Update README: add sample usage

*   Also add some notes about development of this project

1 files changed, 28 insertions, 0 deletions

diff --git a/README.markdown b/README.markdown
index 6cfe413..4f0a731 100644
--- a/README.markdown
+++ b/README.markdown
@@ -5,6 +5,34 @@
 This intends to be a near complete Python language binding of the
 [Chorus API][1].
 
+The library itself will likely be very unstable for a little while as
+its development progresses.
+
+## Sample Usage ##
+
+Here is a sample interactive session that demonstrates the current
+usage.
+
+    >>> import pylibchorus
+    >>> from ConfigParser import SafeConfigParser
+    >>> config = SafeConfigParser()
+    >>> config.read('/tmp/alpine.cfg')
+    ['/tmp/alpine.cfg']
+    >>> with pylibchorus.ChorusSession(config) as session:
+    ...     print(session.sid)
+    ...     resp = pylibchorus.check_login_status(session)
+    ...     print(resp.status_code)
+    ...     json = resp.json()
+    ...     print(json['response']['session_id'])
+    ...
+    49fb8e27e591d9ccb6f0006334eedb8e4d8004a5
+    200
+    49fb8e27e591d9ccb6f0006334eedb8e4d8004a5
+    >> quit()
+
+Notice, some of the interactions that depend on the `requests`
+library may be cleaned up in the future, enabling easier interaction
+with this library.
 
 ## License ##