mirror of
https://github.com/kennethreitz/pydantic.git
synced 2026-06-05 23:00:18 +00:00
Samuel Colvin
f341049b9e
* Remove Cython * fix CI * fix coverage * fix tests * switching to pypyroject.toml * pre-commit all and use pre-commit for linting * no mypy tests on macos and windows on ci, use flake8-pyproject * fix docs and tests CI * check build is working * drop pytest-cov * window and macos ci with 3.11, reduce filtering * use pip-tools to pin all dependencies * fix docs and fastapi tests * fix test deps for 3.7 * no cache on tests job * revert fastapi changes, fix coverage * fix mypy coverage * test with older mypy * dotenv not required for mypy tests * split testing requirements std and extra * typo * @PrettyWood comments * correct branch name * mypy python_version and pr template
68 lines
2.5 KiB
Markdown
68 lines
2.5 KiB
Markdown
# pydantic
|
|
|
|
[](https://github.com/pydantic/pydantic/actions?query=event%3Apush+branch%3Amain+workflow%3ACI)
|
|
[](https://coverage-badge.samuelcolvin.workers.dev/redirect/pydantic/pydantic)
|
|
[](https://pypi.python.org/pypi/pydantic)
|
|
[](https://anaconda.org/conda-forge/pydantic)
|
|
[](https://pepy.tech/project/pydantic)
|
|
[](https://github.com/pydantic/pydantic)
|
|
[](https://github.com/pydantic/pydantic/blob/main/LICENSE)
|
|
|
|
Data validation using Python type hints.
|
|
|
|
---
|
|
|
|
## Notice
|
|
|
|
**This branch relates to development of pydantic V2 which is not yet ready for release.**
|
|
|
|
If you're a user of pydantic, you probably want either
|
|
[pydantic V1.10 Documentation](https://pydantic-docs.helpmanual.io/) or,
|
|
[`1.10.X-fixes` git branch](https://github.com/pydantic/pydantic/tree/1.10.X-fixes).
|
|
|
|
---
|
|
|
|
Fast and extensible, *pydantic* plays nicely with your linters/IDE/brain.
|
|
Define how data should be in pure, canonical Python 3.7+; validate it with *pydantic*.
|
|
|
|
## Help
|
|
|
|
See [documentation](https://pydantic-docs.helpmanual.io/) 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](https://pydantic-docs.helpmanual.io/install/) section in the documentation.
|
|
|
|
## A Simple Example
|
|
|
|
```py
|
|
from datetime import datetime
|
|
from typing import List, Optional
|
|
from pydantic import BaseModel
|
|
|
|
class User(BaseModel):
|
|
id: int
|
|
name = '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](https://pydantic-docs.helpmanual.io/contributing/).
|
|
|
|
## Reporting a Security Vulnerability
|
|
|
|
See our [security policy](https://github.com/pydantic/pydantic/security/policy).
|