• Repository
• Stars:
• Forks:
• Open issues:
• Open PRs:

Meta

• License Expression: MIT
  SPDXLicense Expression
• Author:Samuel Colvin
• Requires: Python >=3.9
• Provides-Extra:email,timezone

Classifiers

• Development Status
  • 5 - Production/Stable
• Framework
  • Hypothesis
  • Pydantic
• Intended Audience
  • Developers
  • Information Technology
• License
  • OSI Approved :: MIT License
• Operating System
  • OS Independent
• Programming Language
  • Python
  • Python :: 3
  • Python :: 3 :: Only
  • Python :: 3.9
  • Python :: 3.10
  • Python :: 3.11
  • Python :: 3.12
  • Python :: 3.13
  • Python :: Implementation :: CPython
  • Python :: Implementation :: PyPy
• Topic
  • Internet
  • Software Development :: Libraries :: Python Modules

Pydantic

Data validation using Python type hints.

Fast and extensible, Pydantic plays nicely with your linters/IDE/brain.Define how data should be in pure, canonical Python 3.9+; validate it with Pydantic.

Pydantic Logfire :fire:

We've recently launched Pydantic Logfire to help you monitor your applications.Learn more

Pydantic V1.10 vs. V2

Pydantic V2 is a ground-up rewrite that offers many new features, performance improvements, and some breaking changes compared to Pydantic V1.

If you're using Pydantic V1 you may want to look at thepydantic V1.10 Documentation or,1.10.X-fixes git branch. Pydantic V2 also ships with the latest version of Pydantic V1 built in so that you can incrementally upgrade your code base and projects:from pydantic import v1 as pydantic_v1.

Help

Seedocumentation for more details.

Installation

Install usingpip install -U pydantic orconda install pydantic -c conda-forge.For more installation options to make Pydantic even faster,see theInstall section in the documentation.

A Simple Example

fromdatetimeimportdatetimefromtypingimportOptionalfrompydanticimportBaseModelclassUser(BaseModel):id:intname:str='John Doe'signup_ts:Optional[datetime]=Nonefriends:list[int]=[]external_data={'id':'123','signup_ts':'2017-06-01 12:22','friends':[1,'2',b'3']}user=User(**external_data)print(user)#> User id=123 name='John Doe' signup_ts=datetime.datetime(2017, 6, 1, 12, 22) friends=[1, 2, 3]print(user.id)#> 123

Contributing

For guidance on setting up a development environment and how to make acontribution to Pydantic, seeContributing to Pydantic.

Reporting a Security Vulnerability

See oursecurity policy.

Changelog

v2.11.7 (2025-06-14)

GitHub release

What's Changed

Fixes

• CopyFieldInfo instance if necessary duringFieldInfo build by@Viicos in#11898

v2.11.6 (2025-06-13)

GitHub release

What's Changed

Fixes

• Rebuild dataclass fields before schema generation by@Viicos in#11949
• Always store the original field assignment onFieldInfo by@Viicos in#11946

v2.11.5 (2025-05-22)

GitHub release

What's Changed

Fixes

• Check ifFieldInfo is complete after applying type variable map by@Viicos in#11855
• Do not delete mock validator/serializer inmodel_rebuild() by@Viicos in#11890
• Do not duplicate metadata on model rebuild by@Viicos in#11902

v2.11.4 (2025-04-29)

GitHub release

What's Changed

Packaging

• Bumpmkdocs-llmstxt to v0.2.0 by@Viicos in#11725

Changes

• Allow config and bases to be specified together increate_model() by@Viicos in#11714.This change was backported as it was previously possible (although not meant to be supported)to providemodel_config as a field, which would make it possible to provide both configurationand bases.

Fixes

• Remove generics cache workaround by@Viicos in#11755
• Remove coercion of decimal constraints by@Viicos in#11772
• Fix crash when expanding root type in the mypy plugin by@Viicos in#11735
• Fix issue with recursive generic models by@Viicos in#11775
• Traversefunction-before schemas during schema gathering by@Viicos in#11801

v2.11.3 (2025-04-08)

GitHub release

What's Changed

Packaging

• Update V1 copy to v1.10.21 by@Viicos in#11706

Fixes

• Preserve field description when rebuilding model fields by@Viicos in#11698

v2.11.2 (2025-04-03)

GitHub release

What's Changed

Fixes

• Bumppydantic-core to v2.33.1 by@Viicos in#11678
• Make sure__pydantic_private__ exists before setting private attributes by@Viicos in#11666
• Do not overrideFieldInfo._complete when using field from parent class by@Viicos in#11668
• Provide the available definitions when applying discriminated unions by@Viicos in#11670
• Do not expand root type in the mypy plugin for variables by@Viicos in#11676
• Mention the attribute name in model fields deprecation message by@Viicos in#11674
• Properly validate parameterized mappings by@Viicos in#11658

