pex


Namepex JSON
Version 2.3.0 PyPI version JSON
download
home_pageNone
SummaryThe PEX packaging toolchain.
upload_time2024-03-28 21:04:53
maintainerNone
docs_urlNone
authorNone
requires_python!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,<3.13,>=2.7
licenseNone
keywords executable freeze lock package virtualenv
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ***
PEX
***
.. image:: https://github.com/pex-tool/pex/workflows/CI/badge.svg?branch=main
    :target: https://github.com/pex-tool/pex/actions?query=branch%3Amain+workflow%3ACI
.. image:: https://img.shields.io/pypi/l/pex.svg
    :target: https://pypi.org/project/pex/
.. image:: https://img.shields.io/pypi/v/pex.svg
    :target: https://pypi.org/project/pex/
.. image:: https://img.shields.io/pypi/pyversions/pex.svg
    :target: https://pypi.org/project/pex/
.. image:: https://img.shields.io/pypi/wheel/pex.svg
    :target: https://pypi.org/project/pex/#files

.. contents:: **Contents**

Overview
========
pex is a library for generating .pex (Python EXecutable) files which are
executable Python environments in the spirit of `virtualenvs <http://virtualenv.org>`_.
pex is an expansion upon the ideas outlined in
`PEP 441 <https://peps.python.org/pep-0441/>`_
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
<http://pantsbuild.org/>`_, `Buck <http://facebook.github.io/buck/>`_, and  `{py}gradle <https://github.com/linkedin/pygradle>`_  also
support building .pex files directly.

Still unsure about what pex does or how it works?  Watch this quick lightning
talk: `WTF is PEX? <http://www.youtube.com/watch?v=NmpnGhRwsu0>`_.

pex is licensed under the Apache2 license.


Installation
============

To install pex, simply

.. code-block:: bash

    $ pip install pex

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

.. code-block:: bash

    $ 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:

.. code-block:: bash

    $ pex requests flask 'psutil>2,<3'

Save Dependencies From Pip
~~~~~~~~~~~~~~~~~~~~~~~~~~

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

.. code-block:: bash

    $ 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:

.. code-block:: bash

    $ pex flask -- webserver.py

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

.. code-block:: bash

    $ 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:

.. code-block:: bash

    $ 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:

.. code-block:: bash

    $ 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``:

.. code-block:: 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://docs.pex-tool.org.


Development
===========

Pex uses `tox <https://tox.wiki/en/latest/>`_ for test and development automation. To run
the test suite, just invoke tox:

.. code-block:: bash

    $ tox

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

.. code-block::

    $ 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:

.. code-block::

    $ tox -e fmt

To run MyPy:

.. code-block::

    $ tox -e check

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

.. code-block::

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

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

