The PEX packaging toolchain.
Project description
Overview
pex is a library for generating .pex (Python EXecutable) files which are executable Python environments in the spirit of virtualenvs. pex is an expansion upon the ideas outlined in PEP 441 and makes the deployment of Python applications as simple as cp. pex files may even include multiple platform-specific Python distributions, meaning that a single pex file can be portable across Linux and OS X.
pex files can be built using the pex tool. Build systems such as Pants, Buck, and {py}gradle also support building .pex files directly.
Still unsure about what pex does or how it works? Watch this quick lightning talk: WTF is PEX?.
pex is licensed under the Apache2 license.
Installation
To install pex, simply
$ pip install pexYou can also build pex in a git clone using tox:
$ tox -e package
$ cp dist/pex ~/binThis builds a pex binary in dist/pex that can be copied onto your $PATH. The advantage to this approach is that it keeps your Python environment as empty as possible and is more in-line with what pex does philosophically.
Simple Examples
Launch an interpreter with requests, flask and psutil in the environment:
$ pex requests flask 'psutil>2,<3'Or instead freeze your current virtualenv via requirements.txt and execute it anywhere:
$ pex -r <(pip freeze) -o my_virtualenv.pex
$ deactivate
$ ./my_virtualenv.pexRun webserver.py in an environment containing flask as a quick way to experiment:
$ pex flask -- webserver.pyLaunch Sphinx in an ephemeral pex environment using the Sphinx entry point sphinx:main:
$ pex sphinx -e sphinx:main -- --helpBuild a standalone pex binary into pex.pex using the pex console_scripts entry point:
$ pex pex -c pex -o pex.pexYou can also build pex files that use a specific interpreter type:
$ pex pex -c pex --python=pypy -o pypy-pex.pexMost pex options compose well with one another, so the above commands can be mixed and matched. For a full list of options, just type pex --help.
Integrating pex into your workflow
If you use tox (and you should!), a simple way to integrate pex into your workflow is to add a packaging test environment to your tox.ini:
[testenv:package]
deps = pex
commands = pex . -o dist/app.pexThen tox -e package will produce a relocateable copy of your application that you can copy to staging or production environments.
Documentation
More documentation about Pex, building .pex files, and how .pex files work is available at https://pex.readthedocs.io.
Development
Pex uses tox for test and development automation. To run the test suite, just invoke tox:
$ toxIf you don’t have tox, you can generate a pex of tox:
$ pex tox -c tox -o ~/bin/toxTox provides many useful commands and options, explained at https://tox.readthedocs.io/en/latest/. Below, we provide some of the most commonly used commands used when working on Pex, but the docs are worth acquainting yourself with to better understand how Tox works and how to do more advanced commmands.
To run a specific environment, identify the name of the environment you’d like to invoke by running tox --listenvs-all, then invoke like this:
$ tox -e format-runAll of our tox test environments allow passthrough arguments, which can be helpful to run specific tests:
$ tox -e py37-integration -- -k test_reproducible_buildTo run Pex from source, rather than through what is on your PATH, invoke via Python:
$ python -m pexContributing
To contribute, follow these instructions: https://www.pantsbuild.org/docs/contributor-overview
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
Built Distribution
File details
Details for the file pex-2.1.15.tar.gz.
File metadata
- Download URL: pex-2.1.15.tar.gz
- Upload date:
- Size: 3.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: python-requests/2.24.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e1092ae52cfdef41c22d98fa98f9225ac21936a7d096131777ca3a7940fe1b2d |
|
| MD5 | c850f71a47626839742e107470f6a37c |
|
| BLAKE2b-256 | 713d1e60e9a68e9848f5040928ff707020bbe7a43c40ae6eb43669fb86f08df1 |
File details
Details for the file pex-2.1.15-py2.py3-none-any.whl.
File metadata
- Download URL: pex-2.1.15-py2.py3-none-any.whl
- Upload date:
- Size: 2.3 MB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: python-requests/2.24.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 338d41d238e3035a25edf6641897b2e372365de7e84acadfb01231536cefd03f |
|
| MD5 | 292b776a931264115b8c510d2e09212d |
|
| BLAKE2b-256 | f8d0edeed88fc1a9e56c939df65eeb9f1d7a97b3dd656197b0517a572808a16d |
