pex

• Bugfix: Open setup.py in binary mode.

• Bugfix: Repair a regression in --disable-cache.

• Add README and supported python versions to PyPI description.
• Use open with utf-8 support.
• Add --pex-root option.

This release is a quick fix for a regression that inadvertently went out in 1.1.5 (Issue #243).

• Fix the bdist_pex setuptools command to work for python2.
• Upgrade pex dependencies on setuptools and wheel.

• Fix PEXBuilder.clone and thus bdist_pex --pex-args for --python and --python-shebang.
• Fix old pkg_resources egg version normalization.
• Fix the inherit_path handling.
• Fix handling of bad distribution script names when used as the pex entrypoint.

This release is a quick fix for a regression that inadvertently went out in 1.1.3 (Issue #216).

• Add a test for the regression in FixedEggMetadata._zipinfo_name and revert the breaking commit.

This release includes an initial body of work towards Windows support, ABI tag support for CPython 2.x and a fix for version number normalization.

• Add python 2.x abi tag support.
• Add .idea to .gitignore.
• Don't normalize version numbers as names.
• More fixes for windows.
• Fixes to get pex to work on windows.

• Bump setuptools & wheel version pinning.
• Unescape html in PageParser.href_match_to_url.
• Memoize calls to Crawler.crawl() for performance win in find-links based resolution.

• Fix infinite recursion when PEX_PYTHON points at a symlink.
• Add /etc/pexrc to the list of pexrc locations to check.
• Improve error messaging for platform constrained Untranslateable errors.

• Add support for .pexrc files for influencing the pex environment. See the notes here.
• Bug fix: PEX_PROFILE_FILENAME and PEX_PROFILE_SORT were not respected.
• Adds the bdist_pex command to setuptools.
• Bug fix: We did not normalize package names in ResolvableSet, so it was possible to depend on sphinx and Sphinx-1.4a0.tar.gz and get two versions build and included into the pex.
• Adds a pex-identifying User-Agent.

• Bug fix: Accommodate OSX Python python binaries. Previously the OSX python distributions shipped with OSX, XCode and available via https://www.python.org/downloads/ could fail to be detected using the PythonInterpreter class. Fixes
• Bug fix: PEX_SCRIPT failed when the script was from a not-zip-safe egg.
• Bug fix: sys.exit called without arguments would cause None to be printed on stderr since pex 1.0.1.

• Bug fix: PEX-INFO values were overridden by environment Variables with default values that were not explicitly set in the environment. Fixes #135.
• Bug fix: Since 69649c1 we have been un-patching the side effects of sys.modules after PEX.execute. This takes all modules imported during the PEX lifecycle and sets all their attributes to None. Unfortunately, sys.excepthook, atexit and __del__ may still try to operate using these tainted modules, causing exceptions on interpreter teardown. This reverts just the sys un-patching so that the above-mentioned teardown hooks behave more predictably.

• Allow PEXBuilder to optionally copy files into the PEX environment instead of hard-linking them.
• Allow PEXBuilder to optionally skip pre-compilation of .py files into .pyc files.
• Bug fix: PEXBuilder did not respect the target interpreter when compiling source to bytecode.
• Bug fix: Fix complex resolutions when using a cache.

The 1.0.0 release of pex introduces a few breaking changes: pex -r now takes requirements.txt files instead of requirement specs, pex -s has now been removed since source specs are accepted as arguments, and pex -p has been removed in favor of its alias pex -o.

The pex command line interface now adheres to semver insofar as backwards incompatible CLI changes will invoke a major version change. Any backwards incompatible changes to the PEX environment variable semantics will also result in a major version change. The pex API adheres to semver insofar as backwards incompatible API changes will invoke minor version changes.

For users of the PEX API, it is recommended to add minor version ranges, e.g. pex>=1.0,<1.1. For users of the PEX CLI, major version ranges such as pex>=1,<2 should be sufficient.

• BREAKING CHANGE: Removes the -s option in favor of specifying directories directly as arguments to the pex command line.
• BREAKING CHANGE: pex -r now takes requirements.txt filenames and not requirement specs. Requirement specs are now passed as arguments to the pex tool. Use -- to escape command line arguments passed to interpreters spawned by pex.
• Adds a number of flag aliases to be more compatible with pip command lines: --no-index, -f, --find-links, --index-url, --no-use-wheel. Removes -p in favor of -o exclusively.
• Adds --python-shebang option to the pex tool in order to set the #! shebang to an exact path.
• Adds support for PEX_PYTHON environment variable which will cause the pex file to re-invoke itself using the interpreter specified, e.g. PEX_PYTHON=python3.4 or PEX_PYTHON=/exact/path/to/interpreter.
• Adds support for PEX_PATH environment variable which allows merging of PEX environments at runtime. This can be used to inject plugins or entry_points or modules from one PEX into another without explicitly building them together.
• Consolidates documentation of PEX_ environment variables and adds the --help-variables option to the pex client.
• Adds helper method to dump a package subdirectory onto disk from within a zipped PEX file. This can be useful for applications that know they're running within a PEX and would prefer some static assets dumped to disk instead of running as an unzipped PEX file.
• Now supports extras for static URLs and installable directories.
• Adds -m and --entry-point alias to the existing -e option for entry points in the pex tool to evoke the similarity to python -m.
• Adds console script support via -c/--script/--console-script and PEX_SCRIPT. This allows you to reference the named entry point instead of the exact module:name pair. Also supports scripts defined in the scripts section of setup.py.
• Adds more debugging information when encountering unresolvable requirements.
• Bug fix: PEX_COVERAGE and PEX_PROFILE did not function correctly when SystemExit was raised.
• Bug fix: Fixes caching in the PEX tool since we don't cache the source distributions of installable directories.

This is the last release before the 1.0.0 development branch is started.

• Change the setuptools range to >=2.2,<16 by handling EntryPoint changes as well as being flexible on whether pkg_resources is a package or a module.
• Adds option groups to the pex tool to make the help output slightly more readable.
• Bug fix: Make pip install pex work better by removing extras_requires on the console_script entry point.
• New feature: Adds an interpreter cache to the pex tool. If the user does not explicitly disable the wheel feature and attempts to build a pex with wheels but does not have the wheel package installed, pex will download it in order to make the feature work.

• Bug fix: Honor installed sys.excepthook in pex teardown.
• Bug fix: UrllibContext used replace as a keyword argument for bytes.decode but this only works on Python 3.

• Bug fix: Fixup string formatting in pex/bin/pex.py to support Python 2.6

• Performance improvement: Speed up the best-case scenario of dependency resolution.
• Bug fix: Change from uuid4().get_hex() to uuid4().hex to maintain Python3 compatibility of pex.common.
• Bug fix: Actually cache the results of translation. Previously bdist translations would be created in a temporary directory even if a cache location was specified.
• Bug fix: Support all potential abi tag permutations when determining platform compatibility.

• Performance improvement: Don't always write packages to disk if they've already been cached. This can significantly speed up launching PEX files with a large number of non-zip-safe dependencies.

• Bug fix: Allow pex 0.8.x to parse pex files produced by earlier versions of pex and twitter.common.python.
• Pin pex to setuptools prior to 9.x until we have a chance to make changes related to PEP440 and the change of pkg_resources.py to a package.

• Bug fix: Fix issue where it'd be possible to os.path.getmtime on a remote Link object

• API change: Decouple translation from package iteration. This removes the Obtainer construct entirely, which likely means if you're using PEX as a library, you will need to change your code if you were doing anything nontrivial. This adds a couple new options to resolve but simplifies the story around how to cache packages.
• Refactor http handling in pex to allow for alternate http implementations. Adds support for requests, improving both performance and security. For more information, read the commit notes at 91c7f32.
• Improvements to API documentation throughout.
• Renamed Tracer to TraceLogger to prevent nondeterministic isort ordering.
• Refactor tox.ini to increase the number of environment combinations and improve coverage.
• Adds HTTP retry support for the RequestsContext.
• Make pex --version correct.
• Bug fix: Fix over-aggressive sys.modules scrubbing for namespace packages. Under certain circumstances, namespace packages in site-packages could conflict with packages within a PEX, causing them to fail importing.
• Bug fix: Replace uses of os.unsetenv(...) with del os.environ[...]
• Bug fix: Scrub sys.path and sys.modules based upon both supplied path and realpath of files and directories. Newer versions of virtualenv on Linux symlink site-packages which caused those packages to not be removed from sys.path correctly.
• Bug fix: The pex -s option was not correctly pulling in transitive dependencies.
• Bug fix: Adds content method to HTTP contexts that does HTML content decoding, fixing an encoding issue only experienced when using Python 3.

• Rename twitter.common.python to pex and split out from the twitter/commons repo.

• Initial published version of twitter.common.python.