WIP: Solidarity.Tech Connector

docs/conf.py

@@ -92,6 +92,7 @@
     "psycopg2-binary": ("https://www.psycopg.org/docs/", None),
     "pyairtable": ("https://pyairtable.readthedocs.io/en/stable/", None),
     "PyGitHub": ("https://pygithub.readthedocs.io/en/latest/", None),
+    "pyratelimiter": ("https://pyratelimiter.readthedocs.io/en/latest/", None),
     "requests-toolbelt": ("https://toolbelt.readthedocs.io/en/stable/", None),
     "rich": ("https://rich.readthedocs.io/en/stable/", None),
     "simple-salesforce": ("https://simple-salesforce.readthedocs.io/en/latest/", None),

docs/framework/utilities.rst

@@ -132,6 +132,13 @@ OAuth API Connector
    :inherited-members:
    :members:
 
+Rate-Limited API Connector
+==========================
+
+.. automodule:: parsons.utilities.ratelimited_api_connector
+   :inherited-members:
+   :members:
+
 SQL Helpers
 ===========
 

docs/index.rst

@@ -187,6 +187,7 @@ Indices and tables
    sftp
    shopify
    sisense
+   solidarity_tech
    targetsmart
    turbovote
    twilio

docs/solidarity_tech.rst

@@ -0,0 +1,54 @@
+###############
+Solidarity Tech
+###############
+
+Overview
+========
+
+Solidarity Tech's all-in-one nonprofit CRM includes digital tools like
+texting, calling, email & websites for advocacy groups, unions & grassroots organizers.
+
+As of September 2026, the :class:`~parsons.solidarity_tech.solidarity_tech.SolidarityTech` connector supports
+all endpoints described in the `Solidarity Tech API Documentation <https://www.solidarity.tech/reference/solidarity-tech-api>`_.
+
+Quickstart
+==========
+
+To instantiate the :class:`~parsons.solidarity_tech.solidarity_tech.SolidarityTech` class,
+you can either store your Solidarity Tech bearer authorization key as
+an environmental variable (``SOLIDARITY_TECH_BEARER_KEY``) or pass it as a keyword argument.
+
+.. code-block:: python
+   :caption: Load bearer authorization key from environment variable
+
+   from parsons import SolidarityTech
+   st = SolidarityTech()
+
+.. code-block:: python
+   :caption: Pass bearer authorization key as argument
+
+   from parsons import SolidarityTech
+   st = SolidarityTech(api_token='SOME_BEARER_KEY')
+
+You can then call various endpoints:
+
+.. code-block:: python
+   :caption: Get all events
+
+   events = st.get_events()
+
+.. code-block:: python
+   :caption: Create a new user
+
+   st.create_user(
+       first_name="Elizabeth",
+       last_name="Flynn",
+       email="egflynn@example.com"
+   )
+
+API
+====
+
+.. autoclass:: parsons.solidarity_tech.solidarity_tech.SolidarityTech
+   :inherited-members:
+   :members:

parsons/__init__.py

@@ -100,6 +100,7 @@
     "SFTP": "parsons.sftp.sftp",
     "Shopify": "parsons.shopify.shopify",
     "Sisense": "parsons.sisense.sisense",
+    "SolidarityTech": "parsons.solidarity_tech.solidarity_tech",
     "TargetSmartAPI": "parsons.targetsmart.targetsmart_api",
     "TargetSmartAutomation": "parsons.targetsmart.targetsmart_automation",
     "TurboVote": "parsons.turbovote.turbovote",

parsons/solidarity_tech/__init__.py

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

parsons/solidarity_tech/exceptions.py

@@ -0,0 +1,35 @@
+import requests
+from requests.exceptions import HTTPError
+
+
+class STResponseError(HTTPError):
+    """Base exception for all Solidarity Tech response errors."""
+
+    def __init__(
+        self, message: str | None = None, *args, err_msg: str, response: requests.Response, **kwargs
+    ) -> None:
+        if response.status_code:
+            err_msg += f" (Status Code {response.status_code})"
+        if message:
+            err_msg += f" -- {message}"
+        super().__init__(err_msg, *args, **kwargs)
+
+
+class STUnexpectedResponseError(STResponseError):
+    """Status code is not expected."""
+
+    def __init__(
+        self, message: str | None = None, *args, response: requests.Response, **kwargs
+    ) -> None:
+        err_msg = "Unexpected Response"
+        super().__init__(message, *args, err_msg=err_msg, response=response, **kwargs)
+
+
+class STFailedResponseError(STResponseError):
+    """Status code indicates a known failure."""
+
+    def __init__(
+        self, message: str | None = None, *args, response: requests.Response, **kwargs
+    ) -> None:
+        err_msg = "Request Failed"
+        super().__init__(message, *args, err_msg=err_msg, response=response, **kwargs)

