عملگرهای ادغام و به‌روزرسانی دیکشنری¶

عملگرهای ادغام (|) و به‌روزرسانی (|=) به کلاس توکار dict افزوده شده‌اند. این عملگرها مکمل روش‌های موجود dict.update و {**d1, **d2} برای ادغام دیکشنری‌ها هستند.

مثال:

>>> x = {"key1": "value1 from x", "key2": "value2 from x"}
>>> y = {"key2": "value2 from y", "key3": "value3 from y"}
>>> x | y
{'key1': 'value1 from x', 'key2': 'value2 from y', 'key3': 'value3 from y'}
>>> y | x
{'key2': 'value2 from x', 'key3': 'value3 from y', 'key1': 'value1 from x'}

برای توضیح کامل به PEP 584 مراجعه کنید. (مشارکت از Brandt Bucher در bpo-36144.)

متدهای جدید رشته برای حذف پیشوندها و پسوندها¶

str.removeprefix(prefix) و str.removesuffix(suffix) اضافه شده‌اند تا بتوان به‌سادگی یک پیشوند یا پسوند غیرضروری را از یک رشته حذف کرد. متدهای متناظر bytes، bytearray و collections.UserString نیز اضافه شده‌اند. برای توضیح کامل به PEP 616 مراجعه کنید. (ارائه‌شده توسط Dennis Sweeney در bpo-39939.)

نوع‌های عام برای راهنمایی نوع در مجموعه‌های استاندارد¶

در حاشیه‌نویسی‌های نوع اکنون می‌توانید از نوع‌های مجموعه‌ای توکار مانند list و dict به‌عنوان نوع‌های عام استفاده کنید، به‌جای اینکه نوع‌های متناظر با حرف بزرگ (مثلاً List یا Dict) را از typing ایمپورت کنید. برخی دیگر از نوع‌ها در کتابخانه‌ی استاندارد نیز اکنون عام هستند، برای مثال queue.Queue.

مثال:

def greet_all(names: list[str]) -> None:
    for name in names:
        print("Hello", name)

برای جزئیات بیشتر به PEP 585 مراجعه کنید. (مشارکت‌شده توسط گیدو ون‌روسوم، ایتن اسمیت و باتوهان تاشکایا در bpo-39481.)

پارسر جدید¶

پایتون 3.9 از یک پارسر جدید استفاده می‌کند که به‌جای LL(1) مبتنی بر PEG است. کارایی پارسر جدید تقریباً با کارایی پارسر قدیمی برابری می‌کند، اما هنگام طراحی قابلیت‌های جدید زبان، صورت‌گرایی PEG انعطاف‌پذیرتر از LL(1) است. استفاده از این انعطاف‌پذیری را از پایتون 3.10 به بعد آغاز خواهیم کرد.

ماژول ast از پارسر جدید استفاده می‌کند و همان AST‌ای را تولید می‌کند که پارسر قدیمی تولید می‌کند.

در پایتون 3.10، پارسر قدیمی حذف خواهد شد و تمام قابلیت‌هایی که به آن وابسته‌اند نیز حذف خواهند شد (عمدتاً ماژول parser که مدت‌هاست منسوخ شده است). تنها در پایتون 3.9 می‌توانید با استفاده از یک سوییچ خط فرمان (-X oldparser) یا یک متغیر محیطی (PYTHONOLDPARSER=1) به پارسر LL(1) بازگردید.

برای جزئیات بیشتر به PEP 617 مراجعه کنید. (مشارکت‌شده توسط Guido van Rossum، Pablo Galindo و Lysandros Nikolaou در bpo-40334.)

zoneinfo¶

ماژول zoneinfo پشتیبانی از پایگاه داده منطقه‌های زمانی IANA را به کتابخانه استاندارد می‌آورد. این ماژول zoneinfo.ZoneInfo را می‌افزاید؛ یک پیاده‌سازی عینی از datetime.tzinfo که مبتنی بر داده‌های منطقه زمانی سیستم است.

مثال:

>>> from zoneinfo import ZoneInfo
>>> import datetime as dt

>>> # Daylight saving time
>>> when = dt.datetime(2020, 10, 31, 12, tzinfo=ZoneInfo("America/Los_Angeles"))
>>> print(when)
2020-10-31 12:00:00-07:00
>>> when.tzname()
'PDT'

>>> # Standard time
>>> when += dt.timedelta(days=7)
>>> print(when)
2020-11-07 12:00:00-08:00
>>> print(when.tzname())
PST

به‌عنوان منبع جایگزین داده‌ها برای پلتفرم‌هایی که پایگاه داده‌ی IANA را ارائه نمی‌کنند، ماژول tzdata به‌صورت یک بسته‌ی طرف اول (first-party) منتشر شد — بسته‌ای که از طریق PyPI توزیع می‌شود و توسط تیم اصلی سی‌پایتون نگهداری می‌شود.

graphlib¶

ماژول جدیدی به نام graphlib اضافه شد که شامل کلاس graphlib.TopologicalSorter برای ارائه‌ی قابلیت انجام مرتب‌سازی توپولوژیکی گراف‌ها است. (با مشارکت Pablo Galindo، Tim Peters و Larry Hastings در bpo-17005.)

ast¶

گزینه‌ی indent به dump() افزوده شد که به آن امکان می‌دهد خروجی چندسطری با تورفتگی تولید کند. (مشارکت سرهی استورچاکا در bpo-37995.)

تابع ast.unparse() به‌عنوان تابعی در ماژول ast افزوده شد که می‌توان از آن برای تجزیه‌گشایی (unparse) یک شیء ast.AST و تولید رشته‌ای حاوی کدی استفاده کرد که هنگام تجزیه، شیء ast.AST معادلی تولید می‌کند. (مشارکت‌شده توسط پابلو گالیندو و باتوهان تاسکایا در bpo-38870.)

به گره‌های AST رشته‌های مستندی اضافه شد که امضای ASDL مورد استفاده برای ساخت آن گره را شامل می‌شوند. (نوشته‌شده توسط Batuhan Taskaya در bpo-39638.)

asyncio¶

به دلیل نگرانی‌های امنیتی جدی، پارامتر reuse_address در asyncio.loop.create_datagram_endpoint() دیگر پشتیبانی نمی‌شود. دلیل این امر، رفتار گزینه‌ی سوکت SO_REUSEADDR در UDP است. برای جزئیات بیشتر، به مستندات loop.create_datagram_endpoint() مراجعه کنید. (با مشارکت کایل استنلی، آنتوان پی‌ترو و یوری سلیوانوف در bpo-37228.)

یک هم‌روال جدید به نام shutdown_default_executor() افزوده شد که خاتمه‌ی اجراکننده‌ی پیش‌فرض را زمان‌بندی می‌کند و منتظر می‌ماند تا ThreadPoolExecutor به‌طور کامل بسته شود. همچنین، asyncio.run() به‌روزرسانی شده است تا از هم‌روال جدید استفاده کند. (مشارکت‌شده توسط کایل استنلی در bpo-34037.)

