PEP 649 و PEP 749: ارزیابی معوق حاشیه‌نویسی‌ها¶

حاشیه‌نویسی‌های توابع، کلاس‌ها و ماژول‌ها دیگر به‌طور فوری ارزیابی نمی‌شوند. در عوض، حاشیه‌نویسی‌ها در توابع ویژه‌ی حاشیه‌نویسی ذخیره می‌شوند و فقط هنگام نیاز ارزیابی می‌شوند (مگر اینکه از from __future__ import annotations استفاده شود).

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

ماژول جدید annotationlib ابزارهایی برای بررسی حاشیه‌نویسی‌های معوق فراهم می‌کند. حاشیه‌نویسی‌ها را می‌توان در قالب VALUE (که حاشیه‌نویسی‌ها را به مقادیر زمان اجرا ارزیابی می‌کند، مشابه رفتار نسخه‌های پیشین پایتون)، قالب FORWARDREF (که نام‌های تعریف‌نشده را با نشانگرهای ویژه جایگزین می‌کند) و قالب STRING (که حاشیه‌نویسی‌ها را به‌صورت رشته برمی‌گرداند) ارزیابی کرد.

این مثال نشان می‌دهد که این قالب‌ها چگونه رفتار می‌کنند:

>>> from annotationlib import get_annotations, Format
>>> def func(arg: Undefined):
...     pass
>>> get_annotations(func, format=Format.VALUE)
Traceback (most recent call last):
  ...
NameError: name 'Undefined' is not defined
>>> get_annotations(func, format=Format.FORWARDREF)
{'arg': ForwardRef('Undefined', owner=<function func at 0x...>)}
>>> get_annotations(func, format=Format.STRING)
{'arg': 'Undefined'}

بخش انتقال شامل راهنمایی‌هایی درباره‌ی تغییراتی است که ممکن است به دلیل این تغییرات لازم باشند، هرچند در اکثر موارد، کد بدون تغییر به کار خود ادامه خواهد داد.

(مشارکت‌کرده توسط Jelle Zijlstra در PEP 749 و gh-119180؛ PEP 649 توسط Larry Hastings نوشته شد.)

PEP 734: مفسرهای متعدد در کتابخانه استاندارد¶

ران‌تایم سی‌پایتون از اجرای همزمان چند رونوشت از پایتون در یک فرایند واحد پشتیبانی می‌کند و بیش از ۲۰ سال است که این کار را انجام می‌دهد. هر یک از این رونوشت‌های جداگانه «مفسر» نامیده می‌شود. با این حال، این قابلیت تنها از طریق C-API در دسترس بوده است.

این محدودیت در پایتون 3.14 با ماژول جدید concurrent.interpreters برداشته شده است.

دست‌کم دو دلیل قابل‌توجه وجود دارد که چرا استفاده از چند مفسر مزایای چشمگیری دارد:

• آن‌ها از یک مدل هم‌روندی جدید (برای پایتون) و دوستدار انسان پشتیبانی می‌کنند

• موازی‌سازی واقعی چند‌هسته‌ای

برای برخی موارد استفاده، همروایی در نرم‌افزار در نگاه کلان کارایی را بهبود می‌بخشد و می‌تواند طراحی را ساده‌تر کند. در همان حال، پیاده‌سازی و نگهداری هر نوع همروایی به جز ساده‌ترین‌ها، اغلب برای مغز انسان تلاشی طاقت‌فرسا است. این موضوع به‌ویژه در مورد نخ‌های ساده صدق می‌کند (برای مثال، threading)، که در آن‌ها تمام حافظه میان همه‌ی نخ‌ها مشترک است.

با چندین مفسر ایزوله، می‌توانید از دسته‌ای از مدل‌های همزمانی، مانند فرایندهای ترتیبی ارتباط‌برقرارکننده (CSP) یا مدل بازیگر (actor)، که در زبان‌های برنامه‌نویسی دیگر مانند Smalltalk، Erlang، Haskell و Go به موفقیت دست یافته‌اند، بهره ببرید. مفسرهای متعدد را مانند نخ‌ها در نظر بگیرید، اما با اشتراک‌گذاری اختیاری.

درباره‌ی موازی‌سازی چندهسته‌ای: از پایتون 3.12 به بعد، مفسرها اکنون به اندازه‌ی کافی از یکدیگر جدا شده‌اند تا بتوان از آن‌ها به صورت موازی استفاده کرد (به PEP 684 مراجعه کنید). این امر انواعی از موارد استفاده‌ی سنگین از نظر CPU را برای پایتون ممکن می‌سازد که توسط GIL محدود شده بودند.

استفاده از چندین مفسر از بسیاری جهات شبیه به multiprocessing است، از این جهت که هر دو «فرایندهای» منطقی جداشده‌ای فراهم می‌کنند که می‌توانند به‌طور موازی اجرا شوند و به‌طور پیش‌فرض هیچ اشتراکی ندارند. با این حال، هنگام استفاده از چندین مفسر، یک برنامه منابع سیستمی کمتری استفاده می‌کند و کارآمدتر عمل می‌کند (زیرا در همان فرایند باقی می‌ماند). چندین مفسر را این‌گونه در نظر بگیرید: جداسازی فرایندها همراه با کارایی نخ‌ها.

اگرچه این ویژگی چند دهه است که وجود دارد، اما مفسرهای چندگانه به دلیل آگاهی کم و نبود ماژولی در کتابخانه استاندارد، به‌طور گسترده استفاده نشده‌اند. در نتیجه، این مفسرها در حال حاضر چندین محدودیت قابل توجه دارند که انتظار می‌رود اکنون که این ویژگی به جریان اصلی تبدیل می‌شود، به‌طور چشمگیری بهبود یابند.

محدودیت‌های فعلی:

• راه‌اندازی هر مفسر هنوز بهینه‌سازی نشده است

• هر مفسر بیش از حافظه‌ی لازم استفاده می‌کند (کار روی اشتراک‌گذاری داخلی گسترده میان مفسرها ادامه دارد)

• گزینه‌های زیادی برای اشتراک‌گذاری واقعی اشیاء یا داده‌های دیگر بین مفسرها هنوز وجود ندارد (به‌جز memoryview)

• بسیاری از ماژول‌های توسعه‌ای شخص ثالث در PyPI هنوز با چندین مفسر سازگار نیستند (تمام ماژول‌های توسعه‌ای کتابخانه استاندارد سازگار هستند)

• رویکرد به نوشتن برنامه‌هایی که از چندین مفسر ایزوله استفاده می‌کنند، فعلاً برای کاربران پایتون عمدتاً ناآشناست

تأثیر این محدودیت‌ها به بهبودهای آتی سی‌پایتون، نحوه استفاده از مفسرها و مسائلی که کامیونیتی از طریق بسته‌های PyPI حل می‌کند، بستگی خواهد داشت. بسته به مورد استفاده، ممکن است این محدودیت‌ها تأثیر چندانی نداشته باشند، پس آن را امتحان کنید!

علاوه بر این، نسخه‌های آینده‌ی سی‌پایتون سربار را کاهش داده یا حذف خواهند کرد و ابزارهایی فراهم خواهند کرد که کمتر مناسب است در PyPI قرار بگیرند. در این میان، بیشترِ محدودیت‌ها را می‌توان از طریق ماژول‌های توسعه‌ای نیز برطرف کرد؛ به این معنا که بسته‌های PyPI می‌توانند برای 3.14 هر شکافی را پر کنند و حتی تا 3.12، نسخه‌ای که در آن مفسرها سرانجام به‌درستی جدا شدند و اشتراک قفل مفسر سراسری را متوقف کردند. به همین ترتیب، انتظار می‌رود کتابخانه‌هایی در PyPI برای انتزاع‌های سطح بالا بر فراز مفسرها پدیدار شوند.

در مورد ماژول‌های توسعه‌ای، کار برای به‌روزرسانی برخی پروژه‌های PyPI و همچنین ابزارهایی مانند Cython، pybind11، nanobind و PyO3 در جریان است. مراحل جداسازی یک ماژول توسعه‌ای در جداسازی ماژول‌های توسعه آمده است. جداسازی یک ماژول با آنچه برای پشتیبانی از نخ‌بندی آزاد لازم است، همپوشانی زیادی دارد؛ بنابراین کارهای جاری کامیونیتی در این حوزه به تسریع پشتیبانی از مفسرهای متعدد کمک خواهد کرد.

همچنین در 3.14 افزوده شد: concurrent.futures.InterpreterPoolExecutor.

(مشارکت‌شده توسط اریک اسنو در gh-134939.)

PEP 750: مقادیر لفظی رشته قالبی¶

رشته‌های قالبی سازوکار جدیدی برای پردازش سفارشی رشته‌ها هستند. آن‌ها سینتکس آشنای اف‌استرینگ‌ها را به اشتراک می‌گذارند، اما برخلاف اف‌استرینگ‌ها، به‌جای یک str ساده، شیء‌ای را برمی‌گردانند که بخش‌های ایستا و درون‌یابی‌شده‌ی رشته را نمایندگی می‌کند.

برای نوشتن یک تی‌استرینگ، به‌جای پیشوند 'f' از پیشوند 't' استفاده کنید:

>>> variety = 'Stilton'
>>> template = t'Try some {variety} cheese!'
>>> type(template)
<class 'string.templatelib.Template'>

اشیاء Template دسترسی به بخش‌های ایستا و درون‌یابی‌شده (درون آکولادها) یک رشته را پیش از ترکیب شدن آن‌ها فراهم می‌کنند. برای دسترسی به بخش‌هایشان به ترتیب، روی نمونه‌های Template پیمایش کنید:

>>> list(template)
['Try some ', Interpolation('Stilton', 'variety', None, ''), ' cheese!']

نوشتن (یا فراخوانی) کد برای پردازش نمونه‌های Template آسان است. برای مثال، تابع زیر بخش‌های ایستا را با حروف کوچک و نمونه‌های Interpolation را با حروف بزرگ رندر می‌کند:

from string.templatelib import Interpolation

def lower_upper(template):
    """Render static parts lowercase and interpolations uppercase."""
    parts = []
    for part in template:
        if isinstance(part, Interpolation):
            parts.append(str(part.value).upper())
        else:
            parts.append(part.lower())
    return ''.join(parts)

name = 'Wenslydale'
template = t'Mister {name}'
assert lower_upper(template) == 'mister WENSLYDALE'

از آنجا که نمونه‌های Template در زمان اجرا بین رشته‌های ایستا و درون‌یابی‌ها تمایز قائل می‌شوند، می‌توانند برای پاکسازی ورودی کاربر مفید باشند. نوشتن تابع html() که ورودی کاربر را در HTML خنثی کند، تمرینی است که به خواننده واگذار می‌شود! کد پردازش قالب می‌تواند انعطاف‌پذیری بهتری فراهم کند. برای نمونه، تابع html() پیشرفته‌تری می‌تواند یک dict از ویژگی‌های HTML را مستقیماً در قالب بپذیرد:

attributes = {'src': 'limburger.jpg', 'alt': 'lovely cheese'}
template = t'<img {attributes}>'
assert html(template) == '<img src="limburger.jpg" alt="lovely cheese" />'

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

با وجود تی‌استرینگ‌ها، توسعه‌دهندگان می‌توانند سیستم‌هایی بنویسند که SQL را پاک‌سازی کنند، عملیات پوسته را به‌صورت امن انجام دهند، گزارش‌گیری را بهبود بخشند، به ایده‌های مدرن در توسعه وب (HTML، CSS و غیره) بپردازند و زبان‌های اختصاصی دامنه (DSL) سبک‌وزن و سفارشی کسب‌وکار را پیاده‌سازی کنند.

(مشارکت‌شده توسط Jim Baker، Guido van Rossum، Paul Everitt، Koudai Aono، Lysandros Nikolaou، Dave Peck، Adam Turner، Jelle Zijlstra، Bénédikt Tran و Pablo Galindo Salgado در gh-132661.)

PEP 768: رابط امن اشکال‌زدای خارجی¶

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

رابط جدید نقاط اجرای امن را برای اتصال کد اشکال‌زدا فراهم می‌کند، بدون آنکه مسیر اجرای عادی مفسر را تغییر دهد یا هیچ سرباری در ران‌تایم ایجاد کند. به همین دلیل، ابزارها اکنون می‌توانند برنامه‌های پایتون را به‌صورت بلادرنگ بررسی کرده و با آن‌ها تعامل کنند؛ این قابلیتی حیاتی برای سیستم‌های با دسترسی‌پذیری بالا و محیط‌های تولید است.

برای سهولت، این رابط در تابع sys.remote_exec() پیاده‌سازی شده است. برای مثال:

import sys
from tempfile import NamedTemporaryFile

with NamedTemporaryFile(mode='w', suffix='.py', delete=False) as f:
    script_path = f.name
    f.write(f'import my_debugger; my_debugger.connect({os.getpid()})')

# Execute in process with PID 1234
print('Behold! An offering:')
sys.remote_exec(1234, script_path)

این تابع امکان ارسال کد پایتون به یک فرایند هدف را فراهم می‌کند تا در نقطه اجرای ایمن بعدی اجرا شود. با این حال، نویسندگان ابزار همچنین می‌توانند پروتکل را مستقیماً همان‌طور که در PEP توضیح داده شده پیاده‌سازی کنند؛ این PEP سازوکارهای زیرین مورد استفاده برای اتصال ایمن به فرایندهای در حال اجرا را تشریح می‌کند.

رابط اشکال‌زدایی با در نظر گرفتن امنیت، با دقت طراحی شده است و شامل چندین سازوکار برای کنترل دسترسی است:

• متغیر محیطی PYTHON_DISABLE_REMOTE_DEBUG.

• یک گزینه‌ی خط فرمان -X disable-remote-debug.

• یک پرچم configure با نام --without-remote-debug برای غیرفعال‌سازی کامل این قابلیت در زمان ساخت.

(مشارکت‌شده توسط پابلو گالیندو سالگادو، مت وازنیسکی و ایوونا استویانوویچ در gh-131591.)

نوع جدیدی از مفسر¶

نوع جدیدی از مفسر به سی‌پایتون افزوده‌شده است. این مفسر به‌جای یک دستور case بزرگ در C، از فراخوانی‌های دمی بین توابع کوچک C که آپ‌کد‌های منفرد پایتون را پیاده‌سازی می‌کنند، استفاده می‌کند. برای برخی از کامپایلرهای جدیدتر، این مفسر کارایی به‌مراتب بهتری فراهم می‌کند. بنچمارک‌های اولیه نشان می‌دهند که بسته به سکو و معماری، میانگین هندسی افزایش سرعت در بدنه بنچمارک استاندارد pyperformance برابر با ۳ تا ۵ درصد است. خط پایه، Python 3.14 است که با Clang 19 و بدون این مفسر جدید ساخته‌شده است.

این مفسر در حال حاضر فقط با Clang 19 و نسخه‌های جدیدتر روی معماری‌های x86-64 و AArch64 کار می‌کند. با این حال، انتظار می‌رود یک نسخه‌ی آینده از GCC نیز از آن پشتیبانی کند.

این قابلیت فعلاً به‌صورت اختیاری (opt-in) است. هنگام استفاده از مفسر جدید، فعال کردن بهینه‌سازی هدایت‌شده با پروفایل (profile-guided optimization) به‌شدت توصیه می‌شود، زیرا این تنها پیکربندی‌ای است که برای بهبود کارایی آزمایش و اعتبارسنجی شده است. برای اطلاعات بیشتر، --with-tail-call-interp را ببینید.

(با مشارکت Ken Jin در gh-128563، همراه با ایده‌هایی درباره‌ی نحوه‌ی پیاده‌سازی این مورد در سی‌پایتون از سوی Mark Shannon، Garrett Gu، Haoran Xu و Josh Haberman.)

بهبودهای حالت نخ‌آزاد¶

حالت نخ‌آزاد سی‌پایتون (PEP 703) که نخستین‌بار در 3.13 اضافه شد، در پایتون 3.14 به‌طور قابل توجهی بهبود یافته است. پیاده‌سازی توصیف‌شده در PEP 703، از جمله تغییرات در C API، تکمیل شده است و راهکارهای موقت در مفسر با راهکارهای پایدارتر جایگزین شدند. مفسر تطبیقی تخصص‌ساز (PEP 659) اکنون در حالت نخ‌آزاد فعال شده است که در کنار بسیاری از بهینه‌سازی‌های دیگر، کارایی آن را به‌طور چشمگیری بهبود می‌بخشد. افت کارایی کد تک‌نخی در حالت نخ‌آزاد اکنون، بسته به پلتفرم و کامپایلر C استفاده‌شده، حدود ۵ تا ۱۰ درصد است.

از پایتون 3.14 به بعد، هنگام کامپایل کردن ماژول‌های توسعه‌ای برای نسخه‌ی نخ‌آزاد سی‌پایتون در ویندوز، متغیر پیش‌پردازنده‌ی Py_GIL_DISABLED اکنون باید توسط بک‌اند ساخت مشخص شود، زیرا دیگر به‌طور خودکار توسط کامپایلر C تعیین نخواهد شد. برای یک مفسر در حال اجرا، می‌توان تنظیمی را که در زمان کامپایل استفاده شده است، از طریق sysconfig.get_config_var() پیدا کرد.

پرچم جدید -X context_aware_warnings کنترل می‌کند که آیا کنترل هم‌زمان‌ایمن هشدارها فعال است یا خیر. مقدار پیش‌فرض این پرچم برای ساخت‌ نخ‌آزاد true و برای ساخت‌ دارای قفل مفسر سراسری false است.

پرچم جدید thread_inherit_context افزوده شده است که در صورت فعال بودن، به این معناست که نخ‌هایی که با threading.Thread ایجاد می‌شوند، با رونوشتی از Context() فراخوان‌کننده‌ی start() آغاز می‌شوند. مهم‌تر از همه، این امر باعث می‌شود زمینه‌ی فیلتر کردن هشدار که توسط catch_warnings برقرار شده است، توسط نخ‌ها (یا وظیفه‌های asyncio) که در آن زمینه آغاز شده‌اند «به ارث برده شود». این پرچم بر ماژول‌های دیگری که از متغیرهای زمینه استفاده می‌کنند نیز اثر می‌گذارد، مانند مدیر زمینه‌ی decimal. مقدار پیش‌فرض این پرچم در ساخت‌ نخ‌آزاد true و در ساخت‌ دارای قفل مفسر سراسری false است.

(با مشارکت Sam Gross، Matt Page، Neil Schemenauer، Thomas Wouters، Donghee Na، Kirill Podoprigora، Ken Jin، Itamar Oren، Brett Simmers، Dino Viehland، Nathan Goldbaum، Ralf Gommers، Lysandros Nikolaou، Kumar Aditya، Edgar Margffoy و بسیاری دیگر. برخی از این مشارکت‌کنندگان در استخدام متا هستند؛ شرکتی که همچنان منابع مهندسی قابل‌توجهی برای پشتیبانی از این پروژه فراهم کرده است.)

پیام‌های خطای بهبودیافته¶

