Data validation using Python type hints

These details have not been verified by PyPI

Project links

Project description

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.8+; validate it with Pydantic.

Pydantic Company :rocket:

We've started a company based on the principles that I believe have led to Pydantic's success. Learning more from the Company Announcement.

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 the pydantic 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

See documentation for more details.

Installation

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

A Simple Example

from datetime import datetime
from typing import List, Optional
from pydantic import BaseModel

class User(BaseModel):
    id: int
    name: str = 'John Doe'
    signup_ts: Optional[datetime] = None
    friends: 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 a contribution to Pydantic, see Contributing to Pydantic.

Reporting a Security Vulnerability

See our security policy.

Changelog

v2.6.2 (2024-02-23)

GitHub release

What's Changed

Packaging

Upgrade to pydantic-core 2.16.3 by @sydney-runkle in #8879

Fixes

'YYYY-MM-DD' date string coerced to datetime shouldn't infer timezone by @sydney-runkle in pydantic/pydantic-core#1193

v2.6.1 (2024-02-05)

GitHub release

What's Changed

Packaging

Upgrade to pydantic-core 2.16.2 by @sydney-runkle in #8717

Fixes

Fix bug with mypy plugin and no_strict_optional = True by @dmontagu in #8666
Fix ByteSize error type change by @sydney-runkle in #8681
Fix inheriting Field annotations in dataclasses by @sydney-runkle in #8679
Fix regression in core schema generation for indirect definition references by @dmontagu in #8702
Fix unsupported types bug with PlainValidator by @sydney-runkle in #8710
Reverting problematic fix from 2.6 release, fixing schema building bug by @sydney-runkle in #8718
Fix warning for tuple of wrong size in Union by @davidhewitt in pydantic/pydantic-core#1174
Fix computed_field JSON serializer exclude_none behavior by @sydney-runkle in pydantic/pydantic-core#1187

v2.6.0 (2024-01-29)

GitHub release

The code released in v2.6.0 is practically identical to that of v2.6.0b1.

What's Changed

Packaging