v2.11.1 (2025-03-28)

GitHub release

What's Changed

Fixes

• Do not override'definitions-ref' schemas containing serialization schemas or metadata by@Viicos in#11644

v2.11.0 (2025-03-27)

GitHub release

What's Changed

Pydantic v2.11 is a version strongly focused on build time performance of Pydantic models (and core schema generation in general).See theblog post for more details.

Packaging

• Bumppydantic-core to v2.33.0 by@Viicos in#11631

New Features

• Addencoded_string() method to the URL types by@YassinNouh21 in#11580
• Add support fordefer_build with@validate_call decorator by@Viicos in#11584
• Allow@with_config decorator to be used with keyword arguments by@Viicos in#11608
• Simplify customization of default value inclusion in JSON Schema generation by@Viicos in#11634
• Addgenerate_arguments_schema() function by@Viicos in#11572

Fixes

• Allow generic typed dictionaries to be used for unpacked variadic keyword parameters by@Viicos in#11571
• Fix runtime error when computing model string representation involving cached properties and self-referenced models by@Viicos in#11579
• Preserve other steps when using the ellipsis in the pipeline API by@Viicos in#11626
• Fix deferred discriminator application logic by@Viicos in#11591

New Contributors

• @cmenon12 made their first contribution in#11562
• @Jeukoh made their first contribution in#11611

v2.11.0b2 (2025-03-17)

GitHub release

What's Changed

Packaging

• Bumppydantic-core to v2.32.0 by@Viicos in#11567

New Features

• Add experimental support for free threading by@Viicos in#11516

Fixes

• FixNotRequired qualifier not taken into account in stringified annotation by@Viicos in#11559

New Contributors

• @joren485 made their first contribution in#11547

v2.11.0b1 (2025-03-06)

GitHub release

What's Changed

Packaging

• Add acheck_pydantic_core_version() function by@Viicos inhttps://github.com/pydantic/pydantic/pull/11324
• Removegreenlet development dependency by@Viicos inhttps://github.com/pydantic/pydantic/pull/11351
• Use thetyping-inspection library by@Viicos inhttps://github.com/pydantic/pydantic/pull/11479
• Bumppydantic-core tov2.31.1 by@sydney-runkle inhttps://github.com/pydantic/pydantic/pull/11526

New Features

• Support unsubstituted type variables with both a default and a bound or constraints by@FyZzyss inhttps://github.com/pydantic/pydantic/pull/10789
• Add adefault_factory_takes_validated_data property toFieldInfo by@Viicos inhttps://github.com/pydantic/pydantic/pull/11034
• Raise a better error when a generic alias is used insidetype[] by@Viicos inhttps://github.com/pydantic/pydantic/pull/11088
• Properly support PEP 695 generics syntax by@Viicos inhttps://github.com/pydantic/pydantic/pull/11189
• Properly support type variable defaults by@Viicos inhttps://github.com/pydantic/pydantic/pull/11332
• Add support for validating v6, v7, v8 UUIDs by@astei inhttps://github.com/pydantic/pydantic/pull/11436
• Improve alias configuration APIs by@sydney-runkle inhttps://github.com/pydantic/pydantic/pull/11468

Changes

• Reworkcreate_model field definitions format by@Viicos inhttps://github.com/pydantic/pydantic/pull/11032
• Raise a deprecation warning when a field is annotated as final with a default value by@Viicos inhttps://github.com/pydantic/pydantic/pull/11168
• Deprecate accessingmodel_fields andmodel_computed_fields on instances by@Viicos inhttps://github.com/pydantic/pydantic/pull/11169
• Breaking Change: Move core schema generation logic for path types inside theGenerateSchema class by@sydney-runkle inhttps://github.com/pydantic/pydantic/pull/10846
• Remove Python 3.8 Support by@sydney-runkle inhttps://github.com/pydantic/pydantic/pull/11258
• Optimize calls toget_type_ref by@Viicos inhttps://github.com/pydantic/pydantic/pull/10863
• Disablepydantic-core core schema validation by@sydney-runkle inhttps://github.com/pydantic/pydantic/pull/11271

Performance

• Only evaluateFieldInfo annotations if required during schema building by@Viicos inhttps://github.com/pydantic/pydantic/pull/10769
• Improve__setattr__ performance of Pydantic models by caching setter functions by@MarkusSintonen inhttps://github.com/pydantic/pydantic/pull/10868
• Improve annotation application performance by@Viicos inhttps://github.com/pydantic/pydantic/pull/11186
• Improve performance of_typing_extra module by@Viicos inhttps://github.com/pydantic/pydantic/pull/11255
• Refactor and optimize schema cleaning logic by@Viicos inhttps://github.com/pydantic/pydantic/pull/11244
• Create a single dictionary when creating aCoreConfig instance by@sydney-runkle inhttps://github.com/pydantic/pydantic/pull/11384
• Bumppydantic-core and thus useSchemaValidator andSchemaSerializer caching by@sydney-runkle inhttps://github.com/pydantic/pydantic/pull/11402
• Reuse cached core schemas for parametrized generic Pydantic models by@MarkusSintonen inhttps://github.com/pydantic/pydantic/pull/11434

