Generate docs exampels for Python 3.10 and above (#4339)

* Generate docs exampels for Python 3.10 and above

Code quality is not great and main intent here is to show the result.

* Fix docs build on 3.9

* Build docs on 3.10

* What's Python 3.1?

* Create temp dir if not exists

* Refactor and improve imlementetion

* Keep runtime typing in examples

* Revert unrelated formatting changes

* Add changes file

* Allow specifying requirements in examples

* Pin autoflake and pyupgrade

* Add docs/build to Makefile lint/format/mypy

* ignore_missing_imports for ansi2html and devtools

* Add .tmp-projections to .gitignore

* Remove dont-upgrade now when Pattern is supported

* Update postponed evaluation examples

Co-authored-by: Samuel Colvin <s@muelcolvin.com>

.github/workflows/ci.yml

@@ -70,7 +70,7 @@ jobs:
     - name: set up python
       uses: actions/setup-python@v4
       with:
-        python-version: 3.9
+        python-version: "3.10"
 
     - uses: actions/cache@v3
       id: cache

.gitignore

@@ -21,6 +21,8 @@ test.py
 /docs/.version.md
 /docs/.tmp_schema_mappings.html
 /docs/.tmp_examples/
+/docs/.tmp-projections/
+/docs/usage/.tmp-projections/
 /site/
 /site.zip
 .pytest_cache/

Makefile

@@ -1,6 +1,7 @@
 .DEFAULT_GOAL := all
-isort = isort pydantic tests
-black = black -S -l 120 --target-version py38 pydantic tests
+sources = pydantic tests docs/build
+isort = isort $(sources)
+black = black -S -l 120 --target-version py38 $(sources)
 
 .PHONY: install-linting
 install-linting:
@@ -35,13 +36,13 @@ build:
 
 .PHONY: format
 format:
-	pyupgrade --py37-plus  --exit-zero-even-if-changed `find pydantic tests -name "*.py" -type f`
+	pyupgrade --py37-plus  --exit-zero-even-if-changed `find $(sources) -name "*.py" -type f`
 	$(isort)
 	$(black)
 
 .PHONY: lint
 lint:
-	flake8 pydantic/ tests/
+	flake8 $(sources)
 	$(isort) --check-only --df
 	$(black) --check --diff
 
@@ -53,7 +54,7 @@ check-dist:
 
 .PHONY: mypy
 mypy:
-	mypy pydantic
+	mypy pydantic docs/build
 
 .PHONY: pyupgrade
 pyupgrade:

changes/4339-Bobronium.md

@@ -0,0 +1 @@
+Add Python 3.9 and 3.10 examples to docs