oireachtas-api 2.0.0__tar.gz

oireachtas_api-2.0.0/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.4
+Name: oireachtas-api
+Version: 2.0.0
+Summary: Houses of the Oireachtas Open Data APIs Python SDK
+Home-page: https://github.com/Irishsmurf/OireachtasAPI
+Author-email: open.data@oireachtas.ie
+Keywords: Oireachtas,Ireland,Parliament,API,Open Data
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Requires-Dist: certifi>=2020.6.20
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: urllib3>=2.0.0
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+    The Houses of the Oireachtas is providing these APIs to allow our datasets to be retrieved and reused as widely as possible. They are intended to be used in conjunction with https://data.oireachtas.ie, from where our datasets can be accessed directly. By using the APIs, users can make metadata queries to identify the specific data they require. New data are available through the API as soon as they are published.  Currently, https://data.oireachtas.ie contains data in XML format from the Official Report of the Houses of the Oireachtas (the "debates") and replies to Parliamentary Questions in XML files complying with the [Akoma Ntoso](http://akomantoso.org) schema, as well data in PDF format for Bills, Acts and other documents published by the Houses of the Oireachtas.  Files can be retrieved from https://data.oireachtas.ie by adding the URI fragment contained in the "formats" fields of the JSON documents returned by these APIs. At the moment only PDF and XML files are available directly from https://data.oireachtas.ie, but this will become the endpoint for direct access of all "uri" fields in the data queried through https://api.oireachtas.ie. We will also be making bulk downloads available through https://data.oireachtas.ie.  Please note the APIs are a work in progress. We are working on expanding the range of datasets we publish, and we are interested in hearing about how to make these APIs more useful and wide ranging. For these reasons, we welcome any feedback, suggestions and user stories to open.data@oireachtas.ie  Data published through these APIs are made available under the [Oireachtas (Open Data) PSI Licence](https://beta.oireachtas.ie/en/open-data/license/)  # noqa: E501
+    

oireachtas_api-2.0.0/README.md