asyncio.PidfdChildWatcher افزوده شد؛ یک پیاده‌سازی دیده‌بان فرزند (child watcher) مخصوص لینوکس که توصیف‌گرهای پرونده‌ی فرایند را پایش می‌کند. (bpo-38692)

یک هم‌روال جدید به نام asyncio.to_thread() اضافه شد. این هم‌روال عمدتاً برای اجرای توابع محدود به IO در یک نخ جداگانه به‌کار می‌رود تا از مسدود شدن حلقه رویداد جلوگیری شود، و اساساً به‌عنوان نسخه سطح بالایی از run_in_executor() کار می‌کند که می‌تواند مستقیماً آرگومان‌های کلیدواژه‌ای بپذیرد. (مشارکت کایل استنلی و یوری سلیوانوف در bpo-32309.)

هنگام لغو وظیفه به دلیل اتمام مهلت زمانی، asyncio.wait_for() اکنون در حالتی که timeout <= 0 است نیز، همان‌طور که با مهلت‌های زمانی مثبت انجام می‌دهد، تا کامل‌شدن لغو منتظر می‌ماند. (مشارکت‌شده توسط Elvis Pranskevichus در bpo-32751.)

asyncio اکنون هنگام فراخوانی متدهای نا‌سازگار با سوکتِ ssl.SSLSocket، استثنای TypeError را مطرح می‌کند. (مشارکت‌شده توسط Ido Michael در bpo-37404.)

compileall¶

امکان جدیدی اضافه شد تا از پیوندهای سخت برای پرونده‌های .pyc تکراری استفاده شود: پارامتر hardlink_dupes و گزینه‌ی خط فرمان --hardlink-dupes. (مشارکت‌شده توسط Lumír 'Frenzy' Balhar در bpo-40495.)

گزینه‌های جدیدی برای دستکاری مسیر در پرونده‌های .pyc حاصل اضافه شد: پارامترهای stripdir، prependdir و limit_sl_dest و گزینه‌های خط فرمان -s، -p و -e. امکان تعیین گزینه مربوط به یک سطح بهینه‌سازی به تعداد دفعات متعدد اضافه شد. (مشارکت‌شده توسط Lumír 'Frenzy' Balhar در bpo-38112.)

concurrent.futures¶

پارامتر جدید cancel_futures به concurrent.futures.Executor.shutdown() اضافه شد که همه‌ی آینده‌نماهای در انتظاری که هنوز اجرایشان آغاز نشده است را لغو می‌کند، به‌جای آن‌که پیش از خاموش کردن اجراکننده منتظر کامل شدن آن‌ها بماند. (با مشارکت کایل استنلی در bpo-39349.)

نخ‌های دِیمِن از ThreadPoolExecutor و ProcessPoolExecutor حذف شدند. این امر سازگاری با زیرمفسرها و پیش‌بینی‌پذیری در فرایندهای خاموش‌شدن آن‌ها را بهبود می‌بخشد. (مشارکت‌شده توسط کایل استنلی در bpo-39812.)

کارگرهای ProcessPoolExecutor اکنون به‌صورت درخواستی ایجاد می‌شوند، تنها زمانی که هیچ کارگر بیکاری برای استفاده مجدد در دسترس نباشد. این کار سربار راه‌اندازی را بهینه‌سازی می‌کند و مقدار زمان CPU تلف‌شده به‌دلیل کارگرهای بیکار را کاهش می‌دهد. (ارائه‌شده توسط کایل استنلی در bpo-39207.)

curses¶

توابع curses.get_escdelay()، curses.set_escdelay()، curses.get_tabsize() و curses.set_tabsize() افزوده شدند. (مشارکت توسط آنتونی ساتیل در bpo-38312.)

datetime¶

متدهای isocalendar() از datetime.date و isocalendar() از datetime.datetime اکنون به‌جای tuple یک namedtuple() بازمی‌گردانند. (مشارکت Donghee Na در bpo-24416.)

distutils¶

فرمان upload اکنون چکیده‌های هش SHA2-256 و Blake2b-256 را ایجاد می‌کند. در پلتفرم‌هایی که چکیده MD5 را مسدود می‌کنند، از MD5 صرف‌نظر می‌کند. (مشارکت‌شده توسط Christian Heimes در bpo-40698.)

fcntl¶

ثابت‌های fcntl.F_OFD_GETLK، fcntl.F_OFD_SETLK و fcntl.F_OFD_SETLKW اضافه شدند. (مشارکت‌شده توسط Donghee Na در bpo-38602.)

ftplib¶

FTP و FTP_TLS اکنون در صورتی که مهلت زمانی داده‌شده برای سازنده‌شان صفر باشد، برای جلوگیری از ایجاد سوکت غیر‌مسدودکننده، استثنای ValueError ایجاد می‌کنند. (مشارکت‌شده توسط دونگ‌هی نا در bpo-39259.)

gc¶

وقتی زباله‌روب جمع‌آوری‌ای انجام می‌دهد که در آن برخی اشیاء باززنده می‌شوند (پس از اجرای نهایی‌سازها، از بیرون چرخه‌های ایزوله قابل دسترس‌اند)، جمع‌آوری تمام اشیایی که همچنان غیرقابل دسترس‌اند را مسدود نمی‌کند. (با مشارکت Pablo Galindo و Tim Peters در bpo-38379.)

تابع جدید gc.is_finalized() برای بررسی اینکه آیا یک شیء توسط زباله‌روب نهایی‌سازی شده است یا خیر، اضافه شد. (مشارکت‌شده توسط پابلو گالیندو در bpo-39322.)

hashlib¶

ماژول hashlib اکنون می‌تواند در صورت موجود بودن OpenSSL، از هش‌های SHA3 و SHAKE XOF آن استفاده کند. (مشارکت‌شده توسط کریستین هایمز در bpo-37630.)

اکنون می‌توان ماژول‌های هش توکار را با ./configure --without-builtin-hashlib-hashes غیرفعال کرد یا به‌صورت انتخابی، مثلاً با ./configure --with-builtin-hashlib-hashes=sha3,blake2، فعال کرد تا استفاده از پیاده‌سازی مبتنی بر OpenSSL اجباری شود. (مشارکت Christian Heimes در bpo-40479)

http¶

کدهای وضعیت HTTP 103 EARLY_HINTS، 418 IM_A_TEAPOT و 425 TOO_EARLY به http.HTTPStatus افزوده شدند. (مشارکت Donghee Na در bpo-39509 و Ross Rhodes در bpo-39507.)

IDLE و idlelib¶

گزینه‌ای برای خاموش کردن چشمک‌زدن مکان‌نما اضافه شد. (با مشارکت Zackery Spytz در bpo-4603.)

