sanka-sdk 0.1.0__tar.gz

sanka_sdk-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+.venv/
+.ruff_cache/
+__pycache__/
+*.pyc
+build/
+dist/
+.tmp-fern/
+src/sanka_sdk/.fern/

sanka_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: sanka-sdk
+Version: 0.1.0
+Summary: Python SDK for the Sanka API.
+Project-URL: Homepage, https://sanka.com
+Project-URL: Repository, https://github.com/sankaHQ/sanka-python
+Author: Sanka
+Requires-Python: >=3.9
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: pydantic<3,>=2.7
+Requires-Dist: typing-extensions>=4.9
+Description-Content-Type: text/markdown
+
+# sanka-sdk
+
+Python SDK for the Sanka API.
+
+This package is generated from [Sanka's OpenAPI spec](/Users/haegwan/Sites/sanka/sanka-sdks/openapi.json) using Fern, then packaged locally for `uv` and PyPI.
+
+## Install
+
+```bash
+uv add sanka-sdk
+```
+
+## Usage
+
+```python
+from sanka_sdk import SankaClient
+
+client = SankaClient(token="YOUR_TOKEN")
+response = client.public_auth.whoami()
+print(response)
+```
+
+## Regenerate
+
+```bash
+./scripts/generate_sdk.sh
+```
+
+## Publish
+
+This repo includes a GitHub Actions workflow for PyPI Trusted Publishing at [.github/workflows/publish.yml](/Users/haegwan/Sites/sanka/sanka-python/.github/workflows/publish.yml).
+
+Configure a Trusted Publisher on PyPI for:
+
+- owner: `sankaHQ`
+- repository: `sanka-python`
+- workflow: `.github/workflows/publish.yml`
+- environment: `pypi`
+
+Then publish by pushing a tag like `v0.1.0` or running the workflow manually.
+

sanka_sdk-0.1.0/README.md

@@ -0,0 +1,41 @@
+# sanka-sdk
+
+Python SDK for the Sanka API.
+
+This package is generated from [Sanka's OpenAPI spec](/Users/haegwan/Sites/sanka/sanka-sdks/openapi.json) using Fern, then packaged locally for `uv` and PyPI.
+
+## Install
+
+```bash
+uv add sanka-sdk
+```
+
+## Usage
+
+```python
+from sanka_sdk import SankaClient
+
+client = SankaClient(token="YOUR_TOKEN")
+response = client.public_auth.whoami()
+print(response)
+```
+
+## Regenerate
+
+```bash
+./scripts/generate_sdk.sh
+```
+
+## Publish
+
+This repo includes a GitHub Actions workflow for PyPI Trusted Publishing at [.github/workflows/publish.yml](/Users/haegwan/Sites/sanka/sanka-python/.github/workflows/publish.yml).
+
+Configure a Trusted Publisher on PyPI for:
+
+- owner: `sankaHQ`
+- repository: `sanka-python`
+- workflow: `.github/workflows/publish.yml`
+- environment: `pypi`
+
+Then publish by pushing a tag like `v0.1.0` or running the workflow manually.
+

sanka_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["hatchling>=1.27.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "sanka-sdk"
+version = "0.1.0"
+description = "Python SDK for the Sanka API."
+readme = "README.md"
+requires-python = ">=3.9"
+authors = [
+  { name = "Sanka" }
+]
+dependencies = [
+  "httpx>=0.27,<1",
+  "pydantic>=2.7,<3",
+  "typing-extensions>=4.9"
+]
+
+[project.urls]
+Homepage = "https://sanka.com"
+Repository = "https://github.com/sankaHQ/sanka-python"
+
+[dependency-groups]
+dev = [
+  "ruff>=0.12.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/sanka_sdk"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "README.md",
+  "pyproject.toml",
+  "src/sanka_sdk",
+]
+
+[tool.ruff]
+line-length = 120
+target-version = "py39"
+
+[tool.ruff.lint.per-file-ignores]
+"src/sanka_sdk/**/*.py" = ["E402", "E711", "E721", "E722", "F841"]

sanka_sdk-0.1.0/src/sanka_sdk/__init__.py

@@ -0,0 +1,117 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+import typing
+from importlib import import_module
+
+if typing.TYPE_CHECKING:
+    from . import (
+        ai,
+        bills,
+        calendar,
+        companies,
+        contacts,
+        deals,
+        disbursements,
+        estimates,
+        expenses,
+        inventories,
+        inventory_transactions,
+        invoices,
+        items,
+        locations,
+        meters,
+        orders,
+        payments,
+        properties,
+        public_auth,
+        purchase_orders,
+        reports,
+        slips,
+        subscriptions,
+        tickets,
+        workflows,
+    )
+    from .client import AsyncSankaClient, SankaClient
+_dynamic_imports: typing.Dict[str, str] = {
+    "AsyncSankaClient": ".client",
+    "SankaClient": ".client",
+    "ai": ".ai",
+    "bills": ".bills",
+    "calendar": ".calendar",
+    "companies": ".companies",
+    "contacts": ".contacts",
+    "deals": ".deals",
+    "disbursements": ".disbursements",
+    "estimates": ".estimates",
+    "expenses": ".expenses",
+    "inventories": ".inventories",
+    "inventory_transactions": ".inventory_transactions",
+    "invoices": ".invoices",
+    "items": ".items",
+    "locations": ".locations",
+    "meters": ".meters",
+    "orders": ".orders",
+    "payments": ".payments",
+    "properties": ".properties",
+    "public_auth": ".public_auth",
+    "purchase_orders": ".purchase_orders",
+    "reports": ".reports",
+    "slips": ".slips",
+    "subscriptions": ".subscriptions",
+    "tickets": ".tickets",
+    "workflows": ".workflows",
+}
+
+
+def __getattr__(attr_name: str) -> typing.Any:
+    module_name = _dynamic_imports.get(attr_name)
+    if module_name is None:
+        raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")
+    try:
+        module = import_module(module_name, __package__)
+        if module_name == f".{attr_name}":
+            return module
+        else:
+            return getattr(module, attr_name)
+    except ImportError as e:
+        raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e
+    except AttributeError as e:
+        raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e
+
+
+def __dir__():
+    lazy_attrs = list(_dynamic_imports.keys())
+    return sorted(lazy_attrs)
+
+
+__all__ = [
+    "AsyncSankaClient",
+    "SankaClient",
+    "ai",
+    "bills",
+    "calendar",
+    "companies",
+    "contacts",
+    "deals",
+    "disbursements",
+    "estimates",
+    "expenses",
+    "inventories",
+    "inventory_transactions",
+    "invoices",
+    "items",
+    "locations",
+    "meters",
+    "orders",
+    "payments",
+    "properties",
+    "public_auth",
+    "purchase_orders",
+    "reports",
+    "slips",
+    "subscriptions",
+    "tickets",
+    "workflows",
+]

sanka_sdk-0.1.0/src/sanka_sdk/ai/__init__.py

@@ -0,0 +1,4 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+

sanka_sdk-0.1.0/src/sanka_sdk/ai/client.py

@@ -0,0 +1,257 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.request_options import RequestOptions
+from ..types.enrich_company_seed import EnrichCompanySeed
+from ..types.enrich_response import EnrichResponse
+from ..types.score_response import ScoreResponse
+from .raw_client import AsyncRawAiClient, RawAiClient
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class AiClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawAiClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawAiClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawAiClient
+        """
+        return self._raw_client
+
+    def api_routers_v_1_ai_api_enrich_record(
+        self,
+        *,
+        object_type: str,
+        record_id: typing.Optional[str] = OMIT,
+        seed: typing.Optional[EnrichCompanySeed] = OMIT,
+        custom_field_map: typing.Optional[typing.Dict[str, str]] = OMIT,
+        dry_run: typing.Optional[bool] = OMIT,
+        force_refresh: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> EnrichResponse:
+        """
+        Parameters
+        ----------
+        object_type : str
+
+        record_id : typing.Optional[str]
+
+        seed : typing.Optional[EnrichCompanySeed]
+
+        custom_field_map : typing.Optional[typing.Dict[str, str]]
+
+        dry_run : typing.Optional[bool]
+
+        force_refresh : typing.Optional[bool]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        EnrichResponse
+            OK
+
+        Examples
+        --------
+        from sanka_sdk import SankaClient
+
+        client = SankaClient(
+            token="YOUR_TOKEN",
+        )
+        client.ai.api_routers_v_1_ai_api_enrich_record(
+            object_type="object_type",
+        )
+        """
+        _response = self._raw_client.api_routers_v_1_ai_api_enrich_record(
+            object_type=object_type,
+            record_id=record_id,
+            seed=seed,
+            custom_field_map=custom_field_map,
+            dry_run=dry_run,
+            force_refresh=force_refresh,
+            request_options=request_options,
+        )
+        return _response.data
+
+    def api_routers_v_1_ai_api_score_record(
+        self,
+        *,
+        object_type: str,
+        record_id: str,
+        score_model_id: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ScoreResponse:
+        """
+        Parameters
+        ----------
+        object_type : str
+
+        record_id : str
+
+        score_model_id : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ScoreResponse
+            OK
+
+        Examples
+        --------
+        from sanka_sdk import SankaClient
+
+        client = SankaClient(
+            token="YOUR_TOKEN",
+        )
+        client.ai.api_routers_v_1_ai_api_score_record(
+            object_type="object_type",
+            record_id="record_id",
+        )
+        """
+        _response = self._raw_client.api_routers_v_1_ai_api_score_record(
+            object_type=object_type, record_id=record_id, score_model_id=score_model_id, request_options=request_options
+        )
+        return _response.data
+
+
+class AsyncAiClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawAiClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawAiClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawAiClient
+        """
+        return self._raw_client
+
+    async def api_routers_v_1_ai_api_enrich_record(
+        self,
+        *,
+        object_type: str,
+        record_id: typing.Optional[str] = OMIT,
+        seed: typing.Optional[EnrichCompanySeed] = OMIT,
+        custom_field_map: typing.Optional[typing.Dict[str, str]] = OMIT,
+        dry_run: typing.Optional[bool] = OMIT,
+        force_refresh: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> EnrichResponse:
+        """
+        Parameters
+        ----------
+        object_type : str
+
+        record_id : typing.Optional[str]
+
+        seed : typing.Optional[EnrichCompanySeed]
+
+        custom_field_map : typing.Optional[typing.Dict[str, str]]
+
+        dry_run : typing.Optional[bool]
+
+        force_refresh : typing.Optional[bool]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        EnrichResponse
+            OK
+
+        Examples
+        --------
+        import asyncio
+
+        from sanka_sdk import AsyncSankaClient
+
+        client = AsyncSankaClient(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.ai.api_routers_v_1_ai_api_enrich_record(
+                object_type="object_type",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.api_routers_v_1_ai_api_enrich_record(
+            object_type=object_type,
+            record_id=record_id,
+            seed=seed,
+            custom_field_map=custom_field_map,
+            dry_run=dry_run,
+            force_refresh=force_refresh,
+            request_options=request_options,
+        )
+        return _response.data
+
+    async def api_routers_v_1_ai_api_score_record(
+        self,
+        *,
+        object_type: str,
+        record_id: str,
+        score_model_id: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ScoreResponse:
+        """
+        Parameters
+        ----------
+        object_type : str
+
+        record_id : str
+
+        score_model_id : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ScoreResponse
+            OK
+
+        Examples
+        --------
+        import asyncio
+
+        from sanka_sdk import AsyncSankaClient
+
+        client = AsyncSankaClient(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.ai.api_routers_v_1_ai_api_score_record(
+                object_type="object_type",
+                record_id="record_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.api_routers_v_1_ai_api_score_record(
+            object_type=object_type, record_id=record_id, score_model_id=score_model_id, request_options=request_options
+        )
+        return _response.data