a claimless python to c++ converter
Project description
======= Pythran =======
http://pythonhosted.org/pythran/
What is it?
Pythran is a Python to c++ compiler for a subset of the Python language, with a focus on scientific computing. It takes a Python module annotated with a few interface description 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.
Pythran development is currently done using Python version 2.7.
Installation
Pythran sources are hosted on https://github.com/serge-sans-paille/pythran.
Pythran releases are hosted on http://pypi.python.org/pypi/pythran.
Pythran is available through Conda on https://conda.anaconda.org/serge-sans-paille.
Debian/Ubuntu
Using pip
Gather dependencies:
Pythran depends on a few Python modules and several C++ libraries. On a debian-like platform, run:
$> sudo apt-get install libgmp-dev libboost-dev cmake libblas-dev $> sudo apt-get install python-dev python-ply python-networkx python-numpy
Use easy_install or pip:
$> pip install pythran
Using a private debian repo
Add serge_sans_paille’s debian server to your source.list, following the instruction given in http://serge.liyun.free.fr/serge/debian.html
Run the classic:
$> sudo apt-get update $> sudo apt-get install pythran
Using conda
Install conda, following the instruction given in http://conda.pydata.org/docs/install/quick.html
Run:
$> conda install -c serge-sans-paille pythran
Mac OSX
Using brew (http://brew.sh/):
$> brew install gmp $> brew install cmake $> easy_install pip $> pip install numpy pythran
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 yaourt:
$> yaourt -S python2-pythran-git
Windows
Using WinPython (http://winpython.github.io), installed in E:\WinPython-32bit-2.7.9.5
Install the binary version of CMake (http://www.cmake.org/download), and make sure to check to check the box to add cmake to the PATH.
Install Boost (http://www.boost.org/users/download/): Once the archive is extracted, use the WinPython Command Prompt and run the following:
cd boost_1_58 .\bootstrap.bat .\b2 toolset=gcc link=shared xcopy /E boost E:\WinPython-32bit-2.7.9.5\python-2.7.9\include\boost
The python-2.7.9 directory may be python-2.7.9-amd64.
Then cd to the Pythran source, and run:
set BOOST_ROOT=E:\boost_1_58 python setup.py install
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. The also is a TUTORIAL file for those who don’t like reading documentation.
A todo list is maintained in the eponymous TODO file.
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
Examples
See the pythran/tests/cases/ directory from the sources.
Contact
Praise, flame and cookies:
pythran@freelists.org – register at http://www.freelists.org/list/pythran first!
#pythran on FreeNode
The mailing list archive is available at http://www.freelists.org/archive/pythran/.
License
See LICENSE file.
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.