/python-firebase

python wrapper for Firebase's REST API

Primary LanguagePython

python-firebase

http://github.com/mikexstudios/python-firebase by Michael Huynh (mike@mikexstudios.com)

Purpose:

A very simple wrapper for Firebase's REST API.

How to use

  1. Install python-firebase using pip:

    pip install -e git://github.com/mikexstudios/python-firebase.git#egg=python-firebase
    

    or with easy_install (not recommended):

    easy_install http://github.com/mikexstudios/python-firebase/tarball/master
    

    Note that python-firebase depends on requests (http://python-requests.org), a REST/http client for python. If you used pip or easy_install, the dependency should automatically be installed.

  2. Then simply import firebase at the top of your python script:

    from firebase import Firebase
    

    and then instantiate Firebase, passing in your root url:

    f = Firebase('https://SampleChat.firebaseIO-demo.com/')
    

    You may optionaly pass a Firebase authentication token to secure your calls:

    f = Firebase('http://SampleChat.firebaseIO-demo.com/', auth_token="<my_firebase_auth_token>")
    

    Now call the different methods of the Firebase class (see the Firebase REST API page: http://www.firebase.com/docs/rest-api.html and the source of firebase/__init__.py for what methods are available and how to call them). For example, to push a list of data:

    f = Firebase('https://SampleChat.firebaseIO-demo.com/message_list')
    r = f.push({'user_id': 'wilma', 'text': 'Hello'})
    

    The response r is a dictionary containing Firebase's REST response:

    {"name":"-INOQPH-aV_psbk3ZXEX"}
    

License

django-firebase is BSD licensed.