The PEX packaging toolchain.

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for benjyw from gravatar.com benjyw Avatar for John.Sirois from gravatar.com John.Sirois Avatar for wickman from gravatar.com wickman

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: Apache Software License
  • Author: The PEX developers
  • Requires: Python >=2.7, <3.12, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
Classifiers

Project description

https://github.com/pantsbuild/pex/workflows/CI/badge.svg?branch=main https://img.shields.io/pypi/l/pex.svg https://img.shields.io/pypi/v/pex.svg https://img.shields.io/pypi/pyversions/pex.svg https://img.shields.io/pypi/wheel/pex.svg

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 pex

You can also build pex in a git clone using tox:

$ tox -e package
$ cp dist/pex ~/bin

This 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'

Save Dependencies From Pip

Or instead freeze your current virtualenv via requirements.txt and execute it anywhere:

$ pex $(pip freeze) -o my_virtualenv.pex
$ deactivate
$ ./my_virtualenv.pex

Ephemeral Environments

Run webserver.py in an environment containing flask as a quick way to experiment:

$ pex flask -- webserver.py

Launch Sphinx in an ephemeral pex environment using the Sphinx entry point sphinx:main:

$ pex sphinx -e sphinx:main -- --help

Using Entry Points

Projects specifying a console_scripts entry point in their configuration can build standalone executables for those entry points.

To build a standalone pex-tools-executable.pex binary that runs the pex-tools console script found in all pex version 2.1.35 and newer distributions:

$ pex "pex>=2.1.35" --console-script pex-tools --output-file pex-tools-executable.pex

Specifying A Specific Interpreter

You can also build pex files that use a specific interpreter type:

$ pex "pex>=2.1.35" -c pex-tools --python=pypy -o pex-tools-pypy-executable.pex

Most pex options compose well with one another, so the above commands can be mixed and matched, and equivalent short options are available.

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.pex

Then tox -e package will produce a relocatable 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:

$ tox

If you don’t have tox, you can generate a pex of tox:

$ pex tox -c tox -o ~/bin/tox

Tox provides many useful commands and options, explained at https://tox.wiki/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 commands.

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-run

To run MyPy:

$ tox -e typecheck

All of our tox test environments allow passthrough arguments, which can be helpful to run specific tests:

$ tox -e py37-integration -- -k test_reproducible_build

To run Pex from source, rather than through what is on your PATH, invoke via Python:

$ python -m pex

Contributing

To contribute, follow these instructions: https://www.pantsbuild.org/docs/contributor-overview

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for benjyw from gravatar.com benjyw Avatar for John.Sirois from gravatar.com John.Sirois Avatar for wickman from gravatar.com wickman

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: Apache Software License
  • Author: The PEX developers
  • Requires: Python >=2.7, <3.12, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
Classifiers

Release history Release notifications | RSS feed

2.24.1

2.24.0

2.23.0

2.22.0

2.21.0

2.20.4

2.20.3

2.20.2

2.20.1

2.20.0

2.19.1

2.19.0

2.18.1

2.18.0

2.17.0

2.16.2

2.16.1

2.16.0

2.15.0

2.14.1

2.14.0

2.13.1

2.13.0

2.12.1

2.12.0

2.11.0

2.10.1

2.10.0

2.9.0

2.8.1

2.8.0

2.7.0

2.6.3

2.6.2 yanked

Reason this release was yanked:

Neither the pex.pdf nor the Pex PEX were released at https://github.com/pex-tool/pex/releases. Please use 2.6.3 which is a re-release of the same code.

2.6.1 yanked

Reason this release was yanked:

Neither the pex.pdf nor the Pex PEX were released at https://github.com/pex-tool/pex/releases. Please us 2.6.2 which is a re-release of the same code.

2.6.0

2.5.0

2.4.1

2.4.0

2.3.3

2.3.2

2.3.1

2.3.0

2.2.2

2.2.1

2.2.0

2.1.164

2.1.163

2.1.162

2.1.161

2.1.160

2.1.159

2.1.158

2.1.157

2.1.156

2.1.155

2.1.154

2.1.153

2.1.152

2.1.151

2.1.150

2.1.149

2.1.148

2.1.147

2.1.146

2.1.145

2.1.144

2.1.143

2.1.142

2.1.141

2.1.140

2.1.139

2.1.138

2.1.137

2.1.136

This version

2.1.135

2.1.134

2.1.133

2.1.132

2.1.131

2.1.130

2.1.129

2.1.128

2.1.127

2.1.126

2.1.125

2.1.124

2.1.123

2.1.122

2.1.121

2.1.120

2.1.119

2.1.118

2.1.117

2.1.116

2.1.115

2.1.114

