Release History

v20.26.0 (2024-04-23)

Bugfixes - 20.26.0

  • allow builtin discovery to discover specific interpreters (e.g. python3.12) given an unspecific spec (e.g. python3) - by @flying-sheep. (#2709)

v20.25.3 (2024-04-17)

Bugfixes - 20.25.3

  • Python 3.13.0a6 renamed pathmod to parser. (#2702)

v20.25.2 (2024-04-16)

Bugfixes - 20.25.2

  • Upgrade embedded wheels:

    • setuptools of 69.1.0 to 69.5.1

    • wheel of 0.42.0 to 0.43.0 (#2699)

v20.25.1 (2024-02-21)

Bugfixes - 20.25.1

  • Upgrade embedded wheels:

    • setuptools to 69.0.3 from 69.0.2

    • pip to 23.3.2 from 23.3.1 (#2681)

  • Upgrade embedded wheels:

    • pip 23.3.2 to 24.0,

    • setuptools 69.0.3 to 69.1.0. (#2691)

Misc - 20.25.1

v20.25.0 (2023-12-01)

Features - 20.25.0

  • The tests now pass on the CI with Python 3.13.0a2 - by @hroncok. (#2673)

Bugfixes - 20.25.0

  • Upgrade embedded wheels:

    • wheel to 0.41.3 from 0.41.2 (#2665)

  • Upgrade embedded wheels:

    • wheel to 0.42.0 from 0.41.3

    • setuptools to 69.0.2 from 68.2.2 (#2669)

v20.24.6 (2023-10-23)

Bugfixes - 20.24.6

  • Use get_hookimpls method instead of the private attribute in tests. (#2649)

  • Upgrade embedded wheels:

    • setuptools to 68.2.2 from 68.2.0

    • pip to 23.3.1 from 23.2.1 (#2656)

v20.24.5 (2023-09-08)

Bugfixes - 20.24.5

  • Declare PyPy 3.10 support - by @cclauss. (#2638)

  • Brew on macOS no longer allows copy builds - disallow choosing this by @gaborbernat. (#2640)

  • Upgrade embedded wheels:

    • setuptools to 68.2.0 from 68.1.2 (#2642)

v20.24.4 (2023-08-30)

Bugfixes - 20.24.4

  • Upgrade embedded wheels:

    • setuptools to 68.1.2 from 68.1.0 on 3.8+

    • wheel to 0.41.2 from 0.41.1 on 3.7+ (#2628)

v20.24.3 (2023-08-11)

Bugfixes - 20.24.3

  • Fixed ResourceWarning on exit caused by periodic update subprocess (#2472)

  • Upgrade embedded wheels:

    • wheel to 0.41.1 from 0.41.0 (#2622)

Misc - 20.24.3

v20.24.2 (2023-07-24)

Bugfixes - 20.24.2

  • Upgrade embedded wheels:

    • pip to 23.2.1 from 23.2

    • wheel to 0.41.0 from 0.40.0 (#2614)

v20.24.1 (2023-07-19)

Bugfixes - 20.24.1

v20.24.0 (2023-07-14)

Features - 20.24.0

  • Export the prompt prefix as VIRTUAL_ENV_PROMPT when activating a virtual environment - by @jimporter. (#2194)

Bugfixes - 20.24.0

v20.23.1 (2023-06-16)

Bugfixes - 20.23.1

  • update and simplify nushell activation script, fixes an issue on Windows resulting in consecutive command not found - by @melMass. (#2572)

  • Upgrade embedded wheels:

    • setuptools to 67.8.0 from 67.7.2 (#2588)

v20.23.0 (2023-04-27)

Features - 20.23.0

  • Do not install wheel and setuptools seed packages for Python 3.12+. To restore the old behavior use:

    • for wheel use VIRTUALENV_WHEEL=bundle environment variable or --wheel=bundle CLI flag,

    • for setuptools use VIRTUALENV_SETUPTOOLS=bundle environment variable or --setuptools=bundle CLI flag.

    By @chrysle. (#2487)

  • 3.12 support - by @gaborbernat. (#2558)

Bugfixes - 20.23.0

  • Prevent PermissionError when using venv creator on systems that deliver files without user write permission - by @kulikjak. (#2543)

  • Upgrade setuptools to 67.7.2 from 67.6.1 and pip to 23.1.2 from 23.1 - by @szleb. (#2560)

v20.22.0 (2023-04-19)

Features - 20.22.0

  • Drop support for creating Python <=3.6 (including 2) interpreters. Removed pip of 20.3.4, 21.3.1; wheel of 0.37.1; setuptools of 59.6.0, 44.1.1, 50.3.2- by @gaborbernat. (#2548)

v20.21.1 (2023-04-19)

Bugfixes - 20.21.1

  • Add tox.ini to sdist - by @mtelka. (#2511)

  • Move the use of ‘let’ in nushell to ensure compatibility with future releases of nushell, where ‘let’ no longer assumes that its initializer is a full expressions. (#2527)

  • The nushell command ‘str collect’ has been superseded by the ‘str join’ command. The activate.nu script has been updated to reflect this change. (#2532)

  • Upgrade embedded wheels:

    • wheel to 0.40.0 from 0.38.4

    • setuptools to 67.6.1 from 67.4.0

    • pip to 23.1 from 23.0.1 (#2546)

v20.21.0 (2023-03-12)

Features - 20.21.0

  • Make closure syntax explicitly starts with {||. (#2512)

Bugfixes - 20.21.0

  • Add print command to nushell print_prompt to ensure compatibility with future release of nushell, where intermediate commands no longer print their result to stdout. (#2514)

  • Do not assume the default encoding. (#2515)

  • Make ReentrantFileLock thread-safe and, thereby, fix race condition in virtualenv.cli_run - by @radoering. (#2516)

v20.20.0 (2023-02-28)

Features - 20.20.0

  • Change environment variable existence check in Nushell activation script to not use deprecated command. (#2506)

Bugfixes - 20.20.0

  • Discover CPython implementations distributed on Windows by any organization - by @faph. (#2504)

  • Upgrade embedded setuptools to 67.4.0 from 67.1.0 and pip to 23.0.1 from 23.0 - by @gaborbernat. (#2510)

v20.19.0 (2023-02-07)

Features - 20.19.0

v20.18.0 (2023-02-06)

Features - 20.18.0

Bugfixes - 20.18.0

  • Fix broken prompt in Nushell when activating virtual environment - by @kubouc. (#2481)

  • Bump embedded pip to 23.0 and setuptools to 67.1 - by @gaborbernat. (#2489)

v20.17.1 (2022-12-05)

Bugfixes - 20.17.1

  • A py or python spec means any Python rather than CPython - by @gaborbernat. (#2460)

  • Make activate.nu respect VIRTUAL_ENV_DISABLE_PROMPT and not set the prompt if requested - by @m-lima. (#2461)

v20.17.0 (2022-11-27)

Features - 20.17.0

  • Change Nushell activation script to be a module meant to be activated as an overlay. (#2422)

  • Update operator used in Nushell activation script to be compatible with future versions. (#2450)

Bugfixes - 20.17.0

  • Do not use deprecated API from importlib.resources on Python 3.10 or later - by @gaborbernat. (#2448)

  • Upgrade embedded setuptools to 65.6.3 from 65.5.1 - by @gaborbernat. (#2451)

v20.16.7 (2022-11-12)

Bugfixes - 20.16.7

  • Use parent directory of python executable for pyvenv.cfg “home” value per PEP 405 - by @vfazio. (#2440)

  • In POSIX virtual environments, try alternate binary names if sys._base_executable does not exist - by @vfazio. (#2442)

  • Upgrade embedded wheel to 0.38.4 and pip to 22.3.1 from 22.3 and setuptools to 65.5.1 from 65.5.0 - by @gaborbernat. (#2443)

v20.16.6 (2022-10-25)

Features - 20.16.6

  • Drop unneeded shims for PyPy3 directory structure (#2426)

Bugfixes - 20.16.6

  • Fix selected scheme on debian derivatives for python 3.10 when python3-distutils is not installed or the venv scheme is not available - by @asottile. (#2350)

  • Allow the test suite to pass even with the original C shell (rather than tcsh) - by @kulikjak. (#2418)

  • Fix fallback handling of downloading wheels for bundled packages - by @schaap. (#2429)

  • Upgrade embedded setuptools to 65.5.0 from 65.3.0 and pip to 22.3 from 22.2.2 - by @gaborbernat. (#2434)

v20.16.5 (2022-09-07)

Bugfixes - 20.16.5

  • Do not turn echo off for subsequent commands in batch activators (activate.bat and deactivate.bat) - by @pawelszramowski. (#2411)

v20.16.4 (2022-08-29)

Bugfixes - 20.16.4

v20.16.3 (2022-08-04)

Bugfixes - 20.16.3

  • Upgrade embedded pip to 22.2.2 from 22.2.1 and setuptools to 63.4.1 from 63.2.0 - by @gaborbernat. (#2395)

v20.16.2 (2022-07-27)

Bugfixes - 20.16.2

v20.16.1 (2022-07-26)

Features - 20.16.1

  • Update Nushell activation scripts to version 0.67 - by @kubouch. (#2386)

v20.16.0 (2022-07-25)

Features - 20.16.0

  • Drop support for running under Python 2 (still can generate Python 2 environments) - by @gaborbernat. (#2382)

  • Upgrade embedded pip to 22.2 from 22.1.2 and setuptools to 63.2.0 from 62.6.0 - by @gaborbernat. (#2383)

v20.15.1 (2022-06-28)

Bugfixes - 20.15.1

  • Fix the incorrect operation when setuptools plugins output something into stdout. (#2335)

  • CPython3Windows creator ignores missing DLLs dir. (#2368)

v20.15.0 (2022-06-25)

Features - 20.15.0

  • Support for Windows embeddable Python package: includes python<VERSION>.zip in the creator sources - by @reksarka. (#1774)

Bugfixes - 20.15.0

v20.14.1 (2022-04-11)

Features - 20.14.1

  • Support for creating a virtual environment from a Python 2.7 framework on macOS 12 - by @nickhutchinson. (#2284)

Bugfixes - 20.14.1

v20.14.0 (2022-03-25)

Features - 20.14.0

  • Support Nushell activation scripts with nu version 0.60 - by @kubouch. (#2321)

Bugfixes - 20.14.0

v20.13.4 (2022-03-18)

Bugfixes - 20.13.4

  • Improve performance of python startup inside created virtualenvs - by @asottile. (#2317)

  • Upgrade embedded setuptools to 60.10.0 from 60.9.3 - by @gaborbernat. (#2320)

v20.13.3 (2022-03-07)

Bugfixes - 20.13.3

v20.13.2 (2022-02-24)

Bugfixes - 20.13.2

v20.13.1 (2022-02-05)

Bugfixes - 20.13.1

  • fix “execv() arg 2 must contain only strings” error on M1 MacOS (#2282)

  • Upgrade embedded setuptools to 60.5.0 from 60.2.0 - by @asottile. (#2289)

  • Upgrade embedded pip to 22.0.3 and setuptools to 60.6.0 - by @gaborbernat and @asottile. (#2294)

v20.13.0 (2022-01-02)

Features - 20.13.0

  • Add downloaded wheel information in the relevant JSON embed file to prevent additional downloads of the same wheel. - by @mayeut. (#2268)

Bugfixes - 20.13.0

  • Fix AttributeError: 'bool' object has no attribute 'error' when creating a Python 2.x virtualenv on macOS - by moreati. (#2269)

  • Fix PermissionError: [Errno 1] Operation not permitted when creating a Python 2.x virtualenv on macOS/arm64 - by moreati. (#2271)

v20.12.1 (2022-01-01)

Bugfixes - 20.12.1

  • Try using previous updates of pip, setuptools & wheel when inside an update grace period rather than always falling back to embedded wheels - by @mayeut. (#2265)

  • New patch versions of pip, setuptools & wheel are now returned in the expected timeframe. - by @mayeut. (#2266)

  • Manual upgrades of pip, setuptools & wheel are not discarded by a periodic update - by @mayeut. (#2267)

v20.12.0 (2021-12-31)

Features - 20.12.0

Bugfixes - 20.12.0

v20.11.2 (2021-12-29)

Bugfixes - 20.11.2

  • Fix installation of pinned versions of pip, setuptools & wheel - by @mayeut. (#2203)

v20.11.1 (2021-12-29)

Bugfixes - 20.11.1

v20.11.0 (2021-12-28)

Features - 20.11.0

  • Avoid deprecation warning from py-filelock argument - by @ofek. (#2237)

  • Upgrade embedded setuptools to 61.1.0 from 58.3.0 - by @gaborbernat. (#2240)

  • Drop the runtime dependency of backports.entry-points-selectable - by @hroncok. (#2246)

  • Fish: PATH variables should not be quoted when being set - by @d3dave. (#2248)

v20.10.0 (2021-11-01)

Features - 20.10.0

  • If a "venv" install scheme exists in sysconfig, virtualenv now uses it to create new virtual environments. This allows Python distributors, such as Fedora, to patch/replace the default install scheme without affecting the paths in new virtual environments. A similar technique was proposed to Python, for the venv module - by hroncok (#2208)

  • The activated virtualenv prompt is now always wrapped in parentheses. This affects venvs created with the --prompt attribute, and matches virtualenv’s behavior on par with venv. (#2224)

Bugfixes - 20.10.0

v20.9.0 (2021-10-23)

Features - 20.9.0

  • Special-case --prompt . to the name of the current directory - by @rkm. (#2220)

  • Add libffi-8.dll to pypy windows #2218 - by @mattip

Bugfixes - 20.9.0

  • Fixed path collision that could lead to a PermissionError or writing to system directories when using PyPy3.8 - by @mgorny. (#2182)

  • Upgrade embedded setuptools to 58.3.0 from 58.1.0 and pip to 21.3.1 from 21.2.4 - by @gaborbernat. (#2205)

  • Remove stray closing parenthesis in activate.bat - by @SiggyBar. (#2221)

v20.8.1 (2021-09-24)

Bugfixes - 20.8.1

  • Fixed a bug where while creating a venv on top of an existing one, without cleaning, when seeded wheel version mismatch occurred, multiple .dist-info directories may be present, confounding entrypoint discovery - by @arcivanov (#2185)

  • Bump embed setuptools from 58.0.4 to 58.1.0 - by @gaborbernat. (#2195)

Misc - 20.8.1

v20.8.0 (2021-09-16)

  • upgrade embedded setuptools to 58.0.4 from 57.4.0 and pip to 21.2.4 from 21.2.3

  • Add nushell activation script

v20.7.2 (2021-08-10)

Bugfixes - 20.7.2

  • Upgrade embedded pip to 21.2.3 from 21.2.2 and wheel to 0.37.0 from 0.36.2 - by @gaborbernat. (#2168)

v20.7.1 (2021-08-09)

Bugfixes - 20.7.1

  • Fix unpacking dictionary items in PythonInfo.install_path (#2165)

v20.7.0 (2021-07-31)

Bugfixes - 20.7.0

  • upgrade embedded pip to 21.2.2 from 21.1.3 and setuptools to 57.4.0 from 57.1.0 - by @gaborbernat (#2159)

Deprecations and Removals - 20.7.0

  • Removed xonsh activator due to this breaking fairly often the CI and lack of support from those packages maintainers, upstream is encouraged to continue supporting the project as a plugin - by @gaborbernat. (#2160)

v20.6.0 (2021-07-14)

Features - 20.6.0

  • Support Python interpreters without distutils (fallback to syconfig in these cases) - by @gaborbernat. (#1910)

v20.5.0 (2021-07-13)

Features - 20.5.0

  • Plugins now use ‘selectable’ entry points - by @jaraco. (#2093)

  • add libffi-7.dll to the hard-coded list of dlls for PyPy (#2141)

  • Use the better maintained platformdirs instead of appdirs - by @gaborbernat. (#2142)

Bugfixes - 20.5.0

  • Bump pip the embedded pip 21.1.3 and setuptools to 57.1.0 - by @gaborbernat. (#2135)

Deprecations and Removals - 20.5.0

  • Drop python 3.4 support as it has been over 2 years since EOL - by @gaborbernat. (#2141)

v20.4.7 (2021-05-24)

Bugfixes - 20.4.7

v20.4.6 (2021-05-05)

Bugfixes - 20.4.6

  • Fix site.getsitepackages() broken on python2 on debian - by @freundTech. (#2105)

v20.4.5 (2021-05-05)

Bugfixes - 20.4.5

v20.4.4 (2021-04-20)

Bugfixes - 20.4.4

  • Built in discovery class is always preferred over plugin supplied classes. (#2087)

  • Upgrade embedded setuptools to 56.0.0 by @gaborbernat. (#2094)

v20.4.3 (2021-03-16)

Bugfixes - 20.4.3

v20.4.2 (2021-02-01)

Bugfixes - 20.4.2

v20.4.1 (2021-01-31)

Bugfixes - 20.4.1

  • Bump embedded pip and setuptools packages to latest upstream supported (21.0.1 and 52.0.0) - by @gaborbernat. (#2060)

v20.4.0 (2021-01-19)

Features - 20.4.0

  • On the programmatic API allow passing in the environment variable dictionary to use, defaults to os.environ if not specified - by @gaborbernat. (#2054)

Bugfixes - 20.4.0

v20.3.1 (2021-01-13)

Bugfixes - 20.3.1

  • Bump embed pip to 20.3.3, setuptools to 51.1.1 and wheel to 0.36.2 - by @gaborbernat. (#2036)

  • Allow unfunctioning of pydoc to fail freely so that virtualenvs can be activated under Zsh with set -e (since otherwise unset -f and unfunction exit with 1 if the function does not exist in Zsh) - by @d125q. (#2049)

  • Drop cached python information if the system executable is no longer present (for example when the executable is a shim and the mapped executable is replaced - such is the case with pyenv) - by @gaborbernat. (#2050)

v20.3.0 (2021-01-10)

Features - 20.3.0

  • The builtin discovery takes now a --try-first-with argument and is first attempted as valid interpreters. One can use this to force discovery of a given python executable when the discovery order/mechanism raises errors - by @gaborbernat. (#2046)

Bugfixes - 20.3.0

  • On Windows python 3.7+ distributions where the exe shim is missing fallback to the old ways - by @gaborbernat. (#1986)

  • When discovering interpreters on Windows, via the PEP-514, prefer PythonCore releases over other ones. virtualenv is used via pip mostly by this distribution, so prefer it over other such as conda - by @gaborbernat. (#2046)

v20.2.2 (2020-12-07)

Bugfixes - 20.2.2

  • Bump pip to 20.3.1, setuptools to 51.0.0 and wheel to 0.36.1 - by @gaborbernat. (#2029)

v20.2.1 (2020-11-23)

No significant changes.

v20.2.0 (2020-11-21)

Features - 20.2.0

  • Optionally skip VCS ignore directive for entire virtualenv directory, using option no-vcs-ignore, by default False. (#2003)

  • Add --read-only-app-data option to allow for creation based on an existing app data cache which is non-writable. This may be useful (for example) to produce a docker image where the app-data is pre-populated.

    ENV \
    VIRTUALENV_OVERRIDE_APP_DATA=/opt/virtualenv/cache \
    VIRTUALENV_SYMLINK_APP_DATA=1
RUN virtualenv venv && rm -rf venv
ENV VIRTUALENV_READ_ONLY_APP_DATA=1
USER nobody
# this virtualenv has symlinks into the read-only app-data cache
RUN virtualenv /tmp/venv

    Patch by @asottile. (#2009)

Bugfixes - 20.2.0

  • Fix processing of the VIRTUALENV_PYTHON environment variable and make it multi-value as well (separated by comma) - by @pneff. (#1998)

v20.1.0 (2020-10-25)

Features - 20.1.0

  • The python specification can now take one or more values, first found is used to create the virtual environment - by @gaborbernat. (#1995)

v20.0.35 (2020-10-15)

Bugfixes - 20.0.35

  • Bump embedded setuptools from 50.3.0 to 50.3.1 - by @gaborbernat. (#1982)

  • After importing virtualenv passing cwd to a subprocess calls breaks with invalid directory - by @gaborbernat. (#1983)

v20.0.34 (2020-10-12)

Bugfixes - 20.0.34

  • Align with venv module when creating virtual environments with builtin creator on Windows 3.7 and later - by @gaborbernat. (#1782)

  • Handle Cygwin path conversion in the activation script - by @davidcoghlan. (#1969)

v20.0.33 (2020-10-04)

Bugfixes - 20.0.33

  • Fix None type error in cygwin if POSIX path in dest - by @danyeaw. (#1962)

  • Fix Python 3.4 incompatibilities (added back to the CI) - by @gaborbernat. (#1963)

v20.0.32 (2020-10-01)

Bugfixes - 20.0.32

  • For activation scripts always use UNIX line endings (unless it’s BATCH shell related) - by @saytosid. (#1818)

  • Upgrade embedded pip to 20.2.1 and setuptools to 49.4.0 - by @gaborbernat. (#1918)

  • Avoid spawning new windows when doing seed package upgrades in the background on Windows - by @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 to 20.2.3 - by @gaborbernat. (#1939)

  • Provide correct path for bash activator in cygwin or msys2 - by @danyeaw. (#1940)

  • Relax importlib requirement to allow version<3 - by @usamasadiq (#1953)

  • pth files were not processed on CPython2 if $PYTHONPATH was pointing to site-packages/ - by @navytux. (#1959) (#1960)

v20.0.31 (2020-08-17)

Bugfixes - 20.0.31

  • Upgrade embedded pip to 20.2.1, setuptools to 49.6.0 and wheel to 0.35.1 - by @gaborbernat. (#1918)

v20.0.30 (2020-08-04)

Bugfixes - 20.0.30

v20.0.29 (2020-07-31)

Bugfixes - 20.0.29

v20.0.28 (2020-07-24)

Bugfixes - 20.0.28

  • Fix test suite failing if run from system Python - by @gaborbernat. (#1882)

  • Provide setup_logging flag to python API so that users can bypass logging handling if their application already performs this - by @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 @gaborbernat. (#1905)

v20.0.27 (2020-07-15)

Bugfixes - 20.0.27

v20.0.26 (2020-07-07)

Bugfixes - 20.0.26

  • Bump dependency distutils >= 0.3.1 - by @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 behavior inline)

    • fallback to unverified context when querying the PyPi for release date,

    • stop downloading wheels once we reach the embedded version,

    by @gaborbernat. (#1883)

  • Do not print error message if the application exists with SystemExit(0) - by @gaborbernat. (#1885)

  • Upgrade embedded setuptools from 47.3.1 to 49.1.0 for Python 3.5+ - by @gaborbernat. (#1887)

v20.0.25 (2020-06-23)

Bugfixes - 20.0.25

  • 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 @gaborbernat. (#1869)

v20.0.24 (2020-06-22)

Features - 20.0.24

  • Ensure that the seeded packages do not get too much out of date:

    • add a CLI flag that triggers upgrade of embedded wheels under 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 no-periodic-update)

    More details under Wheels - by @gaborbernat. (#1821)

  • Upgrade embed wheel content:

    • ship wheels for Python 3.9 and 3.10

    • upgrade setuptools for Python 3.5+ from 47.1.1 to 47.3.1

    by @gaborbernat. (#1841)

  • 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 @gaborbernat. (#1864)

Bugfixes - 20.0.24

  • Do not generate/overwrite .gitignore if it already exists at destination path - by @gaborbernat. (#1862)

  • Improve error message for no .dist-info inside the app-data copy seeder - by @gaborbernat. (#1867)

Improved Documentation - 20.0.24

v20.0.23 (2020-06-12)

Bugfixes - 20.0.23

v20.0.22 (2020-06-12)

Bugfixes - 20.0.22

  • Relax importlib.resources requirement to also allow version 2 - by @asottile. (#1846)

  • Upgrade embedded setuptools to 44.1.1 for python 2 and 47.1.1 for python3.5+ - by @gaborbernat. (#1855)

v20.0.21 (2020-05-20)

Features - 20.0.21

  • 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 @gaborbernat. (#1806)

Bugfixes - 20.0.21

  • Fix virtualenv fails sometimes when run concurrently, --clear-app-data conflicts with clear flag when abbreviation is turned on. To bypass this while allowing abbreviated flags on the command line we had to move it to reset-app-data - by @gaborbernat. (#1824)

  • Upgrade embedded setuptools to 46.4.0 from 46.1.3 on Python 3.5+, and pip from 20.1 to 20.1.1 - by @gaborbernat. (#1827)

  • Seeder pip now correctly handles --extra-search-dir - by @frenzymadness. (#1834)

v20.0.20 (2020-05-04)

Bugfixes - 20.0.20

  • Fix download fails with python 3.4 - by @gaborbernat. (#1809)

  • Fixes older CPython2 versions use _get_makefile_filename instead of get_makefile_filename on sysconfig - by @ianw. (#1810)

  • Fix download is True by default - by @gaborbernat. (#1813)

  • Fail app-data seed operation when wheel download fails and better error message - by @gaborbernat. (#1814)

v20.0.19 (2020-05-03)

Bugfixes - 20.0.19

  • Fix generating a Python 2 environment from Python 3 creates invalid python activator - by @gaborbernat. (#1776)

  • Fix pinning seed packages via app-data seeder raised Invalid Requirement - by @gaborbernat. (#1779)

  • Do not stop interpreter discovery if we fail to find the system interpreter for a executable during discovery - by @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 @gaborbernat. (#1783)

  • Better handling of options copies and 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 @gaborbernat. (#1784)

  • Upgrade pip for Python 2.7 and 3.5+ from 20.0.2 to 20.1 - by @gaborbernat. (#1793)

  • Fix CPython is not discovered from Windows registry, and discover pythons from Windows registry in decreasing order by version - by @gaborbernat. (#1796)

  • Fix symlink detection for creators - by @asottile (#1803)

v20.0.18 (2020-04-16)

Bugfixes - 20.0.18

  • Importing setuptools before cli_run could cause our python information query to fail due to setuptools patching distutils.dist.Distribution - by @gaborbernat. (#1771)

v20.0.17 (2020-04-09)

Features - 20.0.17

  • Extend environment variables checked for configuration to also check aliases (e.g. setting either VIRTUALENV_COPIES or VIRTUALENV_ALWAYS_COPY will work) - by @gaborbernat. (#1763)

v20.0.16 (2020-04-04)

Bugfixes - 20.0.16

  • Allow seed wheel files inside the extra-search-dir folders that do not have Requires-Python metadata specified, these are considered compatible with all python versions - by @gaborbernat. (#1757)

v20.0.15 (2020-03-27)

Features - 20.0.15

v20.0.14 (2020-03-25)

Features - 20.0.14

  • Remove __PYVENV_LAUNCHER__ on macOs for Python 3.7.(<8) and 3.8.(<3) on interpreter startup via pth file, this pulls in the upstream patch - by @gaborbernat. (#1704)

  • Upgrade embedded setuptools for Python 3.5+ to 46.1.1, for Python 2.7 to 44.1.0 - by @gaborbernat. (#1745)

Bugfixes - 20.0.14

  • Fix discovery of interpreter by name from PATH that does not match a spec format - by @gaborbernat. (#1746)

v20.0.13 (2020-03-19)

Bugfixes - 20.0.13

  • Do not fail when the pyc files is missing for the host Python 2 - by @gaborbernat. (#1738)

  • Support broken Packaging pythons that put the include headers under distutils pattern rather than sysconfig one - by @gaborbernat. (#1739)

v20.0.12 (2020-03-19)

Bugfixes - 20.0.12

v20.0.11 (2020-03-18)

Features - 20.0.11

  • 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 @gaborbernat. (#1716)

Bugfixes - 20.0.11

  • Support Python 3 Framework distributed via XCode in macOs Catalina and before - by @gaborbernat. (#1663)

  • Fix Windows Store Python support, do not allow creation via symlink as that’s not going to work by design - by @gaborbernat. (#1709)

  • Fix activate_this.py throws AttributeError on Windows when virtual environment was created via cross python mechanism - by @gaborbernat. (#1710)

  • Fix --no-pip, --no-setuptools, --no-wheel not being respected - by @gaborbernat. (#1712)

  • Allow missing .py files if a compiled .pyc version is available - by @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 @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 image amazonlinux:1) - by @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 @gaborbernat. (#1721)

  • Also generate pipx.y console script beside pip-x.y to be compatible with how pip installs itself - by @gaborbernat. (#1723)

  • Automatically create the application data folder if it does not exists - by @gaborbernat. (#1728)

Improved Documentation - 20.0.11

v20.0.10 (2020-03-10)

Bugfixes - 20.0.10

  • Fix acquiring python information might be altered by distutils configuration files generating incorrect layout virtual environments - by @gaborbernat. (#1663)

  • Upgrade embedded setuptools to 46.0.0 from 45.3.0 on Python 3.5+ - by @gaborbernat. (#1702)

Improved Documentation - 20.0.10

  • Document requirements (pip + index server) when installing via pip under the installation section - by @gaborbernat. (#1618)

  • Document installing from non PEP-518 systems - @gaborbernat. (#1619)

  • Document installing latest unreleased version from Github - @gaborbernat. (#1620)

v20.0.9 (2020-03-08)

Bugfixes - 20.0.9

  • pythonw.exe works as python.exe on Windows - by @gaborbernat. (#1686)

  • Handle legacy loaders for virtualenv import hooks used to patch distutils configuration load - by @gaborbernat. (#1690)

  • Support for python 2 platforms that store landmark files in platstdlib over stdlib (e.g. RHEL) - by @gaborbernat. (#1694)

  • Upgrade embedded setuptools to 45.3.0 from 45.2.0 for Python 3.5+ - by @gaborbernat. (#1699)

v20.0.8 (2020-03-04)

Bugfixes - 20.0.8

  • Having distutils configuration files that set prefix and install_scripts cause installation of packages in the wrong location - by @gaborbernat. (#1663)

  • Fix PYTHONPATH being overridden on Python 2 — by @jd. (#1673)

  • Fix list configuration value parsing from config file or environment variable - by @gaborbernat. (#1674)

  • Fix Batch activation script shell prompt to display environment name by default - by @spetafree. (#1679)

  • Fix startup on Python 2 is slower for virtualenv - this was due to setuptools calculating it’s working set distribution - by @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 @gaborbernat. (#1684)

  • Fix attr: import fails for setuptools - by @gaborbernat. (#1685)

v20.0.7 (2020-02-26)

Bugfixes - 20.0.7

v20.0.6 (2020-02-26)

Bugfixes - 20.0.6

  • Fix global site package always being added with bundled macOs python framework builds - by @gaborbernat. (#1561)

  • Fix generated scripts use host version info rather than target - by @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 @gaborbernat. (#1632)

  • Handle the case when the application data folder is read-only:

    • the application data folder is now controllable via app-data,

    • clear-app-data now cleans the entire application data folder, not just the app-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,

    • symlink-app-data is always False when the application data is temporary

    by @gaborbernat. (#1640)

  • Fix PyPy 2 builtin modules are imported from standard library, rather than from builtin - by @gaborbernat. (#1652)

  • Fix creation of entry points when path contains spaces - by @nsoranzo. (#1660)

  • Fix relative paths for the zipapp (for python 3.7+) - by @gaborbernat. (#1666)

v20.0.5 (2020-02-21)

Features - 20.0.5

  • Also create pythonX.X executables when creating pypy virtualenvs - by @asottile (#1612)

  • Fail with better error message if trying to install source with unsupported setuptools, allow setuptools-scm >= 2 and move to legacy setuptools-scm format to support better older platforms (CentOS 7 and such) - by @gaborbernat. (#1621)

  • Report of the created virtual environment is now split across four short lines rather than one long - by @gaborbernat (#1641)

Bugfixes - 20.0.5

  • Add macOs Python 2 Framework support (now we test it with the CI via brew) - by @gaborbernat (#1561)

  • Fix losing of libpypy-c.so when the pypy executable is a symlink - by @asottile (#1614)

  • Discover python interpreter in a case insensitive manner - by @PrajwalM2212 (#1624)

  • Fix cross interpreter support when the host python sets sys.base_executable based on __PYVENV_LAUNCHER__ - by @cjolowicz (#1643)

v20.0.4 (2020-02-14)

Features - 20.0.4

  • When aliasing interpreters, use relative symlinks - by @asottile. (#1596)

Bugfixes - 20.0.4

  • Allow the use of / as pathname component separator on Windows - by vphilippon (#1582)

  • Lower minimal version of six required to 1.9 - by ssbarnea (#1606)

v20.0.3 (2020-02-12)

Bugfixes - 20.0.3

  • On Python 2 with Apple Framework builds the global site package is no longer added when the system-site-packages is not specified - by @gaborbernat. (#1561)

  • Fix system python discovery mechanism when prefixes contain relative parts (e.g. ..) by resolving paths within the python information query - by @gaborbernat. (#1583)

  • Expose a programmatic API as from virtualenv import cli_run - by @gaborbernat. (#1585)

  • Fix app-data seeder injects a extra .dist-info.virtualenv path that breaks importlib.metadata, now we inject an extra .virtualenv - by @gaborbernat. (#1589)

Improved Documentation - 20.0.3

v20.0.2 (2020-02-11)

Features - 20.0.2

  • Print out a one line message about the created virtual environment when no verbose is set, this can now be silenced to get back the original behavior via the quiet flag - by @pradyunsg. (#1557)

  • Allow virtualenv’s app data cache to be overridden by VIRTUALENV_OVERRIDE_APP_DATA - by @asottile. (#1559)

  • Passing in the virtual environment name/path is now required (no longer defaults to venv) - by @gaborbernat. (#1568)

  • Add a CLI flag with-traceback that allows displaying the stacktrace of the virtualenv when a failure occurs - by @gaborbernat. (#1572)

Bugfixes - 20.0.2

  • Support long path names for generated virtual environment console entry points (such as pip) when using the app-data seeder - by @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 @gaborbernat. (#1545)

  • 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 @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 @gaborbernat. (#1574)

  • The app-data seeder no longer symlinks the packages on UNIX and copies on Windows. Instead by default always copies, however now has the symlink-app-data flag allowing users to request this less robust but faster method - by @gaborbernat. (#1575)

Improved Documentation - 20.0.2

v20.0.1 (2020-02-10)

Features - 20.0.1

  • upgrade embedded setuptools to 45.2.0 from 45.1.0 for Python 3.4+ - by @gaborbernat. (#1554)

Bugfixes - 20.0.1

  • Virtual environments created via relative path on Windows creates bad console executables - by @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 @gaborbernat. (#1553)

v20.0.0. (2020-02-10)

Improved Documentation - 20.0.0.

  • Fixes typos, repeated words and inconsistent heading spacing. Rephrase parts of the development documentation and CLI documentation. Expands shorthands like env var and config to their full forms. Uses descriptions from respective documentation, for projects listed in related links - by @pradyunsg. (#1540)

v20.0.0b2 (2020-02-04)

Features - 20.0.0b2

  • 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 @gaborbernat. (#1515)

  • Generate bash and fish activators on Windows too (as these can be available with git bash, cygwin or mysys2) - by @gaborbernat. (#1527)

  • Upgrade the bundled wheel package from 0.34.0 to 0.34.2 - by @gaborbernat. (#1531)

Bugfixes - 20.0.0b2

  • Bash activation script should have no extensions instead of .sh (this fixes the virtualenvwrapper integration) - by @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 for PythonSpec 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 @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 @gaborbernat. (#1512)

  • Support relative paths for -p - by @gaborbernat. (#1514)

  • Creating virtual environments in parallel fail with cannot acquire lock within app data - by @gaborbernat. (#1516)

  • pth files were not processed under Debian CPython2 interpreters - by @gaborbernat. (#1517)

  • Fix prompt not displayed correctly with upcoming fish 3.10 due to us not preserving $pipestatus - by @krobelus. (#1530)

  • Stable order within pyenv.cfg and add include-system-site-packages only for creators that reference a global Python - by user:gaborbernat. (#1535)

Improved Documentation - 20.0.0b2

  • Create the first iteration of the new documentation - by @gaborbernat. (#1465)

  • Project readme is now of type MarkDown instead of reStructuredText - by @gaborbernat. (#1531)

v20.0.0b1 (2020-01-28)

  • First public release of the rewrite. Everything is brand new and just added.

  • --download defaults to False

  • No longer replaces builtin site module with custom version baked within virtualenv code itself. A simple shim module is used to fix up things on Python 2 only.

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.