@@ -0,0 +1,132 @@
+# Houses of the Oireachtas Open Data API - Python SDK
+
+[![Build Status](https://github.com/Irishsmurf/OireachtasAPI/actions/workflows/ci.yml/badge.svg)](https://github.com/Irishsmurf/OireachtasAPI/actions/workflows/ci.yml)
+[![Version](https://img.shields.io/badge/version-2.0.0-blue.svg)](#)
+[![Python Version](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11%20%7C%203.12-blue.svg)](#)
+
+A modern, lightweight Python client SDK for retrieving and querying open parliament data from the national parliament of Ireland (Houses of the Oireachtas).
+
+This client SDK makes metadata queries easy, allowing you to discover and locate specific official documents, bills, members, votes (divisions), and debates. Output formats point directly to XML/PDF datasets hosted at [data.oireachtas.ie](https://data.oireachtas.ie).
+
+---
+
+## 🚀 Key Features
+
+* **Modern Python 3 Support:** Fully compatible with Python 3.8+ (legacy Python 2 support has been dropped).
+* **Fully Tested:** Upgraded to use `pytest` with a complete suite of unit (mocked) and integration (live API) tests.
+* **Open Access:** Works out of the box with the public Oireachtas API endpoints (no authentication tokens required).
+* **Automated CI/CD:** GitHub Actions verify compatibility on every push and automatically build & publish new GitHub Releases when tags are created.
+
+---
+
+## 🛠 Installation
+
+### Installing directly from GitHub
+
+To install the latest release directly from GitHub:
+```bash
+pip install git+https://github.com/Irishsmurf/OireachtasAPI.git
+```
+
+### Local Development Setup
+
+To clone the repository and install it in editable mode with development dependencies:
+```bash
+# Clone the repository
+git clone https://github.com/Irishsmurf/OireachtasAPI.git
+cd OireachtasAPI
+
+# Create and activate a virtual environment
+python3 -m venv .venv
+source .venv/bin/activate
+
+# Install requirements
+pip install --upgrade pip setuptools wheel
+pip install -r requirements.txt -r test-requirements.txt
+pip install -e .
+```
+
+---
+
+## 💡 Quick Start Example
+
+This code demonstrates how to retrieve the 5 most recent active Constituencies:
+
+```python
+import oireachtas_api
+from pprint import pprint
+
+# 1. Initialize the client
+client = oireachtas_api.ConstituenciesApi()
+
+try:
+    # 2. Query constituencies (limiting to 5 results)
+    response = client.constituencies(limit=5)
+    
+    # 3. Print the API response
+    print("--- Oireachtas Constituencies ---")
+    pprint(response)
+except oireachtas_api.rest.ApiException as e:
+    print(f"Failed to query constituencies: {e}")
+```
+
+---
+
+## 📂 Core API Reference
+
+All requests call the live API endpoint: `https://api.oireachtas.ie/v1`.
+
+| Service Class | Method API | Description / Use Case | Official Specs |
+| :--- | :--- | :--- | :--- |
+| **`ConstituenciesApi`** | `constituencies()` | Retrieve electoral districts | [Docs](docs/ConstituenciesApi.md) |
+| **`DebatesApi`** | `debates()` | Access official debates transcripts | [Docs](docs/DebatesApi.md) |
+| **`DivisionsApi`** | `divisions()` | Inspect parliamentary votes and counts | [Docs](docs/DivisionsApi.md) |
+| **`HousesApi`** | `houses()` | Query house info (Dáil or Seanad) | [Docs](docs/HousesApi.md) |
+| **`LegislationApi`** | `legislation()` | Query active & historic bills and acts | [Docs](docs/LegislationApi.md) |
+| **`MembersApi`** | `members()` | Look up details of TDs and Senators | [Docs](docs/MembersApi.md) |
+| **`PartiesApi`** | `parties()` | List political parties | [Docs](docs/PartiesApi.md) |
+| **`QuestionsApi`** | `questions()` | Query parliamentary questions (PQs) | [Docs](docs/QuestionsApi.md) |
+
+---
+
+## 🧪 Testing Guide
+
+We use `pytest` for unit and integration tests.
+
+### 1. Isolated Unit Tests (Mocked Network)
+To run local test stubs using mock API responses (extremely fast, offline-safe):
+```bash
+pytest -m "not integration"
+```
+
+### 2. Live Integration Tests
+To verify compatibility against the real, live Oireachtas API endpoints:
+```bash
+pytest -m "integration"
+```
+
+### 3. Run the Whole Test Suite
+To run all tests:
+```bash
+pytest
+```
+
+---
+
+## 🏷 Release Automation
+
+This project tracks official releases automatically:
+1. Ensure your version code is up to date in [setup.py](setup.py).
+2. Commit your changes and tag the master branch:
+   ```bash
+   git tag v2.0.0
+   git push origin v2.0.0
+   ```
+3. The **Release Workflow** will automatically build the package wheels and publish a drafted GitHub Release with build assets attached.
+
+---
+
+## 📬 Contact & Support
+
+* **Official API Portal:** [beta.oireachtas.ie/en/open-data](https://beta.oireachtas.ie/en/open-data)
+* **Email:** open.data@oireachtas.ie

oireachtas_api-2.0.0/oireachtas_api/__init__.py

@@ -0,0 +1,84 @@
+# coding: utf-8
+
+# flake8: noqa
+
+"""
+    Houses of the Oireachtas Open Data APIs
+
+    The Houses of the Oireachtas is providing these APIs to allow our datasets to be retrieved and reused as widely as possible. They are intended to be used in conjunction with https://data.oireachtas.ie, from where our datasets can be accessed directly. By using the APIs, users can make metadata queries to identify the specific data they require. New data are available through the API as soon as they are published.  Currently, https://data.oireachtas.ie contains data in XML format from the Official Report of the Houses of the Oireachtas (the \"debates\") and replies to Parliamentary Questions in XML files complying with the [Akoma Ntoso](http://akomantoso.org) schema, as well data in PDF format for Bills, Acts and other documents published by the Houses of the Oireachtas.  Files can be retrieved from https://data.oireachtas.ie by adding the URI fragment contained in the \"formats\" fields of the JSON documents returned by these APIs. At the moment only PDF and XML files are available directly from https://data.oireachtas.ie, but this will become the endpoint for direct access of all \"uri\" fields in the data queried through https://api.oireachtas.ie. We will also be making bulk downloads available through https://data.oireachtas.ie.  Please note the APIs are a work in progress. We are working on expanding the range of datasets we publish, and we are interested in hearing about how to make these APIs more useful and wide ranging. For these reasons, we welcome any feedback, suggestions and user stories to open.data@oireachtas.ie  Data published through these APIs are made available under the [Oireachtas (Open Data) PSI Licence](https://beta.oireachtas.ie/en/open-data/license/)  # noqa: E501
+
+    OpenAPI spec version: 1.0
+    Contact: open.data@oireachtas.ie
+    Generated by: https://github.com/swagger-api/swagger-codegen.git
+"""
+
+
+
+# import apis into sdk package
+from oireachtas_api.api.constituencies_api import ConstituenciesApi
+from oireachtas_api.api.debates_api import DebatesApi
+from oireachtas_api.api.divisions_api import DivisionsApi
+from oireachtas_api.api.filters_api import FiltersApi
+from oireachtas_api.api.houses_api import HousesApi
+from oireachtas_api.api.legislation_api import LegislationApi
+from oireachtas_api.api.members_api import MembersApi
+from oireachtas_api.api.parties_api import PartiesApi
+from oireachtas_api.api.questions_api import QuestionsApi
+
+# import ApiClient
+from oireachtas_api.api_client import ApiClient
+from oireachtas_api.configuration import Configuration
+# import models into sdk package
+from oireachtas_api.models.error_response import ErrorResponse
+from oireachtas_api.models.inline_response200 import InlineResponse200
+from oireachtas_api.models.inline_response2001 import InlineResponse2001
+from oireachtas_api.models.inline_response2001_question import InlineResponse2001Question
+from oireachtas_api.models.inline_response2001_question_by import InlineResponse2001QuestionBy
+from oireachtas_api.models.inline_response2001_question_debate_section import InlineResponse2001QuestionDebateSection
+from oireachtas_api.models.inline_response2001_question_debate_section_formats import InlineResponse2001QuestionDebateSectionFormats
+from oireachtas_api.models.inline_response2001_question_to import InlineResponse2001QuestionTo
+from oireachtas_api.models.inline_response2001_results import InlineResponse2001Results
+from oireachtas_api.models.inline_response2002 import InlineResponse2002
+from oireachtas_api.models.inline_response2002_debate_record import InlineResponse2002DebateRecord
+from oireachtas_api.models.inline_response2002_debate_record_chamber import InlineResponse2002DebateRecordChamber
+from oireachtas_api.models.inline_response2002_debate_record_counts import InlineResponse2002DebateRecordCounts
+from oireachtas_api.models.inline_response2002_debate_record_debate_section import InlineResponse2002DebateRecordDebateSection
+from oireachtas_api.models.inline_response2002_debate_record_debate_section_counts import InlineResponse2002DebateRecordDebateSectionCounts
+from oireachtas_api.models.inline_response2002_debate_record_debate_section_speakers import InlineResponse2002DebateRecordDebateSectionSpeakers
+from oireachtas_api.models.inline_response2002_debate_record_debate_sections import InlineResponse2002DebateRecordDebateSections
+from oireachtas_api.models.inline_response2002_debate_record_house import InlineResponse2002DebateRecordHouse
+from oireachtas_api.models.inline_response2002_results import InlineResponse2002Results
+from oireachtas_api.models.inline_response2003 import InlineResponse2003
+from oireachtas_api.models.inline_response2003_division import InlineResponse2003Division
+from oireachtas_api.models.inline_response2003_division_debate import InlineResponse2003DivisionDebate
+from oireachtas_api.models.inline_response2003_division_house import InlineResponse2003DivisionHouse
+from oireachtas_api.models.inline_response2003_division_subject import InlineResponse2003DivisionSubject
+from oireachtas_api.models.inline_response2003_division_tallies import InlineResponse2003DivisionTallies
+from oireachtas_api.models.inline_response2003_results import InlineResponse2003Results
+from oireachtas_api.models.inline_response2004 import InlineResponse2004
+from oireachtas_api.models.inline_response2004_head import InlineResponse2004Head
+from oireachtas_api.models.inline_response2004_head_counts import InlineResponse2004HeadCounts
+from oireachtas_api.models.inline_response2004_head_date_range import InlineResponse2004HeadDateRange
+from oireachtas_api.models.inline_response2004_member import InlineResponse2004Member
+from oireachtas_api.models.inline_response2004_member_membership import InlineResponse2004MemberMembership
+from oireachtas_api.models.inline_response2004_member_membership_house import InlineResponse2004MemberMembershipHouse
+from oireachtas_api.models.inline_response2004_member_membership_office import InlineResponse2004MemberMembershipOffice
+from oireachtas_api.models.inline_response2004_member_membership_office_date_range import InlineResponse2004MemberMembershipOfficeDateRange
+from oireachtas_api.models.inline_response2004_member_membership_office_office_name import InlineResponse2004MemberMembershipOfficeOfficeName
+from oireachtas_api.models.inline_response2004_member_membership_offices import InlineResponse2004MemberMembershipOffices
+from oireachtas_api.models.inline_response2004_member_membership_parties import InlineResponse2004MemberMembershipParties
+from oireachtas_api.models.inline_response2004_member_membership_party import InlineResponse2004MemberMembershipParty
+from oireachtas_api.models.inline_response2004_member_membership_party_date_range import InlineResponse2004MemberMembershipPartyDateRange
+from oireachtas_api.models.inline_response2004_member_membership_represent import InlineResponse2004MemberMembershipRepresent
+from oireachtas_api.models.inline_response2004_member_membership_represents import InlineResponse2004MemberMembershipRepresents
+from oireachtas_api.models.inline_response2004_member_memberships import InlineResponse2004MemberMemberships
+from oireachtas_api.models.inline_response2004_results import InlineResponse2004Results
+from oireachtas_api.models.inline_response200_bill import InlineResponse200Bill
+from oireachtas_api.models.inline_response200_bill_amendment_lists import InlineResponse200BillAmendmentLists
+from oireachtas_api.models.inline_response200_bill_origin_house import InlineResponse200BillOriginHouse
+from oireachtas_api.models.inline_response200_bill_stages import InlineResponse200BillStages
+from oireachtas_api.models.inline_response200_bill_version import InlineResponse200BillVersion
+from oireachtas_api.models.inline_response200_bill_versions import InlineResponse200BillVersions
+from oireachtas_api.models.inline_response200_head import InlineResponse200Head
+from oireachtas_api.models.inline_response200_head_date_range import InlineResponse200HeadDateRange
+from oireachtas_api.models.inline_response200_results import InlineResponse200Results

oireachtas_api-2.0.0/oireachtas_api/api/__init__.py

@@ -0,0 +1,13 @@
+
+# flake8: noqa
+
+# import apis into api package
+from oireachtas_api.api.constituencies_api import ConstituenciesApi
+from oireachtas_api.api.debates_api import DebatesApi
+from oireachtas_api.api.divisions_api import DivisionsApi
+from oireachtas_api.api.filters_api import FiltersApi
+from oireachtas_api.api.houses_api import HousesApi
+from oireachtas_api.api.legislation_api import LegislationApi
+from oireachtas_api.api.members_api import MembersApi
+from oireachtas_api.api.parties_api import PartiesApi
+from oireachtas_api.api.questions_api import QuestionsApi

oireachtas_api-2.0.0/oireachtas_api/api/constituencies_api.py

@@ -0,0 +1,144 @@
+# coding: utf-8
+
+"""
+    Houses of the Oireachtas Open Data APIs
+
+    The Houses of the Oireachtas is providing these APIs to allow our datasets to be retrieved and reused as widely as possible. They are intended to be used in conjunction with https://data.oireachtas.ie, from where our datasets can be accessed directly. By using the APIs, users can make metadata queries to identify the specific data they require. New data are available through the API as soon as they are published.  Currently, https://data.oireachtas.ie contains data in XML format from the Official Report of the Houses of the Oireachtas (the \"debates\") and replies to Parliamentary Questions in XML files complying with the [Akoma Ntoso](http://akomantoso.org) schema, as well data in PDF format for Bills, Acts and other documents published by the Houses of the Oireachtas.  Files can be retrieved from https://data.oireachtas.ie by adding the URI fragment contained in the \"formats\" fields of the JSON documents returned by these APIs. At the moment only PDF and XML files are available directly from https://data.oireachtas.ie, but this will become the endpoint for direct access of all \"uri\" fields in the data queried through https://api.oireachtas.ie. We will also be making bulk downloads available through https://data.oireachtas.ie.  Please note the APIs are a work in progress. We are working on expanding the range of datasets we publish, and we are interested in hearing about how to make these APIs more useful and wide ranging. For these reasons, we welcome any feedback, suggestions and user stories to open.data@oireachtas.ie  Data published through these APIs are made available under the [Oireachtas (Open Data) PSI Licence](https://beta.oireachtas.ie/en/open-data/license/)  # noqa: E501
+
+    OpenAPI spec version: 1.0
+    Contact: open.data@oireachtas.ie
+    Generated by: https://github.com/swagger-api/swagger-codegen.git
+"""
+
+
+
+import re  # noqa: F401
+
+# python 2 and python 3 compatibility library
+
+from oireachtas_api.api_client import ApiClient
+
+
+class ConstituenciesApi(object):
+    """NOTE: This class is auto generated by the swagger code generator program.
+
+    Do not edit the class manually.
+    Ref: https://github.com/swagger-api/swagger-codegen
+    """
+
+    def __init__(self, api_client=None):
+        if api_client is None:
+            api_client = ApiClient()
+        self.api_client = api_client
+
+    def constituencies(self, **kwargs):  # noqa: E501
+        """Constituencies List  # noqa: E501
+
+        Returns list of constituencies filtered by the base and additional parameters. The list supports paging.  #### Mapping * Start Date - Greater Than or Equal To - question.date * End Date - Less Than or Equal To - question.date * Skip - Equal To - this will ignore the first x number of records set in the parameter * Limit - Equal To - this will only return a specific amount of records * House/Chamber - house.house.uri   # noqa: E501
+        This method makes a synchronous HTTP request by default. To make an
+        asynchronous HTTP request, please pass async_req=True
+        >>> thread = api.constituencies(async_req=True)
+        >>> result = thread.get()
+
+        :param async_req bool
+        :param list[str] chamber_id: Filter by house or committee uri. Example  /ie/oireachtas/house/dail/32 
+        :param str chamber: Filter by House name (dail or seanad). Using an empty string retrieves results for both Houses. 
+        :param int house_no: filter by house number
+        :param int skip: This is a base filter which is used on many APIs, allowing skipping of records by a specific integer.
+        :param int limit: This is a base filter which is used on many APIs, allowing the limiting of records to a specific integer.
+        :return: object
+                 If the method is called asynchronously,
+                 returns the request thread.
+        """
+        kwargs['_return_http_data_only'] = True
+        if kwargs.get('async_req'):
+            return self.constituencies_with_http_info(**kwargs)  # noqa: E501
+        else:
+            (data) = self.constituencies_with_http_info(**kwargs)  # noqa: E501
+            return data
+
+    def constituencies_with_http_info(self, **kwargs):  # noqa: E501
+        """Constituencies List  # noqa: E501
+
+        Returns list of constituencies filtered by the base and additional parameters. The list supports paging.  #### Mapping * Start Date - Greater Than or Equal To - question.date * End Date - Less Than or Equal To - question.date * Skip - Equal To - this will ignore the first x number of records set in the parameter * Limit - Equal To - this will only return a specific amount of records * House/Chamber - house.house.uri   # noqa: E501
+        This method makes a synchronous HTTP request by default. To make an
+        asynchronous HTTP request, please pass async_req=True
+        >>> thread = api.constituencies_with_http_info(async_req=True)
+        >>> result = thread.get()
+
+        :param async_req bool
+        :param list[str] chamber_id: Filter by house or committee uri. Example  /ie/oireachtas/house/dail/32 
+        :param str chamber: Filter by House name (dail or seanad). Using an empty string retrieves results for both Houses. 
+        :param int house_no: filter by house number
+        :param int skip: This is a base filter which is used on many APIs, allowing skipping of records by a specific integer.
+        :param int limit: This is a base filter which is used on many APIs, allowing the limiting of records to a specific integer.
+        :return: object
+                 If the method is called asynchronously,
+                 returns the request thread.
+        """
+
+        all_params = ['chamber_id', 'chamber', 'house_no', 'skip', 'limit']  # noqa: E501
+        all_params.append('async_req')
+        all_params.append('_return_http_data_only')
+        all_params.append('_preload_content')
+        all_params.append('_request_timeout')
+
+        params = locals()
+        for key, val in params['kwargs'].items():
+            if key not in all_params:
+                raise TypeError(
+                    "Got an unexpected keyword argument '%s'"
+                    " to method constituencies" % key
+                )
+            params[key] = val
+        del params['kwargs']
+
+        collection_formats = {}
+
+        path_params = {}
+
+        query_params = []
+        if 'chamber_id' in params:
+            query_params.append(('chamber_id', params['chamber_id']))  # noqa: E501
+            collection_formats['chamber_id'] = 'csv'  # noqa: E501
+        if 'chamber' in params:
+            query_params.append(('chamber', params['chamber']))  # noqa: E501
+        if 'house_no' in params:
+            query_params.append(('house_no', params['house_no']))  # noqa: E501
+        if 'skip' in params:
+            query_params.append(('skip', params['skip']))  # noqa: E501
+        if 'limit' in params:
+            query_params.append(('limit', params['limit']))  # noqa: E501
+
+        header_params = {}
+
+        form_params = []
+        local_var_files = {}
+
+        body_params = None
+        # HTTP header `Accept`
+        header_params['Accept'] = self.api_client.select_header_accept(
+            ['application/json'])  # noqa: E501
+
+        # HTTP header `Content-Type`
+        header_params['Content-Type'] = self.api_client.select_header_content_type(  # noqa: E501
+            ['application/json'])  # noqa: E501
+
+        # Authentication setting
+        auth_settings = []  # noqa: E501
+
+        return self.api_client.call_api(
+            '/constituencies', 'GET',
+            path_params,
+            query_params,
+            header_params,
+            body=body_params,
+            post_params=form_params,
+            files=local_var_files,
+            response_type='object',  # noqa: E501
+            auth_settings=auth_settings,
+            async_req=params.get('async_req'),
+            _return_http_data_only=params.get('_return_http_data_only'),
+            _preload_content=params.get('_preload_content', True),
+            _request_timeout=params.get('_request_timeout'),
+            collection_formats=collection_formats)

oireachtas_api-2.0.0/oireachtas_api/api/debates_api.py

@@ -0,0 +1,160 @@
+# coding: utf-8
+
+"""
+    Houses of the Oireachtas Open Data APIs
+
+    The Houses of the Oireachtas is providing these APIs to allow our datasets to be retrieved and reused as widely as possible. They are intended to be used in conjunction with https://data.oireachtas.ie, from where our datasets can be accessed directly. By using the APIs, users can make metadata queries to identify the specific data they require. New data are available through the API as soon as they are published.  Currently, https://data.oireachtas.ie contains data in XML format from the Official Report of the Houses of the Oireachtas (the \"debates\") and replies to Parliamentary Questions in XML files complying with the [Akoma Ntoso](http://akomantoso.org) schema, as well data in PDF format for Bills, Acts and other documents published by the Houses of the Oireachtas.  Files can be retrieved from https://data.oireachtas.ie by adding the URI fragment contained in the \"formats\" fields of the JSON documents returned by these APIs. At the moment only PDF and XML files are available directly from https://data.oireachtas.ie, but this will become the endpoint for direct access of all \"uri\" fields in the data queried through https://api.oireachtas.ie. We will also be making bulk downloads available through https://data.oireachtas.ie.  Please note the APIs are a work in progress. We are working on expanding the range of datasets we publish, and we are interested in hearing about how to make these APIs more useful and wide ranging. For these reasons, we welcome any feedback, suggestions and user stories to open.data@oireachtas.ie  Data published through these APIs are made available under the [Oireachtas (Open Data) PSI Licence](https://beta.oireachtas.ie/en/open-data/license/)  # noqa: E501
+
+    OpenAPI spec version: 1.0
+    Contact: open.data@oireachtas.ie
+    Generated by: https://github.com/swagger-api/swagger-codegen.git
+"""
+
+
+
+import re  # noqa: F401
+
+# python 2 and python 3 compatibility library
+
+from oireachtas_api.api_client import ApiClient
+
+
+class DebatesApi(object):
+    """NOTE: This class is auto generated by the swagger code generator program.
+
+    Do not edit the class manually.
+    Ref: https://github.com/swagger-api/swagger-codegen
+    """
+
+    def __init__(self, api_client=None):
+        if api_client is None:
+            api_client = ApiClient()
+        self.api_client = api_client
+
+    def debates(self, **kwargs):  # noqa: E501
+        """Debates List  # noqa: E501
+
+        Returns list of debates filtered by the base and additional parameters. The list supports paging. #### Mapping * Start Date - Greater Than or Equal To - debateRecord.date * End Date - Less Than or Equal To - debateRecord.date * Skip - Equal To - this will ignore the first x number of records set in the parameter * Limit - Equal To - this will only return a specific amount of records   # noqa: E501
+        This method makes a synchronous HTTP request by default. To make an
+        asynchronous HTTP request, please pass async_req=True
+        >>> thread = api.debates(async_req=True)
+        >>> result = thread.get()
+
+        :param async_req bool
+        :param str chamber_type: Filter results by House, ie, Dáil or Seanad or committees. 
+        :param list[str] chamber_id: Filter by house or committee uri. Example  /ie/oireachtas/house/dail/32 
+        :param str chamber: Filter by House name (dail or seanad). Using an empty string retrieves results for both Houses. 
+        :param date date_start: This is a base filter which is used on many APIs, allowing filtering by Start Date related to the Section.
+        :param date date_end: This is a base filter which is used on many APIs, allowing filtering by End Date related to the Section.
+        :param int skip: This is a base filter which is used on many APIs, allowing skipping of records by a specific integer.
+        :param int limit: This is a base filter which is used on many APIs, allowing the limiting of records to a specific integer.
+        :param str member_id: Filter by Member uri.
+        :param str debate_id: Filter by debate uri
+        :return: InlineResponse2002
+                 If the method is called asynchronously,
+                 returns the request thread.
+        """
+        kwargs['_return_http_data_only'] = True
+        if kwargs.get('async_req'):
+            return self.debates_with_http_info(**kwargs)  # noqa: E501
+        else:
+            (data) = self.debates_with_http_info(**kwargs)  # noqa: E501
+            return data
+
+    def debates_with_http_info(self, **kwargs):  # noqa: E501
+        """Debates List  # noqa: E501
+
+        Returns list of debates filtered by the base and additional parameters. The list supports paging. #### Mapping * Start Date - Greater Than or Equal To - debateRecord.date * End Date - Less Than or Equal To - debateRecord.date * Skip - Equal To - this will ignore the first x number of records set in the parameter * Limit - Equal To - this will only return a specific amount of records   # noqa: E501
+        This method makes a synchronous HTTP request by default. To make an
+        asynchronous HTTP request, please pass async_req=True
+        >>> thread = api.debates_with_http_info(async_req=True)
+        >>> result = thread.get()
+
+        :param async_req bool
+        :param str chamber_type: Filter results by House, ie, Dáil or Seanad or committees. 
+        :param list[str] chamber_id: Filter by house or committee uri. Example  /ie/oireachtas/house/dail/32 
+        :param str chamber: Filter by House name (dail or seanad). Using an empty string retrieves results for both Houses. 
+        :param date date_start: This is a base filter which is used on many APIs, allowing filtering by Start Date related to the Section.
+        :param date date_end: This is a base filter which is used on many APIs, allowing filtering by End Date related to the Section.
+        :param int skip: This is a base filter which is used on many APIs, allowing skipping of records by a specific integer.
+        :param int limit: This is a base filter which is used on many APIs, allowing the limiting of records to a specific integer.
+        :param str member_id: Filter by Member uri.
+        :param str debate_id: Filter by debate uri
+        :return: InlineResponse2002
+                 If the method is called asynchronously,
+                 returns the request thread.
+        """
+
+        all_params = ['chamber_type', 'chamber_id', 'chamber', 'date_start', 'date_end', 'skip', 'limit', 'member_id', 'debate_id']  # noqa: E501
+        all_params.append('async_req')
+        all_params.append('_return_http_data_only')
+        all_params.append('_preload_content')
+        all_params.append('_request_timeout')
+
+        params = locals()
+        for key, val in params['kwargs'].items():
+            if key not in all_params:
+                raise TypeError(
+                    "Got an unexpected keyword argument '%s'"
+                    " to method debates" % key
+                )
+            params[key] = val
+        del params['kwargs']
+
+        collection_formats = {}
+
+        path_params = {}
+
+        query_params = []
+        if 'chamber_type' in params:
+            query_params.append(('chamber_type', params['chamber_type']))  # noqa: E501
+        if 'chamber_id' in params:
+            query_params.append(('chamber_id', params['chamber_id']))  # noqa: E501
+            collection_formats['chamber_id'] = 'csv'  # noqa: E501
+        if 'chamber' in params:
+            query_params.append(('chamber', params['chamber']))  # noqa: E501
+        if 'date_start' in params:
+            query_params.append(('date_start', params['date_start']))  # noqa: E501
+        if 'date_end' in params:
+            query_params.append(('date_end', params['date_end']))  # noqa: E501
+        if 'skip' in params:
+            query_params.append(('skip', params['skip']))  # noqa: E501
+        if 'limit' in params:
+            query_params.append(('limit', params['limit']))  # noqa: E501
+        if 'member_id' in params:
+            query_params.append(('member_id', params['member_id']))  # noqa: E501
+        if 'debate_id' in params:
+            query_params.append(('debate_id', params['debate_id']))  # noqa: E501
+
+        header_params = {}
+
+        form_params = []
+        local_var_files = {}
+
+        body_params = None
+        # HTTP header `Accept`
+        header_params['Accept'] = self.api_client.select_header_accept(
+            ['application/json'])  # noqa: E501
+
+        # HTTP header `Content-Type`
+        header_params['Content-Type'] = self.api_client.select_header_content_type(  # noqa: E501
+            ['application/json'])  # noqa: E501
+
+        # Authentication setting
+        auth_settings = []  # noqa: E501
+
+        return self.api_client.call_api(
+            '/debates', 'GET',
+            path_params,
+            query_params,
+            header_params,
+            body=body_params,
+            post_params=form_params,
+            files=local_var_files,
+            response_type='InlineResponse2002',  # noqa: E501
+            auth_settings=auth_settings,
+            async_req=params.get('async_req'),
+            _return_http_data_only=params.get('_return_http_data_only'),
+            _preload_content=params.get('_preload_content', True),
+            _request_timeout=params.get('_request_timeout'),
+            collection_formats=collection_formats)