solidaritytechtools 0.0.2__py3-none-any.whl

solidaritytechtools/client/base_client.py

@@ -0,0 +1,452 @@
+from typing import Any, Final
+
+import httpx
+from pydantic import BaseModel
+
+from .models import (
+    EventRsvpCreate,
+    EventRsvpUpdate,
+    ScheduledTaskCreate,
+    UserCreate,
+    UserNoteCreate,
+    UserUpdate,
+)
+
+DEFAULT_V1_ST_API_BASE_URL: Final[str] = "https://api.solidarity.tech/v1/"
+
+
+class STClient:
+    def __init__(
+        self,
+        api_key: str | None = None,
+        base_url: str | None = None,
+    ):
+        """
+        Initializes the Solidarity Tech API client.
+
+        Args:
+            api_key: Optional API key. If not provided, it will be loaded
+                from the ST_API_KEY env var.
+            base_url: Optional base URL. If not provided, it will be loaded o
+                from ST_BASE_URL env var or default.
+        """
+        if not api_key:
+            raise ValueError("Must pass api_key")
+        self.api_key: str = api_key
+
+        if not base_url:
+            base_url = DEFAULT_V1_ST_API_BASE_URL
+        self.base_url: str = base_url
+
+        self._client = httpx.Client(
+            base_url=self.base_url,
+            headers={
+                "Authorization": f"Bearer {self.api_key}",
+                "Accept": "application/json",
+            },
+        )
+
+    # --- HTTP Helpers ---
+
+    def _get(self, path: str, params: dict[str, Any] | None = None) -> Any:
+        response = self._client.get(path, params=params)
+        response.raise_for_status()
+        return response.json()
+
+    def _post(self, path: str, json: dict[str, Any] | None = None) -> Any:
+        response = self._client.post(path, json=json)
+        response.raise_for_status()
+        return response.json()
+
+    def _put(self, path: str, json: dict[str, Any] | None = None) -> Any:
+        response = self._client.put(path, json=json)
+        response.raise_for_status()
+        return response.json()
+
+    def _delete(self, path: str, params: dict[str, Any] | None = None) -> Any:
+        response = self._client.delete(path, params=params)
+        response.raise_for_status()
+        return response.json()
+
+    def _build_params(
+        self,
+        limit: int = 20,
+        offset: int = 0,
+        since: int = 0,
+        extra: dict[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        params = {"_limit": limit, "_offset": offset, "_since": since}
+        if extra:
+            params.update({k: v for k, v in extra.items() if v is not None})
+        return params
+
+    def _to_dict(self, data: BaseModel | dict[str, Any]) -> dict[str, Any]:
+        if isinstance(data, BaseModel):
+            return data.model_dump(exclude_unset=True)
+        return data
+
+    # --- Users ---
+
+    def get_users(
+        self,
+        limit: int = 20,
+        offset: int = 0,
+        since: int = 0,
+        user_list_ids: list[int] | str | None = None,
+    ) -> list[dict[str, Any]]:
+        extra = {}
+        if user_list_ids:
+            extra["user_list_ids"] = (
+                ",".join([str(i) for i in user_list_ids])
+                if isinstance(user_list_ids, list)
+                else user_list_ids
+            )
+        params = self._build_params(limit, offset, since, extra)
+        return self._get("users", params=params)
+
+    def get_user(self, user_id: int) -> dict[str, Any]:
+        return self._get(f"users/{user_id}")
+
+    def create_user(self, user_data: UserCreate | dict[str, Any]) -> dict[str, Any]:
+        return self._post("users", json=self._to_dict(user_data))
+
+    def update_user(self, user_id: int, user_data: UserUpdate | dict[str, Any]) -> dict[str, Any]:
+        return self._put(f"users/{user_id}", json=self._to_dict(user_data))
+
+    # --- Activities ---
+
+    def get_activities(self, limit: int = 20, offset: int = 0, since: int = 0) -> dict[str, Any]:
+        return self._get("activities", params=self._build_params(limit, offset, since))
+
+    # --- Agent Assignments ---
+
+    def get_agent_assignments(
+        self,
+        limit: int = 20,
+        offset: int = 0,
+        since: int = 0,
+        user_id: int | None = None,
+        agent_user_id: int | None = None,
+    ) -> list[dict[str, Any]]:
+        extra = {"user_id": user_id, "agent_user_id": agent_user_id}
+        params = self._build_params(limit, offset, since, extra)
+        return self._get("agent_assignments", params=params)
+
+    def create_agent_assignment(self, data: dict[str, Any]) -> dict[str, Any]:
+        return self._post("agent_assignments", json=data)
+
+    def update_agent_assignment(self, assignment_id: int, data: dict[str, Any]) -> dict[str, Any]:
+        return self._put(f"agent_assignments/{assignment_id}", json=data)
+
+    def delete_agent_assignment(self, assignment_id: int) -> dict[str, Any]:
+        return self._delete(f"agent_assignments/{assignment_id}")
+
+    # --- Calls ---
+
+    def get_calls(
+        self,
+        limit: int = 20,
+        offset: int = 0,
+        since: int = 0,
+        user_id: int | None = None,
+    ) -> list[dict[str, Any]]:
+        extra = {"user_id": user_id}
+        params = self._build_params(limit, offset, since, extra)
+        return self._get("calls", params=params)
+
+    # --- Chapters ---
+
+    def get_chapters(
+        self, limit: int = 20, offset: int = 0, since: int = 0
+    ) -> list[dict[str, Any]]:
+        return self._get("chapters", params=self._build_params(limit, offset, since))
+
+    def get_chapter_phone_numbers(
+        self, limit: int = 20, offset: int = 0, since: int = 0
+    ) -> list[dict[str, Any]]:
+        return self._get("chapter_phone_numbers", params=self._build_params(limit, offset, since))
+
+    # --- Custom User Properties ---
+
+    def get_custom_user_properties(
+        self, limit: int = 20, offset: int = 0, since: int = 0
+    ) -> list[dict[str, Any]]:
+        return self._get("custom_user_properties", params=self._build_params(limit, offset, since))
+
+    # --- Donations ---
+
+    def get_donation_charges(
+        self, limit: int = 20, offset: int = 0, since: int = 0
+    ) -> list[dict[str, Any]]:
+        return self._get("donation_charges", params=self._build_params(limit, offset, since))
+
+    def get_donation_charge(self, charge_id: int) -> dict[str, Any]:
+        return self._get(f"donation_charges/{charge_id}")
+
+    # --- Events & RSVPs ---
+
+    def get_events(self, limit: int = 20, offset: int = 0, since: int = 0) -> list[dict[str, Any]]:
+        return self._get("events", params=self._build_params(limit, offset, since))
+
+    def get_event(self, event_id: int) -> dict[str, Any]:
+        return self._get(f"events/{event_id}")
+
+    def get_event_sessions(
+        self, limit: int = 20, offset: int = 0, since: int = 0
+    ) -> list[dict[str, Any]]:
+        return self._get("event_sessions", params=self._build_params(limit, offset, since))
+
+    def get_event_rsvps(
+        self,
+        limit: int = 20,
+        offset: int = 0,
+        since: int = 0,
+        event_id: int | None = None,
+        user_id: int | None = None,
+    ) -> list[dict[str, Any]]:
+        extra = {"event_id": event_id, "user_id": user_id}
+        params = self._build_params(limit, offset, since, extra)
+        return self._get("event_rsvps", params=params)
+
+    def create_event_rsvp(self, rsvp_data: EventRsvpCreate | dict[str, Any]) -> dict[str, Any]:
+        return self._post("event_rsvps", json=self._to_dict(rsvp_data))
+
+    def update_event_rsvp(
+        self, rsvp_id: int, rsvp_data: EventRsvpUpdate | dict[str, Any]
+    ) -> dict[str, Any]:
+        return self._put(f"event_rsvps/{rsvp_id}", json=self._to_dict(rsvp_data))
+
+    # --- User Actions ---
+
+    def submit_user_action(self, action_data: dict[str, Any]) -> dict[str, Any]:
+        """
+        Submits a user action (e.g., form submission, petition signature).
+        Matches POST /user_actions.
+        """
+        return self._post("user_actions", json=action_data)
+
+    # --- Texts ---
+
+    def get_texts(
+        self,
+        limit: int = 20,
+        offset: int = 0,
+        since: int = 0,
+        user_id: int | None = None,
+    ) -> list[dict[str, Any]]:
+        extra = {"user_id": user_id}
+        params = self._build_params(limit, offset, since, extra)
+        return self._get("texts", params=params)
+
+    def create_text(self, text_data: dict[str, Any]) -> dict[str, Any]:
+        return self._post("texts", json=text_data)
+
+    # --- Emails ---
+
+    def send_email(self, email_data: dict[str, Any]) -> dict[str, Any]:
+        return self._post("emails", json=email_data)
+
+    def get_email_blasts(
+        self, limit: int = 20, offset: int = 0, since: int = 0
+    ) -> list[dict[str, Any]]:
+        return self._get("email_blasts", params=self._build_params(limit, offset, since))
+
+    # --- Scheduled Tasks ---
+
+    def get_scheduled_tasks(
+        self,
+        limit: int = 20,
+        offset: int = 0,
+        since: int = 0,
+        user_id: int | None = None,
+        agent_user_id: int | None = None,
+    ) -> list[dict[str, Any]]:
+        extra = {"user_id": user_id, "agent_user_id": agent_user_id}
+        params = self._build_params(limit, offset, since, extra)
+        return self._get("scheduled_tasks", params=params)
+
+    def create_scheduled_task(
+        self, task_data: ScheduledTaskCreate | dict[str, Any]
+    ) -> dict[str, Any]:
+        return self._post("scheduled_tasks", json=self._to_dict(task_data))
+
+    def update_scheduled_task(self, task_id: int, task_data: dict[str, Any]) -> dict[str, Any]:
+        return self._put(f"scheduled_tasks/{task_id}", json=task_data)
+
+    # --- User Notes ---
+
+    def create_user_note(self, note_data: UserNoteCreate | dict[str, Any]) -> dict[str, Any]:
+        return self._post("user_notes", json=self._to_dict(note_data))
+
+    def delete_user_note(self, note_id: int) -> dict[str, Any]:
+        return self._delete(f"user_notes/{note_id}")
+
+    # --- Organizations ---
+
+    def get_organizations(
+        self, limit: int = 20, offset: int = 0, since: int = 0
+    ) -> list[dict[str, Any]]:
+        return self._get("organizations", params=self._build_params(limit, offset, since))
+
+    # --- Automation Enrollments ---
+
+    def enroll_in_automation(self, enrollment_data: dict[str, Any]) -> dict[str, Any]:
+        return self._post("automation_enrollments", json=enrollment_data)
+
+    # --- Phonebanks & Textbanks ---
+
+    def get_phonebanks(
+        self, limit: int = 20, offset: int = 0, since: int = 0
+    ) -> list[dict[str, Any]]:
+        return self._get("phonebanks", params=self._build_params(limit, offset, since))
+
+    def get_phonebank(self, phonebank_id: int) -> dict[str, Any]:
+        return self._get(f"phonebanks/{phonebank_id}")
+
+    def get_textbanks(
+        self, limit: int = 20, offset: int = 0, since: int = 0
+    ) -> list[dict[str, Any]]:
+        return self._get("textbanks", params=self._build_params(limit, offset, since))
+
+    def get_textbank(self, textbank_id: int) -> dict[str, Any]:
+        return self._get(f"textbanks/{textbank_id}")
+
+    def get_text_blasts(
+        self, limit: int = 20, offset: int = 0, since: int = 0
+    ) -> list[dict[str, Any]]:
+        return self._get("text_blasts", params=self._build_params(limit, offset, since))
+
+    def get_text_blast(self, text_blast_id: int) -> dict[str, Any]:
+        return self._get(f"text_blasts/{text_blast_id}")
+
+    # --- User Lists ---
+
+    def get_user_lists(
+        self, limit: int = 20, offset: int = 0, since: int = 0
+    ) -> list[dict[str, Any]]:
+        return self._get("user_lists", params=self._build_params(limit, offset, since))
+
+    def create_user_list(self, data: dict[str, Any]) -> dict[str, Any]:
+        return self._post("user_lists", json=data)
+
+    def get_user_list(self, list_id: int) -> dict[str, Any]:
+        return self._get(f"user_lists/{list_id}")
+
+    def update_user_list(self, list_id: int, data: dict[str, Any]) -> dict[str, Any]:
+        return self._put(f"user_lists/{list_id}", json=data)
+
+    def delete_user_list(self, list_id: int) -> dict[str, Any]:
+        return self._delete(f"user_lists/{list_id}")
+
+    # --- Relationships ---
+
+    def get_user_relationships(self, user_id: int) -> list[dict[str, Any]]:
+        return self._get("user_relationships", params={"user_id": user_id})
+
+    def create_user_relationship(self, data: dict[str, Any]) -> dict[str, Any]:
+        return self._post("user_relationships", json=data)
+
+    def delete_user_relationship(self, relationship_id: int, user_id: int) -> dict[str, Any]:
+        return self._delete(f"user_relationships/{relationship_id}", params={"user_id": user_id})
+
+    # --- Task Agents & Assignments ---
+
+    def get_task_agents(
+        self, limit: int = 20, offset: int = 0, since: int = 0
+    ) -> list[dict[str, Any]]:
+        return self._get("task_agents", params=self._build_params(limit, offset, since))
+
+    def create_task_agent(self, data: dict[str, Any]) -> dict[str, Any]:
+        return self._post("task_agents", json=data)
+
+    def get_task_agent(self, agent_id: int) -> dict[str, Any]:
+        return self._get(f"task_agents/{agent_id}")
+
+    def delete_task_agent(self, agent_id: int) -> dict[str, Any]:
+        return self._delete(f"task_agents/{agent_id}")
+
+    def get_task_assignments(
+        self, limit: int = 20, offset: int = 0, since: int = 0
+    ) -> list[dict[str, Any]]:
+        return self._get("task_assignments", params=self._build_params(limit, offset, since))
+
+    def create_task_assignment(self, data: dict[str, Any]) -> dict[str, Any]:
+        return self._post("task_assignments", json=data)
+
+    def get_task_assignment(self, assignment_id: int) -> dict[str, Any]:
+        return self._get(f"task_assignments/{assignment_id}")
+
+    def update_task_assignment(self, assignment_id: int, data: dict[str, Any]) -> dict[str, Any]:
+        return self._put(f"task_assignments/{assignment_id}", json=data)
+
+    def delete_task_assignment(self, assignment_id: int) -> dict[str, Any]:
+        return self._delete(f"task_assignments/{assignment_id}")
+
+    # --- Team Members ---
+
+    def get_team_members(
+        self, limit: int = 20, offset: int = 0, since: int = 0
+    ) -> list[dict[str, Any]]:
+        return self._get("team_members", params=self._build_params(limit, offset, since))
+
+    def create_team_member(self, data: dict[str, Any]) -> dict[str, Any]:
+        return self._post("team_members", json=data)
+
+    def update_team_member(self, member_id: int, data: dict[str, Any]) -> dict[str, Any]:
+        return self._put(f"team_members/{member_id}", json=data)
+
+    # --- Text Templates ---
+
+    def get_text_templates(
+        self, limit: int = 20, offset: int = 0, since: int = 0
+    ) -> list[dict[str, Any]]:
+        return self._get("text_templates", params=self._build_params(limit, offset, since))
+
+    def create_text_template(self, data: dict[str, Any]) -> dict[str, Any]:
+        return self._post("text_templates", json=data)
+
+    def get_text_template(self, template_id: int) -> dict[str, Any]:
+        return self._get(f"text_templates/{template_id}")
+
+    def update_text_template(self, template_id: int, data: dict[str, Any]) -> dict[str, Any]:
+        return self._put(f"text_templates/{template_id}", json=data)
+
+    def delete_text_template(self, template_id: int) -> dict[str, Any]:
+        return self._delete(f"text_templates/{template_id}")
+
+    # --- Scheduled Calls ---
+
+    def get_scheduled_calls(
+        self, limit: int = 20, offset: int = 0, since: int = 0
+    ) -> list[dict[str, Any]]:
+        return self._get("scheduled_calls", params=self._build_params(limit, offset, since))
+
+    def get_scheduled_call(self, call_id: int) -> dict[str, Any]:
+        return self._get(f"scheduled_calls/{call_id}")
+
+    # --- Other ---
+
+    def create_field_survey_url(self, data: dict[str, Any]) -> dict[str, Any]:
+        return self._post("field_survey_urls", json=data)
+
+    def create_custom_user_property_option(
+        self, property_id: int, data: dict[str, Any]
+    ) -> dict[str, Any]:
+        return self._post(f"custom_user_properties/{property_id}/options", json=data)
+
+    def delete_custom_user_property_option(
+        self, property_id: int, option_id: int
+    ) -> dict[str, Any]:
+        return self._delete(f"custom_user_properties/{property_id}/options/{option_id}")
+
+    # --- Lifecycle ---
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self._client.close()
+
+    def close(self):
+        """Closes the underlying httpx client."""
+        self._client.close()

solidaritytechtools/client/models.py

@@ -0,0 +1,279 @@
+from datetime import datetime
+from typing import Any, Literal
+
+from pydantic import BaseModel, ConfigDict, Field
+
+ScopeType = Literal["Organization", "Chapter", "Team", "User"]
+
+
+class UserAddressUpdate(BaseModel):
+    address1: str | None = None
+    address2: str | None = None
+    city: str | None = None
+    state: str | None = None
+    zip_code: str | None = None
+    country: str | None = None
+    latitude: float | None = None
+    longitude: float | None = None
+
+
+class UserUpdate(BaseModel):
+    phone_number: str | None = None
+    email: str | None = None
+    first_name: str | None = None
+    last_name: str | None = None
+    preferred_language: str | None = None
+    chapter_id: int | None = None
+    chapter_ids: list[int] | None = None
+    add_chapter_ids: list[int] | None = None
+    remove_chapter_ids: list[int] | None = None
+    set_exclusive_chapter: bool | None = None
+    second_language: str | None = None
+    referred_by_user_id: int | None = None
+    custom_user_properties: dict[str, str] | None = None
+    address: UserAddressUpdate | None = None
+    sms_permission: bool | None = None
+    call_permission: bool | None = None
+    email_permission: bool | None = None
+    timezone: str | None = None
+
+
+class UserCreate(BaseModel):
+    phone_number: str | None = None
+    email: str | None = None
+    first_name: str | None = None
+    last_name: str | None = None
+    preferred_language: str | None = "en"
+    second_language: str | None = None
+    chapter_id: int | None = None
+    chapter_ids: list[int] | None = None
+    referred_by_user_id: int | None = None
+    custom_user_properties: dict[str, str] | None = None
+    add_tags: list[str] | None = None
+    remove_tags: list[str] | None = None
+    address: UserAddressUpdate | None = None
+    sms_permission: bool | None = None
+    call_permission: bool | None = None
+    email_permission: bool | None = None
+    timezone: str | None = None
+
+
+class EventRsvpCreate(BaseModel):
+    event_id: int
+    event_session_id: int | None = None
+    user_id: int
+    is_attending: Literal["yes", "no", "maybe"] | None = "yes"
+    is_confirmed: bool | None = False
+    agent_user_id: int | None = None
+    source: str | None = None
+    source_system: str | None = None
+    skip_email_confirmation: bool | None = False
+
+
+class EventRsvpUpdate(BaseModel):
+    is_attending: Literal["yes", "no", "maybe"] | None = None
+    is_confirmed: bool | None = None
+    agent_user_id: int | None = None
+    source: str | None = None
+    source_system: str | None = None
+
+
+class ScheduledTaskCreate(BaseModel):
+    due_at: int | None = None
+    remind_at: int | None = None
+    agent_user_id: int | None = None
+    user_id: int
+    notes: str | None = None
+    marked_as_completed: bool | None = False
+
+
+class UserNoteCreate(BaseModel):
+    content: str
+    user_id: int
+    agent_user_id: int | None = None
+
+
+class TextMessage(BaseModel):
+    sent_at: int
+    content: str
+    direction: Literal["in", "out"] | None = None
+
+
+class CallRecord(BaseModel):
+    called_at: int
+    duration: int
+    notes: str | None = None
+
+
+class Note(BaseModel):
+    id: int
+    content: str
+    agent_user_id: int
+    created_at: datetime
+    updated_at: datetime
+
+
+class Donation(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+
+class Person(BaseModel):
+    model_config = ConfigDict(
+        populate_by_name=True,
+        extra="allow",
+    )
+
+    id: int
+    name: str
+    first_name: str
+    last_name: str
+
+    phone_number: str | None = None
+    email: str | None = None
+
+    chapter: str | None = None
+    preferred_language: str | None = None
+
+    full_address: str | None = None
+    address1: str | None = None
+    address2: str | None = None
+    city: str | None = None
+    state: str | None = None
+    postal_code: str | None = None
+    country: str | None = None
+
+    created_at: datetime
+    paid_dues_since: datetime | None = None
+    last_ip_address: str | None = None
+
+    tags: list[str] = Field(default_factory=list)
+
+    yes_rsvp_count: int | None = None
+    confirmed_rsvp_count: int | None = None
+
+    most_recent_yes_rsvp_session: str | None = None
+    most_recent_confirmed_yes_rsvp_session: str | None = None
+
+    action_interests: str | None = Field(default=None, alias="action-interests")
+    cause_interests: str | None = Field(default=None, alias="cause-interests")
+
+    # list_date: date | None = Field(
+    #    default=None, alias="list-date"
+    # )
+
+    membership_status: str | None = Field(default=None, alias="membership-status")
+
+    ydsa_chapter: str | None = Field(default=None, alias="ydsa-chapter")
+
+    texts: list[TextMessage] = Field(default_factory=list)
+    calls: list[CallRecord] = Field(default_factory=list)
+    notes: list[Note] = Field(default_factory=list)
+    donations: list[Donation] = Field(default_factory=list)
+
+
+class Chapter(BaseModel):
+    id: int
+    name: str
+    logo_url: str | None = None
+    organization_id: int
+    chapter_phone_number: str | None = None
+
+
+class Organization(BaseModel):
+    id: int
+    name: str
+    image_url: str | None = None
+    parent_organization_id: int | None = None
+    default_language: str | None = None
+    supported_languages: list[str] | None = None
+
+
+class User(BaseModel):
+    id: int
+    hash_id: str | None = None
+    phone_number: str | None = None
+    email: str | None = None
+    first_name: str | None = None
+    last_name: str | None = None
+    preferred_language: str
+    second_language: str | None = None
+    chapter_id: int | None = None
+    chapter_ids: list[int] = Field(default_factory=list)
+    branch_id: int | None = None
+    created_at: datetime
+    custom_user_properties: dict[str, str] = Field(default_factory=dict)
+    address: dict[str, Any] | None = None
+    sms_permission: bool = False
+    call_permission: bool = False
+    email_permission: bool = False
+
+
+class EventSession(BaseModel):
+    id: int
+    event_id: int
+    start_time: datetime
+    end_time: datetime
+    title: str | None = None
+    location_name: str | None = None
+    location_address: str | None = None
+
+
+class Event(BaseModel):
+    id: int
+    title: str
+    scope_id: int
+    scope_type: ScopeType
+    event_type: str
+    location_name: str | None = None
+    created_at: datetime
+
+
+class Call(BaseModel):
+    id: int
+    user_id: int
+    direction: str
+    agent_user_id: int | None = None
+    duration: int
+    picked_up: bool
+    left_voicemail: bool
+    created_at: datetime
+
+
+class Text(BaseModel):
+    id: int
+    user_id: int
+    direction: str
+    body: str | None = None
+    media_urls: list[str] = Field(default_factory=list)
+    created_at: datetime
+
+
+class UserNote(BaseModel):
+    id: int
+    content: str
+    user_id: int
+
+
+class DonationCharge(BaseModel):
+    id: int
+    amount: int
+
+    success: bool
+    refunded: bool
+    created_at: datetime
+    user: dict[str, Any] | None = None
+
+
+class Activity(BaseModel):
+    id: int
+    user_id: int
+    name: str
+    actionable_id: int
+    actionable_type: str
+    created_at: datetime
+
+
+class ChapterPhoneNumber(BaseModel):
+    phone_number: str
+    assigned_user_count: int | None = None
+    created_at: datetime

solidaritytechtools-0.0.2.dist-info/METADATA

@@ -0,0 +1,42 @@
+Metadata-Version: 2.4
+Name: solidaritytechtools
+Version: 0.0.2
+Summary: Add your description here
+Requires-Python: >=3.14
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pydantic>=2.12.5
+Description-Content-Type: text/markdown
+
+# Solidarity Tech Tools
+
+A python library to help you automate solidarity tech (ST).
+
+This is still in beta, and there is a bit more work to do. But you can still use this in production if you are bold.
+
+## Features
+
+### Client  
+Call python methods to interact with the ST api. You can pass pydantic models and receive pydantic models in return, so you can rely on the response structure.
+
+## Todo: Contact Matching
+Given a contact export and a ST account with contacts, attempt to match the two, so you can perform operations.
+
+This is useful for example if you want to export migrate resources from one ST account to another.
+
+## Using
+
+1. Add `solidaritytechtools` as a dependency via `uv add solidaritytechtools`, `pip install solidaritytechtools`, etc
+2. Initialize the client with the api key: `st_client = STClient(api_key="...")`
+3. Perform calls, like `st_client.get_users()`
+
+## Contributing
+
+1. Clone the repo 
+2. Install pre-commit hooks (`uv run pre-commit install`)
+3. Start coding and make a MR :)
+
+Please use `ty` to check the type safety of your code. When possible, this will be added to pre-commit hooks.
+
+## Publishing
+
+1. `uv build`

solidaritytechtools-0.0.2.dist-info/RECORD

@@ -0,0 +1,6 @@
+solidaritytechtools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+solidaritytechtools/client/base_client.py,sha256=fO-dJ-hh-FzKZhM3A-91rj4JE-zMXwl6BxsrQmlYtZA,16403
+solidaritytechtools/client/models.py,sha256=sJzje0srV5Wy_FfuV0CPkdS0ZD_iel7g9n01tGugNYQ,7121
+solidaritytechtools-0.0.2.dist-info/METADATA,sha256=KAUMTV5CsqJw8jxn_iXm1xoTSImVP55t0yGX72i8Uls,1379
+solidaritytechtools-0.0.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+solidaritytechtools-0.0.2.dist-info/RECORD,,

solidaritytechtools-0.0.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any