Update README.md

Author: otobrglez

README.md

@@ -12,34 +12,53 @@ When in Databox Designer go to Account > Access tokens, then either create a new
 
 ## Using the Databox Python library
 
+To use databox-python libary you have to pass access token to client. You can do this when initialising `Client` or by setting `DATABOX_PUSH_TOKEN` environment variable.
+
+Using `Client` and `push` to push data directly:
+
 ```python
-from databox import PushClient
+from databox import Client
+
+client = Client('<access token>')
+client.push('sales.total', 1447.0)
+client.push('orders.total', 32, date='2015-01-01 09:00:00')
+```
+
+Inserting multiple matrices with one `insert_all`:
 
-# instantiate PushClient
-client = PushClient('<access token>')
+```python
+client.insert_all([
+    {'key': 'temp.boston', 'value': 51},
+    {'key': 'temp.boston', 'value': 49, 'date': '2015-01-01 17:00:00'},
+    {'key': 'sales.total', 'value': 3000},
+])
+```
+
+Retriving information from last push with `last_push`:
+```python
+print client.last_push()
+```
 
-# push metric "answer1" with value 42 for today
-client.add(42, "answer1")
+Libary can be used with shorthand methods: 
 
-# push metric "answer1" with value 42 for any other day
-client.add(42, "answer1", "2015-05-01 10:10:10")
 
-# send to Databox
-print client.send()
+```python
+from databox import push, insert_all, last_push
 
-# get last push
-print client.lastPush()
-``
+push('sales.total', 1448.9)
+print last_push(token)
+```
 
-Check working sample in [sample1.py](/sample1.py) file.
+## Development and testing
 
-## Development
+Using virtualenv:
 
     mkvirtualenv --no-site-packages databox-python
     workon databox-python
     pip install --upgrade -r requirements.txt
 
-    # Running test suite
+Running test suite with unittest:
+
     python -munittest discover -p -t . 'test*' -v
 
 ## Authors and contributions
@@ -49,4 +68,4 @@ Check working sample in [sample1.py](/sample1.py) file.
 
 ## Licence
 
-- [MIT](LICENSE.txt)
+- [MIT](LICENSE.txt)