Adding documentation for push (#2)

* Update firebase.py

Enabling push

* Update README.md

* Update README.md

Adding documentation for push

Author: faaez

README.md

@@ -12,9 +12,9 @@ https://www.firebase.com/signup/
 
 
 
-##get and put
+##get, put and push
 
-`get` gets the value of a Firebase at some URL, and `put` sets the value of a Firebase at URL to some data.
+`get` gets the value of a Firebase at some URL, `put` writes or replaces data at the path defined by URL and `push` appends data to a list at the path defined by URL. A new ID is also generated every time you `push` to a Firebase URL.
 
 ```python
 >>> import firebase
@@ -36,6 +36,15 @@ tell me everything
 
 >>> print firebase.get(URL + '/color')
 red
+
+>>> #Whereas using put replaces existing data, push simply appends to a list
+>>> firebase.push(URL+'/listexample',{'color':'red'})
+>>> firebase.get(URL+'/listexample')
+{'u'-JyAXHX9ZNBh7tPPja4w':{'color':'red'}}
+
+>>> firebase.push(URL+'/listexample',{'color':'green'})
+>>> firebase.get(URL+'/listexample')
+{'u'-JyAXHX9ZNBh7tPPja4w':{'color':'red'},'-JyAXHX9ZNBh7tPPjasd':{'color':'green'}}
 ```
 
 

firebase.py

@@ -125,10 +125,8 @@ def get(URL):
         raise FirebaseException(response.text)
     return json.loads(response.text)
 
-
-# Yuck, I don't want to write documentation for this :p
-#def push(URL, msg):
-#    to_post = json.dumps(msg)
-#    response = requests.post(firebaseURL(URL), data=to_post)
-#    if response.status_code != 200:
-#        raise Exception(response.text)
+def push(URL, msg):
+    to_post = json.dumps(msg)
+    response = requests.post(firebaseURL(URL), data=to_post)
+    if response.status_code != 200:
+        raise Exception(response.text)