pydantic-models-py/references/capabilities.md

pydantic-models-py capability coverage

SDK/package: pydantic

This reference captures additional non-hero capabilities and API breadth so the main SKILL.md can stay focused on copy/paste hero flows.

Hero scenarios covered in SKILL.md

• Quick Start
• Multi-Model Pattern
• camelCase Aliases
• Optional Update Fields

Important non-hero scenarios to include when needed

• Database Document
• Integration Steps

API breadth checklist

• Verify field validators (@field_validator) and model validators (@model_validator) cover all required constraints.
• Confirm serialization behavior: use model_dump(mode="json") for JSON-safe output and model_dump(exclude_unset=True) for partial updates.
• Include schema generation examples (model_json_schema()) when the model drives API contracts or documentation.
• Use model_validate when validating an existing dict or object; direct BaseModel(...) construction also runs validators and coercion.
• Ensure new code uses Pydantic v2 patterns (@field_validator, model_config) rather than deprecated v1 patterns (@validator, orm_mode).