mirror of
https://github.com/kennethreitz/pydantic.git
synced 2026-06-05 23:00:18 +00:00
Samuel Colvin
33b7d52d31
* moving docs to mkdocs * transfering readme to md and more * fixing build * splitting usage.md * improving schema.md and index.md * fix make_history.rst * models intro * working on data conversation and required fields * more fixes to models.md * list all standard types supported * list of pydantic types * tweaks * update links in code * Apply suggestions from code review incorporate @dmontagu's suggestions. Co-Authored-By: dmontagu <35119617+dmontagu@users.noreply.github.com> * Apply suggestions from code review more missed suggestions. Co-Authored-By: dmontagu <35119617+dmontagu@users.noreply.github.com> * Apply suggestions from code review more corrects. * cleanup * Field order warning * fix and regenerate benchmarks * format examples better, cleanup * improve schema mapping table * correct highlighting file types in schema.md * add redirects in javascript * add logo
53 lines
2.0 KiB
Markdown
53 lines
2.0 KiB
Markdown
We'd love you to contribute to *pydantic*, it should be extremely simple to get started and create a Pull Request.
|
|
*pydantic* is released regularly so you should see your improvements release in a matter of days or weeks.
|
|
|
|
Unless your change is trivial (typo, docs tweak etc.), please create an issue to discuss the change before
|
|
creating a pull request.
|
|
|
|
If you're looking for something to get your teeth into, check out the
|
|
["help wanted"](https://github.com/samuelcolvin/pydantic/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)
|
|
label on github.
|
|
|
|
To make contributing as easy and fast as possible, you'll want to run tests and linting locally. Luckily since
|
|
*pydantic* has few dependencies, doesn't require compiling and tests don't need access to databases etc., setting
|
|
up and running tests should be very simple.
|
|
|
|
You'll need to have **python 3.6** or **3.7**, **virtualenv**, **git**, and **make** installed.
|
|
|
|
```bash
|
|
# 1. clone your fork and cd into the repo directory
|
|
git clone git@github.com:<your username>/pydantic.git
|
|
cd pydantic
|
|
|
|
# 2. Set up a virtualenv for running tests
|
|
virtualenv -p `which python3.7` env
|
|
source env/bin/activate
|
|
# (or however you prefer to setup a python environment, 3.6 will work too)
|
|
|
|
# 3. Install pydantic, dependencies and test dependencies
|
|
make install
|
|
|
|
# 4. Checkout a new branch and make your changes
|
|
git checkout -b my-new-feature-branch
|
|
# make your changes...
|
|
|
|
# 5. Fix formatting and imports
|
|
make format
|
|
# Pydantic uses black to enforce formatting and isort to fix imports
|
|
# (https://github.com/ambv/black, https://github.com/timothycrosley/isort)
|
|
|
|
# 6. Run tests and linting
|
|
make
|
|
# there are a few sub-commands in Makefile like `test`, `testcov` and `lint`
|
|
# which you might want to use, but generally just `make` should be all you need
|
|
|
|
# 7. Build documentation
|
|
make docs
|
|
# if you have changed the documentation make sure it builds successfully
|
|
|
|
# ... commit, push, and create your pull request
|
|
```
|
|
|
|
**tl;dr**: use `make format` to fix formatting, `make` to run tests and linting & `make docs`
|
|
to build docs.
|