• مفسر اکنون هنگام تشخیص غلط‌های تایپی در کلیدواژه‌های پایتون، پیشنهادهای مفیدی ارائه می‌دهد. هنگامی که با واژه‌ای مواجه شود که شباهت نزدیکی به یک کلیدواژه‌ی پایتون دارد، مفسر کلیدواژه‌ی درست را در پیام خطا پیشنهاد می‌کند. این قابلیت به برنامه‌نویسان کمک می‌کند تا اشتباهات تایپی رایج را به‌سرعت شناسایی و برطرف کنند. برای مثال:

  >>> whille True:
  ...     pass
  Traceback (most recent call last):
    File "<stdin>", line 1
      whille True:
      ^^^^^^
  SyntaxError: invalid syntax. Did you mean 'while'?
  

  هرچند این ویژگی بر رایج‌ترین موارد تمرکز دارد، ممکن است برخی گونه‌های غلط‌های املایی همچنان به خطاهای سینتکس معمولی منجر شوند. (مشارکت‌شده توسط Pablo Galindo در gh-132449.)

• دستورهای elif که پس از یک بلوک else قرار می‌گیرند، اکنون پیام خطای اختصاصی دارند. (مشارکت‌شده توسط استیل فارنزورث در gh-129902.)

  >>> if who == "me":
  ...     print("It's me!")
  ... else:
  ...     print("It's not me!")
  ... elif who is None:
  ...     print("Who is it?")
  File "<stdin>", line 5
    elif who is None:
    ^^^^
  SyntaxError: 'elif' block follows an 'else' block
  

• اگر دستوری پس از else به عبارات شرطی گذرانده شود، یا یکی از pass، break یا continue پیش از if گذرانده شود، پیام خطا محلی را که expression در آن لازم است برجسته می‌کند. (مشارکت Sergey Miryanov در gh-129515.)

  >>> x = 1 if True else pass
  Traceback (most recent call last):
    File "<string>", line 1
      x = 1 if True else pass
                         ^^^^
  SyntaxError: expected expression after 'else', but statement is given
  
  >>> x = continue if True else break
  Traceback (most recent call last):
    File "<string>", line 1
      x = continue if True else break
          ^^^^^^^^
  SyntaxError: expected expression before 'if', but statement is given
  

• هنگامی که رشته‌های به‌نادرستی بسته‌شده تشخیص داده شوند، پیام خطا پیشنهاد می‌کند که ممکن است رشته به‌عنوان بخشی از رشته در نظر گرفته شده باشد. (مشارکت‌شده توسط Pablo Galindo در gh-88535.)

  >>> "The interesting object "The important object" is very important"
  Traceback (most recent call last):
  SyntaxError: invalid syntax. Is this intended to be part of the string?
  

• هنگامی که رشته‌ها پیشوندهای ناسازگار داشته باشند، خطا اکنون نشان می‌دهد که کدام پیشوندها ناسازگار هستند. (مشارکت نیکیتا سوبولف در gh-133197.)

  >>> ub'abc'
    File "<python-input-0>", line 1
      ub'abc'
      ^^
  SyntaxError: 'u' and 'b' prefixes are incompatible
  

• بهبود پیام‌های خطا هنگام استفاده از as با مقصد‌های ناسازگار در:

  • ایمپورت‌ها: import ... as ...

  • ایمپورت‌های from: from ... import ... as ...

  • هندلرهای except: except ... as ...

  • حالت‌های تطبیق الگو: case ... as ...

  (مشارکت‌شده توسط نیکیتا سوبولف در gh-123539، gh-123562 و gh-123440.)

• پیام خطا هنگام تلاش برای افزودن نمونه‌ای از یک نوع هش‌ناپذیر به dict یا set بهبود یافت. (مشارکت‌شده توسط CF Bolz-Tereick و Victor Stinner در gh-132828.)

  >>> s = set()
  >>> s.add({'pages': 12, 'grade': 'A'})
  Traceback (most recent call last):
    File "<python-input-1>", line 1, in <module>
      s.add({'pages': 12, 'grade': 'A'})
      ~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  TypeError: cannot use 'dict' as a set element (unhashable type: 'dict')
  >>> d = {}
  >>> l = [1, 2, 3]
  >>> d[l] = 12
  Traceback (most recent call last):
    File "<python-input-4>", line 1, in <module>
      d[l] = 12
      ~^^^
  TypeError: cannot use 'list' as a dict key (unhashable type: 'list')
  

• پیام خطا هنگامی که شیء‌ای که از پروتکل مدیر زمینه همگام پشتیبانی می‌کند با async with به جای with وارد می‌شود، و بالعکس برای پروتکل مدیر زمینه ناهمگام، بهبود یافت. (مشارکت Bénédikt Tran در gh-128398.)

PEP 784: پشتیبانی از Zstandard در کتابخانه استاندارد¶

بسته جدید compression شامل ماژول‌های compression.lzma، compression.bz2، compression.gzip و compression.zlib می‌باشد که به‌ترتیب ماژول‌های lzma، bz2، gzip و zlib را بازاکسپورت می‌کنند. نام‌های ایمپورت جدید تحت compression نام‌های ترجیح‌دار برای ایمپورت کردن این ماژول‌های فشرده‌سازی از پایتون ۳.۱۴ هستند. با این حال، نام‌های ماژول‌های موجود منسوخ نشده‌اند. هرگونه منسوخ‌سازی یا حذف ماژول‌های فشرده‌سازی موجود زودتر از پنج سال پس از انتشار ۳.۱۴ رخ نخواهد داد.

ماژول جدید compression.zstd واسط‌های برنامه‌نویسی (API) برای فشرده‌سازی و واگشایی فرمت Zstandard را از طریق باندینگ به کتابخانه zstd متا فراهم می‌کند. Zstandard یک فرمت فشرده‌سازی به‌طور گسترده پذیرفته‌شده، بسیار کارآمد و سریع است. علاوه بر واسط‌های برنامه‌نویسی معرفی‌شده در compression.zstd، پشتیبانی از خواندن و نوشتن آرشیوهای فشرده‌شده Zstandard به ماژول‌های tarfile، zipfile و shutil اضافه شده است.

در اینجا مثالی از استفاده از ماژول جدید برای فشرده‌سازی برخی داده‌ها آمده است:

from compression import zstd
import math

data = str(math.pi).encode() * 20
compressed = zstd.compress(data)
ratio = len(compressed) / len(data)
print(f"Achieved compression ratio of {ratio}")

همان‌طور که می‌بینید، API شبیه به API‌های ماژول‌های lzma و bz2 است.

(مشارکت‌شده توسط Emma Harper Smith، Adam Turner، Gregory P. Smith، Tomas Roun، Victor Stinner و Rogdham در gh-132983.)

قابلیت‌های درون‌نگری asyncio¶

رابط خط فرمان جدیدی برای بررسی فرایندهای در حال اجرای پایتون با استفاده از وظایف ناهمگام اضافه شد که از طریق python -m asyncio ps PID یا python -m asyncio pstree PID در دسترس است.

زیرفرمان ps شناسه‌ی فرایند (PID) داده‌شده را بررسی می‌کند و اطلاعاتی درباره‌ی وظایف asyncio در حال اجرا نمایش می‌دهد. این زیرفرمان یک جدول وظایف را خروجی می‌دهد: فهرستی تخت از همه‌ی وظایف، نام‌های آن‌ها، پشته‌های هم‌روال آن‌ها، و اینکه کدام وظایف در انتظار آن‌ها هستند.

زیرفرمان pstree همان اطلاعات را بازیابی می‌کند، اما به‌جای آن یک درخت بصری از فراخوانی‌های ناهمگام ترسیم می‌کند که روابط میان هم‌روال‌ها را در قالبی سلسله‌مراتبی نشان می‌دهد. این فرمان به‌طور خاص برای اشکال‌زدایی برنامه‌های ناهمگامِ طولانی‌مدت یا گیرکرده مفید است. این فرمان به توسعه‌دهندگان کمک می‌کند تا به‌سرعت تشخیص دهند که برنامه در کجا مسدود شده است، چه وظایفی در انتظار هستند و هم‌روال‌ها چگونه به یکدیگر زنجیر شده‌اند.

برای مثال، با فرض این کد:

import asyncio

async def play_track(track):
    await asyncio.sleep(5)
    print(f'🎵 Finished: {track}')

async def play_album(name, tracks):
    async with asyncio.TaskGroup() as tg:
        for track in tracks:
            tg.create_task(play_track(track), name=track)

async def main():
    async with asyncio.TaskGroup() as tg:
        tg.create_task(
          play_album('Sundowning', ['TNDNBTG', 'Levitate']),
          name='Sundowning')
        tg.create_task(
          play_album('TMBTE', ['DYWTYLM', 'Aqua Regia']),
          name='TMBTE')

if __name__ == '__main__':
    asyncio.run(main())

اجرای ابزار جدید بر روی فرایند در حال اجرا، جدولی مانند این تولید خواهد کرد:

python -m asyncio ps 12345

tid        task id              task name            coroutine stack                                    awaiter chain                                      awaiter name    awaiter id
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
1935500    0x7fc930c18050       Task-1               TaskGroup._aexit -> TaskGroup.__aexit__ -> main                                                                       0x0
1935500    0x7fc930c18230       Sundowning           TaskGroup._aexit -> TaskGroup.__aexit__ -> album   TaskGroup._aexit -> TaskGroup.__aexit__ -> main    Task-1          0x7fc930c18050
1935500    0x7fc93173fa50       TMBTE                TaskGroup._aexit -> TaskGroup.__aexit__ -> album   TaskGroup._aexit -> TaskGroup.__aexit__ -> main    Task-1          0x7fc930c18050
1935500    0x7fc93173fdf0       TNDNBTG              sleep -> play                                      TaskGroup._aexit -> TaskGroup.__aexit__ -> album   Sundowning      0x7fc930c18230
1935500    0x7fc930d32510       Levitate             sleep -> play                                      TaskGroup._aexit -> TaskGroup.__aexit__ -> album   Sundowning      0x7fc930c18230
1935500    0x7fc930d32890       DYWTYLM              sleep -> play                                      TaskGroup._aexit -> TaskGroup.__aexit__ -> album   TMBTE           0x7fc93173fa50
1935500    0x7fc93161ec30       Aqua Regia           sleep -> play                                      TaskGroup._aexit -> TaskGroup.__aexit__ -> album   TMBTE           0x7fc93173fa50

یا درختی مانند این:

python -m asyncio pstree 12345

└── (T) Task-1
    └──  main example.py:13
        └──  TaskGroup.__aexit__ Lib/asyncio/taskgroups.py:72
            └──  TaskGroup._aexit Lib/asyncio/taskgroups.py:121
                ├── (T) Sundowning
                │   └──  album example.py:8
                │       └──  TaskGroup.__aexit__ Lib/asyncio/taskgroups.py:72
                │           └──  TaskGroup._aexit Lib/asyncio/taskgroups.py:121
                │               ├── (T) TNDNBTG
                │               │   └──  play example.py:4
                │               │       └──  sleep Lib/asyncio/tasks.py:702
                │               └── (T) Levitate
                │                   └──  play example.py:4
                │                       └──  sleep Lib/asyncio/tasks.py:702
                └── (T) TMBTE
                    └──  album example.py:8
                        └──  TaskGroup.__aexit__ Lib/asyncio/taskgroups.py:72
                            └──  TaskGroup._aexit Lib/asyncio/taskgroups.py:121
                                ├── (T) DYWTYLM
                                │   └──  play example.py:4
                                │       └──  sleep Lib/asyncio/tasks.py:702
                                └── (T) Aqua Regia
                                    └──  play example.py:4
                                        └──  sleep Lib/asyncio/tasks.py:702

اگر چرخه‌ای در گراف await ناهمگام شناسایی شود (که می‌تواند نشان‌دهنده‌ی یک مشکل برنامه‌نویسی باشد)، ابزار خطا ایجاد می‌کند و مسیرهای چرخه‌ای که از ساخت درخت جلوگیری می‌کنند را فهرست می‌کند:

python -m asyncio pstree 12345

ERROR: await-graph contains cycles - cannot print a tree!

cycle: Task-2 → Task-3 → Task-2

(مشارکت‌شده توسط پابلو گالیندو، ووکاش لانگا، یوری سلیوانوف و مارتا گومز ماسیاس در gh-91048.)

کنترل همزمان‌ایمن هشدارها¶

مدیر زمینه‌ی warnings.catch_warnings اکنون به‌صورت اختیاری از یک متغیر زمینه برای فیلترهای هشدار استفاده می‌کند. این قابلیت با تنظیم پرچم context_aware_warnings، از طریق گزینه‌ی خط فرمان -X یا یک متغیر محیطی فعال می‌شود. این امر کنترل قابل پیش‌بینی هشدارها را هنگام استفاده از catch_warnings در ترکیب با چندین نخ یا وظایف ناهمگام فراهم می‌کند. مقدار پیش‌فرض این پرچم در نسخه‌ی نخ‌آزاد true و در نسخه‌ی دارای قفل مفسر سراسری false است.

(مشارکت‌شده توسط Neil Schemenauer و Kumar Aditya در gh-130010.)

توکارها¶

• متدهای bytes.fromhex() و bytearray.fromhex() اکنون bytes اسکی و اشیاء شبه‌بایت را می‌پذیرند. (مشارکت‌شده توسط Daniel Pope در gh-129349.)

• افزودن متدهای کلاس float.from_number() و complex.from_number() برای تبدیل یک عدد به‌طور متناظر به نوع float یا complex. این متدها در صورتی که آرگومان یک عدد حقیقی نباشد، TypeError ایجاد می‌کنند. (مشارکت‌شده توسط Serhiy Storchaka در gh-84978.)

• پشتیبانی از زیرخط و ویرگول به‌عنوان جداکننده‌های هزارگان در بخش کسری برای انواع نمایش ممیز شناور در قالب‌بندی رشته‌ی سبک جدید (با format() یا اف‌استرینگ‌ها). (مشارکت‌شده توسط سرگئی بی. کیرپیچف در gh-87790.)

• تابع int() دیگر به __trunc__() واگذار نمی‌کند. کلاس‌هایی که می‌خواهند از تبدیل به int() پشتیبانی کنند، باید __int__() یا __index__() را پیاده‌سازی کنند. (مشارکت‌شده توسط Mark Dickinson در gh-119743.)

• تابع map() اکنون مانند zip() یک پرچم اختیاریِ فقط‌کلیدواژه‌ای strict دارد که بررسی می‌کند همه‌ی پیمایش‌پذیرها طول برابر داشته باشند. (ارائه‌شده توسط Wannes Boeykens در gh-119793.)

• نوع memoryview اکنون از زیرنویسی پشتیبانی می‌کند و به یک نوع عام تبدیل می‌شود. (مشارکت‌شده توسط Brian Schubert در gh-126012.)

• استفاده از NotImplemented در یک زمینه بولی اکنون باعث ایجاد TypeError می‌شود. این مورد از پایتون 3.9 یک DeprecationWarning ایجاد می‌کرد. (مشارکت‌شده توسط Jelle Zijlstra در gh-118767.)

• pow() سه‌آرگومنی اکنون در صورت لزوم تلاش می‌کند __rpow__() را فراخوانی کند. پیش‌تر این متد فقط در pow() دوآرگومنی و عملگر دودویی توان فراخوانی می‌شد. (مشارکت‌شده توسط Serhiy Storchaka در gh-130104.)

• اشیای super اکنون کپی‌پذیر و پیکل‌پذیر هستند. (مشارکت Serhiy Storchaka در gh-125767.)

خط فرمان و محیط¶

• پرچم زمان ایمپورت اکنون می‌تواند از طریق -X importtime=2 جدید، ماژول‌هایی را که از قبل بارگذاری شده‌اند ('cached') پیگیری کند. هنگامی که چنین ماژولی ایمپورت می‌شود، زمان‌های self و cumulative با رشته‌ی cached جایگزین می‌شوند.

  مقادیر بالاتر از 2 برای -X importtime اکنون برای استفاده در آینده رزرو شده‌اند.

  (با مشارکت Noah Kim و Adam Turner در gh-118655.)

• گزینه‌ی خط فرمان -c اکنون به‌طور خودکار تورفتگی آرگومان کد خود را پیش از اجرا حذف می‌کند. (مشارکت‌کنندگان: Jon Crall و Steven Sun در gh-103998.)

• پرچم -J دیگر برای Jython رزرو‌شده نیست و اکنون معنای خاصی ندارد. (مشارکت‌شده توسط Adam Turner در gh-133336.)

PEP 758: اجازه دادن به عبارت‌های except و except* بدون پرانتز¶

عبارت‌های except و except* اکنون اجازه می‌دهند که در صورت وجود چندین نوع استثنا و عدم استفاده از بند as، پرانتزها حذف شوند. برای مثال:

try:
    connect_to_server()
except TimeoutError, ConnectionRefusedError:
    print('The network has ceased to be!')

(مشارکت‌شده توسط پابلو گالیندو و برت کانون در PEP 758 و gh-131831.)

PEP 765: جریان کنترل در بلوک‌های finally¶

کامپایلر اکنون هنگامی که دستور return، break یا continue باعث خروج از بلوک finally می‌شود، SyntaxWarning منتشر می‌کند. این تغییر در PEP 765 مشخص شده است.

در موقعیت‌هایی که این تغییر ناخوشایند است (مانند مواردی که هشدارها به‌دلیل لینت‌کردن کد (code linting) زائد هستند)، می‌توان با افزودن ignore::SyntaxWarning به‌عنوان یک فیلتر، از فیلتر هشدار برای غیرفعال کردن تمام هشدارهای سینتکس استفاده کرد. این را می‌توان در ترکیب با فیلتری که هشدارهای دیگر را به خطا تبدیل می‌کند، مشخص کرد (برای مثال، ارسال -Werror -Wignore::SyntaxWarning به‌عنوان گزینه‌های CLI، یا تنظیم PYTHONWARNINGS=error,ignore::SyntaxWarning).

توجه داشته باشید که اعمال چنین فیلتری در زمان اجرا با استفاده از ماژول warnings تنها هشدار را در کدی که پس از تنظیم فیلتر کامپایل می‌شود سرکوب خواهد کرد. کدی که پیش از تنظیم فیلتر کامپایل شده است (برای مثال، زمانی که یک ماژول ایمپورت می‌شود) همچنان هشدار سینتکس را منتشر خواهد کرد.

(مشارکت‌شده توسط ایریت کاتریل در gh-130080.)

زباله‌روبی¶

از پایتون 3.14.5 به بعد:

زباله‌روب (GC) در پایتون 3.14.5 تغییر کرده است.

پایتون 3.14.0-3.14.4 به همراه یک زباله‌روب افزایشی (incremental GC) جدید عرضه شد. با این حال، به دلیل تعدادی گزارش از فشار قابل توجه بر حافظه در محیط‌های عملیاتی، به زباله‌روب نسلی (generational GC) نسخه‌ی 3.13 بازگردانده شد. این همان زباله‌روب است که اکنون در پایتون 3.14.5 و نسخه‌های بعدی استفاده می‌شود.

پیش‌تر در پایتون 3.14.0-3.14.4:

زباله‌روب چرخه‌ای اکنون افزایشی است. این بدان معناست که بیشینه زمان‌های مکث برای هیپ‌های بزرگ‌تر به میزان یک مرتبه بزرگی یا بیشتر کاهش می‌یابد.

