Update Partner

.gitignore

@@ -0,0 +1 @@
+/vendor

.travis.yml

@@ -3,10 +3,13 @@ language: php
 php:
   - 5.3
   - 5.4
+  - 5.5
+  - 5.6
+  - hhvm
 
 env:
   - SYMFONY_VERSION="2.1.*"
 
 before_script:
   - wget http://getcomposer.org/composer.phar
-  - php composer.phar install
+  - php composer.phar install

README.md

@@ -1,4 +1,8 @@
-[![Build Status](https://secure.travis-ci.org/phpforce/soap-client.png?branch=master)](http://travis-ci.org/phpforce/soap-client)
+[![Build Status](https://travis-ci.org/phpforce/soap-client.svg?branch=master)](https://travis-ci.org/phpforce/soap-client)  
+[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/phpforce/soap-client/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/phpforce/soap-client/?branch=master)
+
+###[I’m looking for maintainers!](https://github.com/phpforce/soap-client/issues/4)
+
 
 PHPForce Soap Client: a PHP client for the Salesforce SOAP API
 ==============================================================
@@ -25,4 +29,104 @@ This library’s features include the following.
 * Completely unit tested (still working on that one).
 * Use the client in conjunction with the Symfony2
   [Mapper Bundle](https://github.com/ddeboer/DdeboerSalesforceMapperBundle)
-  to get even easier access to your Salesforce data.
+  to get even easier access to your Salesforce data.
+
+Installation
+------------
+
+This library is available on [Packagist](http://packagist.org/packages/phpforce/soap-client). 
+The recommended way to install this library is through [Composer](http://getcomposer.org):
+
+```bash
+$ php composer.phar require phpforce/soap-client dev-master
+```
+
+Usage
+-----
+
+### The client
+
+Use the client to query and manipulate your organisation’s Salesforce data. First construct a client using the builder:
+
+```php
+$builder = new \Phpforce\SoapClient\ClientBuilder(
+  '/path/to/your/salesforce/wsdl/sandbox.enterprise.wsdl.xml',
+  'username',
+  'password',
+  'security_token'
+);
+
+$client = $builder->build();
+```
+
+### SOQL queries
+
+```php
+$results = $client->query('select Name, SystemModstamp from Account limit 5');
+```
+
+This will fetch five accounts from Salesforce and return them as a
+`RecordIterator`. You can now iterate over the results. The account’s
+`SystemModstamp` is returned as a `\DateTime` object:
+
+```php
+foreach ($results as $account) {
+    echo 'Last modified: ' . $account->SystemModstamp->format('Y-m-d H:i:') . "\n";
+}
+```
+
+### One-to-many relations (subqueries)
+
+Results from [subqueries](http://www.salesforce.com/us/developer/docs/api/Content/sforce_api_calls_soql_select.htm) 
+are themselves returned as record iterators. So:
+
+```php
+$accounts = $client->query(
+    'select Id, (select Id, Name from Contacts) from Account limit 10'
+);
+
+foreach ($accounts as $account) {
+    if (isset($account->Contacts)) {
+        foreach ($account->Contacts as $contact) {
+            echo sprintf("Contact %s has name %s\n", $contact->Id, $contact->Name);
+        }
+    }
+}
+```
+
+### Fetching large numbers of records
+
+If you issue a query that returns over 2000 records, only the first 2000 records
+will be returned by the Salesforce API. Using the `queryLocator`, you can then
+fetch the following results in batches of 2000. The record iterator does this
+automatically for you:
+
+```php
+$accounts = $client->query('Select Name from Account');
+echo $accounts->count() . ' accounts returned';
+foreach ($accounts as $account) {
+    // This will iterate over the 2000 first accounts, then fetch the next 2000
+    // and iterate over these, etc. In the end, all your organisations’s accounts
+    // will be iterated over.
+}
+```
+
+### Logging
+
+To enable logging for the client, call `withLog()` on the builder. For instance when using [Monolog](https://github.com/Seldaek/monolog):
+
+```php
+$log = new \Monolog\Logger('name');  
+$log->pushHandler(new \Monolog\Handler\StreamHandler('path/to/your.log'));
+
+$builder = new \Phpforce\SoapClient\ClientBuilder(
+  '/path/to/your/salesforce/wsdl/sandbox.enterprise.wsdl.xml',
+  'username',
+  'password',
+  'security_token'
+);
+$client = $builder->withLog($log)
+  ->build();
+```
+
+All requests to the Salesforce API, as well as the responses and any errors that it returns, will now be logged.

composer.json

@@ -1,7 +1,7 @@
 {
     "name": "phpforce/soap-client",
     "type": "library",
-    "description": "Use the Salesforce SOAP API from PHP",
+    "description": "A PHP client for the Salesforce SOAP API",
     "keywords": [ "salesforce", "crm", "soap", "force.com", "web services" ],
     "license": "MIT",
     "authors": [
@@ -13,17 +13,20 @@
     ],
     "require": {
         "php": ">=5.3.0",
-        "phpforce/common": "dev-master"
+        "phpforce/common": "dev-master",
+        "psr/log": "*"
     },
     "require-dev": {
-        "doctrine/common": "2.3@stable"
+        "doctrine/common": ">=2.3",
+        "phpunit/phpunit": "^6.3"
     },
     "suggest": {
-        "doctrine/common": "For caching SOAP responses"
+        "doctrine/common": "For caching SOAP responses",
+        "monolog/monolog": "For logging SOAP transactions"
     },
     "autoload": {
         "psr-0": {
             "Phpforce\\SoapClient": "src"
         }
     }
-}
+}