Fixes

• ImproveTypeAdapter instance repr by@sydney-runkle inhttps://github.com/pydantic/pydantic/pull/10872
• Use the correct frame when instantiating a parametrizedTypeAdapter by@Viicos inhttps://github.com/pydantic/pydantic/pull/10893
• Infer final fields with a default value as class variables in the mypy plugin by@Viicos inhttps://github.com/pydantic/pydantic/pull/11121
• Recursively unpackLiteral values if using PEP 695 type aliases by@Viicos inhttps://github.com/pydantic/pydantic/pull/11114
• Override__subclasscheck__ onModelMetaclass to avoid memory leak and performance issues by@Viicos inhttps://github.com/pydantic/pydantic/pull/11116
• Remove unused_extract_get_pydantic_json_schema() parameter by@Viicos inhttps://github.com/pydantic/pydantic/pull/11155
• Improve discriminated union error message for invalid union variants by@Viicos inhttps://github.com/pydantic/pydantic/pull/11161
• Unpack PEP 695 type aliases if using theAnnotated form by@Viicos inhttps://github.com/pydantic/pydantic/pull/11109
• Add missing stacklevel indeprecated_instance_property warning by@Viicos inhttps://github.com/pydantic/pydantic/pull/11200
• CopyWithJsonSchema schema to avoid sharing mutated data by@thejcannon inhttps://github.com/pydantic/pydantic/pull/11014
• Do not cache parametrized models when in the process of parametrizing another model by@Viicos inhttps://github.com/pydantic/pydantic/pull/10704
• Add discriminated union related metadata entries to theCoreMetadata definition by@Viicos inhttps://github.com/pydantic/pydantic/pull/11216
• Consolidate schema definitions logic in the_Definitions class by@Viicos inhttps://github.com/pydantic/pydantic/pull/11208
• Support initializing root model fields with values of theroot type in the mypy plugin by@Viicos inhttps://github.com/pydantic/pydantic/pull/11212
• Fix various issues with dataclasses anduse_attribute_docstrings by@Viicos inhttps://github.com/pydantic/pydantic/pull/11246
• Only compute normalized decimal places if necessary indecimal_places_validator by@misrasaurabh1 inhttps://github.com/pydantic/pydantic/pull/11281
• Add support forvalidation_alias in the mypy plugin by@Viicos inhttps://github.com/pydantic/pydantic/pull/11295
• Fix JSON Schema reference collection with"examples" keys by@Viicos inhttps://github.com/pydantic/pydantic/pull/11305
• Do not transform model serializer functions as class methods in the mypy plugin by@Viicos inhttps://github.com/pydantic/pydantic/pull/11298
• SimplifyGenerateJsonSchema.literal_schema() implementation by@misrasaurabh1 inhttps://github.com/pydantic/pydantic/pull/11321
• Add additional allowed schemes forClickHouseDsn by@Maze21127 inhttps://github.com/pydantic/pydantic/pull/11319
• Coerce decimal constraints toDecimal instances by@Viicos inhttps://github.com/pydantic/pydantic/pull/11350
• Use the correct JSON Schema mode when handling function schemas by@Viicos inhttps://github.com/pydantic/pydantic/pull/11367
• Improve exception message when encountering recursion errors during type evaluation by@Viicos inhttps://github.com/pydantic/pydantic/pull/11356
• Always includeadditionalProperties: True for arbitrary dictionary schemas by@austinyu inhttps://github.com/pydantic/pydantic/pull/11392
• Exposefallback parameter in serialization methods by@Viicos inhttps://github.com/pydantic/pydantic/pull/11398
• Fix path serialization behavior by@sydney-runkle inhttps://github.com/pydantic/pydantic/pull/11416
• Do not reuse validators and serializers during model rebuild by@Viicos inhttps://github.com/pydantic/pydantic/pull/11429
• Collect model fields when rebuilding a model by@Viicos inhttps://github.com/pydantic/pydantic/pull/11388
• Allow cached properties to be altered on frozen models by@Viicos inhttps://github.com/pydantic/pydantic/pull/11432
• Fix tuple serialization forSequence types by@sydney-runkle inhttps://github.com/pydantic/pydantic/pull/11435
• Fix: do not check for__get_validators__ on classes where__get_pydantic_core_schema__ is also defined by@tlambert03 inhttps://github.com/pydantic/pydantic/pull/11444
• Allow callable instances to be used as serializers by@Viicos inhttps://github.com/pydantic/pydantic/pull/11451
• Improve error thrown when overriding field with a property by@sydney-runkle inhttps://github.com/pydantic/pydantic/pull/11459
• Fix JSON Schema generation with referenceable core schemas holding JSON metadata by@Viicos inhttps://github.com/pydantic/pydantic/pull/11475
• Support strict specification on union member types by@sydney-runkle inhttps://github.com/pydantic/pydantic/pull/11481
• Implicitly setvalidate_by_name toTrue whenvalidate_by_alias isFalse by@sydney-runkle inhttps://github.com/pydantic/pydantic/pull/11503
• Change type ofAny when synthesizingBaseSettings.__init__ signature in the mypy plugin by@Viicos inhttps://github.com/pydantic/pydantic/pull/11497
• Support type variable defaults referencing other type variables by@Viicos inhttps://github.com/pydantic/pydantic/pull/11520
• FixValueError on year zero by@davidhewitt inhttps://github.com/pydantic/pydantic-core/pull/1583
• dataclassInitVar shouldn't be required on serialization by@sydney-runkle inhttps://github.com/pydantic/pydantic-core/pull/1602