کلید Escape اکنون پنجره‌های تکمیل IDLE را می‌بندد. (مشارکت از سوی Johnny Najera در bpo-38944.)

کلیدواژه‌ها به فهرست تکمیل نام ماژول افزوده شدند. (مشارکت‌شده توسط Terry J. Reedy در bpo-37765.)

جدید در نسخه‌های نگهداری 3.9

IDLE اکنون sys.excepthook() را فراخوانی می‌کند (وقتی بدون '-n' اجرا شود). قلاب‌های کاربر پیش‌تر نادیده گرفته می‌شدند. (ارائه‌شده توسط Ken Hilton در bpo-43008.)

تغییرات فوق به نسخه‌های نگهداری 3.8 بک‌پورت شده‌اند.

پنجره تنظیمات بازآرایی شد. زبانه General به زبانه‌های Windows و Shell/Ed تقسیم شد. منابع راهنما که منوی Help را گسترش می‌دهند، به زبانه Extensions منتقل شدند. برای گزینه‌های جدید فضا ایجاد شد و پنجره کوتاه‌تر شد. دومی باعث می‌شود پنجره تنظیمات با صفحه‌های نمایش کوچک بهتر متناسب شود. (مشارکت Terry Jan Reedy در bpo-40468.) تنظیم فضای تورفتگی از زبانه Font به زبانه جدید Windows منتقل شد. (مشارکت Mark Roseman و Terry Jan Reedy در bpo-33962.)

اعمال برجسته‌سازی نحوی بر پرونده‌های .pyi. (مشارکت‌شده توسط Alex Waygood و Terry Jan Reedy در bpo-45447.)

imaplib¶

کلاس‌های IMAP4 و IMAP4_SSL اکنون پارامتر اختیاری timeout برای سازنده‌های خود دارند. همچنین، متد open() با این تغییر اکنون پارامتر اختیاری timeout دارد. این تغییر بر متدهای بازنویسی‌شده‌ی IMAP4_SSL و IMAP4_stream نیز اعمال شد. (مشارکت Donghee Na در bpo-38615.)

imaplib.IMAP4.unselect() اضافه شد. imaplib.IMAP4.unselect() منابع سرور مربوط به صندوق پستی انتخاب‌شده را آزاد می‌کند و سرور را به وضعیت احراز هویت‌شده برمی‌گرداند. این دستور همان اقدامات imaplib.IMAP4.close() را انجام می‌دهد، با این تفاوت که هیچ پیامی به‌طور دائمی از صندوق پستی انتخاب‌شده‌ی فعلی حذف نمی‌شود. (مشارکت: Donghee Na در bpo-40375.)

importlib¶

برای بهبود سازگاری با دستورهای ایمپورت، importlib.util.resolve_name() اکنون برای تلاش‌های نامعتبر ایمپورت نسبی، به جای ValueError استثنای ImportError ایجاد می‌کند. (مشارکت‌شده توسط Ngalim Siregar در bpo-37444.)

بارگذارهای ایمپورت که اشیاء ماژول تغییرناپذیر منتشر می‌کنند، اکنون می‌توانند علاوه بر ماژول‌های منفرد، بسته‌های تغییرناپذیر نیز منتشر کنند. (با مشارکت Dino Viehland در bpo-39336.)

تابع importlib.resources.files() با پشتیبانی از زیرپوشه‌ها در داده‌های بسته اضافه شد که با بک‌پورت در نسخه 1.5 importlib_resources مطابقت دارد. (با مشارکت Jason R. Coombs در bpo-39791.)

importlib.metadata از importlib_metadata نسخه‌ی 1.6.1 به‌روزرسانی شد.

inspect¶

inspect.BoundArguments.arguments از OrderedDict به دیکشنری معمولی تغییر کرده است. (با مشارکت Inada Naoki در bpo-36350 و bpo-39775.)

ipaddress¶

ipaddress اکنون نشانی‌های محدوده‌دار IPv6 (نشانی IPv6 با پسوند %<scope_id>) را پشتیبانی می‌کند.

نشانی‌های IPv6 دارای محدوده را می‌توان با استفاده از ipaddress.IPv6Address تجزیه کرد. در صورت وجود، شناسه ناحیه محدوده (scope zone ID) از طریق ویژگی scope_id در دسترس است. (مشارکت‌شده توسط Oleksandr Pavliuk در bpo-34788.)

از پایتون 3.9.5 به بعد، ماژول ipaddress دیگر هیچ صفرِ ابتدایی‌ای را در رشته‌های آدرس IPv4 نمی‌پذیرد. (مشارکت‌شده توسط کریستین هایمز در bpo-36384).

math¶

تابع math.gcd() برای مدیریت آرگومان‌های متعدد گسترش یافت. پیش‌تر، این تابع تنها از دو آرگومان پشتیبانی می‌کرد. (مشارکت‌شده توسط Serhiy Storchaka در bpo-39648.)

math.lcm() اضافه شد: کمترین مضرب مشترک آرگومان‌های مشخص‌شده را برمی‌گرداند. (مشارکت‌شده توسط مارک دیکنسون، آنانتاکریشنان و سرهی استورچاکا در bpo-39479 و bpo-39648.)

تابع math.nextafter() اضافه شد: مقدار ممیز شناور بعدی پس از x به سمت y را برمی‌گرداند. (مشارکت‌شده توسط Victor Stinner در bpo-39288.)

تابع math.ulp() افزوده شد: مقدار کم‌ارزش‌ترین بیت یک عدد اعشاری را برمی‌گرداند. (مشارکت‌شده توسط Victor Stinner در bpo-39310.)

چندپردازشی (multiprocessing)¶

کلاس multiprocessing.SimpleQueue متد جدید close() را برای بستن صریح صف دارد. (مشارکت Victor Stinner در bpo-30966.)

nntplib¶

NNTP و NNTP_SSL اکنون در صورتی که مهلت زمانی داده‌شده برای سازنده‌ی آن‌ها صفر باشد، برای جلوگیری از ایجاد سوکت غیرمسدودکننده، استثنای ValueError را ایجاد می‌کنند. (مشارکت‌شده توسط دونگ‌هی نا در bpo-39259.)

os¶

CLD_KILLED و CLD_STOPPED برای si_code اضافه شدند. (مشارکت‌شده توسط Donghee Na در bpo-38493.)

قابلیت‌های مخصوص لینوکس os.pidfd_open() (bpo-38692) و os.P_PIDFD (bpo-38713) برای مدیریت فرایند با توصیف‌گرهای پرونده در دسترس قرار گرفتند.

تابع os.unsetenv() اکنون در ویندوز نیز در دسترس است. (ارائه‌شده توسط ویکتور استینر در bpo-39413.)

توابع os.putenv() و os.unsetenv() اکنون همیشه دسترس‌پذیر هستند. (مشارکت‌شده توسط Victor Stinner در bpo-39395.)

