simpleapps-com-augur-api 0.8.10__py3-none-any.whl

augur_api/services/avalara/__init__.py

@@ -0,0 +1,17 @@
+"""Avalara service exports."""
+
+from augur_api.services.avalara.client import (
+    AvalaraClient,
+    RatesResource,
+)
+from augur_api.services.avalara.schemas import (
+    RatesParams,
+    TaxRate,
+)
+
+__all__ = [
+    "AvalaraClient",
+    "RatesParams",
+    "RatesResource",
+    "TaxRate",
+]

augur_api/services/avalara/client.py

@@ -0,0 +1,64 @@
+"""Avalara service client for tax rate calculations."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+from augur_api.core.schemas import BaseResponse
+from augur_api.services.avalara.schemas import (
+    TaxRate,
+)
+from augur_api.services.base import BaseServiceClient
+from augur_api.services.resource import BaseResource
+
+if TYPE_CHECKING:
+    from augur_api.core.http_client import HTTPClient
+
+
+class RatesResource(BaseResource):
+    """Resource for /rates endpoints."""
+
+    def __init__(self, http: HTTPClient) -> None:
+        """Initialize the resource."""
+        super().__init__(http, "/rates")
+
+    def create(self, data: Any) -> BaseResponse[TaxRate]:
+        """Calculate tax rates for an address.
+
+        Args:
+            data: Address parameters for tax rate calculation.
+
+        Returns:
+            BaseResponse containing tax rate information.
+        """
+        response = self._post(data=data)
+        return BaseResponse[TaxRate].model_validate(response)
+
+
+class AvalaraClient(BaseServiceClient):
+    """Client for the Avalara tax service.
+
+    Provides access to tax rate calculation endpoints.
+
+    Example:
+        >>> from augur_api import AugurAPI
+        >>> api = AugurAPI(token="...", site_id="...")
+        >>> rates = api.avalara.rates.create(RatesParams(postal_code="98101"))
+        >>> print(rates.data.total_rate)
+    """
+
+    def __init__(self, http_client: HTTPClient) -> None:
+        """Initialize the Avalara client.
+
+        Args:
+            http_client: HTTP client for making requests.
+        """
+        super().__init__(http_client)
+        self._rates: RatesResource | None = None
+
+    @property
+    def rates(self) -> RatesResource:
+        """Access tax rates endpoints."""
+        if self._rates is None:
+            self._rates = RatesResource(self._http)
+        return self._rates

augur_api/services/avalara/schemas.py

@@ -0,0 +1,34 @@
+"""Schemas for the Avalara service."""
+
+from augur_api.core.schemas import CamelCaseModel, EdgeCacheParams
+
+
+# Health Check
+class HealthCheckData(CamelCaseModel):
+    """Health check response data."""
+
+    site_hash: str | None = None
+    site_id: str | None = None
+
+
+# Rates
+class RatesParams(EdgeCacheParams):
+    """Parameters for tax rate lookup."""
+
+    line1: str | None = None
+    line2: str | None = None
+    line3: str | None = None
+    city: str | None = None
+    region: str | None = None
+    postal_code: str | None = None
+    country: str | None = None
+
+
+class TaxRate(CamelCaseModel):
+    """Tax rate response."""
+
+    total_rate: float | None = None
+    state_rate: float | None = None
+    county_rate: float | None = None
+    city_rate: float | None = None
+    special_rate: float | None = None

augur_api/services/base.py

@@ -0,0 +1,54 @@
+"""Base service client class for all Augur services."""
+
+from typing import Any
+
+from augur_api.core.http_client import HTTPClient
+from augur_api.core.schemas import BaseResponse, HealthCheckData
+
+
+class BaseServiceClient:
+    """Base client for Augur API services.
+
+    All service-specific clients inherit from this class to gain
+    common functionality like health checks and ping endpoints.
+
+    Attributes:
+        _http: The HTTP client for making requests.
+        service_name: Name of the service.
+    """
+
+    def __init__(self, http_client: HTTPClient) -> None:
+        """Initialize the service client.
+
+        Args:
+            http_client: The HTTP client for making requests.
+        """
+        self._http = http_client
+        self.service_name = http_client.service_name
+
+    def health_check(self) -> BaseResponse[HealthCheckData]:
+        """Check service health.
+
+        Returns:
+            BaseResponse containing HealthCheckData with site_hash and site_id.
+        """
+        response = self._http.get("/health-check")
+        return BaseResponse[HealthCheckData].model_validate(response)
+
+    def ping(self) -> BaseResponse[str]:
+        """Ping the service.
+
+        Returns:
+            BaseResponse containing 'pong' string.
+        """
+        response = self._http.get("/ping")
+        return BaseResponse[str].model_validate(response)
+
+    def whoami(self) -> BaseResponse[dict[str, Any]]:
+        """Get information about the authenticated user.
+
+        Returns:
+            BaseResponse containing user information.
+        """
+        response = self._http.get("/whoami")
+        return BaseResponse[dict[str, Any]].model_validate(response)

augur_api/services/basecamp2/__init__.py

@@ -0,0 +1,65 @@
+"""Basecamp2 service exports."""
+
+from augur_api.services.basecamp2.client import (
+    Basecamp2Client,
+    CommentsResource,
+    EventsResource,
+    MetricsResource,
+    PeopleResource,
+    ProjectsResource,
+    TodolistsResource,
+    TodosResource,
+    TodosSummaryResource,
+)
+from augur_api.services.basecamp2.schemas import (
+    Comment,
+    CommentCreateParams,
+    CommentListParams,
+    Event,
+    EventListParams,
+    Metric,
+    MetricsListParams,
+    Person,
+    PersonListParams,
+    Project,
+    ProjectListParams,
+    Todo,
+    TodoCreateParams,
+    Todolist,
+    TodolistListParams,
+    TodoListParams,
+    TodosSummary,
+    TodosSummaryListParams,
+    TodoUpdateParams,
+)
+
+__all__ = [
+    "Basecamp2Client",
+    "Comment",
+    "CommentCreateParams",
+    "CommentListParams",
+    "CommentsResource",
+    "Event",
+    "EventListParams",
+    "EventsResource",
+    "Metric",
+    "MetricsListParams",
+    "MetricsResource",
+    "PeopleResource",
+    "Person",
+    "PersonListParams",
+    "Project",
+    "ProjectListParams",
+    "ProjectsResource",
+    "Todo",
+    "TodoCreateParams",
+    "TodoListParams",
+    "Todolist",
+    "TodolistListParams",
+    "TodolistsResource",
+    "TodosResource",
+    "TodosSummary",
+    "TodosSummaryListParams",
+    "TodosSummaryResource",
+    "TodoUpdateParams",
+]