New Contributors

• @FyZzyss made their first contribution inhttps://github.com/pydantic/pydantic/pull/10789
• @tamird made their first contribution inhttps://github.com/pydantic/pydantic/pull/10948
• @felixxm made their first contribution inhttps://github.com/pydantic/pydantic/pull/11077
• @alexprabhat99 made their first contribution inhttps://github.com/pydantic/pydantic/pull/11082
• @Kharianne made their first contribution inhttps://github.com/pydantic/pydantic/pull/11111
• @mdaffad made their first contribution inhttps://github.com/pydantic/pydantic/pull/11177
• @thejcannon made their first contribution inhttps://github.com/pydantic/pydantic/pull/11014
• @thomasfrimannkoren made their first contribution inhttps://github.com/pydantic/pydantic/pull/11251
• @usernameMAI made their first contribution inhttps://github.com/pydantic/pydantic/pull/11275
• @ananiavito made their first contribution inhttps://github.com/pydantic/pydantic/pull/11302
• @pawamoy made their first contribution inhttps://github.com/pydantic/pydantic/pull/11311
• @Maze21127 made their first contribution inhttps://github.com/pydantic/pydantic/pull/11319
• @kauabh made their first contribution inhttps://github.com/pydantic/pydantic/pull/11369
• @jaceklaskowski made their first contribution inhttps://github.com/pydantic/pydantic/pull/11353
• @tmpbeing made their first contribution inhttps://github.com/pydantic/pydantic/pull/11375
• @petyosi made their first contribution inhttps://github.com/pydantic/pydantic/pull/11405
• @austinyu made their first contribution inhttps://github.com/pydantic/pydantic/pull/11392
• @mikeedjones made their first contribution inhttps://github.com/pydantic/pydantic/pull/11402
• @astei made their first contribution inhttps://github.com/pydantic/pydantic/pull/11436
• @dsayling made their first contribution inhttps://github.com/pydantic/pydantic/pull/11522
• @sobolevn made their first contribution inhttps://github.com/pydantic/pydantic-core/pull/1645

v2.11.0a2 (2025-02-10)

GitHub release

What's Changed

Pydantic v2.11 is a version strongly focused on build time performance of Pydantic models (and core schema generation in general).This is another early alpha release, meant to collect early feedback from users having issues with core schema builds.

Packaging

• Bumpruff from 0.9.2 to 0.9.5 by@Viicos in#11407
• Bumppydantic-core to v2.29.0 by@mikeedjones in#11402
• Use locally-built rust with symbols & pgo by@davidhewitt in#11403

Performance

• Create a single dictionary when creating aCoreConfig instance by@sydney-runkle in#11384

Fixes

• Use the correct JSON Schema mode when handling function schemas by@Viicos in#11367
• Fix JSON Schema reference logic withexamples keys by@Viicos in#11366
• Improve exception message when encountering recursion errors during type evaluation by@Viicos in#11356
• Always includeadditionalProperties: True for arbitrary dictionary schemas by@austinyu in#11392
• Exposefallback parameter in serialization methods by@Viicos in#11398
• Fix path serialization behavior by@sydney-runkle in#11416

New Contributors

• @kauabh made their first contribution in#11369
• @jaceklaskowski made their first contribution in#11353
• @tmpbeing made their first contribution in#11375
• @petyosi made their first contribution in#11405
• @austinyu made their first contribution in#11392
• @mikeedjones made their first contribution in#11402

v2.11.0a1 (2025-01-30)

