Skip to main content

A performant type checker for Python

Project description

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:

$ sudo apt-get install python3 python3-pip watchman

We tested Pyre on Ubuntu 16.04 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.0.53.tar.gz (15.2 MB view details)

Uploaded Source

Built Distributions

pyre_check-0.0.53-py3-none-manylinux1_x86_64.whl (24.6 MB view details)

Uploaded Python 3

pyre_check-0.0.53-py3-none-macosx_10_11_x86_64.whl (16.1 MB view details)

Uploaded Python 3 macOS 10.11+ x86-64

File details

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

File metadata

  • Download URL: pyre-check-0.0.53.tar.gz
  • Upload date:
  • Size: 15.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.4.2 requests/2.24.1+fb1 setuptools/46.1.0 requests-toolbelt/0.8.0 tqdm/4.47.0 CPython/3.7.5+

File hashes

Hashes for pyre-check-0.0.53.tar.gz
Algorithm Hash digest
SHA256 a504fc7cae0420ac981df9fd6eb458ca0e1dce42770767ddad1265c599e2c6c5
MD5 43ea109a676e9f17535b35380f3a2982
BLAKE2b-256 73fbf4b6598e9803331b1ea85d11d7c405731625a3fdcea838333e65f799fba7

See more details on using hashes here.

Provenance

File details

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

File metadata

  • Download URL: pyre_check-0.0.53-py3-none-manylinux1_x86_64.whl
  • Upload date:
  • Size: 24.6 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.4.2 requests/2.24.1+fb1 setuptools/46.1.0 requests-toolbelt/0.8.0 tqdm/4.47.0 CPython/3.7.5+

File hashes

Hashes for pyre_check-0.0.53-py3-none-manylinux1_x86_64.whl
Algorithm Hash digest
SHA256 2e7f0405dd695c84339b040275e134b941c67adc4e13d8ad090a6c892abeccfb
MD5 d154d22bac2521cf049beb7dc3df4ea3
BLAKE2b-256 c805b248c1efdbca2b53770420e402397ecc0f06ca46b619f6e51c8f4c21920b

See more details on using hashes here.

Provenance

File details

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

File metadata

  • Download URL: pyre_check-0.0.53-py3-none-macosx_10_11_x86_64.whl
  • Upload date:
  • Size: 16.1 MB
  • Tags: Python 3, macOS 10.11+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.4.2 requests/2.24.1+fb1 setuptools/46.1.0 requests-toolbelt/0.8.0 tqdm/4.47.0 CPython/3.7.5+

File hashes

Hashes for pyre_check-0.0.53-py3-none-macosx_10_11_x86_64.whl
Algorithm Hash digest
SHA256 998c968aa0b0f432f57f8c8187f386b0088c098379ddeeb181a137c982b8c059
MD5 471372ea07532a9dbcd02f5cc970df6c
BLAKE2b-256 753b95ebe81b47a237911721f02a6a571695f4d8646c05a335e344459e9ba23d

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