.. code-block::

    $ python -m pex


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "pex",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,<3.13,>=2.7",
    "maintainer_email": null,
    "keywords": "executable, freeze, lock, package, virtualenv",
    "author": null,
    "author_email": "The PEX developers <developers@pex-tool.org>",
    "download_url": "https://files.pythonhosted.org/packages/a9/69/68a5301623566d11b24f1c271e56d08c846604758c27ed0a3a38b08f726d/pex-2.3.0.tar.gz",
    "platform": null,
    "description": "***\nPEX\n***\n.. image:: https://github.com/pex-tool/pex/workflows/CI/badge.svg?branch=main\n    :target: https://github.com/pex-tool/pex/actions?query=branch%3Amain+workflow%3ACI\n.. image:: https://img.shields.io/pypi/l/pex.svg\n    :target: https://pypi.org/project/pex/\n.. image:: https://img.shields.io/pypi/v/pex.svg\n    :target: https://pypi.org/project/pex/\n.. image:: https://img.shields.io/pypi/pyversions/pex.svg\n    :target: https://pypi.org/project/pex/\n.. image:: https://img.shields.io/pypi/wheel/pex.svg\n    :target: https://pypi.org/project/pex/#files\n\n.. contents:: **Contents**\n\nOverview\n========\npex is a library for generating .pex (Python EXecutable) files which are\nexecutable Python environments in the spirit of `virtualenvs <http://virtualenv.org>`_.\npex is an expansion upon the ideas outlined in\n`PEP 441 <https://peps.python.org/pep-0441/>`_\nand makes the deployment of Python applications as simple as ``cp``.  pex files may even\ninclude multiple platform-specific Python distributions, meaning that a single pex file\ncan be portable across Linux and OS X.\n\npex files can be built using the ``pex`` tool.  Build systems such as `Pants\n<http://pantsbuild.org/>`_, `Buck <http://facebook.github.io/buck/>`_, and  `{py}gradle <https://github.com/linkedin/pygradle>`_  also\nsupport building .pex files directly.\n\nStill unsure about what pex does or how it works?  Watch this quick lightning\ntalk: `WTF is PEX? <http://www.youtube.com/watch?v=NmpnGhRwsu0>`_.\n\npex is licensed under the Apache2 license.\n\n\nInstallation\n============\n\nTo install pex, simply\n\n.. code-block:: bash\n\n    $ pip install pex\n\nYou can also build pex in a git clone using tox:\n\n.. code-block:: bash\n\n    $ tox -e package\n    $ cp dist/pex ~/bin\n\nThis builds a pex binary in ``dist/pex`` that can be copied onto your ``$PATH``.\nThe advantage to this approach is that it keeps your Python environment as empty as\npossible and is more in-line with what pex does philosophically.\n\n\nSimple Examples\n===============\n\nLaunch an interpreter with ``requests``, ``flask`` and ``psutil`` in the environment:\n\n.. code-block:: bash\n\n    $ pex requests flask 'psutil>2,<3'\n\nSave Dependencies From Pip\n~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nOr instead freeze your current virtualenv via requirements.txt and execute it anywhere:\n\n.. code-block:: bash\n\n    $ pex $(pip freeze) -o my_virtualenv.pex\n    $ deactivate\n    $ ./my_virtualenv.pex\n\nEphemeral Environments\n~~~~~~~~~~~~~~~~~~~~~~\n\nRun webserver.py in an environment containing ``flask`` as a quick way to experiment:\n\n.. code-block:: bash\n\n    $ pex flask -- webserver.py\n\nLaunch Sphinx in an ephemeral pex environment using the Sphinx entry point ``sphinx:main``:\n\n.. code-block:: bash\n\n    $ pex sphinx -e sphinx:main -- --help\n\nUsing Entry Points\n~~~~~~~~~~~~~~~~~~\n\nProjects specifying a ``console_scripts`` entry point in their configuration\ncan build standalone executables for those entry points.\n\nTo build a standalone ``pex-tools-executable.pex`` binary that runs the\n``pex-tools`` console script found in all pex version ``2.1.35`` and newer distributions:\n\n.. code-block:: bash\n\n    $ pex \"pex>=2.1.35\" --console-script pex-tools --output-file pex-tools-executable.pex\n\nSpecifying A Specific Interpreter\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nYou can also build pex files that use a specific interpreter type:\n\n.. code-block:: bash\n\n    $ pex \"pex>=2.1.35\" -c pex-tools --python=pypy -o pex-tools-pypy-executable.pex\n\nMost pex options compose well with one another, so the above commands can be\nmixed and matched, and equivalent short options are available.\n\nFor a full list of options, just type ``pex --help``.\n\n\nIntegrating pex into your workflow\n==================================\n\nIf you use tox (and you should!), a simple way to integrate pex into your\nworkflow is to add a packaging test environment to your ``tox.ini``:\n\n.. code-block:: ini\n\n    [testenv:package]\n    deps = pex\n    commands = pex . -o dist/app.pex\n\nThen ``tox -e package`` will produce a relocatable copy of your application\nthat you can copy to staging or production environments.\n\n\nDocumentation\n=============\n\nMore documentation about Pex, building .pex files, and how .pex files work\nis available at https://docs.pex-tool.org.\n\n\nDevelopment\n===========\n\nPex uses `tox <https://tox.wiki/en/latest/>`_ for test and development automation. To run\nthe test suite, just invoke tox:\n\n.. code-block:: bash\n\n    $ tox\n\nIf you don't have tox, you can generate a pex of tox:\n\n.. code-block::\n\n    $ pex tox -c tox -o ~/bin/tox\n\nTox provides many useful commands and options, explained at https://tox.wiki/en/latest/ .\nBelow, we provide some of the most commonly used commands used when working on Pex, but the\ndocs are worth acquainting yourself with to better understand how Tox works and how to do more\nadvanced commands.\n\nTo run a specific environment, identify the name of the environment you'd like to invoke by\nrunning ``tox --listenvs-all``, then invoke like this:\n\n.. code-block::\n\n    $ tox -e fmt\n\nTo run MyPy:\n\n.. code-block::\n\n    $ tox -e check\n\nAll of our tox test environments allow passthrough arguments, which can be helpful to run\nspecific tests:\n\n.. code-block::\n\n    $ tox -e py37-integration -- -k test_reproducible_build\n\nTo run Pex from source, rather than through what is on your PATH, invoke via Python:\n\n.. code-block::\n\n    $ python -m pex\n\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "The PEX packaging toolchain.",
    "version": "2.3.0",
    "project_urls": {
        "Changelog": "https://github.com/pex-tool/pex/blob/v2.3.0/CHANGES.md",
        "Documentation": "https://docs.pex-tool.org/",
        "Download": "https://github.com/pex-tool/pex/releases/download/v2.3.0/pex",
        "Homepage": "https://github.com/pex-tool/pex",
        "Source": "https://github.com/pex-tool/pex/tree/v2.3.0"
    },
    "split_keywords": [
        "executable",
        " freeze",
        " lock",
        " package",
        " virtualenv"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e61c5e613559590ba9e0ebc74d029424afb908d9107d4a4091f2acb84f0e6a7a",
                "md5": "1a98006caf4d21ed764f568d796c5b15",
                "sha256": "6c0ccbaa99fe15174fb1560c01ba0416579a057eed7ac90453324b18356f9b40"
            },
            "downloads": -1,
            "filename": "pex-2.3.0-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "1a98006caf4d21ed764f568d796c5b15",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,<3.13,>=2.7",
            "size": 3375409,
            "upload_time": "2024-03-28T21:04:50",
            "upload_time_iso_8601": "2024-03-28T21:04:50.106025Z",
            "url": "https://files.pythonhosted.org/packages/e6/1c/5e613559590ba9e0ebc74d029424afb908d9107d4a4091f2acb84f0e6a7a/pex-2.3.0-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "a96968a5301623566d11b24f1c271e56d08c846604758c27ed0a3a38b08f726d",
                "md5": "2028eb6d3cd7263b14b29cca41ac6e9a",
                "sha256": "7d0fc86236192fbc14a71b25081e9c48c543d7dbc1e7b270d62eff88afd2245c"
            },
            "downloads": -1,
            "filename": "pex-2.3.0.tar.gz",
            "has_sig": false,
            "md5_digest": "2028eb6d3cd7263b14b29cca41ac6e9a",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,<3.13,>=2.7",
            "size": 4159727,
            "upload_time": "2024-03-28T21:04:53",
            "upload_time_iso_8601": "2024-03-28T21:04:53.949171Z",
            "url": "https://files.pythonhosted.org/packages/a9/69/68a5301623566d11b24f1c271e56d08c846604758c27ed0a3a38b08f726d/pex-2.3.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-03-28 21:04:53",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "pex-tool",
    "github_project": "pex",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "tox": true,
    "lcname": "pex"
}
        
Elapsed time: 0.23546s