تابع os.waitstatus_to_exitcode() اضافه شد: یک وضعیت انتظار را به کد خروج تبدیل می‌کند. (مشارکت‌شده توسط Victor Stinner در bpo-40094.)

pathlib¶

متد pathlib.Path.readlink() افزوده شد که مشابه os.readlink() عمل می‌کند. (مشارکت‌شده توسط Girts Folkmanis در bpo-30618)

pdb¶

اکنون در ویندوز Pdb از ~/.pdbrc پشتیبانی می‌کند. (ارائه‌شده توسط Tim Hopper و Dan Lidral-Porter در bpo-20523.)

poplib¶

POP3 و POP3_SSL اکنون اگر مهلت زمانی داده‌شده برای سازنده‌شان صفر باشد، یک ValueError ایجاد می‌کنند تا از ساخت سوکت غیرمسدودکننده جلوگیری شود. (ارائه‌شده توسط Donghee Na در bpo-39259.)

pprint¶

pprint اکنون می‌تواند types.SimpleNamespace را به‌طور زیبا (pretty-print) چاپ کند. (با مشارکت کارل بوردوم هانسن در bpo-37376.)

pydoc¶

رشته مستند اکنون نه‌تنها برای کلاس، تابع، متد و غیره، بلکه برای هر شیء‌ای که ویژگی __doc__ مخصوص به خود را داشته باشد نمایش داده می‌شود. (مشارکت Serhiy Storchaka در bpo-40257.)

random¶

متد جدید random.Random.randbytes() اضافه شد: تولید بایت‌های تصادفی. (مشارکت‌شده توسط Victor Stinner در bpo-40286.)

signal¶

تابع مخصوص لینوکس signal.pidfd_send_signal() برای ارسال سیگنال‌ها به یک فرایند با استفاده از توصیف‌گر پرونده به‌جای شناسه‌ی فرایند (pid) افشا شد. (bpo-38712)

smtplib¶

SMTP و SMTP_SSL اکنون در صورتی که مهلت زمانی داده‌شده برای سازنده‌شان صفر باشد، برای جلوگیری از ساخت سوکت غیرمسدودکننده، یک ValueError ایجاد می‌کنند. (مشارکت دونگ‌هی نا در bpo-39259.)

سازنده‌ی LMTP اکنون یک پارامتر اختیاری timeout دارد. (مشارکت‌شده توسط Donghee Na در bpo-39329.)

socket¶

ماژول socket اکنون ثابت CAN_RAW_JOIN_FILTERS را روی لینوکس 4.1 و بالاتر اکسپورت می‌کند. (مشارکت‌شده توسط استفان تاتشنر و زاکری اسپیتز در bpo-25780.)

ماژول socket اکنون پروتکل CAN_J1939 را روی پلتفرم‌هایی که از آن پشتیبانی می‌کنند، پشتیبانی می‌کند. (مشارکت‌شده توسط Karl Ding در bpo-40291.)

ماژول socket اکنون دارای توابع socket.send_fds() و socket.recv_fds() است. (مشارکت‌شده توسط Joannah Nanjekye، Shinya Okano و Victor Stinner در bpo-28724.)

time¶

در AIX، thread_time() اکنون با thread_cputime() پیاده‌سازی شده است که وضوح نانوثانیه‌ای دارد، به جای clock_gettime(CLOCK_THREAD_CPUTIME_ID) که وضوح آن ۱۰ میلی‌ثانیه است. (مشارکت Batuhan Taskaya در bpo-40192)

sys¶

ویژگی جدید sys.platlibdir افزوده شد: نام پوشه کتابخانه مخصوص پلتفرم. از آن برای ساخت مسیر کتابخانه استاندارد و مسیرهای ماژول‌های توسعه‌ای نصب‌شده استفاده می‌شود. در بیشتر پلتفرم‌ها برابر "lib" است. در فدورا و SuSE، در پلتفرم‌های ۶۴ بیتی برابر "lib64" است. (با مشارکت Jan Matějek، Matěj Cepl، Charalampos Stratakis و Victor Stinner در bpo-1294959.)

پیش‌تر، sys.stderr در حالت غیرتعاملی بافر بلوکی داشت. اکنون stderr به‌طور پیش‌فرض همیشه بافر سطری دارد. (مشارکت‌شده توسط Jendrik Seipp در bpo-13601.)

tracemalloc¶

تابع tracemalloc.reset_peak() افزوده شد تا اندازه اوج بلوک‌های حافظه‌ی ردیابی‌شده به اندازه فعلی تنظیم شود تا بتوان اوج تکه‌های خاصی از کد را اندازه‌گیری کرد. (ارائه‌شده توسط Huon Wilson در bpo-40630.)

typing¶

PEP 593 نوع typing.Annotated را برای تزئین نوع‌های موجود با فراداده‌های خاصِ زمینه، و پارامتر جدید include_extras را در typing.get_type_hints() برای دسترسی به فراداده‌ها در زمان اجرا معرفی کرد. (مشارکت: Till Varoquaux و Konstantin Kashin.)

unicodedata¶

پایگاه داده یونیکد به نسخه‌ی 13.0.0 به‌روزرسانی شده است. (bpo-39926).

venv¶

اسکریپت‌های فعال‌سازی ارائه‌شده توسط venv اکنون همگی سفارشی‌سازی اعلان خود را به‌طور سازگار مشخص می‌کنند و همیشه از مقدار تعیین‌شده توسط __VENV_PROMPT__ استفاده می‌کنند. پیش‌تر برخی از اسکریپت‌ها بدون قید و شرط از __VENV_PROMPT__ استفاده می‌کردند، برخی دیگر تنها در صورتی که اتفاقاً تنظیم شده بود (که حالت پیش‌فرض همین بود)، و یکی نیز به‌جای آن از __VENV_NAME__ استفاده می‌کرد. (مشارکت‌شده توسط Brett Cannon در bpo-37663.)

xml¶

نویسه‌های فضای سفید درون ویژگی‌ها اکنون هنگام سریال‌سازی xml.etree.ElementTree به پرونده XML حفظ می‌شوند. نویسه‌های پایان سطر (EOLN) دیگر به "n" نرمال نمی‌شوند. این نتیجه‌ی بحث درباره‌ی نحوه‌ی تفسیر بخش ۲.۱۱ مشخصات XML است. (مشارکت‌شده توسط Mefistotelis در bpo-39011.)

تغییرات در API پایتون¶

• __import__() و importlib.util.resolve_name() اکنون به جای ValueError که قبلاً پرتاب می‌کردند، ImportError پرتاب می‌کنند. فراخوانندگانی که نوع استثنای مشخص را می‌گیرند و هم پایتون 3.9 و هم نسخه‌های پیشین را پشتیبانی می‌کنند، باید هر دو را با استفاده از except (ImportError, ValueError): بگیرند.