GitHub release

What's Changed

Pydantic v2.11 is a version strongly focused on build time performance of Pydantic models (and core schema generation in general).This is an early alpha release, meant to collect early feedback from users having issues with core schema builds.

Packaging

• Bump dawidd6/action-download-artifact from 6 to 7 by@dependabot in#11018
• Re-enable memray related tests on Python 3.12+ by@Viicos in#11191
• Bump astral-sh/setup-uv to 5 by@dependabot in#11205
• Bumpruff to v0.9.0 by@sydney-runkle in#11254
• Regularuv.lock deps update by@sydney-runkle in#11333
• Add acheck_pydantic_core_version() function by@Viicos in#11324
• Removegreenlet development dependency by@Viicos in#11351
• Bumppydantic-core to v2.28.0 by@Viicos in#11364

New Features

• Support unsubstituted type variables with both a default and a bound or constraints by@FyZzyss in#10789
• Add adefault_factory_takes_validated_data property toFieldInfo by@Viicos in#11034
• Raise a better error when a generic alias is used insidetype[] by@Viicos in#11088
• Properly support PEP 695 generics syntax by@Viicos in#11189
• Properly support type variable defaults by@Viicos in#11332

Changes

• Reworkcreate_model field definitions format by@Viicos in#11032
• Raise a deprecation warning when a field is annotated as final with a default value by@Viicos in#11168
• Deprecate accessingmodel_fields andmodel_computed_fields on instances by@Viicos in#11169
• Move core schema generation logic for path types inside theGenerateSchema class by@sydney-runkle in#10846
• Movedeque schema gen toGenerateSchema class by@sydney-runkle in#11239
• MoveMapping schema gen toGenerateSchema to complete removal ofprepare_annotations_for_known_type workaround by@sydney-runkle in#11247
• Remove Python 3.8 Support by@sydney-runkle in#11258
• Disablepydantic-core core schema validation by@sydney-runkle in#11271

Performance

• Only evaluateFieldInfo annotations if required during schema building by@Viicos in#10769
• Optimize calls toget_type_ref by@Viicos in#10863
• Improve__setattr__ performance of Pydantic models by caching setter functions by@MarkusSintonen in#10868
• Improve annotation application performance by@Viicos in#11186
• Improve performance of_typing_extra module by@Viicos in#11255
• Refactor and optimize schema cleaning logic by@Viicos and@MarkusSintonen in#11244

Fixes

• Add validation tests for_internal/_validators.py by@tkasuz in#10763
• ImproveTypeAdapter instance repr by@sydney-runkle in#10872
• Revert "ci: use locally built pydantic-core with debug symbols by@sydney-runkle in#10942
• Re-enable all FastAPI tests by@tamird in#10948
• Fix typo in HISTORY.md. by@felixxm in#11077
• Infer final fields with a default value as class variables in the mypy plugin by@Viicos in#11121
• Recursively unpackLiteral values if using PEP 695 type aliases by@Viicos in#11114
• Override__subclasscheck__ onModelMetaclass to avoid memory leak and performance issues by@Viicos in#11116
• Remove unused_extract_get_pydantic_json_schema() parameter by@Viicos in#11155
• Add FastAPI and SQLModel to third-party tests by@sydney-runkle in#11044
• Fix conditional expressions syntax for third-party tests by@Viicos in#11162
• Move FastAPI tests to third-party workflow by@Viicos in#11164
• Improve discriminated union error message for invalid union variants by@Viicos in#11161
• Unpack PEP 695 type aliases if using theAnnotated form by@Viicos in#11109
• Includeopenapi-python-client check in issue creation for third-party failures, usemain branch by@sydney-runkle in#11182
• Add pandera third-party tests by@Viicos in#11193
• Add ODMantic third-party tests by@sydney-runkle in#11197
• Add missing stacklevel indeprecated_instance_property warning by@Viicos in#11200
• CopyWithJsonSchema schema to avoid sharing mutated data by@thejcannon in#11014
• Do not cache parametrized models when in the process of parametrizing another model by@Viicos in#10704
• Re-enable Beanie third-party tests by@Viicos in#11214
• Add discriminated union related metadata entries to theCoreMetadata definition by@Viicos in#11216
• Consolidate schema definitions logic in the_Definitions class by@Viicos in#11208
• Support initializing root model fields with values of theroot type in the mypy plugin by@Viicos in#11212
• Fix various issues with dataclasses anduse_attribute_docstrings by@Viicos in#11246
• Only compute normalized decimal places if necessary indecimal_places_validator by@misrasaurabh1 in#11281
• Fix two misplaced sentences in validation errors documentation by@ananiavito in#11302
• Fix mkdocstrings inventory example in documentation by@pawamoy in#11311
• Add support forvalidation_alias in the mypy plugin by@Viicos in#11295
• Do not transform model serializer functions as class methods in the mypy plugin by@Viicos in#11298
• SimplifyGenerateJsonSchema.literal_schema() implementation by@misrasaurabh1 in#11321
• Add additional allowed schemes forClickHouseDsn by@Maze21127 in#11319
• Coerce decimal constraints toDecimal instances by@Viicos in#11350
• FixValueError on year zero by@davidhewitt inpydantic-core#1583

