satvu 0.2.0__tar.gz

satvu-0.2.0/.gitignore

@@ -0,0 +1,20 @@
+__pycache__/
+.cache
+.envrc
+.idea/
+.mcp.json
+.pytest_cache
+.venv
+*.egg-info
+*.py[oc]
+/src/satvu/services/*
+!/src/satvu/services/conftest.py
+build/
+dist/
+pytest-coverage.txt
+pytest.xml
+tasks-*.md
+wheels/
+.claude/
+.dagger/src/dagger_gen.py
+.hypothesis

satvu-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 to present SatVu
+
+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.

satvu-0.2.0/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: satvu
+Version: 0.2.0
+Summary: SatVu API SDK
+Author-email: Christian Wygoda <christian.wygoda@satellitevu.com>, James Harrison <james.harrison@satellitevu.com>, Zhelini Raveendran <zhelini.raveendran@satellitevu.com>
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: pydantic>=2.11.7
+Provides-Extra: http-httpx
+Requires-Dist: httpx>=0.28.1; extra == 'http-httpx'
+Provides-Extra: http-requests
+Requires-Dist: requests>=2.32.0; extra == 'http-requests'
+Provides-Extra: http-urllib3
+Requires-Dist: urllib3>=2.0.0; extra == 'http-urllib3'
+Provides-Extra: standard
+Requires-Dist: appdirs>=1.4.4; extra == 'standard'
+Description-Content-Type: text/markdown
+
+# SatVu API SDK
+
+[![pypi](https://img.shields.io/pypi/v/satvu)](https://pypi.org/project/satvu/)
+[![GitHub License](https://img.shields.io/github/license/SatelliteVu/satvu-api-sdk)](https://github.com/SatelliteVu/satvu-api-sdk/blob/main/LICENSE)
+[![X (formerly Twitter) Follow](https://img.shields.io/twitter/follow/satellitevu)](https://x.com/intent/follow?screen_name=satellitevu)
+[![LinkedIn](https://img.shields.io/badge/LinkedIn-blue?style=flat&logo=linkedin)](https://uk.linkedin.com/company/satvu)
+
+Python SDK for [SatVu's](https://www.satellitevu.com/) satellite imagery platform.
+
+## ✨ Features
+
+- **Unified Interface** - Access all SatVu APIs through a single SDK
+- **Type Safety** - Full type hints with Pydantic models for requests and responses
+- **Explicit Error Handling** - Rust-inspired Result types for predictable error handling
+- **Multiple HTTP Backends** - Choose httpx, requests, urllib3, or stdlib
+- **Built-in Pagination** - Iterator methods for seamless pagination through large result sets
+- **Streaming Downloads** - Memory-efficient downloads for large satellite imagery files
+
+## 📦 Installation
+
+The package is published on [PyPI](https://pypi.org/project/satvu/) and can be installed with pip:
+
+```bash
+pip install satvu
+```
+
+With optional HTTP backends:
+
+```bash
+pip install satvu[http-httpx]
+pip install satvu[http-requests]
+pip install satvu[http-urllib3]
+```
+
+The SDK works out of the box with Python's built-in `urllib`.
+
+## 🚀 Quick Start
+
+```python
+import os
+from uuid import UUID
+from satvu import SatVuSDK
+
+sdk = SatVuSDK(
+    client_id=os.environ["SATVU_CLIENT_ID"],
+    client_secret=os.environ["SATVU_CLIENT_SECRET"],
+)
+
+contract_id = UUID(os.environ["SATVU_CONTRACT_ID"])
+
+# Search the catalog
+results = sdk.catalog.get_search(contract_id=contract_id, limit=10)
+for feature in results.features:
+    print(feature.id)
+```
+
+## Available Services
+
+| Service        | Description                                                                               |
+| -------------- | ----------------------------------------------------------------------------------------- |
+| `sdk.catalog`  | Search and discover SatVu's [STAC](https://github.com/radiantearth/stac-api-spec) catalog |
+| `sdk.cos`      | Order and download imagery available from SatVu's STAC catalog                            |
+| `sdk.id`       | Identity and user management, including webhooks                                          |
+| `sdk.otm`      | Order and manage satellite tasking                                                        |
+| `sdk.policy`   | Check active contracts                                                                    |
+| `sdk.reseller` | Perform reseller operations                                                               |
+| `sdk.wallet`   | Check credit balances                                                                     |
+
+## 📖 Documentation
+
+- [Getting Started](docs/getting-started.md) - Installation, authentication, first API call
+- [Authentication](docs/authentication.md) - OAuth2 flow, token caching, environments
+- [Error Handling](docs/error-handling.md) - Result types and error patterns
+- [Pagination](docs/pagination.md) - Working with paginated endpoints
+- [Streaming Downloads](docs/streaming-downloads.md) - Downloading large imagery files
+- [HTTP Backends](docs/http-backends.md) - Choosing and configuring HTTP clients
+- [Changelog](CHANGELOG.md)
+
+## Requirements
+
+- Python 3.10+
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+
+## Support
+
+For bugs and feature requests, please [open an issue](https://github.com/satellitevu/satvu-api-sdk/issues).

satvu-0.2.0/README.md

@@ -0,0 +1,89 @@
+# SatVu API SDK
+
+[![pypi](https://img.shields.io/pypi/v/satvu)](https://pypi.org/project/satvu/)
+[![GitHub License](https://img.shields.io/github/license/SatelliteVu/satvu-api-sdk)](https://github.com/SatelliteVu/satvu-api-sdk/blob/main/LICENSE)
+[![X (formerly Twitter) Follow](https://img.shields.io/twitter/follow/satellitevu)](https://x.com/intent/follow?screen_name=satellitevu)
+[![LinkedIn](https://img.shields.io/badge/LinkedIn-blue?style=flat&logo=linkedin)](https://uk.linkedin.com/company/satvu)
+
+Python SDK for [SatVu's](https://www.satellitevu.com/) satellite imagery platform.
+
+## ✨ Features
+
+- **Unified Interface** - Access all SatVu APIs through a single SDK
+- **Type Safety** - Full type hints with Pydantic models for requests and responses
+- **Explicit Error Handling** - Rust-inspired Result types for predictable error handling
+- **Multiple HTTP Backends** - Choose httpx, requests, urllib3, or stdlib
+- **Built-in Pagination** - Iterator methods for seamless pagination through large result sets
+- **Streaming Downloads** - Memory-efficient downloads for large satellite imagery files
+
+## 📦 Installation
+
+The package is published on [PyPI](https://pypi.org/project/satvu/) and can be installed with pip:
+
+```bash
+pip install satvu
+```
+
+With optional HTTP backends:
+
+```bash
+pip install satvu[http-httpx]
+pip install satvu[http-requests]
+pip install satvu[http-urllib3]
+```
+
+The SDK works out of the box with Python's built-in `urllib`.
+
+## 🚀 Quick Start
+
+```python
+import os
+from uuid import UUID
+from satvu import SatVuSDK
+
+sdk = SatVuSDK(
+    client_id=os.environ["SATVU_CLIENT_ID"],
+    client_secret=os.environ["SATVU_CLIENT_SECRET"],
+)
+
+contract_id = UUID(os.environ["SATVU_CONTRACT_ID"])
+
+# Search the catalog
+results = sdk.catalog.get_search(contract_id=contract_id, limit=10)
+for feature in results.features:
+    print(feature.id)
+```
+
+## Available Services
+
+| Service        | Description                                                                               |
+| -------------- | ----------------------------------------------------------------------------------------- |
+| `sdk.catalog`  | Search and discover SatVu's [STAC](https://github.com/radiantearth/stac-api-spec) catalog |
+| `sdk.cos`      | Order and download imagery available from SatVu's STAC catalog                            |
+| `sdk.id`       | Identity and user management, including webhooks                                          |
+| `sdk.otm`      | Order and manage satellite tasking                                                        |
+| `sdk.policy`   | Check active contracts                                                                    |
+| `sdk.reseller` | Perform reseller operations                                                               |
+| `sdk.wallet`   | Check credit balances                                                                     |
+
+## 📖 Documentation
+
+- [Getting Started](docs/getting-started.md) - Installation, authentication, first API call
+- [Authentication](docs/authentication.md) - OAuth2 flow, token caching, environments
+- [Error Handling](docs/error-handling.md) - Result types and error patterns
+- [Pagination](docs/pagination.md) - Working with paginated endpoints
+- [Streaming Downloads](docs/streaming-downloads.md) - Downloading large imagery files
+- [HTTP Backends](docs/http-backends.md) - Choosing and configuring HTTP clients
+- [Changelog](CHANGELOG.md)
+
+## Requirements
+
+- Python 3.10+
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+
+## Support
+
+For bugs and feature requests, please [open an issue](https://github.com/satellitevu/satvu-api-sdk/issues).

satvu-0.2.0/hatch_build.py

@@ -0,0 +1,23 @@
+"""Hatch build hook to generate SDK code from OpenAPI specs."""
+
+import sys
+from pathlib import Path
+
+from hatchling.builders.hooks.plugin.interface import (  # type: ignore[import-not-found]
+    BuildHookInterface,
+)
+
+# Add src to sys.path so we can import builder
+ROOT_DIR = Path(__file__).parent
+sys.path.insert(0, str(ROOT_DIR / "src"))
+
+
+class CustomBuildHook(BuildHookInterface):
+    """Build hook to generate SDK code before packaging."""
+
+    def initialize(self, version, build_data):
+        """Run the SDK builder before packaging."""
+        from builder.build import build
+
+        # Generate all service modules (fetch specs fresh during build)
+        build(api_id="all", use_cached=False)

satvu-0.2.0/pyproject.toml

@@ -0,0 +1,195 @@
+[project]
+name = "satvu"
+version = "0.2.0"
+description = "SatVu API SDK"
+readme = "README.md"
+authors = [
+    { name = "Christian Wygoda", email = "christian.wygoda@satellitevu.com" },
+    { name = "James Harrison", email = "james.harrison@satellitevu.com" },
+    { name = "Zhelini Raveendran", email = "zhelini.raveendran@satellitevu.com" },
+]
+requires-python = ">=3.10"
+dependencies = [
+    "pydantic>=2.11.7",
+]
+
+[project.optional-dependencies]
+standard = ["appdirs>=1.4.4"]
+http-urllib3 = ["urllib3>=2.0.0"]
+http-requests = ["requests>=2.32.0"]
+http-httpx = ["httpx>=0.28.1"]
+
+[build-system]
+requires = [
+    "hatchling",
+    "openapi-python-client>=0.27.0",
+    "httpx>=0.28.1",
+    "attr>=0.3.2",
+]
+build-backend = "hatchling.build"
+
+[dependency-groups]
+dev = [
+    "attr>=0.3.2",
+    "fawltydeps>=0.20.0",
+    "freezegun>=1.5.5",
+    "httpx>=0.28.1",
+    "hypothesis>=6.148.2",
+    "hypothesis-jsonschema>=0.23.1",
+    "mdformat>=1.0.0",
+    "mdformat-gfm>=1.0.0",
+    "mdformat-ruff>=0.1.3",
+    "openapi-python-client>=0.27.0",
+    "pook>=2.1.0",
+    "pyright>=1.1.407",
+    "pytest>=8.3.4",
+    "pytest-cov>=7.0.0",
+    "pytest-xdist>=3.8.0",
+    "requests>=2.32.0",
+    "ruff>=0.14.3",
+    "urllib3>=2.0.0",
+]
+
+[tool.hatch.build.hooks.custom]
+path = "hatch_build.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/satvu"]
+
+[tool.hatch.build.targets.wheel.force-include]
+"src/builder" = "builder"
+
+[tool.hatch.build.targets.sdist]
+include = ["/src"]
+
+[tool.hatch.envs.default.scripts]
+build-sdk = "uv run python -m builder all"
+
+[tool.ruff]
+target-version = "py310"
+line-length = 88
+
+[tool.ruff.lint]
+select = [
+    "B", # flake8-bugbear
+    "E", # pycodestyle
+    "F", # pyflakes
+    "FURB", # refurb
+    "I", # isort
+    "SIM", # flake8-simplify
+    "UP", # pyupgrade
+]
+ignore = [
+    "E501", # line too long
+    "UP007" # x | y syntax
+]
+
+[tool.pyright]
+exclude = [
+    ".dagger/",
+    ".venv/",
+    "**/__pycache__/",
+    "**/node_modules/",
+    "src/builder/patches.py",
+]
+pythonVersion = "3.10"
+reportMissingImports = true
+reportMissingTypeStubs = false
+typeCheckingMode = "basic"
+venv = ".venv"
+venvPath = "."
+
+[tool.fawltydeps]
+code = [
+    "src/"
+]
+ignore_unused = [
+    "fawltydeps",
+    "hypothesis-jsonschema",
+    "mdformat",
+    "mdformat-gfm",
+    "mdformat-ruff",
+    "pyright",
+    "pytest-cov",
+    "pytest-xdist",
+    "ruff",
+]
+ignore_undeclared = [
+    "builder",
+    "hatchling",
+    "satvu", # Allow self-referencing imports in tests
+]
+
+[tool.commitizen]
+name = "cz_customize"
+
+[tool.commitizen.customize]
+message_template = "{{change_type}}({{scope}}): {{subject}}{% if body %}\n\n{{body}}{% endif %}{% if breaking %}\n\nBREAKING CHANGE: {{breaking}}{% endif %}"
+example = "feat(catalog): add thermal_anomaly collection support"
+schema = "<type>(<scope>): <subject>"
+schema_pattern = "^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)\\((core|auth|http|catalog|cos|id|otm|policy|reseller|wallet|builder|deps|docs|test|misc)\\): .{1,50}$"
+commit_parser = "^(?P<change_type>feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)\\((?P<scope>core|auth|http|catalog|cos|id|otm|policy|reseller|wallet|builder|deps|docs|test|misc)\\): (?P<message>.*)$"
+bump_pattern = "^(feat|fix|refactor|perf)"
+bump_map = {"feat" = "MINOR", "fix" = "PATCH", "refactor" = "PATCH", "perf" = "PATCH"}
+info = "Commits must follow: <type>(<scope>): <subject>"
+
+[[tool.commitizen.customize.questions]]
+type = "list"
+name = "change_type"
+message = "Select the type of change:"
+choices = [
+    {value = "feat", name = "feat:     A new feature"},
+    {value = "fix", name = "fix:      A bug fix"},
+    {value = "docs", name = "docs:     Documentation only"},
+    {value = "style", name = "style:    Code style (formatting, etc)"},
+    {value = "refactor", name = "refactor: Code change that neither fixes a bug nor adds a feature"},
+    {value = "perf", name = "perf:     Performance improvement"},
+    {value = "test", name = "test:     Adding or updating tests"},
+    {value = "build", name = "build:    Build system or dependencies"},
+    {value = "ci", name = "ci:       CI/CD configuration"},
+    {value = "chore", name = "chore:    Other changes (maintenance, tooling)"},
+    {value = "revert", name = "revert:   Revert a previous commit"},
+]
+
+[[tool.commitizen.customize.questions]]
+type = "list"
+name = "scope"
+message = "Select the scope of this change:"
+choices = [
+    {value = "core", name = "core:     SDK core (SDKClient, base functionality)"},
+    {value = "auth", name = "auth:     Authentication (AuthService, tokens)"},
+    {value = "http", name = "http:     HTTP adapters (httpx, requests, urllib3, stdlib)"},
+    {value = "catalog", name = "catalog:  Catalog API service"},
+    {value = "cos", name = "cos:      COS API service"},
+    {value = "id", name = "id:       ID API service"},
+    {value = "otm", name = "otm:      OTM API service"},
+    {value = "policy", name = "policy:   Policy API service"},
+    {value = "reseller", name = "reseller: Reseller API service"},
+    {value = "wallet", name = "wallet:   Wallet API service"},
+    {value = "builder", name = "builder:  SDK code generator"},
+    {value = "deps", name = "deps:     Dependencies"},
+    {value = "docs", name = "docs:     Documentation"},
+    {value = "test", name = "test:     Test infrastructure"},
+    {value = "misc", name = "misc:     Miscellaneous changes"},
+]
+
+[[tool.commitizen.customize.questions]]
+type = "input"
+name = "subject"
+message = "Write a short description (max 50 chars):"
+
+[[tool.commitizen.customize.questions]]
+type = "input"
+name = "body"
+message = "Longer description (optional, press enter to skip):"
+
+[[tool.commitizen.customize.questions]]
+type = "input"
+name = "breaking"
+message = "Breaking change description (optional, press enter to skip):"
+
+[tool.coverage.report]
+show_missing = true
+skip_empty = true
+sort = "Cover"
+omit = ["**/*_test.py", "**/conftest.py", "src/builder/**"]

satvu-0.2.0/src/builder/__init__.py

@@ -0,0 +1,8 @@
+"""
+Builder package for SatVu API SDK.
+
+This package generates Python SDK code from OpenAPI specifications.
+"""
+
+# Import patches to apply monkey-patches to openapi-python-client
+import builder.patches  # noqa: F401

satvu-0.2.0/src/builder/__main__.py

@@ -0,0 +1,12 @@
+from argparse import ArgumentParser
+
+from builder.build import build
+from builder.config import CMD_ARGS
+
+parser = ArgumentParser(__package__, description="OpenAPI SDK builder")
+parser.add_argument("api", choices=CMD_ARGS.keys())
+parser.add_argument("--cached", action="store_true", default=False)
+
+args = parser.parse_args()
+
+build(api_id=args.api, use_cached=args.cached)