• اسکریپت‌های فعال‌سازی venv دیگر هنگامی که __VENV_PROMPT__ برابر "" تنظیم شده باشد، مورد خاصی در نظر نمی‌گیرند.

• متد select.epoll.unregister() دیگر خطای EBADF را نادیده نمی‌گیرد. (مشارکت‌شده توسط Victor Stinner در bpo-39239.)

• پارامتر compresslevel در bz2.BZ2File فقط‌کلیدواژه‌ای شد، زیرا پارامتر buffering حذف شده است. (مشارکت‌شده توسط Victor Stinner در bpo-39357.)

• AST ساده‌شده برای :[subscription term]. اندیس‌های ساده با مقدار خود و اسلایس‌های توسعه‌یافته به‌صورت تاپل نمایش داده خواهند شد. Index(value) خودِ value را برمی‌گرداند و ExtSlice(slices) مقدار Tuple(slices, Load()) را برمی‌گرداند. (با مشارکت Serhiy Storchaka در bpo-34822.)

• ماژول importlib اکنون متغیر محیطی PYTHONCASEOK را هنگام استفاده از گزینه‌های خط فرمان -E یا -I نادیده می‌گیرد.

• پارامتر encoding به‌عنوان یک پارامتر فقط-کلیدواژه‌ای به کلاس‌های ftplib.FTP و ftplib.FTP_TLS افزوده شده است، و کدگذاری پیش‌فرض برای پیروی از RFC 2640 از Latin-1 به UTF-8 تغییر یافته است.

• asyncio.loop.shutdown_default_executor() به AbstractEventLoop افزوده شده است؛ به این معنا که حلقه‌های رویداد جایگزینی که از آن ارث‌بری می‌کنند، باید این متد را تعریف کرده باشند. (ارائه‌شده توسط Kyle Stanley در bpo-34037.)

• مقادیر ثابت پرچم‌های آینده در ماژول __future__ به‌منظور جلوگیری از تداخل با پرچم‌های کامپایلر به‌روزرسانی شده‌اند. پیش‌تر PyCF_ALLOW_TOP_LEVEL_AWAIT با CO_FUTURE_DIVISION تداخل داشت. (مشارکت‌شده توسط Batuhan Taskaya در bpo-39562)

• array('u') اکنون به‌جای Py_UNICODE از wchar_t به‌عنوان نوع C استفاده می‌کند. این تغییر بر رفتار آن تأثیری ندارد، زیرا Py_UNICODE از پایتون 3.3 به بعد نام مستعار wchar_t است. (مشارکت‌شده توسط Inada Naoki در bpo-34538.)

• API logging.getLogger() اکنون هنگامی که نام 'root' به آن داده شود، گزارش‌گیر ریشه را بازمی‌گرداند، در حالی که پیش‌تر گزارش‌گیر غیرریشه‌ای با نام 'root' را بازگرداند. این می‌تواند بر مواردی تأثیر بگذارد که در آن‌ها کد کاربر به‌طور صریح یک گزارش‌گیر غیرریشه با نام 'root' را می‌خواهد، یا در ماژول سطح بالایی به نام 'root.py' با استفاده از logging.getLogger(__name__) یک گزارش‌گیر نمونه‌سازی می‌کند. (مشارکت‌شده توسط وینای ساجیپ در bpo-37742.)

• مدیریت تقسیم PurePath اکنون هنگامی که چیزی غیر از نمونه‌ای از str یا PurePath به آن ارسال شود، به جای ایجاد TypeError، NotImplemented را برمی‌گرداند. این امکان را فراهم می‌کند تا کلاس‌های سازگاری ایجاد کنید که از انواع ذکرشده ارث‌بری نمی‌کنند. (ارائه‌شده توسط Roger Aiudi در bpo-34775).

• از پایتون 3.9.5 به بعد، ماژول ipaddress دیگر هیچ صفر ابتدایی‌ای در رشته‌های نشانی IPv4 نمی‌پذیرد. صفرهای ابتدایی مبهم هستند و توسط برخی کتابخانه‌ها به‌عنوان نمادگذاری مبنای هشت تفسیر می‌شوند. برای مثال، تابع قدیمی socket.inet_aton() صفرهای ابتدایی را به‌عنوان نمادگذاری مبنای هشت در نظر می‌گیرد. پیاده‌سازی glibc از تابع مدرن inet_pton() هیچ صفر ابتدایی‌ای را نمی‌پذیرد. (مشارکت‌شده توسط Christian Heimes در bpo-36384).

• codecs.lookup() اکنون نام کدگذاری را به همان روش encodings.normalize_encoding() نرمال‌سازی می‌کند، با این تفاوت که codecs.lookup() نام را به حروف کوچک نیز تبدیل می‌کند. برای مثال، نام کدگذاری "latex+latin1" اکنون به "latex_latin1" نرمال‌سازی می‌شود. (مشارکت‌شده توسط Jordon Xu در bpo-37751.)

تغییرات در API زبان C¶

• از پایتون 3.8 به بعد، نمونه‌های نوع‌های تخصیص‌یافته در هیپ (مانند نوع‌هایی که با PyType_FromSpec() و APIهای مشابه ایجاد می‌شوند) به شیء نوع خود ارجاع نگه می‌دارند. همان‌طور که در «تغییرات در API زبان C» پایتون 3.8 اشاره شده است، در اکثریت قاطع موارد نباید هیچ اثر جانبی وجود داشته باشد، اما برای نوع‌هایی که تابع سفارشی tp_traverse دارند، اطمینان حاصل کنید که تمام توابع سفارشی tp_traverse نوع‌های تخصیص‌یافته در هیپ، نوع شیء را بازدید می‌کنند.

  مثال:

  int
  foo_traverse(PyObject *self, visitproc visit, void *arg)
  {
  // Rest of the traverse function
  #if PY_VERSION_HEX >= 0x03090000
      // This was not needed before Python 3.9 (Python issue 35810 and 40217)
      Py_VISIT(Py_TYPE(self));
  #endif
  }
  

  اگر تابع پیمایش شما کار خود را به tp_traverse کلاس پایه‌اش (یا نوع دیگری) واگذاری می‌کند، اطمینان حاصل کنید که Py_TYPE(self) فقط یک‌بار بازدید شود. توجه داشته باشید که انتظار می‌رود تنها نوع‌های هیپ نوع را در tp_traverse بازدید کنند.

  برای مثال، اگر تابع tp_traverse شما شامل موارد زیر باشد:

  base->tp_traverse(self, visit, arg)
  

  سپس اضافه کنید:

  #if PY_VERSION_HEX >= 0x03090000
      // این مورد پیش از پایتون 3.9 لازم نبود (bpo-35810 و bpo-40217)
      if (base->tp_flags & Py_TPFLAGS_HEAPTYPE) {
          // در نوع‌های هیپ، tp_traverse از قبل Py_TYPE(self) را بازدید کرده است
      } else {
          Py_VISIT(Py_TYPE(self));
      }
  #else
  

  (برای اطلاعات بیشتر به bpo-35810 و bpo-40217 مراجعه کنید.)