New Contributors

• @FyZzyss made their first contribution in#10789
• @tamird made their first contribution in#10948
• @felixxm made their first contribution in#11077
• @alexprabhat99 made their first contribution in#11082
• @Kharianne made their first contribution in#11111
• @mdaffad made their first contribution in#11177
• @thejcannon made their first contribution in#11014
• @thomasfrimannkoren made their first contribution in#11251
• @usernameMAI made their first contribution in#11275
• @ananiavito made their first contribution in#11302
• @pawamoy made their first contribution in#11311
• @Maze21127 made their first contribution in#11319

v2.10.6 (2025-01-23)

GitHub release

What's Changed

Fixes

• Fix JSON Schema reference collection with'examples' keys by@Viicos in#11325
• Fix url python serialization by@sydney-runkle in#11331

v2.10.5 (2025-01-08)

GitHub release

What's Changed

Fixes

• Remove custom MRO implementation of Pydantic models by@Viicos in#11184
• Fix URL serialization for unions by@sydney-runkle in#11233

v2.10.4 (2024-12-18)

GitHub release

What's Changed

Packaging

• Bumppydantic-core to v2.27.2 by@davidhewitt in#11138

Fixes

• Fix for comparison ofAnyUrl objects by@alexprabhat99 in#11082
• Properly fetch PEP 695 type params for functions, do not fetch annotations from signature by@Viicos in#11093
• Include JSON Schema input core schema in function schemas by@Viicos in#11085
• Addlen to_BaseUrl to avoid TypeError by@Kharianne in#11111
• Make sure the type reference is removed from the seen references by@Viicos in#11143

New Contributors

• @FyZzyss made their first contribution in#10789
• @tamird made their first contribution in#10948
• @felixxm made their first contribution in#11077
• @alexprabhat99 made their first contribution in#11082
• @Kharianne made their first contribution in#11111

v2.10.3 (2024-12-03)

GitHub release

What's Changed

Fixes

• Set fields whendefer_build is set on Pydantic dataclasses by@Viicos in#10984
• Do not resolve the JSON Schema reference fordict core schema keys by@Viicos in#10989
• Use the globals of the function when evaluating the return type forPlainSerializer andWrapSerializer functions by@Viicos in#11008
• Fix host required enforcement for urls to be compatible with v2.9 behavior by@sydney-runkle in#11027
• Add adefault_factory_takes_validated_data property toFieldInfo by@Viicos in#11034
• Fix url json schema inserialization mode by@sydney-runkle in#11035

v2.10.2 (2024-11-25)

GitHub release

What's Changed

Fixes

• Only evaluate FieldInfo annotations if required during schema building by@Viicos in#10769
• Do not evaluate annotations for private fields by@Viicos in#10962
• Support serialization as any forSecret types andUrl types by@sydney-runkle in#10947
• Fix type hint ofField.default to be compatible with Python 3.8 and 3.9 by@Viicos in#10972
• Add hashing support for URL types by@sydney-runkle in#10975
• HideBaseModel.__replace__ definition from type checkers by@Viicos in#10979

v2.10.1 (2024-11-21)

GitHub release

What's Changed

Packaging

• Bumppydantic-core version tov2.27.1 by@sydney-runkle in#10938

Fixes

• Use the correct frame when instantiating a parametrizedTypeAdapter by@Viicos in#10893
• Relax check for validated data indefault_factory utils by@sydney-runkle in#10909
• Fix type checking issue withmodel_fields andmodel_computed_fields by@sydney-runkle in#10911
• Use the parent configuration during schema generation for stdlibdataclasses by@sydney-runkle in#10928
• Use theglobals of the function when evaluating the return type of serializers andcomputed_fields by@Viicos in#10929
• Fix URL constraint application by@sydney-runkle in#10922
• Fix URL equality with different validation methods by@sydney-runkle in#10934
• Fix JSON schema title when specified as'' by@sydney-runkle in#10936
• Fixpython mode serialization forcomplex inference by@sydney-runkle inpydantic-core#1549

New Contributors

v2.10.0 (2024-11-20)

The code released in v2.10.0 is practically identical to that of v2.10.0b2.

GitHub release

See thev2.10 release blog post for the highlights!

What's Changed

Packaging

• Bumppydantic-core tov2.27.0 by@sydney-runkle in#10825
• Replaced pdm with uv by@frfahim in#10727