اکنون فقط دو نسل وجود دارد: جوان و پیر. وقتی gc.collect() مستقیماً فراخوانی نشود، زباله‌روب کمی کمتر فراخوانی می‌شود. هنگام فراخوانی، به‌جای جمع‌آوری یک یا چند نسل، نسل جوان و بخشی از نسل پیر را جمع‌آوری می‌کند.

رفتار gc.collect() کمی تغییر می‌کند:

• gc.collect(1): یک مرحله از زباله‌روبی را انجام می‌دهد، نه اینکه نسل ۱ را جمع‌آوری کند.

• سایر فراخوانی‌های gc.collect() بدون تغییر باقی می‌مانند.

(مشارکت Mark Shannon در gh-108362.)

پوسته تعاملی پیش‌فرض¶

• پوسته‌ی interactive پیش‌فرض اکنون سینتکس پایتون را برجسته‌سازی می‌کند. این قابلیت به‌طور پیش‌فرض فعال است، مگر اینکه PYTHON_BASIC_REPL یا هر متغیر محیطی دیگری که رنگ را غیرفعال می‌کند تنظیم شده باشد. برای جزئیات به کنترل رنگ مراجعه کنید.

  تم رنگی پیش‌فرض برجسته‌سازی سینتکس می‌کوشد کنتراست خوبی داشته باشد و برای حداکثر سازگاری، تنها از کدهای رنگ ANSI استاندارد VGA چهاربیتی استفاده می‌کند. این تم را می‌توان با استفاده از یک API آزمایشی _colorize.set_theme() سفارشی‌سازی کرد. این تابع را می‌توان به‌صورت تعاملی یا در اسکریپت PYTHONSTARTUP فراخوانی کرد. توجه داشته باشید که این تابع هیچ تضمینی برای پایداری ندارد و ممکن است تغییر کند یا حذف شود.

  (مشارکت Łukasz Langa در gh-131507.)

• پوسته‌ی interactive پیش‌فرض اکنون از تکمیل خودکار ایمپورت پشتیبانی می‌کند. این بدان معناست که با تایپ کردن import co و فشار دادن کلید <Tab>، ماژول‌هایی که با co شروع می‌شوند پیشنهاد می‌شوند. به‌طور مشابه، با تایپ کردن from concurrent import i، زیرماژول‌های concurrent که با i شروع می‌شوند پیشنهاد می‌شوند. توجه داشته باشید که تکمیل خودکار ویژگی‌های ماژول در حال حاضر پشتیبانی نمی‌شود. (مشارکت Tomas Roun در gh-69605.)

argparse¶

• مقدار پیش‌فرض نام برنامه برای argparse.ArgumentParser اکنون نحوه‌ی دستور داده‌شده به مفسر پایتون برای یافتن کد ماژول __main__ را بازتاب می‌دهد. (مشارکت‌شده توسط Serhiy Storchaka و Alyssa Coghlan در gh-66436.)

• پارامتر اختیاری suggest_on_error در argparse.ArgumentParser معرفی شد که در صورت اشتباه تایپی از سوی کاربر، پیشنهادهایی برای گزینه‌های آرگومان و نام‌های زیرپارسر ارائه می‌دهد. (مشارکت‌شده توسط Savannah Ostrowski در gh-124456.)

• فعال‌سازی رنگ برای متن راهنما، که می‌توان آن را با پارامتر اختیاری color در argparse.ArgumentParser غیرفعال کرد. این قابلیت را می‌توان از طریق متغیرهای محیطی نیز کنترل کرد. (مشارکت‌شده توسط هوگو ون کمِناده در gh-130645.)

ast¶

• افزودن compare()، تابعی برای مقایسه‌ی دو AST. (با مشارکت Batuhan Taskaya و Jeremy Hylton در gh-60191.)

• افزودن پشتیبانی از copy.replace() برای گره‌های AST. (مشارکت Bénédikt Tran در gh-121141.)

• رشته‌های مستند اکنون در سطح بهینه‌سازی ۲ از یک AST بهینه‌شده حذف می‌شوند. (مشارکت‌شده توسط Irit Katriel در gh-123958.)

• خروجی repr() برای گره‌های AST اکنون شامل اطلاعات بیشتری است. (مشارکت: Tomas Roun در gh-116022.)

• هنگامی که با یک درخت سینتکس انتزاعی (AST) به‌عنوان ورودی فراخوانی شود، تابع parse() اکنون همیشه بررسی می‌کند که نوع گره ریشه مناسب باشد. (ارائه‌شده توسط Irit Katriel در gh-130139.)

• افزودن گزینه‌های جدید به رابط خط فرمان: --feature-version، --optimize و --show-empty. (مشارکت‌شده توسط Semyon Moroz در gh-133367.)

asyncio¶

• تابع و متد‌هایی که create_task() نام دارند، اکنون فهرست دلخواهی از آرگومان‌های کلیدواژه‌ای را می‌پذیرند. تمام آرگومان‌های کلیدواژه‌ای به سازنده‌ی Task یا کارخانه وظیفه سفارشی منتقل می‌شوند. (برای جزئیات به set_task_factory() مراجعه کنید.) آرگومان‌های کلیدواژه‌ای name و context دیگر ویژه نیستند؛ نام باید اکنون با استفاده از آرگومان کلیدواژه‌ای name کارخانه تنظیم شود و context می‌تواند None باشد.

  این بر تابع و متدهای زیر تأثیر می‌گذارد: asyncio.create_task()، asyncio.loop.create_task()، asyncio.TaskGroup.create_task().

  (با مشارکت Thomas Grainger در gh-128307.)

• دو تابع کاربردی جدید برای درون‌نگری و چاپ گراف فراخوانی یک برنامه وجود دارد: capture_call_graph() و print_call_graph(). برای جزئیات بیشتر به قابلیت‌های درون‌نگری Asyncio مراجعه کنید. (مشارکت‌شده توسط Yury Selivanov، Pablo Galindo Salgado و Łukasz Langa در gh-91048.)

calendar¶

• به‌طور پیش‌فرض، تاریخ امروز در خروجی متنی خط فرمان ماژول calendar با رنگ برجسته می‌شود. این را می‌توان با متغیرهای محیطی کنترل کرد. (مشارکت‌شده توسط هوگو ون کمِناده در gh-128317.)

concurrent.futures¶

• کلاس اجراکننده‌ی جدیدی، InterpreterPoolExecutor، اضافه شده است که چندین مفسر پایتون را در یک فرایند واحد («زیرمفسرها» — subinterpreters) برای کد پایتون در دسترس قرار می‌دهد. این کلاس از یک استخر مفسرهای مستقل پایتون برای اجرای فراخوانی‌ها به‌صورت ناهمگام استفاده می‌کند.

  این مورد جدا از ماژول جدید interpreters است که توسط PEP 734 معرفی‌شده است. (مشارکت‌شده توسط Eric Snow در gh-124548.)

• در پلتفرم‌های یونیکس به‌جز macOS، 'forkserver' اکنون متد شروع پیش‌فرض برای ProcessPoolExecutor است (جایگزین 'fork' شده است). این تغییر بر Windows یا macOS تأثیری نمی‌گذارد و در آن‌ها 'spawn' همچنان متد شروع پیش‌فرض است.

  اگر روش fork که با نخ‌بندی ناسازگار است مورد نیاز باشد، باید آن را به‌طور صریح با فراهم‌کردن یک زمینه‌ی multiprocessing به نام mp_context برای ProcessPoolExecutor درخواست کنید.

  برای اطلاعات و تفاوت‌های آن با روش فورک و همچنین برای آگاهی از اینکه این تغییر چگونه ممکن است بر کدهای موجود با متغیرهای سراسری اشتراکی تغییرپذیر و/یا اشیاء اشتراکی‌ای که نمی‌توان به‌طور خودکار آن‌ها را پیکل کرد تأثیر بگذارد، به محدودیت‌های forkserver مراجعه کنید.

  (مشارکت‌شده توسط Gregory P. Smith در gh-84559.)

• دو متد جدید به ProcessPoolExecutor اضافه شد: terminate_workers() و kill_workers()، به‌عنوان راه‌هایی برای خاتمه دادن یا کشتن همه‌ی فرایندهای کارگر زنده در استخر داده‌شده. (مشارکت‌شده توسط Charles Machalow در gh-130849.)

• افزودن پارامتر اختیاری buffersize به Executor.map برای محدود کردن تعداد وظایف ارسال‌شده‌ای که نتایجشان هنوز تولید نشده است. اگر بافر پر باشد، پیمایش روی iterables مکث می‌کند تا زمانی که نتیجه‌ای از بافر تولید شود. (مشارکت‌شده توسط انزو بونال و جاش روزنبرگ در gh-74028.)

configparser¶

• برای بهبود امنیت، configparser دیگر پرونده‌های پیکربندی‌ای را که نمی‌تواند بخواند، نمی‌نویسد. تلاش برای write() کردن کلیدهایی که شامل جداکننده‌ها هستند یا با الگوی سرآیند بخش آغاز می‌شوند، باعث ایجاد استثنای InvalidWriteError می‌شود. (مشارکت‌شده توسط Jacob Lincoln در gh-129270.)

contextvars¶

• پشتیبانی از پروتکل مدیر زمینه برای اشیای Token. (با مشارکت Andrew Svetlov در gh-129889.)

ctypes¶

• چیدمان فیلدهای بیتی در اشیاء Structure و Union اکنون تطابق نزدیک‌تری با پیش‌فرض‌های پلتفرم (GCC/Clang یا MSVC) دارد. به‌ویژه، فیلدها دیگر هم‌پوشانی ندارند. (با مشارکت Matthias Görgens در gh-97702.)

• اکنون می‌توان ویژگی کلاس Structure._layout_ را برای کمک به تطبیق با رابط دودویی برنامه (ABI) غیرپیش‌فرض تنظیم کرد. (مشارکت‌شده توسط Petr Viktorin در gh-97702.)

• کلاس توصیف‌گرهای فیلد Structure/Union اکنون به‌صورت CField در دسترس است و ویژگی‌های جدیدی برای کمک به اشکال‌زدایی و درون‌نگری درونی دارد. (مشارکت‌شده توسط Petr Viktorin در gh-128715.)

• در ویندوز، استثنای COMError اکنون عمومی است. (مشارکت‌شده توسط Jun Komoda در gh-126686.)

• در ویندوز، تابع CopyComPointer() اکنون عمومی است. (مشارکت‌شده توسط Jun Komoda در gh-127275.)

• افزودن memoryview_at()، تابعی برای ایجاد شیء memoryview که به اشاره‌گر و طول ارائه‌شده ارجاع می‌دهد. این تابع مانند ctypes.string_at() کار می‌کند، با این تفاوت که از رونوشت بافر اجتناب می‌کند و به‌طور معمول هنگام پیاده‌سازی توابع کال‌بک پایتون خالصی که بافرهای با اندازه‌ی پویا به آن‌ها ارسال می‌شود، مفید است. (مشارکت‌شده توسط Rian Hunter در gh-112018.)

• در صورتی که هم کامپایلر و هم کتابخانه‌ی libffi از نوع‌های مختلط C پشتیبانی کنند، نوع‌های مختلط c_float_complex، c_double_complex و c_longdouble_complex اکنون در دسترس هستند. (با مشارکتِ Sergey B Kirpichev در gh-61103.)

• افزودن ctypes.util.dllist() برای فهرست کردن کتابخانه‌های اشتراکی بارگذاری‌شده توسط فرایند جاری. (مشارکت‌شده توسط Brian Ward در gh-119349.)

• نهانگاه نوع‌های ctypes.POINTER() از یک نهانگاه داخلی سراسری (_pointer_type_cache) به ویژگی _CData.__pointer_type__ نوع‌های متناظر ctypes منتقل شد. این کار در برخی موقعیت‌ها مانع از رشد بی‌کران نهانگاه می‌شود. (مشارکت‌شده توسط سرگئی میریانوف در gh-100926.)

• نوع py_object اکنون از زیرنویسی پشتیبانی می‌کند و در نتیجه به یک نوع عام تبدیل می‌شود. (با مشارکت Brian Schubert در gh-132168.)

• ctypes اکنون از ساخت‌های نخ‌بندی آزاد پشتیبانی می‌کند. (مشارکت‌شده توسط Kumar Aditya و Peter Bierma در gh-127945.)

curses¶

• تابع assume_default_colors() اضافه شد؛ پالایشی از تابع use_default_colors() که امکان تغییر جفت رنگ 0 را فراهم می‌کند. (مشارکت Serhiy Storchaka در gh-133139.)

datetime¶

• افزودن متد strptime() به کلاس‌های datetime.date و datetime.time. (مشارکت‌شده توسط Wannes Boeykens در gh-41431.)

decimal¶

• افزودن Decimal.from_number() به‌عنوان سازنده‌ای جایگزین برای Decimal. (با مشارکت سرهی استورچاکا در gh-121798.)

• افشای IEEEContext() برای پشتیبانی از ایجاد زمینه‌های متناظر با قالب‌های تبادلی اعشاری IEEE 754 (2008). (مشارکت‌شده توسط Sergey B Kirpichev در gh-53032.)

difflib¶

• صفحات مقایسه با تغییرات برجسته‌شده که توسط کلاس HtmlDiff تولید می‌شوند، اکنون از «حالت تاریک» پشتیبانی می‌کنند. (مشارکت‌شده توسط Jiahao Li در gh-129939.)

dis¶

• پشتیبانی از نمایش اطلاعات کامل مکان دستورالعمل‌ها در کد منبع، به‌جای فقط شماره سطر، اضافه شد. این قابلیت از طریق آرگومان کلیدواژه‌ای show_positions به رابط‌های زیر اضافه شده است:

  • dis.Bytecode

  • dis.dis()

  • dis.distb()

  • dis.disassemble()

  این قابلیت همچنین از طریق dis --show-positions در دسترس است. (مشارکت‌شده توسط Bénédikt Tran در gh-123165.)

• افزودن گزینه‌ی خط فرمان dis --specialized برای نمایش بایت‌کد تخصصی‌شده. (مشارکت‌شده توسط Bénédikt Tran در gh-127413.)

errno¶

• افزودن ثابت کد خطای EHWPOISON. (مشارکت James Roy در gh-126585.)

faulthandler¶

• پشتیبانی از چاپ ردگیری پشته‌ی C روی سیستم‌هایی که از آن پشتیبانی می‌کنند، از طریق تابع جدید dump_c_stack() یا از طریق آرگومان c_stack در faulthandler.enable() اضافه شد. (با مشارکت Peter Bierma در gh-127604.)

fnmatch¶

• افزودن filterfalse()، تابعی برای رد کردن نام‌هایی که با الگوی داده‌شده مطابقت دارند. (مشارکت‌شده توسط Bénédikt Tran در gh-74598.)

fractions¶

• اکنون می‌توان یک شیء Fraction را از هر شیء دارای متد as_integer_ratio() ساخت. (مشارکت‌شده توسط Serhiy Storchaka در gh-82017.)

• افزودن Fraction.from_number() به‌عنوان سازنده‌ای جایگزین برای Fraction. (ارائه‌شده توسط Serhiy Storchaka در gh-121797.)

functools¶

• افزودن نشانگر Placeholder. از این نشانگر می‌توان همراه با توابع partial() یا partialmethod() استفاده کرد تا مکانی برای آرگومان‌های جایگاهی در شیء پارشیال (partial) بازگردانده‌شده رزرو شود. (مشارکت‌شده توسط Dominykas Grigonis در gh-119127.)

• پارامتر initial تابع reduce() اکنون می‌تواند به‌صورت آرگومان کلیدواژه‌ای ارسال شود. (مشارکت Sayandip Dutta در gh-125916.)

getopt¶

• افزودن پشتیبانی از گزینه‌هایی با آرگومان‌های اختیاری. (مشارکت‌شده توسط Serhiy Storchaka در gh-126374.)

• افزودن پشتیبانی از بازگرداندن گزینه‌ها و آرگومان‌های غیر از گزینه‌ها به‌صورت درهم‌آمیخته و به ترتیب. (با مشارکت Serhiy Storchaka در gh-126390.)

getpass¶

• پشتیبانی از بازخورد صفحه‌کلید در تابع getpass() از طریق آرگومان اختیاریِ فقط‌کلیدواژه‌ای echo_char. نویسه‌های جای‌نگهدار هر زمان که نویسه‌ای وارد شود، نمایش داده می‌شوند و با حذف یک نویسه برداشته می‌شوند. (مشارکت‌شده توسط سمیون موروز در gh-77065.)

graphlib¶

• اجازه می‌دهد TopologicalSorter.prepare() بیش از یک بار فراخوانی شود، تا زمانی که مرتب‌سازی آغاز نشده باشد. (مشارکت از Daniel Pope در gh-130914.)

heapq¶

• ماژول heapq از طریق توابع جدید زیر، پشتیبانی بهبودیافته‌ای برای کار با هیپ‌های بیشینه ارائه می‌دهد:

  • heapify_max()

  • heappush_max()

  • heappop_max()

  • heapreplace_max()

  • heappushpop_max()

hmac¶

• پیاده‌سازی توکاری برای HMAC (RFC 2104) با استفاده از کد تأییدشده به‌صورت صوری از پروژه‌ی HACL* اضافه شد. این پیاده‌سازی زمانی به‌عنوان جایگزین استفاده می‌شود که پیاده‌سازی HMAC در OpenSSL دسترس‌پذیر نباشد. (مشارکت‌شده توسط Bénédikt Tran در gh-99108.)

http¶

• فهرست‌های پوشه و صفحات خطای تولیدشده توسط ماژول http.server به مرورگر اجازه می‌دهند حالت تاریک پیش‌فرض خود را اعمال کند. (مشارکت‌شده توسط Yorik Hansen در gh-123430.)

• ماژول http.server اکنون از سرویس‌دهی از طریق HTTPS با استفاده از کلاس http.server.HTTPSServer پشتیبانی می‌کند. رابط خط فرمان (python -m http.server) این قابلیت را از طریق گزینه‌های زیر در دسترس قرار می‌دهد:

  • --tls-cert <path>: مسیر پرونده گواهی TLS.

  • --tls-key <path>: مسیر اختیاری به پرونده‌ی کلید خصوصی.

  • --tls-password-file <path>: مسیر اختیاری به پرونده گذرواژه برای کلید خصوصی.

  (مشارکت‌شده توسط Semyon Moroz در gh-85162.)

imaplib¶

• افزودن IMAP4.idle()، که فرمان IDLE در IMAP4 را همان‌طور که در RFC 2177 تعریف شده است پیاده‌سازی می‌کند. (مشارکت Forest در gh-55454.)

inspect¶

• signature() یک آرگومان جدید با نام annotation_format می‌گیرد تا annotationlib.Format مورد استفاده برای بازنمایی حاشیه‌نویسی‌ها را کنترل کند. (مشارکت‌شده توسط Jelle Zijlstra در gh-101552.)

• Signature.format() آرگومان جدید unquote_annotations را می‌پذیرد. اگر درست باشد، حاشیه‌نویسی‌های رشته‌ای بدون علامت‌های نقل‌قول اطراف نمایش داده می‌شوند. (مشارکت‌شده توسط Jelle Zijlstra در gh-101552.)