2.1.113

2.1.112

2.1.111

2.1.110

2.1.109

2.1.108

2.1.107

2.1.106

2.1.105

2.1.104

2.1.103

2.1.102

2.1.101

2.1.100

2.1.99

2.1.98

2.1.97

2.1.96

2.1.95

2.1.94

2.1.93

2.1.92

2.1.91

2.1.90

2.1.89

2.1.88

2.1.87

2.1.86

2.1.85

2.1.84

2.1.83

2.1.82

2.1.81

2.1.80

2.1.79

2.1.78

2.1.77

2.1.76

2.1.75

2.1.74

2.1.73

2.1.72

2.1.71

2.1.70

2.1.69

2.1.68

2.1.67

2.1.66

2.1.65

2.1.64

2.1.63

2.1.62

2.1.61

2.1.60

2.1.59

2.1.58

2.1.57

2.1.56

2.1.55

2.1.54

2.1.53

2.1.52

2.1.51

2.1.50

2.1.49

2.1.48

2.1.47

2.1.46

2.1.45

2.1.44

2.1.43

2.1.42

2.1.41

2.1.40

2.1.39

2.1.38

2.1.37

2.1.36

2.1.35

2.1.34

2.1.33

2.1.32

2.1.31

2.1.30

2.1.29

2.1.28

2.1.27

2.1.26

2.1.25

2.1.24

2.1.23

2.1.22

2.1.21

2.1.20

2.1.19

2.1.18

2.1.17

2.1.16

2.1.15

2.1.14

2.1.13

2.1.12

2.1.11

2.1.10

2.1.9

2.1.8

2.1.7

2.1.6

2.1.5

2.1.4

2.1.3

2.1.2

2.1.1

2.1.0

2.0.3

2.0.2

2.0.1

2.0.0

1.6.12

1.6.11

1.6.10

1.6.9

1.6.8

1.6.7

1.6.6

1.6.5

1.6.4

1.6.3

1.6.2

1.6.1

1.6.0

1.5.3

1.5.2

1.5.1

1.5.0

1.4.9

1.4.8

1.4.7

1.4.6

1.4.5

1.4.4

1.4.3

1.4.2

1.4.1

1.4.0

1.3.2

1.3.1

1.3.0

1.2.16

1.2.15

1.2.14

1.2.13

1.2.12

1.2.11

1.2.10

1.2.9

1.2.8

1.2.7

1.2.6

1.2.5

1.2.4

1.2.3

1.2.2

1.2.1

1.2.0

1.1.20

1.1.19

1.1.18

1.1.17

1.1.16

1.1.15

1.1.14

1.1.13

1.1.12

1.1.11

1.1.10

1.1.9

1.1.8

1.1.7

1.1.6

1.1.5

1.1.4

1.1.3

1.1.2

1.1.1

1.1.0

1.0.3

1.0.2

1.0.1

1.0.0

1.0.0.dev3 pre-release

1.0.0.dev0 pre-release

0.9.0

0.8.6

0.8.5

0.8.4

0.8.3

0.8.2

0.8.1

0.8.0

0.7.0

0.1.0

Download files

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

Source Distribution

pex-2.1.135.tar.gz (3.9 MB view details)

Uploaded Source

Built Distribution

pex-2.1.135-py2.py3-none-any.whl (2.9 MB view details)

Uploaded Python 2 Python 3

File details

Details for the file pex-2.1.135.tar.gz.

File metadata

  • Download URL: pex-2.1.135.tar.gz
  • Upload date:
  • Size: 3.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/4.0.1 CPython/3.11.3

File hashes

Hashes for pex-2.1.135.tar.gz
Algorithm Hash digest
SHA256 87a9eff7522423eebe70b1d2f026309bdb5d75b8e238e5ac764d7ed7b3eeb6f5
MD5 6fb111e5d43096197935187bbf0c64c8
BLAKE2b-256 35eeaf772c967c288e3175a9b37e226543778c7215dc06da2c920b9c5b91123b

See more details on using hashes here.

File details

Details for the file pex-2.1.135-py2.py3-none-any.whl.

File metadata

  • Download URL: pex-2.1.135-py2.py3-none-any.whl
  • Upload date:
  • Size: 2.9 MB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/4.0.1 CPython/3.11.3

File hashes

Hashes for pex-2.1.135-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 bd3a8c500d11b439d0a42b3b117413a1e133d0ee1b6b2c61ec6e44e86b53fe6f
MD5 1341df2577d94ecfa70f84eb85f2b899
BLAKE2b-256 4090b260cbedb249fd24e733d524f7d6f85052b45f07c5e6cf0c7bc28058c4e4

See more details on using hashes here.

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