New Features

• Supportfractions.Fraction by@sydney-runkle in#10318
• SupportHashable for json validation by@sydney-runkle in#10324
• Add aSocketPath type forlinux systems by@theunkn0wn1 in#10378
• Allow arbitrary refs in JSON schemaexamples by@sydney-runkle in#10417
• Supportdefer_build for Pydantic dataclasses by@Viicos in#10313
• Adding v1 / v2 incompatibility warning for nested v1 model by@sydney-runkle in#10431
• Add support for unpackedTypedDict to type hint variadic keyword arguments with@validate_call by@Viicos in#10416
• Support compiled patterns inprotected_namespaces by@sydney-runkle in#10522
• Add support forpropertyNames in JSON schema by@FlorianSW in#10478
• Adding__replace__ protocol for Python 3.13+ support by@sydney-runkle in#10596
• Expose publicsort method for JSON schema generation by@sydney-runkle in#10595
• Add runtime validation of@validate_call callable argument by@kc0506 in#10627
• Addexperimental_allow_partial support by@samuelcolvin in#10748
• Support default factories taking validated data as an argument by@Viicos in#10678
• Allow subclassingValidationError andPydanticCustomError by@Youssefares inpydantic/pydantic-core#1413
• Addtrailing-strings support toexperimental_allow_partial by@sydney-runkle in#10825
• Addrebuild() method forTypeAdapter and simplifydefer_build patterns by@sydney-runkle in#10537
• ImproveTypeAdapter instance repr by@sydney-runkle in#10872

Changes

• Don't allow customization ofSchemaGenerator until interface is more stable by@sydney-runkle in#10303
• Cleanlydefer_build onTypeAdapters, removing experimental flag by@sydney-runkle in#10329
• Fixmro of generic subclass by@kc0506 in#10100
• Strip whitespaces on JSON Schema title generation by@sydney-runkle in#10404
• Useb64decode andb64encode forBase64Bytes type by@sydney-runkle in#10486
• Relax protected namespace config default by@sydney-runkle in#10441
• Revalidate parametrized generics if instance's origin is subclass of OG class by@sydney-runkle in#10666
• Warn if configuration is specified on the@dataclass decorator and with the__pydantic_config__ attribute by@sydney-runkle in#10406
• Recommend against usingEllipsis (...) withField by@Viicos in#10661
• Migrate to subclassing instead of annotated approach for pydantic url types by@sydney-runkle in#10662
• Change JSON schema generation ofLiterals andEnums by@Viicos in#10692
• Simplify unions involvingAny orNever when replacing type variables by@Viicos in#10338
• Do not require padding when decodingbase64 bytes by@bschoenmaeckers inpydantic/pydantic-core#1448
• Support dates all the way to 1BC by@changhc inpydantic/speedate#77

Performance

• Schema cleaning: skip unnecessary copies during schema walking by@Viicos in#10286
• Refactor namespace logic for annotations evaluation by@Viicos in#10530
• Improve email regexp on edge cases by@AlekseyLobanov in#10601
• CoreMetadata refactor with an emphasis on documentation, schema build time performance, and reducing complexity by@sydney-runkle in#10675

Fixes