• تابع ispackage() برای تعیین اینکه آیا یک شیء package است یا خیر، افزوده شد. (مشارکت‌شده توسط Zhikang Yan در gh-125634.)

io¶

• خواندن متن از یک جریان غیرمسدودکننده با read ممکن است اکنون در صورتی که عملیات نتواند بلافاصله بایت‌ها را بازگرداند، BlockingIOError ایجاد کند. (مشارکت‌شده توسط Giovanni Siragusa در gh-109523.)

• پروتکل‌های Reader و Writer به‌عنوان جایگزین‌های ساده‌تری برای شبه‌پروتکل‌های typing.IO، typing.TextIO و typing.BinaryIO افزوده شدند. (مشارکت‌شده توسط سباستین ریتائو در gh-127648.)

json¶

• افزودن یادداشت‌های استثنا برای خطاهای سریال‌سازی JSON که امکان شناسایی منشأ خطا را فراهم می‌کنند. (مشارکت‌شده توسط Serhiy Storchaka در gh-122163.)

• امکان استفاده از ماژول json به‌عنوان اسکریپت از طریق سوییچ -m فراهم شد: python -m json. این روش اکنون بر python -m json.tool ترجیح دارد، که منسوخ نرم است. مستندات رابط خط فرمان JSON را ببینید. (مشارکت از سوی Trey Hunner در gh-122873.)

• به‌طور پیش‌فرض، خروجی رابط خط فرمان JSON به‌صورت رنگی برجسته‌سازی می‌شود. این امر را می‌توان با متغیرهای محیطی کنترل کرد. (مشارکت‌شده توسط Tomas Roun در gh-131952.)

linecache¶

• getline() اکنون می‌تواند کد منبع ماژول‌های فریزشده را بازیابی کند. (مشارکت‌شده توسط Tian Gao در gh-131638.)

logging.handlers¶

• اشیاء QueueListener اکنون از پروتکل مدیر زمینه پشتیبانی می‌کنند. (مشارکت‌شده توسط Charles Machalow در gh-132106.)

• QueueListener.start اکنون اگر شنونده از پیش راه‌اندازی شده باشد، یک RuntimeError ایجاد می‌کند. (نوشته‌ی Charles Machalow در gh-132106.)

math¶

• پیام‌های خطای مفصل‌تری برای خطاهای دامنه در ماژول اضافه شد. (با مشارکت Charlie Zhao و Sergey B Kirpichev در gh-101410.)

mimetypes¶

• افزودن یک خط فرمان عمومی برای ماژول، که از طریق python -m mimetypes فراخوانی می‌شود. (مشارکت‌شده توسط Oleg Iarygin و Hugo van Kemenade در gh-93096.)

• افزودن چندین نوع MIME جدید بر اساس RFC‌ها و کاربرد رایج:

  انواع MIME برای فونت‌ها از مایکروسافت و RFC 8081

  • اوپن‌تایپ تعبیه‌شده (Embedded OpenType): application/vnd.ms-fontobject

  • OpenType Layout (OTF) font/otf

  • TrueType: font/ttf

  • WOFF 1.0 font/woff

  • WOFF 2.0 font/woff2

  RFC 9559 انواع MIME برای ساختارهای ظرف داده‌های دیداری‌شنیداری Matroska

  • صدا بدون ویدیو: audio/matroska (.mka)

  • ویدیو: video/matroska (.mkv)

  • ویدئوی استریوسکوپی: video/matroska-3d (.mk3d)

  تصاویر دارای RFCها

  • RFC 1494: CCITT Group 3 (.g3)

  • RFC 3362: فکس بلادرنگ، T.38 (.t38)

  • RFC 3745: JPEG 2000 (.jp2)، توسعه‌یافته (.jpx) و ترکیبی (.jpm)

  • RFC 3950: Tag Image File Format Fax eXtended, TIFF-FX (.tfx)

  • RFC 4047: سامانه انتقال تصویر انعطاف‌پذیر (Flexible Image Transport System) (.fits)

  • RFC 7903: فراپرونده‌ی پیشرفته (Enhanced Metafile) (.emf) و فراپرونده‌ی ویندوز (Windows Metafile) (.wmf)

  سایر افزوده‌ها و تغییرات نوع MIME

  • RFC 2361: تغییر نوع برای .avi به video/vnd.avi و برای .wav به audio/vnd.wave

  • RFC 4337: افزودن MPEG-4 audio/mp4 (.m4a)

  • RFC 5334: افزودن رسانه‌ی Ogg (.oga، .ogg و .ogx)

  • RFC 6713: افزودن gzip application/gzip (.gz)

  • RFC 9639: افزودن FLAC audio/flac (.flac)

  • RFC 9512 نوع MIME application/yaml برای پرونده‌های YAML (.yaml و .yml)

  • افزودن 7z application/x-7z-compressed (.7z)

  • افزودن بسته اندروید application/vnd.android.package-archive (.apk) زمانی که strict نباشد

  • افزودن deb application/x-debian-package (.deb)

  • افزودن glTF دودویی model/gltf-binary (.glb)

  • افزودن glTF JSON/ASCII model/gltf+json (.gltf)

  • افزودن M4V video/x-m4v (.m4v)

  • افزودن PHP application/x-httpd-php (.php)

  • افزودن RAR application/vnd.rar (.rar)

  • افزودن RPM application/x-rpm (.rpm)

  • افزودن STL model/stl (.stl)

  • افزودن Windows Media Video با نوع video/x-ms-wmv (.wmv)

  • دفاکتو (De facto): افزودن WebM audio/webm (.weba)

  • ECMA-376: افزودن نوع‌های .docx، .pptx و .xlsx

  • OASIS: افزودن نوع‌های OpenDocument .odg، .odp، .ods و .odt

  • W3C: افزودن EPUB application/epub+zip (.epub)

  (با مشارکت Sahil Prajapati و Hugo van Kemenade در gh-84852، Sasha "Nelie" Chernykh و Hugo van Kemenade در gh-132056، و Hugo van Kemenade در gh-89416، gh-85957 و gh-129965.)

multiprocessing¶

• در پلتفرم‌های یونیکس به‌جز macOS، 'forkserver' اکنون روش شروع پیش‌فرض است (جایگزین 'fork'). این تغییر بر ویندوز یا macOS تأثیری نمی‌گذارد؛ در آن‌ها 'spawn' همچنان روش شروع پیش‌فرض است.

  اگر روش fork ناسازگار با نخ‌بندی مورد نیاز است، باید آن را به‌طور صریح از طریق زمینه‌ای از get_context() (ترجیحی) درخواست کنید یا پیش‌فرض را از طریق set_start_method() تغییر دهید.

  برای اطلاعات و تفاوت‌های آن با روش فورک و همچنین برای آگاهی از اینکه این تغییر چگونه ممکن است بر کدهای موجود با متغیرهای سراسری اشتراکی تغییرپذیر و/یا اشیاء اشتراکی‌ای که نمی‌توان به‌طور خودکار آن‌ها را پیکل کرد تأثیر بگذارد، به محدودیت‌های forkserver مراجعه کنید.

  (مشارکت‌شده توسط Gregory P. Smith در gh-84559.)

• روش شروع 'forkserver' در multiprocessing اکنون سوکت کنترل خود را احراز هویت می‌کند تا برای محدود کردن اینکه کدام فرایندهای دیگر می‌توانند باعث شوند سرور انشعاب (forkserver) کارگرها را ایجاد کند و کد اجرا کند، صرفاً به مجوزهای سامانه فایل‌بندی متکی نباشد. (مشارکت‌شده توسط Gregory P. Smith برای gh-97514.)

• اشیاء پراکسی multiprocessing برای انواع list و dict، متدهای مفقودی را که پیش‌تر نادیده گرفته‌شده بودند به دست می‌آورند:

  • clear() و copy() برای پراکسی‌های list

  • fromkeys()، reversed(d)، d | {}، {} | d، d |= {'b': 2} برای پراکسی‌های dict

  (مشارکتی از Roy Hyunjin Han برای gh-103134.)

• پشتیبانی از اشیای set مشترک از طریق SyncManager.set() اضافه شد. متد set() در Manager() اکنون در دسترس است. (مشارکت‌شده توسط Mingyu Park در gh-129949.)

• افزودن متد interrupt() به اشیاء multiprocessing.Process، که فرایند فرزند را با ارسال SIGINT خاتمه می‌دهد. این کار به بندهای finally امکان می‌دهد تا ردگیری پشته‌ای برای فرایند خاتمه‌یافته چاپ کنند. (مشارکت‌شده توسط آرتم پولکین در gh-131913.)

operator¶

• افزودن is_none() و is_not_none() به‌عنوان یک جفت تابع، به‌گونه‌ای که operator.is_none(obj) معادل obj is None و operator.is_not_none(obj) معادل obj is not None باشد. (مشارکت Raymond Hettinger و Nico Mexis در gh-115808.)

os¶

• تابع reload_environ() اضافه شد تا os.environ و os.environb را با تغییرات اعمال‌شده در محیط توسط os.putenv() یا os.unsetenv()، یا با تغییراتی که خارج از پایتون در همان فرایند ایجاد شده‌اند، به‌روزرسانی کند. (مشارکت‌شده توسط Victor Stinner در gh-120057.)

• ثابت‌های SCHED_DEADLINE و SCHED_NORMAL به ماژول os افزوده شدند. (با مشارکت James Roy در gh-127688.)

• تابع readinto() برای خواندن درون یک شیء بافر از یک توصیف‌گر پرونده افزوده شد. (مشارکت کودی مالونی در gh-129205.)

os.path¶

• پارامتر strict در realpath() مقدار جدیدی به نام ALLOW_MISSING را می‌پذیرد. در صورت استفاده، خطاهایی غیر از FileNotFoundError دوباره ایجاد خواهند شد؛ مسیر حاصل می‌تواند وجود نداشته باشد، اما فاقد پیوندهای نمادین خواهد بود. (مشارکت‌شده توسط Petr Viktorin برای CVE 2025-4517.)

pathlib¶

• افزودن متدهایی به pathlib.Path برای کپی یا انتقال بازگشتی پرونده‌ها و پوشه‌ها:

  • copy() یک پرونده یا درخت پوشه را به مقصد کپی می‌کند.

  • copy_into() به داخلِ یک پوشه‌ی مقصد کپی می‌کند.

  • move() یک پرونده یا درخت پوشه را به مقصد منتقل می‌کند.

  • متد move_into() به درون پوشه‌ی مقصد منتقل می‌کند.

  (مشارکت Barney Gale در gh-73991.)

• ویژگی info افزوده شد که شیء‌ای را ذخیره می‌کند که پروتکل جدید pathlib.types.PathInfo را پیاده‌سازی می‌کند. این شیء از پرس‌وجوی نوع پرونده و نهانگاه‌سازی داخلی نتایج stat() پشتیبانی می‌کند. اشیاء Path تولیدشده توسط iterdir() با اطلاعات نوع پرونده‌ی حاصل از پویش پوشه والد، مقداردهی اولیه می‌شوند. (مشارکت‌شده توسط Barney Gale در gh-125413.)

pdb¶

• ماژول pdb اکنون از اتصال از راه دور به یک فرایند پایتون در حال اجرا با استفاده از گزینه‌ی جدید خط فرمان -p PID پشتیبانی می‌کند:

  python -m pdb -p 1234
  

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

  این قابلیت از PEP 768 و تابع جدید sys.remote_exec() برای اتصال به فرایند از راه دور و ارسال دستورهای PDB به آن استفاده می‌کند.

  (مشارکت‌شده توسط Matt Wozniski و Pablo Galindo در gh-131591.)

• نقاط توقف ثابت (hardcoded) (breakpoint() و set_trace()) اکنون به‌جای اینکه هر بار نمونه‌ی جدیدی ایجاد کنند، از آخرین نمونه‌ی Pdb که set_trace() را فراخوانی می‌کند، دوباره استفاده می‌کنند. در نتیجه، تمام داده‌های مخصوص نمونه مانند display و commands بین نقاط توقف ثابت حفظ می‌شوند. (مشارکت‌شده توسط Tian Gao در gh-121450.)

• آرگومان جدید mode به pdb.Pdb اضافه شد. دستور restart هنگامی که pdb در حالت inline باشد، غیرفعال می‌شود. (مشارکت‌شده توسط Tian Gao در gh-123757.)

• وقتی کاربر بخواهد از pdb در حالت inline خارج شود، یک اعلان تأیید نمایش داده می‌شود. y، Y، <Enter> یا EOF خروج را تأیید کرده و به جای برخاستن استثنای bdb.BdbQuit، sys.exit() را فراخوانی می‌کنند. (مشارکت‌شده توسط Tian Gao در gh-124704.)

• نقطه‌های توقف درون‌خطی مانند breakpoint() یا pdb.set_trace() همیشه برنامه را در فریم فراخوانی متوقف می‌کنند و الگوی skip (در صورت وجود) را نادیده می‌گیرند. (با مشارکت Tian Gao در gh-130493.)

• <tab> در ابتدای سطر در ورودی چندسطری pdb اکنون به‌جای درج نویسه‌ی \t، یک تورفتگی ۴ فاصله‌ای ایجاد می‌کند. (مشارکت‌شده توسط Tian Gao در gh-130471.)

• قابلیت تورفتگی خودکار در ورودی چندسطری pdb معرفی شد. این قابلیت یا تورفتگی سطر آخر را حفظ می‌کند، یا هنگامی که بلوک کد جدیدی را تشخیص می‌دهد، تورفتگی ۴ فاصله‌ای درج می‌کند. (با مشارکت Tian Gao در gh-133350.)

• $_asynctask برای دسترسی به وظیفه‌ی جاری asyncio (در صورت وجود) افزوده شد. (مشارکت Tian Gao در gh-124367.)

• pdb.set_trace_async() برای پشتیبانی از اشکال‌زدایی هم‌روال‌های asyncio اضافه شده است. از دستورهای await با این تابع پشتیبانی می‌شود. (مشارکت‌شده توسط Tian Gao در gh-132576.)

• کد منبع نمایش‌داده‌شده در pdb با برجسته‌سازی سینتکس نمایش داده خواهد شد. این قابلیت را می‌توان با همان روش‌های مورد استفاده در پوسته‌ی interactive پیش‌فرض و همچنین با آرگومان colorize که به‌تازگی به pdb.Pdb افزوده شده است، کنترل کرد. (مشارکت Tian Gao و Łukasz Langa در gh-133355.)

pickle¶

• نسخه‌ی پیش‌فرض پروتکل در ماژول pickle را روی ۵ تنظیم می‌کند. برای جزئیات بیشتر، به پروتکل‌های پیکل مراجعه کنید.

• افزودن یادداشت‌های استثنا به خطاهای سریال‌سازی پیکل که امکان شناسایی منبع خطا را فراهم می‌کنند. (مشارکت‌شده توسط Serhiy Storchaka در gh-122213.)

platform¶

• افزودن invalidate_caches()، تابعی برای باطل کردن نتایج نهانگاهی‌شده در ماژول platform. (مشارکت‌شده توسط Bénédikt Tran در gh-122549.)

pydoc¶

• حاشیه‌نویسی‌ها در خروجی راهنما اکنون معمولاً در قالبی نزدیک‌تر به قالب کد منبع اصلی نمایش داده می‌شوند. (مشارکت‌شده توسط Jelle Zijlstra در gh-101552.)

re¶

• پشتیبانی از \z به‌عنوان مترادف \Z در عبارت‌های باقاعده. این الگو در بسیاری از موتورهای عبارت باقاعده‌ی دیگر بدون ابهام تفسیر می‌شود، برخلاف \Z که رفتار آن تفاوت‌های ظریفی دارد. (مشارکت‌شده توسط Serhiy Storchaka در gh-133306.)

• \B در عبارت باقاعده اکنون با رشته ورودی خالی تطبیق می‌کند، به این معنا که اکنون همیشه عکس \b است. (مشارکت‌شده توسط Serhiy Storchaka در gh-124130.)

socket¶

• بهبود و اصلاح پشتیبانی از سوکت‌های بلوتوث.

  • رفع اشکال پشتیبانی از سوکت‌های بلوتوث در NetBSD و DragonFly BSD. (مشارکت‌شده توسط Serhiy Storchaka در gh-132429.)

  • اصلاح پشتیبانی از BTPROTO_HCI در FreeBSD. (مشارکت‌شده توسط Victor Stinner در gh-111178.)

  • افزودن پشتیبانی از BTPROTO_SCO در FreeBSD. (مشارکت‌شده توسط Serhiy Storchaka در gh-85302.)

  • افزودن پشتیبانی از cid و bdaddr_type در نشانی برای BTPROTO_L2CAP در FreeBSD. (با مشارکت Serhiy Storchaka در gh-132429.)

  • افزودن پشتیبانی از channel در نشانی مربوط به BTPROTO_HCI در لینوکس. (مشارکت‌شده توسط Serhiy Storchaka در gh-70145.)

  • پذیرش یک عدد صحیح به‌عنوان نشانی برای BTPROTO_HCI در لینوکس. (مشارکت‌شده توسط Serhiy Storchaka در gh-132099.)

  • برگرداندن cid در getsockname() برای BTPROTO_L2CAP. (مشارکت Serhiy Storchaka در gh-132429.)

  • ثابت‌های جدید بسیاری افزوده شد. (مشارکت‌شده توسط Serhiy Storchaka در gh-132734.)

ssl¶

• بولی HAS_PHA نشان می‌دهد که آیا ماژول ssl از احراز هویت کلاینت پس از دست‌دهی (PHA) در TLSv1.3 پشتیبانی می‌کند یا خیر. (مشارکت‌شده توسط Will Childs-Klein در gh-128036.)

struct¶

• پشتیبانی از نوع‌های C float complex و double complex در ماژول struct (به ترتیب نویسه‌های قالب‌بندی 'F' و 'D'). (با مشارکت Sergey B Kirpichev در gh-121249.)

symtable¶

• متدهای زیر از Symbol را در دسترس قرار می‌دهد:

  • is_comp_cell()

  • is_comp_iter()

  • is_free_class()

  (مشارکت‌شده توسط Bénédikt Tran در gh-120029.)

sys¶

• تابع ویژه‌ی sys.getobjects() که پیش‌تر مستند نشده بود و فقط در ساخت‌های خاص پایتون وجود دارد، اکنون ممکن است اشیاءی را از مفسرهایی غیر از مفسری که در آن فراخوانی می‌شود بازگرداند. (مشارکت‌شده توسط اریک اسنو در gh-125286.)

• تابع sys._is_immortal() برای تعیین اینکه آیا یک شیء نامیرا است، افزوده شد. (مشارکت‌شده توسط Peter Bierma در gh-128509.)

• در FreeBSD، sys.platform دیگر شامل شماره نسخه‌ی اصلی نیست. همیشه 'freebsd' است، به‌جای 'freebsd13' یا 'freebsd14'. (مشارکت‌شده توسط Michael Osipov در gh-129393.)

• ایجاد DeprecationWarning برای sys._clear_type_cache(). این تابع در پایتون 3.13 منسوخ شد، اما هشدار ران‌تایم ایجاد نمی‌کرد.

