drazill 0.2.0__tar.gz

drazill-0.2.0/.gitignore

@@ -0,0 +1,134 @@
+# =============================================================================
+# DRAZILL BACKEND - GITIGNORE
+# =============================================================================
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+/lib/
+/lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+ENV/
+env/
+.venv/
+# ...but the sandbox RL environment package is source, not a virtualenv (DIW-10).
+# Narrow to .py sources so build artifacts (__pycache__) stay ignored.
+!app/services/ml/sandbox/env/
+!app/services/ml/sandbox/env/*.py
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.project
+.pydevproject
+.settings/
+
+# Generated multi-root Cursor workspace (machine-specific, churny worktree paths)
+*.code-workspace
+
+# Environment files
+.env
+.env.local
+.env.*.local
+*.env
+*.env.*
+*.env.bak
+*.env.backup
+*.env.backup.*
+*.env.orig
+*.env.save
+*.env.tmp
+*.env~
+config.*.env
+!config.example.env
+!*.example.env
+!*.env.example
+.envrc
+.envrc.*
+
+# Infrastructure
+infrastructure/config/*.env
+!infrastructure/config/*.env.example
+# DI-1: the staging ML enablement set is a reviewed, secret-free flags-only file
+# (all ML_*_ENABLED booleans; no keys/secrets) that ops append to the staging env.
+# Committed intentionally like scripts/ml/demo_flags.env.example — the `.env.example`
+# suffix keeps it out of the tracked-private-env CI gate (scripts/ci/check_no_tracked_env.py).
+!infrastructure/ml/staging_ml_flags.env.example
+
+# AWS Key Pairs - NEVER commit these
+*.pem
+*.key
+drazill-key.pem
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Database
+*.db
+*.sqlite
+*.sqlite3
+
+# Logs
+*.log
+logs/
+
+# Local development
+test.db
+local.db
+tmp/
+
+# AWS artifacts
+.aws-sam/
+samconfig.toml
+
+# Package files downloaded (macOS installers — never commit)
+*.pkg
+
+# SDK build artifacts
+sdks/typescript/dist/
+sdks/typescript/node_modules/
+sdks/typescript/*.tgz
+sdks/python/dist/
+sdks/python/build/
+sdks/python/*.egg-info/
+
+# Local cold-start bootstrap state + logs (may contain operator emails) — never commit
+.bootstrap-state/
+
+# Redis dump written to CWD when a local redis-server saves
+dump.rdb
+
+# Fern AI-generated API examples — a build artifact the Fern CLI writes next to the
+# spec (fern/openapi/) on `fern generate --docs` / `fern docs dev`. Regenerated each
+# build; not a source of truth (the truth-first docs mandate authors examples via
+# x-fern-examples). See fern/AGENTS.md and https://buildwithfern.com/learn/docs/ai-features/ai-examples
+**/ai_examples_override.yml

drazill-0.2.0/CHANGELOG.md

@@ -0,0 +1,77 @@
+# Changelog
+
+## Unreleased
+
+### Changed
+- **The default API base URL is now staging** (`https://staging.drazill.com/api/v1`),
+  and the default realtime URL is `wss://staging.drazill.com/ws`. Production is
+  not yet a separate live environment; because a published package cannot be
+  recalled, an unconfigured client must not be able to start trading real money
+  on its own the day `api.drazill.com` goes live. Pass `base_url=` (or set
+  `DRAZILL_BASE_URL`) to target any other environment. The default moves to
+  production in the release that ships alongside it (DRA-922).
+
+### Added
+- `DRAZILL_BASE_URL` / `DRAZILL_WS_URL` environment-variable overrides, resolved
+  as **explicit argument > environment variable > default**. `resolve_base_url`
+  and `DEFAULT_BASE_URL` are exported from the package root so callers can assert
+  which environment an unconfigured client resolves to (DRA-922).
+- First-class pagination iterators, exported from the package root:
+  `iter_cursor`/`aiter_cursor` (the canonical signed-cursor scheme) and
+  `iter_offset`/`aiter_offset`. Pass a bound resource method and iterate items
+  in one line — `for trade in iter_cursor(client.trades.get_trades_cursor,
+  market_id=...)` (DX-21).
+- `RequestOptions` for application-owned idempotency keys + per-request timeouts
+  on unsafe-verb methods (DX-23).
+
+### Fixed
+- Corrected the advertised API surface. The SDK covers **61 resource groups /
+  442 operations / 799 types** — the 0.2.0 notes and README said 41/319/458,
+  which rotted as the contract grew. The counts are now stamped into the README
+  by `sdks/generate_sdks.py` and kept honest by the SDK drift gate, so they can
+  no longer drift from the code (DX-19, DX-25).
+
+## 0.2.0 (2026-06-01)
+
+Full public API coverage. Resources and types are now generated from the
+canonical OpenAPI contract (`docs/api/openapi.v1.json`) via
+`sdks/generate_sdks.py`, keeping the SDK in lockstep with the backend.
+
+### Added
+- Complete coverage of the public API: **41 resource groups / 319 operations**
+  (previously 8 resources). New groups include disputes, moderation, rewards,
+  compliance, chat, copy-trading, lessons, market intelligence, paper trading,
+  sports, crypto, rank, parlays, conditional/bracket/TWAP/trailing-stop orders,
+  price alerts, referrals, api-keys, security, geo, fees, settings, and more.
+- Pydantic models generated for every contract schema (458 types) under
+  `drazill.types.models`, re-exported from `drazill.types`.
+- Multipart file upload support (e.g. `users.upload_avatar`,
+  `users.upload_background`).
+- Query params on `POST`/`PATCH`/`PUT`/`DELETE` (e.g.
+  `orders.place_order(body, include_receipt=True)`).
+
+### Changed (breaking)
+- **Method names now mirror the API operation** (e.g. `markets.list()` →
+  `markets.list_markets()`, `markets.get(id)` → `markets.get_market(id)`,
+  `orders.create(...)` → `orders.place_order(body)`). See the README for the
+  naming convention and full examples.
+- Request bodies are passed as a single positional argument (a typed model or a
+  `dict`) instead of keyword arguments.
+- Query values keep their native types (numbers are no longer stringified);
+  enums and bools are coerced for transport.
+- Removed per-resource `list_all()` iterators; paginate with the returned page
+  object (`page`/`pages`) or cursor endpoints (`*_cursor`).
+
+## 0.1.0 (2026-03-06)
+
+Initial release.
+
+- Synchronous client (`DrazillClient`) and async client (`AsyncDrazillClient`)
+- Full type safety with Pydantic models for all API responses
+- Resource classes for Markets, Orders, Wallet, Users, Comments, Watchlist, and Notifications
+- WebSocket client with auto-reconnect and channel subscriptions (requires `drazill[websocket]`)
+- API key (`X-API-Key`) and Bearer token authentication
+- Automatic retry with exponential backoff for 5xx and 429 errors
+- Auto-pagination iterators via `list_all()` helpers (sync and async)
+- Typed error classes: `ApiError`, `AuthenticationError`, `RateLimitError`, `ValidationError`, `NetworkError`
+- `py.typed` marker for PEP 561 type checking support

drazill-0.2.0/LICENSE

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