• Remove guarding check oncomputed_field withfield_serializer by@nix010 in#10390
• FixPredicate issue inv2.9.0 by@sydney-runkle in#10321
• Fixingannotated-types bound by@sydney-runkle in#10327
• Turntzdata install requirement into optionaltimezone dependency by@jakob-keller in#10331
• Use correct types namespace when buildingnamedtuple core schemas by@Viicos in#10337
• Fix evaluation of stringified annotations during namespace inspection by@Viicos in#10347
• FixIncEx type alias definition by@Viicos in#10339
• Do not error when trying to evaluate annotations of private attributes by@Viicos in#10358
• Fix nested type statement by@kc0506 in#10369
• Improve typing ofModelMetaclass.mro by@Viicos in#10372
• Fix class access of deprecatedcomputed_fields by@Viicos in#10391
• Make sureinspect.iscoroutinefunction works on coroutines decorated with@validate_call by@MovisLi in#10374
• FixNameError when usingvalidate_call with PEP 695 on a class by@kc0506 in#10380
• FixZoneInfo with various invalid types by@sydney-runkle in#10408
• FixPydanticUserError on emptymodel_config with annotations by@cdwilson in#10412
• Fix variance issue in_IncEx type alias, only allowTrue by@Viicos in#10414
• Fix serialization schema generation when usingPlainValidator by@Viicos in#10427
• Fix schema generation error when serialization schema holds references by@Viicos in#10444
• Inline references if possible when generating schema forjson_schema_input_type by@Viicos in#10439
• Fix recursive arguments inRepresentation by@Viicos in#10480
• Fix representation for builtin function types by@kschwab in#10479
• Add python validators for decimal constraints (max_digits anddecimal_places) by@sydney-runkle in#10506
• Only fetch__pydantic_core_schema__ from the current class during schema generation by@Viicos in#10518
• Fixstacklevel on deprecation warnings forBaseModel by@sydney-runkle in#10520
• Fix warningstacklevel inBaseModel.__init__ by@Viicos in#10526
• Improve error handling for in-evaluable refs for discriminator application by@sydney-runkle in#10440
• Change the signature ofConfigWrapper.core_config to take the title directly by@Viicos in#10562
• Do not use the previous config from the stack for dataclasses without config by@Viicos in#10576
• Fix serialization for IP types withmode='python' by@sydney-runkle in#10594
• Support constraint application forBase64Etc types by@sydney-runkle in#10584
• Fixvalidate_call ignoringField inAnnotated by@kc0506 in#10610
• Raise an error whenSelf is invalid by@kc0506 in#10609
• Usingcore_schema.InvalidSchema instead of metadata injection + checks by@sydney-runkle in#10523
• Tweak type alias logic by@kc0506 in#10643
• Support usage oftype withtyping.Self and type aliases by@kc0506 in#10621
• Use overloads forField andPrivateAttr functions by@Viicos in#10651
• Clean up themypy plugin implementation by@Viicos in#10669
• Properly check fortyping_extensions variant ofTypeAliasType by@Daraan in#10713
• Allow any mapping inBaseModel.model_copy() by@Viicos in#10751
• Fixisinstance behavior for urls by@sydney-runkle in#10766
• Ensurecached_property can be set on Pydantic models by@Viicos in#10774
• Fix equality checks for primitives in literals by@sydney-runkle inpydantic/pydantic-core#1459
• Properly enforcehost_required for URLs by@Viicos inpydantic/pydantic-core#1488
• Fix whencoerce_numbers_to_str enabled and string has invalid Unicode character by@andrey-berenda inpydantic/pydantic-core#1515
• Fix serializingcomplex values inEnums by@changhc inpydantic/pydantic-core#1524
• Refactor_typing_extra module by@Viicos in#10725
• Support intuitive equality for urls by@sydney-runkle in#10798
• Addbytearray toTypeAdapter.validate_json signature by@samuelcolvin in#10802
• Ensure class access of method descriptors is performed when used as a default withField by@Viicos in#10816
• Fix circular import withvalidate_call by@sydney-runkle in#10807
• Fix error when using type aliases referencing other type aliases by@Viicos in#10809
• FixIncEx type alias to be compatible with mypy by@Viicos in#10813
• Make__signature__ a lazy property, do not deepcopy defaults by@Viicos in#10818
• Make__signature__ lazy for dataclasses, too by@sydney-runkle in#10832
• Subclass all single host url classes fromAnyUrl to preserve behavior from v2.9 by@sydney-runkle in#10856

New Contributors

• @jakob-keller made their first contribution in#10331
• @MovisLi made their first contribution in#10374
• @joaopalmeiro made their first contribution in#10405
• @theunkn0wn1 made their first contribution in#10378
• @cdwilson made their first contribution in#10412
• @dlax made their first contribution in#10421
• @kschwab made their first contribution in#10479
• @santibreo made their first contribution in#10453
• @FlorianSW made their first contribution in#10478
• @tkasuz made their first contribution in#10555
• @AlekseyLobanov made their first contribution in#10601
• @NiclasvanEyk made their first contribution in#10667
• @mschoettle made their first contribution in#10677
• @Daraan made their first contribution in#10713
• @k4nar made their first contribution in#10736
• @UriyaHarpeness made their first contribution in#10740
• @frfahim made their first contribution in#10727

v2.10.0b2 (2024-11-13)

Pre-release, seethe GitHub release for details.

v2.10.0b1 (2024-11-06)

Pre-release, seethe GitHub release for details.

... seehere for earlier changes.

Verified details

Project links

• Homepage
• Source

Owner

• Pydantic

GitHub Statistics

Maintainers

dmontagu

Unverified details

Project links

• Changelog
• Documentation
• Funding

• Download URL:pydantic-2.11.7.tar.gz
• Upload date: Jun 14, 2025
• Size: 788.4 kB
• Tags: Source
• Uploaded using Trusted Publishing? Yes
• Uploaded via: twine/6.1.0 CPython/3.12.9

See more details on using hashes here.

• Download URL:pydantic-2.11.7-py3-none-any.whl
• Upload date: Jun 14, 2025
• Size: 444.8 kB
• Tags: Python 3
• Uploaded using Trusted Publishing? Yes
• Uploaded via: twine/6.1.0 CPython/3.12.9

See more details on using hashes here.