• تابع sys.remote_exec() برای پیاده‌سازی رابط اشکال‌زدای خارجی جدید افزوده شد. برای جزئیات به PEP 768 مراجعه کنید. (با مشارکت Pablo Galindo Salgado، Matt Wozniski و Ivona Stojanovic در gh-131591.)

• فضای نام sys._jit افزوده شد که شامل ابزارهایی برای درون‌نگری کامپایل در لحظه است. (با مشارکت Brandt Bucher در gh-133231.)

sys.monitoring¶

• دو رویداد نظارتی جدید، BRANCH_LEFT و BRANCH_RIGHT، افزوده شده‌اند. این دو رویداد جایگزین رویداد BRANCH شده و آن را منسوخ می‌کنند. (مشارکت‌شده توسط Mark Shannon در gh-122548.)

• برای لغو ثبت تمام رویدادها و توابع کال‌بک مرتبط با یک شناسه ابزار، sys.monitoring.clear_tool_id() را اضافه کنید. sys.monitoring.free_tool_id() اکنون قبل از آزاد کردن شناسه ابزار، آن را فراخوانی می‌کند، به جای اینکه رویدادها و کال‌بک‌های آن را ثبت نگه دارد. (مشارکت تیان گائو در gh-116750.)

sysconfig¶

• افزودن کلید ABIFLAGS به get_config_vars() در ویندوز. (مشارکت‌شده توسط Xuehai Pan در gh-131799.)

tarfile¶

• data_filter() اکنون مقصد پیوندهای نمادین را نرمال‌سازی می‌کند تا از حمله‌های پیمایش مسیر (path traversal) جلوگیری شود. (مشارکت‌شده توسط Petr Viktorin در gh-127987 و CVE 2025-4138.)

• extractall() اکنون هنگامی که پوشه‌ای حذف‌شده یا با نوع دیگری از پرونده جایگزین‌شده باشد، از اصلاح ویژگی‌های پوشه صرف‌نظر می‌کند. (مشارکت‌شده توسط Petr Viktorin در gh-127987 و CVE 2024-12718.)

• extract() و extractall() اکنون هنگام جایگزین کردن پیوند (سخت یا نمادین) با کپی عضوی دیگر از آرشیو، و هنگام اصلاح ویژگی‌های پوشه، فیلتر استخراج را (دوباره) اعمال می‌کنند. حالت اول استثنای جدیدی به نام LinkFallbackError ایجاد می‌کند. (مشارکت از Petr Viktorin برای CVE 2025-4330 و CVE 2024-12718.)

• extract() و extractall() دیگر اعضای ردشده را هنگامی که errorlevel() صفر است، استخراج نمی‌کنند. (مشارکت توسط Matt Prodani و Petr Viktorin در gh-112887 و CVE 2025-4435.)

threading¶

• threading.Thread.start() اکنون نام نخ سیستم‌عامل را برابر با threading.Thread.name تنظیم می‌کند. (با مشارکت Victor Stinner در gh-59705.)

tkinter¶

• متدهای after() و after_idle() ابزارک‌های tkinter اکنون آرگومان‌های کلیدواژه‌ای را می‌پذیرند. (مشارکت‌شده توسط Zhikang Yan در gh-126899.)

• قابلیت تعیین نام برای tkinter.OptionMenu و tkinter.ttk.OptionMenu اضافه شد. (مشارکت‌شده توسط Zhikang Yan در gh-130482.)

turtle¶

• مدیرهای زمینه برای turtle.fill()، turtle.poly() و turtle.no_animation() اضافه شدند. (با مشارکت Marie Roald و Yngve Mardal Moe در gh-126350.)

types¶

• types.UnionType اکنون نام مستعری برای typing.Union است. برای جزئیات بیشتر به زیر مراجعه کنید. (مشارکت‌شده توسط Jelle Zijlstra در gh-105499.)

typing¶

• نوع‌های types.UnionType و typing.Union اکنون مستعار یکدیگر هستند، به این معنا که هم اجتماع (union) سبک قدیمی (ایجادشده با Union[int, str]) و هم اجتماع سبک جدید (int | str) اکنون نمونه‌هایی از همان نوع ران‌تایم ایجاد می‌کنند. این، رفتار میان دو سینتکس را یکپارچه می‌کند، اما به برخی تفاوت‌های رفتاری منجر می‌شود که ممکن است بر کاربرانی که نوع‌ها را در زمان اجرا درون‌نگری می‌کنند تأثیر بگذارد:

  • هر دو سینتکس برای ایجاد اجتماع (union) اکنون در repr() بازنمایی رشته‌ای یکسانی تولید می‌کنند. برای مثال، repr(Union[int, str]) اکنون "int | str" است، به‌جای "typing.Union[int, str]".

  • اجتماع‌هایی (Union) که با سینتکس قدیمی ساخته می‌شوند، دیگر در نهانگاه ذخیره نمی‌شوند. پیش از این، اجرای Union[int, str] به دفعات همان شیء را برمی‌گرداند (Union[int, str] is Union[int, str] برابر True بود)، اما اکنون دو شیء متفاوت برمی‌گرداند. برای مقایسه‌ی یونیون‌ها از نظر برابری، از == استفاده کنید، نه is. یونیون‌های سبک جدید هرگز به این روش در نهانگاه ذخیره نشده‌اند. این تغییر ممکن است مصرف حافظه را برای برخی برنامه‌هایی که از تعداد زیادی یونیون ساخته‌شده از طریق زیرنویسی typing.Union استفاده می‌کنند، افزایش دهد. با این حال، چندین عامل این هزینه را جبران می‌کنند: یونیون‌های استفاده‌شده در حاشیه‌نویسی‌ها به دلیل PEP 649 در پایتون 3.14 دیگر به‌طور پیش‌فرض ارزیابی نمی‌شوند؛ یک نمونه از types.UnionType خود بسیار کوچک‌تر از شیء‌ای است که Union[] در نسخه‌های پیشین پایتون برمی‌گرداند؛ و حذف نهانگاه نیز مقداری صرفه‌جویی در فضا ایجاد می‌کند. بنابراین، بعید است که این تغییر برای اکثر کاربران باعث افزایش قابل‌توجهی در مصرف حافظه شود.

  • قبلاً، یونیون‌های سبک قدیمی با استفاده از کلاس خصوصی typing._UnionGenericAlias پیاده‌سازی می‌شدند. این کلاس دیگر برای پیاده‌سازی مورد نیاز نیست، اما برای سازگاری با نسخه‌های پیشین نگه داشته شده است و حذف آن برای پایتون 3.17 برنامه‌ریزی شده است. کاربران باید به‌جای اتکا به جزئیات پیاده‌سازی خصوصی، از ابزارهای کمکی مستند درون‌نگری مانند get_origin() و typing.get_args() استفاده کنند.

  • اکنون می‌توان از خودِ typing.Union در بررسی‌های isinstance() استفاده کرد. برای مثال، isinstance(int | str, typing.Union) مقدار True را برمی‌گرداند؛ پیش‌تر این کار TypeError ایجاد می‌کرد.

  • ویژگی __args__ از اشیاء typing.Union دیگر قابل نوشتن نیست.

  • دیگر نمی‌توان هیچ ویژگی‌ای را روی اشیاء Union تنظیم کرد. این کار در نسخه‌های قبلی تنها برای ویژگی‌های دندر (dunder) کار می‌کرد، هرگز مستند نشده بود که کار کند، و در بسیاری از موارد به‌طور نا‌محسوس معیوب بود.

  (مشارکت‌شده توسط Jelle Zijlstra در gh-105499.)

• TypeAliasType اکنون از واگشایی ستاره‌ای پشتیبانی می‌کند.

unicodedata¶

• پایگاه داده یونیکد به یونیکد 16.0.0 به‌روزرسانی شده است.

unittest¶

• خروجی unittest اکنون به‌طور پیش‌فرض رنگی است. این را می‌توان با متغیرهای محیطی کنترل کرد. (مشارکت‌شده توسط هوگو فان کمِناده در gh-127221.)

• قابلیت کشف unittest دوباره از بسته فضای نام به‌عنوان پوشه شروع پشتیبانی می‌کند. این پشتیبانی در پایتون 3.11 حذف شده بود. (مشارکت‌شده توسط Jacob Walls در gh-80958.)

• تعدادی متد جدید به کلاس TestCase اضافه شد که آزمون‌های تخصصی‌تری فراهم می‌کنند.

  • assertHasAttr() و assertNotHasAttr() بررسی می‌کنند که آیا شیء دارای ویژگی معینی است یا خیر.

  • assertIsSubclass() و assertNotIsSubclass() بررسی می‌کنند که آیا شیء زیرکلاس یک کلاس خاص است یا زیرکلاس یکی از کلاس‌های یک تاپل.

  • assertStartsWith()، assertNotStartsWith()، assertEndsWith() و assertNotEndsWith() بررسی می‌کنند که آیا رشته‌ی یونیکد یا رشته‌ی بایت با رشته‌های مشخصی شروع می‌شود یا به آن‌ها پایان می‌یابد.

  (مشارکت‌شده توسط Serhiy Storchaka در gh-71339.)

urllib¶

• ارتقای الگوریتم احراز هویت دایجست HTTP برای urllib.request با پشتیبانی از احراز هویت دایجست SHA-256 مطابق با مشخصات RFC 7616. (با مشارکت Calvin Bui در gh-128193.)

• بهبود ارگونومی و انطباق با استانداردها هنگام تجزیه و تولید نشانی‌های file:.

  در url2pathname():

  • پذیرفتن یک URL کامل هنگامی که آرگومان جدید require_scheme روی true تنظیم شود.

  • اگر بخش مرجعِ نشانی‌وب با نام میزبان محلی مطابقت دارد، آن را کنار بگذارید.

  • هنگامی که آرگومان جدید resolve_host برابر true تنظیم شده باشد، مرجع (authority) URL در صورت حل شدن به یک آدرس IP محلی حذف می‌شود.

  • اجزای کوئری و قطعه (fragment) در URL دور ریخته می‌شوند.

  • در صورتی که مرجع (authority) یک URL محلی نباشد، URLError ایجاد می‌شود؛ به‌جز در ویندوز که مانند قبل یک مسیر UNC برمی‌گردانیم.

  در pathname2url():

  • وقتی آرگومان جدید add_scheme برابر با true قرار گیرد، یک URL کامل برمی‌گرداند.

  • در صورتی که مسیر با اسلش آغاز شود، یک مرجع (authority) خالی در URL گنجانده می‌شود. برای مثال، مسیر /etc/hosts به URL ///etc/hosts تبدیل می‌شود.

  در ویندوز، حروف درایو دیگر به حروف بزرگ تبدیل نمی‌شوند و نویسه‌های : که به دنبال حرف درایو نمی‌آیند، دیگر باعث ایجاد استثنای OSError نمی‌شوند.

  (مشارکت از Barney Gale در gh-125866.)

uuid¶

• پشتیبانی از نسخه‌های 6، 7 و 8 UUID مطابق مشخصات RFC 9562، از طریق uuid6()، uuid7() و uuid8() به ترتیب اضافه شد. (مشارکت‌شده توسط Bénédikt Tran در gh-89083.)

• NIL و MAX اکنون برای نمایش قالب‌های UUID تهی (Nil) و بیشینه (Max) مطابق تعریف RFC 9562 در دسترس هستند. (با مشارکت Nick Pope در gh-128427.)

• امکان تولید همزمان چندین UUID در خط فرمان از طریق python -m uuid --count فراهم شد. (مشارکت‌شده توسط Simon Legner در gh-131236.)

webbrowser¶

• نام‌ها در متغیر محیطی BROWSER اکنون می‌توانند به مرورگرهای از پیش ثبت‌شده برای ماژول webbrowser اشاره کنند، به‌جای اینکه همیشه یک دستور مرورگر جدید تولید شود.

  این کار باعث می‌شود که بتوان BROWSER را به مقدار یکی از مرورگرهای پشتیبانی‌شده در macOS تنظیم کرد.

zipfile¶

• متد ZipInfo._for_archive اضافه شد؛ متدی برای حل کردن پیش‌فرض‌های مناسب برای شیء ZipInfo همان‌طور که توسط ZipFile.writestr استفاده می‌شود. (مشارکت‌شده توسط Bénédikt Tran در gh-123424.)

• ZipFile.writestr() اکنون برای پشتیبانی بهتر از ساخت‌های تکرارپذیر، متغیر محیطی SOURCE_DATE_EPOCH را رعایت می‌کند. (مشارکت‌شده توسط Jiahao Li در gh-91279.)

asyncio¶

• نتایج بنچمارک‌های استاندارد پس از پیاده‌سازی یک فهرست پیوندی دوطرفه‌ی جدید به ازای هر نخ برای وظیفه‌های بومی، به میزان ۱۰ تا ۲۰ درصد بهبود یافته و مصرف حافظه نیز کاهش یافته است. این امر به ابزارهای درون‌نگری خارجی مانند python -m asyncio pstree امکان می‌دهد گراف فراخوانی وظیفه‌های asyncio در حال اجرا در همه‌ی نخ‌ها را درون‌نگری کنند. (مشارکت Kumar Aditya در gh-107803.)

• این ماژول اکنون پشتیبانی درجه‌یک از ساخت‌های نخ‌آزاد دارد. این امر اجرای موازی چندین حلقه رویداد را در نخ‌های مختلف ممکن می‌سازد که به‌طور خطی با تعداد نخ‌ها مقیاس می‌شود. (مشارکت‌شده توسط Kumar Aditya در gh-128002.)

base64¶

• b16decode() اکنون تا شش برابر سریع‌تر شده است. (مشارکت Bénédikt Tran، Chris Markiewicz و Adam Turner در gh-118761.)

bdb¶

• اشکال‌زدای پایه اکنون بک‌اندی مبتنی بر sys.monitoring دارد که می‌توان آن را با گذر دادن 'monitoring' به پارامتر جدید backend کلاس Bdb انتخاب کرد. (مشارکت‌شده توسط Tian Gao در gh-124533.)

difflib¶

• تابع IS_LINE_JUNK() اکنون تا دو برابر سریع‌تر شده است. (مشارکت‌شده توسط Adam Turner و Semyon Moroz در gh-130167.)

gc¶

• از پایتون 3.14.5 به بعد:

  پایتون 3.14.0 تا 3.14.4 با یک زباله‌روب افزایشی جدید عرضه شد. با این حال، به دلیل تعدادی گزارش درباره‌ی فشار حافظه‌ی قابل‌توجه در محیط‌های عملیاتی، آن به زباله‌روب نسل‌محور نسخه‌ی 3.13 بازگردانده شد. این همان زباله‌روب است که اکنون در پایتون 3.14.5 و پس از آن استفاده می‌شود.

• پیش‌تر در پایتون 3.14.0-3.14.4:

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

  به دلیل این بهینه‌سازی، معنای نتایج get_threshold() و set_threshold() به همراه get_count() و get_stats() تغییر کرده است.

  • برای سازگاری با نسخه‌های پیشین، get_threshold() همچنان یک تاپل سه‌عضوی برمی‌گرداند. مقدار اول، مانند پیش، آستانه‌ی گردآوری‌های جوان است؛ مقدار دوم نرخی را تعیین می‌کند که گردآوری قدیمی با آن پویش می‌شود (مقدار پیش‌فرض ۱۰ است و مقادیر بالاتر به این معناست که گردآوری قدیمی کندتر پویش می‌شود). مقدار سوم اکنون بی‌معناست و همیشه صفر است.

  • set_threshold() اکنون هر آیتمی را پس از آیتم دوم نادیده می‌گیرد.

  • get_count() و get_stats() همچنان همان قالب نتایج را برمی‌گردانند. تنها تفاوت این است که به‌جای آنکه نتایج به نسل‌های جوان، در حال پیر شدن و پیر اشاره کنند، نتایج به نسل جوان و فضاهای پیر شدن و جمع‌آوری نسل پیر اشاره می‌کنند.

  خلاصه اینکه، کدی که سعی می‌کرد رفتار زباله‌روب چرخه‌ای (cycle GC) را دستکاری کند، ممکن است دقیقاً مطابق منظور کار نکند، اما به احتمال بسیار زیاد مضر نخواهد بود. تمام کدهای دیگر بدون هیچ مشکلی کار خواهند کرد.

  (مشارکت Mark Shannon در gh-108362.)

io¶

• باز کردن و خواندن پرونده‌ها اکنون فراخوانی‌های سیستمی کمتری اجرا می‌کند. خواندن کامل یک پرونده کوچکِ موجود در نهانگاه سیستم‌عامل تا ۱۵ درصد سریع‌تر است. (مشارکت‌شده توسط Cody Maloney و Victor Stinner در gh-120754 و gh-90102.)

pathlib¶

• Path.read_bytes اکنون از حالت بدون بافر برای باز کردن پرونده‌ها استفاده می‌کند، که خواندن کامل آن‌ها را بین ۹٪ تا ۱۷٪ سریع‌تر می‌کند. (مشارکت‌شده توسط کودی مالونی در gh-120754.)

pdb¶

• اکنون pdb از دو بک‌اند پشتیبانی می‌کند که مبتنی بر sys.settrace() یا sys.monitoring هستند. استفاده از رابط خط فرمان pdb یا breakpoint() همیشه بک‌اند sys.monitoring را به کار خواهد برد. نمونه‌سازی صریح از pdb.Pdb و کلاس‌های مشتق‌شده‌ی آن به‌صورت پیش‌فرض از بک‌اند sys.settrace() استفاده خواهد کرد که قابل پیکربندی است. (مشارکت‌شده توسط Tian Gao در gh-124533.)

textwrap¶

• تابع dedent() بهینه‌سازی شد و عملکرد آن به‌طور میانگین ۲٫۴ برابر بهبود یافت، با بهبود‌های بزرگ‌تر برای ورودی‌های بزرگ‌تر، و اشکالی در نرمال‌سازی ناقص سطر‌های خالی که نویسه‌های فضای سفید به‌جز فاصله و تب دارند، رفع شد.

uuid¶

• uuid3() و uuid5() اکنون هر دو برای نام‌های ۱۶ بایتی تقریباً ۴۰٪ سریع‌تر و برای نام‌های ۱۰۲۴ بایتی ۲۰٪ سریع‌تر هستند. کارایی برای نام‌های طولانی‌تر بدون تغییر باقی می‌ماند. (مشارکت‌شده توسط Bénédikt Tran در gh-128150.)

• uuid4() اکنون حدود ۳۰٪ سریع‌تر شده است. (مشارکت‌شده توسط Bénédikt Tran در gh-128150.)

zlib¶

• در ویندوز، zlib-ng اکنون به‌عنوان پیاده‌سازی ماژول zlib در دودویی‌های پیش‌فرض استفاده می‌شود. هیچ ناسازگاری شناخته‌شده‌ای بین zlib-ng و پیاده‌سازی قبلی zlib وجود ندارد. این امر باید به عملکرد بهتری در تمام سطوح فشرده‌سازی منجر شود.

  شایان ذکر است که zlib.Z_BEST_SPEED (1) ممکن است نسبت به پیاده‌سازی قبلی به فشرده‌سازی به‌مراتب کمتری منجر شود، در حالی که زمان فشرده‌سازی را نیز به‌طور چشمگیری کاهش می‌دهد.

  (مشارکت Steve Dower در gh-91349.)

