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.101755256327

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.101755256327
File Size Uploaded
pyre-check-nightly-0.0.101755256327.tar.gz 21.6 MB Details

Built distributions (wheels)

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

Total release size: 89.8 MB

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

Download URL pyre-check-nightly-0.0.101755256327.tar.gz
Size 21.6 MB
Tags Source
SHA-256 checksum
How to use checksums
0793bd6331c253762d5c463418e95599975d18d31cc0890b8fed4b64757cce59
BLAKE2b-256 checksum
How to use checksums
3896f75029163f0a19497e822193c56ec6aca38dcb46e39f7e0d7ea39e372e00
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.101755256327-py3-none-manylinux1_x86_64.whl

Download URL pyre_check_nightly-0.0.101755256327-py3-none-manylinux1_x86_64.whl
Size 45.9 MB
Tags Linux glibc 2.5+ x86-64 Python 3
SHA-256 checksum
How to use checksums
737a285577a7402180f70be371a2e3a0093df2610e91d368fe3752c180543381
BLAKE2b-256 checksum
How to use checksums
2243b798c945c58c9f2e32ac555c50f6fcee3298af473b0c299a20256d061b56
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.101755256327-py3-none-macosx_10_11_x86_64.whl

Download URL pyre_check_nightly-0.0.101755256327-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
6ccb0f623200697f07da9101120834ec67e779c9e7dea702f015372f145d8a1f
BLAKE2b-256 checksum
How to use checksums
dcaea89b8db3c097e98361b9fd74395595ef20b43fe57994e6044a8bbf95c7f8
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.101755256327 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