Airmeet Event Details connector with tests and documentation (#1077)

* Airmeet Event Details connector with tests and documentation

* Handle when list of booths is null. Add tests for session and replay attendance exceptions.

* Fix naming and formatting

* Fix long lines.

* add airmeet docs to sidebar

* Added notes indicating untested methods related to booths and event tracks (features that are available only in certain Airmeet plans).

---------

Co-authored-by: Cody Gordon <[email protected]>

docs/airmeet.rst

@@ -0,0 +1,63 @@
+Airmeet
+=======
+
+********
+Overview
+********
+
+`Airmeet <https://www.airmeet.com/>`_ is a webinar platform. This connector supports
+fetching events ("Airmeets"), sessions, participants, and other event data via the
+`Airmeet Public API for Event Details <https://help.airmeet.com/support/solutions/articles/82000909768-1-event-details-airmeet-public-api>`_.
+
+.. note::
+  Authentication
+    You must create an Access Key and Secret Key via the Airmeet website. These are used by the ``Airmeet`` class to fetch
+    an access token which is used for subsequent interactions with the API. There are three region-based API endpoints; see
+    the `Airmeet API documentation <https://help.airmeet.com/support/solutions/articles/82000909768-1-event-details-airmeet-public-api#3.-Authentication%C2%A0>`_ for details.
+
+***********
+Quick Start
+***********
+
+To instantiate the ``Airmeet`` class, you can either store your API endpoint, access key, and secret key as environmental
+variables (``AIRMEET_URI``, ``AIRMEET_ACCESS_KEY``, ``AIRMEET_SECRET_KEY``) or pass them in as arguments.
+
+.. code-block:: python
+
+  from parsons import Airmeet
+
+  # First approach: Use API credentials via environmental variables
+  airmeet = Airmeet()
+
+  # Second approach: Pass API credentials as arguments (airmeet_uri is optional)
+  airmeet = Airmeet(
+    airmeet_uri='https://api-gateway.airmeet.com/prod',
+    airmeet_access_key="my_access_key",
+    airmeet_secret_key="my_secret_key
+  )
+
+You can then call various endpoints:
+
+.. code-block:: python
+
+  # Fetch the list of Airmeets.
+  events_tbl = airmeet.list_airmeets()
+
+  # Fetch the list of sessions in an Airmeet.
+  sessions_tbl = airmeet.fetch_airmeet_sessions("my_airmeet_id")
+
+  # Fetch the list of registrations for an Airmeet, sorted in order
+  # of registration date.
+  participants_tbl = airmeet.fetch_airmeet_participants(
+    "my_airmeet_id", sorting_direction="ASC"
+  )
+
+  # Fetch the list of session attendees.
+  session_attendees_tbl = airmeet.fetch_session_attendance("my_session_id")
+
+***
+API
+***
+
+.. autoclass :: parsons.Airmeet
+   :inherited-members:

docs/index.rst

@@ -182,6 +182,7 @@ Indices and tables
    action_kit
    action_builder
    action_network
+   airmeet
    airtable
    alchemer
    auth0

parsons/__init__.py

@@ -31,6 +31,7 @@
     ("parsons.action_kit.action_kit", "ActionKit"),
     ("parsons.action_builder.action_builder", "ActionBuilder"),
     ("parsons.action_network.action_network", "ActionNetwork"),
+    ("parsons.airmeet.airmeet", "Airmeet"),
     ("parsons.airtable.airtable", "Airtable"),
     ("parsons.alchemer.alchemer", "Alchemer"),
     ("parsons.alchemer.alchemer", "SurveyGizmo"),

parsons/airmeet/__init__.py

@@ -0,0 +1,3 @@
+from parsons.airmeet.airmeet import Airmeet
+
+__all__ = ["Airmeet"]