argparse¶

• پارامترهای type، choices و metavar از BooleanOptionalAction حذف شدند. این پارامترها از پایتون 3.12 منسوخ شده‌اند. (مشارکت نیکیتا سوبولف در gh-118805.)

• فراخوانی add_argument_group() روی یک گروه آرگومان اکنون استثنای ValueError ایجاد می‌کند. به‌طور مشابه، add_argument_group() یا add_mutually_exclusive_group() روی یک گروه انحصار متقابل اکنون هر دو استثنای ValueError ایجاد می‌کنند. این «تودرتو‌سازی» هرگز پشتیبانی نمی‌شد، اغلب به‌درستی کار نمی‌کرد و به‌طور ناخواسته از طریق وراثت در دسترس قرار گرفته بود. این قابلیت از Python 3.11 منسوخ شده است. (مشارکت‌شده توسط Savannah Ostrowski در gh-127186.)

ast¶

• کلاس‌های زیر، که از پایتون 3.8 نام‌های مستعار منسوخِ Constant بوده‌اند و از پایتون 3.12 هشدارهای منسوخ‌سازی صادر کرده‌اند، حذف شدند:

  • Bytes

  • Ellipsis

  • NameConstant

  • Num

  • Str

  در نتیجه‌ی این حذف‌ها، متدهای visit_Num، visit_Str، visit_Bytes، visit_NameConstant و visit_Ellipsis که توسط کاربر روی زیرکلاس‌های سفارشی NodeVisitor تعریف شده‌اند، دیگر هنگام پیمایش یک AST توسط زیرکلاس NodeVisitor فراخوانی نمی‌شوند. به جای آن، یک متد visit_Constant تعریف کنید.

  (مشارکت الکس وی‌گود در gh-119562.)

• پراپرتی‌های منسوخ زیر روی ast.Constant حذف شدند؛ این پراپرتی‌ها برای سازگاری با کلاس‌های AST که اکنون حذف شده‌اند، وجود داشتند:

  • Constant.n

  • Constant.s

  به جای آن از Constant.value استفاده کنید. (مشارکت‌شده توسط Alex Waygood در gh-119562.)

asyncio¶

• کلاس‌ها، متدها و توابع زیر که از پایتون 3.12 منسوخ شده بودند، حذف شدند:

  • AbstractChildWatcher

  • FastChildWatcher

  • MultiLoopChildWatcher

  • PidfdChildWatcher

  • SafeChildWatcher

  • ThreadedChildWatcher

  • AbstractEventLoopPolicy.get_child_watcher()

  • AbstractEventLoopPolicy.set_child_watcher()

  • get_child_watcher()

  • set_child_watcher()

  (مشارکت‌شده توسط Kumar Aditya در gh-120804.)

• asyncio.get_event_loop() اکنون در صورت نبود حلقه رویداد فعلی، استثنای RuntimeError را پرتاب می‌کند و دیگر به‌طور ضمنی حلقه رویداد ایجاد نمی‌کند.

  (مشارکت Kumar Aditya در gh-126353.)

  چند الگو وجود دارد که از asyncio.get_event_loop() استفاده می‌کنند و بیشتر آن‌ها را می‌توان با asyncio.run() جایگزین کرد.

  اگر در حال اجرای یک تابع ناهمگام هستید، به سادگی از asyncio.run() استفاده کنید.

  پیش از:

  async def main():
      ...
  
  
  loop = asyncio.get_event_loop()
  try:
      loop.run_until_complete(main())
  finally:
      loop.close()
  

  پس از:

  async def main():
      ...
  
  asyncio.run(main())
  

  اگر لازم است چیزی را راه‌اندازی کنید، برای مثال سروری که روی یک سوکت گوش می‌دهد و سپس برای همیشه اجرا می‌شود، از asyncio.run() و یک asyncio.Event استفاده کنید.

  پیش از:

  def start_server(loop): ...
  
  loop = asyncio.get_event_loop()
  try:
      start_server(loop)
      loop.run_forever()
  finally:
      loop.close()
  

  پس از:

  def start_server(loop): ...
  
  async def main():
      start_server(asyncio.get_running_loop())
      await asyncio.Event().wait()
  
  asyncio.run(main())
  

  اگر نیاز دارید چیزی را در یک حلقه رویداد اجرا کنید و سپس کد مسدودکننده‌ای را در اطراف آن اجرا کنید، از asyncio.Runner استفاده کنید.

  پیش از:

  async def operation_one(): ...
  def blocking_code(): ...
  async def operation_two(): ...
  
  loop = asyncio.get_event_loop()
  try:
      loop.run_until_complete(operation_one())
      blocking_code()
      loop.run_until_complete(operation_two())
  finally:
      loop.close()
  

  پس از:

  async def operation_one(): ...
  def blocking_code(): ...
  async def operation_two(): ...
  
  with asyncio.Runner() as runner:
      runner.run(operation_one())
      blocking_code()
      runner.run(operation_two())
  

email¶

• پارامتر isdst از email.utils.localtime() حذف شد که در پایتون 3.12 منسوخ شده بود و از آن زمان نادیده گرفته می‌شد. (مشارکت Hugo van Kemenade در gh-118798.)

importlib.abc¶

• حذف کلاس‌های منسوخ importlib.abc:

  • ResourceReader (از TraversableResources استفاده کنید)

  • Traversable (از Traversable استفاده کنید)

  • TraversableResources (از TraversableResources استفاده کنید)

  (مشارکت Jason R. Coombs و Hugo van Kemenade در gh-93963.)

itertools¶

• حذف پشتیبانی از عملیات کپی، کپی عمیق و پیکل از پیمایش‌گرهای itertools. این موارد از پایتون 3.12 هشدار DeprecationWarning منتشر می‌کردند. (مشارکت‌شده توسط Raymond Hettinger در gh-101588.)

pathlib¶

• پشتیبانی از ارسال آرگومان‌های کلیدواژه‌ای اضافی به Path حذف شد. در نسخه‌های قبلی، هر آرگومانی از این دست نادیده گرفته می‌شد. (مشارکت‌شده توسط Barney Gale در gh-74033.)

• پشتیبانی از ارسال آرگومان‌های جایگاهی اضافی به PurePath.relative_to() و is_relative_to() حذف شد. در نسخه‌های قبلی، هر آرگومانی از این قبیل به other الحاق می‌شد. (مشارکت‌شده توسط Barney Gale در gh-78707.)

pkgutil¶

• توابع get_loader() و find_loader() که از پایتون 3.12 منسوخ شده بودند، حذف شدند. (با مشارکت Bénédikt Tran در gh-97850.)

pty¶

• توابع master_open() و slave_open() که از پایتون 3.12 منسوخ شده بودند، حذف شدند. به جای آن‌ها از pty.openpty() استفاده کنید. (مشارکت نیکیتا سوبولف در gh-118824.)

sqlite3¶

• version و version_info از ماژول sqlite3 حذف شدند؛ برای شماره نسخه واقعی کتابخانه SQLite ران‌تایم از sqlite_version و sqlite_version_info استفاده کنید. (مشارکت‌شده توسط هوگو ون کمِناده در gh-118924.)

• استفاده از دنباله‌ای از پارامترها با جای‌نگهدارهای نام‌دار، که از پایتون 3.12 منسوخ شده بود، اکنون ProgrammingError ایجاد می‌کند. (مشارکت‌شده توسط Erlend E. Aasland در gh-118928 و gh-101693.)

urllib¶

• کلاس Quoter که از پایتون 3.11 منسوخ شده بود، از urllib.parse حذف شد. (با مشارکت نیکیتا سوبولف در gh-118827.)

• کلاس‌های URLopener و FancyURLopener که از پایتون 3.3 منسوخ شده بودند، از urllib.request حذف شدند.

  می‌توان myopener.open() را با urlopen() جایگزین کرد. myopener.retrieve() را می‌توان با urlretrieve() جایگزین کرد. سفارشی‌سازی‌های کلاس‌های بازکننده (opener) را می‌توان با ارسال هندلرهای سفارشی به build_opener() جایگزین کرد. (مشارکت‌شده توسط Barney Gale در gh-84850.)

منسوخ‌سازی‌های جدید¶

• گذر دادن یک عدد مختلط به‌عنوان آرگومان real یا imag در سازنده‌ی complex() اکنون منسوخ شده است؛ اعداد مختلط باید فقط به‌عنوان یک آرگومان جایگاهی واحد گذر داده شوند. (مشارکت‌شده توسط Serhiy Storchaka در gh-109218.)

• argparse:

  • ارسال آرگومان کلیدواژه‌ای مستند‌نشده prefix_chars به متد add_argument_group() اکنون منسوخ شده است. (ارائه‌شده توسط Savannah Ostrowski در gh-125563.)

  • مبدل نوع argparse.FileType منسوخ شد. هر چیزی که به مدیریت منابع مربوط می‌شود باید در پایین‌دست (downstream)، پس از تجزیه آرگومان‌ها انجام شود. (مشارکت Serhiy Storchaka در gh-58032.)

• asyncio:

  • تابع asyncio.iscoroutinefunction() اکنون منسوخ شده است و در پایتون 3.16 حذف خواهد شد؛ به جای آن از inspect.iscoroutinefunction() استفاده کنید. (با مشارکت Jiahao Li و Kumar Aditya در gh-122875.)

  • سیستم سیاست asyncio منسوخ شده است و در Python 3.16 حذف خواهد شد. به‌طور خاص، کلاس‌ها و توابع زیر منسوخ شده‌اند:

    • asyncio.AbstractEventLoopPolicy

    • asyncio.DefaultEventLoopPolicy

    • asyncio.WindowsSelectorEventLoopPolicy

    • asyncio.WindowsProactorEventLoopPolicy

    • asyncio.get_event_loop_policy()

    • asyncio.set_event_loop_policy()

    کاربران باید برای استفاده از پیاده‌سازی حلقه رویداد دلخواه، از asyncio.run() یا asyncio.Runner به‌همراه آرگومان loop_factory استفاده کنند.

    به عنوان مثال، برای استفاده از asyncio.SelectorEventLoop در ویندوز:

    import asyncio
    
    async def main():
        ...
    
    asyncio.run(main(), loop_factory=asyncio.SelectorEventLoop)
    

    (مشارکت‌شده توسط Kumar Aditya در gh-127949.)

• codecs: تابع codecs.open() اکنون منسوخ شده است و در نسخه‌ای آینده از پایتون حذف خواهد شد. به جای آن از open() استفاده کنید. (مشارکت‌شده توسط Inada Naoki در gh-133036.)

• ctypes:

  • در پلتفرم‌های غیر از ویندوز، تنظیم Structure._pack_ برای استفاده از چیدمان حافظه‌ی پیش‌فرض سازگار با MSVC، اکنون به نفع تنظیم Structure._layout_ به 'ms' منسوخ شده است و در پایتون 3.19 حذف خواهد شد. (با مشارکت Petr Viktorin در gh-131747.)

  • فراخوانی ctypes.POINTER() روی یک رشته اکنون منسوخ شده است. برای ساختارهای خودارجاع از نوع‌های ناقص استفاده کنید. همچنین، ctypes._pointer_type_cache داخلی منسوخ شده است. برای جزئیات به‌روز پیاده‌سازی به ctypes.POINTER() مراجعه کنید. (مشارکت‌شده توسط Sergey Myrianov در gh-100926.)

• functools: فراخوانی پیاده‌سازی پایتونی functools.reduce() با function یا sequence به‌عنوان آرگومان‌های کلیدواژه‌ای اکنون منسوخ شده است؛ این پارامترها در پایتون 3.16 فقط جایگاهی خواهند شد. (مشارکت‌شده توسط Kirill Podoprigora در gh-121676.)

• logging: پشتیبانی از هندلرهای گزارش‌گیری سفارشی با آرگومان strm اکنون منسوخ شده است و قرار است در پایتون 3.16 حذف شود. در عوض، هندلرها را با آرگومان stream تعریف کنید. (مشارکت‌شده توسط Mariusz Felisiak در gh-115032.)

• mimetypes: پسوندهای معتبر برای mimetypes.MimeTypes.add_type() یا خالی هستند یا باید با '.' شروع شوند. پسوندهای بدون نقطه منسوخ شده‌اند و در پایتون 3.16 یک ValueError ایجاد خواهند کرد. (ارائه‌شده توسط هوگو ون کمِناده در gh-75223.)

• nturl2path: این ماژول اکنون منسوخ شده است. به جای آن، urllib.request.url2pathname() و pathname2url() را فراخوانی کنید. (مشارکت‌شده توسط Barney Gale در gh-125866.)

• os: توابع os.popen() و os.spawn* اکنون به‌طور نرم منسوخ (soft deprecated) هستند. دیگر نباید از آن‌ها برای نوشتن کد جدید استفاده کنید. در عوض، استفاده از ماژول subprocess توصیه می‌شود. (با مشارکت Victor Stinner در gh-120743.)

• pathlib: pathlib.PurePath.as_uri() اکنون منسوخ شده و حذف آن در پایتون 3.19 برنامه‌ریزی شده است. به جای آن از pathlib.Path.as_uri() استفاده کنید. (مشارکت‌شده توسط برنی گیل در gh-123599.)

• pdb: ویژگی مستندنشده‌ی pdb.Pdb.curframe_locals اکنون یک پراپرتی فقط‌خواندنی منسوخ است که در نسخه‌های آینده‌ی پایتون حذف خواهد شد. دسترسی پویا با سربار کم به متغیرهای محلی فریم که در پایتون 3.13 توسط PEP 667 اضافه شد، به این معنی است که ارجاع به نهانگاه متغیرهای محلی فریم که پیش‌تر در این ویژگی ذخیره می‌شد، دیگر لازم نیست. اشکال‌زداهای مشتق‌شده باید در پایتون 3.13 و نسخه‌های بعدی، مستقیماً به pdb.Pdb.curframe.f_locals دسترسی داشته باشند. (مشارکت‌شده توسط Tian Gao در gh-124369 و gh-125951.)

• symtable: symtable.Class.get_methods() به دلیل عدم استقبال منسوخ شد و حذف آن در پایتون 3.16 برنامه‌ریزی شده است. (مشارکت‌شده توسط Bénédikt Tran در gh-119698.)

• tkinter: متدهای trace_variable()، trace_vdelete() و trace_vinfo() در tkinter.Variable اکنون منسوخ شده‌اند. به جای آن‌ها از trace_add()، trace_remove() و trace_info() استفاده کنید. (مشارکت‌شده توسط Serhiy Storchaka در gh-120220.)

• urllib.parse: پذیرش اشیاء دارای مقادیر نادرست (مانند 0 و []) به‌جز رشته‌های خالی، اشیاء شبه‌بایت و None در parse_qsl() و parse_qs() اکنون منسوخ شده است. (مشارکت‌شده توسط Serhiy Storchaka در gh-116897.)

در پایتون 3.15 حذف خواهد شد¶

• سیستم ایمپورت:

  • تنظیم __cached__ روی یک ماژول در حالی که تنظیم کردن __spec__.cached ناموفق باشد، منسوخ شده است. در پایتون ۳.۱۵، __cached__ توسط سیستم ایمپورت یا کتابخانه‌ی استاندارد تنظیم نخواهد شد و در نظر گرفته نمی‌شود. (gh-97879)

  • تنظیم __package__ روی یک ماژول بدون آنکه __spec__.parent تنظیم شود، منسوخ شده است. در پایتون 3.15، __package__ دیگر توسط سیستم ایمپورت یا کتابخانه استاندارد تنظیم یا در نظر گرفته نخواهد شد. (gh-97879)

• ctypes:

  • تابع مستند‌نشده‌ی ctypes.SetPointerType() از پایتون 3.13 منسوخ شده است.

• http.server:

  • کلاس منسوخ و به‌ندرت استفاده‌شده‌ی CGIHTTPRequestHandler از نسخه‌ی ۳.۱۳ پایتون از رده خارج شده است. هیچ جایگزین مستقیمی برای آن وجود ندارد. هر چیزی برای برقراری ارتباط بین یک سرور وب و یک هندلر درخواست، از CGI بهتر است.

  • پرچم --cgi در رابط خط فرمان python -m http.server از پایتون 3.13 منسوخ شده است.

• importlib:

  • متد load_module(): به‌جای آن از exec_module() استفاده کنید.

• pathlib:

  • متد .PurePath.is_reserved() از پایتون ۳.۱۳ منسوخ شده است. برای شناسایی مسیرهای رزرو شده در ویندوز، از os.path.isreserved() استفاده کنید.

• platform:

  • تابعی platform.java_ver() از نسخه‌ی ۳.۱۳ پایتون منسوخ شده است. این تابع فقط برای پشتیبانی از Jython مفید است، دارای یک API گیج‌کننده است و تا حد زیادی آزمایش نشده است.

• sysconfig:

  • آرگومان check_home تابع sysconfig.is_python_build() از پایتون 3.12 منسوخ شده است.

• threading:

  • RLock() در پایتون 3.15 هیچ آرگومانی نخواهد گرفت. گذراندن هر آرگومانی از پایتون 3.14 منسوخ شده است، زیرا نسخه پایتونی هیچ آرگومانی را مجاز نمی‌داند، اما نسخه C هر تعداد آرگومان جایگاهی یا کلیدواژه‌ای را می‌پذیرد و همه آرگومان‌ها را نادیده می‌گیرد.

• types:

  • types.CodeType: دسترسی به codeobject.co_lnotab در PEP 626 از نسخه‌ی ۳.۱۰ منسوخ شد و برنامه‌ریزی شده بود در نسخه‌ی ۳.۱۲ حذف شود، اما تنها در نسخه‌ی ۳.۱۲ یک هشدار DeprecationWarning مناسب دریافت کرد. ممکن است در نسخه‌ی ۳.۱۵ حذف شود. (مشارکت‌کننده: Nikita Sobolev در gh-101866.)

• typing:

  • سینتکس آرگومان کلیدواژه‌ای مستندنشده برای ایجاد کلاس‌های NamedTuple (برای مثال، Point = NamedTuple("Point", x=int, y=int)) از پایتون 3.13 منسوخ شده است. به‌جای آن از سینتکس مبتنی بر کلاس یا سینتکس تابعی استفاده کنید.

  • هنگام استفاده از سینتکس تابعی TypedDict، عدم ارسال مقدار به پارامتر fields (TD = TypedDict("TD")) یا ارسال None (TD = TypedDict("TD", None)) از پایتون 3.13 منسوخ شده است. برای ایجاد یک TypedDict با صفر فیلد، از class TD(TypedDict): pass یا TD = TypedDict("TD", {}) استفاده کنید.

  • تابع typing.no_type_check_decorator از نسخه‌ی ۳.۱۳ پایتون منسوخ شده است. پس از هشت سال حضور در ماژول typing، هنوز توسط هیچ‌کدام از بررسی‌کننده‌های نوع بزرگ پشتیبانی نمی‌شود.

• ماژول‌های sre_compile، sre_constants و sre_parse.

• wave:

  • متدهای getmark()، setmark() و getmarkers() از کلاس‌های Wave_read و Wave_write از پایتون ۳.۱۳ منسوخ شده‌اند.

