mirror of
https://github.com/kennethreitz/pydantic.git
synced 2026-06-05 23:00:18 +00:00
aeba4943883d9df6efde66c892eec38e15284da8
* ✨ Add support for generics with __get_validators__ * ✅ Add tests for Generics with __get_validators__ * 📝 Add change note * ✨ Add support for Generic fields with validation of sub-types * 📝 Add docs for arbitrary generic types * ✅ Add tests for generic sub-type validation * 📝 Update change note. Generic support is not so "basic" now * 📝 Update docs with code review * ♻️ Update fields module with code review changes * ✅ Update tests from code review * 📝 Update example for generics, try to simplify and explain better * tweak docs example Co-authored-by: Samuel Colvin <samcolvin@gmail.com>
pydantic
Data validation and settings management using Python type hinting.
Fast and extensible, pydantic plays nicely with your linters/IDE/brain. Define how data should be in pure, canonical Python 3.6+; validate it with pydantic.
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
from pydantic import BaseModel
class User(BaseModel):
id: int
name = 'John Doe'
signup_ts: 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.
Languages
Python
99.7%
Makefile
0.3%