Skip to main content

tests License: MIT Gitter

[!IMPORTANT]

New Version is Available

Check out Pyrefly, our next-generation Python typechecker and language server.

Pyre is a performant type checker for Python compliant with PEP 484. Pyre can analyze codebases with millions of lines of code incrementally – providing instantaneous feedback to developers as they write code. You can try it out on examples in the Pyre Playground.

Pyre ships with Pysa, a security focused static analysis tool we've built on top of Pyre that reasons about data flows in Python applications. Please refer to our documentation to get started with our security analysis.

Pysa is also available on the GitHub Marketplace as a Github Action

Requirements

To get started, you need Python 3.8 or later and watchman working on your system. On MacOS you can get everything with homebrew:

$ brew install python3 watchman

On Ubuntu, Mint, or Debian; use apt-get and homebrew:

$ sudo apt-get install python3 python3-pip python3-venv
$ brew install watchman

We tested Pyre on Ubuntu 18.04.5 LTS, CentOS 7, as well as OSX 10.11 and later.

Setting up a Project

We start by creating an empty project directory and setting up a virtual environment:

$ mkdir my_project && cd my_project
$ python3 -m venv ~/.venvs/venv
$ source ~/.venvs/venv/bin/activate
(venv) $ pip install pyre-check

Next, we teach Pyre about our new project:

(venv) $ pyre init

This command will set up a configuration for Pyre (.pyre_configuration) as well as watchman (.watchmanconfig) in your project's directory. Accept the defaults for now – you can change them later if necessary.

Running Pyre

We are now ready to run Pyre:

(venv) $ echo "i: int = 'string'" > test.py
(venv) $ pyre
 ƛ Found 1 type error!
test.py:1:0 Incompatible variable type [9]: i is declared to have type `int` but is used as type `str`.

This first invocation will start a daemon listening for filesystem changes – type checking your project incrementally as you make edits to the code. You will notice that subsequent invocations of pyre will be faster than the first one.

For more detailed documentation, see https://pyre-check.org.

Join the Pyre community

See CONTRIBUTING.md for how to help out.

License

Pyre is licensed under the MIT license.

Metadata

Release files for pyre-check-nightly 0.0.101754219451

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyre-check-nightly 0.0.101754219451
File Size Uploaded
pyre-check-nightly-0.0.101754219451.tar.gz 21.5 MB Details

Built distributions (wheels)

Table of built distributions (wheels) for pyre-check-nightly 0.0.101754219451
File Interpreter ABI Platform
pyre_check_nightly-0.0.101754219451-py3-none-manylinux1_x86_64.whl Python 3 none Linux glibc 2.5+ x86-64 Details
pyre_check_nightly-0.0.101754219451-py3-none-macosx_10_11_x86_64.whl Python 3 none macOS 10.11+ x86-64 Details

Total release size: 89.5 MB

Release files / pyre-check-nightly-0.0.101754219451.tar.gz

Download URL pyre-check-nightly-0.0.101754219451.tar.gz
Size 21.5 MB
Tags Source
SHA-256 checksum
How to use checksums
aa0511c33b01dc6f89c0da13e724ada4fe38a480d1643b9ef20d67b191af7aff
BLAKE2b-256 checksum
How to use checksums
84cefd1c3670ac512019080cbb9de6d69d75ce0975847df4cc8f46dd76f51f36
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.1.1 pkginfo/1.12.0 requests/2.32.3+fb3 setuptools/70.0.0 requests-toolbelt/0.9.1 tqdm/4.67.1 CPython/3.12.11+meta

Release files / pyre_check_nightly-0.0.101754219451-py3-none-manylinux1_x86_64.whl

Download URL pyre_check_nightly-0.0.101754219451-py3-none-manylinux1_x86_64.whl
Size 45.8 MB
Tags Linux glibc 2.5+ x86-64 Python 3
SHA-256 checksum
How to use checksums
ddd8d9dd7e0ef03dc7676fef507bd4d86bbcdbfe959c83238ebe52024e7f6fb5
BLAKE2b-256 checksum
How to use checksums
8c36577fc2fd5a9afd03e1968dce9d765af1785cf8d02b0059c8f16ab1850bee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.1.1 pkginfo/1.12.0 requests/2.32.3+fb3 setuptools/70.0.0 requests-toolbelt/0.9.1 tqdm/4.67.1 CPython/3.12.11+meta

Release files / pyre_check_nightly-0.0.101754219451-py3-none-macosx_10_11_x86_64.whl

Download URL pyre_check_nightly-0.0.101754219451-py3-none-macosx_10_11_x86_64.whl
Size 22.3 MB
Tags Python 3 macOS 10.11+ x86-64
SHA-256 checksum
How to use checksums
89729b82120b28226d04e2bba46a8b7938de17490ad543b90405504be38af415
BLAKE2b-256 checksum
How to use checksums
42b011616fe7ed1ec8fb5abd949214e71f977313e6018390ad2c173611c75cb3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.1.1 pkginfo/1.12.0 requests/2.32.3+fb3 setuptools/70.0.0 requests-toolbelt/0.9.1 tqdm/4.67.1 CPython/3.12.11+meta

Release history Release notifications | RSS feed

This release

0.0.101754219451 This release

3 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page