This project is not affiliated with Microsoft in any way, shape or form
Pyright for Python is a Python command line wrapper over pyright, a static type checker for Python.
This project is not suitable for production usage.
Use the package manager pip to install pyright.
pip install pyrightPyright can be invoked using two different methods
pyright --helpor
python3 -m pyright --helpPyright for Python should work exactly the same as pyright does, see the pyright documentation for details on how to make use of pyright.
Pyright is written in TypeScript and requires node to be installed and is normally installed with npm, this could be a barrier for entry for some python developers as they may not have node or npm, installed on their machine, I wanted to make pyright as easy to install as any normal python package.
This project works by first checking if node is in the PATH and if it is not then we download node at runtime using nodeenv and then install the pyright npm package using npx.
We also automatically upgrade the pyright npm package to it's latest version on every run, see below for how to change this behaviour.
You can configure Pyright for Python using environment variables.
Set PYRIGHT_PYTHON_DEBUG to any value.
Set PYRIGHT_PYTHON_FORCE_VERSION to the desired version, e.g. 1.1.156
By default, Pyright for Python disables npm error messages, if you want to display the npm error messages then set PYRIGHT_PYTHON_VERBOSE to any truthy value.
Set PYRIGHT_PYTHON_GLOBAL_NODE to any non-truthy value, i.e. anything apart from 1, t, on or true.
e.g. off
Set PYRIGHT_PYTHON_ENV_DIR to a valid nodeenv directory. e.g. ~/.cache/nodeenv
Set PYRIGHT_PYTHON_IGNORE_WARNINGS to a truthy value, e.g. 1, t, on or true.
Pyright for Python will print warnings for the following case(s)
- Using nodeenv without bash available
All pull requests are welcome.