Skip to content

docs(deps): Add Python Bindings API Formalization DEP#68

Open
nnshah1 wants to merge 1 commit intomainfrom
python-bindings-api-dep
Open

docs(deps): Add Python Bindings API Formalization DEP#68
nnshah1 wants to merge 1 commit intomainfrom
python-bindings-api-dep

Conversation

@nnshah1
Copy link
Contributor

@nnshah1 nnshah1 commented Feb 5, 2026

Summary

  • Separates Python bindings from the 1.0 API DEP into its own proposal
  • Includes both the working document and formalized DEP

Files Added

  1. proposal-bindings-v2.md - Graham's working document with:

    • Current inventory of 65+ classes/functions
    • Identified issues and proposed actions
    • Notes on KV router, metrics, multimodal interfaces
  2. 0000-python-bindings-api.md - Formalized DEP with:

    • Public API surface definition
    • Proposal to move internals to dynamo._internal
    • Unified interface proposals
    • Stability guarantees
    • Type stubs requirements
    • Implementation phases

Key Proposals

  1. Move internal bindings (Namespace, Component, Context, etc.) to dynamo._internal
  2. Unify KV router interfaces (15+ classes → unified KvRouter/KvPublisher)
  3. Reorganize metrics under dynamo.metrics module
  4. Establish stable vs unstable API tiers

Related

  • Dynamo PRs: #5412, #5458
  • Should be removed from dynamo_api branch after merge

Test plan

  • Review DEP content for completeness
  • Verify alignment with Graham's original proposal
  • Confirm format matches DEP template

🤖 Generated with Claude Code

Separates Python bindings from the 1.0 API DEP into its own proposal.

Includes:
- proposal-bindings-v2.md: Working document with current state analysis
- 0000-python-bindings-api.md: Formalized DEP

Key content:
- Inventory of 65+ classes/functions currently exposed
- Proposal to move internals to dynamo._internal
- Unified KV router interfaces
- Metrics module reorganization
- Stability guarantees (stable vs unstable APIs)
- Type stubs requirements

Related PRs:
- ai-dynamo/dynamo#5412
- ai-dynamo/dynamo#5458

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
nnshah1 added a commit that referenced this pull request Feb 5, 2026
- Replace DEP content with full requirements from temporary.md
- Add Component Registry with support levels and standardization priorities
- Add Testing Requirements section with test pyramid and coverage targets
- Add Framework Requirements for vLLM/SGLang version support
- Add Developer Velocity Requirements with metrics and ownership model
- Add CI/CD Requirements with P0/P1 priorities
- Add Packaging and Repo Structure section
- Remove proposal-bindings-v2.md (moved to separate PR #68)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant