- For activation scripts always use UNIX line endings (unless it's BATCH shell related) - by :user:`saytosid`. (#1818)
- Upgrade embedded pip to
20.2.1
and setuptools to49.4.0
- by :user:`gaborbernat`. (#1918) - Avoid spawning new windows when doing seed package upgrades in the background on Windows - by :user:`gaborbernat`. (#1928)
- Fix a bug that reading and writing on the same file may cause race on multiple processes. (#1938)
- Upgrade embedded setuptools to
50.2.0
and pip to20.2.3
- by :user:`gaborbernat`. (#1939) - Provide correct path for bash activator in cygwin or msys2 - by :user:`danyeaw`. (#1940)
- Relax importlib requirement to allow version<3 - by :user:`usamasadiq` (#1953)
- pth files were not processed on CPython2 if $PYTHONPATH was pointing to site-packages/ - by :user:`navytux`. (#1959) (#1960)
- Upgrade embedded pip to
20.2.1
, setuptools to49.6.0
and wheel to0.35.1
- by :user:`gaborbernat`. (#1918)
- Upgrade pip to
20.2.1
and setuptools to49.2.1
- by :user:`gaborbernat`. (#1915)
- Upgrade embedded pip from version
20.1.2
to20.2
- by :user:`gaborbernat`. (#1909)
- Fix test suite failing if run from system Python - by :user:`gaborbernat`. (#1882)
- Provide
setup_logging
flag to python API so that users can bypass logging handling if their application already performs this - by :user:`gaborbernat`. (#1896) - Use
\n
instead if\r\n
as line separator for report (because Python already performs this transformation automatically upon write to the logging pipe) - by :user:`gaborbernat`. (#1905)
- No longer preimport threading to fix support for gpython and gevent - by :user:`navytux`. (#1897)
- Upgrade setuptools from
49.2.0
onPython 3.5+
- by :user:`gaborbernat`. (#1898)
Bump dependency
distutils >= 0.3.1
- by :user:`gaborbernat`. (#1880)Improve periodic update handling:
- better logging output while running and enable logging on background process call (
_VIRTUALENV_PERIODIC_UPDATE_INLINE
may be used to debug behaviour inline) - fallback to unverified context when querying the PyPi for release date,
- stop downloading wheels once we reach the embedded version,
by :user:`gaborbernat`. (#1883)
- better logging output while running and enable logging on background process call (
Do not print error message if the application exists with
SystemExit(0)
- by :user:`gaborbernat`. (#1885)Upgrade embedded setuptools from
47.3.1
to49.1.0
for Python3.5+
- by :user:`gaborbernat`. (#1887)
- Fix that when the
app-data
seeders image creation fails the exception is silently ignored. Avoid two virtual environment creations to step on each others toes by using a lock while creating the base images. By :user:`gaborbernat`. (#1869)
Ensure that the seeded packages do not get too much out of date:
- add a CLI flag that triggers upgrade of embedded wheels under :option:`upgrade-embed-wheels`
- periodically (once every 14 days) upgrade the embedded wheels in a background process, and use them if they have been released for more than 28 days (can be disabled via :option:`no-periodic-update`)
More details under :ref:`wheels` - by :user:`gaborbernat`. (#1821)
Upgrade embed wheel content:
- ship wheels for Python
3.9
and3.10
- upgrade setuptools for Python
3.5+
from47.1.1
to47.3.1
by :user:`gaborbernat`. (#1841)
- ship wheels for Python
Display the installed seed package versions in the final summary output, for example:
created virtual environment CPython3.8.3.final.0-64 in 350ms creator CPython3Posix(dest=/x, clear=True, global=False) seeder FromAppData(download=False, pip=bundle, setuptools=bundle, wheel=bundle, via=copy, app_data_dir=/y/virtualenv) added seed packages: pip==20.1.1, setuptools==47.3.1, wheel==0.34.2
by :user:`gaborbernat`. (#1864)
- Do not generate/overwrite
.gitignore
if it already exists at destination path - by :user:`gaborbernat`. (#1862) - Improve error message for no
.dist-info
inside theapp-data
copy seeder - by :user:`gaborbernat`. (#1867)
- How seeding mechanisms discover (and automatically keep it up to date) wheels at :ref:`wheels` - by :user:`gaborbernat`. (#1821)
- How distributions should handle shipping their own embedded wheels at :ref:`distribution_wheels` - by :user:`gaborbernat`. (#1840)
- Fix typo in
setup.cfg
- by :user:`RowdyHowell`. (#1857)
- Relax
importlib.resources
requirement to also allow version 2 - by :user:`asottile`. (#1846) - Upgrade embedded setuptools to
44.1.1
for python 2 and47.1.1
for python3.5+ - by :user:`gaborbernat`. (#1855)
- Generate ignore file for version control systems to avoid tracking virtual environments by default. Users should remove these files if still want to track. For now we support only git by :user:`gaborbernat`. (#1806)
- Fix virtualenv fails sometimes when run concurrently,
--clear-app-data
conflicts with :option:`clear` flag when abbreviation is turned on. To bypass this while allowing abbreviated flags on the command line we had to move it to :option:`reset-app-data` - by :user:`gaborbernat`. (#1824) - Upgrade embedded
setuptools
to46.4.0
from46.1.3
on Python3.5+
, andpip
from20.1
to20.1.1
- by :user:`gaborbernat`. (#1827) - Seeder pip now correctly handles
--extra-search-dir
- by :user:`frenzymadness`. (#1834)
- Fix download fails with python 3.4 - by :user:`gaborbernat`. (#1809)
- Fixes older CPython2 versions use
_get_makefile_filename
instead ofget_makefile_filename
onsysconfig
- by :user:`ianw`. (#1810) - Fix download is
True
by default - by :user:`gaborbernat`. (#1813) - Fail
app-data
seed operation when wheel download fails and better error message - by :user:`gaborbernat`. (#1814)
- Fix generating a Python 2 environment from Python 3 creates invalid python activator - by :user:`gaborbernat`. (#1776)
- Fix pinning seed packages via
app-data
seeder raisedInvalid Requirement
- by :user:`gaborbernat`. (#1779) - Do not stop interpreter discovery if we fail to find the system interpreter for a executable during discovery - by :user:`gaborbernat`. (#1781)
- On CPython2 POSIX platforms ensure
syconfig.get_makefile_filename
exists within the virtual environment (this is used by some c-extension based libraries - e.g. numpy - for building) - by :user:`gaborbernat`. (#1783) - Better handling of options :option:`copies` and :option:`symlinks`. Introduce priority of where the option is set to follow the order: CLI, env var, file, hardcoded. If both set at same level prefers copy over symlink. - by :user:`gaborbernat`. (#1784)
- Upgrade pip for Python
2.7
and3.5+
from20.0.2
to20.1
- by :user:`gaborbernat`. (#1793) - Fix CPython is not discovered from Windows registry, and discover pythons from Windows registry in decreasing order by version - by :user:`gaborbernat`. (#1796)
- Fix symlink detection for creators - by :user:`asottile` (#1803)
- Importing setuptools before cli_run could cause our python information query to fail due to setuptools patching
distutils.dist.Distribution
- by :user:`gaborbernat`. (#1771)
- Extend environment variables checked for configuration to also check aliases (e.g. setting either
VIRTUALENV_COPIES
orVIRTUALENV_ALWAYS_COPY
will work) - by :user:`gaborbernat`. (#1763)
- Allow seed wheel files inside the :option:`extra-search-dir` folders that do not have
Requires-Python
metadata specified, these are considered compatible with all python versions - by :user:`gaborbernat`. (#1757)
- Upgrade embedded setuptools to
46.1.3
from46.1.1
- by :user:`gaborbernat`. (#1752)
- Remove
__PYVENV_LAUNCHER__
on macOs for Python3.7.(<8)
and3.8.(<3)
on interpreter startup viapth
file, this pulls in the upstream patch - by :user:`gaborbernat`. (#1704) - Upgrade embedded setuptools for Python
3.5+
to46.1.1
, for Python2.7
to44.1.0
- by :user:`gaborbernat`. (#1745)
- Fix discovery of interpreter by name from
PATH
that does not match a spec format - by :user:`gaborbernat`. (#1746)
- Do not fail when the pyc files is missing for the host Python 2 - by :user:`gaborbernat`. (#1738)
- Support broken Packaging pythons that put the include headers under distutils pattern rather than sysconfig one - by :user:`gaborbernat`. (#1739)
- Fix relative path discovery of interpreters - by :user:`gaborbernat`. (#1734)
- Improve error message when the host python does not satisfy invariants needed to create virtual environments (now we print which host files are incompatible/missing and for which creators when no supported creator can be matched, however we found creators that can describe the given Python interpreter - will still print no supported creator for Jython, however print exactly what host files do not allow creation of virtual environments in case of CPython/PyPy) - by :user:`gaborbernat`. (#1716)
- Support Python 3 Framework distributed via XCode in macOs Catalina and before - by :user:`gaborbernat`. (#1663)
- Fix Windows Store Python support, do not allow creation via symlink as that's not going to work by design - by :user:`gaborbernat`. (#1709)
- Fix
activate_this.py
throwsAttributeError
on Windows when virtual environment was created via cross python mechanism - by :user:`gaborbernat`. (#1710) - Fix
--no-pip
,--no-setuptools
,--no-wheel
not being respected - by :user:`gaborbernat`. (#1712) - Allow missing
.py
files if a compiled.pyc
version is available - by :user:`tucked`. (#1714) - Do not fail if the distutils/setuptools patch happens on a C-extension loader (such as
zipimporter
on Python 3.7 or earlier) - by :user:`gaborbernat`. (#1715) - Support Python 2 implementations that require the landmark files and
site.py
to be in platform standard library instead of the standard library path of the virtual environment (notably some RHEL ones, such as the Docker imageamazonlinux:1
) - by :user:`gaborbernat`. (#1719) - Allow the test suite to pass even when called with the system Python - to help repackaging of the tool for Linux distributions - by :user:`gaborbernat`. (#1721)
- Also generate
pipx.y
console script besidepip-x.y
to be compatible with how pip installs itself - by :user:`gaborbernat`. (#1723) - Automatically create the application data folder if it does not exists - by :user:`gaborbernat`. (#1728)
- :ref:`supports <compatibility-requirements>` details now explicitly what Python installations we support - by :user:`gaborbernat`. (#1714)
- Fix acquiring python information might be altered by distutils configuration files generating incorrect layout virtual environments - by :user:`gaborbernat`. (#1663)
- Upgrade embedded setuptools to
46.0.0
from45.3.0
on Python3.5+
- by :user:`gaborbernat`. (#1702)
- Document requirements (pip + index server) when installing via pip under the installation section - by :user:`gaborbernat`. (#1618)
- Document installing from non PEP-518 systems - :user:`gaborbernat`. (#1619)
- Document installing latest unreleased version from Github - :user:`gaborbernat`. (#1620)
pythonw.exe
works aspython.exe
on Windows - by :user:`gaborbernat`. (#1686)- Handle legacy loaders for virtualenv import hooks used to patch distutils configuration load - by :user:`gaborbernat`. (#1690)
- Support for python 2 platforms that store landmark files in
platstdlib
overstdlib
(e.g. RHEL) - by :user:`gaborbernat`. (#1694) - Upgrade embedded setuptools to
45.3.0
from45.2.0
for Python3.5+
- by :user:`gaborbernat`. (#1699)
- Having distutils configuration
files that set
prefix
andinstall_scripts
cause installation of packages in the wrong location - by :user:`gaborbernat`. (#1663) - Fix
PYTHONPATH
being overridden on Python 2 — by :user:`jd`. (#1673) - Fix list configuration value parsing from config file or environment variable - by :user:`gaborbernat`. (#1674)
- Fix Batch activation script shell prompt to display environment name by default - by :user:`spetafree`. (#1679)
- Fix startup on Python 2 is slower for virtualenv - this was due to setuptools calculating it's working set distribution - by :user:`gaborbernat`. (#1682)
- Fix entry points are not populated for editable installs on Python 2 due to setuptools working set being calculated
before
easy_install.pth
runs - by :user:`gaborbernat`. (#1684) - Fix
attr:
import fails for setuptools - by :user:`gaborbernat`. (#1685)
- Disable distutils fixup for python 3 until pypa/pip #7778 is fixed and released - by :user:`gaborbernat`. (#1669)
Fix global site package always being added with bundled macOs python framework builds - by :user:`gaborbernat`. (#1561)
Fix generated scripts use host version info rather than target - by :user:`gaborbernat`. (#1600)
Fix circular prefix reference with single elements (accept these as if they were system executables, print a info about them referencing themselves) - by :user:`gaborbernat`. (#1632)
Handle the case when the application data folder is read-only:
- the application data folder is now controllable via :option:`app-data`,
clear-app-data
now cleans the entire application data folder, not just theapp-data
seeder path,- check if the application data path passed in does not exist or is read-only, and fallback to a temporary directory,
- temporary directory application data is automatically cleaned up at the end of execution,
- :option:`symlink-app-data` is always
False
when the application data is temporary
by :user:`gaborbernat`. (#1640)
Fix PyPy 2 builtin modules are imported from standard library, rather than from builtin - by :user:`gaborbernat`. (#1652)
Fix creation of entry points when path contains spaces - by :user:`nsoranzo`. (#1660)
Fix relative paths for the zipapp (for python
3.7+
) - by :user:`gaborbernat`. (#1666)
- Also create
pythonX.X
executables when creating pypy virtualenvs - by :user:`asottile` (#1612) - Fail with better error message if trying to install source with unsupported
setuptools
, allowsetuptools-scm >= 2
and move to legacysetuptools-scm
format to support better older platforms (CentOS 7
and such) - by :user:`gaborbernat`. (#1621) - Report of the created virtual environment is now split across four short lines rather than one long - by :user:`gaborbernat` (#1641)
- Add macOs Python 2 Framework support (now we test it with the CI via brew) - by :user:`gaborbernat` (#1561)
- Fix losing of libpypy-c.so when the pypy executable is a symlink - by :user:`asottile` (#1614)
- Discover python interpreter in a case insensitive manner - by :user:`PrajwalM2212` (#1624)
- Fix cross interpreter support when the host python sets
sys.base_executable
based on__PYVENV_LAUNCHER__
- by :user:`cjolowicz` (#1643)
- When aliasing interpreters, use relative symlinks - by :user:`asottile`. (#1596)
- Allow the use of
/
as pathname component separator on Windows - byvphilippon
(#1582) - Lower minimal version of six required to 1.9 - by
ssbarnea
(#1606)
- On Python 2 with Apple Framework builds the global site package is no longer added when the :option:`system-site-packages` is not specified - by :user:`gaborbernat`. (#1561)
- Fix system python discovery mechanism when prefixes contain relative parts (e.g.
..
) by resolving paths within the python information query - by :user:`gaborbernat`. (#1583) - Expose a programmatic API as
from virtualenv import cli_run
- by :user:`gaborbernat`. (#1585) - Fix
app-data
:option:`seeder` injects a extra.dist-info.virtualenv
path that breaksimportlib.metadata
, now we inject an extra.virtualenv
- by :user:`gaborbernat`. (#1589)
- Document a programmatic API as
from virtualenv import cli_run
under :ref:`programmatic_api` - by :user:`gaborbernat`. (#1585)
- Print out a one line message about the created virtual environment when no :option:`verbose` is set, this can now be silenced to get back the original behaviour via the :option:`quiet` flag - by :user:`pradyunsg`. (#1557)
- Allow virtualenv's app data cache to be overridden by
VIRTUALENV_OVERRIDE_APP_DATA
- by :user:`asottile`. (#1559) - Passing in the virtual environment name/path is now required (no longer defaults to
venv
) - by :user:`gaborbernat`. (#1568) - Add a CLI flag :option:`with-traceback` that allows displaying the stacktrace of the virtualenv when a failure occurs - by :user:`gaborbernat`. (#1572)
Support long path names for generated virtual environment console entry points (such as
pip
) when using theapp-data
:option:`seeder` - by :user:`gaborbernat`. (#997)Improve python discovery mechanism:
- do not fail if there are executables that fail to query (e.g. for not having execute access to it) on the
PATH
, - beside the prefix folder also try with the platform dependent binary folder within that,
by :user:`gaborbernat`. (#1545)
- do not fail if there are executables that fail to query (e.g. for not having execute access to it) on the
When copying (either files or trees) do not copy the permission bits, last access time, last modification time, and flags as access to these might be forbidden (for example in case of the macOs Framework Python) and these are not needed for the user to use the virtual environment - by :user:`gaborbernat`. (#1561)
While discovering a python executables interpreters that cannot be queried are now displayed with info level rather than warning, so now they're no longer shown by default (these can be just executables to which we don't have access or that are broken, don't warn if it's not the target Python we want) - by :user:`gaborbernat`. (#1574)
The
app-data
:option:`seeder` no longer symlinks the packages on UNIX and copies on Windows. Instead by default always copies, however now has the :option:`symlink-app-data` flag allowing users to request this less robust but faster method - by :user:`gaborbernat`. (#1575)
- Add link to the legacy documentation for the changelog by :user:`jezdez`. (#1547)
- Fine tune the documentation layout: default width of theme, allow tables to wrap around, soft corners for code snippets - by :user:`pradyunsg`. (#1548)
- upgrade embedded setuptools to
45.2.0
from45.1.0
for Python3.4+
- by :user:`gaborbernat`. (#1554)
- Virtual environments created via relative path on Windows creates bad console executables - by :user:`gaborbernat`. (#1552)
- Seems sometimes venvs created set their base executable to themselves; we accept these without question, so we handle virtual environments as system pythons causing issues - by :user:`gaborbernat`. (#1553)
- Fixes typos, repeated words and inconsistent heading spacing. Rephrase parts of the development documentation and CLI
documentation. Expands shorthands like
env var
andconfig
to their full forms. Uses descriptions from respective documentation, for projects listed inrelated links
- by :user:`pradyunsg`. (#1540)
Improve base executable discovery mechanism:
- print at debug level why we refuse some candidates,
- when no candidates match exactly, instead of hard failing fallback to the closest match where the priority of matching attributes is: python implementation, major version, minor version, architecture, patch version, release level and serial (this is to facilitate things to still work when the OS upgrade replace/upgrades the system python with a never version, than what the virtualenv host python was created with),
- always resolve system_executable information during the interpreter discovery, and the discovered environment is the system interpreter instead of the venv/virtualenv (this happened before lazily the first time we accessed, and caused reporting that the created virtual environment is of type of the virtualenv host python version, instead of the system pythons version - these two can differ if the OS upgraded the system python underneath and the virtualenv host was created via copy),
by :user:`gaborbernat`. (#1515)
Generate
bash
andfish
activators on Windows too (as these can be available with git bash, cygwin or mysys2) - by :user:`gaborbernat`. (#1527)Upgrade the bundled
wheel
package from0.34.0
to0.34.2
- by :user:`gaborbernat`. (#1531)
Bash activation script should have no extensions instead of
.sh
(this fixes the :pypi:`virtualenvwrapper` integration) - by :user:`gaborbernat`. (#1508)Show less information when we run with a single verbosity (
-v
):- no longer shows accepted interpreters information (as the last proposed one is always the accepted one),
- do not display the
str_spec
attribute forPythonSpec
as these can be deduced from the other attributes, - for the
app-data
seeder do not show the type of lock, only the path to the app data directory,
By :user:`gaborbernat`. (#1510)
Fixed cannot discover a python interpreter that has already been discovered under a different path (such is the case when we have multiple symlinks to the same interpreter) - by :user:`gaborbernat`. (#1512)
Support relative paths for
-p
- by :user:`gaborbernat`. (#1514)Creating virtual environments in parallel fail with cannot acquire lock within app data - by :user:`gaborbernat`. (#1516)
pth files were not processed under Debian CPython2 interpreters - by :user:`gaborbernat`. (#1517)
Fix prompt not displayed correctly with upcoming fish 3.10 due to us not preserving
$pipestatus
- by :user:`krobelus`. (#1530)Stable order within
pyenv.cfg
and addinclude-system-site-packages
only for creators that reference a global Python - by user:gaborbernat. (#1535)
- Create the first iteration of the new documentation - by :user:`gaborbernat`. (#1465)
- Project readme is now of type MarkDown instead of reStructuredText - by :user:`gaborbernat`. (#1531)
- First public release of the rewrite. Everything is brand new and just added.
--download
defaults toFalse
Warning
The current virtualenv is the second iteration of implementation. From version 0.8
all the way to 16.7.9
we numbered the first iteration. Version 20.0.0b1
is a complete rewrite of the package, and as such this release
history starts from there. The old changelog is still available in the
legacy branch documentation.