• zipimport:

  • zipimport.zipimporter.load_module() از پایتون ۳.۱۰ منسوخ شده است. به‌جای آن از exec_module() استفاده کنید. (gh-125746.)

در انتظار حذف در پایتون 3.16¶

• سیستم ایمپورت:

  • تنظیم __loader__ روی یک ماژول بدون آنکه __spec__.loader تنظیم شود، منسوخ شده است. در پایتون 3.16، __loader__ دیگر توسط سامانه ایمپورت یا کتابخانه استاندارد تنظیم نخواهد شد یا در نظر گرفته نخواهد شد.

• array:

  • کد قالب 'u' (wchar_t) در مستندات از پایتون 3.3 و در ران‌تایم از پایتون 3.13 منسوخ شده است. به‌جای آن، برای نویسه‌های یونیکد از کد قالب 'w' (Py_UCS4) استفاده کنید.

• asyncio:

  • asyncio.iscoroutinefunction() منسوخ شده است و در پایتون 3.16 حذف خواهد شد؛ به‌جای آن از inspect.iscoroutinefunction() استفاده کنید. (مشارکت‌شده توسط Jiahao Li و Kumar Aditya در gh-122875.)

  • سیستم سیاست‌گذاری asyncio منسوخ شده است و در پایتون 3.16 حذف خواهد شد. به‌طور خاص، کلاس‌ها و توابع زیر منسوخ شده‌اند:

    • asyncio.AbstractEventLoopPolicy

    • asyncio.DefaultEventLoopPolicy

    • asyncio.WindowsSelectorEventLoopPolicy

    • asyncio.WindowsProactorEventLoopPolicy

    • asyncio.get_event_loop_policy()

    • asyncio.set_event_loop_policy()

    کاربران باید برای استفاده از پیاده‌سازی حلقه رویداد مورد نظر، از asyncio.run() یا asyncio.Runner همراه با loop_factory استفاده کنند.

    به عنوان مثال، برای استفاده از asyncio.SelectorEventLoop در ویندوز:

    import asyncio
    
    async def main():
        ...
    
    asyncio.run(main(), loop_factory=asyncio.SelectorEventLoop)
    

    (مشارکت‌شده توسط Kumar Aditya در gh-127949.)

• builtins:

  • وارون‌سازی بیتی روی نوع‌های بولی، یعنی ~True یا ~False، از پایتون 3.12 منسوخ شده است، زیرا نتایجی عجیب و خلاف شهود تولید می‌کند (-2 و -1). برای نقیض منطقی یک مقدار بولی، به‌جای آن از not x استفاده کنید. در موارد نادری که به وارون‌سازی بیتی عدد صحیح زیرین نیاز دارید، آن را به‌طور صریح به int تبدیل کنید (~int(x)).

• functools:

  • فراخوانی پیاده‌سازی پایتونیِ functools.reduce() با function یا sequence به‌عنوان آرگومان‌های کلیدواژه‌ای از پایتون 3.14 منسوخ شده است.

• logging:

  • پشتیبانی از هندلرهای سفارشی گزارش‌گیری با آرگومان strm منسوخ شده و برای حذف در پایتون 3.16 برنامه‌ریزی شده است. به جای آن، هندلرها را با آرگومان stream تعریف کنید. (مشارکت Mariusz Felisiak در gh-115032.)

• mimetypes:

  • پسوندهای معتبر برای mimetypes.MimeTypes.add_type() با '.' شروع می‌شوند یا خالی هستند. پسوندهای بدون نقطه منسوخ شده‌اند و در Python 3.16 باعث ایجاد ValueError می‌شوند. (با مشارکت Hugo van Kemenade در gh-75223.)

• shutil:

  • استثنای ExecError از پایتون 3.14 منسوخ شده است. این استثنا از پایتون 3.4 به بعد توسط هیچ تابعی در shutil استفاده نشده است و اکنون نام مستعاری برای RuntimeError است.

• symtable:

  • متد Class.get_methods از پایتون 3.14 منسوخ شده است.

• sys:

  • تابع _enablelegacywindowsfsencoding() از پایتون 3.13 منسوخ شده است. به جای آن از متغیر محیطی PYTHONLEGACYWINDOWSFSENCODING استفاده کنید.

• sysconfig:

  • تابع sysconfig.expand_makefile_vars() از پایتون 3.14 منسوخ شده است. به‌جای آن از آرگومان vars در sysconfig.get_paths() استفاده کنید.

• tarfile:

  • ویژگی مستندنشده و استفاده‌نشده‌ی TarFile.tarfile از پایتون 3.13 منسوخ شده است.

در انتظار حذف در پایتون 3.17¶

• datetime:

  • فراخوانی‌های متد strptime() که از یک رشته‌ی قالب حاوی %e (روز ماه) بدون سال استفاده می‌کنند. این مورد از نسخه‌ی ۳.۱۵ پایتون منسوخ شده است. (مشارکت توسط Stan Ulbrych در gh-70647.)

• collections.abc:

  • collections.abc.ByteString برای حذف در پایتون 3.17 برنامه‌ریزی شده است.

    برای آزمایش اینکه آیا obj پروتکل بافر را در زمان اجرا پیاده‌سازی می‌کند، از isinstance(obj, collections.abc.Buffer) استفاده کنید. برای استفاده در حاشیه‌نویسی‌های نوع، یا از Buffer استفاده کنید یا از یک اجتماع (union) که به‌صراحت نوع‌هایی را که کد شما پشتیبانی می‌کند مشخص می‌کند (مثلاً bytes | bytearray | memoryview).

    ByteString در اصل قرار بود یک کلاس انتزاعی باشد که به‌عنوان فرانوع (supertype) هر دو bytes و bytearray عمل کند. اما از آنجا که این کلاس پایه انتزاعی هرگز هیچ متدی نداشت، دانستن اینکه یک شیء نمونه‌ای از ByteString است، در واقع هرگز هیچ چیز مفیدی درباره‌ی آن شیء به شما نمی‌گفت. سایر نوع‌های بافر رایج مانند memoryview نیز هرگز به‌عنوان زیرنوع‌های ByteString در نظر گرفته نمی‌شدند (نه در زمان اجرا و نه توسط بررسی‌گرهای نوع ایستا).

    برای جزئیات بیشتر به PEP 688 مراجعه کنید. (مشارکت‌شده توسط شانتانو جین در gh-91896.)

• encodings:

  • ارسال نام‌های کدگذاری non-ascii به تابع encodings.normalize_encoding() منسوخ شده است و طبق برنامه‌ریزی در نسخه‌ی ۳.۱۷ پایتون حذف خواهد شد. (مشارکت توسط Stan Ulbrych در gh-136702.)

• profile:

  • ماژول profile منسوخ شده است و در نسخه‌ی ۳.۱۷ پایتون حذف خواهد شد. به‌جای آن از profiling.tracing استفاده کنید که یک API سازگار فراهم می‌کند. برای جزئیات به PEP 799 مراجعه کنید. (مشارکت توسط Pablo Galindo و László Kiss Kollár در gh-138122.)

• webbrowser:

  • webbrowser.MacOSXOSAScript به نفع webbrowser.MacOS منسوخ شده است. (gh-137586)

• typing:

  • پیش از پایتون 3.14، اجتماعهای سبک قدیمی (old-style unions) با استفاده از کلاس خصوصی typing._UnionGenericAlias پیاده‌سازی می‌شدند. این کلاس دیگر برای پیاده‌سازی مورد نیاز نیست، اما برای سازگاری با نسخه‌های قبلی حفظ شده است و حذف آن برای پایتون 3.17 برنامه‌ریزی شده است. کاربران باید به‌جای تکیه بر جزئیات پیاده‌سازی خصوصی، از ابزارهای کمکی درون‌نگری مستند مانند typing.get_origin() و typing.get_args() استفاده کنند.

  • typing.ByteString که از پایتون 3.9 منسوخ شده است، قرار است در پایتون 3.17 حذف شود.

    برای آزمایش اینکه آیا obj پروتکل بافر را در زمان اجرا پیاده‌سازی می‌کند، از isinstance(obj, collections.abc.Buffer) استفاده کنید. برای استفاده در حاشیه‌نویسی‌های نوع، یا از Buffer استفاده کنید یا از یک اجتماع (union) که به‌صراحت نوع‌هایی را که کد شما پشتیبانی می‌کند مشخص می‌کند (مثلاً bytes | bytearray | memoryview).

    ByteString در اصل قرار بود یک کلاس انتزاعی باشد که به‌عنوان فرانوع (supertype) هر دو bytes و bytearray عمل کند. اما از آنجا که این کلاس پایه انتزاعی هرگز هیچ متدی نداشت، دانستن اینکه یک شیء نمونه‌ای از ByteString است، در واقع هرگز هیچ چیز مفیدی درباره‌ی آن شیء به شما نمی‌گفت. سایر نوع‌های بافر رایج مانند memoryview نیز هرگز به‌عنوان زیرنوع‌های ByteString در نظر گرفته نمی‌شدند (نه در زمان اجرا و نه توسط بررسی‌گرهای نوع ایستا).

    برای جزئیات بیشتر به PEP 688 مراجعه کنید. (مشارکت‌شده توسط شانتانو جین در gh-91896.)

• tkinter:

  • متدهای tkinter.Variable یعنی trace_variable()، trace() (که نام مستعاری برای trace_variable() است)، trace_vdelete() و trace_vinfo() که از نسخه‌ی ۳.۱۴ پایتون منسوخ شده‌اند، برای حذف در نسخه‌ی ۳.۱۷ پایتون برنامه‌ریزی شده‌اند. به‌جای آن‌ها از trace_add()، trace_remove() و trace_info() استفاده کنید. (توسط Serhiy Storchaka در gh-120220 مشارکت داده شده است.)

در انتظار حذف در پایتون 3.18¶

• دیگر مقداری بولی در جایی که انتظار توصیف‌گر پرونده می‌رود پذیرفته نمی‌شود. (توسط Serhiy Storchaka در gh-82626 مشارکت داده شده است.)

• decimal:

  • مشخص‌کننده‌ی قالب 'N' در Decimal، که غیراستاندارد و مستندسازی‌نشده است و تنها در پیاده‌سازی C ماژول decimal پشتیبانی می‌شود، از پایتون 3.13 منسوخ شده است. (مشارکت‌شده توسط Serhiy Storchaka در gh-89902.)

• موارد منسوخ تعریف‌شده توسط PEP 829:

  • سطرهای import در پرونده‌های name.pth به‌طور صامت نادیده گرفته می‌شوند.

  (توسط Barry Warsaw در gh-148641 مشارکت داده شده است.)

در انتظار حذف در پایتون 3.19¶

• ctypes:

  • تغییر ضمنی به چیدمان ساختار سازگار با MSVC از طریق تنظیم _pack_ اما بدون تنظیم _layout_ روی پلتفرم‌های غیر ویندوزی.

• hashlib:

  • در سازنده‌های تابع هش مانند new() یا سازنده‌های مستقیم با نام هش مانند md5() و sha256()، به پارامتر داده‌ی اولیه‌ی اختیاری آن‌ها نیز می‌توان در پیاده‌سازی‌های مختلف hashlib یک آرگومان کلیدواژه‌ای به نام data= یا string= ارسال کرد.

    پشتیبانی از نام آرگومان کلیدواژه‌ای string اکنون منسوخ شده است و در نسخه‌ی ۳.۱۹ پایتون حذف خواهد شد.

    پیش از نسخه‌ی ۳.۱۳ پایتون، پارامتر کلیدواژه‌ای string بسته به پیاده‌سازی بک‌اند تابع‌های هش به‌درستی پشتیبانی نمی‌شد. برای حداکثر سازگاری با نسخه‌های قبلی، ترجیح دهید داده‌ی اولیه را به عنوان یک آرگومان جایگاهی ارسال کنید.

• http.cookies:

  • متد http.cookies.Morsel.js_output() منسوخ شده است و در نسخه‌ی ۳.۱۹ پایتون حذف خواهد شد.

  • متد http.cookies.BaseCookie.js_output() منسوخ شده است و در نسخه‌ی ۳.۱۹ پایتون حذف خواهد شد.

• imaplib:

  • تغییر دادن IMAP4.file اکنون منسوخ شده است و طبق برنامه‌ریزی در نسخه‌ی ۳.۱۹ پایتون حذف خواهد شد. این خصوصیت اکنون استفاده نمی‌شود و تغییر مقدار آن به‌طور خودکار پرونده‌ی فعلی را نمی‌بندد.

    پیش از نسخه‌ی ۳.۱۴ پایتون، این خصوصیت برای پیاده‌سازی متدهای مربوط به read() و readline() برای IMAP4 استفاده می‌شد، اما از آن زمان به بعد دیگر این‌طور نیست.

در نوبت حذف در نسخه‌ی ۳.۲۰ پایتون¶

• فراخوانی متد __new__() از struct.Struct بدون آرگومان format منسوخ شده است و در نسخه‌ی ۳.۲۰ پایتون حذف خواهد شد. فراخوانی متد __init__() روی شیءهای مقداردهی اولیه‌شده‌ی Struct منسوخ شده است و در نسخه‌ی ۳.۲۰ پایتون حذف خواهد شد.

  (توسط Sergey B Kirpichev و Serhiy Storchaka در gh-143715 مشارکت داده شده است.)

• صفات __version__، version و VERSION در این ماژول‌های کتابخانه‌ی استاندارد منسوخ شده‌اند و در نسخه‌ی ۳.۲۰ پایتون حذف خواهند شد. به‌جای آن از sys.version_info استفاده کنید.

  • argparse

  • csv

  • ctypes

  • ctypes.macholib

  • decimal (به‌جای آن از decimal.SPEC_VERSION استفاده کنید)

  • http.server

  • imaplib

  • ipaddress

  • json

  • logging (__date__ نیز منسوخ شده است)

  • optparse

  • pickle

  • platform

  • re

  • socketserver

  • tabnanny

  • tarfile

  • tkinter.font

  • tkinter.ttk

  • wsgiref.simple_server

  • xml.etree.ElementTree

  • xml.sax.expatreader

  • xml.sax.handler

  • zlib

  (مشارکت توسط Hugo van Kemenade و Stan Ulbrych در gh-76007.)

• موارد منسوخ تعریف‌شده توسط PEP 829:

  • برای خط‌های import یافت‌شده در پرونده‌های name.pth اخطارهایی تولید می‌شود.

  • پرونده‌های name.pth دیگر به‌طور پیش‌فرض با کدگذاری locale رمزگشایی نمی‌شوند. آن‌ها باید با utf-8-sig کدگذاری شوند.

  (توسط Barry Warsaw در gh-148641 مشارکت داده شده است.)

• ast:

  • ایجاد نمونه‌هایی از گره‌های درخت نحوی انتزاعی (AST) (مانند ast.AST یا ast.expr) منسوخ شده است و در پایتون ۳.۲۰ خطایی را ایجاد خواهد کرد.

• typing:

  • فراخوانی بررسی‌های isinstance() و issubclass() روی کلاس‌های پروتکلی که صراحتاً با runtime_checkable() تزئین نشده‌اند اما از یک کلاس پروتکلِ قابل‌بررسی در زمان اجرا (runtime-checkable) ارث‌بری می‌کنند، منسوخ شده است. این کار در پایتون ۳.۲۰ یک TypeError ایجاد خواهد کرد.

    (مشارکت توسط Bartosz Sławecki در gh-132604.)

در انتظار حذف در نسخه‌های آینده¶

APIهای زیر در آینده حذف خواهند شد، هرچند در حال حاضر تاریخی برای حذف آن‌ها تعیین نشده است.

• argparse:

  • تودرتو کردن گروه‌های آرگومان و تودرتو کردن گروه‌های متقابلاً مانعة‌الجمع منسوخ شده‌اند.

  • ارسال آرگومان کلیدواژه‌ای مستندنشده prefix_chars به add_argument_group() اکنون منسوخ شده است.

  • مبدل نوع argparse.FileType منسوخ شده است.

• builtins:

  • تولیدگرها: امضای throw(type, exc, tb) و athrow(type, exc, tb) منسوخ شده است: به‌جای آن از throw(exc) و athrow(exc) استفاده کنید، یعنی امضای تک‌آرگومانی.

  • در حال حاضر پایتون می‌پذیرد که مقادیر لفظی عددی بلافاصله با کلیدواژه‌ها دنبال شوند، برای مثال 0in x، 1or x، 0if 1else 2. این اجازه می‌دهد عبارت‌های گیج‌کننده و مبهمی مانند [0x1for x in y] نوشته شوند (که می‌توان آن را به صورت [0x1 for x in y] یا [0x1f or x in y] تفسیر کرد). اگر بلافاصله پس از مقدار لفظی عددی، یکی از کلیدواژه‌های and، else، for، if، in، is و or بیاید، یک هشدار نحوی صادر می‌شود. در نسخه‌ای در آینده این به یک خطای نحوی تبدیل خواهد شد. (gh-87999)

  • پشتیبانی از متدهای __index__() و __int__() که نوعی غیر از int برمی‌گردانند: این متدها ملزم خواهند بود که نمونه‌ای از یک زیرکلاس اکیدِ int را برگردانند.

  • پشتیبانی از متد __float__() که زیرکلاس اکیدی از float را برمی‌گرداند: این متدها ملزم خواهند شد که نمونه‌ای از float را برگردانند.

  • پشتیبانی از متد __complex__() که زیرکلاس اکیدی از complex را برمی‌گرداند: این متدها ملزم به برگرداندن نمونه‌ای از complex خواهند بود.

  • ارسال یک عدد مختلط به‌عنوان آرگومان real یا imag در سازنده‌ی complex() اکنون منسوخ شده است؛ این عدد باید فقط به‌عنوان یک آرگومان جایگاهی منفرد ارسال شود. (مشارکت Serhiy Storchaka در gh-109218.)

• calendar: ثابت‌های calendar.January و calendar.February منسوخ شده‌اند و با calendar.JANUARY و calendar.FEBRUARY جایگزین شده‌اند. (مشارکت‌شده توسط Prince Roshan در gh-103636.)

• codecs: به‌جای codecs.open() از open() استفاده کنید. (gh-133038)

• codeobject.co_lnotab: به‌جای آن از متد codeobject.co_lines() استفاده کنید.

• datetime:

  • utcnow(): از datetime.datetime.now(tz=datetime.UTC) استفاده کنید.

  • utcfromtimestamp(): از datetime.datetime.fromtimestamp(timestamp, tz=datetime.UTC) استفاده کنید.

• gettext: مقدار جمع باید یک عدد صحیح باشد.

• importlib:

  • پارامتر debug_override در cache_from_source() منسوخ شده است: به‌جای آن از پارامتر optimization استفاده کنید.

• importlib.metadata:

  • رابط تاپلی EntryPoints.

  • None ضمنی در مقادیر بازگشتی.

• logging: متد warn() از پایتون 3.3 منسوخ شده است؛ به جای آن از warning() استفاده کنید.

• mailbox: استفاده از ورودی StringIO و حالت متنی منسوخ شده است؛ به جای آن از BytesIO و حالت دودویی استفاده کنید.

