geopera 2.0.0__tar.gz

geopera-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Geopera
+
+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.

geopera-2.0.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: geopera
+Version: 2.0.0
+Summary: Official Python client for the Geopera geospatial data platform
+License: MIT
+License-File: LICENSE
+Keywords: geopera,satellite,geospatial,earth-observation,stac,remote-sensing,api-client
+Author: Geopera
+Author-email: support@geopera.com
+Requires-Python: >=3.11,<4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Dist: attrs (>=22.2.0)
+Requires-Dist: httpx (>=0.23.1,<0.29.0)
+Project-URL: Changelog, https://github.com/geo-pera/geopera-python/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://docs.geopera.com/api-reference
+Project-URL: Homepage, https://docs.geopera.com
+Project-URL: Repository, https://github.com/geo-pera/geopera-python
+Project-URL: Source, https://github.com/geo-pera/geopera-python
+Description-Content-Type: text/markdown
+
+# Geopera SDK (Python)
+
+[![PyPI](https://img.shields.io/pypi/v/geopera.svg)](https://pypi.org/project/geopera/)
+[![Python](https://img.shields.io/pypi/pyversions/geopera.svg)](https://pypi.org/project/geopera/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+The official Python client for the **Geopera** geospatial data platform — satellite tasking &
+archive ordering, catalog search, the data platform, billing, and more. Every capability is a typed
+*operation*; this SDK gives you a fully typed, sync **and** async client for all of them.
+
+- **Typed end-to-end** — every operation has typed inputs, outputs, and errors (`py.typed` shipped).
+- **Sync & async** — call any operation with `.sync()` or `await .asyncio()`.
+- **Auth your way** — a Geopera API key, or an OAuth bearer token from sign-in.
+- Generated from the live OpenAPI, so it never drifts from the API.
+
+## Install
+
+```bash
+pip install geopera
+```
+
+Requires Python 3.11+.
+
+## Quickstart
+
+```python
+from geopera import AuthenticatedClient
+from geopera.api.operations import catalog_search
+from geopera.models import CatalogSearchInput
+
+client = AuthenticatedClient(
+    base_url="https://api.geopera.com",
+    token="gpra_...",            # your Geopera API key
+)
+
+result = catalog_search.sync(
+    client=client,
+    body=CatalogSearchInput(
+        host_name="api.geopera.com",
+        collections=["sentinel-2-l2a"],
+        limit=10,
+    ),
+)
+print(result)   # -> CatalogSearchOutput (typed)
+```
+
+Every operation lives under `geopera.api.operations.<operation_id>` (dots become underscores —
+e.g. `orders.tasking.estimate` → `orders_tasking_estimate`). Request/response models are in
+`geopera.models`. Browse the full operation reference at **https://docs.geopera.com/api-reference**.
+
+## Authentication
+
+Pass either credential as `token`; Geopera accepts both and runs every call as that principal
+(with its scopes, audit, and provenance):
+
+```python
+# 1) A Geopera API key (headless / server-to-server) — create one in the portal.
+client = AuthenticatedClient(base_url="https://api.geopera.com", token="gpra_...")
+
+# 2) An OAuth bearer token (e.g. from a signed-in user session).
+client = AuthenticatedClient(base_url="https://api.geopera.com", token=user_access_token)
+```
+
+## Async
+
+```python
+import asyncio
+from geopera import AuthenticatedClient
+from geopera.api.operations import orders_tasking_estimate
+from geopera.models import TaskingEstimateInput
+
+async def main():
+    async with AuthenticatedClient(base_url="https://api.geopera.com", token="gpra_...") as client:
+        est = await orders_tasking_estimate.asyncio(
+            client=client,
+            body=TaskingEstimateInput(...),
+        )
+        print(est)
+
+asyncio.run(main())
+```
+
+## Error handling
+
+Operations return either the typed success model or a typed error — `Problem` (RFC 9457
+`problem+json`, what Geopera returns for business/permission errors) or `HTTPValidationError`
+(422 input validation). Use the `*_detailed` variant when you need the HTTP status code:
+
+```python
+from geopera.api.operations import catalog_search
+from geopera.models import CatalogSearchInput, Problem
+
+resp = catalog_search.sync_detailed(client=client, body=CatalogSearchInput(...))
+if resp.status_code == 200:
+    data = resp.parsed              # CatalogSearchOutput
+elif isinstance(resp.parsed, Problem):
+    print("geopera error:", resp.parsed.title, resp.parsed.detail)
+```
+
+## Configuration
+
+`AuthenticatedClient` accepts the usual knobs (timeouts, retries via httpx, custom headers,
+TLS verification):
+
+```python
+client = AuthenticatedClient(
+    base_url="https://api.geopera.com",
+    token="gpra_...",
+    timeout=httpx.Timeout(30.0),
+    raise_on_unexpected_status=True,
+    headers={"X-Request-Source": "my-app"},
+)
+```
+
+## Versioning
+
+The SDK version tracks the Geopera API contract. Breaking API changes bump the major version.
+See the [changelog](https://github.com/geo-pera/geopera-python/blob/main/CHANGELOG.md).
+
+## Links
+
+- 📚 API reference: https://docs.geopera.com/api-reference
+- 🌐 Geopera: https://geopera.com
+- 🐍 PyPI: https://pypi.org/project/geopera/
+
+## License
+
+MIT © Geopera
+

geopera-2.0.0/README.md

@@ -0,0 +1,128 @@
+# Geopera SDK (Python)
+
+[![PyPI](https://img.shields.io/pypi/v/geopera.svg)](https://pypi.org/project/geopera/)
+[![Python](https://img.shields.io/pypi/pyversions/geopera.svg)](https://pypi.org/project/geopera/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+The official Python client for the **Geopera** geospatial data platform — satellite tasking &
+archive ordering, catalog search, the data platform, billing, and more. Every capability is a typed
+*operation*; this SDK gives you a fully typed, sync **and** async client for all of them.
+
+- **Typed end-to-end** — every operation has typed inputs, outputs, and errors (`py.typed` shipped).
+- **Sync & async** — call any operation with `.sync()` or `await .asyncio()`.
+- **Auth your way** — a Geopera API key, or an OAuth bearer token from sign-in.
+- Generated from the live OpenAPI, so it never drifts from the API.
+
+## Install
+
+```bash
+pip install geopera
+```
+
+Requires Python 3.11+.
+
+## Quickstart
+
+```python
+from geopera import AuthenticatedClient
+from geopera.api.operations import catalog_search
+from geopera.models import CatalogSearchInput
+
+client = AuthenticatedClient(
+    base_url="https://api.geopera.com",
+    token="gpra_...",            # your Geopera API key
+)
+
+result = catalog_search.sync(
+    client=client,
+    body=CatalogSearchInput(
+        host_name="api.geopera.com",
+        collections=["sentinel-2-l2a"],
+        limit=10,
+    ),
+)
+print(result)   # -> CatalogSearchOutput (typed)
+```
+
+Every operation lives under `geopera.api.operations.<operation_id>` (dots become underscores —
+e.g. `orders.tasking.estimate` → `orders_tasking_estimate`). Request/response models are in
+`geopera.models`. Browse the full operation reference at **https://docs.geopera.com/api-reference**.
+
+## Authentication
+
+Pass either credential as `token`; Geopera accepts both and runs every call as that principal
+(with its scopes, audit, and provenance):
+
+```python
+# 1) A Geopera API key (headless / server-to-server) — create one in the portal.
+client = AuthenticatedClient(base_url="https://api.geopera.com", token="gpra_...")
+
+# 2) An OAuth bearer token (e.g. from a signed-in user session).
+client = AuthenticatedClient(base_url="https://api.geopera.com", token=user_access_token)
+```
+
+## Async
+
+```python
+import asyncio
+from geopera import AuthenticatedClient
+from geopera.api.operations import orders_tasking_estimate
+from geopera.models import TaskingEstimateInput
+
+async def main():
+    async with AuthenticatedClient(base_url="https://api.geopera.com", token="gpra_...") as client:
+        est = await orders_tasking_estimate.asyncio(
+            client=client,
+            body=TaskingEstimateInput(...),
+        )
+        print(est)
+
+asyncio.run(main())
+```
+
+## Error handling
+
+Operations return either the typed success model or a typed error — `Problem` (RFC 9457
+`problem+json`, what Geopera returns for business/permission errors) or `HTTPValidationError`
+(422 input validation). Use the `*_detailed` variant when you need the HTTP status code:
+
+```python
+from geopera.api.operations import catalog_search
+from geopera.models import CatalogSearchInput, Problem
+
+resp = catalog_search.sync_detailed(client=client, body=CatalogSearchInput(...))
+if resp.status_code == 200:
+    data = resp.parsed              # CatalogSearchOutput
+elif isinstance(resp.parsed, Problem):
+    print("geopera error:", resp.parsed.title, resp.parsed.detail)
+```
+
+## Configuration
+
+`AuthenticatedClient` accepts the usual knobs (timeouts, retries via httpx, custom headers,
+TLS verification):
+
+```python
+client = AuthenticatedClient(
+    base_url="https://api.geopera.com",
+    token="gpra_...",
+    timeout=httpx.Timeout(30.0),
+    raise_on_unexpected_status=True,
+    headers={"X-Request-Source": "my-app"},
+)
+```
+
+## Versioning
+
+The SDK version tracks the Geopera API contract. Breaking API changes bump the major version.
+See the [changelog](https://github.com/geo-pera/geopera-python/blob/main/CHANGELOG.md).
+
+## Links
+
+- 📚 API reference: https://docs.geopera.com/api-reference
+- 🌐 Geopera: https://geopera.com
+- 🐍 PyPI: https://pypi.org/project/geopera/
+
+## License
+
+MIT © Geopera

geopera-2.0.0/geopera/__init__.py

@@ -0,0 +1,8 @@
+"""A client library for accessing Geopera Operations"""
+
+from .client import AuthenticatedClient, Client
+
+__all__ = (
+    "AuthenticatedClient",
+    "Client",
+)

geopera-2.0.0/geopera/api/__init__.py

@@ -0,0 +1 @@
+"""Contains methods for accessing the API"""

geopera-2.0.0/geopera/api/operations/__init__.py

@@ -0,0 +1 @@
+"""Contains endpoint functions for accessing the API"""

geopera-2.0.0/geopera/api/operations/alerts_acknowledge_event.py

@@ -0,0 +1,202 @@
+from http import HTTPStatus
+from typing import Any
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.acknowledge_event_input import AcknowledgeEventInput
+from ...models.alert_event_output import AlertEventOutput
+from ...models.http_validation_error import HTTPValidationError
+from ...models.problem import Problem
+from ...types import UNSET, Response, Unset
+
+
+def _get_kwargs(
+    *,
+    body: AcknowledgeEventInput,
+    x_api_key: None | str | Unset = UNSET,
+) -> dict[str, Any]:
+    headers: dict[str, Any] = {}
+    if not isinstance(x_api_key, Unset):
+        headers["x-api-key"] = x_api_key
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/v1/op/alerts.acknowledge_event",
+    }
+
+    _kwargs["json"] = body.to_dict()
+
+    headers["Content-Type"] = "application/json"
+
+    _kwargs["headers"] = headers
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> AlertEventOutput | HTTPValidationError | Problem | None:
+    if response.status_code == 200:
+        response_200 = AlertEventOutput.from_dict(response.json())
+
+        return response_200
+
+    if response.status_code == 401:
+        response_401 = Problem.from_dict(response.json())
+
+        return response_401
+
+    if response.status_code == 403:
+        response_403 = Problem.from_dict(response.json())
+
+        return response_403
+
+    if response.status_code == 404:
+        response_404 = Problem.from_dict(response.json())
+
+        return response_404
+
+    if response.status_code == 422:
+        response_422 = HTTPValidationError.from_dict(response.json())
+
+        return response_422
+
+    if response.status_code == 500:
+        response_500 = Problem.from_dict(response.json())
+
+        return response_500
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[AlertEventOutput | HTTPValidationError | Problem]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient,
+    body: AcknowledgeEventInput,
+    x_api_key: None | str | Unset = UNSET,
+) -> Response[AlertEventOutput | HTTPValidationError | Problem]:
+    """Mark an alert event acknowledged (org-scoped).
+
+    Args:
+        x_api_key (None | str | Unset):
+        body (AcknowledgeEventInput):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[AlertEventOutput | HTTPValidationError | Problem]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+        x_api_key=x_api_key,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    *,
+    client: AuthenticatedClient,
+    body: AcknowledgeEventInput,
+    x_api_key: None | str | Unset = UNSET,
+) -> AlertEventOutput | HTTPValidationError | Problem | None:
+    """Mark an alert event acknowledged (org-scoped).
+
+    Args:
+        x_api_key (None | str | Unset):
+        body (AcknowledgeEventInput):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        AlertEventOutput | HTTPValidationError | Problem
+    """
+
+    return sync_detailed(
+        client=client,
+        body=body,
+        x_api_key=x_api_key,
+    ).parsed
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient,
+    body: AcknowledgeEventInput,
+    x_api_key: None | str | Unset = UNSET,
+) -> Response[AlertEventOutput | HTTPValidationError | Problem]:
+    """Mark an alert event acknowledged (org-scoped).
+
+    Args:
+        x_api_key (None | str | Unset):
+        body (AcknowledgeEventInput):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[AlertEventOutput | HTTPValidationError | Problem]
+    """
+
+    kwargs = _get_kwargs(
+        body=body,
+        x_api_key=x_api_key,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient,
+    body: AcknowledgeEventInput,
+    x_api_key: None | str | Unset = UNSET,
+) -> AlertEventOutput | HTTPValidationError | Problem | None:
+    """Mark an alert event acknowledged (org-scoped).
+
+    Args:
+        x_api_key (None | str | Unset):
+        body (AcknowledgeEventInput):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        AlertEventOutput | HTTPValidationError | Problem
+    """
+
+    return (
+        await asyncio_detailed(
+            client=client,
+            body=body,
+            x_api_key=x_api_key,
+        )
+    ).parsed