GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — typing/docs at main · python/typing

Expand file tree

/

docs

/
Copy path

Directory actions

More options

More options

Directory actions

More options

More options

Latest commit

 

History

History
History
/

docs

/
Copy path

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
guides
guides
 
 
reference
reference
 
 
spec
spec
 
 
tutorials
tutorials
 
 
Makefile
Makefile
 
 
README.rst
README.rst
 
 
conf.py
conf.py
 
 
index.rst
index.rst
 
 
make.bat
make.bat
 
 

README.rst

Outline

Python Typing Documentation

Reading the docs

The live documentation for Python's static typing can be found at typing.python.org.

Building the docs

The documentation is built with tools which are not included in this tree but are maintained separately and are available from PyPI.

  • Sphinx
  • python-docs-theme

The easiest way to install these tools is to create a virtual environment and install the tools into there.

Using make

To get started on UNIX, you can create a virtual environment with the command

make venv

That will install all the tools necessary to build the documentation. Assuming the virtual environment was created in the venv directory (the default; configurable with the VENVDIR variable), you can run the following command to build the HTML output files:

make html

By default, if the virtual environment is not created, the Makefile will look for instances of sphinxbuild and blurb installed on your process PATH (configurable with the SPHINXBUILD and BLURB variables).

Available make targets are:

  • "clean", which removes all build files.
  • "venv", which creates a virtual environment with all necessary tools installed.
  • "html", which builds standalone HTML files for offline viewing.
  • "text", which builds a plain text file for each source file.
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.