pydantic/pydantic

User-facing functionality is exposed through Python APIs rather than application routes or screens. BaseModel and TypeAdapter cover structured and arbitrary typed data, with dedicated wrappers for dataclasses and function calls. Field metadata, custom validators, serializers, and specialized types refine those contracts. JSON Schema export and instrumentation plugins support integration with surrounding developer systems.

• BaseModel supports keyword construction, Python-object validation with optional attribute extraction, and JSON validation; call options include strictness, extra-field behavior, context, and alias/name selection.
  pydantic/main.py#L270-L287pydantic/main.py#L784-L798pydantic/main.py#L839-L847
• model_dump returns Python data and model_dump_json returns a string; both support inclusion/exclusion, unset/default/None filtering, context, round-trip behavior, fallbacks, and serialization warning policy.
  pydantic/main.py#L520-L536pydantic/main.py#L538-L604
• TypeAdapter builds or reuses a schema for an arbitrary type, validates Python or JSON input, supports experimental partial validation, and returns JSON bytes from dump_json.
  pydantic/type_adapter.py#L250-L297pydantic/type_adapter.py#L362-L418pydantic/type_adapter.py#L460-L474pydantic/type_adapter.py#L651-L668
• pydantic.dataclasses.dataclass wraps stdlib dataclasses with initialization validation and optional assignment validation; validate_on_init=False is rejected.
  pydantic/dataclasses.py#L100-L118pydantic/dataclasses.py#L205-L236pydantic/dataclasses.py#L273-L279
• validate_call validates function arguments and optionally return values, preserving wrapper identity and supporting coroutine functions with validation after awaiting their result.
  pydantic/validate_call_decorator.py#L83-L121pydantic/_internal/_validate_call.py#L29-L47pydantic/_internal/_validate_call.py#L106-L141
• FieldInfo represents defaults/factories, distinct validation and serialization aliases, exclusions, tagged-union discriminators, frozen fields, and constraints; decorators and Annotated handlers add custom validation and serialization.
  pydantic/fields.py#L112-L141pydantic/functional_validators.py#L75-L87pydantic/functional_serializers.py#L80-L86pydantic/_internal/_generate_schema.py#L1260-L1312
• Specialized APIs include root-value models, runtime create_model factories, ImportString resolution, filesystem path checks, masked secret types, and normalized email validation with deliverability checks disabled.
  pydantic/root_model.py#L48-L70pydantic/main.py#L1823-L1843pydantic/types.py#L1293-L1345pydantic/networks.py#L1402-L1414
• JSON Schema export supports validation/serialization modes and selectable union representation; plugins receive schema identity and settings plus optional handlers for Python, JSON, and string validation.
  pydantic/json_schema.py#L2733-L2760pydantic/plugin/__init__.py#L34-L67pydantic/plugin/_schema_validator.py#L77-L93