Provided by: pex_1.5.3-1_all 

NAME
pex - pex
SYNOPSIS
pex [-o OUTPUT.PEX] [options] [-- arg1 arg2 ...]
DESCRIPTION
pex builds a PEX (Python Executable) file based on the given specifications: sources, requirements, their
dependencies and other options.
OPTIONS
--version
show program's version number and exit
-h, --help
show this help message and exit
-o PEX_NAME, --output-file=PEX_NAME
The name of the generated .pex file: Omiting this will run PEX immediately and not save it to a
file.
-p FILE, --preamble-file=FILE
The name of a file to be included as the preamble for the generated .pex file
-D DIR, --sources-directory=DIR
Add sources directory to be packaged into the generated .pex file. This option can be used
multiple times.
-R DIR, --resources-directory=DIR
Add resources directory to be packaged into the generated .pex file. This option can be used
multiple times.
-r FILE, --requirement=FILE
Add requirements from the given requirements file. This option can be used multiple times.
--constraints=FILE
Add constraints from the given constraints file. This option can be used multiple times.
-v Turn on logging verbosity, may be specified multiple times.
--pex-root=PEX_ROOT
Specify the pex root used in this invocation of pex. [Default: ~/.pex]
--help-variables
Print out help about the various environment variables used to change the behavior of a running
PEX file.
Resolver options:
Tailor how to find, resolve and translate the packages that get put into the PEX environment.
--pypi, --no-pypi, --no-index
Whether to use pypi to resolve dependencies; Default: use pypi
--pex-path=PEX_PATH
A colon separated list of other pex files to merge into the runtime environment.
-f PATH/URL, --find-links=PATH/URL, --repo=PATH/URL
Additional repository path (directory or URL) to look for requirements.
-i URL, --index=URL, --index-url=URL
Additional cheeseshop indices to use to satisfy requirements.
--pre, --no-pre
Whether to include pre-release and development versions of requirements; Default: only stable
versions are used, unless explicitly requested
--disable-cache
Disable caching in the pex tool entirely.
--cache-dir=CACHE_DIR
The local cache directory to use for speeding up requirement lookups. [Default: ~/.pex/build]
--cache-ttl=CACHE_TTL
The cache TTL to use for inexact requirement specifications.
--wheel, --no-wheel, --no-use-wheel
Whether to allow wheel distributions; Default: allow wheels
--build, --no-build
Whether to allow building of distributions from source; Default: allow builds
--manylinux, --no-manylinux, --no-use-manylinux
Whether to allow resolution of manylinux dists for linux target platforms; Default: allow
manylinux
PEX output options:
Tailor the behavior of the emitted .pex file if -o is specified.
--zip-safe, --not-zip-safe
Whether or not the sources in the pex file are zip safe. If they are not zip safe, they will be
written to disk prior to execution; Default: zip safe.
--always-write-cache
Always write the internally cached distributions to disk prior to invoking the pex source code.
This can use less memory in RAM constrained environments. [Default: False]
--ignore-errors
Ignore run-time requirement resolution errors when invoking the pex. [Default: False]
--inherit-path=INHERIT_PATH
Inherit the contents of sys.path (including sitepackages) running the pex. Possible values: false
(does not inherit sys.path), fallback (inherits sys.path after packaged dependencies), prefer
(inherits sys.path before packaged dependencies), No value (alias for prefer, for backwards
compatibility). [Default: false]
PEX environment options:
Tailor the interpreter and platform targets for the PEX environment.
--python=PYTHON
The Python interpreter to use to build the pex. Either specify an explicit path to an
interpreter, or specify a binary accessible on $PATH. This option can be passed multiple times to
create a multi-interpreter compatible pex. Default: Use current interpreter.
--interpreter-constraint=INTERPRETER_CONSTRAINT
A constraint that determines the interpreter compatibility for this pex, using the
Requirementstyle format, e.g. "CPython>=3", or ">=2.7" for requirements agnostic to interpreter
class. This option can be passed multiple times.
--rcfile=RC_FILE
An additional path to a pexrc file to read during configuration parsing. Used primarily for
testing.
--python-shebang=PYTHON_SHEBANG
The exact shebang (#!...) line to add at the top of the PEX file minus the #!. This overrides the
default behavior, which picks an environment python interpreter compatible with the one used to
build the PEX file.
--platform=PLATFORMS
The platform for which to build the PEX. This option can be passed multiple times to create a
multiplatform pex. To use wheels for specific interpreter/platform tags, you can append them to
the platform with hyphens like: PLATFORM-IMPL-PYVER-ABI (e.g. "linux_x86_64-cp-27-cp27mu",
"macosx_10.12_x86_64-cp-36-cp36m") PLATFORM is the host platform e.g. "linux-x86_64",
"macosx-10.12-x86_64", etc". IMPL is the python implementation abbreviation (e.g. "cp", "pp",
"jp"). PYVER is a two-digit string representing the python version (e.g. "27", "36"). ABI is the
ABI tag (e.g. "cp36m", "cp27mu", "abi3", "none"). Default: current platform.
--interpreter-cache-dir=INTERPRETER_CACHE_DIR
The interpreter cache to use for keeping track of interpreter dependencies for the pex tool.
Default: `~/.pex/interpreters`.
PEX entry point options:
Specify what target/module the PEX should invoke if any.
-m MODULE[:SYMBOL], -e MODULE[:SYMBOL], --entry-point=MODULE[:SYMBOL]
Set the entry point to module or module:symbol. If just specifying module, pex behaves like
python -m, e.g. python -m SimpleHTTPServer. If specifying module:symbol, pex imports that symbol
and invokes it as if it were main.
-c SCRIPT_NAME, --script=SCRIPT_NAME, --console-script=SCRIPT_NAME
Set the entry point as to the script or console_script as defined by a any of the distributions in
the pex. For example: "pex -c fab fabric" or "pex -c mturk boto".
--validate-entry-point
Validate the entry point by importing it in separate process. Warning: this could have side
effects. For example, entry point `a.b.c:m` will translate to `from a.b.c import m` during
validation. [Default: False]
pex 1.5.3-1 June 2022 PEX(1)