Metadata-Version: 2.0
Name: tkapi
Version: 0.2.0
Summary: Python bindings for the Tweede Kamer OData API
Home-page: https://github.com/openkamer/tkapi
Author: Open Kamer
Author-email: info@openkamer.org
License: MIT
Description-Content-Type: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Requires-Dist: requests (>=2.13.0)
Requires-Dist: orderedset (>=2.0)

tkapi
=====

Python bindings for the `Tweede Kamer <https://tweedekamer.nl>`__ `Open
Data Portaal <https://opendata.tweedekamer.nl>`__ OData API.

Requires Python 3.3+

**WARNING**: This is a work in progress. There will be major changes
that break everything!

Installation
------------

::

    pip install tkapi

Usage
-----

A simple first example,

.. code:: python

    import tkapi

    api = tkapi.Api(user=USERNAME, password=PASSWORD)
    personen = api.get_personen(max_items=100)
    for persoon in personen:
        print(persoon.achternaam)

Where ``USERNAME`` and ``PASSWORD`` are your Tweede Kamer OpenData
username and password. You can get one by registering at
https://opendata.tweedekamer.nl .

Development
-----------

Tests
~~~~~

Run all tests,

.. code:: bash

    python -m unittest discover

Coverage report
^^^^^^^^^^^^^^^

Run all tests,

.. code:: bash

    coverage -m unittest discover

Create coverage report,

.. code:: bash

    coverage html

Then visit htmlcov/index.html in your browser.