• os: فراخوانی os.register_at_fork() در یک فرایند چندنخی.

• os.path: تابع os.path.commonprefix() منسوخ شده است؛ برای پیشوندهای مسیر از os.path.commonpath() استفاده کنید. تابع os.path.commonprefix() به دلیل داشتن نام و ماژول گمراه‌کننده در حال منسوخ شدن است. این تابع با وجود اینکه در ماژولی مربوط به دستکاری مسیر قرار دارد، برای استفاده با پیشوندهای مسیر ایمن نیست؛ به این معنی که با استفاده از این تابع، به‌طور تصادفی آسیب‌پذیری‌های پیمایش مسیر (path traversal) در برنامه‌های پایتون ایجاد می‌شود.

• pydoc.ErrorDuringImport: مقدار تاپل برای پارامتر exc_info منسوخ شده است؛ از یک نمونه استثنا استفاده کنید.

• re: اکنون قواعد سخت‌گیرانه‌تری برای ارجاع‌های عددی گروه و نام گروه‌ها در عبارات باقاعده اعمال می‌شود. اکنون فقط دنباله‌ای از ارقام اسکی به‌عنوان ارجاع عددی پذیرفته می‌شود. نام گروه در الگوهای بایتی و رشته‌های جایگزین اکنون فقط می‌تواند شامل حروف و ارقام اسکی و زیرخط باشد. (مشارکت‌شده توسط Serhiy Storchaka در gh-91760.)

• shutil: پارامتر onerror در rmtree() در پایتون 3.12 منسوخ شده است؛ به جای آن از پارامتر onexc استفاده کنید.

• گزینه‌ها و پروتکل‌های ssl:

  • ssl.SSLContext بدون آرگومان پروتکل منسوخ شده است.

  • ssl.SSLContext: set_npn_protocols() و selected_npn_protocol() منسوخ شده‌اند: به جای آن‌ها از ALPN استفاده کنید.

  • گزینه‌های ssl.OP_NO_SSL*

  • گزینه‌های ssl.OP_NO_TLS*

  • ssl.PROTOCOL_SSLv3

  • ssl.PROTOCOL_TLS

  • ssl.PROTOCOL_TLSv1

  • ssl.PROTOCOL_TLSv1_1

  • ssl.PROTOCOL_TLSv1_2

  • ssl.TLSVersion.SSLv3

  • ssl.TLSVersion.TLSv1

  • ssl.TLSVersion.TLSv1_1

• متدهای threading:

  • threading.Condition.notifyAll(): از notify_all() استفاده کنید.

  • threading.Event.isSet(): از is_set() استفاده کنید.

  • threading.Thread.isDaemon()، threading.Thread.setDaemon(): از ویژگی threading.Thread.daemon استفاده کنید.

  • threading.Thread.getName()، threading.Thread.setName(): از ویژگی threading.Thread.name استفاده کنید.

  • threading.currentThread(): از threading.current_thread() استفاده کنید.

  • threading.activeCount(): از threading.active_count() استفاده کنید.

• typing.Text (gh-92332).

• کلاس داخلی typing._UnionGenericAlias دیگر برای پیاده‌سازی typing.Union استفاده نمی‌شود. برای حفظ سازگاری با کاربرانی که از این کلاس خصوصی استفاده می‌کنند، یک شیم سازگاری (compatibility shim) تا حداقل پایتون 3.17 ارائه خواهد شد. (مشارکت Jelle Zijlstra در gh-105499.)

• unittest.IsolatedAsyncioTestCase: منسوخ شده است که از یک مورد آزمون مقداری غیر از None برگردانده شود.

• توابع منسوخ urllib.parse: به‌جای آن‌ها از urlparse() استفاده کنید

  • splitattr()

  • splithost()

  • splitnport()

  • splitpasswd()

  • splitport()

  • splitquery()

  • splittag()

  • splittype()

  • splituser()

  • splitvalue()

  • to_bytes()

• wsgiref: SimpleHandler.stdout.write() نباید نوشتن جزئی (partial write) انجام دهد.

• xml.etree.ElementTree: آزمودن مقدار درستی یک Element منسوخ شده است. در نسخه‌های آینده، همیشه True بازگردانده خواهد شد. به‌جای آن، آزمون‌های صریح len(elem) یا elem is not None را ترجیح دهید.

• sys._clear_type_cache() منسوخ شده است: به جای آن از sys._clear_internal_caches() استفاده کنید.

شبه‌دستورها¶

• شبه‌دستور ANNOTATIONS_PLACEHOLDER برای پشتیبانی از حاشیه‌نویسی‌های سطح ماژول که به‌طور جزئی اجرا شده‌اند، همراه با ارزیابی معوق حاشیه‌نویسی‌ها اضافه شد. (مشارکت‌شده توسط Jelle Zijlstra در gh-130907.)

• شبه‌دستور BINARY_OP_EXTEND افزوده شد که جفتی از توابع (توابع نگهبان و تخصصی‌سازی) را که از نهانگاه درون‌خطی در دسترس‌اند اجرا می‌کند. (مشارکت‌شده توسط Irit Katriel در gh-100239.)

• سه تخصصی‌سازی برای CALL_KW اضافه شد؛ CALL_KW_PY برای فراخوانی توابع پایتون، CALL_KW_BOUND_METHOD برای فراخوانی متدهای مقید و CALL_KW_NON_PY برای همه‌ی فراخوانی‌های دیگر. (مشارکت‌شده توسط مارک شانون در gh-118093.)

• افزودن شبه‌دستورالعمل‌های JUMP_IF_TRUE و JUMP_IF_FALSE، پرش‌های شرطی که بر پشته تأثیر نمی‌گذارند. با دنباله‌ی COPY 1، TO_BOOL و POP_JUMP_IF_TRUE/FALSE جایگزین می‌شوند. (مشارکت‌شده توسط Irit Katriel در gh-124285.)

• افزودن شبه‌دستور (pseudo instruction) LOAD_CONST_MORTAL. (مشارکت‌شده توسط Mark Shannon در gh-128685.)

• دستور شبه‌پیش فرض LOAD_CONST_IMMORTAL اضافه شد که کاری مشابه LOAD_CONST انجام می‌دهد، اما برای اشیای نامیرا کارآمدتر است. (مشارکت توسط Mark Shannon در gh-125837.)

• افزودن شبه‌دستورالعمل NOT_TAKEN که توسط sys.monitoring برای ثبت رویدادهای انشعاب (مانند BRANCH_LEFT) استفاده می‌شود. (مشارکت‌شده توسط Mark Shannon در gh-122548.)

API پیکربندی پایتون در C¶

افزودن PyInitConfig C API برای پیکربندی مقداردهی اولیه‌ی پایتون بدون تکیه بر ساختارهای C و امکان اعمال تغییرات سازگار با ABI در آینده.

PyConfig C API مربوط به PEP 587 با افزودن PyInitConfig_AddModule() که می‌توان از آن برای افزودن یک ماژول توسعه‌ای توکار استفاده کرد، تکمیل شد؛ قابلیتی که پیش‌تر «inittab» نامیده می‌شد.

افزودن توابع PyConfig_Get() و PyConfig_Set() برای دریافت و تنظیم پیکربندی فعلی ران‌تایم.

PEP 587 «پیکربندی مقداردهی اولیه پایتون» تمام روش‌های پیکربندی مقداردهی اولیه‌ی پایتون را یکپارچه کرد. این PEP همچنین پیکربندی پیش‌مقداردهی اولیه و مقداردهی اولیه‌ی پایتون را در یک API واحد یکپارچه می‌کند. افزون بر این، این PEP برای تعبیه کردن پایتون تنها یک گزینه فراهم می‌کند، به‌جای دو گزینه‌ی «Python» و «Isolated» (PEP 587)، تا API را بیش از پیش ساده کند.

API سطح پایین‌ترِ PyConfig مربوط به PEP 587 همچنان برای موارد استفاده‌ای که به‌طور عمدی سطح بالاتری از جفت‌شدگی (coupling) با جزئیات پیاده‌سازی سی‌پایتون دارند، در دسترس است (مانند شبیه‌سازی تمامی کارکردهای رابط خط فرمان سی‌پایتون، از جمله سازوکارهای پیکربندی آن).

(مشارکت‌شده توسط Victor Stinner در gh-107954.)

ویژگی‌های جدید در API زبان C¶

• افزودن Py_PACK_VERSION() و Py_PACK_FULL_VERSION()، دو ماکروی جدید برای بسته‌بندی بیتی (bit-packing) شماره‌های نسخه پایتون. این برای مقایسه با Py_Version یا PY_VERSION_HEX مفید است. (مشارکت‌شده توسط Petr Viktorin در gh-128629.)

• افزودن تابع PyBytes_Join(sep, iterable)، مشابه sep.join(iterable) در پایتون. (با مشارکت Victor Stinner در gh-121645.)

• افزودن توابعی برای دستکاری پیکربندی مفسر پایتون فعلی در زمان اجرا (PEP 741: Python configuration C API):

  • PyConfig_Get()

  • PyConfig_GetInt()

  • PyConfig_Set()

  • PyConfig_Names()

  (مشارکت‌شده توسط Victor Stinner در gh-107954.)

• افزودن توابعی برای پیکربندی مقداردهی اولیه‌ی پایتون (PEP 741: C API برای پیکربندی پایتون):

  • Py_InitializeFromInitConfig()

  • PyInitConfig_AddModule()

  • PyInitConfig_Create()

  • PyInitConfig_Free()

  • PyInitConfig_FreeStrList()

  • PyInitConfig_GetError()

  • PyInitConfig_GetExitCode()

  • PyInitConfig_GetInt()

  • PyInitConfig_GetStr()

  • PyInitConfig_GetStrList()

  • PyInitConfig_HasOption()

  • PyInitConfig_SetInt()

  • PyInitConfig_SetStr()

  • PyInitConfig_SetStrList()

  (مشارکت‌شده توسط Victor Stinner در gh-107954.)

• تابع Py_fopen() برای باز کردن یک پرونده اضافه شد. این تابع مشابه تابع استاندارد fopen() در C کار می‌کند، با این تفاوت که یک شیء پایتون را برای پارامتر path می‌پذیرد و در صورت خطا یک استثنا تنظیم می‌کند. برای بستن یک پرونده باید از تابع جدید متناظر Py_fclose() استفاده کرد. (مشارکت‌کرده: Victor Stinner در gh-127350.)

• افزودن Py_HashBuffer() برای محاسبه و بازگرداندن مقدار هش یک بافر. (مشارکت‌شده توسط آنتوان پی‌ترو و ویکتور استینر در gh-122854.)

• افزودن توابع کمکی PyImport_ImportModuleAttr() و PyImport_ImportModuleAttrString() برای ایمپورت کردن یک ماژول و به دست آوردن یک ویژگی از ماژول. (مشارکت‌شده توسط Victor Stinner در gh-128911.)

• افزودن PyIter_NextItem() برای جایگزینی PyIter_Next()، که مقدار بازگشتی آن مبهم است. (مشارکت‌شده توسط Irit Katriel و Erlend Aasland در gh-105201.)

• تابع PyLong_GetSign() برای به‌دست‌آوردن علامت اشیاء int اضافه شد. (با مشارکت Sergey B Kirpichev در gh-116560.)

• توابع PyLong_IsPositive()، PyLong_IsNegative() و PyLong_IsZero() به ترتیب برای بررسی مثبت، منفی یا صفر بودن PyLongObject اضافه شدند. (با مشارکت James Roy و Sergey B Kirpichev در gh-126061.)

• توابع جدیدی برای تبدیل اعداد C <stdint.h> به اشیاء int پایتون و برعکس اضافه شده‌اند:

  • PyLong_AsInt32()

  • PyLong_AsInt64()

  • PyLong_AsUInt32()

  • PyLong_AsUInt64()

  • PyLong_FromInt32()

  • PyLong_FromInt64()

  • PyLong_FromUInt32()

  • PyLong_FromUInt64()

  (مشارکت‌شده توسط Victor Stinner در gh-120389.)

• افزودن API جدیدی برای ایمپورت و اکسپورت اشیاء int پایتون (PEP 757):

  • PyLong_GetNativeLayout()

  • PyLong_Export()

  • PyLong_FreeExport()

  • PyLongWriter_Create()

  • PyLongWriter_Finish()

  • PyLongWriter_Discard()

  (مشارکت‌شده توسط Sergey B Kirpichev و Victor Stinner در gh-102471.)

• افزودن PyMonitoring_FireBranchLeftEvent() و PyMonitoring_FireBranchRightEvent() برای تولید رویدادهای BRANCH_LEFT و BRANCH_RIGHT، به ترتیب. (مشارکت Mark Shannon در gh-122548.)

• افزودن تابع PyType_Freeze() برای تغییرناپذیر کردن یک نوع. (با مشارکت ویکتور استینر در gh-121654.)

• افزودن PyType_GetBaseByToken() و جایگاه Py_tp_token برای شناسایی آسان‌تر کلاس پایه، که تلاش می‌کند مشکل بررسی نوعِ اشاره‌شده در PEP 630 را حل کند. (مشارکت‌شده در gh-124153.)

• تابع جدید PyUnicode_Equal() برای بررسی برابر بودن دو رشته افزوده شد. این تابع همچنین به C API محدود افزوده شده است. (ارائه‌شده توسط ویکتور استینر در gh-124502.)

• یک API جدید PyUnicodeWriter با توابع زیر برای ایجاد یک شیء str پایتون اضافه شد:

  • PyUnicodeWriter_Create()

  • PyUnicodeWriter_DecodeUTF8Stateful()

  • PyUnicodeWriter_Discard()

  • PyUnicodeWriter_Finish()

  • PyUnicodeWriter_Format()

  • PyUnicodeWriter_WriteASCII()

  • PyUnicodeWriter_WriteChar()

  • PyUnicodeWriter_WriteRepr()

  • PyUnicodeWriter_WriteStr()

  • PyUnicodeWriter_WriteSubstring()

  • PyUnicodeWriter_WriteUCS4()

  • PyUnicodeWriter_WriteUTF8()

  • PyUnicodeWriter_WriteWideChar()

  (با مشارکت Victor Stinner در gh-119182.)

• قالب‌های k و K در PyArg_ParseTuple() و توابع مشابه، اکنون در صورت وجود از __index__() استفاده می‌کنند، مانند تمام قالب‌های عدد صحیح دیگر. (مشارکت‌شده توسط Serhiy Storchaka در gh-112068.)

• افزودن پشتیبانی از واحد قالب جدید p در Py_BuildValue() که یک شیء bool پایتون را از یک عدد صحیح C تولید می‌کند. (با مشارکت Pablo Galindo در bpo-45325.)

• تابع PyUnstable_IsImmortal() برای تعیین اینکه آیا یک شیء immortal است، به منظور اشکال‌زدایی اضافه شد. (مشارکت‌شده توسط Peter Bierma در gh-128509.)

• افزودن PyUnstable_Object_EnableDeferredRefcount() برای فعال‌سازی شمارش ارجاعِ معوق، همان‌طور که در PEP 703 تشریح شده است.

• افزودن PyUnstable_Object_IsUniquelyReferenced() به‌عنوان جایگزینی برای Py_REFCNT(op) == 1 در ساخت‌های نخ‌آزاد. (مشارکت‌شده توسط Peter Bierma در gh-133140.)

• افزودن PyUnstable_Object_IsUniqueReferencedTemporary() برای تعیین اینکه آیا یک شیء روی پشته‌ی عملوندهای مفسر، شیء موقت یکتا است یا خیر. در برخی موارد می‌توان از این تابع به‌عنوان جایگزینی برای بررسی برابر 1 بودن Py_REFCNT() برای اشیاء پایتونی که به‌عنوان آرگومان به توابع C API پاس داده می‌شوند، استفاده کرد. (مشارکت‌شده توسط Sam Gross در gh-133164.)

تغییرات API محدود C¶

• در C API محدود نسخه 3.14 و جدیدتر، Py_TYPE() و Py_REFCNT() اکنون به‌صورت یک فراخوانی تابع مات پیاده‌سازی شده‌اند تا جزئیات پیاده‌سازی پنهان شود. (با مشارکت Victor Stinner در gh-120600 و gh-124127.)

• ماکروهای PySequence_Fast_GET_SIZE، PySequence_Fast_GET_ITEM و PySequence_Fast_ITEMS از C API محدود حذف شدند، زیرا این ماکروها همیشه در C API محدود معیوب بوده‌اند. (مشارکت‌شده توسط Victor Stinner در gh-91417.)

APIهای C حذف‌شده¶

• ایجاد انواع تغییرناپذیر با کلاس‌های پایه‌ی تغییرپذیر در پایتون 3.12 منسوخ شد و اکنون TypeError ایجاد می‌کند. (مشارکت نیکیتا سوبولف در gh-119775.)

• عضو PyDictObject.ma_version_tag که در پایتون 3.12 منسوخ شده بود، حذف شد. به جای آن از API PyDict_AddWatcher() استفاده کنید. (با مشارکت Sam Gross در gh-124296.)

• تابع خصوصی _Py_InitializeMain() حذف شد. این تابع یک API آزمایشی بود که توسط PEP 587 به پایتون 3.8 افزوده شد. (مشارکت‌شده توسط Victor Stinner در gh-129033.)

• APIهای غیرمستند Py_C_RECURSION_LIMIT و PyThreadState.c_recursion_remaining حذف شدند. این APIها در 3.13 افزوده شده بودند و بدون منسوخ‌شدن حذف شدند. برای محافظت در برابر بازگشتی بی‌مهار در کد C، از Py_EnterRecursiveCall() استفاده کنید. (حذف‌شده توسط Petr Viktorin در gh-133079؛ به gh-130396 نیز مراجعه کنید.)

APIهای C منسوخ¶

• ماکروی Py_HUGE_VAL اکنون به‌طور نرم‌افزاری منسوخ شده است. به‌جای آن از INFINITY استفاده کنید. (مشارکت توسط Sergey B Kirpichev در gh-120026.)

• ماکروهای Py_IS_NAN، Py_IS_INFINITY و Py_IS_FINITE اکنون نرم‌منسوخ هستند. به‌جای آن‌ها از isnan، isinf و isfinite استفاده کنید که از C99 به بعد در math.h در دسترس هستند. (مشارکت Sergey B Kirpichev در gh-119613.)

• دنباله‌های غیرتاپل اکنون به‌عنوان آرگومان برای واحد قالب (format unit) (items) در PyArg_ParseTuple() و سایر توابع تجزیه آرگومان منسوخ شده‌اند، اگر items شامل واحدهای قالب باشد که یک بافر امانتی یا یک ارجاع امانتی ذخیره می‌کنند. (مشارکت‌شده توسط Serhiy Storchaka در gh-50333.)

• تابع _PyMonitoring_FireBranchEvent اکنون منسوخ شده است و باید با فراخوانی‌های PyMonitoring_FireBranchLeftEvent() و PyMonitoring_FireBranchRightEvent() جایگزین شود.

• تابع PySequence_In() که پیش‌تر مستند نشده بود، اکنون soft deprecated است. به‌جای آن از PySequence_Contains() استفاده کنید. (مشارکت‌شده توسط Yuki Kobayashi در gh-127896.)