bolster.data_sources.wikipedia
==============================

.. py:module:: bolster.data_sources.wikipedia

.. autoapi-nested-parse::

   Wikipedia Northern Ireland Data Integration.

   Data Source: Wikipedia provides publicly edited information about Northern Ireland institutions
   and governance through structured tables at https://en.wikipedia.org/wiki/Northern_Ireland_Executive.
   This module accesses historical composition data for the Northern Ireland Executive, including
   formation dates, dissolution dates, and leadership appointments since devolution began in 1999.

   Update Frequency: Wikipedia content is updated continuously by volunteer editors as political
   events occur. Executive composition changes are typically reflected within days of official
   announcements. The module specifically parses the "Historical composition of the Northern Ireland
   Executive" table which maintains a comprehensive record of all executives since devolution.

   .. rubric:: Example

   Extract NI Executive historical data and analyze political stability:

       >>> from bolster.data_sources import wikipedia
       >>> executives = wikipedia.get_ni_executive_basic_table()
       >>> 'Duration' in executives.columns
       True
       >>> len(executives) > 0
       True

   This module provides utilities for analyzing Northern Ireland's political history and executive
   stability patterns since the establishment of devolved government.



Attributes
----------

.. autoapisummary::

   bolster.data_sources.wikipedia.logger


Functions
---------

.. autoapisummary::

   bolster.data_sources.wikipedia.get_ni_executive_basic_table


Module Contents
---------------

.. py:data:: logger

.. py:function:: get_ni_executive_basic_table()

   Get Northern Ireland Executive composition data from Wikipedia.

   Extracts historical data from the "Historical composition of the Northern Ireland Executive"
   table at: https://en.wikipedia.org/wiki/Northern_Ireland_Executive#Composition_since_devolution

   :returns:

             - Established: datetime64[ns] - When the executive was formed
             - Dissolved: datetime64[ns] - When the executive ended
             - Duration: timedelta64[ns] - How long the executive lasted
             - Interregnum: timedelta64[ns] - Gap until next executive
   :rtype: DataFrame with Executive index and columns

   .. rubric:: Example

   >>> df = get_ni_executive_basic_table()
   >>> sorted(df.columns.tolist())
   ['Dissolved', 'Duration', 'Established', 'Interregnum']
   >>> len(df) > 0
   True