• توابع PyEval_CallObject، PyEval_CallFunction، PyEval_CallMethod و PyEval_CallObjectWithKeywords منسوخ شده‌اند. به جای آن‌ها از PyObject_Call() و گونه‌های آن استفاده کنید. (برای جزئیات بیشتر به bpo-29548 مراجعه کنید.)

تغییرات بایت‌کد سی‌پایتون¶

• آپ‌کد LOAD_ASSERTION_ERROR برای مدیریت دستور assert افزوده شد. پیش‌تر، اگر استثنای AssertionError پوشانده شده بود، دستور assert به‌درستی کار نمی‌کرد. (مشارکت‌شده توسط Zackery Spytz در bpo-34880.)

• آپ‌کد COMPARE_OP به چهار دستور مجزا تفکیک شد:

  • COMPARE_OP برای مقایسه‌های غنی (rich comparison)

  • IS_OP برای آزمون‌های 'is' و 'is not'

  • CONTAINS_OP برای آزمون‌های 'in' و 'not in'

  • JUMP_IF_NOT_EXC_MATCH برای بررسی استثناها در دستورهای 'try-except'.

  (با مشارکت Mark Shannon در bpo-39156.)

قابلیت‌های جدید¶

• PEP 573: PyType_FromModuleAndSpec() برای مرتبط کردن یک ماژول با یک کلاس اضافه شد؛ PyType_GetModule() و PyType_GetModuleState() برای بازیابی ماژول و وضعیت آن؛ و PyCMethod و METH_METHOD برای اینکه به یک متد اجازه دهند به کلاسی که در آن تعریف شده است دسترسی داشته باشد. (مشارکت‌شده توسط مارسل پلچ و پتر ویکتورین در bpo-38787.)

• تابع PyFrame_GetCode() افزوده شد: دریافت کد یک فریم. تابع PyFrame_GetBack() افزوده شد: دریافت فریم بیرونی بعدی از فریم. (مشارکت‌شده توسط Victor Stinner در bpo-40421.)

• PyFrame_GetLineNumber() به API محدود C اضافه شد. (مشارکت‌شده توسط Victor Stinner در bpo-40421.)

• توابع PyThreadState_GetInterpreter() و PyInterpreterState_Get() برای دریافت مفسر اضافه شدند. تابع PyThreadState_GetFrame() برای دریافت فریم فعلی وضعیت نخ پایتون اضافه شد. تابع PyThreadState_GetID() اضافه شد: دریافت شناسه یکتای وضعیت نخ پایتون. (نوشته‌شده توسط Victor Stinner در bpo-39947.)

• تابع عمومی جدید PyObject_CallNoArgs() به API زبان C اضافه شد که یک شیء پایتون فراخوانی‌پذیر را بدون هیچ آرگومانی فراخوانی می‌کند. این کارآمدترین روش برای فراخوانی یک شیء پایتون فراخوانی‌پذیر بدون هیچ آرگومانی است. (مشارکت‌شده توسط Victor Stinner در bpo-37194.)

• تغییرات در API محدود C (اگر ماکروی Py_LIMITED_API تعریف شده باشد):

  • Py_EnterRecursiveCall() و Py_LeaveRecursiveCall() به‌عنوان توابع معمولی برای API محدود ارائه شده‌اند. پیش‌تر، این توابع به‌صورت ماکرو تعریف شده بودند، اما این ماکروها با C API محدود کامپایل نمی‌شدند، زیرا این API نمی‌تواند به فیلد PyThreadState.recursion_depth دسترسی داشته باشد (ساختار مذکور در C API محدود مات است).

  • PyObject_INIT() و PyObject_INIT_VAR() به توابع معمولی «مات» تبدیل می‌شوند تا جزئیات پیاده‌سازی را پنهان کنند.

  (مشارکت‌شده توسط ویکتور استینر در bpo-38644 و bpo-39542.)

• تابع PyModule_AddType() برای کمک به افزودن یک نوع به یک ماژول افزوده‌شده است. (مشارکت‌شده توسط Donghee Na در bpo-40024.)

• توابع PyObject_GC_IsTracked() و PyObject_GC_IsFinalized() به API عمومی افزوده شدند تا به ترتیب بتوان پرس‌وجو کرد که آیا اشیای پایتون در حال حاضر پیگیری می‌شوند یا پیش‌تر توسط زباله‌روب نهایی‌شده‌اند. (مشارکت‌شده توسط پابلو گالیندو سالگادو در bpo-40241.)

• تابع _PyObject_FunctionStr() برای به دست آوردن بازنمایی رشته‌ای کاربرپسند از یک شیء شبه‌تابع افزوده شد. (وصل توسط Jeroen Demeyer در bpo-37645.)

• تابع PyObject_CallOneArg() برای فراخوانی یک شیء با یک آرگومان جایگاهی افزوده شد (وصل توسط Jeroen Demeyer در bpo-37483.)

انتقال به پایتون 3.9¶

• PyInterpreterState.eval_frame (PEP 523) اکنون به یک پارامتر الزامی جدید tstate (PyThreadState*) نیاز دارد. (مشارکت‌شده توسط Victor Stinner در bpo-38500.)

• ماژول‌های توسعه‌ای: توابع m_traverse، m_clear و m_free در PyModuleDef دیگر فراخوانی نمی‌شوند اگر وضعیت ماژول درخواست شده باشد اما هنوز تخصیص نیافته باشد. این حالت بلافاصله پس از ایجاد ماژول و پیش از اجرای آن برقرار است (تابع Py_mod_exec). به بیان دقیق‌تر، این توابع فراخوانی نمی‌شوند اگر m_size بزرگ‌تر از ۰ باشد و وضعیت ماژول (همان‌طور که توسط PyModule_GetState() بازگردانده می‌شود) برابر NULL باشد.

  ماژول‌های توسعه‌ای فاقد وضعیت ماژول (m_size <= 0) تأثیر نمی‌پذیرند.

• اگر Py_AddPendingCall() در یک زیرمفسر فراخوانی شود، این تابع اکنون برای فراخوانی از خودِ زیرمفسر زمان‌بندی می‌شود، نه از مفسر اصلی. هر زیرمفسر اکنون فهرست فراخوانی‌های زمان‌بندی‌شده‌ی خود را دارد. (مشارکت‌شده توسط Victor Stinner در bpo-39984.)

• هنگامی که گزینه‌ی -E استفاده می‌شود (اگر PyConfig.use_environment برابر 0 تنظیم شده باشد)، رجیستری ویندوز دیگر برای مقداردهی اولیه‌ی sys.path استفاده نمی‌شود. این موضوع هنگام تعبیه پایتون در ویندوز اهمیت دارد. (مشارکت‌شده توسط Zackery Spytz در bpo-8901.)

