owlvigil 0.2.0__tar.gz

owlvigil-0.2.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,10 @@
+## Summary
+
+## API or behavior affected
+
+## Verification
+
+- [ ] Tests added or updated
+- [ ] Full local test suite passes
+- [ ] Documentation updated
+- [ ] No credentials or sensitive data included

owlvigil-0.2.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.venv/
+dist/
+build/
+*.egg-info/
+.env
+.idea/

owlvigil-0.2.0/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+This project follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
+and uses [Semantic Versioning](https://semver.org/). During the 0.x preview,
+minor releases may include announced breaking changes.
+
+## [Unreleased]
+
+## [0.2.0] - 2026-09-12
+
+### Added
+
+- A generated, checked-in Management OpenAPI catalog with 144 operations and
+  generated snake_case sync/async methods.
+- Generated Python `TypedDict` definitions for 167 Management schemas.
+- Management `open_api()` requests with typed path/query/body forwarding and
+  cursor-based workspace iteration.
+- Sync and async OAuth 2.0 clients with custom base paths and consistent
+  protocol errors.
+- Production, staging, and local environment routing compatible with the Go
+  SDK.
+
+### Changed
+
+- Direct `pytest` execution now works with the src-layout package.
+- CI validates the source package, wheel/sdist metadata, and generated API
+  surface.

owlvigil-0.2.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,12 @@
+# Code of Conduct
+
+We are committed to a welcoming, harassment-free community. Be respectful,
+assume good intent, give actionable feedback, and avoid discriminatory,
+threatening, sexualized, or personally abusive conduct.
+
+Maintainers may edit or remove inappropriate contributions and may temporarily
+or permanently restrict participation. Report conduct concerns privately
+through [the maintainers](https://github.com/Syrovex/owlvigil_sdk_python/security/advisories/new).
+Enforcement will be fair, proportionate, and respectful of reporter privacy.
+
+This policy is based on the principles of the Contributor Covenant 2.1.

owlvigil-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,20 @@
+# Contributing to OwlVigil
+
+Thank you for improving the OwlVigil SDK.
+
+## Development
+
+Use Python 3.9 or later in a virtual environment.
+
+```bash
+python -m pip install -e '.[test]'
+pytest
+```
+
+Keep changes focused, add contract tests for public behavior, and never add API
+keys, access tokens, provider credentials, or webhook secrets to commits.
+
+Open an issue before making a large API or compatibility change. Pull requests
+should explain the affected API contract, tests run, compatibility impact, and
+any credential requirements. By contributing, you agree that your contribution
+is licensed under this repository's MIT License.

owlvigil-0.2.0/LICENSE

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

owlvigil-0.2.0/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: owlvigil
+Version: 0.2.0
+Summary: Python SDK for OwlVigil Gateway and Management APIs
+Project-URL: Homepage, https://github.com/Syrovex/owlvigil_sdk_python
+Project-URL: Repository, https://github.com/Syrovex/owlvigil_sdk_python
+Project-URL: Issues, https://github.com/Syrovex/owlvigil_sdk_python/issues
+Project-URL: Changelog, https://github.com/Syrovex/owlvigil_sdk_python/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/Syrovex/owlvigil_sdk_python#readme
+Author: OwlVigil
+Maintainer: OwlVigil
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,gateway,openai,owlvigil,sdk
+Classifier: Development Status :: 3 - Alpha
+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: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx<1,>=0.27
+Provides-Extra: release
+Requires-Dist: build<2,>=1.2; extra == 'release'
+Requires-Dist: twine<7,>=5; extra == 'release'
+Provides-Extra: test
+Requires-Dist: pytest-asyncio<1,>=0.24; extra == 'test'
+Requires-Dist: pytest<9,>=8; extra == 'test'
+Description-Content-Type: text/markdown
+
+# OwlVigil Python SDK
+
+Sync and native async Python 3.9+ clients for the OwlVigil AI Gateway,
+Management API, streaming, and webhook verification.
+
+## Installation
+
+```bash
+pip install owlvigil
+```
+
+Until the package is published on PyPI, install a trusted source checkout
+with `pip install .`.
+
+## Quick start
+
+Set `OWLVIGIL_GATEWAY_KEY` and use a provider-facing model name:
+
+```python
+from owlvigil import OwlVigil
+
+with OwlVigil() as client:
+    response = client.gateway.create_chat_completion({
+        "model": "deepseek-v4-flash",
+        "messages": [{"role": "user", "content": "Hello"}],
+    })
+    print(response.data["choices"][0]["message"]["content"])
+```
+
+`AsyncOwlVigil` provides native async requests and async streaming. Sync and
+async clients are context managers and close only HTTP clients they own.
+
+Set `OWLVIGIL_API_KEY` only for Management calls. List workspaces first, then
+pass the returned workspace ID to workspace-scoped methods. `RequestOptions`
+controls timeout, retry limits, idempotency keys, and safe custom headers.
+Retries apply only to idempotent calls or calls with an idempotency key.
+
+Use `environment="staging"` or `environment="local"` for the same endpoint
+routing convention as the Go SDK. `OWLVIGIL_ENV` is used when the option is
+omitted. Explicit base URLs remain available for reverse proxies and test
+servers.
+
+## Supported preview surface
+
+- Gateway models, Chat Completions, Responses, Embeddings, and Anthropic Messages
+- Sync and async SSE streaming for Chat Completions and Responses
+- Workspace listing, usage summary, and request-log lookup
+- The complete generated 144-operation Management OpenAPI catalog, available
+  through `open_api()` and generated snake_case methods
+- OAuth 2.0 authorization-code, refresh-token, client-credentials, revocation,
+  and user-info flows
+- Webhook HMAC signing and verification
+
+## Development
+
+```bash
+python -m pip install -e '.[test,release]'
+pytest
+python -m build
+python -m twine check dist/*
+```
+
+Regenerate the checked-in Management catalog and Python types with:
+
+```bash
+python scripts/generate_all.py
+```
+
+Live tests are opt-in and read-only.
+
+## Documentation
+
+- Developer guides: [English](docs/DEVELOPER_GUIDE.en-US.md) · [简体中文](docs/DEVELOPER_GUIDE.zh-CN.md)
+- [CONTRIBUTING.md](CONTRIBUTING.md), [SECURITY.md](SECURITY.md),
+  [SUPPORT.md](SUPPORT.md), and [CHANGELOG.md](CHANGELOG.md)
+
+Licensed under the [MIT License](LICENSE).

owlvigil-0.2.0/README.md

@@ -0,0 +1,77 @@
+# OwlVigil Python SDK
+
+Sync and native async Python 3.9+ clients for the OwlVigil AI Gateway,
+Management API, streaming, and webhook verification.
+
+## Installation
+
+```bash
+pip install owlvigil
+```
+
+Until the package is published on PyPI, install a trusted source checkout
+with `pip install .`.
+
+## Quick start
+
+Set `OWLVIGIL_GATEWAY_KEY` and use a provider-facing model name:
+
+```python
+from owlvigil import OwlVigil
+
+with OwlVigil() as client:
+    response = client.gateway.create_chat_completion({
+        "model": "deepseek-v4-flash",
+        "messages": [{"role": "user", "content": "Hello"}],
+    })
+    print(response.data["choices"][0]["message"]["content"])
+```
+
+`AsyncOwlVigil` provides native async requests and async streaming. Sync and
+async clients are context managers and close only HTTP clients they own.
+
+Set `OWLVIGIL_API_KEY` only for Management calls. List workspaces first, then
+pass the returned workspace ID to workspace-scoped methods. `RequestOptions`
+controls timeout, retry limits, idempotency keys, and safe custom headers.
+Retries apply only to idempotent calls or calls with an idempotency key.
+
+Use `environment="staging"` or `environment="local"` for the same endpoint
+routing convention as the Go SDK. `OWLVIGIL_ENV` is used when the option is
+omitted. Explicit base URLs remain available for reverse proxies and test
+servers.
+
+## Supported preview surface
+
+- Gateway models, Chat Completions, Responses, Embeddings, and Anthropic Messages
+- Sync and async SSE streaming for Chat Completions and Responses
+- Workspace listing, usage summary, and request-log lookup
+- The complete generated 144-operation Management OpenAPI catalog, available
+  through `open_api()` and generated snake_case methods
+- OAuth 2.0 authorization-code, refresh-token, client-credentials, revocation,
+  and user-info flows
+- Webhook HMAC signing and verification
+
+## Development
+
+```bash
+python -m pip install -e '.[test,release]'
+pytest
+python -m build
+python -m twine check dist/*
+```
+
+Regenerate the checked-in Management catalog and Python types with:
+
+```bash
+python scripts/generate_all.py
+```
+
+Live tests are opt-in and read-only.
+
+## Documentation
+
+- Developer guides: [English](docs/DEVELOPER_GUIDE.en-US.md) · [简体中文](docs/DEVELOPER_GUIDE.zh-CN.md)
+- [CONTRIBUTING.md](CONTRIBUTING.md), [SECURITY.md](SECURITY.md),
+  [SUPPORT.md](SUPPORT.md), and [CHANGELOG.md](CHANGELOG.md)
+
+Licensed under the [MIT License](LICENSE).

owlvigil-0.2.0/SECURITY.md

@@ -0,0 +1,21 @@
+# Security Policy
+
+Security reports must not be filed as public issues.
+
+## Supported versions
+
+| Version | Supported |
+| --- | --- |
+| Latest 0.x release | Yes |
+| Older 0.x releases | No |
+
+Report a vulnerability privately through [GitHub Security
+Advisories](https://github.com/Syrovex/owlvigil_sdk_python/security/advisories/new). Include the affected
+version, impact, reproduction steps, and any suggested mitigation. Do not
+include real customer credentials or data.
+
+Maintainers target acknowledgement within three business days and an initial
+status update within seven business days. We will validate the issue,
+coordinate a fix and disclosure, and credit reporters who want attribution.
+Timelines may change with severity and complexity, but reporters will receive
+updates while remediation is active.

owlvigil-0.2.0/SUPPORT.md

@@ -0,0 +1,12 @@
+# Support
+
+- Use [GitHub Discussions](https://github.com/Syrovex/owlvigil_sdk_python/discussions) for usage questions.
+- Use [GitHub Issues](https://github.com/Syrovex/owlvigil_sdk_python/issues) for reproducible SDK bugs and feature requests.
+- Use the private process in [SECURITY.md](SECURITY.md) for vulnerabilities.
+
+Include the SDK version, runtime version, minimal reproduction, status code,
+and request ID. Never post API keys, provider credentials, tokens, webhook
+secrets, or sensitive request and response bodies.
+
+The SDK is currently a 0.x preview. Backward-incompatible changes will be
+called out in the changelog; deprecated APIs will be retained when practical.