mikexstudios / python-firebase

⛔️ [DEPRECATED] python wrapper for Firebase's REST API
117 stars 38 forks source link
archived deprecated firebase obsolete python python-firebase

⛔️ DEPRECATED

No Maintenance Intended

python-firebase has been unmaintained for years and is no longer supported. Please consider using another library instead.

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.