valbridge-pydantic-extractor 1.0.2

Workspace-local Pydantic extraction utilities for valbridge

Extract JSON Schema from existing Pydantic models, enriched with x-valbridge annotations for high-fidelity cross-language generation.

---

Installation

pip install valbridge-pydantic-extractor
# or
uv add valbridge-pydantic-extractor

CLI usage

valbridge-pydantic-extractor app.models:User --python-path .

Output is JSON with:

• schema -- the extracted JSON Schema document
• diagnostics -- import or extraction diagnostics when the target cannot be resolved cleanly

Options

Flag	Description
--python-path <path>	Prepend an import path before loading the target module
--module-root <path>	Add module roots for project-local imports
--stub-module <module>	Install placeholder modules for optional imports
--env KEY=VALUE	Inject environment variables before importing the model

Key behaviors

• Target must use module:Class format
• Target class must inherit from pydantic.BaseModel
• Extracted output preserves x-valbridge annotations needed by downstream code generation
• Emits diagnostics for Pydantic features that cannot be represented in JSON Schema

Related packages

Package	Purpose
valbridge-pydantic	Pydantic adapter (JSON Schema to Pydantic)
valbridge-core	Core IR and JSON Schema parser
@vectorfyco/valbridge-zod-extractor	TypeScript equivalent for Zod schemas

Learn more

• GitHub repository
• Full documentation