parsons/solidarity_tech/solidarity_tech.py

@@ -0,0 +1,77 @@
+from __future__ import annotations
+
+import logging
+
+from parsons.solidarity_tech.st_activities import SolidarityTechActivities
+from parsons.solidarity_tech.st_agent_assignments import SolidarityTechAgentAssignments
+from parsons.solidarity_tech.st_automation_enrollments import SolidarityTechAutomationEnrollments
+from parsons.solidarity_tech.st_calls import SolidarityTechCalls
+from parsons.solidarity_tech.st_chapter_phone_numbers import SolidarityTechChapterPhoneNumbers
+from parsons.solidarity_tech.st_chapters import SolidarityTechChapters
+from parsons.solidarity_tech.st_custom_user_properties import SolidarityTechCustomUserProperties
+from parsons.solidarity_tech.st_donation_charges import SolidarityTechDonationCharges
+from parsons.solidarity_tech.st_email_blasts import SolidarityTechEmailBlasts
+from parsons.solidarity_tech.st_email_senders import SolidarityTechEmailSenders
+from parsons.solidarity_tech.st_emails import SolidarityTechEmails
+from parsons.solidarity_tech.st_event_attendances import SolidarityTechEventAttendances
+from parsons.solidarity_tech.st_event_rsvps import SolidarityTechEventRSVPs
+from parsons.solidarity_tech.st_event_sessions import SolidarityTechEventSessions
+from parsons.solidarity_tech.st_events import SolidarityTechEvents
+from parsons.solidarity_tech.st_field_survey_urls import SolidarityTechFieldSurveyURLs
+from parsons.solidarity_tech.st_organizations import SolidarityTechOrganizations
+from parsons.solidarity_tech.st_pages import SolidarityTechPages
+from parsons.solidarity_tech.st_phonebanks import SolidarityTechPhonebanks
+from parsons.solidarity_tech.st_scheduled_calls import SolidarityTechScheduledCalls
+from parsons.solidarity_tech.st_scheduled_tasks import SolidarityTechScheduledTasks
+from parsons.solidarity_tech.st_task_agents import SolidarityTechTaskAgents
+from parsons.solidarity_tech.st_task_assignments import SolidarityTechTaskAssignments
+from parsons.solidarity_tech.st_team_members import SolidarityTechTeamMembers
+from parsons.solidarity_tech.st_text_blasts import SolidarityTechTextBlasts
+from parsons.solidarity_tech.st_text_templates import SolidarityTechTextTemplates
+from parsons.solidarity_tech.st_textbanks import SolidarityTechTextbanks
+from parsons.solidarity_tech.st_texts import SolidarityTechTexts
+from parsons.solidarity_tech.st_user_actions import SolidarityTechUserActions
+from parsons.solidarity_tech.st_user_lists import SolidarityTechUserLists
+from parsons.solidarity_tech.st_user_notes import SolidarityTechUserNotes
+from parsons.solidarity_tech.st_user_relationships import SolidarityTechUserRelationships
+from parsons.solidarity_tech.st_users import SolidarityTechUsers
+
+logger = logging.getLogger(__name__)
+
+
+class SolidarityTech(
+    SolidarityTechActivities,
+    SolidarityTechAgentAssignments,
+    SolidarityTechAutomationEnrollments,
+    SolidarityTechCalls,
+    SolidarityTechChapterPhoneNumbers,
+    SolidarityTechChapters,
+    SolidarityTechCustomUserProperties,
+    SolidarityTechDonationCharges,
+    SolidarityTechEmailBlasts,
+    SolidarityTechEmailSenders,
+    SolidarityTechEmails,
+    SolidarityTechEventAttendances,
+    SolidarityTechEventRSVPs,
+    SolidarityTechEventSessions,
+    SolidarityTechEvents,
+    SolidarityTechFieldSurveyURLs,
+    SolidarityTechOrganizations,
+    SolidarityTechPages,
+    SolidarityTechPhonebanks,
+    SolidarityTechScheduledCalls,
+    SolidarityTechScheduledTasks,
+    SolidarityTechTaskAgents,
+    SolidarityTechTaskAssignments,
+    SolidarityTechTeamMembers,
+    SolidarityTechTextBlasts,
+    SolidarityTechTextTemplates,
+    SolidarityTechTextbanks,
+    SolidarityTechTexts,
+    SolidarityTechUserActions,
+    SolidarityTechUserLists,
+    SolidarityTechUserNotes,
+    SolidarityTechUserRelationships,
+    SolidarityTechUsers,
+):
+    pass