• متغیر سراسری PyStructSequence_UnnamedField اکنون یک ثابت است و به یک رشته ثابت ارجاع می‌دهد. (مشارکت‌شده توسط Serhiy Storchaka در bpo-38650.)

• ساختار PyGC_Head اکنون مات است. این ساختار تنها در API داخلی C (pycore_gc.h) تعریف‌شده است. (مشارکت‌شده توسط Victor Stinner در bpo-40241.)

• Py_UNICODE_COPY، Py_UNICODE_FILL، PyUnicode_WSTR_LENGTH، PyUnicode_FromUnicode()، PyUnicode_AsUnicode()، _PyUnicode_AsUnicode و PyUnicode_AsUnicodeAndSize() در C به‌عنوان منسوخ علامت‌گذاری شده‌اند. آن‌ها از پایتون 3.3 به بعد توسط PEP 393 منسوخ شده‌اند. (مشارکت‌شده توسط Inada Naoki در bpo-36346.)

• تابع Py_FatalError() با ماکرویی جایگزین شده است که به‌طور خودکار نام تابع فعلی را ثبت می‌کند، مگر آنکه ماکرو Py_LIMITED_API تعریف شده باشد. (مشارکت‌شده توسط Victor Stinner در bpo-39882.)

• پروتکل فراخوانی برداری (vectorcall) اکنون الزام می‌کند که فراخوانی‌کننده فقط رشته‌ها را به‌عنوان نام‌های کلیدواژه عبور دهد. (برای اطلاعات بیشتر به bpo-37540 مراجعه کنید.)

• جزئیات پیاده‌سازی تعدادی از ماکروها و توابع اکنون پنهان شده‌اند:

  • ماکروی PyObject_IS_GC() به یک تابع تبدیل شد.

  • ماکروی PyObject_NEW() به نام مستعاری برای ماکروی PyObject_New تبدیل می‌شود و ماکروی PyObject_NEW_VAR() به نام مستعاری برای ماکروی PyObject_NewVar تبدیل می‌شود. این ماکروها دیگر مستقیماً به عضو PyTypeObject.tp_basicsize دسترسی ندارند.

  • ماکرو PyObject_GET_WEAKREFS_LISTPTR() به یک تابع تبدیل شد: این ماکرو مستقیماً به عضو PyTypeObject.tp_weaklistoffset دسترسی داشت.

  • ماکرو PyObject_CheckBuffer() به یک تابع تبدیل شد: این ماکرو مستقیماً به عضو PyTypeObject.tp_as_buffer دسترسی داشت.

  • PyIndex_Check() اکنون همیشه به‌صورت یک تابع مات اعلان می‌شود تا جزئیات پیاده‌سازی پنهان بماند: ماکرو PyIndex_Check() حذف شد. این ماکرو مستقیماً به عضو PyTypeObject.tp_as_number دسترسی داشت.

  (برای جزئیات بیشتر به bpo-40170 مراجعه کنید.)

حذف‌شده¶

• ماکروهای PyFPE_START_PROTECT() و PyFPE_END_PROTECT() در pyfpe.h از C API محدود حذف شدند. (مشارکت‌شده توسط Victor Stinner در bpo-38835.)

• جایگاه tp_print در PyTypeObject حذف شده است. این جایگاه در پایتون 2.7 و قبل از آن برای چاپ اشیاء در پرونده‌ها استفاده می‌شد. از پایتون 3.0 به بعد، نادیده گرفته شده و استفاده نمی‌شده است. (مشارکت‌شده توسط Jeroen Demeyer در bpo-36974.)

• تغییرات در API محدود C (اگر ماکروی Py_LIMITED_API تعریف شده باشد):

  • توابع زیر از C API محدود مستثنا شدند:

    • PyThreadState_DeleteCurrent() (مشارکت‌شده توسط Joannah Nanjekye در bpo-37878.)

    • _Py_CheckRecursionLimit

    • _Py_NewReference()

    • _Py_ForgetReference()

    • _PyTraceMalloc_NewReference()

    • _Py_GetRefTotal()

    • سازوکار سطل زباله (trashcan) که هرگز در C API محدود کار نمی‌کرد.

    • PyTrash_UNWIND_LEVEL

    • Py_TRASHCAN_BEGIN_CONDITION

    • Py_TRASHCAN_BEGIN

    • Py_TRASHCAN_END

    • Py_TRASHCAN_SAFE_BEGIN

    • Py_TRASHCAN_SAFE_END

  • توابع و تعریف‌های زیر به API داخلی C منتقل شدند:

    • _PyDebug_PrintTotalRefs()

    • _Py_PrintReferences()

    • _Py_PrintReferenceAddresses()

    • _Py_tracemalloc_config

    • _Py_AddToAllObjects() (ویژه‌ی ساخت‌ Py_TRACE_REFS)

  (مشارکت‌شده توسط ویکتور استینر در bpo-38644 و bpo-39542.)

• قلاب _PyRuntime.getframe و ماکروی _PyThreadState_GetFrame که مستعاری برای _PyRuntime.getframe بود، حذف شدند. این‌ها فقط توسط API داخلی C در دسترس بودند. نوع PyThreadFrameGetter نیز حذف شد. (مشارکت‌شده توسط Victor Stinner در bpo-39946.)

• توابع زیر از C API حذف شدند. برای پاک‌سازی تمام فهرست‌های آزاد، PyGC_Collect() را صریحاً فراخوانی کنید. (مشارکت‌شده توسط Inada Naoki و Victor Stinner در bpo-37340، bpo-38896 و bpo-40428.)

  • PyAsyncGen_ClearFreeLists()

  • PyContext_ClearFreeList()

  • PyDict_ClearFreeList()

  • PyFloat_ClearFreeList()

  • PyFrame_ClearFreeList()

  • PyList_ClearFreeList()

  • PyMethod_ClearFreeList() و PyCFunction_ClearFreeList(): فهرست‌های آزاد (free list) اشیاء متد مقید حذف شده‌اند.

  • PySet_ClearFreeList(): فهرست آزاد (free list) مجموعه در پایتون 3.4 حذف شده است.

  • PyTuple_ClearFreeList()

  • PyUnicode_ClearFreeList(): فهرست آزاد یونیکد در پایتون 3.3 حذف شده است.

• تابع _PyUnicode_ClearStaticStrings() حذف شد. (به کوشش Victor Stinner در bpo-39465.)

• Py_UNICODE_MATCH حذف شد. این مورد توسط PEP 393 منسوخ اعلام شده است و از پایتون 3.3 به بعد خراب بوده است. می‌توان به جای آن از تابع PyUnicode_Tailmatch() استفاده کرد. (مشارکت‌شده توسط Inada Naoki در bpo-36346.)

