spatialflow 0.1.0__tar.gz → 0.2.0__tar.gz

spatialflow-0.2.0/.gitignore

@@ -0,0 +1,29 @@
+# Build artifacts
+dist/
+build/
+*.egg-info/
+
+# Python cache
+__pycache__/
+*.py[cod]
+*$py.class
+.pytest_cache/
+
+# Coverage
+htmlcov/
+.coverage
+.coverage.*
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OpenAPI generator scratch (if regenerating)
+.openapi-generator/FILES

{spatialflow-0.1.0 → spatialflow-0.2.0}/CHANGELOG.md

@@ -5,7 +5,33 @@ All notable changes to the SpatialFlow Python SDK will be documented in this fil
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.1.0] - 2024-12-04
+## [0.2.0] - 2025-12-26
+
+### Added
+
+- **Workflow activation**: `client.workflows.activate(workflow_id)` - Activate draft workflows for production use
+  - Idempotent: returns success if workflow is already active
+  - Validates workflow has trigger and steps before activation
+  - Rate limited: 1000 requests/hour
+
+### Fixed
+
+- **Integrations API key auth**: Integrations API now accepts API key authentication (was JWT-only)
+  - Requires `integrations:read` permission for list/get endpoints
+  - Requires `integrations:write` permission for create/update/delete/test endpoints
+  - Fixes: GitHub issue #114
+
+- **Location ingest JWT auth**: Location ingest API now accepts JWT authentication (was API-key-only)
+  - Both JWT and API key auth now work for location ingestion
+  - Fixes: GitHub issue #115
+
+### Technical Details
+
+- Regenerated from OpenAPI spec using openapi-generator-cli 7.19.0
+- Generated package now installed as `spatialflow_generated` in virtualenv
+- OpenAPI spec hash: ce5ef5f82f7f17ebc5d628a612b84d1d39159c330c8362c4680be7bbdda50327
+
+## [0.1.0] - 2025-12-04
 
 ### Added
 

spatialflow-0.2.0/LICENSE

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

