Merge pull request #16 from hfaran/develop

Add Piazza abstraction on top of PiazzaRPC

Author: hfaran

README.md

@@ -2,19 +2,48 @@
 
 Unofficial Client for Piazza's Internal API
 
-## Example
+## Setup
+
+```bash
+git clone https://github.com/hfaran/piazza-api
+cd piazza-api
+sudo python setup.py install
 ```
+
+## Examples
+
+Some examples to get started; more in the documentation (which is coming soon; 
+but the code is all Sphinx style documented and is fairly readable).
+
+```python
 >>> from piazza_api import Piazza
->>> p = Piazza("hl5qm84dl4t3x2")
->>> p.user_auth()
+>>> p = Piazza()
+>>> p.user_login()
 Email: ...
 Password: ...
->>> p.get_post(181)
-...
->>> p.enroll_students(["student@example.com", "anotherStudent@example.com"])
+>>> user_profile = p.get_user_profile()
+>>> eece210 = p.network("hl5qm84dl4t3x2")
+>>> eece210.get_post(100)
 ...
+>>> posts = eece210.iter_all_posts(limit=10)
+>>> for post in posts:
+...     do_awesome_thing(post)
+>>> users = eece210.get_users(["userid1", "userid2"])
+>>> all_users = eece210.get_all_users()
 ```
 
-## Dependencies
+You can also use the "internal" PiazzaRPC class which maps more directly
+to Piazza's API itself but is not as nice and as intuitive to use as the
+`Piazza` class abstraction.
 
-* [requests](http://python-requests.org/)
+```python
+>>> from piazza_api.rpc import PiazzaRPC
+>>> p = PiazzaRPC("hl5qm84dl4t3x2")
+>>> p.user_login()
+Email: ...
+Password: ...
+>>> p.content_get(181)
+...
+>>> p.add_students(["student@example.com", "anotherStudent@example.com"])
+...
+```