


            ==========
             DjamBase
            ==========
**A Python Jambase API Client Library**

Getting Started
---------------
::

    $ pip install DjamBase

Get a valid Developer API key at http://developer.jambase.com.

::

    import DjamBase

     db = DjamBase.API("your_api_key")

Usage
---------
db.artist_search(params)
    -'params' is a dictionary, with: ``{"id": <int>, "name": <str>}`` as valid key, value options. These will serve
    as the JamBase Artist search parameters.
db.venue_search(params)
    -'params' is a dictionary, with: ``{"id": <int>, "zipCode": <int>, "radius"*: <int>}`` as valid key, value options.
    These are the JamBase Venue search parameters.
db.event_list(params)
    -'params' is a dictionary, with:
|                                    ``{``
|                                    ``"id": <int>``,
|                                    ``"artist": <str>``,
|                                    ``"artistId": <int>``,
|                                    ``"band": <str>``,
|                                    ``"bandId": <int>``,
|                                    ``"venueId": <int>``,
|                                    ``"zipCode": <int>``,
|                                    ``"radius"*: <int>``,
|                                    ``"startDate": <YYYY-MM-DD>``,
|                                    ``"endDate": <YYYY-MM-DD>   } ``as possible valid key, value options.
 These are the JamBase Event search parameters.

Use any combination of a functions' available parameters that you like, depending on the
desired results. Notice that all keys are written in "camelCase".



Use as below:

::

    r = db.event_list( {"name": "the foobar fighters", "radius": 200} )


Response
--------


Of course, you can use whatever variable name you like, but the above variable "r" will contain a response object. It's that simple!
The ".body" attribute of this object contains the response in JSON format. If you would like XML, pass "xml"
as the optional 2nd argument when instantiating the client.

r.body
   -Use this response object property retrieve the content of the search response. JSON by default.
r.status
   -This property will give you access to the dialogues' HTTP status code, in case there are issues.
r.text
   -This property will give you a stringified version of the JSON response.
r.binary
   -This property will get you binary version of the response.



::

    json = r.body
     print json

Example
---------

::

    import DjamBase

     db = DjamBase.API("your_api_key", "xml")

     r = db.event_list( {"name": "the foobar fighters", "radius": 200} )
     code = r.status
     print code      **<Response-200>**

     xml = r.body
     print xml


 *** miles
