add an example script

Author: hharnisc

.gitignore

@@ -1,3 +1,4 @@
 venv
 dist
-*.egg-info
+*.egg-info
+*.pyc

README.md

@@ -14,6 +14,7 @@ $ pip install python-meteor
 - [TODO](#TODO)
 - [Quick Start](#quick-start)
 - [Usage](#usage)
+- [Example](#example)
 - [Collaborators](#collaborators)
 
 ## History
@@ -509,6 +510,23 @@ client.on('logged_in', logged_in)
 client.on('logged_out', logged_out)
 ```
 
+##Example
+
+There is an included `example.py` script to use with the `todo` sample app included with meteor
+
+Create the sample meteor app and start it
+
+```bash
+$ meteor create --example todos
+$ meteor
+```
+
+Then run example.py
+
+```bash
+$ python example.py
+```
+
 ##Collaborators
 
 - [@ppettit](https://github.com/ppettit)

example.py

@@ -0,0 +1,53 @@
+import time
+
+from MeteorClient import MeteorClient
+
+client = MeteorClient('ws://127.0.0.1:3000/websocket')
+
+def subscribed(subscription):
+    print '* SUBSCRIBED {}'.format(subscription)
+
+def unsubscribed(subscription):
+    print '* UNSUBSCRIBED {}'.format(subscription)
+
+def added(collection, id, fields):
+    print '* ADDED {} {}'.format(collection, id)
+    for key, value in fields.items():
+        print '  - FIELD {} {}'.format(key, value)
+
+    # query the data each time something has been added to
+    # a collection to see the data `grow`
+    all_lists = client.find('lists', selector={})
+    print 'Lists: {}'.format(all_lists)
+    print 'Num lists: {}'.format(len(all_lists))
+
+
+    # if collection == 'list' you could subscribe to the list here
+    # with something like
+    # client.subscribe('todos', id)
+    # all_todos = client.find('todos', selector={})
+    # print 'Todos: {}'.format(all_todos)
+
+def connected():
+    print '* CONNECTED'
+
+def subscription_callback(error):
+    if error:
+        print error
+
+client.on('subscribed', subscribed)
+client.on('unsubscribed', unsubscribed)
+client.on('added', added)
+client.on('connected', connected)
+
+client.connect()
+client.subscribe('lists')
+
+
+# (sort of) hacky way to keep the client alive
+# ctrl + c to kill the script
+while True:
+    try:
+        time.sleep(1)
+    except KeyboardInterrupt:
+        break