Merge branch 'main' into dependabot/pip/docs/suds-py3-1.4.5.0

.github/workflows/python-checks.yml

@@ -15,7 +15,7 @@ jobs:
         strategy:
             fail-fast: false
             matrix:
-                python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+                python-version: ["3.9", "3.10", "3.11", "3.12"]
                 os: ["ubuntu-latest", "windows-latest", "macos-latest"]
                 limited-dependencies: ["", "TRUE"]
 
@@ -32,6 +32,10 @@ jobs:
             - name: Install uv
               uses: install-pinned/uv@de03c60d508703a83d3f8f49afcf1249590ecda1  # 0.4.12
 
+            - name: Patch install error when using Python 3.9, limited dependencies, and MacOS
+              if: ${{ matrix.limited-dependencies }} == True and ${{ matrix.os }} == "macos-latest" and ${{ matrix.python-version }} == "3.9"
+              run: uv pip install --system psycopg2-binary==2.9.9
+
             - name: Install dependencies
               env:
                   PARSONS_LIMITED_DEPENDENCIES: ${{ matrix.limited-dependencies }}
@@ -140,7 +144,7 @@ jobs:
         strategy:
             fail-fast: false
             matrix:
-                python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+                python-version: ["3.9", "3.10", "3.11", "3.12"]
                 os: ["ubuntu-latest", "windows-latest", "macos-latest"]
                 limited-dependencies: ["", "TRUE"]
 
@@ -160,6 +164,10 @@ jobs:
                   python-version: ${{ matrix.python-version }}
                   cache: pip
 
+            - name: Patch install error when using Python 3.9, limited dependencies, and MacOS
+              if: ${{ matrix.limited-dependencies }} == True and ${{ matrix.os }} == "macos-latest" and ${{ matrix.python-version }} == "3.9"
+              run: pip install psycopg2-binary==2.9.9
+
             - name: Install dependencies
               env:
                   PARSONS_LIMITED_DEPENDENCIES: ${{ matrix.limited-dependencies }}

.github/workflows/security_scorecard.yml

@@ -43,7 +43,7 @@ jobs:
           persist-credentials: false
 
       - name: "Run analysis"
-        uses: ossf/scorecard-action@0864cf19026789058feabb7e87baa5f140aac736 # v2.3.1
+        uses: ossf/scorecard-action@62b2cac7ed8198b15735ed49ab1e5cf35480ba46 # v2.4.0
         with:
           results_file: results.sarif
           results_format: sarif

Dockerfile

@@ -1,4 +1,4 @@
-FROM --platform=linux/amd64 python:3.8
+FROM --platform=linux/amd64 python:3.11
 
 ####################
 ## Selenium setup ##

README.md

@@ -15,7 +15,7 @@ This project is maintained by [The Movement Cooperative](https://movementcoopera
 after [Lucy Parsons](https://en.wikipedia.org/wiki/Lucy_Parsons). The Movement Cooperative is a member-led organization
 focused on providing data, tools, and strategic support for the progressive community.
 
-Parsons is only supported for Python 3.8-12.
+Parsons is only supported for Python 3.9-12.
 
 ## Table of Contents
 

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/empower.rst

@@ -0,0 +1,49 @@
+Empower
+=======
+
+********
+Overview
+********
+
+The Empower class allows you to interact with the Empower API. Documentation for the Empower API can be found
+in their `GitHub <https://github.com/getempower/api-documentation/blob/master/README.md>`_ repo.
+
+The Empower API only has a single endpoint to access all account data. As such, it has a very high overhead. This
+connector employs caching in order to allow the user to specify the tables to extract without additional API calls.
+You can disable caching as an argument when instantiating the class.
+
+.. note::
+    To authenticate, request a secret token from Empower. 
+
+==========
+Quickstart
+==========
+
+To instantiate the Empower class, you can either store your ``EMPOWER_API_KEY`` as an environment
+variables or pass it in as an argument:
+
+.. code-block:: python
+
+   from parsons import Empower
+
+   # First approach: Use API key environment variables
+
+   # In bash, set your environment variables like so:
+   # export EMPOWER_API_KEY='MY_API_KEY'
+   empower = Empower()
+
+   # Second approach: Pass API keys as arguments
+   empower = Empower(api_key='MY_API_KEY')
+
+You can then request tables in the following manner:
+
+.. code-block:: python
+
+    tbl = empower.get_profiles()
+
+***
+API
+***
+
+.. autoclass :: parsons.Empower
+   :inherited-members:

docs/index.rst

@@ -182,6 +182,7 @@ Indices and tables
    action_kit
    action_builder
    action_network
+   airmeet
    airtable
    alchemer
    auth0
@@ -199,6 +200,7 @@ Indices and tables
    crowdtangle
    databases
    donorbox
+   empower
    facebook_ads
    formstack
    freshdesk

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"),
@@ -91,6 +92,7 @@
     ("parsons.turbovote.turbovote", "TurboVote"),
     ("parsons.twilio.twilio", "Twilio"),
     ("parsons.zoom.zoom", "Zoom"),
+    ("parsons.empower.empower", "Empower"),
 ):
     try:
         globals()[connector_name] = getattr(importlib.import_module(module_path), connector_name)

parsons/airmeet/__init__.py

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