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

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.101750849915
File Size Uploaded
pyre-check-nightly-0.0.101750849915.tar.gz 21.3 MB Details

Built distributions (wheels)

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

Total release size: 88.8 MB

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

Download URL pyre-check-nightly-0.0.101750849915.tar.gz
Size 21.3 MB
Tags Source
SHA-256 checksum
How to use checksums
7746b5b7a8a7d33e39eb588d2d93331ee833ec2e79121bee9ae8f18c06d39538
BLAKE2b-256 checksum
How to use checksums
0512f0c94f007b72305ec21b72788809e9524953a661170f358d5de57b014142
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.101750849915-py3-none-manylinux1_x86_64.whl

Download URL pyre_check_nightly-0.0.101750849915-py3-none-manylinux1_x86_64.whl
Size 45.5 MB
Tags Linux glibc 2.5+ x86-64 Python 3
SHA-256 checksum
How to use checksums
18fdfa59b2e3bbd0f8ef933cbe3a58dbdc037c41a5f01945cd08208dafb2c275
BLAKE2b-256 checksum
How to use checksums
0262deb4af6976c268104a0acc68821ebb993a9c72e8d190da69a7bb39aae808
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.101750849915-py3-none-macosx_10_11_x86_64.whl

Download URL pyre_check_nightly-0.0.101750849915-py3-none-macosx_10_11_x86_64.whl
Size 22.0 MB
Tags Python 3 macOS 10.11+ x86-64
SHA-256 checksum
How to use checksums
4db03ac3f33a38b8516405488634dd07b78f043cf345535abc61fe96cc9f6078
BLAKE2b-256 checksum
How to use checksums
89c7f95828c0c4570dfe4f4ddb67ede123959b18589f2e4989527b08dbc889fc
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.101750849915 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