niaopendata 0.0.1

Distribute & Pip

Installing niaopendata is simple with pip:

$ pip install niaopendata

or, with easy_install:

$ easy_install niaopendata

But, you really shouldn’t do that.

Get the Code

niaopendata is actively developed on GitHub, where the code is always available.

You can either clone the public repository:

$ git clone git://github.com/paddycarey/niaopendata.git

Or download the tarball:

$ curl -OL https://github.com/paddycarey/niaopendata/tarball/master

Once you have a copy of the source, you can embed it in your Python package, or install it into your site-packages easily:

$ python setup.py install

Retrieving data from the API

As an example of what is possible, it is easy to retrieve a list of all members.:

>>> niaopendata.all_current_members()
[
    OrderedDict([
        (u'PersonId', u'307'),
        (u'AffiliationId', u'2482'),
        (u'MemberName', u'Agnew, Steven'),
        (u'MemberLastName', u'Agnew'),
        (u'MemberFirstName', u'Steven'),
        (u'MemberFullDisplayName', u'Mr S Agnew'),
        (u'MemberSortName', u'AgnewSteven'),
        (u'MemberTitle', u'MLA - North Down'),
        (u'PartyName', u'Green Party'),
        (u'PartyOrganisationId', u'111'),
        (u'ConstituencyName', u'North Down'),
        (u'ConstituencyId', u'11'),
        (u'MemberImgUrl', u'http://aims.niassembly.gov.uk/images/mla/307_s.jpg'),
        (u'MemberPrefix', u'Mr')
    ]),
    ...
]

>>> len(niaopendata.all_current_members())
107

Full API documentation

Full documentation is a work in progress, but the code itself should be easy to follow. All public functions are explicitly imported in __init__.py and all functions have appropriate docstrings.