• نصب بودن پایتون نسخه 3.9 یا جدیدتر روی سیستم شما. اگر از یک ابزار مدیریت نسخه مانند pyenv https://github.com/pyenv/pyenv، mise https://mise.jdx.dev یا asdf https://asdf-vm.com استفاده می‌کنید، virtualenv به‌طور خودکار نسخه پایتون مدیریت‌شده توسط آن‌ها را شناسایی می‌کند.
• نصب بودن virtualenv (بخش Install virtualenv <> را ببینید).

(myproject) C:\> where.exe python
C:\Users\user\myproject\Scripts\python.exe

با فعال بودن محیط، یک بسته را با استفاده از pip نصب کنید:

(myproject) $ pip install requests
Collecting requests
  Using cached requests-2.32.3-py3-none-any.whl (64 kB)
Installing collected packages: requests
Successfully installed requests-2.32.3

بررسی کنید که بسته تنها درون محیط مجازی شما نصب شده باشد:

(myproject) $ python -c "import requests; print(requests.__file__)"
/home/user/myproject/lib/python3.13/site-packages/requests/__init__.py

این مسیر نشان می‌دهد که requests در محیط مجازی نصب شده است، نه در Python سیستم شما.

• یک محیط مجازی با virtualenv ایجاد کنید.
• محیط‌های مجازی را در پلتفرم‌های مختلف فعال و غیرفعال کنید.
• بسته‌ها را به‌صورت ایزوله‌شده از پایتون سیستم خود نصب کنید.
• وابستگی‌های پروژه را با pip freeze ذخیره کنید.
• محیط‌ها را با استفاده از requirements.txt بازتولید کنید.

• بخش Use virtualenv <> برای انتخاب نگارش‌های خاص پایتون، پیکربندی پیش‌فرض‌ها و الگوهای استفاده پیشرفته.
• بخش Explanation <> برای درک نحوه کارکرد درونی virtualenv و مقایسه آن با venv.
• بخش Command line <> برای تمام گزینه‌ها و پرچم‌های موجود در خط فرمان.

• ابزار uv https://docs.astral.sh/uv -- مدیر بسته سریع و مدرن پایتون. اگر از قبل uv را دارید یا می‌خواهید تازه شروع کنید از این گزینه استفاده کنید.
• ابزار pipx https://pipx.pypa.io/stable -- ابزارهای خط فرمان پایتون را در محیط‌های ایزوله نصب می‌کند. اگر از قبل pipx را راه‌اندازی کرده‌اید از این گزینه استفاده کنید.
• ابزار pip https://pip.pypa.io/stable -- نصاب استاندارد بسته‌های پایتون. از گزینه --user استفاده کنید تا از تغییر بسته‌های سیستم جلوگیری شود. ممکن است در توزیع‌هایی با محیط‌های پایتون مدیریت‌شده از خارج کار نکند.
• بسته zipapp https://docs.python.org/3/library/zipapp.html -- یک فایل اجرایی مستقل بدون نیاز به نصب. از این در CI یا محیط‌هایی که نمی‌توانید بسته‌ها را نصب کنید استفاده کنید.

• >=3.12 -- هر نسخه Python 3.12 یا بالاتر.
• ~=3.11.0 -- انتشار سازگار، معادل >=3.11.0, <3.12.0 (هر وصله 3.11.x).
• cpython>=3.10 -- محدود به پیاده‌سازی CPython، نسخه 3.10 یا بالاتر.

$ virtualenv -p /usr/bin/python3.9 venv

از --try-first-with برای ارائه یک راهنمایی درباره این‌که کدام پایتون ابتدا بررسی شود استفاده کنید. بر خلاف --python، این یک پیشنهاد است تا یک قانون قطعی. مفسر موجود در این مسیر ابتدا بررسی می‌شود، اما تنها در صورتی استفاده خواهد شد که با قید --python مطابقت داشته باشد.

$ virtualenv --python ">=3.10" --try-first-with /usr/bin/python3.9 venv

در این مثال، ابتدا /usr/bin/python3.9 بررسی می‌شود اما به دلیل برآورده نکردن شرط >=3.10 رد می‌شود.

@ source venv/bin/activate.xsh

خروج از محیط مجازی:

$ deactivate

$ virtualenv --download venv

غیرفعال‌سازی به‌روزرسانی‌های خودکار دوره‌ای بسته‌های اولیه (seed packages):

$ virtualenv --no-periodic-update venv

• نسخه‌های جدید نزدیک به تاریخ انتشارشان، معمولاً در طول فاز بتا اضافه می‌شوند.
• پشتیبانی از نسخه‌های قدیمی ۱۸ ماه پس از پایان عمر (EOL) در CPython https://devguide.python.org/versions متوقف می‌شود، که به کاربران زمان کافی برای مهاجرت می‌دهد.

• 21.5.0 (2026-06-13): پشتیبانی از اجرا تحت Python 3.8 و پیش از آن و همچنین ساخت محیط برای آن‌ها متوقف شد.
• 20.27.0 (2024-10-17): پشتیبانی از اجرا تحت Python 3.7 و پیش از آن متوقف شد.
• 20.22.0 (2023-04-19): پشتیبانی از ساخت محیط برای Python 3.6 و پیش از آن متوقف شد.
• 20.18.0 (2023-02-06): پشتیبانی از اجرا تحت Python 3.6 و پیش از آن متوقف شد.

• نصب‌های انجام‌شده از python.org https://www.python.org/downloads
• ساخت‌های python-build-standalone https://github.com/astral-sh/python-build-standalone (استفاده‌شده توسط uv https://docs.astral.sh/uv و mise https://mise.jdx.dev)
• نسخه‌های Python مدیریت‌شده توسط pyenv https://github.com/pyenv/pyenv، mise https://mise.jdx.dev یا asdf https://asdf-vm.com (فایل‌های shim به‌طور خودکار به دودویی واقعی نگاشت می‌شوند)

