simpro-py-sdk 0.1.0__tar.gz

simpro_py_sdk-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,24 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: uv sync --frozen
+      - run: uv run ruff check .
+      - run: uv run ruff format --check .
+      - run: uv run mypy
+      - run: uv run pytest -q

simpro_py_sdk-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,20 @@
+name: Publish
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      # PyPI trusted publishing (OIDC).
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv sync --frozen
+      - run: uv run pytest -q
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@release/v1

simpro_py_sdk-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+.idea/
+.vscode/
+dist/
+build/
+*.egg-info/
+__pycache__/
+*.pyc
+.venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/

simpro_py_sdk-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

simpro_py_sdk-0.1.0/LICENCE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2016 Bradley McElroy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

simpro_py_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.5
+Name: simpro-py-sdk
+Version: 0.1.0
+Summary: Python client for the SimPro Cloud REST API (v1.0).
+Project-URL: Homepage, https://github.com/xuanpablo/simpro-py
+Project-URL: Changelog, https://github.com/xuanpablo/simpro-py/releases
+Author: Paul Millar
+License: MIT License
+        
+        Copyright (c) 2016 Bradley McElroy
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENCE.txt
+Keywords: api,client,construction,simpro,simprosuite
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.27
+Description-Content-Type: text/markdown
+
+# simpro-py
+
+A thin Python client for the [SimPro Cloud REST API (v1.0)](https://www.simprogroup.com).
+
+```python
+from simpro import SimproClient
+
+client = SimproClient("https://yourtenant.simprosuite.com", "YOUR_API_KEY")
+
+for customer in client.customers.iter_all(0):
+    print(customer["ID"], customer.get("CompanyName") or customer.get("FamilyName"))
+```
+
+The distribution is `simpro-py-sdk`; the import name is `simpro`.
+
+## Install
+
+```bash
+pip install simpro-py-sdk
+```
+
+Requires Python 3.12+. The only runtime dependency is `httpx`.
+
+## Authentication
+
+SimPro API keys are bearer tokens — create one in SimPro under
+**Administration > API Keys** and pass it with your tenant base URL:
+
+```python
+client = SimproClient("https://yourtenant.simprosuite.com", "YOUR_API_KEY")
+```
+
+Every request is sent to `{base_url}/api/v1.0/...`. If your `base_url` already
+ends with `/api/v1.0` it is stripped automatically, so the well-known
+doubled-prefix 404 (`Invalid route`) cannot happen.
+
+## Resources
+
+0.1.x ships read-only access to the first-slice resources, one namespace per
+resource, hung off the client:
+
+| Namespace | Endpoints |
+|---|---|
+| `client.companies` | `list(*, search=None, modified_since=None, **filters)`, `get(company_id)` |
+| `client.customers` | `list(company_id, ...)`, `get(company_id, customer_id)`, `iter_all(company_id, **filters)` |
+| `client.sites` | `list(company_id, ...)`, `get(company_id, site_id)`, `iter_all(company_id, **filters)` |
+| `client.jobs` | `list(company_id, ...)`, `get(company_id, job_id)`, `iter_all(company_id, **filters)` |
+
+`company_id` is `0` unless your build uses SimPro multi-company.
+
+Notes:
+
+- **Single-customer GETs are type-split in SimPro** (company vs individual).
+  `client.customers.get(company_id, customer_id)` tries the company path first
+  and falls back to individuals, so callers never need the type up front.
+- **`search`** is SimPro's documented match-mode param (`"all"`/`"any"`) that
+  combines with field filters. Field filters themselves are passed verbatim as
+  extra keyword arguments, e.g. `client.customers.list(0, Name="Acme")`.
+- All methods return plain dicts/lists — no DTO layer by design.
+
+## Pagination
+
+`list()` fetches a single page (`page`, `per_page`, capped at SimPro's maximum
+of 250). `iter_all()` walks every page for you:
+
+```python
+for job in client.jobs.iter_all(0):
+    ...
+```
+
+Page continuation follows the SimPro convention: the `Result-Pages` response
+header carries the total page count; if it is absent, the walk stops on a
+short page.
+
+## Incremental pulls
+
+List endpoints honour the `If-Modified-Since` watermark. Pass
+`modified_since=<datetime>` and the client formats the header (RFC 1123, UTC)
+and maps a `304 Not Modified` answer to an empty result:
+
+```python
+since = last_sync_run_at  # aware datetime; naive values are treated as UTC
+new_customers = client.customers.list(0, modified_since=since)
+```
+
+## Errors
+
+All failures raise a subclass of `SimproError`:
+
+| Exception | HTTP status |
+|---|---|
+| `SimproAuthError` | 401, 403 |
+| `SimproNotFound` | 404 |
+| `SimproValidationError` | 422 (`.details` holds the raw error list) |
+| `SimproRateLimitError` | 429 |
+| `SimproError` | anything else, including transport failures |
+
+SimPro 422 bodies are normally `{"errors": [{"path", "message", "value"}, ...]}`
+but the `errors` key may be absent — both shapes are handled, and
+`SimproValidationError.details` is always a list.
+
+## Deliberate omissions
+
+- **No retry, no rate limiting, no caching.** SimPro allows roughly 10
+  requests/second per key; callers doing bulk pulls should pace requests and
+  retry 429s/transport errors themselves.
+- **No write endpoints** in 0.1.x — read-only first.
+- **No DTO layer** — responses are plain JSON dicts, so SDK releases never
+  lag the API.
+
+## Lineage
+
+This package is a clean rewrite of [`limx0/simpro-py`](https://github.com/limx0/simpro-py)
+(MIT), which wrapped SimPro's legacy on-prem JSON-RPC API. The rewrite targets
+the SimPro Cloud REST API and shares no code with the original; the MIT
+licence and lineage are retained with thanks.
+
+## Development
+
+```bash
+uv sync
+uv run pytest -q
+uv run ruff check . && uv run ruff format --check .
+uv run mypy
+```
+
+## Licence
+
+MIT — see [LICENCE.txt](LICENCE.txt).

simpro_py_sdk-0.1.0/README.md

@@ -0,0 +1,129 @@
+# simpro-py
+
+A thin Python client for the [SimPro Cloud REST API (v1.0)](https://www.simprogroup.com).
+
+```python
+from simpro import SimproClient
+
+client = SimproClient("https://yourtenant.simprosuite.com", "YOUR_API_KEY")
+
+for customer in client.customers.iter_all(0):
+    print(customer["ID"], customer.get("CompanyName") or customer.get("FamilyName"))
+```
+
+The distribution is `simpro-py-sdk`; the import name is `simpro`.
+
+## Install
+
+```bash
+pip install simpro-py-sdk
+```
+
+Requires Python 3.12+. The only runtime dependency is `httpx`.
+
+## Authentication
+
+SimPro API keys are bearer tokens — create one in SimPro under
+**Administration > API Keys** and pass it with your tenant base URL:
+
+```python
+client = SimproClient("https://yourtenant.simprosuite.com", "YOUR_API_KEY")
+```
+
+Every request is sent to `{base_url}/api/v1.0/...`. If your `base_url` already
+ends with `/api/v1.0` it is stripped automatically, so the well-known
+doubled-prefix 404 (`Invalid route`) cannot happen.
+
+## Resources
+
+0.1.x ships read-only access to the first-slice resources, one namespace per
+resource, hung off the client:
+
+| Namespace | Endpoints |
+|---|---|
+| `client.companies` | `list(*, search=None, modified_since=None, **filters)`, `get(company_id)` |
+| `client.customers` | `list(company_id, ...)`, `get(company_id, customer_id)`, `iter_all(company_id, **filters)` |
+| `client.sites` | `list(company_id, ...)`, `get(company_id, site_id)`, `iter_all(company_id, **filters)` |
+| `client.jobs` | `list(company_id, ...)`, `get(company_id, job_id)`, `iter_all(company_id, **filters)` |
+
+`company_id` is `0` unless your build uses SimPro multi-company.
+
+Notes:
+
+- **Single-customer GETs are type-split in SimPro** (company vs individual).
+  `client.customers.get(company_id, customer_id)` tries the company path first
+  and falls back to individuals, so callers never need the type up front.
+- **`search`** is SimPro's documented match-mode param (`"all"`/`"any"`) that
+  combines with field filters. Field filters themselves are passed verbatim as
+  extra keyword arguments, e.g. `client.customers.list(0, Name="Acme")`.
+- All methods return plain dicts/lists — no DTO layer by design.
+
+## Pagination
+
+`list()` fetches a single page (`page`, `per_page`, capped at SimPro's maximum
+of 250). `iter_all()` walks every page for you:
+
+```python
+for job in client.jobs.iter_all(0):
+    ...
+```
+
+Page continuation follows the SimPro convention: the `Result-Pages` response
+header carries the total page count; if it is absent, the walk stops on a
+short page.
+
+## Incremental pulls
+
+List endpoints honour the `If-Modified-Since` watermark. Pass
+`modified_since=<datetime>` and the client formats the header (RFC 1123, UTC)
+and maps a `304 Not Modified` answer to an empty result:
+
+```python
+since = last_sync_run_at  # aware datetime; naive values are treated as UTC
+new_customers = client.customers.list(0, modified_since=since)
+```
+
+## Errors
+
+All failures raise a subclass of `SimproError`:
+
+| Exception | HTTP status |
+|---|---|
+| `SimproAuthError` | 401, 403 |
+| `SimproNotFound` | 404 |
+| `SimproValidationError` | 422 (`.details` holds the raw error list) |
+| `SimproRateLimitError` | 429 |
+| `SimproError` | anything else, including transport failures |
+
+SimPro 422 bodies are normally `{"errors": [{"path", "message", "value"}, ...]}`
+but the `errors` key may be absent — both shapes are handled, and
+`SimproValidationError.details` is always a list.
+
+## Deliberate omissions
+
+- **No retry, no rate limiting, no caching.** SimPro allows roughly 10
+  requests/second per key; callers doing bulk pulls should pace requests and
+  retry 429s/transport errors themselves.
+- **No write endpoints** in 0.1.x — read-only first.
+- **No DTO layer** — responses are plain JSON dicts, so SDK releases never
+  lag the API.
+
+## Lineage
+
+This package is a clean rewrite of [`limx0/simpro-py`](https://github.com/limx0/simpro-py)
+(MIT), which wrapped SimPro's legacy on-prem JSON-RPC API. The rewrite targets
+the SimPro Cloud REST API and shares no code with the original; the MIT
+licence and lineage are retained with thanks.
+
+## Development
+
+```bash
+uv sync
+uv run pytest -q
+uv run ruff check . && uv run ruff format --check .
+uv run mypy
+```
+
+## Licence
+
+MIT — see [LICENCE.txt](LICENCE.txt).

simpro_py_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,49 @@
+[project]
+name = "simpro-py-sdk"
+version = "0.1.0"
+description = "Python client for the SimPro Cloud REST API (v1.0)."
+readme = "README.md"
+license = { file = "LICENCE.txt" }
+requires-python = ">=3.12"
+authors = [{ name = "Paul Millar" }]
+keywords = ["simpro", "simprosuite", "construction", "api", "client"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = ["httpx>=0.27"]
+
+[project.urls]
+Homepage = "https://github.com/xuanpablo/simpro-py"
+Changelog = "https://github.com/xuanpablo/simpro-py/releases"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[dependency-groups]
+dev = ["pytest>=8", "ruff==0.16.9", "mypy==2.3.1"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/simpro"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B", "SIM"]
+
+[tool.mypy]
+python_version = "3.12"
+files = ["src/simpro"]

simpro_py_sdk-0.1.0/src/simpro/__init__.py

@@ -0,0 +1,31 @@
+"""simpro-py: a thin Python client for the SimPro Cloud REST API (v1.0).
+
+Quickstart::
+
+    from simpro import SimproClient
+
+    client = SimproClient("https://yourtenant.simprosuite.com", "API_KEY")
+    for customer in client.customers.iter_all(0):
+        print(customer["ID"], customer.get("CompanyName"))
+"""
+
+from simpro.client import SimproClient
+from simpro.exceptions import (
+    SimproAuthError,
+    SimproError,
+    SimproNotFound,
+    SimproRateLimitError,
+    SimproValidationError,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "SimproAuthError",
+    "SimproClient",
+    "SimproError",
+    "SimproNotFound",
+    "SimproRateLimitError",
+    "SimproValidationError",
+    "__version__",
+]

simpro_py_sdk-0.1.0/src/simpro/_util.py

@@ -0,0 +1,19 @@
+"""Internal helpers shared by the client and the resource modules."""
+
+from __future__ import annotations
+
+from datetime import UTC, datetime
+from email.utils import format_datetime
+
+API_PREFIX = "/api/v1.0"
+MAX_PAGE_SIZE = 250
+
+
+def format_http_date(dt: datetime) -> str:
+    """Format ``dt`` as an RFC 1123 date string (UTC), for ``If-Modified-Since``.
+
+    Naive datetimes are treated as UTC.
+    """
+    if dt.tzinfo is None:
+        dt = dt.replace(tzinfo=UTC)
+    return format_datetime(dt.astimezone(UTC), usegmt=True)

simpro_py_sdk-0.1.0/src/simpro/client.py

@@ -0,0 +1,152 @@
+"""The SimPro Cloud REST API client.
+
+Every request URL is built in one place (``_request``) as
+``{base}/api/v1.0{path}``; if ``base_url`` already ends with ``/api/v1.0``
+the prefix is stripped first, so the well-known doubling trap (simPRO
+answers 404 ``Invalid route``) is impossible by construction.
+
+The client is intentionally thin: no retry, no rate limiting, no caching.
+SimPro allows roughly 10 requests/second per key — callers with bulk pulls
+should pace requests and retry 429s/transport errors themselves.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any, Self
+
+import httpx
+
+from simpro._util import API_PREFIX
+from simpro.exceptions import (
+    SimproAuthError,
+    SimproError,
+    SimproNotFound,
+    SimproRateLimitError,
+    SimproValidationError,
+)
+from simpro.resources import Companies, Customers, Jobs, Sites
+
+DEFAULT_TIMEOUT = 30.0
+
+
+class SimproClient:
+    """Synchronous client for the SimPro Cloud REST API (v1.0).
+
+    Args:
+        base_url: Tenant root, e.g. ``https://yourtenant.simprosuite.com``.
+            A trailing ``/api/v1.0`` is tolerated and stripped.
+        api_key: API key bearer token (SimPro > Administration > API Keys).
+        timeout: Per-request timeout in seconds.
+        transport: Optional ``httpx`` transport override (testing/proxies).
+    """
+
+    def __init__(
+        self,
+        base_url: str,
+        api_key: str,
+        *,
+        timeout: float = DEFAULT_TIMEOUT,
+        transport: httpx.BaseTransport | None = None,
+    ) -> None:
+        base = base_url.rstrip("/").removesuffix(API_PREFIX)
+        self._base = base
+        self._http = httpx.Client(
+            timeout=timeout,
+            headers={
+                "Authorization": f"Bearer {api_key}",
+                "Accept": "application/json",
+            },
+            transport=transport,
+        )
+        # Resource namespaces.
+        self.companies = Companies(self)
+        self.customers = Customers(self)
+        self.sites = Sites(self)
+        self.jobs = Jobs(self)
+
+    def __enter__(self) -> Self:
+        return self
+
+    def __exit__(self, *exc_info: object) -> None:
+        self.close()
+
+    def close(self) -> None:
+        """Close the underlying connection pool."""
+        self._http.close()
+
+    def _request(
+        self,
+        method: str,
+        path: str,
+        *,
+        params: Mapping[str, Any] | None = None,
+        headers: Mapping[str, str] | None = None,
+    ) -> httpx.Response:
+        """Perform one API request and map failures to typed exceptions.
+
+        ``path`` is relative to the API prefix and starts with ``/``,
+        e.g. ``/companies/0/customers/``. A 304 (If-Modified-Since hit) is
+        returned to the caller as a normal response.
+        """
+        url = f"{self._base}{API_PREFIX}{path}"
+        try:
+            response = self._http.request(method, url, params=params, headers=headers)
+        except httpx.HTTPError as exc:
+            raise SimproError(f"SimPro request failed: {exc}") from exc
+        _raise_for_status(response)
+        return response
+
+
+def _raise_for_status(response: httpx.Response) -> None:
+    status = response.status_code
+    if status < 400 or status == 304:
+        return
+    if status in (401, 403):
+        raise SimproAuthError(
+            f"SimPro rejected the credentials (HTTP {status})", status_code=status
+        )
+    if status == 404:
+        raise SimproNotFound(f"SimPro resource not found: {response.url}", status_code=status)
+    if status == 429:
+        raise SimproRateLimitError(
+            "SimPro rate limit exceeded; retry after a pause", status_code=status
+        )
+    if status == 422:
+        message, details = _parse_validation_body(response)
+        raise SimproValidationError(message, details=details, status_code=status)
+    raise SimproError(
+        f"SimPro request failed with HTTP {status}: {response.text[:200]}",
+        status_code=status,
+    )
+
+
+def _parse_validation_body(
+    response: httpx.Response,
+) -> tuple[str, list[dict[str, Any]]]:
+    """Extract a message and error details from a 422 body.
+
+    SimPro 422 bodies are ``{"errors": [{"path", "message", "value"}, ...]}``
+    — but the ``errors`` key may be absent, and the body may not be JSON at
+    all. Both shapes degrade gracefully.
+    """
+    try:
+        body: Any = response.json()
+    except ValueError:
+        body = None
+    if isinstance(body, dict):
+        errors = body.get("errors")
+        details = [e for e in errors if isinstance(e, dict)] if isinstance(errors, list) else []
+        message = body.get("message") if isinstance(body.get("message"), str) else None
+        if message is None:
+            message = "SimPro rejected the request payload (HTTP 422)"
+        if details:
+            summary = "; ".join(
+                f"{d.get('path', '?')}: {d.get('message', '')}" for d in details[:5]
+            )
+            message = f"{message} — {summary}"
+        return message, details
+    if isinstance(body, list):
+        details = [e for e in body if isinstance(e, dict)]
+        return "SimPro rejected the request payload (HTTP 422)", details
+    return f"SimPro rejected the request payload (HTTP 422): {response.text[:200]}", []

simpro_py_sdk-0.1.0/src/simpro/exceptions.py

@@ -0,0 +1,49 @@
+"""Exception hierarchy for the simpro client.
+
+Every HTTP failure is mapped to one of these types in one place
+(``simpro.client``); transport-level failures raise ``SimproError``.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+
+class SimproError(Exception):
+    """Base error for all simpro failures (transport or HTTP)."""
+
+    def __init__(self, message: str, *, status_code: int | None = None) -> None:
+        super().__init__(message)
+        self.status_code = status_code
+
+
+class SimproAuthError(SimproError):
+    """SimPro rejected the request as unauthenticated or unauthorised (401/403)."""
+
+
+class SimproNotFound(SimproError):
+    """The requested SimPro resource does not exist (404)."""
+
+
+class SimproRateLimitError(SimproError):
+    """SimPro rate limit exceeded (429). Retry after a pause; the SDK does not retry."""
+
+
+class SimproValidationError(SimproError):
+    """SimPro rejected the request payload (422).
+
+    ``details`` carries the raw error list when the response body provides
+    one: SimPro returns ``{"errors": [{"path", "message", "value"}, ...]}``
+    but the ``errors`` key may be absent, in which case ``details`` is empty
+    and the message carries whatever the body offered.
+    """
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        details: list[dict[str, Any]] | None = None,
+        status_code: int | None = None,
+    ) -> None:
+        super().__init__(message, status_code=status_code)
+        self.details = details if details is not None else []