Skip to main content

A performant type checker for Python

Project description

lint tests pyre

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.

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.

Requirements

To get started, you need Python 3.6 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.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyre-check-0.9.3.tar.gz (15.3 MB view details)

Uploaded Source

Built Distributions

pyre_check-0.9.3-py3-none-manylinux1_x86_64.whl (25.1 MB view details)

Uploaded Python 3

pyre_check-0.9.3-py3-none-macosx_10_11_x86_64.whl (16.0 MB view details)

Uploaded Python 3 macOS 10.11+ x86-64

File details

Details for the file pyre-check-0.9.3.tar.gz.

File metadata

  • Download URL: pyre-check-0.9.3.tar.gz
  • Upload date:
  • Size: 15.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.6.1 requests/2.25.1+fb6 setuptools/51.0.0 requests-toolbelt/0.8.0 tqdm/4.55.1 CPython/3.8.6

File hashes

Hashes for pyre-check-0.9.3.tar.gz
Algorithm Hash digest
SHA256 d5c03de101610d534eaf3d7b654702d91b95505209886feed211a30ded789daa
MD5 fa9cd293be1ade729ab07e742fb38b41
BLAKE2b-256 f6c444443260ad1b8a5c7141167d8c1cebefc4968869e66d179b5569185236eb

See more details on using hashes here.

Provenance

File details

Details for the file pyre_check-0.9.3-py3-none-manylinux1_x86_64.whl.

File metadata

  • Download URL: pyre_check-0.9.3-py3-none-manylinux1_x86_64.whl
  • Upload date:
  • Size: 25.1 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.6.1 requests/2.25.1+fb6 setuptools/51.0.0 requests-toolbelt/0.8.0 tqdm/4.55.1 CPython/3.8.6

File hashes

Hashes for pyre_check-0.9.3-py3-none-manylinux1_x86_64.whl
Algorithm Hash digest
SHA256 ed000307bcc7999b6e651bd8fa3d7716d6b3cc272855bf677643438f77ff54c1
MD5 8f064c5a46a99c0f2f9d508b28c2bf71
BLAKE2b-256 9b4339e09ed203ed27e7e27780e9f4e1c64b0bc322eb66f39cdd9728d1365883

See more details on using hashes here.

Provenance

File details

Details for the file pyre_check-0.9.3-py3-none-macosx_10_11_x86_64.whl.

File metadata

  • Download URL: pyre_check-0.9.3-py3-none-macosx_10_11_x86_64.whl
  • Upload date:
  • Size: 16.0 MB
  • Tags: Python 3, macOS 10.11+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.6.1 requests/2.25.1+fb6 setuptools/51.0.0 requests-toolbelt/0.8.0 tqdm/4.55.1 CPython/3.8.6

File hashes

Hashes for pyre_check-0.9.3-py3-none-macosx_10_11_x86_64.whl
Algorithm Hash digest
SHA256 989a82f1f76dd572da46e33bde34e56e7949f272df32f96d1f397241f42ebb13
MD5 557bde13b33a3c2514e1bdf31f31f89d
BLAKE2b-256 d2624dcfde94809fb3119869f2f903b3322b49ef6b2460b5baeccfd71102b08a

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page