Check for email-validator version >= 2.0 by @commonism in #6033
Upgrade `ruff`` target version to Python 3.8 by @Elkiwa in #8341
Update to pydantic-extra-types==2.4.1 by @yezz123 in #8478
Update to pyright==1.1.345 by @Viicos in #8453
Update pydantic-core from 2.14.6 to 2.16.1, significant changes from these updates are described below, full changelog here

New Features

Add NatsDsn by @ekeew in #6874
Add ConfigDict.ser_json_inf_nan by @davidhewitt in #8159
Add types.OnErrorOmit by @adriangb in #8222
Support AliasGenerator usage by @sydney-runkle in #8282
Add Pydantic People Page to docs by @sydney-runkle in #8345
Support yyyy-MM-DD datetime parsing by @sydney-runkle in #8404
Added bits conversions to the ByteSize class #8415 by @luca-matei in #8507
Enable json schema creation with type ByteSize by @geospackle in #8537
Add eval_type_backport to handle union operator and builtin generic subscripting in older Pythons by @alexmojaki in #8209
Add support for dataclass fields init by @dmontagu in #8552
Implement pickling for ValidationError by @davidhewitt in pydantic/pydantic-core#1119
Add unified tuple validator that can handle "variadic" tuples via PEP-646 by @dmontagu in pydantic/pydantic-core#865

Changes

Drop Python3.7 support by @hramezani in #7188
Drop Python 3.7, and PyPy 3.7 and 3.8 by @davidhewitt in pydantic/pydantic-core#1129
Use positional-only self in BaseModel constructor, so no field name can ever conflict with it by @ariebovenberg in #8072
Make @validate_call return a function instead of a custom descriptor - fixes binding issue with inheritance and adds self/cls argument to validation errors by @alexmojaki in #8268
Exclude BaseModel docstring from JSON schema description by @sydney-runkle in #8352
Introducing classproperty decorator for model_computed_fields by @Jocelyn-Gas in #8437
Explicitly raise an error if field names clashes with types by @Viicos in #8243
Use stricter serializer for unions of simple types by @alexdrydew pydantic/pydantic-core#1132

Performance

Add Codspeed profiling Actions workflow by @lambertsbennett in #8054
Improve int extraction by @samuelcolvin in pydantic/pydantic-core#1155
Improve performance of recursion guard by @samuelcolvin in pydantic/pydantic-core#1156
dataclass serialization speedups by @samuelcolvin in pydantic/pydantic-core#1162
Avoid HashMap creation when looking up small JSON objects in LazyIndexMaps by @samuelcolvin in pydantic/jiter#55
use hashbrown to speedup python string caching by @davidhewitt in pydantic/jiter#51
Replace Peak with more efficient Peek by @davidhewitt in pydantic/jiter#48

Fixes

Move getattr warning in deprecated BaseConfig by @tlambert03 in #7183
Only hash model_fields, not whole __dict__ by @alexmojaki in #7786
Fix mishandling of unions while freezing types in the mypy plugin by @dmontagu in #7411
Fix mypy error on untyped ClassVar by @vincent-hachin-wmx in #8138
Only compare pydantic fields in BaseModel.__eq__ instead of whole __dict__ by @QuentinSoubeyranAqemia in #7825
Update strict docstring in model_validate method. by @LukeTonin in #8223
Fix overload position of computed_field by @Viicos in #8227
Fix custom type type casting used in multiple attributes by @ianhfc in #8066
Fix issue not allowing validate_call decorator to be dynamically assigned to a class method by @jusexton in #8249
Fix issue unittest.mock deprecation warnings by @ibleedicare in #8262
Added tests for the case JsonValue contains subclassed primitive values by @jusexton in #8286
Fix mypy error on free before validator (classmethod) by @sydney-runkle in #8285
Fix to_snake conversion by @jevins09 in #8316
Fix type annotation of ModelMetaclass.__prepare__ by @slanzmich in #8305
Disallow config specification when initializing a TypeAdapter when the annotated type has config already by @sydney-runkle in #8365
Fix a naming issue with JSON schema for generics parametrized by recursive type aliases by @dmontagu in #8389
Fix type annotation in pydantic people script by @shenxiangzhuang in #8402
Add support for field alias in dataclass signature by @NeevCohen in #8387
Fix bug with schema generation with Field(...) in a forward ref by @dmontagu in #8494
Fix ordering of keys in __dict__ with model_construct call by @sydney-runkle in #8500
Fix module path_type creation when globals does not contain __name__ by @hramezani in #8470
Fix for namespace issue with dataclasses with from __future__ import annotations by @sydney-runkle in #8513
Fix: make function validator types positional-only by @pmmmwh in #8479
Fix usage of @deprecated by @Viicos in #8294
Add more support for private attributes in model_construct call by @sydney-runkle in #8525
Use a stack for the types namespace by @dmontagu in #8378
Fix schema-building bug with TypeAliasType for types with refs by @dmontagu in #8526
Support pydantic.Field(repr=False) in dataclasses by @tigeryy2 in #8511
Override dataclass_transform behavior for RootModel by @Viicos in #8163
Refactor signature generation for simplicity by @sydney-runkle in #8572
Fix ordering bug of PlainValidator annotation by @Anvil in #8567
Fix exclude_none for json serialization of computed_fields by @sydney-runkle in pydantic/pydantic-core#1098
Support yyyy-MM-DD string for datetimes by @sydney-runkle in pydantic/pydantic-core#1124
Tweak ordering of definitions in generated schemas by @StrawHatDrag0n in #8583

New Contributors

`pydantic`

@ekeew made their first contribution in #6874
@lambertsbennett made their first contribution in #8054
@vincent-hachin-wmx made their first contribution in #8138
@QuentinSoubeyranAqemia made their first contribution in #7825
@ariebovenberg made their first contribution in #8072
@LukeTonin made their first contribution in #8223
@denisart made their first contribution in #8231
@ianhfc made their first contribution in #8066
@eonu made their first contribution in #8255
@amandahla made their first contribution in #8263
@ibleedicare made their first contribution in #8262
@jevins09 made their first contribution in #8316
@cuu508 made their first contribution in #8322
@slanzmich made their first contribution in #8305
@jensenbox made their first contribution in #8331
@szepeviktor made their first contribution in #8356
@Elkiwa made their first contribution in #8341
@parhamfh made their first contribution in #8395
@shenxiangzhuang made their first contribution in #8402
@NeevCohen made their first contribution in #8387
@zby made their first contribution in #8497
@patelnets made their first contribution in #8491
@edwardwli made their first contribution in #8503
@luca-matei made their first contribution in #8507
@Jocelyn-Gas made their first contribution in #8437
@bL34cHig0 made their first contribution in #8501
@tigeryy2 made their first contribution in #8511
@geospackle made their first contribution in #8537
@Anvil made their first contribution in #8567
@hungtsetse made their first contribution in #8546
@StrawHatDrag0n made their first contribution in #8583

`pydantic-core`

@mariuswinger made their first contribution in pydantic/pydantic-core#1087
@adamchainz made their first contribution in pydantic/pydantic-core#1090
@akx made their first contribution in pydantic/pydantic-core#1123

v2.6.0b1 (2024-01-19)

Pre-release, see the GitHub release for details.

v2.5.3 (2023-12-22)

GitHub release

What's Changed

Packaging

uprev pydantic-core to 2.14.6

Fixes

Fix memory leak with recursive definitions creating reference cycles by @davidhewitt in pydantic/pydantic-core#1125

v2.5.2 (2023-11-22)

GitHub release

What's Changed

Packaging

uprev pydantic-core to 2.14.5

New Features

Add ConfigDict.ser_json_inf_nan by @davidhewitt in #8159

Fixes

Fix validation of Literal from JSON keys when used as dict key by @sydney-runkle in pydantic/pydantic-core#1075
Fix bug re custom_init on members of Union by @sydney-runkle in pydantic/pydantic-core#1076
Fix JsonValue bool serialization by @sydney-runkle in #8190
Fix handling of unhashable inputs with Literal in Unions by @sydney-runkle in pydantic/pydantic-core#1089

v2.5.1 (2023-11-15)

GitHub release

What's Changed

Packaging

uprev pydantic-core to 2.14.3 by @samuelcolvin in #8120

Fixes

Fix package description limit by @dmontagu in #8097
Fix ValidateCallWrapper error when creating a model which has a @validate_call wrapped field annotation by @sydney-runkle in #8110

v2.5.0 (2023-11-13)

GitHub release

The code released in v2.5.0 is functionally identical to that of v2.5.0b1.

What's Changed

Packaging

Update pydantic-core from 2.10.1 to 2.14.1, significant changes from these updates are described below, full changelog here
Update to pyright==1.1.335 by @Viicos in #8075

New Features

Allow plugins to catch non ValidationError errors by @adriangb in #7806
Support __doc__ argument in create_model() by @chris-spann in #7863
Expose regex_engine flag - meaning you can use with the Rust or Python regex libraries in constraints by @utkini in #7768
Save return type generated from type annotation in ComputedFieldInfo by @alexmojaki in #7889
Adopting ruff formatter by @Luca-Blight in #7930
Added validation_error_cause to config by @zakstucke in #7626
Make path of the item to validate available in plugin by @hramezani in #7861
Add CallableDiscriminator and Tag by @dmontagu in #7983
- CallableDiscriminator renamed to Discriminator by @dmontagu in #8047
Make union case tags affect union error messages by @dmontagu in #8001
Add examples and json_schema_extra to @computed_field by @alexmojaki in #8013
Add JsonValue type by @dmontagu in #7998
Allow str as argument to Discriminator by @dmontagu in #8047
Add SchemaSerializer.__reduce__ method to enable pickle serialization by @edoakes in pydantic/pydantic-core#1006

Changes

Significant Change: replace ultra_strict with new smart union implementation, the way unions are validated has changed significantly to improve performance and correctness, we have worked hard to absolutely minimise the number of cases where behaviour has changed, see the PR for details - by @davidhewitt in pydantic/pydantic-core#867
Add support for instance method reassignment when extra='allow' by @sydney-runkle in #7683
Support JSON schema generation for Enum types with no cases by @sydney-runkle in #7927
Warn if a class inherits from Generic before BaseModel by @alexmojaki in #7891

Performance

New custom JSON parser, jiter by @samuelcolvin in pydantic/pydantic-core#974
PGO build for MacOS M1 by @samuelcolvin in pydantic/pydantic-core#1063
Use __getattr__ for all package imports, improve import time by @samuelcolvin in #7947

Fixes

Fix mypy issue with subclasses of RootModel by @sydney-runkle in #7677
Properly rebuild the FieldInfo when a forward ref gets evaluated by @dmontagu in #7698
Fix failure to load SecretStr from JSON (regression in v2.4) by @sydney-runkle in #7729
Fix defer_build behavior with TypeAdapter by @sydney-runkle in #7736
Improve compatibility with legacy mypy versions by @dmontagu in #7742
Fix: update TypeVar handling when default is not set by @pmmmwh in #7719
Support specification of strict on Enum type fields by @sydney-runkle in #7761
Wrap weakref.ref instead of subclassing to fix cloudpickle serialization by @edoakes in #7780
Keep values of private attributes set within model_post_init in subclasses by @alexmojaki in #7775
Add more specific type for non-callable json_schema_extra by @alexmojaki in #7803
Raise an error when deleting frozen (model) fields by @alexmojaki in #7800
Fix schema sorting bug with default values by @sydney-runkle in #7817
Use generated alias for aliases that are not specified otherwise by @alexmojaki in #7802
Support strict specification for UUID types by @sydney-runkle in #7865
JSON schema: fix extra parameter handling by @me-and in #7810
Fix: support pydantic.Field(kw_only=True) with inherited dataclasses by @PrettyWood in #7827
Support validate_call decorator for methods in classes with __slots__ by @sydney-runkle in #7883
Fix pydantic dataclass problem with dataclasses.field default by @hramezani in #7898
Fix schema generation for generics with union type bounds by @sydney-runkle in #7899
Fix version for importlib_metadata on python 3.7 by @sydney-runkle in #7904
Support | operator (Union) in PydanticRecursiveRef by @alexmojaki in #7892
Fix display_as_type for TypeAliasType in python 3.12 by @dmontagu in #7929
Add support for NotRequired generics in TypedDict by @sydney-runkle in #7932
Make generic TypeAliasType specifications produce different schema definitions by @alexdrydew in #7893
Added fix for signature of inherited dataclass by @howsunjow in #7925
Make the model name generation more robust in JSON schema by @joakimnordling in #7881
Fix plurals in validation error messages (in tests) by @Iipin in #7972
PrivateAttr is passed from Annotated default position by @tabassco in #8004
Don't decode bytes (which may not be UTF8) when displaying SecretBytes by @alexmojaki in #8012
Use classmethod instead of classmethod[Any, Any, Any] by @Mr-Pepe in #7979
Clearer error on invalid Plugin by @samuelcolvin in #8023
Correct pydantic dataclasses import by @samuelcolvin in #8027
Fix misbehavior for models referencing redefined type aliases by @dmontagu in #8050
Fix Optional field with validate_default only performing one field validation by @sydney-runkle in pydantic/pydantic-core#1002
Fix definition-ref bug with Dict keys by @sydney-runkle in pydantic/pydantic-core#1014
Fix bug allowing validation of bool types with coerce_numbers_to_str=True by @sydney-runkle in pydantic/pydantic-core#1017
Don't accept NaN in float and decimal constraints by @davidhewitt in pydantic/pydantic-core#1037
Add lax_str and lax_int support for enum values not inherited from str/int by @michaelhly in pydantic/pydantic-core#1015
Support subclasses in lists in Union of List types by @sydney-runkle in pydantic/pydantic-core#1039
Allow validation against max_digits and decimals to pass if normalized or non-normalized input is valid by @sydney-runkle in pydantic/pydantic-core#1049
Fix: proper pluralization in ValidationError messages by @Iipin in pydantic/pydantic-core#1050
Disallow the string '-' as datetime input by @davidhewitt in pydantic/speedate#52 & pydantic/pydantic-core#1060
Fix: NaN and Inf float serialization by @davidhewitt in pydantic/pydantic-core#1062
Restore manylinux-compatible PGO builds by @davidhewitt in pydantic/pydantic-core#1068

New Contributors

`pydantic`

@schneebuzz made their first contribution in #7699
@edoakes made their first contribution in #7780
@alexmojaki made their first contribution in #7775
@NickG123 made their first contribution in #7751
@gowthamgts made their first contribution in #7830
@jamesbraza made their first contribution in #7848
@laundmo made their first contribution in #7850
@rahmatnazali made their first contribution in #7870
@waterfountain1996 made their first contribution in #7878
@chris-spann made their first contribution in #7863
@me-and made their first contribution in #7810
@utkini made their first contribution in #7768
@bn-l made their first contribution in #7744
@alexdrydew made their first contribution in #7893
@Luca-Blight made their first contribution in #7930
@howsunjow made their first contribution in #7925
@joakimnordling made their first contribution in #7881
@icfly2 made their first contribution in #7976
@Yummy-Yums made their first contribution in #8003
@Iipin made their first contribution in #7972
@tabassco made their first contribution in #8004
@Mr-Pepe made their first contribution in #7979
@0x00cl made their first contribution in #8010
@barraponto made their first contribution in #8032

`pydantic-core`

@sisp made their first contribution in pydantic/pydantic-core#995
@michaelhly made their first contribution in pydantic/pydantic-core#1015

v2.5.0b1 (2023-11-09)

Pre-release, see the GitHub release for details.

v2.4.2 (2023-09-27)

GitHub release

What's Changed

Fixes

Fix bug with JSON schema for sequence of discriminated union by @dmontagu in #7647
Fix schema references in discriminated unions by @adriangb in #7646
Fix json schema generation for recursive models by @adriangb in #7653
Fix models_json_schema for generic models by @adriangb in #7654
Fix xfailed test for generic model signatures by @adriangb in #7658

New Contributors

@austinorr made their first contribution in #7657
@peterHoburg made their first contribution in #7670

v2.4.1 (2023-09-26)

GitHub release

What's Changed

Packaging

Update pydantic-core to 2.10.1 by @davidhewitt in #7633

Fixes

Serialize unsubstituted type vars as Any by @adriangb in #7606
Remove schema building caches by @adriangb in #7624
Fix an issue where JSON schema extras weren't JSON encoded by @dmontagu in #7625

v2.4.0 (2023-09-22)

GitHub release

What's Changed

Packaging

Update pydantic-core to 2.10.0 by @samuelcolvin in #7542

New Features

Add Base64Url types by @dmontagu in #7286
Implement optional number to str coercion by @lig in #7508
Allow access to field_name and data in all validators if there is data and a field name by @samuelcolvin in #7542
Add BaseModel.model_validate_strings and TypeAdapter.validate_strings by @hramezani in #7552
Add Pydantic plugins experimental implementation by @lig @samuelcolvin and @Kludex in #6820

Changes

Do not override model_post_init in subclass with private attrs by @Viicos in #7302
Make fields with defaults not required in the serialization schema by default by @dmontagu in #7275
Mark Extra as deprecated by @disrupted in #7299
Make EncodedStr a dataclass by @Kludex in #7396
Move annotated_handlers to be public by @samuelcolvin in #7569

Performance

Simplify flattening and inlining of CoreSchema by @adriangb in #7523
Remove unused copies in CoreSchema walking by @adriangb in #7528
Add caches for collecting definitions and invalid schemas from a CoreSchema by @adriangb in #7527
Eagerly resolve discriminated unions and cache cases where we can't by @adriangb in #7529
Replace dict.get and dict.setdefault with more verbose versions in CoreSchema building hot paths by @adriangb in #7536
Cache invalid CoreSchema discovery by @adriangb in #7535
Allow disabling CoreSchema validation for faster startup times by @adriangb in #7565

Fixes

Fix config detection for TypedDict from grandparent classes by @dmontagu in #7272
Fix hash function generation for frozen models with unusual MRO by @dmontagu in #7274
Make strict config overridable in field for Path by @hramezani in #7281
Use ser_json_<timedelta|bytes> on default in GenerateJsonSchema by @Kludex in #7269
Adding a check that alias is validated as an identifier for Python by @andree0 in #7319
Raise an error when computed field overrides field by @sydney-runkle in #7346
Fix applying SkipValidation to referenced schemas by @adriangb in #7381
Enforce behavior of private attributes having double leading underscore by @lig in #7265
Standardize __get_pydantic_core_schema__ signature by @hramezani in #7415
Fix generic dataclass fields mutation bug (when using TypeAdapter) by @sydney-runkle in #7435
Fix TypeError on model_validator in wrap mode by @pmmmwh in #7496
Improve enum error message by @hramezani in #7506
Make repr work for instances that failed initialization when handling ValidationErrors by @dmontagu in #7439
Fixed a regular expression denial of service issue by limiting whitespaces by @prodigysml in #7360
Fix handling of UUID values having UUID.version=None by @lig in #7566
Fix __iter__ returning private cached_property info by @sydney-runkle in #7570
Improvements to version info message by @samuelcolvin in #7594

New Contributors

@15498th made their first contribution in #7238
@GabrielCappelli made their first contribution in #7213
@tobni made their first contribution in #7184
@redruin1 made their first contribution in #7282
@FacerAin made their first contribution in #7288
@acdha made their first contribution in #7297
@andree0 made their first contribution in #7319
@gordonhart made their first contribution in #7375
@pmmmwh made their first contribution in #7496
@disrupted made their first contribution in #7299
@prodigysml made their first contribution in #7360

v2.3.0 (2023-08-23)

GitHub release

🔥 Remove orphaned changes file from repo by @lig in #7168
Add copy button on documentation by @Kludex in #7190
Fix docs on JSON type by @Kludex in #7189
Update mypy 1.5.0 to 1.5.1 in CI by @hramezani in #7191
fix download links badge by @samuelcolvin in #7200
add 2.2.1 to changelog by @samuelcolvin in #7212
Make ModelWrapValidator protocols generic by @dmontagu in #7154
Correct Field(..., exclude: bool) docs by @samuelcolvin in #7214
Make shadowing attributes a warning instead of an error by @adriangb in #7193
Document Base64Str and Base64Bytes by @Kludex in #7192
Fix config.defer_build for serialization first cases by @samuelcolvin in #7024
clean Model docstrings in JSON Schema by @samuelcolvin in #7210
fix #7228 (typo): docs in validators.md to correct validate_default kwarg by @lmmx in #7229
✅ Implement tzinfo.fromutc method for TzInfo in pydantic-core by @lig in #7019
Support __get_validators__ by @hramezani in #7197

v2.2.1 (2023-08-18)

GitHub release

Make xfailing test for root model extra stop xfailing by @dmontagu in #6937
Optimize recursion detection by stopping on the second visit for the same object by @mciucu in #7160
fix link in docs by @tlambert03 in #7166
Replace MiMalloc w/ default allocator by @adriangb in pydantic/pydantic-core#900
Bump pydantic-core to 2.6.1 and prepare 2.2.1 release by @adriangb in #7176

v2.2.0 (2023-08-17)

GitHub release

Split "pipx install" setup command into two commands on the documentation site by @nomadmtb in #6869
Deprecate Field.include by @hramezani in #6852
Fix typo in default factory error msg by @hramezani in #6880
Simplify handling of typing.Annotated in GenerateSchema by @dmontagu in #6887
Re-enable fastapi tests in CI by @dmontagu in #6883
Make it harder to hit collisions with json schema defrefs by @dmontagu in #6566
Cleaner error for invalid input to Path fields by @samuelcolvin in #6903
:memo: support Coordinate Type by @yezz123 in #6906
Fix ForwardRef wrapper for py 3.10.0 (shim until bpo-45166) by @randomir in #6919
Fix misbehavior related to copying of RootModel by @dmontagu in #6918
Fix issue with recursion error caused by ParamSpec by @dmontagu in #6923
Add section about Constrained classes to the Migration Guide by @Kludex in #6924
Use main branch for badge links by @Viicos in #6925
Add test for v1/v2 Annotated discrepancy by @carlbordum in #6926
Make the v1 mypy plugin work with both v1 and v2 by @dmontagu in #6921
Fix issue where generic models couldn't be parametrized with BaseModel by @dmontagu in #6933
Remove xfail for discriminated union with alias by @dmontagu in #6938
add field_serializer to computed_field by @andresliszt in #6965
Use union_schema with Type[Union[...]] by @JeanArhancet in #6952
Fix inherited typeddict attributes / config by @adriangb in #6981
fix dataclass annotated before validator called twice by @davidhewitt in #6998
Update test-fastapi deselected tests by @hramezani in #7014
Fix validator doc format by @hramezani in #7015
Fix typo in docstring of model_json_schema by @AdamVinch-Federated in #7032
remove unused "type ignores" with pyright by @samuelcolvin in #7026
Add benchmark representing FastAPI startup time by @adriangb in #7030
Fix json_encoders for Enum subclasses by @adriangb in #7029
Update docstring of ser_json_bytes regarding base64 encoding by @Viicos in #7052
Allow @validate_call to work on async methods by @adriangb in #7046
Fix: mypy error with Settings and SettingsConfigDict by @JeanArhancet in #7002
Fix some typos (repeated words and it's/its) by @eumiro in #7063
Fix the typo in docstring by @harunyasar in #7062
Docs: Fix broken URL in the pydantic-settings package recommendation by @swetjen in #6995
Handle constraints being applied to schemas that don't accept it by @adriangb in #6951
Replace almost_equal_floats with math.isclose by @eumiro in #7082
bump pydantic-core to 2.5.0 by @davidhewitt in #7077
Add short_version and use it in links by @hramezani in #7115
📝 Add usage link to RootModel by @Kludex in #7113
Revert "Fix default port for mongosrv DSNs (#6827)" by @Kludex in #7116
Clarify validate_default and _Unset handling in usage docs and migration guide by @benbenbang in #6950
Tweak documentation of Field.exclude by @Viicos in #7086
Do not require validate_assignment to use Field.frozen by @Viicos in #7103
tweaks to _core_utils by @samuelcolvin in #7040
Make DefaultDict working with set by @hramezani in #7126
Don't always require typing.Generic as a base for partially parametrized models by @dmontagu in #7119
Fix issue with JSON schema incorrectly using parent class core schema by @dmontagu in #7020
Fix xfailed test related to TypedDict and alias_generator by @dmontagu in #6940
Improve error message for NameEmail by @dmontagu in #6939
Fix generic computed fields by @dmontagu in #6988
Reflect namedtuple default values during validation by @dmontagu in #7144
Update dependencies, fix pydantic-core usage, fix CI issues by @dmontagu in #7150
Add mypy 1.5.0 by @hramezani in #7118
Handle non-json native enum values by @adriangb in #7056
document round_trip in Json type documentation by @jc-louis in #7137
Relax signature checks to better support builtins and C extension functions as validators by @adriangb in #7101
add union_mode='left_to_right' by @davidhewitt in #7151
Include an error message hint for inherited ordering by @yvalencia91 in #7124
Fix one docs link and resolve some warnings for two others by @dmontagu in #7153
Include Field extra keys name in warning by @hramezani in #7136

v2.1.1 (2023-07-25)

GitHub release

Skip FieldInfo merging when unnecessary by @dmontagu in #6862

v2.1.0 (2023-07-25)

GitHub release

Add StringConstraints for use as Annotated metadata by @adriangb in #6605
Try to fix intermittently failing CI by @adriangb in #6683
Remove redundant example of optional vs default. by @ehiggs-deliverect in #6676
Docs update by @samuelcolvin in #6692
Remove the Validate always section in validator docs by @adriangb in #6679
Fix recursion error in json schema generation by @adriangb in #6720
Fix incorrect subclass check for secretstr by @AlexVndnblcke in #6730
update pdm / pdm lockfile to 2.8.0 by @davidhewitt in #6714
unpin pdm on more CI jobs by @davidhewitt in #6755
improve source locations for auxiliary packages in docs by @davidhewitt in #6749
Assume builtins don't accept an info argument by @adriangb in #6754
Fix bug where calling help(BaseModelSubclass) raises errors by @hramezani in #6758
Fix mypy plugin handling of @model_validator(mode="after") by @ljodal in #6753
update pydantic-core to 2.3.1 by @davidhewitt in #6756
Mypy plugin for settings by @hramezani in #6760
Use contentSchema keyword for JSON schema by @dmontagu in #6715
fast-path checking finite decimals by @davidhewitt in #6769
Docs update by @samuelcolvin in #6771
Improve json schema doc by @hramezani in #6772
Update validator docs by @adriangb in #6695
Fix typehint for wrap validator by @dmontagu in #6788
🐛 Fix validation warning for unions of Literal and other type by @lig in #6628
Update documentation for generics support in V2 by @tpdorsey in #6685
add pydantic-core build info to version_info() by @samuelcolvin in #6785
Fix pydantic dataclasses that use slots with default values by @dmontagu in #6796
Fix inheritance of hash function for frozen models by @dmontagu in #6789
✨ Add SkipJsonSchema annotation by @Kludex in #6653
Error if an invalid field name is used with Field by @dmontagu in #6797
Add GenericModel to MOVED_IN_V2 by @adriangb in #6776
Remove unused code from docs/usage/types/custom.md by @hramezani in #6803
Fix float -> Decimal coercion precision loss by @adriangb in #6810
remove email validation from the north star benchmark by @davidhewitt in #6816
Fix link to mypy by @progsmile in #6824
Improve initialization hooks example by @hramezani in #6822
Fix default port for mongosrv DSNs by @dmontagu in #6827
Improve API documentation, in particular more links between usage and API docs by @samuelcolvin in #6780
update pydantic-core to 2.4.0 by @davidhewitt in #6831
Fix annotated_types.MaxLen validator for custom sequence types by @ImogenBits in #6809
Update V1 by @hramezani in #6833
Make it so callable JSON schema extra works by @dmontagu in #6798
Fix serialization issue with InstanceOf by @dmontagu in #6829
Add back support for json_encoders by @adriangb in #6811
Update field annotations when building the schema by @dmontagu in #6838
Use WeakValueDictionary to fix generic memory leak by @dmontagu in #6681
Add config.defer_build to optionally make model building lazy by @samuelcolvin in #6823
delegate UUID serialization to pydantic-core by @davidhewitt in #6850
Update json_encoders docs by @adriangb in #6848
Fix error message for staticmethod/classmethod order with validate_call by @dmontagu in #6686
Improve documentation for Config by @samuelcolvin in #6847
Update serialization doc to mention Field.exclude takes priority over call-time include/exclude by @hramezani in #6851
Allow customizing core schema generation by making GenerateSchema public by @adriangb in #6737

v2.0.3 (2023-07-05)

GitHub release

Mention PyObject (v1) moving to ImportString (v2) in migration doc by @slafs in #6456
Fix release-tweet CI by @Kludex in #6461
Revise the section on required / optional / nullable fields. by @ybressler in #6468
Warn if a type hint is not in fact a type by @adriangb in #6479
Replace TransformSchema with GetPydanticSchema by @dmontagu in #6484
Fix the un-hashability of various annotation types, for use in caching generic containers by @dmontagu in #6480
PYD-164: Rework custom types docs by @adriangb in #6490
Fix ci by @adriangb in #6507
Fix forward ref in generic by @adriangb in #6511
Fix generation of serialization JSON schemas for core_schema.ChainSchema by @dmontagu in #6515
Document the change in Field.alias behavior in Pydantic V2 by @hramezani in #6508
Give better error message attempting to compute the json schema of a model with undefined fields by @dmontagu in #6519
Document alias_priority by @tpdorsey in #6520
Add redirect for types documentation by @tpdorsey in #6513
Allow updating docs without release by @samuelcolvin in #6551
Ensure docs tests always run in the right folder by @dmontagu in #6487
Defer evaluation of return type hints for serializer functions by @dmontagu in #6516
Disable E501 from Ruff and rely on just Black by @adriangb in #6552
Update JSON Schema documentation for V2 by @tpdorsey in #6492
Add documentation of cyclic reference handling by @dmontagu in #6493
Remove the need for change files by @samuelcolvin in #6556
add "north star" benchmark by @davidhewitt in #6547
Update Dataclasses docs by @tpdorsey in #6470
♻️ Use different error message on v1 redirects by @Kludex in #6595
⬆ Upgrade pydantic-core to v2.2.0 by @lig in #6589
Fix serialization for IPvAny by @dmontagu in #6572
Improve CI by using PDM instead of pip to install typing-extensions by @adriangb in #6602
Add enum error type docs by @lig in #6603
🐛 Fix max_length for unicode strings by @lig in #6559
Add documentation for accessing features via pydantic.v1 by @tpdorsey in #6604
Include extra when iterating over a model by @adriangb in #6562
Fix typing of model_validator by @adriangb in #6514
Touch up Decimal validator by @adriangb in #6327
Fix various docstrings using fixed pytest-examples by @dmontagu in #6607
Handle function validators in a discriminated union by @dmontagu in #6570
Review json_schema.md by @tpdorsey in #6608
Make validate_call work on basemodel methods by @dmontagu in #6569
add test for big int json serde by @davidhewitt in #6614
Fix pydantic dataclass problem with dataclasses.field default_factory by @hramezani in #6616
Fixed mypy type inference for TypeAdapter by @zakstucke in #6617
Make it work to use None as a generic parameter by @dmontagu in #6609
Make it work to use $ref as an alias by @dmontagu in #6568
add note to migration guide about changes to AnyUrl etc by @davidhewitt in #6618
🐛 Support defining json_schema_extra on RootModel using Field by @lig in #6622
Update pre-commit to prevent commits to main branch on accident by @dmontagu in #6636
Fix PDM CI for python 3.7 on MacOS/windows by @dmontagu in #6627
Produce more accurate signatures for pydantic dataclasses by @dmontagu in #6633
Updates to Url types for Pydantic V2 by @tpdorsey in #6638
Fix list markdown in transform docstring by @StefanBRas in #6649
simplify slots_dataclass construction to appease mypy by @davidhewitt in #6639
Update TypedDict schema generation docstring by @adriangb in #6651
Detect and lint-error for prints by @dmontagu in #6655
Add xfailing test for pydantic-core PR 766 by @dmontagu in #6641
Ignore unrecognized fields from dataclasses metadata by @dmontagu in #6634
Make non-existent class getattr a mypy error by @dmontagu in #6658
Update pydantic-core to 2.3.0 by @hramezani in #6648
Use OrderedDict from typing_extensions by @dmontagu in #6664
Fix typehint for JSON schema extra callable by @dmontagu in #6659

v2.0.2 (2023-07-05)

GitHub release

Fix bug where round-trip pickling/unpickling a RootModel would change the value of __dict__, #6457 by @dmontagu
Allow single-item discriminated unions, #6405 by @dmontagu
Fix issue with union parsing of enums, #6440 by @dmontagu
Docs: Fixed constr documentation, renamed old regex to new pattern, #6452 by @miili
Change GenerateJsonSchema.generate_definitions signature, #6436 by @dmontagu

See the full changelog here

v2.0.1 (2023-07-04)

GitHub release

First patch release of Pydantic V2

Extra fields added via setattr (i.e. m.some_extra_field = 'extra_value') are added to .model_extra if model_config extra='allowed'. Fixed #6333, #6365 by @aaraney
Automatically unpack JSON schema '$ref' for custom types, #6343 by @adriangb
Fix tagged unions multiple processing in submodels, #6340 by @suharnikov

See the full changelog here

v2.0 (2023-06-30)

GitHub release

Pydantic V2 is here! :tada:

See this post for more details.

v2.0b3 (2023-06-16)

Third beta pre-release of Pydantic V2

See the full changelog here

v2.0b2 (2023-06-03)

Add from_attributes runtime flag to TypeAdapter.validate_python and BaseModel.model_validate.

See the full changelog here

v2.0b1 (2023-06-01)

First beta pre-release of Pydantic V2

See the full changelog here

v2.0a4 (2023-05-05)

Fourth pre-release of Pydantic V2

See the full changelog here

v2.0a3 (2023-04-20)

Third pre-release of Pydantic V2

See the full changelog here

v2.0a2 (2023-04-12)

Second pre-release of Pydantic V2

See the full changelog here

v2.0a1 (2023-04-03)

First pre-release of Pydantic V2!

See this post for more details.

... see here for earlier changes.

Project details

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

2.13.0b2 pre-release

Feb 24, 2026

2.13.0b1 pre-release

Feb 23, 2026

2.12.5

Nov 26, 2025

2.12.4

Nov 5, 2025

2.12.3

Oct 17, 2025

2.12.2

Oct 14, 2025

2.12.1 yanked

Oct 13, 2025

Reason this release was yanked:

references a yanked version of pydantic-core

2.12.0

Oct 7, 2025

2.12.0b1 pre-release

Oct 2, 2025

2.12.0a1 pre-release

Jul 26, 2025

2.11.10

Oct 4, 2025

2.11.9

Sep 13, 2025

2.11.8

Sep 13, 2025

2.11.7

Jun 14, 2025

2.11.6

Jun 13, 2025

2.11.5

May 22, 2025

2.11.4

Apr 29, 2025

2.11.3

Apr 8, 2025

2.11.2

Apr 3, 2025

2.11.1

Mar 28, 2025

2.11.0

Mar 27, 2025

2.11.0b2 pre-release

Mar 17, 2025

2.11.0b1 pre-release

Mar 6, 2025

2.11.0a2 pre-release

Feb 10, 2025

2.11.0a1 pre-release

Jan 30, 2025

2.10.6

Jan 24, 2025

2.10.5

Jan 9, 2025

2.10.4

Dec 18, 2024

2.10.3

Dec 3, 2024

2.10.2

Nov 26, 2024

2.10.1

Nov 22, 2024

2.10.0

Nov 20, 2024

2.10.0b2 pre-release

Nov 13, 2024

2.10.0b1 pre-release

Nov 6, 2024

2.9.2

Sep 17, 2024

2.9.1

Sep 9, 2024

2.9.0

Sep 5, 2024

2.9.0b2 pre-release

Aug 31, 2024

2.9.0b1 pre-release

Aug 26, 2024

2.8.2

Jul 4, 2024

2.8.1

Jul 3, 2024

2.8.0

Jul 1, 2024

2.8.0b1 pre-release

Jun 27, 2024

2.7.4

Jun 12, 2024

2.7.3

Jun 3, 2024

2.7.2

May 28, 2024

2.7.1

Apr 23, 2024

2.7.0

Apr 11, 2024

2.7.0b1 pre-release

Apr 3, 2024

2.6.4

Mar 12, 2024

2.6.3

Feb 27, 2024

This version

2.6.2

Feb 23, 2024

2.6.1

Feb 5, 2024

2.6.0

Jan 29, 2024

2.6.0b1 pre-release

Jan 19, 2024

2.5.3

Dec 22, 2023

2.5.2

Nov 22, 2023

2.5.1

Nov 15, 2023

2.5.0

Nov 13, 2023

2.5.0b1 pre-release

Nov 9, 2023

2.4.2

Sep 28, 2023

2.4.1

Sep 26, 2023

2.4.0

Sep 25, 2023

2.3.0

Aug 23, 2023

2.2.1

Aug 18, 2023

2.2.0

Aug 17, 2023

2.1.1

Jul 25, 2023

2.1.0

Jul 25, 2023

2.0.3

Jul 14, 2023

2.0.2

Jul 5, 2023

2.0.1

Jul 4, 2023

2.0

Jun 30, 2023

2.0b3 pre-release

Jun 17, 2023

2.0b2 pre-release

Jun 3, 2023

2.0b1 pre-release

Jun 1, 2023

2.0a4 pre-release

May 5, 2023

2.0a3 pre-release

Apr 20, 2023

2.0a2 pre-release

Apr 12, 2023

2.0a1 pre-release

Apr 3, 2023

1.10.26

Dec 18, 2025

1.10.25

Dec 18, 2025

1.10.24

Sep 25, 2025

1.10.23

Sep 13, 2025

1.10.22

Apr 24, 2025

1.10.21

Jan 14, 2025

1.10.20

Jan 7, 2025

1.10.19

Nov 6, 2024

1.10.18

Aug 22, 2024

1.10.17

Jun 20, 2024

1.10.16

Jun 11, 2024

1.10.15

Apr 3, 2024

1.10.14

Jan 19, 2024

1.10.13

Sep 27, 2023

1.10.12

Jul 24, 2023

1.10.11

Jul 4, 2023

1.10.10

Jun 30, 2023

1.10.9

Jun 7, 2023

1.10.8

May 23, 2023

1.10.7

Mar 22, 2023

1.10.6

Mar 8, 2023

1.10.5

Feb 15, 2023

1.10.4

Dec 30, 2022

1.10.3 yanked

Dec 29, 2022

Reason this release was yanked:

See https://github.com/pydantic/pydantic/issues/4885

1.10.2

Sep 5, 2022

1.10.1

Aug 31, 2022

1.10.0

Aug 30, 2022

1.10.0b1 pre-release

Aug 24, 2022

1.10.0a2 pre-release

Aug 24, 2022

1.10.0a1 pre-release

Aug 22, 2022

1.9.2

Aug 11, 2022

1.9.1

May 19, 2022

1.9.0

Dec 31, 2021

1.9.0a2 pre-release

Dec 24, 2021

1.9.0a1 pre-release

Dec 18, 2021

1.8.2

May 11, 2021

1.8.1

Mar 3, 2021

1.8

Feb 26, 2021

1.7.4

May 11, 2021

1.7.3

Nov 30, 2020

1.7.2

Nov 1, 2020

1.7.1

Oct 28, 2020

1.7

Oct 26, 2020

1.6.2

May 11, 2021

1.6.1

Jul 15, 2020

1.6

Jul 11, 2020

1.5.1

Apr 23, 2020

1.5

Apr 18, 2020

1.4

Jan 24, 2020

1.3

Dec 21, 2019

1.2

Nov 28, 2019

1.1.1

Nov 20, 2019

1.1

Nov 7, 2019

1.0

Oct 23, 2019

1.0b2 pre-release

Oct 7, 2019

1.0b1 pre-release

Oct 1, 2019

0.32.2

Aug 17, 2019

0.32.1

Aug 8, 2019

0.32

Aug 6, 2019

0.31.1

Jul 31, 2019

0.31

Jul 24, 2019

0.30.1

Jul 15, 2019

0.30

Jul 7, 2019

0.29

Jun 19, 2019

0.28

Jun 11, 2019

0.27

May 30, 2019

0.27a1 pre-release

May 26, 2019

0.26

May 22, 2019

0.25

May 5, 2019

0.24

Apr 23, 2019

0.23

Apr 4, 2019

0.22

Mar 29, 2019

0.21

Mar 15, 2019

0.20.1

Feb 26, 2019

0.20

Feb 18, 2019

0.20a1 pre-release

Feb 13, 2019

0.19

Feb 4, 2019

0.18.2

Jan 22, 2019

0.18.1

Jan 17, 2019

0.18

Jan 13, 2019

0.17

Dec 27, 2018

0.16.1

Dec 10, 2018

0.16

Dec 3, 2018

0.15

Nov 18, 2018

0.14

Oct 2, 2018

0.13.1

Sep 21, 2018

0.13

Aug 25, 2018

0.12.1

Jul 31, 2018

0.12

Jul 31, 2018

0.11.2

Jul 5, 2018

0.11.1

Jul 2, 2018

0.11

Jun 28, 2018

0.10

Jun 11, 2018

0.9.1

May 10, 2018

0.9

Apr 28, 2018

0.8

Mar 25, 2018

0.7.1

Feb 7, 2018

0.7

Feb 6, 2018

0.6.4

Feb 1, 2018

0.6.3

Nov 26, 2017

0.6.2

Nov 13, 2017

0.6.1

Nov 8, 2017

0.6

Nov 7, 2017

0.5

Oct 23, 2017

0.4

Jul 8, 2017

0.3

Jun 21, 2017

0.2.1

Jun 7, 2017

0.2

Jun 7, 2017

0.1

Jun 3, 2017

0.0.8

May 31, 2017

0.0.7

May 31, 2017

0.0.6

May 23, 2017

0.0.5

May 11, 2017

0.0.4

May 10, 2017

0.0.3

May 9, 2017

0.0.2

May 6, 2017

0.0.1

May 3, 2017

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pydantic-2.6.2.tar.gz (680.0 kB view details)

Uploaded Feb 23, 2024 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pydantic-2.6.2-py3-none-any.whl (394.9 kB view details)

Uploaded Feb 23, 2024 Python 3

File details

Details for the file pydantic-2.6.2.tar.gz.

File metadata

Download URL: pydantic-2.6.2.tar.gz
Upload date: Feb 23, 2024
Size: 680.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/4.0.2 CPython/3.11.8

File hashes

Hashes for pydantic-2.6.2.tar.gz
Algorithm	Hash digest
SHA256	`a09be1c3d28f3abe37f8a78af58284b236a92ce520105ddc91a6d29ea1176ba7`
MD5	`f07f11534e715f71a5ae91418a291ce9`
BLAKE2b-256	`a72d6308c04382ebdf15f1add7f0ec5e518ab23a0958363a8b3399f09c314fc0`

See more details on using hashes here.

File details

Details for the file pydantic-2.6.2-py3-none-any.whl.

File metadata

Download URL: pydantic-2.6.2-py3-none-any.whl
Upload date: Feb 23, 2024
Size: 394.9 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/4.0.2 CPython/3.11.8

File hashes

Hashes for pydantic-2.6.2-py3-none-any.whl
Algorithm	Hash digest
SHA256	`37a5432e54b12fecaa1049c5195f3d860a10e01bdfd24f1840ef14bd0d3aeab3`
MD5	`0c6e868a5bddaa2da4120c503dbf2062`
BLAKE2b-256	`4228f19be8d493c59a8ddf32c15d69765c6423ad712da1c6255b418df2fc1443`

See more details on using hashes here.

pydantic 2.6.2

Navigation

Verified details

Owner

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

Pydantic

Pydantic Company :rocket:

Pydantic V1.10 vs. V2

Help

Installation

A Simple Example

Contributing

Reporting a Security Vulnerability

Changelog

v2.6.2 (2024-02-23)

What's Changed

Packaging

Fixes

v2.6.1 (2024-02-05)

What's Changed

Packaging

Fixes

v2.6.0 (2024-01-29)

What's Changed

Packaging

New Features

Changes

Performance

Fixes

New Contributors

pydantic

pydantic-core

v2.6.0b1 (2024-01-19)

v2.5.3 (2023-12-22)

What's Changed

Packaging

Fixes

v2.5.2 (2023-11-22)

What's Changed

Packaging

New Features

Fixes

v2.5.1 (2023-11-15)

What's Changed

Packaging

Fixes

v2.5.0 (2023-11-13)

What's Changed

Packaging

New Features

Changes

Performance

Fixes

New Contributors

pydantic

pydantic-core

v2.5.0b1 (2023-11-09)

v2.4.2 (2023-09-27)

What's Changed

Fixes

New Contributors

v2.4.1 (2023-09-26)

What's Changed

Packaging

Fixes

v2.4.0 (2023-09-22)

What's Changed

Packaging

New Features

Changes

Performance

Fixes

New Contributors

v2.3.0 (2023-08-23)

v2.2.1 (2023-08-18)

`pydantic`

`pydantic-core`

`pydantic`

`pydantic-core`