• پرونده‌های سرآیند از رابط‌هایی که تعریف شده بودند اما پیاده‌سازی نداشتند، پاک‌سازی شدند. نمادهای API عمومی که حذف می‌شوند عبارت‌اند از: _PyBytes_InsertThousandsGroupingLocale، _PyBytes_InsertThousandsGrouping، _Py_InitializeFromArgs، _Py_InitializeFromWideArgs، _PyFloat_Repr، _PyFloat_Digits، _PyFloat_DigitsInit، PyFrame_ExtendStack، _PyAIterWrapper_Type، PyNullImporter_Type، PyCmpWrapper_Type، PySortWrapper_Type، PyNoArgsFunction. (مشارکت‌شده توسط پابلو گالیندو سالگادو در bpo-39372.)

typing¶

رفتار typing.Literal تغییر یافت تا با PEP 586 مطابقت داشته باشد و با رفتار بررسی‌گرهای نوع ایستا که در آن PEP مشخص شده است، هم‌خوانی کند.

1. Literal اکنون پارامترهای تکراری را حذف می‌کند.

2. مقایسه‌های برابری بین اشیاء Literal اکنون مستقل از ترتیب هستند.

3. مقایسه‌های Literal اکنون نوع‌ها را در نظر می‌گیرند. برای مثال، Literal[0] == Literal[False] پیش‌تر به True ارزیابی می‌شد. اکنون False است. برای پشتیبانی از این تغییر، نهانگاه نوعِ استفاده‌شده به‌صورت داخلی اکنون از تمایز نوع‌ها پشتیبانی می‌کند.

4. شیءهای Literal اکنون هنگام مقایسه‌های برابری، اگر هر یک از پارامترهایشان هش‌پذیر نباشد، استثنای TypeError ایجاد می‌کنند. توجه داشته باشید که تعریف Literal با پارامترهای تغییرپذیر خطایی پرتاب نمی‌کند:

   >>> from typing import Literal
   >>> Literal[{0}]
   >>> Literal[{0}] == Literal[{False}]
   Traceback (most recent call last):
     File "<stdin>", line 1, in <module>
   TypeError: unhashable type: 'set'
   

(مشارکت‌شده توسط Yurii Karabas در bpo-42345.)

پشتیبانی از macOS 11.0 (Big Sur) و مک‌های Apple Silicon¶

از نسخه‌ی 3.9.1 به بعد، پایتون اکنون به‌طور کامل از ساخت و اجرا روی macOS 11.0 (Big Sur) و روی مک‌های Apple Silicon (مبتنی بر معماری ARM64) پشتیبانی می‌کند. یک گونه‌ی ساخت همگانی جدید، universal2، اکنون در دسترس است تا از هر دو ARM64 و Intel 64 به‌صورت بومی در یک مجموعه از پرونده‌های اجرایی پشتیبانی کند. همچنین اکنون می‌توان پرونده‌های دودویی را روی نسخه‌های فعلی macOS ساخت تا روی طیفی از نسخه‌های قدیمی‌تر macOS مستقر شوند (تا نسخه‌ی 10.9 آزمایش شده است)؛ در عین حال، برخی از توابع و گزینه‌های جدیدتر سیستم‌عامل به‌صورت مشروط و بر اساس نسخه‌ی سیستم‌عاملی که در زمان اجرا استفاده می‌شود در دسترس قرار می‌گیرند (پیوند‌دهی ضعیف یا "weaklinking").

(مشارکت‌شده توسط رونالد اوسورن و لارنس دآنا در bpo-41100.)

collections.abc¶

نوع عام collections.abc.Callable اکنون پارامترهای نوع را تخت‌سازی می‌کند، مشابه کاری که typing.Callable در حال حاضر انجام می‌دهد. این بدان معناست که collections.abc.Callable[[int, str], str] دارای __args__ برابر با (int, str, str) خواهد بود؛ پیش‌تر این مقدار ([int, str], str) بود. برای امکان‌پذیر کردن این تغییر، types.GenericAlias اکنون قابل زیرکلاس‌سازی است و هنگام زیرنویسی نوع collections.abc.Callable، یک زیرکلاس بازگردانده خواهد شد. کدهایی که به آرگومان‌ها از طریق typing.get_args() یا __args__ دسترسی دارند، باید این تغییر را در نظر بگیرند. ممکن است DeprecationWarning برای شکل‌های نامعتبر پارامتری‌سازی collections.abc.Callable که ممکن است در پایتون 3.9.1 بی‌صدا عبور کرده باشند، صادر شود. این DeprecationWarning در پایتون 3.10 به TypeError تبدیل خواهد شد. (با مشارکت Ken Jin در bpo-42195.)

urllib.parse¶

نسخه‌های پیشین پایتون اجازه می‌دادند که هم از ; و هم از & به‌عنوان جداکننده‌ی پارامترهای پرس‌وجو در urllib.parse.parse_qs() و urllib.parse.parse_qsl() استفاده شود. به‌دلیل نگرانی‌های امنیتی، و برای انطباق با توصیه‌های جدیدتر W3C، این مورد تغییر کرده است تا تنها یک کلید جداکننده مجاز باشد که مقدار پیش‌فرض آن & است. این تغییر بر cgi.parse() و cgi.parse_multipart() نیز اثر می‌گذارد، زیرا این توابع به‌طور داخلی از توابع مذکور استفاده می‌کنند. برای جزئیات بیشتر، لطفاً به مستندات مربوط به هر یک از آن‌ها مراجعه کنید. (با مشارکت آدام گلدشمیت، سنتیل کوماران و کن جین در bpo-42967.)

urllib.parse¶

وجود نویسه‌های سطر جدید یا تب در بخش‌هایی از یک URL، امکان برخی انواع حملات را فراهم می‌کند. مطابق با مشخصات WHATWG که RFC 3986 را به‌روزرسانی می‌کند، نویسه‌های اسکی سطر جدید \n، \r و نویسه‌های تب \t توسط پارسر در urllib.parse از URL حذف می‌شوند تا از چنین حملاتی جلوگیری شود. نویسه‌های حذف‌شونده توسط یک متغیر جدید در سطح ماژول به نام urllib.parse._UNSAFE_URL_BYTES_TO_REMOVE کنترل می‌شوند. (نگاه کنید به gh-88048)

tarfile¶

• متدهای استخراج در tarfile و shutil.unpack_archive() آرگومان جدیدی به نام filter دارند که امکان محدود کردن ویژگی‌های tar را فراهم می‌کند؛ ویژگی‌هایی که ممکن است غافلگیرکننده یا خطرناک باشند، مانند ایجاد پرونده‌ها بیرون از پوشه‌ی مقصد. برای جزئیات، به فیلترهای استخراج مراجعه کنید. در پایتون 3.12، استفاده بدون آرگومان فیلتر باعث نمایش DeprecationWarning خواهد شد. در پایتون 3.14، پیش‌فرض به 'data' تغییر خواهد کرد. (مشارکت‌شده توسط Petr Viktorin در PEP 706.)