• توزیع Ubuntu 16.04 و جدیدتر (هم ساخت‌های بالادستی و هم ساخت‌های deadsnakes https://launchpad.net/~deadsnakes/+archive/ubuntu/ppa)
• Fedora
• RHEL و CentOS
• OpenSuse
• Arch Linux

• نسخه‌های Python نصب‌شده از طریق Homebrew https://docs.brew.sh/Homebrew-and-Python (کار می‌کند، اما توصیه نمی‌شود https://justinmayer.com/posts/homebrew-python-is-not-for-you -- زیرا Homebrew ممکن است نسخه‌های Python را بدون هشدار ارتقا داده یا حذف کند و محیط‌های مجازی موجود را از کار بیندازد)
• نسخهٔ Python 3 موجود در XCode (ساخت‌های چارچوب Python در /Library/Frameworks/Python3.framework/)

•

نسخهٔ Python 3.9 و جدیدتر از Windows Store https://apps.microsoft.com/search?query=python

رابط اصلی virtualenv برنامه خط فرمان است. با این حال، می‌توان از آن به صورت برنامه‌نویسی نیز از طریق تابع virtualenv.cli_run و کلاس Session استفاده کرد.

برای مثال‌های کاربردی Use virtualenv <> را ببینید.

virtualenv.cli_run(args, options=None, setup_logging=True, env=None)

ایجاد یک محیط مجازی با دریافت آرگومان‌های رابط خط فرمان.

virtualenv.session_via_cli(args, options=None, setup_logging=True, env=None)

ایجاد یک نشست virtualenv (مشابه cli_run، با این تفاوت که این تابع فرایند ساخت را انجام نمی‌دهد). اگر فقط می‌خواهید وضعیت محیط مجازی را بدون ایجاد واقعی آن بررسی و پرس‌وجو کنید، از این تابع استفاده کنید.

class virtualenv.run.session.Session(verbosity, app_data, interpreter, creator, seeder, activators)

نمایانگر یک نشست ایجاد محیط مجازی است.

فضای نام گزینه‌ها که به سازنده‌های افزونه ارسال شده و از طریق CLI، متغیرهای محیطی و فایل‌های پیکربندی مقداردهی می‌شود.

1.

ایجاد یک فایل اجرایی Python منطبق با مفسر هدف

2.

نصب بسته‌های اولیه (pip، setuptools، wheel) جهت امکان‌پذیر ساختن نصب بسته‌ها

3.

نصب اسکریپت‌های فعال‌سازی برای پوسته‌های مختلف

4.

ایجاد فایل‌های نادیده‌گیری VCS (در حال حاضر .gitignore گیت، صرف‌نظر کردن با --no-vcs-ignore)

• ایجاد محیط سریع است زیرا تنها تعداد کمی فایل باید ایجاد شوند.
• ارتقای Python سیستم ممکن است بر محیط‌های مجازی موجود تأثیر بگذارد، زیرا آن‌ها به کتابخانه استاندارد و افزونه‌های باینری Python سیستم ارجاع می‌دهند.

پیش از ساخت یک محیط مجازی، virtualenv باید یک مفسر Python را پیدا کند. مفسر، نسخهٔ Python محیط مجازی، پیاده‌سازی آن (CPython، PyPy و غیره) و معماری آن (32-bit یا 64-bit) را مشخص می‌کند.

پرچم --python چندین قالب مشخص‌کننده را می‌پذیرد:

هنگامی که یک مشخص‌کننده ارائه می‌دهید، virtualenv با استفاده از این راهبرد به جستجوی مفسرهای منطبق می‌پردازد: [نمودار]

1.

متغیر محیطی PYENV_VERSION (برای چندین نسخه با دونقطه از هم جدا می‌شوند).

2.

یک فایل .python-version در دایرکتوری جاری یا هر یک از دایرکتوری‌های والد.

3.

فایل نسخهٔ سراسری در $PYENV_ROOT/version.

ایجادکننده‌ها مسئول ساختاردهی به محیط مجازی هستند. ابزار virtualenv از دو نوع ایجادکننده پشتیبانی می‌کند:

ابزار virtualenv به‌طور پیش‌فرض در صورت دردسترس بودن ایجادکنندهٔ توکار برای محیط هدف، از آن استفاده می‌کند و در غیر این صورت به ایجادکنندهٔ venv بازمی‌گردد.

صرف‌نظر از اینکه کدام ایجادکننده اجرا شود، مفسر در نهایت تحت چندین نام قابل‌دسترس خواهد بود که در چیدمان محیط (Environment layout) <> فهرست شده‌اند. ابزارهای مختلف نام‌های متفاوتی را فراخوانی می‌کنند - ممکن است یک خط شِبانگ (shebang) به python اشاره کند، یا یک وظیفهٔ CI نام نسخه‌دار را فراخوانی نماید - و محیطی که تنها یکی از آن‌ها را ارائه دهد، عملکرد بقیه را مختل می‌کند. ایجادکننده‌های توکار نام‌های دارای نسخه را از مفسر هدف برمی‌دارند و نام فایل اجراییِ خود میزبان را نیز اضافه می‌کنند؛ بنابراین میزبانی با نام pypy3.11 یا python_d.exe همچنان با همان نامی که فراخوانندگانش استفاده می‌کنند در دسترس باقی می‌ماند.

در Windows فایل‌ها به‌جای پیوند نمادین رونوشت (کپی) می‌شوند، چرا که پیوند نمادین مفسر در آنجا قابل‌اعتماد نیست (bpo-42013 https://bugs.python.org/issue42013). از CPython 3.13 به بعد، فایلی که کپی می‌شود خود مفسر نیست، بلکه بازهدایت‌گر venvlauncher.exe برگرفته از کتابخانهٔ استاندارد میزبان است. این بازهدایت‌گر فایل pyvenv.cfg را می‌خواند و کنترل را به پیشوند پایه منتقل می‌کند، که این امر مانع از کپی شدن فایل‌های DLL و فایل zip کتابخانهٔ استاندارد در تک‌تک محیط‌ها می‌شود. اینکه فایل کپی‌شده چه نامی دارد تفاوتی در مقصد نهایی ایجاد نمی‌کند، زیرا بازهدایت‌گر هدف خود را بر اساس مقداری که درون آن کامپایل شده تعیین می‌کند، نه از روی نام فایل خودش.

• pip - نصب‌کنندهٔ بسته برای Python (همیشه نصب می‌شود).
• setuptools - کتابخانهٔ توسعه و نصب بسته (به‌طور پیش‌فرض در Python 3.12+ غیرفعال است).

بذرپاش pip (pip seeder)

این روش با ایجاد یک فرآیند فرزند pip، از بستهٔ wheel همراه pip برای نصب بسته‌های اولیه استفاده می‌کند. این زیرفرآیند یک نصب کامل شامل از حالت فشرده خارج کردن بسته‌های wheel و تولید متاداده را انجام می‌دهد. این روش قابل‌اعتماد اما کند است و معمولاً ۹۸٪ از کل زمان ساخت محیط مجازی را مصرف می‌کند.

بذرپاش app-data (app-data seeder)

این روش ایمیج‌های نصبیِ با قابلیت استفادهٔ مجدد را در دایرکتوری داده‌های برنامهٔ کاربر ایجاد می‌کند. نخستین باری که محیطی را با نسخه‌های مشخصی از بسته‌های اولیه ایجاد می‌کنید، بذرپاش app-data ایمیج‌های نصب کاملی را ساخته و در حافظهٔ نهان ذخیره می‌کند. در ایجاد محیط‌های بعدی، این ایمیج‌های از پیش ساخته‌شده صرفاً به دایرکتوری site-packages محیط مجازی پیوند داده شده یا کپی می‌شوند.

مقایسهٔ عملکرد در ایجاد محیط‌های مجازی: [graph]

در بسترهایی که به‌طور بهینه از پیوندهای نمادین پشتیبانی می‌کنند (مانند Linux و macOS)، بذرپاش app-data کاشتی تقریباً آنی را فراهم می‌کند.

می‌توانید با استفاده از متغیر محیطی VIRTUALENV_OVERRIDE_APP_DATA محل حافظهٔ نهان را بازنویسی کنید.

بسته‌های wheel توکار (Embedded wheels)

ابزار virtualenv با مجموعه‌ای از فایل‌های wheel عرضه می‌شود که مستقیماً در بسته گنجانده شده‌اند. این بسته‌ها همراه با نگارش virtualenv آزمایش شده‌اند و مجموعه‌ای پایه از بسته‌های اولیه را ارائه می‌دهند. نسخه‌های مختلف Python به نسخه‌های متفاوتی از بسته‌ها نیاز دارند، ازاین‌رو virtualenv چندین بستهٔ wheel مختلف را در خود گنجانده تا دامنهٔ گسترده‌ای از نسخه‌های Python را پشتیبانی کند.

بسته‌های wheel توکار ارتقایافته (Upgraded embedded wheels)

کاربران می‌توانند با اجرای virtualenv به همراه پرچم --upgrade-embed-wheels بسته‌های wheel توکار را به‌صورت دستی ارتقا دهند. این کار نسخه‌های جدیدتر بسته‌های اولیه را از PyPI دریافت کرده و آن‌ها را در دایرکتوری داده‌های برنامهٔ کاربر ذخیره می‌کند. فراخوانی‌های بعدی virtualenv به‌جای بسته‌های توکار پیش‌فرض، از این بسته‌های wheel ارتقایافته استفاده خواهند کرد.

همچنین virtualenv می‌تواند ارتقاهای خودکار دوره‌ای را انجام دهد (پایین‌تر را ببینید).

دایرکتوری‌های جستجوی اضافی (Extra search directories)

کاربران می‌توانند با استفاده از پرچم --extra-search-dir دایرکتوری‌های دیگری را که حاوی فایل‌های wheel هستند مشخص کنند. این قابلیت در محیط‌های بدون دسترسی به اینترنت (air-gapped) یا هنگام استفاده از ساخت‌های سفارشی بسته‌ها مفید است.

دانلود از PyPI (PyPI download)

اگر هیچ بستهٔ wheel مناسبی در مکان‌های بالا یافت نشود، یا اگر پرچم --download تنظیم شده باشد، virtualenv از pip برای دانلود آخرین نسخهٔ سازگار از PyPI استفاده خواهد کرد.

برای به‌روز نگه‌داشتن بسته‌های اولیه (seed packages) تا حدی معقول بدون نیاز به ارتقای دستی virtualenv یا اجرای --upgrade-embed-wheels توسط کاربران، virtualenv یک سامانه به‌روزرسانی خودکار دوره‌ای را پیاده‌سازی می‌کند: [graph]

دوره انتظار ۲۸ روزه کاربران را در برابر دریافت خودکار بسته‌های تازه‌منتشرشده‌ای که ممکن است حاوی باگ باشند محافظت می‌کند. تأخیر ۱ ساعته پس از بارگیری تضمین می‌کند که سامانه‌های یکپارچه‌سازی مداوم در میانه اجرا از نسخه‌های متفاوتی از بسته‌ها استفاده نکنند، که می‌تواند باعث شکست‌های گیج‌کننده در آزمون‌ها شود.

می‌توانید سازوکار به‌روزرسانی دوره‌ای را با پرچم --no-periodic-update غیرفعال کنید.

• VIRTUAL_ENV - مسیر مطلق به دایرکتوری محیط مجازی.
• VIRTUAL_ENV_PROMPT - پیشوند اعلان (نام محیط یا مقدار سفارشی از --prompt).
• PKG_CONFIG_PATH - برای شامل شدن دایرکتوری lib/pkgconfig محیط مجازی تغییر می‌یابد.

• Bash https://www.gnu.org/software/bash (activate)
• Fish https://fishshell.com (activate.fish)
• Csh/Tcsh https://www.tcsh.org (activate.csh)
• PowerShell https://learn.microsoft.com/en-us/powershell (activate.ps1)
• Windows Batch https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/cmd (activate.bat)
• Nushell https://www.nushell.sh (activate.nu)
• Python (activate_this.py) -- برای فعال‌سازی برنامه‌نویسی‌شده از درون یک فرایند در حال اجرای Python، فعال‌سازی برنامه‌نویسی‌شده <#programmatic-activation> را ببینید

• استفاده از virtualenv <> - راهنماهای کاربردی برای کارهای متداول virtualenv.
• خط فرمان <> - مستندات مرجع کامل CLI.

virtualenv.discovery

پلاگین‌های شناسایی مفسر پایتون. این پلاگین‌ها مفسرهای پایتونی را که به‌عنوان پایه برای ساخت محیط‌های مجازی استفاده خواهند شد، مکان‌یابی و شناسایی می‌کنند.

virtualenv.create

پلاگین‌های سازنده محیط مجازی. این پلاگین‌ها ساختار واقعی محیط مجازی، از جمله کپی کردن یا ایجاد پیوند نمادین (symlink) مفسر پایتون و کتابخانه استاندارد را مدیریت می‌کنند.

virtualenv.seed

پلاگین‌های نصب بسته‌های اولیه (seed). این پلاگین‌ها بسته‌های آغازین (مانند pip، setuptools و wheel) را در محیط‌های مجازی تازه ایجادشده نصب می‌کنند.

virtualenv.activate

پلاگین‌های اسکریپت فعال‌سازی شل. این پلاگین‌ها اسکریپت‌های فعال‌سازی ویژه هر شل را ایجاد می‌کنند که محیط را برای استفاده از محیط مجازی تغییر می‌دهند.

from __future__ import annotations
import subprocess
from argparse import ArgumentParser
from pathlib import Path
from virtualenv.config.cli.parser import VirtualEnvOptions
from virtualenv.discovery.discover import Discover
from virtualenv.discovery.py_info import PythonInfo
class PyEnvDiscovery(Discover):
    def __init__(self, options: VirtualEnvOptions) -> None:
        super().__init__(options)
        self.python_spec = options.python if options.python else "python"
    @classmethod
    def add_parser_arguments(cls, parser: ArgumentParser) -> None:
        parser.add_argument(
            "--python",
            dest="python",
            metavar="py",
            type=str,
            default=None,
            help="pyenv Python version to use (e.g., 3.11.0)",
        )
    def run(self) -> PythonInfo | None:
        try:
            result = subprocess.run(
                ["pyenv", "which", "python"],
                capture_output=True,
                text=True,
                check=True,
            )
            python_path = Path(result.stdout.strip())
            return PythonInfo.from_exe(str(python_path))
        except (subprocess.CalledProcessError, FileNotFoundError) as e:
            raise RuntimeError(f"Failed to locate pyenv Python: {e}") from e

افزونه خود را در حالت توسعه در کنار virtualenv نصب کنید:

$ pip install -e virtualenv-pyenv/

[virtualenv.discovery]
custom = your_package.discovery:CustomDiscovery

افزونه‌های creator ساختار محیط مجازی را می‌سازند. آنها را تحت virtualenv.create ثبت کنید.

رابط Creator را پیاده‌سازی کنید:

from __future__ import annotations
from argparse import ArgumentParser
from virtualenv.app_data.base import AppData
from virtualenv.config.cli.parser import VirtualEnvOptions
from virtualenv.create.creator import Creator, CreatorMeta
from virtualenv.discovery.py_info import PythonInfo
class CustomCreator(Creator):
    @classmethod
    def add_parser_arguments(
        cls,
        parser: ArgumentParser,
        interpreter: PythonInfo,
        meta: CreatorMeta,
        app_data: AppData,
    ) -> None:
        parser.add_argument("--custom-creator-opt", help="custom creator option")
    def __init__(self, options: VirtualEnvOptions, interpreter: PythonInfo) -> None:
        super().__init__(options, interpreter)
        self.custom_opt = options.custom_creator_opt
    def create(self) -> None:
        # Create directory structure
        self.bin_dir.mkdir(parents=True, exist_ok=True)
        # Copy or symlink Python executable
        self.install_python()
        # Set up site-packages
        self.install_site_packages()
        # Write pyvenv.cfg
        self.set_pyenv_cfg()

نقطه ورود (entry point) را با استفاده از یک الگوی نام‌گذاری که با پلتفرم و نسخهٔ پایتون مطابقت دارد ثبت کنید:

[virtualenv.create]
cpython3-posix = virtualenv.create.via_global_ref.builtin.cpython.cpython3:CPython3Posix
cpython3-win = virtualenv.create.via_global_ref.builtin.cpython.cpython3:CPython3Windows

[virtualenv.seed]
custom = your_package.seed:CustomSeeder

افزونه‌های فعال‌ساز اسکریپت‌های فعال‌سازی پوسته را تولید می‌کنند. آن‌ها را ذیل virtualenv.activate ثبت کنید.

رابط Activator را پیاده‌سازی کنید:

from __future__ import annotations
from pathlib import Path
from virtualenv.activation.activator import Activator
from virtualenv.create.creator import Creator
class CustomShellActivator(Activator):
    def generate(self, creator: Creator) -> list[Path]:
        # Generate activation script content
        script_content = self._render_template(creator)
        # Write to activation directory
        dest = creator.bin_dir / self.script_name
        dest.write_text(script_content)
        return [dest]
    def _render_template(self, creator: Creator) -> str:
        # Return activation script content
        return f"""
        # Custom shell activation script
        export VIRTUAL_ENV="{creator.dest}"
        export PATH="{creator.bin_dir}:$PATH"
        """
    @property
    def script_name(self) -> str:
        return "activate.custom"

نقطهٔ ورود را ثبت کنید:

[virtualenv.activate]
bash = virtualenv.activation.bash:BashActivator
fish = virtualenv.activation.fish:FishActivator
custom = your_package.activation:CustomShellActivator

$ virtualenv --discovery=custom --creator=custom-posix --seeder=custom --activators=custom test-env

این صفحه رابط‌هایی را مستند می‌کند که افزونه‌ها باید پیاده‌سازی کنند.

class virtualenv.discovery.discover.Discover(options)

class virtualenv.discovery.py_info.PythonInfo

شامل اطلاعات مربوط به یک مفسر Python است.

رابط داده‌های برنامه که توسط افزونه‌ها برای کَش‌سازی استفاده می‌شود.

• virtualenv.discovery
• virtualenv.create
• virtualenv.seed
• virtualenv.activate

1.

دستور virtualenv شروع به کار کرده و تمام entry pointها را از چهار گروه افزونه شناسایی می‌کند

2.

تجزیه‌کننده خط فرمان (CLI parser) به‌صورت پویا ساخته می‌شود و گزینه‌های تمامی افزونه‌های شناسایی‌شده را در بر می‌گیرد

3.

آرگومان‌های کاربر برای انتخاب این‌که کدام افزونه‌های discovery، creator، seeder و activator استفاده شوند، تجزیه می‌شوند

4.

افزونه‌های انتخاب‌شده به ترتیب اجرا می‌شوند: discover → create → seed → activate

5.

هر مرحله خروجی خود را به مرحله بعدی ارسال می‌کند

کلاس پایه انتزاعی

هر نقطه گسترش یک کلاس پایه انتزاعی (Discover، Creator، Seeder، Activator) تعریف می‌کند که رابطی را که افزونه‌ها باید پیاده‌سازی کنند، مشخص می‌سازد.

پیاده‌سازی‌های توکار

نرم‌افزار virtualenv شامل پیاده‌سازی‌های توکاری است که به عنوان entry point در pyproject.toml خود آن ثبت شده‌اند. برای نمونه، سازنده توکار CPython به عنوان cpython3-posix ثبت شده است.

افزونه‌های شخص ثالث

بسته‌های خارجی رابط پایه را پیاده‌سازی کرده و entry pointهای خود را تحت همان گروه ثبت می‌کنند. پس از نصب، آن‌ها در کنار گزینه‌های توکار ظاهر می‌شوند.

گزینش در خط فرمان

پرچم‌های خط فرمان (--discovery، --creator، --seeder، --activators) به کاربران اجازه می‌دهند انتخاب کنند کدام پیاده‌سازی استفاده شود. چندین activator می‌توانند به‌طور هم‌زمان انتخاب شوند.

یکپارچه‌سازی با تجزیه‌کننده

هر افزونه می‌تواند از طریق متد کلاسی add_parser_arguments آرگومان‌های خط فرمان را اضافه کند. این آرگومان‌ها در virtualenv --help ظاهر می‌شوند و در صورت انتخاب افزونه، در دسترس خواهند بود.

Discovery → Creator

افزونه discovery یک شیء PythonInfo ایجاد می‌کند که مفسر مبدأ Python را توصیف می‌نماید. این شیء حاوی فراداده‌هایی درباره نسخه Python، پلتفرم، مسیرها و قابلیت‌ها است. افزونه creator این PythonInfo را دریافت کرده و از آن برای تعیین نحوه ساخت ساختار محیط مجازی استفاده می‌کند.

Creator → Seeder

افزونه creator یک شیء Creator ایجاد می‌کند که نشان‌دهنده محیط مجازی تازه‌ساخته‌شده است. این شیء شامل مسیرهای دایرکتوری bin محیط، site-packages و فایل اجرایی Python است. افزونه seeder از این مسیرها برای نصب بسته‌ها استفاده می‌کند.

Seeder → Activator

پس از تکمیل عملیات بذرپاشی (seeding)، افزونه‌های activator از شیء Creator برای تولید اسکریپت‌های فعال‌سازی پوسته استفاده می‌کنند. این اسکریپت‌ها برای پیکربندی محیط پوسته، به دایرکتوری bin محیط و مسیرهای دیگر ارجاع می‌دهند.

•

git clone https://github.com/pypa/virtualenv
cd virtualenv

• مفسر Python: توصیه می‌کنیم از CPython استفاده کنید. می‌توانید از این راهنما https://realpython.com/installing-python برای راه‌اندازی آن استفاده نمایید.
• ابزار tox https://pypi.org/project/tox: برای دریافت خودکار وابستگی‌های توسعه پروژه و اجرای مجموعه آزمون‌ها. توصیه می‌کنیم آن را با استفاده از pipx https://pipxproject.github.io/pipx نصب کنید.

  ساده‌ترین روش برای این کار، ایجاد محیط توسعهٔ tox و سپس فراخوانی virtualenv از درون پوشهٔ .tox/dev است.

tox -e dev
.tox/dev/bin/virtualenv  # on Linux
.tox/dev/Scripts/virtualenv  # on Windows

• از from __future__ import annotations در بالای هر ماژول استفاده کنید (توسط تنظیمات required-imports در ruff الزامی شده است).
• واردکردن‌هایی را که فقط برای بررسی نوع (type checking) نیاز هستند در داخل یک بلوک if TYPE_CHECKING: قرار دهید تا از سربار زمان اجرا جلوگیری شود.
• قوانین ANN در ruff فعال هستند. قاعده ANN401 (typing.Any) به‌صورت موردی با یادداشت‌های درون‌خطی # noqa: ANN401 در مواردی که واقعاً به Any نیاز است (مانند serialization و dynamic dispatch) نادیده گرفته می‌شود.
• انواع مشخص (concrete types) را بر Any ترجیح دهید. از Union / | برای پارامترهای تهی‌پذیر (nullable) یا چندنوعی استفاده کنید.
• هنگامی که یک خطای نوع واقعاً غیرقابل رفع است (مانند محدودیت‌های کتابخانه‌های شخص ثالث)، آن را با یک یادداشت درون‌خطی # ty: ignore[rule-name] و یک توضیح توجیهی کوتاه نادیده بگیرید.

• virtualenv.png نشان‌واره رسمی است — مارهای پیچیده‌شده دور یک ترمینال، به همراه علامت نوشتاری (wordmark). این فایل نشان‌واره وب‌سایت (light_logo/dark_logo در docs/conf.py) و فایلی است که در هر جا به نشان‌واره virtualenv نیاز باشد باید استفاده شود.
• virtualenv.svg یک نشان ساده‌شده است که تنها به عنوان آیکون مرورگر یا favicon (html_favicon) استفاده می‌شود، چرا که نسخه پرجزئیات PNG در اندازه ۱۶×۱۶ ناخوانا خواهد بود. این یک نسخه برداری (vector) از فایل PNG نیست.

1.

به Pre-release workflow https://github.com/pypa/virtualenv/actions/workflows/pre-release.yaml در GitHub بروید.

2.

روی Run workflow کلیک کرده و نوع افزایش نسخه را انتخاب نمایید (auto، major، minor یا patch).

• feature.rst,
• bugfix.rst,
• doc.rst,
• removal.rst,
• misc.rst.

• Paul Moore https://github.com/pfmoore
• Ian Bicking https://github.com/ianb
• Donald Stufft https://github.com/dstufft

•

نبود یک منبع لازم برای هر دو حالت نصب، اکنون سازندهٔ توکار را از طریق meta.error غیرفعال می‌کند. این بررسی مقادیر RefWhen را با اعضای RefMust مقایسه می‌کرد، بنابراین فرآیند ایجاد با یک FileNotFoundError یا یک پیوند نمادینِ معلق (dangling symlink) شکست می‌خورد - توسط @darrenhuai https://github.com/darrenhuai. (#3227 https://github.com/pypa/virtualenv/issues/3227)

•

ارتقای حداقل نسخهٔ python-discovery به >=1.6 برای PythonInfo.system_exe، که مفسر سیستم را بدون تایپینگ مجاز به تهیِ system_executable گزارش می‌دهد - توسط @gaborbernat https://github.com/gaborbernat. (#3224 https://github.com/pypa/virtualenv/issues/3224)

•

مستندسازی نام‌هایی که مفسر درون یک محیط ایجادشده به آن‌ها پاسخ می‌دهد. صفحهٔ جدید ساختار محیط (Environment layout) <> آن‌ها را به تفکیک پلتفرم فهرست می‌کند، راهنماهای آموزشی و کاربری به آن اشاره دارند، و توضیحات سازنده‌ها پوشش می‌دهد که چرا یک محیط چندین نام را حمل می‌کند و چرا ویندوز یک بازهدایت‌کننده (redirector) را کپی می‌کند - توسط @gaborbernat https://github.com/gaborbernat. (#3225 https://github.com/pypa/virtualenv/issues/3225)

•

در ویندوز، virtualenv دیگر واسط (shim) مربوط به venvlauncher.exe در CPython 3.13+ را با نام خودِ واسط در Scripts کپی نمی‌کند، و میزبان‌هایی مانند python_d.exe نام مستعار خود را پس می‌گیرند. مجموعهٔ نام‌های مستعار، نام‌های خود را از واسطی که جانشین مفسر می‌شود می‌گرفت، بنابراین هر محیط یک نسخهٔ کپی ناخواسته از اجراکننده دریافت می‌کرد و نام فایل اصلیِ خود مفسر حذف می‌شد - توسط @darrenhuai https://github.com/darrenhuai. (#3223 https://github.com/pypa/virtualenv/issues/3223)

• اصلاح بررسی نوع (type check) در برابر python-discovery نسخهٔ 1.5.2، که حاشیه‌نویسی‌های آن مقدار None را برای prefix و مقادیر عدد صحیح را برای sysconfig_vars مجاز می‌دانند: جایگزینی متغیرهای پیکربندی اکنون از پیشوند ناموجود صرف‌نظر می‌کند و مکان‌یابی libpython اشتراکی نیازمند مقادیر رشته‌ای برای INSTSONAME/LIBDIR است. (#3211 https://github.com/pypa/virtualenv/issues/3211)
• متد ExePathRef.can_run اکنون بیت‌های اجرایی گروه و دیگران را به جای فقط بیت مالک بررسی می‌کند، و هنگامی که یک فایل هیچ‌یک از این سه را نداشته باشد، به جای None مقدار False برمی‌گرداند - توسط @darrenhuai https://github.com/darrenhuai. (#3217 https://github.com/pypa/virtualenv/issues/3217)
• تابع safe_delete دیگر ignore_errors=True را به shutil.rmtree ارسال نمی‌کند، زیرا این کار گردانندهٔ chmod-and-retry خودش را با یک عملیات بی‌اثر (no-op) جایگزین می‌کرد و تمامی خطاها را نادیده می‌گرفت. فایل‌های فقط‌خواندنی - تمام فایل‌های درون ایمیج یک wheel، که توسط set_tree علامت‌گذاری می‌شوند - باقی می‌ماندند، بنابراین گزینه‌های --reset-app-data و --clear درخت‌هایی را که گزارش حذف آن‌ها را داده بودند دست‌نخورده نگه می‌داشتند. این گرداننده اکنون تنها خودِ عملیات حذف را مجدداً تلاش می‌کند، سایر بیت‌های حالت مجوز را حفظ می‌کند، و برای هر چیزی که نتواند پاک کند خطای اصلی را صادر می‌کند - توسط @darrenhuai https://github.com/darrenhuai. (#3222 https://github.com/pypa/virtualenv/issues/3222)

•

ارتقای wheelهای تعبیه‌شده:

•

متد ListType.split_values اکنون یک list بازمی‌گرداند که می‌توانید بیش از یک بار روی آن پیمایش کنید، و به جای صدور خطای TypeError ورودی از نوع bytes را می‌پذیرد - توسط @darrenhuai https://github.com/darrenhuai. (#3207 https://github.com/pypa/virtualenv/issues/3207)

•

ارتقای wheelهای تعبیه‌شده:

•

ارتقای wheelهای تعبیه‌شده:

•

مستندسازی این که virtualenv.png نشان رسمی و virtualenv.svg نماد ساده‌شده صرفاً برای favicon است - توسط @gaborbernat https://github.com/gaborbernat. (#3199 https://github.com/pypa/virtualenv/issues/3199)

•

اعلام پشتیبانی از Python 3.15: فرآیند CI اکنون در برابر نسخه بتای CPython 3.15، از جمله ساختِ free-threaded 3.15t آزمایش می‌شود، و رده‌بند Programming Language :: Python :: 3.15 اعلان شده است. (#3192 https://github.com/pypa/virtualenv/issues/3192)

•

مقاوم‌سازی اعلان (prompt) فعال‌کننده fish در برابر توابع کاربری که دستورات توکار (builtins) را هم‌پوشانی (shadow) می‌کنند. هدایت functions، printf، string، echo و source/. از طریق builtin مانع از آن می‌شود که یک تابع هم‌پوشاننده (مانند ابزار ناوبری دایرکتوری به سبک نقطه که . را بازتعریف می‌کند) اعلان را برباید و وضعیت خروج (exit status) دستور قبلی را نادیده بگیرد؛ مطابق با رفع اشکال CPython در gh-140006 https://github.com/python/cpython/issues/140006. (#3185 https://github.com/pypa/virtualenv/issues/3185)

•

توقف نصب قلاب واردسازی distutils با نام _virtualenv.{py,pth} برای Python 3.10 و بالاتر، که در آن‌ها pip، setuptools و CPython از پیش کلیدهای پیکربندی نصبی را که این قلاب از آن‌ها محافظت می‌کرد نادیده می‌گیرند؛ این امر هزینه واردسازی این قلاب در زمان راه‌اندازی را حذف می‌کند. این قلاب همچنان برای Python 3.9 نصب می‌شود - #3181 https://github.com/pypa/virtualenv/issues/3181. (#3181 https://github.com/pypa/virtualenv/issues/3181)

•

ارتقای wheelهای تعبیه‌شده:

•

رد ایجاد محیط‌هایی که نسخه پایتون آن‌ها دیگر توسط wheelهای همراه پوشش داده نمی‌شود (در حال حاضر نسخه‌های پیش از 3.9). virtualenv پیش‌تر جدیدترین pip بسته‌بندی‌شده را جایگزین می‌کرد که روی چنین مقصدی قابل اجرا نبود و محیطی خراب به جا می‌گذاشت؛ اکنون سامانه انتخاب seeder آن را از همان ابتدا با خطایی واضح رد می‌کند. --no-seed و seederهای متفرقه شخص ثالث که wheelهای سازگار ارائه می‌دهند همچنان کار می‌کنند - توسط @gaborbernat https://github.com/gaborbernat. (#3171 https://github.com/pypa/virtualenv/issues/3171)

•

توقف پشتیبانی از Python 3.8؛ اکنون virtualenv برای اجرا و ساخت محیط‌ها به Python 3.9 یا بالاتر نیاز دارد. حذف بسته seed تعبیه‌شدهٔ wheel، که virtualenv آن را فقط برای Python 3.8 به همراه داشت. گزینه‌های --wheel و --no-wheel به عنوان گزینه‌های بی‌اثر (no-ops) باقی می‌مانند، اما اکنون هشدار می‌دهند که virtualenv آن‌ها را در نگارشی پس از 2026-12 حذف خواهد کرد - توسط @gaborbernat https://github.com/gaborbernat. (#3170 https://github.com/pypa/virtualenv/issues/3170)

•

ارتقای wheelهای تعبیه‌شده:

حذف wheel مربوط به نسخه 0.47.0 (#u https://github.com/pypa/virtualenv/issues/u)

•

ارتقای wheelهای تعبیه‌شده:

• حل پیوندهای نمادین (symlink) مخصوص فایل اجرایی هنگام ثبت home و base-executable در pyvenv.cfg، مشابه با getpath.realpath در CPython (python/cpython#115237)، تا محیط‌های ایجادشده از روی یک پیوند نمادین به باینری مفسر بتوانند stdlib پایه را پیدا کنند (برای مثال python-build-standalone)؛ یک درخت مفسر با پیوند نمادین کامل دست‌نخورده باقی می‌ماند - توسط @gaborbernat https://github.com/gaborbernat. (#3157 https://github.com/pypa/virtualenv/issues/3157)
• توقف export کردن PS1 از فعال‌ساز bash تا فرآیندهای فرزند وضعیت خط فرمان پوسته را به ارث نبرند. (#3158 https://github.com/pypa/virtualenv/issues/3158)
• مدیریت تبدیل مسیرهای CYGWIN/MSYS/MINGW در اسکریپت فعال‌سازی fish - توسط user::LuNoX. (#3160 https://github.com/pypa/virtualenv/issues/3160)

•

جلوگیری از متوقف شدن deactivate در اسکریپت فعال‌سازی bash/zsh تحت set -e در صورت شکست hash -r (برای مثال هنگامی که hashing پوسته غیرفعال است) با افزودن || true، مشابه venv در CPython (gh-149701) و فراخوانی غیر-deactivate موجود - توسط @gaborbernat https://github.com/gaborbernat. (#3152 https://github.com/pypa/virtualenv/issues/3152)

•

رفع مشکلی که در آن جایگزینی venvlauncher_d.exe در ساخت خطایابی ویندوز هرگز اجرا نمی‌شد زیرا executables() نام فایل اجرایی مبدأ را به جای نام مقصد مقایسه می‌کرد، و رفع خطای AttributeError روی مشخصهٔ debug_build برای اشیاء اطلاعات مفسر که فاقد این فیلد بودند - توسط @gaborbernat https://github.com/gaborbernat. (#3151 https://github.com/pypa/virtualenv/issues/3151)

• حذف کدهای مردهٔ مربوط به نسخه‌های پایتون پایین‌تر از محدودهٔ هدفِ پشتیبانی‌شده (PyPy 3.6، رابط‌های منسوخ‌شدهٔ importlib) و ساده‌سازی قلاب واردسازی زمان اجرا در _virtualenv.py - توسط @gaborbernat https://github.com/gaborbernat. (#3149 https://github.com/pypa/virtualenv/issues/3149)
• پشتیبانی از ساخت‌های خطایابی ویندوز (python_d.exe، venvlauncher_d.exe) مطابق با رفتار venv در CPython، حذف جایگزینی مردهٔ __SCRIPT_DIR__ و محافظ نسخهٔ has_shim، حذف شاخهٔ غیرقابل‌دسترس Python 3.7 از pyvenv_launch_patch_active، و اصلاح پیام منسوخ شدن wheel به عبارت >= 3.9 - توسط @gaborbernat https://github.com/gaborbernat. (#3150 https://github.com/pypa/virtualenv/issues/3150)

•

شناسایی مفسرهای GraalPy با استفاده از نام نرمال‌شدهٔ GraalPy - توسط @timfel https://github.com/timfel. (#3144 https://github.com/pypa/virtualenv/issues/3144)

•

ارتقای wheelهای تعبیه‌شده:

•

معرفی مجدد فعال‌ساز پوستهٔ xonsh (activate.xsh) که پیش‌تر در 20.7.0 حذف شده بود، و ترجیح دادن نقاط ورودی پیش‌فرض virtualenv توسط بارگذار افزونه‌ها به طوری که یک بستهٔ شخص ثالث نتواند با ثبت نام تکراری آن‌ها را بازنویسی کند. (#3003 https://github.com/pypa/virtualenv/issues/3003)

•

ارتقای wheelهای تعبیه‌شده:

• مقاوم‌سازی امنیتی: اعتبارسنجی هر مدخل در آرشیو seed wheel پیش از استخراج آن، تا یک wheel دست‌کاری‌شده نتواند از طریق مسیر مطلق یا پیمایش با .. از دایرکتوری تصویر app-data خارج شود. (#3118 https://github.com/pypa/virtualenv/issues/3118)
• مقاوم‌سازی امنیتی: راستی‌آزمایی SHA-256 هر seed wheel بسته‌بندی‌شده هنگام بارگذاری آن، تا در صورت خراب یا دست‌کاری شدن فایل روی دیسک، به‌جای تحویل داده شدن به pip با خطای صریح متوقف شود. جدول درهم‌سازی (hash table) در کنار BUNDLE_SUPPORT توسط tasks/upgrade_wheels.py تولید می‌شود. (#3119 https://github.com/pypa/virtualenv/issues/3119)
• مقاوم‌سازی امنیتی: اعتبارسنجی نام توزیع و مشخص‌کنندهٔ نسخهٔ ارسالی به pip download هنگام دریافت seed wheel، تا extras، پرچم‌های pip یا فرامنویسه‌های شل (shell metacharacters) نتوانند به خط فرمان subprocess تزریق شوند. (#3120 https://github.com/pypa/virtualenv/issues/3120)
• مقاوم‌سازی امنیتی: جایگزینی بررسی اشتمال پیشوند رشته‌ای در virtualenv.util.zipapp با Path.relative_to تا توابع کمکی استخراج zipapp هر مسیری را که ذیل ریشهٔ آرشیو قرار نگیرد، رد کنند. (#3121 https://github.com/pypa/virtualenv/issues/3121)
• مقاوم‌سازی امنیتی: عدم بازگشت خاموش به یک بافت (context) تأییدنشدهٔ HTTPS زمانی که درخواست دوره‌ای به‌روزرسانی به PyPI در راستی‌آزمایی TLS شکست می‌خورد. متادادهٔ بازگردانده‌شده مشخص می‌کند که virtualenv کدام نسخهٔ wheel را "به‌روز" تلقی کند، بنابراین پذیرش پاسخی تأییدنشده به مهاجم در سطح شبکه اجازه می‌دهد به‌روزرسانی‌های امنیتی را سرکوب کند. مقدار VIRTUALENV_PERIODIC_UPDATE_INSECURE=1 را برای بازگرداندن رفتار قبلی روی میزبان‌هایی با مخازن اعتماد (trust stores) خراب، تنظیم کنید. (#3122 https://github.com/pypa/virtualenv/issues/3122)

•

افزایش حداقل نسخهٔ python-discovery به >=1.2.2 جهت گنجاندن پشتیبانی از normalize_isa - توسط @rahuldevikar https://github.com/rahuldevikar. (#3117 https://github.com/pypa/virtualenv/issues/3117)

•

ارتقای wheelهای تعبیه‌شده:

•

استفاده از عرض ترمینال برای قالب‌بندی پیام راهنما به‌جای مقدار ثابت ۲۴۰. (#3110 https://github.com/pypa/virtualenv/issues/3110)

•

به‌روزرسانی مولد wheelهای تعبیه‌شده (tasks/upgrade_wheels.py) جهت گنجاندن حاشیه‌نویسی‌های نوع (type annotations) در خروجی تولیدشده - توسط @rahuldevikar https://github.com/rahuldevikar. (#3075 https://github.com/pypa/virtualenv/issues/3075)

• ارسال --without-scm-ignore-files به subprocess venv در Python 3.13+ تا ایجاد .gitignore در کنترل virtualenv باشد؛ که این امر رفتار ناپایدار در test_create_no_seed و نادیده گرفته شدن --no-vcs-ignore در مسیر subprocess را رفع می‌کند - توسط @gaborbernat https://github.com/gaborbernat. (#3089 https://github.com/pypa/virtualenv/issues/3089)
• استفاده از BASH_SOURCE[0] به‌جای $0 در سازوکار جایگزین تغییر مکان اسکریپت فعال‌سازی bash، که مشکل مقدار نادرست PATH را هنگام source کردن اسکریپت فعال‌سازی از یک دایرکتوری دیگر برطرف می‌کند - توسط @gaborbernat https://github.com/gaborbernat. (#3090 https://github.com/pypa/virtualenv/issues/3090)

•

افزودن حاشیه‌نویسی‌های جامع نوع در سرتاسر کدبیس و ارائهٔ نشانگر PEP 561 py.typed تا مصرف‌کنندگان پایین‌دستی و بررسی‌کننده‌های نوع، virtualenv را به‌عنوان بسته‌ای با انواع درون‌خطی (inline-typed) شناسایی کنند - توسط @rahuldevikar https://github.com/rahuldevikar. (#3075 https://github.com/pypa/virtualenv/issues/3075)

•

منطق شناسایی پایتون (Python discovery) در قالب یک بستهٔ مستقل به نام python-discovery در PyPI استخراج شده است (مستندات در https://python-discovery.readthedocs.io) و اکنون به‌عنوان یک وابستگی استفاده می‌شود. اگر پیش‌تر بخش‌های داخلی discovery را مستقیماً وارد می‌کردید (مانند from virtualenv.discovery.py_info import PythonInfo)، آن را به from python_discovery import PythonInfo تغییر دهید. لایه‌های تطبیقی بازصادرکننده برای سازگاری با نسخه‌های پیشین در virtualenv.discovery.py_info، virtualenv.discovery.py_spec و virtualenv.discovery.cached_py_info ارائه شده‌اند، با این حال پشتیبانی‌نشده تلقی می‌شوند و ممکن است در نسخه‌های بعدی حذف شوند - توسط @gaborbernat https://github.com/gaborbernat. (#3070 https://github.com/pypa/virtualenv/issues/3070)

•

افزودن پشتیبانی از ایجاد محیط‌های مجازی با RustPython - توسط @elmjag https://github.com/elmjag. (#3010 https://github.com/pypa/virtualenv/issues/3010)

• حل خودکار shimهای برنامه‌های مدیریت نسخه (pyenv، mise، asdf) به باینری واقعی Python در طول فرایند شناسایی، برای جلوگیری از انتخاب نادرست مفسر هنگامی که shimها در PATH هستند - توسط @gaborbernat https://github.com/gaborbernat. (#3049 https://github.com/pypa/virtualenv/issues/3049)
• افزودن آگاهی از معماری (ISA) به فرایند شناسایی Python — کاربران اکنون می‌توانند یک پسوند معماری CPU در رشته مشخصات --python (مانند cpython3.12-64-arm64) تعیین کنند تا بین مفسرهایی با نسخه و تعداد بیت یکسان اما معماری‌های هدف متفاوت، تمایز قائل شوند. از sysconfig.get_platform() به عنوان منبع داده همراه با یکسان‌سازی چندسکویی (amd64 ↔ x86_64، aarch64 ↔ arm64) استفاده می‌کند. حذف این پسوند رفتار پیشین را حفظ می‌کند - توسط @rahuldevikar https://github.com/rahuldevikar. (#3059 https://github.com/pypa/virtualenv/issues/3059)

• ذخیره داده‌های برنامه (حافظه‌های موقت pip/setuptools/wheel) در دایرکتوری کش سیستم‌عامل (platformdirs.user_cache_dir) به جای دایرکتوری داده‌ها (platformdirs.user_data_dir). داده‌های موجود برنامه در مکان قبلی، در نخستین استفاده به صورت خودکار منتقل می‌شوند. این امر تضمین می‌کند فایل‌های کش‌شده‌ای که امکان بارگیری مجدد دارند در محل استاندارد کش (مانند ~/.cache در لینوکس، ~/Library/Caches در macOS) قرار گیرند تا از فایل‌های پشتیبان مستثنی شده و توسط ابزارهای سیستم قابل پاک‌سازی باشند - توسط @rahuldevikar https://github.com/rahuldevikar. (#1884 https://github.com/pypa/virtualenv/issues/1884) (#1884 https://github.com/pypa/virtualenv/issues/1884)
• افزودن پشتیبانی از متغیر محیطی PKG_CONFIG_PATH به تمامی اسکریپت‌های فعال‌سازی (Bash، Batch، PowerShell، Fish، C Shell، Nushell و Python). اکنون دایرکتوری lib/pkgconfig مربوط به virtualenv هنگام فعال‌سازی به طور خودکار به ابتدای PKG_CONFIG_PATH افزوده شده و هنگام غیرفعال‌سازی بازیابی می‌شود، که به بسته‌های استفاده‌کننده از pkg-config در حین ساخت/نصب امکان می‌دهد فایل‌های پیکربندی خود را پیدا کنند - توسط @rahuldevikar https://github.com/rahuldevikar. (#2637 https://github.com/pypa/virtualenv/issues/2637)
• ارتقای pip تعبیه‌شده به 26.0.1 از 25.3 و setuptools به 82.0.0، 75.3.4 از 75.3.2، 80.9.0 - توسط @rahuldevikar https://github.com/rahuldevikar. (#3027 https://github.com/pypa/virtualenv/issues/3027)
• جایگزینی کامنت‌های ty: ignore با باریک‌سازی مناسب نوع (type narrowing) با استفاده از assertionها و بررسی‌های صریح None - توسط @rahuldevikar https://github.com/rahuldevikar. (#3029 https://github.com/pypa/virtualenv/issues/3029)

• جلوگیری از کپی شدن DLLهای pywin32 (pywintypes*.dll، pythoncom*.dll) در دایرکتوری Scripts هنگام ساخت virtualenv در Windows. این کار مشکلات سازگاری با pywin32 را برطرف می‌کند، چرا که انتظار دارد DLLهایش توسط اسکریپت پس از نصب اختصاصی خودش در site-packages/pywin32_system32 قرار گیرند - توسط @rahuldevikar https://github.com/rahuldevikar. (#2662 https://github.com/pypa/virtualenv/issues/2662)
• حفظ پیوندهای نمادین (symlinks) در مسیرهای pyvenv.cfg برای تطابق با رفتار venv. استفاده از os.path.abspath() به جای os.path.realpath() جهت یکسان‌سازی مسیرها بدون حل کردن پیوندهای نمادین، که مشکلات مربوط به نصب‌های Python با دسترسی از طریق دایرکتوری‌های پیوند نمادین (رایج در سیستم‌های فایل متصل از طریق شبکه) را رفع می‌کند - توسط @rahuldevikar https://github.com/rahuldevikar. رفع اشکال #2770 https://github.com/pypa/virtualenv/issues/2770. (#2770 https://github.com/pypa/virtualenv/issues/2770)
• اصلاح اسکریپت‌های فعال‌سازی Windows جهت قرار دادن صحیح مسیر python.exe در علامت نقل‌قول (کوتیشن)، برای جلوگیری از خرابی در مواردی که Python در مسیری دارای فاصله (مانند C:\Program Files) نصب شده و فایلی به نام C:\Program روی سیستم‌فایل وجود دارد - توسط @rahuldevikar https://github.com/rahuldevikar. (#2985 https://github.com/pypa/virtualenv/issues/2985)
• اصلاح سازگاری با bash -u (set -o nounset) در اسکریپت فعال‌سازی bash با بهره‌گیری از ${PKG_CONFIG_PATH:-} و ${PKG_CONFIG_PATH:+:${PKG_CONFIG_PATH}} جهت مدیریت PKG_CONFIG_PATH تعریف‌نشده - توسط @Fridayai700 https://github.com/Fridayai700. (#3044 https://github.com/pypa/virtualenv/issues/3044)
• مدیریت مناسب کش معیوب روی دیسک و JSON نامعتبر حاصل از زیرفرایند بازجویی Python به جای توقف ناگهانی برنامه با خطاهای مدیریت‌نشدهٔ JSONDecodeError یا KeyError - توسط @gaborbernat https://github.com/gaborbernat. (#3054 https://github.com/pypa/virtualenv/issues/3054)

•

رفع آسیب‌پذیری‌های TOCTOU در هنگام ساخت app_data و دایرکتوری قفل که می‌توانست از طریق حملات پیوند نمادین (symlink) مورد سوءاستفاده قرار گیرد - گزارش شده توسط @tsigouris007 https://github.com/tsigouris007، رفع شده توسط @gaborbernat https://github.com/gaborbernat. (#3013 https://github.com/pypa/virtualenv/issues/3013)

•

افزودن پشتیبانی از مشخص‌کننده‌های نسخه طبق PEP 440 در گزینه --python. کاربران اکنون می‌توانند با عملگرهایی مانند >=، <=، ~= و غیره نسخه‌های Python را مشخص کنند. برای مثال: virtualenv --python=">=3.12" myenv . (:issue:`2994)

• رفع وضعیت رقابتی (race condition) در _virtualenv.py هنگام رونویسی فایل حین ایمپورت، که از بروز NameError هنگام دسترسی به _DISTUTILS_PATCH جلوگیری می‌کند - توسط @gracetyy https://github.com/gracetyy. (#2969 https://github.com/pypa/virtualenv/issues/2969)
• ارتقای wheelهای تعبیه‌شده:

•

پذیرش RuntimeError در test_too_many_open_files، توسط @esafak https://github.com/esafak (#2935 https://github.com/pypa/virtualenv/issues/2935)

•

بازگردانی تغییرات مربوط به استخراج ماژول discovery - توسط @gaborbernat https://github.com/gaborbernat. (#2978 https://github.com/pypa/virtualenv/issues/2978)

• اعمال پچ روی get_interpreter برای مدیریت نبود cache و app_data - توسط @esafak https://github.com/esafak (#2972 https://github.com/pypa/virtualenv/issues/2972)
• رفع تغییرات ناسازگار با نسخه‌های پیشین در PythonInfo - توسط @gaborbernat https://github.com/gaborbernat. (#2975 https://github.com/pypa/virtualenv/issues/2975)

• افزودن پروتکل‌های AppData و Cache به discovery جهت جداسازی وابستگی‌ها (decoupling) - توسط @esafak https://github.com/esafak. (#2074 https://github.com/pypa/virtualenv/issues/2074)
• اطمینان از وجود python3.exe و python3 در Windows برای Python 3 - توسط @esafak https://github.com/esafak. (#2774 https://github.com/pypa/virtualenv/issues/2774)

• جایگزینی ارجاعات مستقیم به مسیرهای کتابخانه tcl/tk با getattr - توسط @esafak https://github.com/esafak (#2944 https://github.com/pypa/virtualenv/issues/2944)
• بازگردانی واردسازی مطلق (absolute import) برای fs_is_case_sensitive - توسط @esafak https://github.com/esafak. (#2955 https://github.com/pypa/virtualenv/issues/2955)

• انتزاع کشینگ در discovery - توسط @esafak https://github.com/esafak. جداسازی FileCache از py_info (در discovery) - توسط @esafak https://github.com/esafak. حذف ارجاعات به py_info در FileCache - توسط @esafak https://github.com/esafak. جداسازی discovery از افزایه‌های creator - توسط @esafak https://github.com/esafak. جداسازی discovery با تکثیر ابزارهای info utils - توسط @esafak https://github.com/esafak. (#2074 https://github.com/pypa/virtualenv/issues/2074)
• افزودن پشتیبانی از PyPy 3.11. با مشارکت @esafak https://github.com/esafak. (#2932 https://github.com/pypa/virtualenv/issues/2932)

• ارتقای wheel تعبیه‌شده pip به 25.2 از 25.1.1 - توسط @gaborbernat https://github.com/gaborbernat. (#2333 https://github.com/pypa/virtualenv/issues/2333)
• پذیرش RuntimeError در test_too_many_open_files، توسط @esafak https://github.com/esafak (#2935 https://github.com/pypa/virtualenv/issues/2935)
• اولویت داشتن Python موجود در PATH نسبت به python مدیریت‌شده توسط uv. با مشارکت @edgarrmondragon https://github.com/edgarrmondragon. (#2952 https://github.com/pypa/virtualenv/issues/2952)

• استخراج صحیح پاسخ ()_get_tcl_tk_libs در PythonInfo. با مشارکت @esafak https://github.com/esafak. (#2930 https://github.com/pypa/virtualenv/issues/2930)
• بازگردانی برچسب زمانی فایل py_info.py در test_py_info_cache_invalidation_on_py_info_change با مشارکت @esafak https://github.com/esafak. (#2933 https://github.com/pypa/virtualenv/issues/2933)

•

افزودن پشتیبانی از Tcl و Tkinter. خواهش می‌کنم! با مشارکت @esafak https://github.com/esafak. (#425 https://github.com/pypa/virtualenv/issues/425)

• جلوگیری از راه‌اندازی ثبت وقایع (logging) هنگامی که --help ارسال شده باشد، جهت رفع یک آزمون ناپایدار (flaky test). با مشارکت @esafak https://github.com/esafak. (#u https://github.com/pypa/virtualenv/issues/u)
• رفع مشکل ابطال حافظه موقت (cache invalidation) برای PythonInfo از طریق درهم‌سازی فایل py_info.py. با مشارکت @esafak https://github.com/esafak. (#2467 https://github.com/pypa/virtualenv/issues/2467)
• هنگامی که هیچ افزایه کشفی (discovery plugin) یافت نمی‌شد، برنامه با StopIteration دچار توقف غیرمنتظره می‌شد. این تغییر، StopIteration را مدیریت کرده و یک RuntimeError با پیامی واضح‌تر صادر می‌کند. با مشارکت @esafak https://github.com/esafak. (#2493 https://github.com/pypa/virtualenv/issues/2493)
• جلوگیری از بازنویسی مسیرهای مطلق --python توسط --try-first-with. با مشارکت @esafak https://github.com/esafak. (#2659 https://github.com/pypa/virtualenv/issues/2659)
• اجباری کردن کدگذاری UTF-8 برای دستور pip download با مشارکت @esafak https://github.com/esafak. (#2780 https://github.com/pypa/virtualenv/issues/2780)
• ایجاد محیط مجازی روی یک سیستم‌فایل بدون پشتیبانی از پیوند نمادین (symlink) حتی با گزینه --copies با شکست مواجه می‌شد؛ اکنون fs_supports_symlink یک بررسی واقعی ساخت پیوند نمادین را روی تمامی پلتفرم‌ها انجام می‌دهد. با مشارکت @esafak https://github.com/esafak. (#2786 https://github.com/pypa/virtualenv/issues/2786)
• افزودن یادداشتی به راهنمای کاربر که استفاده از یک نسخه مشخص Python را هنگام ساخت محیط‌های مجازی توصیه می‌کند. با مشارکت @esafak https://github.com/esafak. (#2808 https://github.com/pypa/virtualenv/issues/2808)
• رفع خطای 'Too many open files' ناشی از نشت توصیف‌کننده فایل (file descriptor leak) در سازوکار قفل‌گذاری virtualenv. با مشارکت @esafak https://github.com/esafak. (#2834 https://github.com/pypa/virtualenv/issues/2834)
• پشتیبانی از تغییر نام هدایت‌گرهای venv در Windows (venvlauncher.exe و venvwlauncher.exe) در Python 3.13 با مشارکت @esafak https://github.com/esafak. (#2851 https://github.com/pypa/virtualenv/issues/2851)
• رفع هشدارهای منسوخ‌شدگی اسکریپت فعال‌سازی Nushell از طریق انتخاب پویای پرچم --optional برای دستور get در Nushell در نسخه 0.106.0 و جدیدتر، ضمن حفظ پرچم منسوخ‌شده -i برای نسخه‌های قدیمی‌تر جهت حفظ سازگاری. با مشارکت @gaborbernat https://github.com/gaborbernat. (#2910 https://github.com/pypa/virtualenv/issues/2910)

• هشدار در صورت فراخوانی نادرست اسکریپت فعال‌سازی Nushell - توسط @esafak https://github.com/esafak. (#nushell_activation https://github.com/pypa/virtualenv/issues/nushell_activation)
• شناسایی نسخه‌های نصب‌شدهٔ Python مدیریت‌شده توسط uv (#2901 https://github.com/pypa/virtualenv/issues/2901)

• نادیده‌گرفتن مسیرهای مطلق ناموجود در شناسایی python - توسط @esafak https://github.com/esafak (#2870 https://github.com/pypa/virtualenv/issues/2870)
• ارتقای setuptools تعبیه‌شده به 80.9.0 از 80.3.1 - توسط @gaborbernat https://github.com/gaborbernat. (#2900 https://github.com/pypa/virtualenv/issues/2900)

•

ارتقای wheelهای تعبیه‌شده:

•

عدم بسته‌بندی wheelهای wheel (به‌جز در Python 3.8)؛ setuptools شامل پشتیبانی بومی از bdist_wheel است. به‌روزرسانی pip به 25.1. (#2868 https://github.com/pypa/virtualenv/issues/2868)

• get_embed_wheel() دیگر هنگام فراخوانی با یک distribution ناشناخته با خطای TypeError https://docs.python.org/3/library/exceptions.html#TypeError شکست نمی‌خورد. (#2877 https://github.com/pypa/virtualenv/issues/2877)
• رفع خطای HelpFormatter با Python 3.14.0b1. (#2878 https://github.com/pypa/virtualenv/issues/2878)

•

افزودن پشتیبانی از GraalPy https://github.com/oracle/graalpython. (#2832 https://github.com/pypa/virtualenv/issues/2832)

•

ارتقای wheelهای تعبیه‌شده:

•

نادیده‌گرفتن دایرکتوری‌های غیرقابل خواندن در PATH. (#2794 https://github.com/pypa/virtualenv/issues/2794)

• حذف wheel قدیمی virtualenv از توزیع کد منبع - توسط @gaborbernat https://github.com/gaborbernat. (#2841 https://github.com/pypa/virtualenv/issues/2841)
• ارتقای wheel تعبیه‌شدهٔ pip به 25.0.1 از 24.3.1 - توسط @gaborbernat https://github.com/gaborbernat. (#2843 https://github.com/pypa/virtualenv/issues/2843)

•

رفع هشدارهای ناسازگاری حافظهٔ پنهان PyInfo - توسط @robsdedude https://github.com/robsdedude. (#2827 https://github.com/pypa/virtualenv/issues/2827)

•

افزودن پشتیبانی از انتخاب مفسرهای پایتون free-threaded، مانند python3.13t. (#2809 https://github.com/pypa/virtualenv/issues/2809)

•

ارتقای wheelهای تعبیه‌شده:

•

صرف‌نظر از آزمون‌های tcsh در نسخه‌های خراب tcsh - توسط @gaborbernat https://github.com/gaborbernat. (#2814 https://github.com/pypa/virtualenv/issues/2814)

•

نوشتن فایل CACHEDIR.TAG در زمان ایجاد - توسط "user:neilramsay. (#2803 https://github.com/pypa/virtualenv/issues/2803)

•

ارتقای wheelهای تعبیه‌شده:

•

ارتقای wheelهای تعبیه‌شده:

• عدم اعمال اجباری echo off در طول فعال‌سازی batch در ویندوز (#2801 https://github.com/pypa/virtualenv/issues/2801)
• ارتقای wheelهای تعبیه‌شده:

•

ارتقای wheelهای تعبیه‌شده:

•

توقف پشتیبانی از 3.7 زیرا محیط‌های CI دیگر اجازه اجرای آن را نمی‌دهند - توسط @gaborbernat https://github.com/gaborbernat. (#2758 https://github.com/pypa/virtualenv/issues/2758)

• هنگامی که وجود یک مدخل $PATH قابل بررسی نیست، به جای پایان دادن، از آن صرف‌نظر شود - توسط @hroncok https://github.com/hroncok. (#2782 https://github.com/pypa/virtualenv/issues/2782)
• ارتقای wheelهای تعبیه‌شده:

•

رفع خرابی zipapp در ویندوز پس از نسخه 0.3.9 از distlib - توسط @gaborbernat https://github.com/gaborbernat. (#2784 https://github.com/pypa/virtualenv/issues/2784)

•

کوتیشن‌گذاری مناسب جانگهدارنده‌های رشته در قالب‌های اسکریپت فعال‌سازی جهت کاهش خطر تزریق احتمالی دستور - توسط @y5c4l3 https://github.com/y5c4l3. (#2768 https://github.com/pypa/virtualenv/issues/2768)

•

ارتقای wheelهای تعبیه‌شده: setuptools به 75.1.0 از 74.1.2 - توسط @gaborbernat https://github.com/gaborbernat. (#2765 https://github.com/pypa/virtualenv/issues/2765)

• عدم تولید خروجی () در کنسول در حین فعال‌سازی virtualenv توسط فایل .bat. (#2728 https://github.com/pypa/virtualenv/issues/2728)
• ارتقای wheelهای تعبیه‌شده:

•

ارتقای wheelهای تعبیه‌شده:

• بسته virtualenv.pyz دیگر در صورت وجود پیوند نمادین (symlink) در مسیر zipapp دچار خطا نمی‌شود - توسط @HandSonic https://github.com/HandSonic و @petamas https://github.com/petamas. (#1949 https://github.com/pypa/virtualenv/issues/1949)
• اصلاح کد بازگشتی نادرست از activate.sh در صورت غیرفعال بودن hashing - توسط :user:'fenkes-ibm'. (#2717 https://github.com/pypa/virtualenv/issues/2717)

•

رفع مشکل شناسایی Python مبتنی بر PATH در Windows - توسط @ofek https://github.com/ofek. (#2712 https://github.com/pypa/virtualenv/issues/2712)

•

امکان شناسایی مفسرهای خاص (مانند python3.12) توسط قابلیت شناسایی توکار (builtin discovery) هنگام ارائه یک مشخصه عمومی (مانند python3) - توسط @flying-sheep https://github.com/flying-sheep. (#2709 https://github.com/pypa/virtualenv/issues/2709)

•

تغییر نام pathmod به parser در Python 3.13.0a6. (#2702 https://github.com/pypa/virtualenv/issues/2702)

•

ارتقای wheelهای تعبیه‌شده:

•

ارتقای wheelهای توکار:

•

ارتقای wheelهای توکار:

•

#2688 https://github.com/pypa/virtualenv/issues/2688

•

اکنون آزمون‌ها در CI با Python 3.13.0a2 پاس می‌شوند - توسط @hroncok https://github.com/hroncok. (#2673 https://github.com/pypa/virtualenv/issues/2673)

•

ارتقای wheelهای توکار:

•

ارتقای wheelهای توکار:

• استفاده از متد get_hookimpls به‌جای ویژگی خصوصی در آزمون‌ها. (#2649 https://github.com/pypa/virtualenv/issues/2649)
• ارتقای wheelهای توکار:

• اعلام پشتیبانی از PyPy 3.10 - توسط @cclauss https://github.com/cclauss. (#2638 https://github.com/pypa/virtualenv/issues/2638)
• Brew در macOS دیگر ساخت‌های رونوشت (copy builds) را مجاز نمی‌داند - جلوگیری از انتخاب این مورد توسط @gaborbernat https://github.com/gaborbernat. (#2640 https://github.com/pypa/virtualenv/issues/2640)
• ارتقای wheelهای توکار:

•

ارتقای wheelهای توکار:

• رفع ResourceWarning هنگام خروج ناشی از زیرپردازش به‌روزرسانی دوره‌ای (#2472 https://github.com/pypa/virtualenv/issues/2472)
• ارتقای بسته‌های wheel تعبیه‌شده:

•

#2610 https://github.com/pypa/virtualenv/issues/2610

•

ارتقای بسته‌های wheel تعبیه‌شده:

•

ارتقای بسته‌های wheel تعبیه‌شده:

•

صدور پیشوند اعلان (prompt prefix) به عنوان VIRTUAL_ENV_PROMPT هنگام فعال‌سازی یک محیط مجازی - توسط @jimporter https://github.com/jimporter. (#2194 https://github.com/pypa/virtualenv/issues/2194)

• رفع اشکال مجموعه آزمون - توسط @gaborbernat https://github.com/gaborbernat. (#2592 https://github.com/pypa/virtualenv/issues/2592)
• ارتقای بسته‌های wheel تعبیه‌شده:

• به‌روزرسانی و ساده‌سازی اسکریپت فعال‌سازی nushell، رفع مشکلی در Windows که منجر به خطاهای متوالی command not found می‌شد - توسط @melMass https://github.com/melMass. (#2572 https://github.com/pypa/virtualenv/issues/2572)
• ارتقای بسته‌های wheel تعبیه‌شده:

•

عدم نصب بسته‌های آغازین (seed) wheel و setuptools برای Python 3.12+. برای بازگرداندن رفتار قبلی از موارد زیر استفاده کنید:

توسط @chrysle https://github.com/chrysle. (#2487 https://github.com/pypa/virtualenv/issues/2487)

•

پشتیبانی از 3.12 - توسط @gaborbernat https://github.com/gaborbernat. (#2558 https://github.com/pypa/virtualenv/issues/2558)

•

حذف پشتیبانی از ساخت مفسرهای Python <=3.6 (شامل ۲). حذف pip نسخه‌های 20.3.4 و 21.3.1؛ wheel نسخه 0.37.1؛ setuptools نسخه‌های 59.6.0، 44.1.1 و 50.3.2 - توسط @gaborbernat https://github.com/gaborbernat. (#2548 https://github.com/pypa/virtualenv/issues/2548)

• افزودن tox.ini به sdist - توسط @mtelka https://github.com/mtelka. (#2511 https://github.com/pypa/virtualenv/issues/2511)
• تغییر نحوه استفاده از 'let' در nushell جهت اطمینان از سازگاری با نسخه‌های آتی nushell، جایی که دیگر فرض نمی‌شود مقداردهی اولیه 'let' یک عبارت کامل است. (#2527 https://github.com/pypa/virtualenv/issues/2527)
• دستور 'str collect' در nushell با دستور 'str join' جایگزین شده است. اسکریپت activate.nu برای اعمال این تغییر به‌روزرسانی شد. (#2532 https://github.com/pypa/virtualenv/issues/2532)
• ارتقای wheelهای تعبیه‌شده:

•

آغاز صریح ساختار دستوری closure با {||. (#2512 https://github.com/pypa/virtualenv/issues/2512)

• افزودن دستور print به print_prompt در nushell جهت تضمین سازگاری با انتشار آینده nushell، جایی که دستورهای میانی دیگر خروجی خود را در stdout چاپ نمی‌کنند. (#2514 https://github.com/pypa/virtualenv/issues/2514)
• عدم اتکا به کدگذاری پیش‌فرض. (#2515 https://github.com/pypa/virtualenv/issues/2515)
• ایمن‌سازی ReentrantFileLock در برابر نخ‌ها (thread-safe) و در نتیجه، رفع شرایط رقابت در virtualenv.cli_run - توسط @radoering https://github.com/radoering. (#2516 https://github.com/pypa/virtualenv/issues/2516)

•

تغییر بررسی وجود متغیر محیطی در اسکریپت فعال‌سازی Nushell به‌منظور عدم استفاده از دستور منسوخ‌شده. (#2506 https://github.com/pypa/virtualenv/issues/2506)

• شناسایی پیاده‌سازی‌های CPython توزیع‌شده در Windows توسط هر سازمانی - توسط @faph https://github.com/faph. (#2504 https://github.com/pypa/virtualenv/issues/2504)
• ارتقای setuptools تعبیه‌شده از 67.1.0 به 67.4.0 و pip از 23.0 به 23.0.1 - توسط @gaborbernat https://github.com/gaborbernat. (#2510 https://github.com/pypa/virtualenv/issues/2510)

•

پشتیبانی از نسخه 3 بسته platformdirs - توسط @cdce8p https://github.com/cdce8p. (#2499 https://github.com/pypa/virtualenv/issues/2499)

•

حذف پشتیبانی از محیط زمان اجرای 3.6 (همچنان امکان ساخت 2.7+ وجود دارد) - توسط @gaborbernat https://github.com/gaborbernat. (#2489 https://github.com/pypa/virtualenv/issues/2489)

• مشخصه py یا python به معنای هر پایتونی است نه صرفاً CPython - توسط @gaborbernat https://github.com/gaborbernat. (#2460 https://github.com/pypa/virtualenv/issues/2460)
• رعایت VIRTUAL_ENV_DISABLE_PROMPT در activate.nu و عدم تنظیم پرامپت در صورت درخواست - توسط @m-lima https://github.com/m-lima. (#2461 https://github.com/pypa/virtualenv/issues/2461)

• تغییر اسکریپت فعال‌سازی Nushell به یک ماژول با هدف فعال‌سازی به عنوان overlay. (#2422 https://github.com/pypa/virtualenv/issues/2422)
• به‌روزرسانی عملگر استفاده‌شده در اسکریپت فعال‌سازی Nushell جهت سازگاری با نسخه‌های آینده. (#2450 https://github.com/pypa/virtualenv/issues/2450)

• عدم استفاده از API منسوخ‌شده از importlib.resources در پایتون ۳.۱۰ یا بالاتر - توسط @gaborbernat https://github.com/gaborbernat. (#2448 https://github.com/pypa/virtualenv/issues/2448)
• ارتقای setuptools تعبیه‌شده به 65.6.3 از 65.5.1 - توسط @gaborbernat https://github.com/gaborbernat. (#2451 https://github.com/pypa/virtualenv/issues/2451)

• استفاده از دایرکتوری والد فایل اجرایی پایتون برای مقدار "home" در pyvenv.cfg طبق PEP 405 - توسط @vfazio https://github.com/vfazio. (#2440 https://github.com/pypa/virtualenv/issues/2440)
• در محیط‌های مجازی POSIX، آزمودن نام‌های باینری جایگزین در صورت عدم وجود sys._base_executable - توسط @vfazio https://github.com/vfazio. (#2442 https://github.com/pypa/virtualenv/issues/2442)
• ارتقای wheel تعبیه‌شده به 0.38.4، و pip به 22.3.1 از 22.3، و setuptools به 65.5.1 از 65.5.0 - توسط @gaborbernat https://github.com/gaborbernat. (#2443 https://github.com/pypa/virtualenv/issues/2443)

•

حذف واسط‌های (shim) غیرضروری برای ساختار دایرکتوری PyPy3 (#2426 https://github.com/pypa/virtualenv/issues/2426)

• اصلاح طرحواره (scheme) انتخاب‌شده در مشتقات دبیان برای پایتون ۳.۱۰ زمانی که python3-distutils نصب نیست یا طرحواره venv در دسترس نیست - توسط @asottile https://github.com/asottile. (#2350 https://github.com/pypa/virtualenv/issues/2350)
• مجاز ساختن قبولی مجموعه آزمون‌ها حتی با C shell اصلی (به جای tcsh) - توسط @kulikjak https://github.com/kulikjak. (#2418 https://github.com/pypa/virtualenv/issues/2418)
• اصلاح سازوکار جایگزین (fallback) برای دانلود wheelهای بسته‌های تجمیع‌شده - توسط @schaap https://github.com/schaap. (#2429 https://github.com/pypa/virtualenv/issues/2429)
• ارتقای setuptools تعبیه‌شده به 65.5.0 از 65.3.0 و pip به 22.3 از 22.2.2 - توسط @gaborbernat https://github.com/gaborbernat. (#2434 https://github.com/pypa/virtualenv/issues/2434)

•

عدم خاموش کردن echo برای دستورهای پسین در اسکریپت‌های فعال‌ساز دسته‌ای (activate.bat و deactivate.bat) - توسط @pawelszramowski https://github.com/pawelszramowski. (#2411 https://github.com/pypa/virtualenv/issues/2411)

•

ارتقای setuptools تعبیه‌شده به 65.3 - توسط @gaborbernat https://github.com/gaborbernat. (#2405 https://github.com/pypa/virtualenv/issues/2405)

•

ارتقای pip تعبیه‌شده به 22.2.2 از 22.2.1 و setuptools به 63.4.1 از 63.2.0 - توسط @gaborbernat https://github.com/gaborbernat. (#2395 https://github.com/pypa/virtualenv/issues/2395)

•

ارتقای pip جاسازی‌شده از 22.2 به 22.2.1 - توسط @gaborbernat https://github.com/gaborbernat. (#2391 https://github.com/pypa/virtualenv/issues/2391)

•

به‌روزرسانی اسکریپت‌های فعال‌سازی Nushell به نسخهٔ 0.67 - توسط @kubouch https://github.com/kubouch. (#2386 https://github.com/pypa/virtualenv/issues/2386)

• حذف پشتیبانی از اجرا تحت Python 2 (همچنان امکان ساخت محیط‌های Python 2 وجود دارد) - توسط @gaborbernat https://github.com/gaborbernat. (#2382 https://github.com/pypa/virtualenv/issues/2382)
• ارتقای pip جاسازی‌شده به 22.2 از 22.1.2 و setuptools به 63.2.0 از 62.6.0 - توسط @gaborbernat https://github.com/gaborbernat. (#2383 https://github.com/pypa/virtualenv/issues/2383)

• رفع عملکرد نادرست هنگامی که افزونه‌های setuptools در stdout خروجی تولید می‌کنند. (#2335 https://github.com/pypa/virtualenv/issues/2335)
• نادیده گرفتن دایرکتوری مفقود DLLs توسط سازندهٔ CPython3Windows. (#2368 https://github.com/pypa/virtualenv/issues/2368)

•

پشتیبانی از بستهٔ پایتون تعبیه‌پذیر در ویندوز (Windows embeddable Python package): گنجاندن python<VERSION>.zip در منابع سازنده - توسط @reksarka https://github.com/reksarka. (#1774 https://github.com/pypa/virtualenv/issues/1774)

• ارتقای setuptools جاسازی‌شده به 62.3.3 از 62.6.0 و pip به 22.1.2 از 22.0.4 - توسط @gaborbernat https://github.com/gaborbernat. (#2348 https://github.com/pypa/virtualenv/issues/2348)
• استفاده از shlex.quote به‌جای تابع منسوخ‌شدهٔ pipes.quote در Python 3 - توسط @frenzymadness https://github.com/frenzymadness. (#2351 https://github.com/pypa/virtualenv/issues/2351)
• رفع مشکل Windows PyPy 3.6 - توسط @reksarka https://github.com/reksarka. (#2363 https://github.com/pypa/virtualenv/issues/2363)

•

پشتیبانی از ایجاد یک محیط مجازی از چارچوب Python 2.7 در macOS 12 - توسط @nickhutchinson https://github.com/nickhutchinson. (#2284 https://github.com/pypa/virtualenv/issues/2284)

•

ارتقای setuptools جاسازی‌شده به 62.1.0 از 61.0.0 - توسط @gaborbernat https://github.com/gaborbernat. (#2327 https://github.com/pypa/virtualenv/issues/2327)

•

پشتیبانی از اسکریپت‌های فعال‌سازی Nushell با نسخهٔ nu 0.60 - توسط @kubouch https://github.com/kubouch. (#2321 https://github.com/pypa/virtualenv/issues/2321)

•

ارتقای setuptools جاسازی‌شده به 61.0.0 از 60.10.0 - توسط @gaborbernat https://github.com/gaborbernat. (#2322 https://github.com/pypa/virtualenv/issues/2322)

• بهبود کارایی راه‌اندازی پایتون درون محیط‌های مجازی ایجادشده - توسط @asottile https://github.com/asottile. (#2317 https://github.com/pypa/virtualenv/issues/2317)
• ارتقای setuptools جاسازی‌شده به 60.10.0 از 60.9.3 - توسط @gaborbernat https://github.com/gaborbernat. (#2320 https://github.com/pypa/virtualenv/issues/2320)

• جلوگیری از ایجاد پیوند نمادین (symlink) از محتویات /usr به درون محیط‌های مجازی +PyPy3.8 - توسط @stefanor https://github.com/stefanor. (#2310 https://github.com/pypa/virtualenv/issues/2310)
• ارتقای pip جاسازی‌شده از 22.0.3 به 22.0.4 - توسط @gaborbernat https://github.com/gaborbernat. (#2311 https://github.com/pypa/virtualenv/issues/2311)

•

ارتقای setuptools تعبیه‌شده از 60.6.0 به 60.9.3 - توسط @gaborbernat https://github.com/gaborbernat. (#2306 https://github.com/pypa/virtualenv/issues/2306)

• رفع خطای "execv() arg 2 must contain only strings" روی M1 MacOS (#2282 https://github.com/pypa/virtualenv/issues/2282)
• ارتقای setuptools تعبیه‌شده از 60.2.0 به 60.5.0 - توسط @asottile https://github.com/asottile. (#2289 https://github.com/pypa/virtualenv/issues/2289)
• ارتقای pip تعبیه‌شده به 22.0.3 و setuptools به 60.6.0 - توسط @gaborbernat https://github.com/gaborbernat و @asottile https://github.com/asottile. (#2294 https://github.com/pypa/virtualenv/issues/2294)

•

افزودن اطلاعات wheel دانلودشده به فایل JSON تعبیه‌شده مربوطه جهت جلوگیری از دانلود مجدد همان wheel. - توسط @mayeut https://github.com/mayeut. (#2268 https://github.com/pypa/virtualenv/issues/2268)

• رفع خطای AttributeError: 'bool' object has no attribute 'error' هنگام ایجاد یک virtualenv پایتون 2.x روی macOS - توسط moreati. (#2269 https://github.com/pypa/virtualenv/issues/2269)
• رفع خطای PermissionError: [Errno 1] Operation not permitted هنگام ایجاد یک virtualenv پایتون 2.x روی macOS/arm64 - توسط moreati. (#2271 https://github.com/pypa/virtualenv/issues/2271)

• تلاش برای استفاده از به‌روزرسانی‌های قبلی pip، setuptools و wheel در طول دوره فرجه به‌روزرسانی به جای بازگشت همیشگی به wheelهای تعبیه‌شده - توسط @mayeut https://github.com/mayeut. (#2265 https://github.com/pypa/virtualenv/issues/2265)
• نسخه‌های وصله‌ای جدید pip، setuptools و wheel اکنون در بازه زمانی مورد انتظار بازگردانده می‌شوند. - توسط @mayeut https://github.com/mayeut. (#2266 https://github.com/pypa/virtualenv/issues/2266)
• ارتقاهای دستی pip، setuptools و wheel در اثر به‌روزرسانی‌های دوره‌ای نادیده گرفته نمی‌شوند - توسط @mayeut https://github.com/mayeut. (#2267 https://github.com/pypa/virtualenv/issues/2267)

•

امضای فایل اجرایی python2 روی Darwin arm64 - توسط @tmspicer https://github.com/tmspicer. (#2233 https://github.com/pypa/virtualenv/issues/2233)

• رفع اشکال گزینه --download - توسط @mayeut https://github.com/mayeut. (#2120 https://github.com/pypa/virtualenv/issues/2120)
• ارتقای setuptools تعبیه‌شده از 60.1.1 به 60.2.0 - توسط @gaborbernat https://github.com/gaborbernat. (#2263 https://github.com/pypa/virtualenv/issues/2263)

•

رفع مشکل نصب نسخه‌های تثبیت‌شده (pinned) از pip، setuptools و wheel - توسط @mayeut https://github.com/mayeut. (#2203 https://github.com/pypa/virtualenv/issues/2203)

•

ارتقای setuptools تعبیه‌شده از 60.1.0 به 60.1.1 - توسط @gaborbernat https://github.com/gaborbernat. (#2258 https://github.com/pypa/virtualenv/issues/2258)

• جلوگیری از هشدار منسوخ‌شدگی ناشی از آرگومان py-filelock - توسط @ofek https://github.com/ofek. (#2237 https://github.com/pypa/virtualenv/issues/2237)
• ارتقای setuptools تعبیه‌شده از 58.3.0 به 61.1.0 - توسط @gaborbernat https://github.com/gaborbernat. (#2240 https://github.com/pypa/virtualenv/issues/2240)
• حذف وابستگی زمان اجرای backports.entry-points-selectable - توسط @hroncok https://github.com/hroncok. (#2246 https://github.com/pypa/virtualenv/issues/2246)
• پوسته Fish: متغیرهای PATH هنگام مقداردهی نباید داخل گیومه قرار گیرند - توسط @d3dave https://github.com/d3dave. (#2248 https://github.com/pypa/virtualenv/issues/2248)

• اگر یک طرح نصب "venv" در sysconfig وجود داشته باشد، virtualenv اکنون از آن برای ایجاد محیط‌های مجازی جدید استفاده می‌کند. این به توزیع‌کنندگان Python، مانند Fedora، اجازه می‌دهد تا طرح نصب پیش‌فرض را بدون تأثیر بر مسیرها در محیط‌های مجازی جدید وصله/جایگزین کنند. روش مشابهی برای Python و ماژول venv پیشنهاد شده بود https://bugs.python.org/issue45413 - توسط hroncok (#2208 https://github.com/pypa/virtualenv/issues/2208)
• اعلان (پرامپت) فعال‌شدهٔ virtualenv اکنون همیشه در پرانتز قرار می‌گیرد. این امر بر محیط‌های مجازی ایجادشده با مشخصهٔ --prompt تأثیر می‌گذارد و رفتار virtualenv را با venv همگام و هم‌تراز می‌کند. (#2224 https://github.com/pypa/virtualenv/issues/2224)

•

رفع پرامپت خراب تنظیم‌شده توسط activate.bat - توسط @SiggyBar https://github.com/SiggyBar. (#2225 https://github.com/pypa/virtualenv/issues/2225)

• در نظر گرفتن حالت خاص برای --prompt . با تبدیل آن به نام دایرکتوری جاری - توسط @rkm https://github.com/rkm. (#2220 https://github.com/pypa/virtualenv/issues/2220)
• افزودن libffi-8.dll به نسخهٔ ویندوز pypy #2218 https://github.com/pypa/virtualenv/issues/2218 - توسط @mattip https://github.com/mattip

• رفع تداخل مسیر که هنگام استفاده از PyPy3.8 می‌توانست منجر به PermissionError یا نوشتن در دایرکتوری‌های سیستمی شود - توسط @mgorny https://github.com/mgorny. (#2182 https://github.com/pypa/virtualenv/issues/2182)
• ارتقای setuptools تعبیه‌شده از 58.1.0 به 58.3.0 و pip از 21.2.4 به 21.3.1 - توسط @gaborbernat https://github.com/gaborbernat. (#2205 https://github.com/pypa/virtualenv/issues/2205)
• حذف پرانتز بسته اضافی در activate.bat - توسط @SiggyBar https://github.com/SiggyBar. (#2221 https://github.com/pypa/virtualenv/issues/2221)

• رفع باگی که در آن هنگام ایجاد یک venv بر روی یک نسخهٔ موجود، بدون پاک‌سازی، در صورت عدم تطابق نسخهٔ wheel مقدماتی (seeded)، ممکن بود چندین دایرکتوری .dist-info وجود داشته باشد که کشف نقطه ورود (entrypoint) را مختل می‌کرد - توسط @arcivanov https://github.com/arcivanov (#2185 https://github.com/pypa/virtualenv/issues/2185)
• ارتقای setuptools تعبیه‌شده از 58.0.4 به 58.1.0 - توسط @gaborbernat https://github.com/gaborbernat. (#2195 https://github.com/pypa/virtualenv/issues/2195)

•

#2189 https://github.com/pypa/virtualenv/issues/2189

• ارتقای setuptools تعبیه‌شده از 57.4.0 به 58.0.4 و pip از 21.2.3 به 21.2.4
• افزودن اسکریپت فعال‌سازی برای nushell

•

ارتقای pip تعبیه‌شده از 21.2.2 به 21.2.3 و wheel از 0.36.2 به 0.37.0 - توسط @gaborbernat https://github.com/gaborbernat. (#2168 https://github.com/pypa/virtualenv/issues/2168)

•

رفع مشکل باز کردن آیتم‌های دیکشنری در PythonInfo.install_path (#2165 https://github.com/pypa/virtualenv/issues/2165)

•

ارتقای pip تعبیه‌شده از 21.1.3 به 21.2.2 و setuptools از 57.1.0 به 57.4.0 - توسط @gaborbernat https://github.com/gaborbernat (#2159 https://github.com/pypa/virtualenv/issues/2159)

•

حذف فعال‌کنندهٔ (activator) xonsh به دلیل خرابی مکرر در CI و عدم پشتیبانی از سوی نگه‌دارندگان این بسته‌ها؛ به بالادست توصیه می‌شود پشتیبانی از پروژه را به صورت یک پلاگین ادامه دهد https://github.com/xonsh/xonsh/issues/3689 - توسط @gaborbernat https://github.com/gaborbernat. (#2160 https://github.com/pypa/virtualenv/issues/2160)

•

پشتیبانی از مفسرهای Python بدون distutils (در این موارد به عنوان جایگزین از syconfig استفاده می‌شود) - توسط @gaborbernat https://github.com/gaborbernat. (#1910 https://github.com/pypa/virtualenv/issues/1910)

• افزونه‌ها اکنون از نقاط ورود 'selectable' استفاده می‌کنند - توسط @jaraco https://github.com/jaraco. (#2093 https://github.com/pypa/virtualenv/issues/2093)
• افزودن libffi-7.dll به فهرست ثابت dllها برای PyPy (#2141 https://github.com/pypa/virtualenv/issues/2141)
• استفاده از platformdirs با نگهداری بهتر به‌جای appdirs - توسط @gaborbernat https://github.com/gaborbernat. (#2142 https://github.com/pypa/virtualenv/issues/2142)

•

ارتقای pip توکار به 21.1.3 و setuptools به 57.1.0 - توسط @gaborbernat https://github.com/gaborbernat. (#2135 https://github.com/pypa/virtualenv/issues/2135)

•

حذف پشتیبانی از python 3.4 به دلیل گذشت بیش از ۲ سال از EOL - توسط @gaborbernat https://github.com/gaborbernat. (#2141 https://github.com/pypa/virtualenv/issues/2141)

•

ارتقای pip توکار به 21.1.2 و setuptools به 57.0.0 - توسط @gaborbernat https://github.com/gaborbernat. (#2123 https://github.com/pypa/virtualenv/issues/2123)

•

رفع خرابی site.getsitepackages() در python2 روی debian - توسط @freundTech https://github.com/freundTech. (#2105 https://github.com/pypa/virtualenv/issues/2105)

• ارتقای pip به 21.1.1 از 21.0.1 - توسط @gaborbernat https://github.com/gaborbernat. (#2104 https://github.com/pypa/virtualenv/issues/2104)
• رفع نادیده‌گرفتن --system-site-packages توسط site.getsitepackages() در python2 - توسط @freundTech https://github.com/freundTech. (#2106 https://github.com/pypa/virtualenv/issues/2106)

• کلاس discovery توکار همواره بر کلاس‌های ارائه‌شده توسط افزونه‌ها ترجیح داده می‌شود. (#2087 https://github.com/pypa/virtualenv/issues/2087)
• ارتقای setuptools توکار به 56.0.0 توسط @gaborbernat https://github.com/gaborbernat. (#2094 https://github.com/pypa/virtualenv/issues/2094)

• ارتقای setuptools توکار از 52.0.0 به 54.1.2 - توسط @gaborbernat https://github.com/gaborbernat (#2069 https://github.com/pypa/virtualenv/issues/2069)
• رفع نادرست‌بودن stdlib برای PyPy3 روی Windows - توسط @gaborbernat https://github.com/gaborbernat. (#2071 https://github.com/pypa/virtualenv/issues/2071)

•

رفع مشکل از کار افتادن هنگام اجرای virtualenv با --upgrade-embed-wheels - توسط @gaborbernat https://github.com/gaborbernat. (#2058 https://github.com/pypa/virtualenv/issues/2058)

•

ارتقای بسته‌های توکار pip و setuptools به آخرین نسخه‌های پشتیبانی‌شده در بالادست (21.0.1 و 52.0.0) - توسط @gaborbernat https://github.com/gaborbernat. (#2060 https://github.com/pypa/virtualenv/issues/2060)

•

امکان ارسال دیکشنری متغیرهای محیطی برای استفاده در API برنامه‌نویسی، با مقدار پیش‌فرض os.environ در صورت عدم تعیین - توسط @gaborbernat https://github.com/gaborbernat. (#2054 https://github.com/pypa/virtualenv/issues/2054)

• ارتقای pip تعبیه‌شده به 20.3.3، setuptools به 51.1.1 و wheel به 0.36.2 - توسط @gaborbernat https://github.com/gaborbernat. (#2036 https://github.com/pypa/virtualenv/issues/2036)
• اجازه دادن به شکست بدون خطای لغو تعریف تابع (unfunctioning) برای pydoc تا virtualenvها بتوانند تحت Zsh با set -e فعال شوند (زیرا در غیر این صورت، چنانچه تابع در Zsh وجود نداشته باشد، دستورات unset -f و unfunction با کد ۱ خارج می‌شوند) - توسط @d125q https://github.com/d125q. (#2049 https://github.com/pypa/virtualenv/issues/2049)
• دور ریختن اطلاعات کش‌شدهٔ python در صورتی که فایل اجرایی سیستم دیگر وجود نداشته باشد (برای مثال زمانی که فایل اجرایی یک shim است و فایل اجرایی نگاشت‌شده جایگزین شده باشد - مانند موردی که در pyenv رخ می‌دهد) - توسط @gaborbernat https://github.com/gaborbernat. (#2050 https://github.com/pypa/virtualenv/issues/2050)

•

سازوکار شناسایی توکار اکنون یک آرگومان --try-first-with می‌پذیرد و ابتدا این موارد به عنوان مفسرهای معتبر آزموده می‌شوند. می‌توان از این گزینه برای تحمیل شناسایی یک فایل اجرایی مشخص python در مواقعی که ترتیب یا سازوکار شناسایی با خطا مواجه می‌شود استفاده کرد - توسط @gaborbernat https://github.com/gaborbernat. (#2046 https://github.com/pypa/virtualenv/issues/2046)

• در توزیع‌های python 3.7+ در ویندوز که در آن‌ها shim فایل exe وجود ندارد، بازگشت به روش‌های قدیمی صورت می‌گیرد - توسط @gaborbernat https://github.com/gaborbernat. (#1986 https://github.com/pypa/virtualenv/issues/1986)
• هنگام شناسایی مفسرها در ویندوز از طریق PEP-514، انتشار‌های PythonCore نسبت به سایر موارد ترجیح داده می‌شوند. virtualenv بیشتر از طریق pip با این توزیع به کار می‌رود، بنابراین نسبت به سایرین مانند conda در اولویت قرار می‌گیرد - توسط @gaborbernat https://github.com/gaborbernat. (#2046 https://github.com/pypa/virtualenv/issues/2046)

•

ارتقای pip به 20.3.1، setuptools به 51.0.0 و wheel به 0.36.1 - توسط @gaborbernat https://github.com/gaborbernat. (#2029 https://github.com/pypa/virtualenv/issues/2029)

• امکان چشم‌پوشی اختیاری از دستور ignore مربوط به VCS برای کل دایرکتوری virtualenv، با استفاده از گزینهٔ no-vcs-ignore <#no-vcs-ignore>، که به‌طور پیش‌فرض False است. (#2003 https://github.com/pypa/virtualenv/issues/2003)
• افزودن گزینهٔ --read-only-app-data جهت اجازه برای ساخت بر پایهٔ یک کش موجود از app data که غیرقابل نوشتن است. این مورد ممکن است (برای مثال) جهت تولید یک ایمیج docker که در آن app-data از پیش پر شده است، مفید باشد.

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

پچ از @asottile https://github.com/asottile. (#2009 https://github.com/pypa/virtualenv/issues/2009)

•

اصلاح پردازش متغیر محیطی VIRTUALENV_PYTHON و چندمقداری کردن آن (جداشده با کاما) - توسط @pneff https://github.com/pneff. (#1998 https://github.com/pypa/virtualenv/issues/1998)

•

مشخصهٔ python اکنون می‌تواند یک یا چند مقدار بپذیرد؛ نخستین مورد یافت‌شده برای ساخت محیط مجازی استفاده می‌شود - توسط @gaborbernat https://github.com/gaborbernat. (#1995 https://github.com/pypa/virtualenv/issues/1995)

• ارتقای setuptools تعبیه‌شده از 50.3.0 به 50.3.1 - توسط @gaborbernat https://github.com/gaborbernat. (#1982 https://github.com/pypa/virtualenv/issues/1982)
• پس از وارد کردن virtualenv، ارسال cwd به فراخوانی‌های subprocess با خطای invalid directory متوقف می‌شد - توسط @gaborbernat https://github.com/gaborbernat. (#1983 https://github.com/pypa/virtualenv/issues/1983)

• هماهنگ‌سازی با ماژول venv هنگام ایجاد محیط‌های مجازی با سازنده توکار در ویندوز پایتون ۳.۷ و بالاتر - توسط @gaborbernat https://github.com/gaborbernat. (#1782 https://github.com/pypa/virtualenv/issues/1782)
• مدیریت تبدیل مسیر Cygwin در اسکریپت فعال‌سازی - توسط @davidcoghlan https://github.com/davidcoghlan. (#1969 https://github.com/pypa/virtualenv/issues/1969)

• رفع خطای نوع None در cygwin در صورت وجود مسیر POSIX در dest - توسط @danyeaw https://github.com/danyeaw. (#1962 https://github.com/pypa/virtualenv/issues/1962)
• رفع ناسازگاری‌های Python 3.4 (افزوده شدن مجدد به CI) - توسط @gaborbernat https://github.com/gaborbernat. (#1963 https://github.com/pypa/virtualenv/issues/1963)

• استفاده همیشگی از پایانه‌های خط UNIX برای اسکریپت‌های فعال‌سازی (مگر مواردی که مربوط به شل BATCH باشند) - توسط @saytosid https://github.com/saytosid. (#1818 https://github.com/pypa/virtualenv/issues/1818)
• ارتقای pip تعبیه‌شده به 20.2.1 و setuptools به 49.4.0 - توسط @gaborbernat https://github.com/gaborbernat. (#1918 https://github.com/pypa/virtualenv/issues/1918)
• جلوگیری از باز شدن پنجره‌های جدید هنگام ارتقای بسته‌های seed در پس‌زمینه در Windows - توسط @gaborbernat https://github.com/gaborbernat. (#1928 https://github.com/pypa/virtualenv/issues/1928)
• رفع باگی که در آن خواندن و نوشتن روی یک فایل یکسان ممکن بود باعث شرایط رقابتی (race condition) بین چندین فرآیند شود. (#1938 https://github.com/pypa/virtualenv/issues/1938)
• ارتقای setuptools تعبیه‌شده به 50.2.0 و pip به 20.2.3 - توسط @gaborbernat https://github.com/gaborbernat. (#1939 https://github.com/pypa/virtualenv/issues/1939)
• ارائه مسیر صحیح برای فعال‌ساز bash در cygwin یا msys2 - توسط @danyeaw https://github.com/danyeaw. (#1940 https://github.com/pypa/virtualenv/issues/1940)
• تسهیل پیش‌نیاز importlib برای مجاز کردن version<3 - توسط @usamasadiq https://github.com/usamasadiq (#1953 https://github.com/pypa/virtualenv/issues/1953)
• عدم پردازش فایل‌های pth روی CPython2 در صورتی که $PYTHONPATH به site-packages/ اشاره می‌کرد - توسط @navytux https://github.com/navytux. (#1959 https://github.com/pypa/virtualenv/issues/1959) (#1960 https://github.com/pypa/virtualenv/issues/1960)

•

ارتقای pip تعبیه‌شده به 20.2.1، setuptools به 49.6.0 و wheel به 0.35.1 - توسط @gaborbernat https://github.com/gaborbernat. (#1918 https://github.com/pypa/virtualenv/issues/1918)

•

ارتقای pip به 20.2.1 و setuptools به 49.2.1 - توسط @gaborbernat https://github.com/gaborbernat. (#1915 https://github.com/pypa/virtualenv/issues/1915)

•

ارتقای pip تعبیه‌شده از نسخه 20.1.2 به 20.2 - توسط @gaborbernat https://github.com/gaborbernat. (#1909 https://github.com/pypa/virtualenv/issues/1909)

• رفع مشکل شکست مجموعه‌آزمون در صورت اجرا از طریق Python سیستمی - توسط @gaborbernat https://github.com/gaborbernat. (#1882 https://github.com/pypa/virtualenv/issues/1882)
• ارائه پرچم setup_logging به API پایتون تا در صورتی که برنامه کاربران از پیش این کار را انجام می‌دهد، بتوانند از مدیریت لاگ‌گیری گذر کنند - توسط @gaborbernat https://github.com/gaborbernat. (#1896 https://github.com/pypa/virtualenv/issues/1896)
• استفاده از \n به جای \r\n به عنوان جداکننده خط برای گزارش (زیرا Python این تبدیل را به طور خودکار هنگام نوشتن در پایپ لاگ‌گیری انجام می‌دهد) - توسط @gaborbernat https://github.com/gaborbernat. (#1905 https://github.com/pypa/virtualenv/issues/1905)

• عدم درون‌ریزی پیشاپیش (preimport) ماژول threading برای رفع مشکل پشتیبانی از gpython https://pypi.org/project/pygolang/#gpython و gevent https://www.gevent.org - توسط @navytux https://github.com/navytux. (#1897 https://github.com/pypa/virtualenv/issues/1897)
• ارتقای setuptools از 49.2.0 در Python 3.5+ - توسط @gaborbernat https://github.com/gaborbernat. (#1898 https://github.com/pypa/virtualenv/issues/1898)

• ارتقای وابستگی به distutils >= 0.3.1 - توسط @gaborbernat https://github.com/gaborbernat. (#1880 https://github.com/pypa/virtualenv/issues/1880)
• بهبود مدیریت به‌روزرسانی دوره‌ای:

توسط @gaborbernat https://github.com/gaborbernat. (#1883 https://github.com/pypa/virtualenv/issues/1883)

• عدم چاپ پیام خطا در صورتی که برنامه با SystemExit(0) خارج شود - توسط @gaborbernat https://github.com/gaborbernat. (#1885 https://github.com/pypa/virtualenv/issues/1885)
• ارتقای setuptools تعبیه‌شده از 47.3.1 به 49.1.0 برای Python 3.5+ - توسط @gaborbernat https://github.com/gaborbernat. (#1887 https://github.com/pypa/virtualenv/issues/1887)

•

رفع مشکلی که در آن هنگام شکست در ایجاد تصویر بذرپاش‌های app-data، استثنا در سکوت نادیده گرفته می‌شد. جلوگیری از تداخل فرایندهای ایجاد دو محیط مجازی با یکدیگر با استفاده از قفل هنگام ایجاد تصاویر پایه. توسط @gaborbernat https://github.com/gaborbernat. (#1869 https://github.com/pypa/virtualenv/issues/1869)

•

اطمینان از اینکه بسته‌های بذرپاشی‌شده بیش از حد قدیمی نشوند:

جزئیات بیشتر در Wheel acquisition <#wheels> - توسط @gaborbernat https://github.com/gaborbernat. (#1821 https://github.com/pypa/virtualenv/issues/1821)

•

ارتقای محتوای wheelهای تعبیه‌شده:

توسط @gaborbernat https://github.com/gaborbernat. (#1841 https://github.com/pypa/virtualenv/issues/1841)

•

نمایش نسخه‌های بسته‌های بذر (seed) نصب‌شده در خروجی نهایی خلاصه، به عنوان مثال:

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

توسط @gaborbernat https://github.com/gaborbernat. (#1864 https://github.com/pypa/virtualenv/issues/1864)

• عدم ایجاد یا بازنویسی .gitignore در صورتی که در مسیر مقصد از قبل وجود داشته باشد - توسط @gaborbernat https://github.com/gaborbernat. (#1862 https://github.com/pypa/virtualenv/issues/1862)
• بهبود پیام خطا هنگام عدم وجود .dist-info درون بذرپاش کپی app-data - توسط @gaborbernat https://github.com/gaborbernat. (#1867 https://github.com/pypa/virtualenv/issues/1867)

• نحوه شناسایی (و به‌روز نگه‌داشتن خودکار) بسته‌های wheel توسط سازوکارهای بذرپاشی در Wheel acquisition <#wheels> - توسط @gaborbernat https://github.com/gaborbernat. (#1821 https://github.com/pypa/virtualenv/issues/1821)
• نحوه مدیریت ارائه بسته‌های wheel تعبیه‌شده اختصاصی توسط توزیع‌ها در Distribution maintainer patching <#distribution-wheels> - توسط @gaborbernat https://github.com/gaborbernat. (#1840 https://github.com/pypa/virtualenv/issues/1840)

•

رفع غلط املایی در setup.cfg - توسط @RowdyHowell https://github.com/RowdyHowell. (#1857 https://github.com/pypa/virtualenv/issues/1857)

• کاهش محدودیت پیش‌نیاز importlib.resources برای مجاز کردن نسخهٔ ۲ نیز - توسط @asottile https://github.com/asottile. (#1846 https://github.com/pypa/virtualenv/issues/1846)
• ارتقای setuptools تعبیه‌شده به 44.1.1 برای python 2 و به 47.1.1 برای python3.5+ - توسط @gaborbernat https://github.com/gaborbernat. (#1855 https://github.com/pypa/virtualenv/issues/1855)

•

تولید فایل ignore برای سامانه‌های کنترل نسخه جهت جلوگیری از ردیابی پیش‌فرض محیط‌های مجازی. در صورتی که کاربران همچنان مایل به ردیابی هستند باید این فایل‌ها را حذف کنند. در حال حاضر ما تنها از git پشتیبانی می‌کنیم - توسط @gaborbernat https://github.com/gaborbernat. (#1806 https://github.com/pypa/virtualenv/issues/1806)

• رفع خطای virtualenv در برخی مواقع هنگام اجرای هم‌روند؛ تداخل پرچم --clear-app-data با پرچم clear <#clear> در صورت فعال بودن خلاصه‌سازی پرچم‌ها. برای دور زدن این مشکل در حین مجاز شمردن پرچم‌های خلاصه‌شده در خط فرمان، مجبور شدیم آن را به reset-app-data <#reset-app-data> تغییر دهیم - توسط @gaborbernat https://github.com/gaborbernat. (#1824 https://github.com/pypa/virtualenv/issues/1824)
• ارتقای setuptools تعبیه‌شده به 46.4.0 از 46.1.3 در Python 3.5+، و pip از 20.1 به 20.1.1 - توسط @gaborbernat https://github.com/gaborbernat. (#1827 https://github.com/pypa/virtualenv/issues/1827)
• اکنون seeder pip گزینهٔ --extra-search-dir را به‌درستی مدیریت می‌کند - توسط @frenzymadness https://github.com/frenzymadness. (#1834 https://github.com/pypa/virtualenv/issues/1834)

• رفع شکست دانلود با python 3.4 - توسط @gaborbernat https://github.com/gaborbernat. (#1809 https://github.com/pypa/virtualenv/issues/1809)
• رفع مشکل استفادهٔ نسخه‌های قدیمی‌تر CPython2 از _get_makefile_filename به جای get_makefile_filename در sysconfig - توسط @ianw https://github.com/ianw. (#1810 https://github.com/pypa/virtualenv/issues/1810)
• رفع مشکل True بودن download به‌طور پیش‌فرض - توسط @gaborbernat https://github.com/gaborbernat. (#1813 https://github.com/pypa/virtualenv/issues/1813)
• شکست عملیات seed در app-data در صورت ناموفق بودن دانلود wheel و ارائهٔ پیام خطای بهتر - توسط @gaborbernat https://github.com/gaborbernat. (#1814 https://github.com/pypa/virtualenv/issues/1814)

• رفع مشکلی که در آن ایجاد یک محیط Python 2 از طریق Python 3 باعث ایجاد فعال‌ساز (activator) نامعتبر python می‌شد - توسط @gaborbernat https://github.com/gaborbernat. (#1776 https://github.com/pypa/virtualenv/issues/1776)
• رفع خطای ایجادشدهٔ Invalid Requirement هنگام پین کردن بسته‌های seed از طریق seeder بستر app-data - توسط @gaborbernat https://github.com/gaborbernat. (#1779 https://github.com/pypa/virtualenv/issues/1779)
• متوقف نکردن فرایند کشف مفسر (interpreter discovery) در صورت عدم موفقیت در یافتن مفسر سیستم برای یک فایل اجرایی در طول فرایند کشف - توسط @gaborbernat https://github.com/gaborbernat. (#1781 https://github.com/pypa/virtualenv/issues/1781)
• در پلتفرم‌های POSIX مربوط به CPython2 اطمینان حاصل شود که syconfig.get_makefile_filename در داخل محیط مجازی وجود دارد (این مورد توسط برخی کتابخانه‌های مبتنی بر افزونه‌های C - مانند numpy - برای ساخت استفاده می‌شود) - توسط @gaborbernat https://github.com/gaborbernat. (#1783 https://github.com/pypa/virtualenv/issues/1783)
• مدیریت بهتر گزینه‌های copies <#copies> و symlinks <#symlinks>. معرفی اولویت‌بندی برای محل تنظیم گزینه بر اساس این ترتیب: CLI، متغیر محیطی، فایل، هاردکدشده. اگر هر دو در یک سطح تنظیم شوند، نسخهٔ رونوشت (copy) بر پیوند نمادین (symlink) ارجحیت دارد - توسط @gaborbernat https://github.com/gaborbernat. (#1784 https://github.com/pypa/virtualenv/issues/1784)
• ارتقای pip برای Python 2.7 و 3.5+ از 20.0.2 به 20.1 - توسط @gaborbernat https://github.com/gaborbernat. (#1793 https://github.com/pypa/virtualenv/issues/1793)
• رفع عدم شناسایی CPython از طریق رجیستری Windows، و کشف مفسرهای python از رجیستری Windows به ترتیب نزولی نسخه - توسط @gaborbernat https://github.com/gaborbernat. (#1796 https://github.com/pypa/virtualenv/issues/1796)
• رفع مشکل شناسایی symlink برای سازنده‌ها (creators) - توسط @asottile https://github.com/asottile (#1803 https://github.com/pypa/virtualenv/issues/1803)

•

وارد کردن (import) setuptools پیش از cli_run می‌توانست به دلیل وصله‌زدن distutils.dist.Distribution توسط setuptools باعث شکست استعلام اطلاعات python شود - توسط @gaborbernat https://github.com/gaborbernat. (#1771 https://github.com/pypa/virtualenv/issues/1771)

•

گسترش متغیرهای محیطی بررسی‌شده برای پیکربندی جهت بررسی نام‌های مستعار (مثلاً تنظیم هر یک از VIRTUALENV_COPIES یا VIRTUALENV_ALWAYS_COPY کارساز خواهد بود) - توسط @gaborbernat https://github.com/gaborbernat. (#1763 https://github.com/pypa/virtualenv/issues/1763)

•

اجازه دادن به فایل‌های wheel اولیه (seed wheel) در پوشه‌های extra-search-dir <#extra-search-dir> که فرادادهٔ Requires-Python برای آن‌ها مشخص نشده است؛ این فایل‌ها سازگار با تمام نسخه‌های python در نظر گرفته می‌شوند - توسط @gaborbernat https://github.com/gaborbernat. (#1757 https://github.com/pypa/virtualenv/issues/1757)

•

ارتقای setuptools تعبیه‌شده از 46.1.1 به 46.1.3 - توسط @gaborbernat https://github.com/gaborbernat. (#1752 https://github.com/pypa/virtualenv/issues/1752)

• حذف __PYVENV_LAUNCHER__ در macOS برای Python 3.7.(<8) و 3.8.(<3) هنگام راه‌اندازی مفسر از طریق فایل pth؛ این کار وصلهٔ بالادست https://github.com/python/cpython/pull/9516 را اعمال می‌کند - توسط @gaborbernat https://github.com/gaborbernat. (#1704 https://github.com/pypa/virtualenv/issues/1704)
• ارتقای setuptools تعبیه‌شده برای Python 3.5+ به 46.1.1، و برای Python 2.7 به 44.1.0 - توسط @gaborbernat https://github.com/gaborbernat. (#1745 https://github.com/pypa/virtualenv/issues/1745)

•

رفع شناسایی مفسر بر اساس نام از PATH در صورتی که با قالب spec مطابقت ندارد - توسط @gaborbernat https://github.com/gaborbernat. (#1746 https://github.com/pypa/virtualenv/issues/1746)

• عدم بروز خطا هنگام نبود فایل‌های pyc برای Python 2 میزبان - توسط @gaborbernat https://github.com/gaborbernat. (#1738 https://github.com/pypa/virtualenv/issues/1738)
• پشتیبانی از پایتون‌های با بسته‌بندی معیوب که هدرهای include را به جای الگوی sysconfig در الگوی distutils قرار می‌دهند - توسط @gaborbernat https://github.com/gaborbernat. (#1739 https://github.com/pypa/virtualenv/issues/1739)

•

رفع شناسایی مفسرها از طریق مسیر نسبی - توسط @gaborbernat https://github.com/gaborbernat. (#1734 https://github.com/pypa/virtualenv/issues/1734)

•

بهبود پیام خطا هنگامی که پایتون میزبان پیش‌نیازهای لازم برای ایجاد محیط‌های مجازی را برآورده نمی‌کند (اکنون وقتی سازنده‌ای منطبق یافت نمی‌شود، اما سازندگانی وجود دارند که مفسر پایتون داده‌شده را توصیف می‌کنند، چاپ می‌شود که کدام فایل‌های میزبان ناسازگار/مفقود هستند و برای کدام سازندگان - همچنان عدم پشتیبانی از سازنده برای Jython چاپ می‌شود، اما در مورد CPython/PyPy دقیقاً مشخص می‌شود کدام فایل‌های میزبان مانع ایجاد محیط‌های مجازی هستند) - توسط @gaborbernat https://github.com/gaborbernat. (#1716 https://github.com/pypa/virtualenv/issues/1716)

• پشتیبانی از Python 3 Framework توزیع‌شده از طریق XCode در macOS Catalina و قبل از آن - توسط @gaborbernat https://github.com/gaborbernat. (#1663 https://github.com/pypa/virtualenv/issues/1663)
• رفع پشتیبانی از Python در Windows Store، عدم اجازهٔ ایجاد از طریق پیوند نمادین (symlink) چرا که طبق طراحی کار نخواهد کرد - توسط @gaborbernat https://github.com/gaborbernat. (#1709 https://github.com/pypa/virtualenv/issues/1709)
• رفع خطای AttributeError در activate_this.py در ویندوز هنگامی که محیط مجازی از طریق سازوکار cross python ایجاد شده است - توسط @gaborbernat https://github.com/gaborbernat. (#1710 https://github.com/pypa/virtualenv/issues/1710)
• رفع مشکل نادیده گرفته شدن گزینه‌های --no-pip، --no-setuptools و --no-wheel - توسط @gaborbernat https://github.com/gaborbernat. (#1712 https://github.com/pypa/virtualenv/issues/1712)
• مجاز دانستن نبود فایل‌های .py در صورتی که نسخه کامپایل‌شدهٔ .pyc در دسترس باشد - توسط @tucked https://github.com/tucked. (#1714 https://github.com/pypa/virtualenv/issues/1714)
• عدم بروز خطا در صورتی که وصله زدن distutils/setuptools روی یک لودر اکستنشن C (مانند zipimporter در Python 3.7 یا قبل‌تر) رخ دهد - توسط @gaborbernat https://github.com/gaborbernat. (#1715 https://github.com/pypa/virtualenv/issues/1715)
• پشتیبانی از پیاده‌سازی‌های Python 2 که نیاز دارند فایل‌های شاخص (landmark) و site.py به جای مسیر کتابخانه استاندارد محیط مجازی در کتابخانه استاندارد پلتفرم باشند (به‌ویژه برخی موارد RHEL، مانند ایمیج داکر amazonlinux:1) - توسط @gaborbernat https://github.com/gaborbernat. (#1719 https://github.com/pypa/virtualenv/issues/1719)
• اجازه به گذراندن موفقیت‌آمیز مجموعه آزمون‌ها حتی زمانی که با Python سیستم فراخوانی می‌شوند - جهت تسهیل بسته‌بندی مجدد ابزار برای توزیع‌های لینوکس - توسط @gaborbernat https://github.com/gaborbernat. (#1721 https://github.com/pypa/virtualenv/issues/1721)
• تولید اسکریپت کنسول pipx.y در کنار pip-x.y به منظور سازگاری با نحوه نصب خودِ pip - توسط @gaborbernat https://github.com/gaborbernat. (#1723 https://github.com/pypa/virtualenv/issues/1723)
• ایجاد خودکار پوشهٔ داده‌های برنامه در صورتی که وجود نداشته باشد - توسط @gaborbernat https://github.com/gaborbernat. (#1728 https://github.com/pypa/virtualenv/issues/1728)