Skip to main content

https://pythran.readthedocs.io

What is it?

Pythran is an ahead of time compiler for a subset of the Python language, with a focus on scientific computing. It takes a Python module annotated with a few interface descriptions and turns it into a native Python module with the same interface, but (hopefully) faster.

It is meant to efficiently compile scientific programs, and takes advantage of multi-cores and SIMD instruction units.

Until 0.9.5 (included), Pythran was supporting Python 3 and Python 2.7. It now only supports Python 3.7 and upward.

Installation

Pythran sources are hosted on https://github.com/serge-sans-paille/pythran.

Pythran releases are hosted on https://pypi.python.org/pypi/pythran.

Pythran is available on conda-forge on https://anaconda.org/conda-forge/pythran.

Debian/Ubuntu

Using pip

  1. Gather dependencies:

    Pythran depends on a few Python modules and several C++ libraries. On a debian-like platform, run:

    $> sudo apt-get install libatlas-base-dev
    $> sudo apt-get install python-dev python-ply python-numpy
  2. Install with pip:

    $> pip install pythran

Using mamba or conda

  1. Using mamba (https://github.com/conda-forge/miniforge) or conda (https://github.com/conda-forge/miniforge)

  2. Run:

    $> mamba install -c conda-forge pythran

    or:

    $> conda install -c conda-forge pythran

Mac OSX

Using brew (https://brew.sh/):

$> pip install pythran
$> brew install openblas
$> printf '[compiler]\nblas=openblas\ninclude_dirs=/usr/local/opt/openblas/include\nlibrary_dirs=/usr/local/opt/openblas/lib' > ~/.pythranrc

Depending on your setup, you may need to add the following to your ~/.pythranrc file:

[compiler]
CXX=g++-4.9
CC=gcc-4.9

ArchLinux

Using pacman:

$> pacman -S python-pythran

Fedora

Using dnf:

$> dnf install pythran

Windows

Windows support is on going and only targets Python 3.5+ with either Visual Studio 2017 or, better, clang-cl:

$> pip install pythran

Note that using clang-cl.exe is the default setting. It can be changed through the CXX and CC environment variables.

Other Platform

See MANUAL file.

Basic Usage

A simple pythran input could be dprod.py

"""
Naive dotproduct! Pythran supports numpy.dot
"""
#pythran export dprod(int list, int list)
def dprod(l0,l1):
    """WoW, generator expression, zip and sum."""
    return sum(x * y for x, y in zip(l0, l1))

To turn it into a native module, run:

$> pythran dprod.py

That will generate a native dprod.so that can be imported just like the former module:

$> python -c 'import dprod' # this imports the native module instead

Documentation

The user documentation is available in the MANUAL file from the doc directory.

The developer documentation is available in the DEVGUIDE file from the doc directory. There is also a TUTORIAL file for those who don’t like reading documentation.

The CLI documentation is available from the pythran help command:

$> pythran --help

Some extra developer documentation is also available using pydoc. Beware, this is the computer science incarnation for the famous Where’s Waldo? game:

$> pydoc pythran
$> pydoc pythran.typing
$> pydoc -b  # in the browser

Examples

See the pythran/tests/cases/ directory from the sources.

Contact

Praise, flame and cookies:

The mailing list archive is available at https://www.freelists.org/archive/pythran/.

Citing

If you need to cite a Pythran paper, feel free to use

@article{guelton2015pythran,
  title={Pythran: Enabling static optimization of scientific python programs},
  author={Guelton, Serge and Brunet, Pierrick and Amini, Mehdi and Merlini,
                  Adrien and Corbillon, Xavier and Raynaud, Alan},
  journal={Computational Science \& Discovery},
  volume={8},
  number={1},
  pages={014001},
  year={2015},
  publisher={IOP Publishing}
}

Authors

See AUTHORS file.

License

See LICENSE file.

Download files

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

Source Distribution

pythran-0.19.0.tar.gz (2.5 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pythran-0.19.0-py3-none-any.whl (4.4 MB view details)

Uploaded Python 3

File details

Details for the file pythran-0.19.0.tar.gz.

File metadata

  • Download URL: pythran-0.19.0.tar.gz
  • Upload date:
  • Size: 2.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.5

File hashes

Hashes for pythran-0.19.0.tar.gz
Algorithm Hash digest
SHA256 18a096daa8b4bbe3ace06ce5d7325be5ff57aec4cf67b91834cf1b757b3e5392
MD5 1a10301204ffc98e04346b2e8147d955
BLAKE2b-256 bba303098a8a5d2c9f801c227cf941d85976934f5f47307ef3d819734370acdc

See more details on using hashes here.

File details

Details for the file pythran-0.19.0-py3-none-any.whl.

File metadata

  • Download URL: pythran-0.19.0-py3-none-any.whl
  • Upload date:
  • Size: 4.4 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.5

File hashes

Hashes for pythran-0.19.0-py3-none-any.whl
Algorithm Hash digest
SHA256 42ab2039b4eaec01084e92a2721a474e893047ba5ec87b14d45ee077ac883d08
MD5 66bfdbedcbf07e573acfa606323a779b
BLAKE2b-256 4add6930fa349be42a3ceb14732ec922fb77f2dd9979f16a5df4e0f575369703

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.19.0 This release

2 files

0.18.1

2 files

0.18.0

2 files

0.17.0

2 files

0.16.1

1 file

0.16.0

2 files

0.15.0

2 files

0.14.0

2 files

0.13.1

2 files

0.13.0

2 files

0.12.2

2 files

0.12.1

2 files

0.12.0

2 files

0.11.0

2 files

0.10.0

2 files

0.9.12.post1

2 files

0.9.12

2 files

0.9.11

2 files

0.9.10

2 files

0.9.9

2 files

0.9.8.post2

2 files

0.9.8.post1

2 files

0.9.8

2 files

0.9.7

2 files

0.9.6

2 files

0.9.5

1 file

0.9.4.post1

1 file

0.9.4.post0

1 file

0.9.4

1 file

0.9.3.post1

1 file

0.9.3.post0

1 file

0.9.3

1 file

0.9.2

1 file

0.9.1.post0

1 file

0.9.1

1 file

0.9.0

1 file

0.8.7

1 file

0.8.6

1 file

0.8.5

1 file

0.8.4.post0

1 file

0.8.4

1 file

0.8.3

1 file

0.8.2

1 file

0.8.1

1 file

0.8.0

1 file

0.7.6.post1

1 file

0.7.6

1 file

0.7.5.post2

1 file

0.7.5.post1

1 file

0.7.5

1 file

0.7.4.post1

1 file

0.7.4.post0

1 file

0.7.4

1 file

0.7.3

1 file

0.7.2

0.7.1

1 file

0.7.0

1 file

0.6.0

1 file

0.5.0

1 file

0.4.0

1 file

0.3.0

1 file

0.2.0

1 file

0.1.0

1 file

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page