spatialflow-0.2.0/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: spatialflow
+Version: 0.2.0
+Summary: Python SDK for SpatialFlow - Real-time geospatial automation platform
+Project-URL: Homepage, https://spatialflow.io
+Project-URL: Documentation, https://docs.spatialflow.io/sdk/python
+Project-URL: Repository, https://github.com/spatialflow-io/spatialflow-python
+Project-URL: Issues, https://github.com/spatialflow-io/spatialflow-python/issues
+Project-URL: Changelog, https://github.com/spatialflow-io/spatialflow-python/blob/main/CHANGELOG.md
+Author-email: SpatialFlow <support@spatialflow.io>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: automation,geofencing,geospatial,location,sdk,spatialflow
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: aiohttp-retry>=2.8.3
+Requires-Dist: aiohttp>=3.8.4
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: typing-extensions>=4.7.1
+Requires-Dist: urllib3<3.0.0,>=1.25.3
+Provides-Extra: dev
+Requires-Dist: aioresponses>=0.7.4; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.0.0; extra == 'docs'
+Requires-Dist: mkdocs>=1.5.0; extra == 'docs'
+Requires-Dist: mkdocstrings[python]>=0.24.0; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# SpatialFlow Python SDK
+
+The official Python SDK for [SpatialFlow](https://spatialflow.io) - a real-time geospatial automation platform.
+
+## Installation
+
+```bash
+pip install spatialflow
+```
+
+### Development Installation
+
+```bash
+cd sdks/python
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```python
+import asyncio
+from spatialflow import SpatialFlow
+
+async def main():
+    async with SpatialFlow(api_key="sf_xxx") as client:
+        # List geofences
+        response = await client.geofences.list()
+        for geofence in response.geofences:
+            print(f"{geofence.name}: {geofence.id}")
+
+        # Get workspace usage
+        usage = await client.workspaces.get_usage()
+        print(f"Event units: {usage.event_units}")
+
+asyncio.run(main())
+```
+
+## Supported Resources
+
+| Resource | Methods | Description |
+|----------|---------|-------------|
+| **Geofences** | CRUD, upload, bulk | Manage geofence boundaries |
+| **Workflows** | CRUD, execute, monitor, versioning | Automation workflows |
+| **Webhooks** | CRUD, deliveries, DLQ, metrics | Webhook endpoints and delivery tracking |
+| **Devices** | CRUD, location updates | Device management |
+| **Account** | profile, API keys, metrics, onboarding | User account management |
+| **Workspaces** | get, update, usage | Workspace settings and usage metrics |
+| **Locations** | ingest, batch, stats | Public location ingestion API |
+| **Integrations** | CRUD, test | Third-party service connections |
+| **Storage** | presigned URLs, files | File upload and management |
+
+## Features
+
+- Fully async with `aiohttp`
+- Automatic retry with exponential backoff
+- Pagination helpers
+- Webhook signature verification
+- Workflow builders for common patterns
+- File upload with streaming (memory efficient)
+
+## Error Handling
+
+```python
+from spatialflow import SpatialFlow, NotFoundError, ValidationError
+
+async with SpatialFlow(api_key="sf_xxx") as client:
+    try:
+        geofence = await client.geofences.get("invalid-id")
+    except NotFoundError as e:
+        print(f"Geofence not found: {e}")
+    except ValidationError as e:
+        print(f"Invalid request: {e.errors}")
+```
+
+## Raw API Access
+
+For advanced use cases, access the generated API clients directly:
+
+```python
+async with SpatialFlow(api_key="sf_xxx") as client:
+    # Use raw generated API
+    response = await client.raw.geofences.apps_geofences_api_list_geofences()
+```
+
+Available via `client.raw`:
+- `geofences`, `workflows`, `webhooks`, `devices`, `storage`, `locations`, `integrations`, `workspaces`, `account` (also wrapped)
+- `authentication`, `admin`, `billing`, `subscriptions`, `tiles` (raw only)
+
+> **Alpha Notice:** This SDK is in alpha (v0.1.0). Some generated APIs (email, system, gpx_simulator,
+> public, default, e2e_test) are not yet exposed. Use the generated client directly for those.
+
+## Documentation
+
+Full documentation: [docs.spatialflow.io/sdks/python](https://docs.spatialflow.io/sdks/python)
+
+## License
+
+MIT

spatialflow-0.2.0/README.md

@@ -0,0 +1,98 @@
+# SpatialFlow Python SDK
+
+The official Python SDK for [SpatialFlow](https://spatialflow.io) - a real-time geospatial automation platform.
+
+## Installation
+
+```bash
+pip install spatialflow
+```
+
+### Development Installation
+
+```bash
+cd sdks/python
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```python
+import asyncio
+from spatialflow import SpatialFlow
+
+async def main():
+    async with SpatialFlow(api_key="sf_xxx") as client:
+        # List geofences
+        response = await client.geofences.list()
+        for geofence in response.geofences:
+            print(f"{geofence.name}: {geofence.id}")
+
+        # Get workspace usage
+        usage = await client.workspaces.get_usage()
+        print(f"Event units: {usage.event_units}")
+
+asyncio.run(main())
+```
+
+## Supported Resources
+
+| Resource | Methods | Description |
+|----------|---------|-------------|
+| **Geofences** | CRUD, upload, bulk | Manage geofence boundaries |
+| **Workflows** | CRUD, execute, monitor, versioning | Automation workflows |
+| **Webhooks** | CRUD, deliveries, DLQ, metrics | Webhook endpoints and delivery tracking |
+| **Devices** | CRUD, location updates | Device management |
+| **Account** | profile, API keys, metrics, onboarding | User account management |
+| **Workspaces** | get, update, usage | Workspace settings and usage metrics |
+| **Locations** | ingest, batch, stats | Public location ingestion API |
+| **Integrations** | CRUD, test | Third-party service connections |
+| **Storage** | presigned URLs, files | File upload and management |
+
+## Features
+
+- Fully async with `aiohttp`
+- Automatic retry with exponential backoff
+- Pagination helpers
+- Webhook signature verification
+- Workflow builders for common patterns
+- File upload with streaming (memory efficient)
+
+## Error Handling
+
+```python
+from spatialflow import SpatialFlow, NotFoundError, ValidationError
+
+async with SpatialFlow(api_key="sf_xxx") as client:
+    try:
+        geofence = await client.geofences.get("invalid-id")
+    except NotFoundError as e:
+        print(f"Geofence not found: {e}")
+    except ValidationError as e:
+        print(f"Invalid request: {e.errors}")
+```
+
+## Raw API Access
+
+For advanced use cases, access the generated API clients directly:
+
+```python
+async with SpatialFlow(api_key="sf_xxx") as client:
+    # Use raw generated API
+    response = await client.raw.geofences.apps_geofences_api_list_geofences()
+```
+
+Available via `client.raw`:
+- `geofences`, `workflows`, `webhooks`, `devices`, `storage`, `locations`, `integrations`, `workspaces`, `account` (also wrapped)
+- `authentication`, `admin`, `billing`, `subscriptions`, `tiles` (raw only)
+
+> **Alpha Notice:** This SDK is in alpha (v0.1.0). Some generated APIs (email, system, gpx_simulator,
+> public, default, e2e_test) are not yet exposed. Use the generated client directly for those.
+
+## Documentation
+
+Full documentation: [docs.spatialflow.io/sdks/python](https://docs.spatialflow.io/sdks/python)
+
+## License
+
+MIT

{spatialflow-0.1.0 → spatialflow-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "spatialflow"
-version = "0.1.0"
+version = "0.2.0"
 description = "Python SDK for SpatialFlow - Real-time geospatial automation platform"
 readme = "README.md"
 license = "MIT"
@@ -61,6 +61,30 @@ Changelog = "https://github.com/spatialflow-io/spatialflow-python/blob/main/CHAN
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/spatialflow"]
+# Exclude generated scaffolding from wheel (keep only Python code)
+exclude = [
+    # OpenAPI generator scaffolding
+    "**/.openapi-generator*",
+    "**/git_push.sh",
+    # Generated docs (not needed at runtime)
+    "**/docs/**",
+    # CI/CD configs
+    "**/.github/**",
+    "**/.gitlab-ci.yml",
+    "**/.travis.yml",
+    "**/tox.ini",
+    # Build configs (use root pyproject.toml instead)
+    "src/spatialflow/_generated/pyproject.toml",
+    "src/spatialflow/_generated/setup.py",
+    "src/spatialflow/_generated/setup.cfg",
+    "src/spatialflow/_generated/requirements.txt",
+    "src/spatialflow/_generated/test-requirements.txt",
+    # Generated README (we have our own)
+    "src/spatialflow/_generated/README.md",
+    # Git ignores
+    "**/.gitignore",
+    "**/.spec-hash",
+]
 
 [tool.hatch.build.targets.sdist]
 include = [
@@ -68,6 +92,25 @@ include = [
     "/tests",
     "/README.md",
     "/CHANGELOG.md",
+    "/LICENSE",
+]
+exclude = [
+    # Same exclusions for sdist
+    "**/.openapi-generator*",
+    "**/git_push.sh",
+    "**/docs/**",
+    "**/.github/**",
+    "**/.gitlab-ci.yml",
+    "**/.travis.yml",
+    "**/tox.ini",
+    "src/spatialflow/_generated/pyproject.toml",
+    "src/spatialflow/_generated/setup.py",
+    "src/spatialflow/_generated/setup.cfg",
+    "src/spatialflow/_generated/requirements.txt",
+    "src/spatialflow/_generated/test-requirements.txt",
+    "src/spatialflow/_generated/README.md",
+    "**/.gitignore",
+    "**/.spec-hash",
 ]
 
 [tool.ruff]

spatialflow-0.2.0/src/spatialflow/__init__.py

@@ -0,0 +1,144 @@
+"""
+SpatialFlow Python SDK
+
+A Python client for the SpatialFlow API - real-time geospatial automation platform.
+
+Example:
+    >>> from spatialflow import SpatialFlow, models
+    >>>
+    >>> async with SpatialFlow(api_key="sf_xxx") as client:
+    ...     # List geofences
+    ...     response = await client.geofences.list()
+    ...     for geofence in response.geofences:
+    ...         print(geofence.name)
+    ...
+    ...     # Create a geofence
+    ...     geofence = await client.geofences.create(
+    ...         models.CreateGeofenceRequest(name="My Region", geometry={...})
+    ...     )
+
+"""
+
+__version__ = "0.2.0"
+
+# Main client (imported early to get DEFAULT_BASE_URL)
+from .client import SpatialFlow, DEFAULT_BASE_URL
+
+# Custom exceptions
+from .exceptions import (
+    SpatialFlowError,
+    AuthenticationError,
+    PermissionError,
+    NotFoundError,
+    ValidationError,
+    RateLimitError,
+    ServerError,
+    ConflictError,
+    TimeoutError,
+    ConnectionError,
+    translate_exception,
+)
+
+# Webhook verification
+from .webhooks import verify_webhook_signature, WebhookSignatureError, verify_signature
+
+# Pagination helpers
+from .pagination import (
+    paginate,
+    paginate_geofences,
+    paginate_workflows,
+    paginate_webhooks,
+    paginate_users,
+    paginate_files,
+    AsyncPaginator,
+    PaginatedResponse,
+)
+
+# Job polling helpers
+from .jobs import poll_job, JobResult, JobTimeoutError, JobFailedError
+
+# File upload helpers
+from .uploads import upload_geofences
+
+# Workflow builders
+from .builders import (
+    build_geofence_webhook_workflow,
+    build_geofence_integration_workflow,
+    TriggerType,
+)
+
+# Resource classes (for type hints and advanced usage)
+from .resources import (
+    AccountResource,
+    GeofencesResource,
+    WorkflowsResource,
+    WebhooksResource,
+    DevicesResource,
+    StorageResource,
+    LocationsResource,
+    IntegrationsResource,
+    WorkspacesResource,
+)
+
+# Re-export generated client and models for advanced usage
+from ._generated.spatialflow_generated.api_client import ApiClient
+from ._generated.spatialflow_generated.configuration import Configuration
+from ._generated.spatialflow_generated import models
+
+__all__ = [
+    # Version
+    "__version__",
+    "DEFAULT_BASE_URL",
+    # Main client
+    "SpatialFlow",
+    # Exceptions
+    "SpatialFlowError",
+    "AuthenticationError",
+    "PermissionError",
+    "NotFoundError",
+    "ValidationError",
+    "RateLimitError",
+    "ServerError",
+    "ConflictError",
+    "TimeoutError",
+    "ConnectionError",
+    "translate_exception",
+    # Webhooks
+    "verify_webhook_signature",
+    "verify_signature",
+    "WebhookSignatureError",
+    # Pagination
+    "paginate",
+    "paginate_geofences",
+    "paginate_workflows",
+    "paginate_webhooks",
+    "paginate_users",
+    "paginate_files",
+    "AsyncPaginator",
+    "PaginatedResponse",
+    # Job polling
+    "poll_job",
+    "JobResult",
+    "JobTimeoutError",
+    "JobFailedError",
+    # File uploads
+    "upload_geofences",
+    # Workflow builders
+    "build_geofence_webhook_workflow",
+    "build_geofence_integration_workflow",
+    "TriggerType",
+    # Resource classes
+    "AccountResource",
+    "GeofencesResource",
+    "WorkflowsResource",
+    "WebhooksResource",
+    "DevicesResource",
+    "StorageResource",
+    "LocationsResource",
+    "IntegrationsResource",
+    "WorkspacesResource",
+    # Generated (advanced)
+    "ApiClient",
+    "Configuration",
+    "models",
+]