PEP 695: سینتکس پارامتر نوع¶

کلاس‌ها و توابع عام در PEP 484 با استفاده از سینتکس پرگویایی اعلان می‌شدند که محدوده‌ی پارامترهای نوع را مبهم می‌گذاشت و اعلان‌های صریح وردایی را الزامی می‌کرد.

PEP 695 روشی جدید، فشرده‌تر و صریح‌تر برای ایجاد کلاس‌های عام و توابع معرفی می‌کند:

def max[T](args: Iterable[T]) -> T:
    ...

class list[T]:
    def __getitem__(self, index: int, /) -> T:
        ...

    def append(self, element: T) -> None:
        ...

علاوه بر این، PEP (پیشنهاد بهبود پایتون) روش جدیدی برای اعلام مستعارهای نوع با استفاده از دستور type معرفی می‌کند که نمونه‌ای از TypeAliasType ایجاد می‌کند:

type Point = tuple[float, float]

مستعارهای نوع همچنین می‌توانند عام باشند:

type Point[T] = tuple[T, T]

سینتکس جدید امکان تعریف پارامترهای TypeVarTuple و ParamSpec و همچنین پارامترهای TypeVar با کران‌ها یا محدودیت‌ها را فراهم می‌کند:

type IntFunc[**P] = Callable[P, int]  # ParamSpec
type LabeledTuple[*Ts] = tuple[str, *Ts]  # TypeVarTuple
type HashableSequence[T: Hashable] = Sequence[T]  # TypeVar with bound
type IntOrStrSequence[T: (int, str)] = Sequence[T]  # TypeVar with constraints

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

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

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

برای جزئیات بیشتر به PEP 695 مراجعه کنید.

(PEP توسط Eric Traut نوشته شده است. پیاده‌سازی توسط Jelle Zijlstra، Eric Traut و دیگران در gh-103764 انجام شده است.)

PEP 701: صوری‌سازی نحوی اف‌استرینگ‌ها¶

PEP 701 برخی از محدودیت‌های استفاده از اف‌استرینگ‌ها را برمی‌دارد. اجزای عبارت درون اف‌استرینگ‌ها اکنون می‌توانند هر عبارت معتبر پایتون باشند، از جمله رشته‌هایی که از همان علامت نقل‌قول اف‌استرینگ دربرگیرنده‌شان استفاده می‌کنند، عبارت‌های چندسطری، کامنت‌ها، بک‌اسلش‌ها و دنباله‌های خنثی‌سازی یونیکد. بیایید این موارد را با جزئیات بررسی کنیم:

• بازاستفاده از علامت نقل‌قول: در پایتون 3.11، استفاده مجدد از همان علامت‌های نقل‌قولی که اف‌استرینگ دربرگیرنده از آن‌ها استفاده می‌کند، یک SyntaxError ایجاد می‌کند و کاربر را مجبور می‌کند که از یکی از سایر علامت‌های نقل‌قول موجود استفاده کند (مانند استفاده از علامت نقل‌قول دوتایی یا سه‌تایی، در صورتی که اف‌استرینگ از علامت نقل‌قول تکی استفاده کند). در پایتون 3.12، اکنون می‌توانید کارهایی مانند این انجام دهید:

  >>> songs = ['Take me back to Eden', 'Alkaline', 'Ascensionism']
  >>> f"This is the playlist: {", ".join(songs)}"
  'This is the playlist: Take me back to Eden, Alkaline, Ascensionism'
  

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

  >>> f"""{f'''{f'{f"{1+1}"}'}'''}"""
  '2'
  

  از آنجا که اف‌استرینگ‌ها اکنون می‌توانند هر عبارت معتبر پایتون را درون اجزای عبارت خود دربرگیرند، اکنون می‌توان اف‌استرینگ‌ها را به‌صورت دلخواه تودرتو کرد:

  >>> f"{f"{f"{f"{f"{f"{1+1}"}"}"}"}"}"
  '2'
  

• عبارت‌ها و کامنت‌های چندسطری: در پایتون 3.11، عبارت‌های اف‌استرینگ باید در یک سطر واحد تعریف شوند، حتی اگر عبارت درون اف‌استرینگ به‌طور معمول بتواند چند سطر را در بر بگیرد (مانند فهرست‌های لفظی که در چند سطر تعریف می‌شوند)، که این امر خواندن آن‌ها را دشوارتر می‌کند. در پایتون 3.12 اکنون می‌توانید اف‌استرینگ‌هایی تعریف کنید که چند سطر را در بر می‌گیرند و کامنت‌های درون‌خطی اضافه کنید:

  >>> f"This is the playlist: {", ".join([
  ...     'Take me back to Eden',  # My, my, those eyes like fire
  ...     'Alkaline',              # Not acid nor alkaline
  ...     'Ascensionism'           # Take to the broken skies at last
  ... ])}"
  'This is the playlist: Take me back to Eden, Alkaline, Ascensionism'
  

• بک‌اسلش‌ها و نویسه‌های یونیکد: پیش از پایتون 3.12، عبارت‌های اف‌استرینگ نمی‌توانستند هیچ نویسه‌ی \ داشته باشند. این موضوع بر دنباله‌های خنثی‌سازی یونیکد (مانند \N{snowman}) نیز اثر می‌گذاشت، زیرا این دنباله‌ها شامل بخش \N هستند که پیش‌تر نمی‌توانست بخشی از اجزای عبارت اف‌استرینگ‌ها باشد. اکنون می‌توانید عبارت‌هایی مانند این تعریف کنید:

  >>> print(f"This is the playlist: {"\n".join(songs)}")
  This is the playlist: Take me back to Eden
  Alkaline
  Ascensionism
  >>> print(f"This is the playlist: {"\N{BLACK HEART SUIT}".join(songs)}")
  This is the playlist: Take me back to Eden♥Alkaline♥Ascensionism
  

برای جزئیات بیشتر به PEP 701 مراجعه کنید.

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

>>> my_string = f"{x z y}" + f"{1 + 1}"
  File "<stdin>", line 1
    (x z y)
     ^^^
SyntaxError: f-string: invalid syntax. Perhaps you forgot a comma?

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

>>> my_string = f"{x z y}" + f"{1 + 1}"
  File "<stdin>", line 1
    my_string = f"{x z y}" + f"{1 + 1}"
                   ^^^
SyntaxError: invalid syntax. Perhaps you forgot a comma?

(با مشارکت Pablo Galindo، Batuhan Taskaya، Lysandros Nikolaou، Cristián Maureira-Fredes و Marta Gómez در gh-102856. PEP نوشته‌شده توسط Pablo Galindo، Batuhan Taskaya، Lysandros Nikolaou و Marta Gómez).

PEP 684: قفل مفسر سراسری به ازای هر مفسر¶

PEP 684 یک قفل مفسر سراسری برای هر مفسر معرفی می‌کند، به‌طوری‌که اکنون می‌توان زیرمفسر‌ها را با یک قفل مفسر سراسری یکتا برای هر مفسر ایجاد کرد. این امر به برنامه‌های پایتون اجازه می‌دهد که به‌طور کامل از چندین هسته‌ی CPU بهره ببرند. این قابلیت در حال حاضر فقط از طریق C-API در دسترس است، هرچند یک API پایتونی برای 3.13 پیش‌بینی شده است.

برای ایجاد مفسری با قفل مفسر سراسری مخصوص به خود، از تابع جدید Py_NewInterpreterFromConfig() استفاده کنید:

PyInterpreterConfig config = {
    .check_multi_interp_extensions = 1,
    .gil = PyInterpreterConfig_OWN_GIL,
};
PyThreadState *tstate = NULL;
PyStatus status = Py_NewInterpreterFromConfig(&tstate, &config);
if (PyStatus_Exception(status)) {
    return -1;
}
/* مفسر جدید اکنون در نخ فعلی فعال است. */

برای مثال‌های بیشتر درباره‌ی نحوه‌ی استفاده از C-API برای زیرمفسر‌ها با قفل مفسر سراسری (GIL) اختصاصی هر مفسر، به Modules/_xxsubinterpretersmodule.c مراجعه کنید.

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

PEP 669: نظارت کم‌تأثیر برای سی‌پایتون¶

PEP 669 یک API جدید تعریف می‌کند که به پروفایل‌گیرها، اشکال‌زداها و دیگر ابزارها امکان می‌دهد رویدادها را در سی‌پایتون پایش کنند. این API طیف گسترده‌ای از رویدادها را در بر می‌گیرد، از جمله فراخوانی‌ها، بازگشت‌ها، سطرها، استثناها، پرش‌ها و موارد دیگر. این بدان معناست که فقط بابت آنچه استفاده می‌کنید هزینه می‌پردازید و همین امر پشتیبانی از اشکال‌زداها و ابزارهای پوشش با سربار نزدیک به صفر را فراهم می‌کند. برای جزئیات به sys.monitoring مراجعه کنید.

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

PEP 688: دسترس‌پذیر کردن پروتکل بافر در پایتون¶

PEP 688 راهی برای استفاده از پروتکل بافر در کد پایتون معرفی می‌کند. کلاس‌هایی که متد __buffer__() را پیاده‌سازی می‌کنند، اکنون به‌عنوان نوع‌های بافر قابل استفاده‌اند.

کلاس پایه انتزاعی جدید collections.abc.Buffer راهی استاندارد برای بازنمایی اشیاء بافر فراهم می‌کند، برای مثال در حاشیه‌نویسی نوع. enum جدید inspect.BufferFlags پرچم‌هایی را نمایش می‌دهد که می‌توان از آن‌ها برای سفارشی‌سازی ایجاد بافر استفاده کرد. (ارائه‌شده توسط Jelle Zijlstra در gh-102500.)

PEP 709: درون‌خطی‌سازی درک‌ها¶

درک‌های دیکشنری، فهرست و مجموعه اکنون به‌صورت درون‌خطی (inlined) درمی‌آیند، به‌جای آنکه برای هر اجرای درک، یک شیء تابع جدید یک‌بارمصرف ساخته شود. این امر سرعت اجرای یک درک را تا دو برابر افزایش می‌دهد. برای جزئیات بیشتر به PEP 709 مراجعه کنید.

متغیرهای پیمایش درک مجزا باقی می‌مانند؛ متغیری با همان نام در محدوده بیرونی را بازنویسی نمی‌کنند و پس از درک نیز قابل مشاهده نیستند. درون‌خطی‌سازی چند تغییر رفتاری قابل مشاهده به همراه دارد:

• دیگر در ردگیری‌ها فریم جداگانه‌ای برای درک وجود ندارد، و ردگیری/پروفایل‌گیری دیگر درک را به‌عنوان فراخوانی تابع نشان نمی‌دهد.

• ماژول symtable دیگر برای هر درک، جدول‌های نماد فرزند تولید نخواهد کرد؛ در عوض، متغیرهای محلی درک در جدول نماد تابع والد گنجانده خواهند شد.

• فراخوانی locals() درون یک درک اکنون متغیرهای بیرون از درک را شامل می‌شود و دیگر متغیر مصنوعی .0 برای «آرگومان» درک را شامل نمی‌شود.

• درکی که مستقیماً روی locals() پیمایش می‌کند (مثلاً [k for k in locals()]) ممکن است هنگامی که تحت ردیابی اجرا شود (مثلاً اندازه‌گیری پوشش کد) با خطای "RuntimeError: dictionary changed size during iteration" روبه‌رو شود. این همان رفتاری است که از قبل در مواردی مانند for k in locals(): دیده می‌شود. برای پرهیز از این خطا، ابتدا فهرستی از کلیدها برای پیمایش ایجاد کنید: keys = list(locals()); [k for k in keys].

(مشارکت‌شده توسط Carl Meyer و Vladimir Matveev در PEP 709.)

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

• اکنون هنگامی که NameError به بالاترین سطح پرتاب می‌شود، ممکن است ماژول‌های کتابخانه استاندارد به‌عنوان بخشی از پیام‌های خطایی که مفسر نمایش می‌دهد پیشنهاد شوند. (مشارکت‌شده توسط Pablo Galindo در gh-98254.)

  >>> sys.version_info
  Traceback (most recent call last):
    File "<stdin>", line 1, in <module>
  NameError: name 'sys' is not defined. Did you forget to import 'sys'?
  

• پیشنهاد خطا در استثناهای NameError برای نمونه‌ها بهبود یافت. اکنون اگر یک NameError در یک متد مطرح شود و نمونه ویژگی‌ای داشته باشد که دقیقاً برابر با نام موجود در استثنا باشد، پیشنهاد به‌جای نزدیک‌ترین تطابق در محدوده متد، شامل self.<NAME> خواهد بود. (مشارکت‌شده توسط Pablo Galindo در gh-99139.)

  >>> class A:
  ...    def __init__(self):
  ...        self.blech = 1
  ...
  ...    def foo(self):
  ...        somethin = blech
  ...
  >>> A().foo()
  Traceback (most recent call last):
    File "<stdin>", line 1
      somethin = blech
                 ^^^^^
  NameError: name 'blech' is not defined. Did you mean: 'self.blech'?
  

• پیام خطای SyntaxError هنگامی که کاربر به‌جای from y import x عبارت import x from y را تایپ می‌کند، بهبود یافت. (مشارکت‌شده توسط پابلو گالیندو در gh-98931.)

  >>> import a.y.z from b.y.z
  Traceback (most recent call last):
    File "<stdin>", line 1
      import a.y.z from b.y.z
      ^^^^^^^^^^^^^^^^^^^^^^^
  SyntaxError: Did you mean to use 'from ... import ...' instead?
  

• استثناهای ImportError که از دستورهای ناموفق from <module> import <name> ایجاد می‌شوند، اکنون بر اساس نام‌های موجود در <module> پیشنهادهایی برای مقدار <name> در بر می‌گیرند. (مشارکت‌شده توسط پابلو گالیندو در gh-91058.)

  >>> from collections import chainmap
  Traceback (most recent call last):
    File "<stdin>", line 1, in <module>
  ImportError: cannot import name 'chainmap' from 'collections'. Did you mean: 'ChainMap'?
  

PEP 692: استفاده از TypedDict برای نوع‌دهی دقیق‌تر **kwargs¶

حاشیه‌نویسی **kwargs در امضای تابع، آن‌گونه که در PEP 484 معرفی شد، تنها در مواردی که همه‌ی **kwargs از یک نوع بودند، امکان حاشیه‌نویسی معتبر را فراهم می‌کرد.

PEP 692 با اتکا به دیکشنری‌های نوع‌دار، راه دقیق‌تری برای نوع‌دهی **kwargs مشخص می‌کند:

from typing import TypedDict, Unpack

class Movie(TypedDict):
  name: str
  year: int

def foo(**kwargs: Unpack[Movie]): ...

برای جزئیات بیشتر به PEP 692 مراجعه کنید.

(با مشارکت Franek Magiera در gh-103629.)

PEP 698: دکوراتور بازنویسی برای نوع‌دهی ایستا¶

دکوراتور جدید @typing.override به ماژول typing اضافه شده است. این دکوراتور به بررسی‌گرهای نوع نشان می‌دهد که این متد برای بازنویسی متدی در یک کلاس والد در نظر گرفته شده است. این امر به بررسی‌گرهای نوع امکان می‌دهد تا اشتباهاتی را شناسایی کنند که در آن‌ها متدی که قرار است چیزی در یک کلاس پایه را بازنویسی کند، در واقع چنین نمی‌کند.

مثال:

from typing import override

class Base:
  def get_color(self) -> str:
    return "blue"

class GoodChild(Base):
  @override  # ok: overrides Base.get_color
  def get_color(self) -> str:
    return "yellow"

class BadChild(Base):
  @override  # type checker error: does not override Base.get_color
  def get_colour(self) -> str:
    return "red"

برای جزئیات بیشتر به PEP 698 مراجعه کنید.

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

array¶

• کلاس array.array اکنون از زیرنویسی پشتیبانی می‌کند و این آن را به یک نوع عام تبدیل می‌کند. (مشارکت‌شده توسط Jelle Zijlstra در gh-98658.)

asyncio¶

• کارایی نوشتن در سوکت‌ها در asyncio به‌طور چشمگیری بهبود یافته است. asyncio اکنون هنگام نوشتن در سوکت‌ها از کپی‌کردن غیرضروری پرهیز می‌کند و در صورتی که پلتفرم از آن پشتیبانی کند، از sendmsg() استفاده می‌کند. (مشارکت Kumar Aditya در gh-91166.)

• توابع asyncio.eager_task_factory() و asyncio.create_eager_task_factory() اضافه شدند تا امکان فعال‌سازی اجرای فوری (eager) وظیفه‌ها در حلقه رویداد فراهم شود و برخی موارد استفاده ۲ تا ۵ برابر سریع‌تر شوند. (ارائه‌شده توسط Jacob Bower و Itamar Oren در gh-102853، gh-104140 و gh-104138)

• در لینوکس، asyncio در صورتی که os.pidfd_open() در دسترس و کارا باشد، به‌طور پیش‌فرض به‌جای asyncio.ThreadedChildWatcher از asyncio.PidfdChildWatcher استفاده می‌کند. (با مشارکت Kumar Aditya در gh-98024.)

• حلقه رویداد اکنون از بهترین پایشگر فرزند (child watcher) موجود برای هر پلتفرم استفاده می‌کند (asyncio.PidfdChildWatcher در صورت پشتیبانی و در غیر این صورت asyncio.ThreadedChildWatcher)، بنابراین پیکربندی دستی پایشگر فرزند توصیه نمی‌شود. (مشارکت‌شده توسط Kumar Aditya در gh-94597.)

• پارامتر loop_factory به asyncio.run() اضافه شد تا بتوان یک کارخانه‌ی سفارشی حلقه رویداد را مشخص کرد. (مشارکت Kumar Aditya در gh-99388.)

• افزودن پیاده‌سازی C برای asyncio.current_task() با افزایش سرعت ۴ تا ۶ برابری. (مشارکت توسط Itamar Oren و Pranav Thulasiram Bhat در gh-100344.)

• asyncio.iscoroutine() اکنون برای تولیدگرها False برمی‌گرداند، زیرا asyncio از هم‌روال‌های قدیمی مبتنی بر تولیدگر پشتیبانی نمی‌کند. (مشارکت‌شده توسط Kumar Aditya در gh-102748.)

• asyncio.wait() و asyncio.as_completed() اکنون تولیدگرهایی که وظیفه تولید می‌کنند را می‌پذیرند. (مشارکت Kumar Aditya در gh-78530.)

calendar¶

• enum‌های calendar.Month و calendar.Day که ماه‌های سال و روزهای هفته را تعریف می‌کنند، اضافه شدند. (مشارکت‌شده توسط Prince Roshan در gh-103636.)

csv¶

• پرچم‌های csv.QUOTE_NOTNULL و csv.QUOTE_STRINGS افزوده شدند تا کنترل دقیق‌تری بر None و رشته‌های خالی توسط اشیاء reader و writer فراهم کنند.

dis¶

• کدهای عمل شبه‌دستور (که توسط کامپایلر استفاده می‌شوند، اما در بایت‌کد اجرایی ظاهر نمی‌شوند) اکنون در ماژول dis در معرض نمایش قرار گرفته‌اند. HAVE_ARGUMENT همچنان برای کدهای عمل واقعی مرتبط است، اما برای شبه‌دستورها مفید نیست. به‌جای آن از مجموعه‌ی جدید dis.hasarg استفاده کنید. (مشارکت‌شده توسط Irit Katriel در gh-94216.)

• افزودن مجموعه‌ی dis.hasexc برای نشان دادن دستورالعمل‌هایی که هندلر استثنا را تنظیم می‌کنند. (مشارکت‌شده توسط Irit Katriel در gh-94216.)

fractions¶

• اشیاء از نوع fractions.Fraction اکنون از قالب‌بندی به سبک اعشاری پشتیبانی می‌کنند. (مشارکت‌شده توسط Mark Dickinson در gh-100161.)

importlib.resources¶

• importlib.resources.as_file() اکنون از پوشه‌های منبع پشتیبانی می‌کند. (مشارکت‌شده توسط Jason R. Coombs در gh-97930.)

• نام پارامتر اول importlib.resources.files() به anchor تغییر کرد. (مشارکت Jason R. Coombs در gh-100598.)

inspect¶

• افزودن inspect.markcoroutinefunction() برای علامت‌گذاری توابع همگامی که یک هم‌روال برمی‌گردانند تا با inspect.iscoroutinefunction() استفاده شوند. (مشارکت‌شده توسط کارلتون گیبسون در gh-99247.)

• افزودن inspect.getasyncgenstate() و inspect.getasyncgenlocals() برای تعیین وضعیت فعلی تولیدگرهای ناهمگام. (مشارکت توسط Thomas Krennwallner در gh-79940.)

• کارایی inspect.getattr_static() به‌طور قابل‌توجهی بهبود یافته است. بیشتر فراخوانی‌های این تابع باید حداقل ۲ برابر سریع‌تر از پایتون 3.11 باشند. (مشارکت Alex Waygood در gh-103193.)

itertools¶

• افزودن itertools.batched() برای جمع‌آوری در تاپل‌های هم‌اندازه که در آن آخرین دسته ممکن است کوتاه‌تر از بقیه باشد. (مشارکت‌شده توسط Raymond Hettinger در gh-98363.)

math¶

• افزودن math.sumprod() برای محاسبه‌ی مجموع حاصل‌ضرب‌ها. (مشارکت‌شده توسط Raymond Hettinger در gh-100485.)

• تابع math.nextafter() توسعه یافت تا شامل آرگومان steps برای حرکت به بالا یا پایین چندین گام در هر بار شود. (مشارکت Matthias Goergens، Mark Dickinson و Raymond Hettinger در gh-94906.)

os¶

• ثابت os.PIDFD_NONBLOCK افزوده شد تا بتوان با استفاده از os.pidfd_open() توصیف‌گر پرونده‌ای را برای یک فرایند در حالت غیرمسدود باز کرد. (مشارکت‌شده توسط Kumar Aditya در gh-93312.)

• os.DirEntry اکنون شامل متد os.DirEntry.is_junction() برای بررسی اتصال بودن ورودی است. (مشارکت‌شده توسط Charles Machalow در gh-99547.)

• افزودن توابع os.listdrives()، os.listvolumes() و os.listmounts() در ویندوز برای شمارش درایوها، حجم‌ها و نقاط اتصال. (مشارکت‌شده توسط Steve Dower در gh-102519.)

• os.stat() و os.lstat() اکنون در ویندوز دقیق‌تر هستند. فیلد st_birthtime اکنون با زمان ایجاد پرونده پر می‌شود، و st_ctime منسوخ شده است اما همچنان شامل زمان ایجاد است (اما در آینده، برای سازگاری با سکوهای دیگر، آخرین تغییر فراداده را بازخواهد گرداند). بسته به سامانه فایل‌بندی شما، st_dev ممکن است تا ۶۴ بیت و st_ino تا ۱۲۸ بیت باشد، و st_rdev همیشه به‌جای مقادیر نادرست، روی صفر تنظیم می‌شود. هر دو تابع ممکن است در نسخه‌های جدیدتر ویندوز به‌طور قابل‌توجهی سریع‌تر باشند. (مشارکت‌شده توسط Steve Dower در gh-99726.)

os.path¶

• تابع os.path.isjunction() برای بررسی اینکه آیا یک مسیر داده‌شده اتصال است یا خیر، افزوده شد. (مشارکت‌شده توسط Charles Machalow در gh-99547.)

• تابع os.path.splitroot() برای تجزیه‌ی یک مسیر به سه‌تایی (drive, root, tail) افزوده شد. (مشارکت‌شده توسط Barney Gale در gh-101000.)

pathlib¶

• افزودن پشتیبانی از زیرکلاس‌سازی pathlib.PurePath و pathlib.Path، به‌همراه گونه‌های مخصوص Posix و Windows آن‌ها. زیرکلاس‌ها می‌توانند متد pathlib.PurePath.with_segments() را بازنویسی کنند تا اطلاعات را بین نمونه‌های مسیر منتقل کنند.

• افزودن pathlib.Path.walk() برای پیمایش درخت‌های پوشه و تولید تمام نام‌های پرونده یا پوشه درون آن‌ها، مشابه os.walk(). (مشارکت‌شده توسط Stanislav Zmiev در gh-90385.)

• افزودن پارامتر اختیاری walk_up به pathlib.PurePath.relative_to() برای اجازه‌دادن به درج ورودی‌های .. در نتیجه؛ این رفتار با os.path.relpath() سازگاری بیشتری دارد. (مشارکت‌شده توسط Domenico Ragusa در gh-84538.)

• افزودن pathlib.Path.is_junction() به‌عنوان پراکسی برای os.path.isjunction(). (مشارکت Charles Machalow در gh-99547.)

• افزودن پارامتر اختیاری case_sensitive به pathlib.Path.glob()، pathlib.Path.rglob() و pathlib.PurePath.match() برای تطبیق بر اساس حساسیت به بزرگی و کوچکی حروف مسیر، که امکان کنترل دقیق‌تری بر فرایند تطبیق را فراهم می‌کند.

platform¶

• پشتیبانی از تشخیص ویندوز ۱۱ و نسخه‌های ویندوز سرور پس از ۲۰۱۲ اضافه شد. پیش‌تر، جستجوها روی پلتفرم‌های ویندوز سرور جدیدتر از ویندوز سرور ۲۰۱۲ و روی ویندوز ۱۱ مقدار Windows-10 را برمی‌گرداندند. (مشارکت استیو داور در gh-89545.)

pdb¶

• افزودن متغیرهای کمکی (convenience variables) برای نگه‌داری موقت مقادیر در طول نشست اشکال‌زدایی و فراهم‌کردن دسترسی سریع به مقادیری مانند فریم فعلی یا مقدار بازگشتی. (مشارکت‌شده توسط Tian Gao در gh-103693.)

random¶

• افزودن random.binomialvariate(). (با مشارکت Raymond Hettinger در gh-81620.)

• افزودن مقدار پیش‌فرض lambd=1.0 به random.expovariate(). (مشارکت‌شده توسط Raymond Hettinger در gh-100234.)

shutil¶

• shutil.make_archive() اکنون آرگومان root_dir را به آرشیوکننده‌های سفارشی‌ای که از آن پشتیبانی می‌کنند، ارسال می‌کند. در این حالت، این تابع برای انجام آرشیو، دیگر پوشه‌ی کاری جاری فرایند را به‌طور موقت به root_dir تغییر نمی‌دهد. (مشارکت Serhiy Storchaka در gh-74696.)

• shutil.rmtree() اکنون آرگومان جدید onexc را می‌پذیرد که هندلر خطایی مانند onerror است، اما به‌جای سه‌تایی (typ, val, tb) یک نمونه از استثنا را انتظار دارد. onerror منسوخ شده است. (مشارکت‌شده توسط ایریت کاتریل در gh-102828.)

• shutil.which() اکنون در ویندوز، حتی وقتی cmd داده‌شده شامل جزء پوشه است، برای یافتن تطبیق‌ها درون PATH به متغیر محیطی PATHEXT مراجعه می‌کند. (مشارکت‌شده توسط Charles Machalow در gh-103179.)

  shutil.which() هنگام جستجوی پرونده‌های اجرایی در ویندوز، NeedCurrentDirectoryForExePathW را فراخوانی می‌کند تا تعیین کند که آیا پوشه‌ی کاری جاری باید به ابتدای مسیر جستجو افزوده شود یا خیر. (مشارکت‌شده توسط Charles Machalow در gh-103179.)

  در ویندوز، shutil.which() پیش از تطبیق مستقیم در جای دیگر از مسیر جستجو، مسیری مطابق با cmd به‌همراه جزئی از PATHEXT را برمی‌گرداند. (مشارکت‌شده توسط Charles Machalow در gh-103179.)

sqlite3¶

• افزودن رابط خط فرمان. (مشارکت‌شده توسط Erlend E. Aasland در gh-77617.)

• ویژگی sqlite3.Connection.autocommit به sqlite3.Connection و پارامتر autocommit به sqlite3.connect() اضافه شدند تا مدیریت تراکنش سازگار با PEP 249 را کنترل کنند. (مشارکت‌شده توسط Erlend E. Aasland در gh-83638.)

• پارامتر فقط‌کلیدواژه‌ای entrypoint به sqlite3.Connection.load_extension() افزوده شد تا بتوان نقطه ورود افزونه SQLite را بازتعریف کرد. (مشارکت‌شده توسط Erlend E. Aasland در gh-103015.)

• متدهای sqlite3.Connection.getconfig() و sqlite3.Connection.setconfig() به sqlite3.Connection افزوده شدند تا بتوان تغییرات پیکربندی را روی یک اتصال پایگاه داده اعمال کرد. (مشارکت‌شده توسط Erlend E. Aasland در gh-103489.)

statistics¶

• تابع statistics.correlation() گسترش یافت تا روش ranked را برای محاسبه‌ی همبستگی اسپیرمن داده‌های رتبه‌بندی‌شده در بر بگیرد. (با مشارکت Raymond Hettinger در gh-95861.)

sys¶

• فضای نام sys.monitoring برای در دسترس قرار دادن API جدید پایش PEP 669 افزوده شد. (با مشارکت Mark Shannon در gh-103082.)

• افزودن sys.activate_stack_trampoline() و sys.deactivate_stack_trampoline() برای فعال کردن و غیرفعال کردن ترامپولین‌های پروفایل‌گیر پشته، و sys.is_stack_trampoline_active() برای پرس‌وجو درباره‌ی فعال بودن ترامپولین‌های پروفایل‌گیر پشته. (مشارکت‌شده توسط Pablo Galindo و Christian Heimes همراه با مشارکت Gregory P. Smith [Google] و Mark Shannon در gh-96123.)

• افزودن sys.last_exc که آخرین استثنای مدیریت‌نشده‌ی مطرح‌شده را نگه می‌دارد (برای موارد استفاده از اشکال‌زدایی پس از خاتمه). منسوخ کردن سه فیلدی که همان اطلاعات را به شکل قدیمی خود دارند: sys.last_type، sys.last_value و sys.last_traceback. (مشارکت‌شده توسط Irit Katriel در gh-102778.)

• sys._current_exceptions() اکنون نگاشتی از شناسه‌ی نخ به نمونه‌ای از استثنا برمی‌گرداند، نه به تاپل (typ, exc, tb). (مشارکت Irit Katriel در gh-103176.)

• sys.setrecursionlimit() و sys.getrecursionlimit(). حد بازگشتی اکنون فقط به کد پایتون اعمال می‌شود. توابع توکار از حد بازگشتی استفاده نمی‌کنند، اما توسط سازوکاری متفاوت محافظت می‌شوند که از فروپاشی ماشین مجازی در اثر بازگشتی جلوگیری می‌کند.

tempfile¶

• تابع tempfile.NamedTemporaryFile دارای پارامتر اختیاری جدید delete_on_close است (مشارکت Evgeny Zorin در gh-58451.)

• tempfile.mkdtemp() اکنون همیشه یک مسیر مطلق برمی‌گرداند، حتی اگر آرگومان ارائه‌شده به پارامتر dir یک مسیر نسبی باشد.

threading¶

• افزودن threading.settrace_all_threads() و threading.setprofile_all_threads() که اجازه می‌دهند توابع ردگیری و پروفایل‌گیری در همه‌ی نخ‌های در حال اجرا، علاوه بر نخ فراخواننده، تنظیم شوند. (مشارکت Pablo Galindo در gh-93503.)

tkinter¶

• tkinter.Canvas.coords() اکنون آرگومان‌های خود را تخت‌سازی می‌کند. این متد اکنون نه‌تنها مختصات را به‌صورت آرگومان‌های جداگانه (x1, y1, x2, y2, ...) و به‌صورت دنباله‌ای از مختصات ([x1, y1, x2, y2, ...]) می‌پذیرد، بلکه مختصات گروه‌بندی‌شده به شکل جفت‌ها ((x1, y1), (x2, y2), ... و [(x1, y1), (x2, y2), ...]) را نیز می‌پذیرد، مانند متدهای create_*(). (مشارکت‌شده توسط Serhiy Storchaka در gh-94473.)

tokenize¶

• ماژول tokenize شامل تغییرات معرفی‌شده در PEP 701 است. (مشارکت‌شده توسط Marta Gómez Macías و Pablo Galindo در gh-102856.) برای اطلاعات بیشتر درباره‌ی تغییرات ماژول tokenize، به انتقال به پایتون 3.12 مراجعه کنید.

types¶

• افزودن types.get_original_bases() برای فراهم کردن امکان درون‌نگری بیشتر در انواع عام تعریف‌شده توسط کاربر زمانی که از آن‌ها زیرکلاس‌سازی شود. (مشارکت‌شده توسط James Hilton-Balfe و Alex Waygood در gh-101827.)

typing¶

• بررسی‌های isinstance() نسبت به پروتکل‌های بررسی‌پذیر در زمان اجرا اکنون برای یافتن اینکه آیا ویژگی‌ها وجود دارند یا خیر، به‌جای hasattr() از inspect.getattr_static() استفاده می‌کنند. این بدان معناست که توصیف‌گرها و متدهای __getattr__() دیگر به‌طور غیرمنتظره در طول بررسی‌های isinstance() نسبت به پروتکل‌های بررسی‌پذیر در زمان اجرا ارزیابی نمی‌شوند. با این حال، این ممکن است بدان معنا نیز باشد که برخی اشیایی که پیش‌تر نمونه‌هایی از یک پروتکل بررسی‌پذیر در زمان اجرا در نظر گرفته می‌شدند، در پایتون 3.12+ ممکن است دیگر نمونه‌هایی از آن پروتکل در نظر گرفته نشوند، و برعکس. بعید است که بیشتر کاربران تحت تأثیر این تغییر قرار بگیرند. (مشارکت‌شده توسط Alex Waygood در gh-102433.)

• اعضای یک پروتکل بررسی‌پذیر در ران‌تایم، اکنون به محض اینکه کلاس ایجاد شود، در ران‌تایم «فریزشده» در نظر گرفته می‌شوند. مانکی‌پچ کردن ویژگی‌ها روی یک پروتکل بررسی‌پذیر در ران‌تایم همچنان کار خواهد کرد، اما هیچ تأثیری بر بررسی‌های isinstance() که اشیاء را با پروتکل مقایسه می‌کنند نخواهد داشت. برای مثال:

  >>> from typing import Protocol, runtime_checkable
  >>> @runtime_checkable
  ... class HasX(Protocol):
  ...     x = 1
  ...
  >>> class Foo: ...
  ...
  >>> f = Foo()
  >>> isinstance(f, HasX)
  False
  >>> f.x = 1
  >>> isinstance(f, HasX)
  True
  >>> HasX.y = 2
  >>> isinstance(f, HasX)  # unchanged, even though HasX now also has a "y" attribute
  True
  

  این تغییر به‌منظور سرعت بخشیدن به بررسی‌های isinstance() روی پروتکل‌های بررسی‌پذیر در زمان اجرا انجام شد.

• پروفایل کارایی بررسی‌های isinstance() با پروتکل‌های قابل بررسی در زمان اجرا به‌طور قابل توجهی تغییر کرده است. بیشتر بررسی‌های isinstance() با پروتکل‌هایی که تنها چند عضو دارند، باید دست‌کم ۲ برابر سریع‌تر از 3.11 باشند و برخی ممکن است ۲۰ برابر سریع‌تر یا بیشتر باشند. با این حال، بررسی‌های isinstance() با پروتکل‌هایی که اعضای زیادی دارند، ممکن است نسبت به پایتون 3.11 کندتر باشند. (مشارکت‌شده توسط Alex Waygood در gh-74690 و gh-103193.)

• تمام کلاس‌های typing.TypedDict و typing.NamedTuple اکنون دارای ویژگی __orig_bases__ هستند. (ارائه‌شده توسط آدریان گارسیا باداراکو در gh-103699.)

• افزودن پارامتر frozen_default به @typing.dataclass_transform. (ارائه‌شده توسط Erik De Bonte در gh-99957.)

unicodedata¶

• پایگاه داده یونیکد به نسخه‌ی 15.0.0 به‌روزرسانی شده است. (با مشارکت Benjamin Peterson در gh-96734).

unittest¶

افزودن گزینه‌ی خط فرمان --durations که N مورد از کندترین موارد آزمون را نشان می‌دهد:

python3 -m unittest --durations=3 lib.tests.test_threading
.....
Slowest test durations
----------------------------------------------------------------------
1.210s     test_timeout (Lib.test.test_threading.BarrierTests)
1.003s     test_default_timeout (Lib.test.test_threading.BarrierTests)
0.518s     test_timeout (Lib.test.test_threading.EventTests)

(0.000 durations hidden.  Use -v to show these durations.)
----------------------------------------------------------------------
Ran 158 tests in 9.869s

OK (skipped=3)

(مشارکت‌شده توسط Giampaolo Rodola در gh-48330)

uuid¶

• یک رابط خط فرمان افزوده شد. (مشارکت‌شده توسط Adam Chhina در gh-88597.)

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

ماژول‌ها (نگاه کنید به PEP 594):

• aifc

• audioop

• cgi

• cgitb

• chunk

• crypt

• imghdr

• mailcap

• msilib

• nis

• nntplib

• ossaudiodev

• pipes

• sndhdr

• spwd

• sunau

• telnetlib

• uu

• xdrlib

ماژول‌های دیگر:

• lib2to3 و برنامه‌ی 2to3 (gh-84540)

API‌ها:

• configparser.LegacyInterpolation (gh-90765)

• locale.resetlocale() (gh-90817)

• turtle.RawTurtle.settiltangle() (gh-50096)

• unittest.findTestCases() (gh-50096)

• unittest.getTestCaseNames() (gh-50096)

• unittest.makeSuite() (gh-50096)

• unittest.TestProgram.usageExit() (gh-67048)

• webbrowser.MacOSX (gh-86421)

• زنجیره‌سازی توصیف‌گر classmethod (gh-89519)

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

• argparse: پارامترهای type، choices و metavar در argparse.BooleanOptionalAction منسوخ شده‌اند و در نسخه‌ی 3.14 حذف خواهند شد. (مشارکت Nikita Sobolev در gh-92248.)

• ast: ویژگی‌های زیر از زمان پایتون 3.8 در مستندات منسوخ اعلام شده‌اند، اکنون هنگامی که به آن‌ها دسترسی پیدا شود یا از آن‌ها استفاده شود، در زمان اجرا موجب صدور DeprecationWarning می‌شوند و در پایتون 3.14 حذف خواهند شد:

  • ast.Num

  • ast.Str

  • ast.Bytes

  • ast.NameConstant

  • ast.Ellipsis

  به‌جای آن از ast.Constant استفاده کنید. (مشارکت‌شده توسط Serhiy Storchaka در gh-90953.)

• asyncio:

  • کلاس‌های پایشگر فرزند (child watcher) asyncio.MultiLoopChildWatcher، asyncio.FastChildWatcher، asyncio.AbstractChildWatcher و asyncio.SafeChildWatcher منسوخ شده‌اند و در پایتون 3.14 حذف خواهند شد. (با مشارکت Kumar Aditya در gh-94597.)

  • asyncio.set_child_watcher()، asyncio.get_child_watcher()، asyncio.AbstractEventLoopPolicy.set_child_watcher() و asyncio.AbstractEventLoopPolicy.get_child_watcher() منسوخ شده‌اند و در پایتون 3.14 حذف خواهند شد. (مشارکت‌شده توسط Kumar Aditya در gh-94597.)

  • متد get_event_loop() سیاست حلقه رویداد پیش‌فرض اکنون در صورتی که هیچ حلقه رویداد جاری‌ای تنظیم‌نشده باشد و تصمیم بگیرد یکی ایجاد کند، هشدار DeprecationWarning منتشر می‌کند. (مشارکت Serhiy Storchaka و Guido van Rossum در gh-100160.)

• email: پارامتر isdst در email.utils.localtime() منسوخ شد. (مشارکت‌شده توسط Alan Williams در gh-72346.)

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

  • importlib.abc.ResourceReader

  • importlib.abc.Traversable

  • importlib.abc.TraversableResources

  به‌جای آن از کلاس‌های importlib.resources.abc استفاده کنید:

  • importlib.resources.abc.Traversable

  • importlib.resources.abc.TraversableResources

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

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

• multiprocessing: روش آغاز پیش‌فرض در لینوکس، BSD‌ها و سایر پلتفرم‌های POSIX غیر از macOS که در حال حاضر 'fork' پیش‌فرض آن‌هاست، به روشی امن‌تر تغییر خواهد کرد (gh-84559). افزودن هشدار زمان اجرا درباره‌ی این موضوع بیش از حد مخل تلقی شد، زیرا انتظار نمی‌رود اکثر کدها به آن اهمیت بدهند. از API‌های get_context() یا set_start_method() استفاده کنید تا به‌صراحت مشخص کنید که چه زمانی کد شما نیازمند 'fork' است. به زمینه‌ها و متدهای شروع مراجعه کنید.

• pathlib: is_relative_to() و relative_to(): گذاشتن آرگومان‌های اضافی منسوخ شده است.

• pkgutil: pkgutil.find_loader() و pkgutil.get_loader() اکنون DeprecationWarning را مطرح می‌کنند؛ به‌جای آن از importlib.util.find_spec() استفاده کنید. (مشارکت‌شده توسط نیکیتا سوبولف در gh-97850.)

• pty:

  • master_open(): از pty.openpty() استفاده کنید.

  • slave_open(): از pty.openpty() استفاده کنید.

• sqlite3:

  • version و version_info.

  • execute() و executemany() اگر از جای‌نگهدارهای نام‌دار استفاده شود و parameters دنباله‌ای به جای یک dict باشد.

• urllib: urllib.parse.Quoter منسوخ شده است: قرار نبود که این کلاس یک API عمومی باشد. (مشارکت‌شده توسط Gregory P. Smith در gh-88168.)

در انتظار حذف در پایتون 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 منسوخ شده است. به جای آن از سینتکس مبتنی بر کلاس یا سینتکس تابعی استفاده کنید.

  • هنگام استفاده از سینتکس تابعی TypedDicts، ارسال‌نکردن مقدار به پارامتر 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، هنوز توسط هیچ بررسی‌کننده نوع (type checker) مهمی پشتیبانی نمی‌شود.

• ماژول‌های 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() استفاده کنید. (مشارکت‌شده توسط جیاهاو لی و کومار آدیتیا در 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() با '.' شروع می‌شوند یا خالی هستند. پسوندهای بدون نقطه منسوخ شده‌اند و در پایتون 3.16 یک ValueError ایجاد خواهند کرد. (با مشارکت هوگو ون کمِناده در 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 منسوخ شده است.

در انتظار حذف در Python 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:

  • ارسال نام‌های کدگذاری (encoding) غیر اسکی به 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.)

در نوبت حذف در پایتون ۳.۱۹¶

• ctypes:

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

• hashlib:

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

    پشتیبانی از نام آرگومان کلیدواژه‌ای 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() دکور نشده‌اند اما از یک کلاس پروتکل قابل‌بررسی در ران‌تایم ارث‌بری می‌کنند، منسوخ شده است. این کار در پایتون ۳.۲۰ یک 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() به دلیل داشتن نام و ماژول گمراه‌کننده در حال منسوخ شدن است. این تابع با وجود اینکه در ماژولی مربوط به دستکاری مسیر قرار دارد، برای پیشوندهای مسیر ناامن است، به این معنی که با استفاده از این تابع به راحتی می‌توان آسیب‌پذیری‌های پیمایش مسیر را به طور تصادفی وارد برنامه‌های پایتون کرد.

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

• re: اکنون قواعد سخت‌گیرانه‌تری برای ارجاع‌های عددی گروه و نام‌های گروه در عبارات باقاعده اعمال می‌شوند. از این پس فقط دنباله‌ای از ارقام اسکی به‌عنوان ارجاع عددی پذیرفته می‌شود. نام گروه در الگوهای bytes و رشته‌های جایگزینی اکنون فقط می‌تواند شامل حروف و ارقام اسکی و خط زیر باشد. (مشارکت‌شده توسط 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 استفاده نمی‌شود. برای حفظ سازگاری با کاربرانی که از این کلاس خصوصی استفاده می‌کنند، یک لایه سازگاری (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() نباید نوشتن جزئی انجام دهد.

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

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

asynchat و asyncore¶

• این دو ماژول مطابق با زمان‌بندی تعیین‌شده در PEP 594 حذف شده‌اند؛ این ماژول‌ها در پایتون 3.6 منسوخ شده بودند. به جای آن‌ها از asyncio استفاده کنید. (مشارکت نیکیتا سوبولف در gh-96580.)

configparser¶

• چندین نام که در configparser از همان نسخه 3.2 منسوخ شده بودند، طبق gh-89336 حذف شده‌اند:

  • configparser.ParsingError دیگر ویژگی یا آرگومان filename ندارد. به‌جای آن، از ویژگی و آرگومان source استفاده کنید.

  • configparser دیگر کلاس SafeConfigParser ندارد. به جای آن از نام کوتاه‌تر ConfigParser استفاده کنید.

  • configparser.ConfigParser دیگر متد readfp را ندارد. به جای آن از read_file() استفاده کنید.

distutils¶

• بسته‌ی distutils حذف شد. این بسته در پایتون 3.10 بر اساس PEP 632 «منسوخ‌سازی ماژول distutils» منسوخ شده بود. برای پروژه‌هایی که هنوز از distutils استفاده می‌کنند و نمی‌توان آن‌ها را به چیز دیگری به‌روزرسانی کرد، می‌توان پروژه‌ی setuptools را نصب کرد: این پروژه همچنان distutils را فراهم می‌کند. (مشارکت‌شده توسط Victor Stinner در gh-92584.)

ensurepip¶

• حذف ویل (wheel) همراه setuptools از ensurepip، و توقف نصب setuptools در محیط‌هایی که توسط venv ایجاد می‌شوند.

  pip (>= 22.1) نیازی به نصب setuptools در محیط ندارد. بسته‌های مبتنی بر setuptools (و مبتنی بر distutils) همچنان با pip install قابل استفاده هستند، زیرا pip setuptools را در محیط ساخت مورد استفاده برای ساخت یک بسته فراهم می‌کند.

  easy_install، pkg_resources، setuptools و distutils دیگر به‌صورت پیش‌فرض در محیط‌هایی که با venv ایجاد شده‌اند یا با ensurepip بوت‌استرپ شده‌اند ارائه نمی‌شوند، زیرا آن‌ها بخشی از بسته‌ی setuptools هستند. برای پروژه‌هایی که در ران‌تایم به این موارد تکیه می‌کنند، پروژه‌ی setuptools باید به‌عنوان یک وابستگی اعلام شود و به‌صورت جداگانه (معمولاً با استفاده از pip) نصب شود.

  (با مشارکت Pradyun Gedam در gh-95299.)

enum¶

• متد EnumMeta.__getattr__ از ماژول enum حذف شد؛ این متد دیگر برای دسترسی به ویژگی‌های enum لازم نیست. (مشارکت‌شده توسط Ethan Furman در gh-95083.)

ftplib¶

• ویژگی کلاس FTP_TLS.ssl_version از ftplib حذف شد: به جای آن از پارامتر context استفاده کنید. (مشارکت‌شده توسط Victor Stinner در gh-94172.)

gzip¶

• ویژگی filename از کلاس gzip.GzipFile در ماژول gzip که از پایتون 2.6 منسوخ شده بود، حذف شد؛ به‌جای آن از ویژگی name استفاده کنید. در حالت نوشتن، ویژگی filename پسوند پرونده‌ی '.gz' را در صورت نبودن اضافه می‌کرد. (مشارکت‌شده توسط Victor Stinner در gh-94196.)

hashlib¶

• پیاده‌سازی خالص پایتونِ hashlib.pbkdf2_hmac() در hashlib، که در پایتون 3.10 منسوخ شده بود، حذف شد. پایتون 3.10 و جدیدتر به OpenSSL 1.1.1 نیاز دارد (PEP 644): این نسخه از OpenSSL یک پیاده‌سازی C برای pbkdf2_hmac() فراهم می‌کند که سریع‌تر است. (مشارکت Victor Stinner در gh-94199.)

importlib¶

• بسیاری از پاک‌سازی‌های پیش‌تر منسوخ‌شده در importlib اکنون تکمیل شده‌اند:

  • ارجاع‌ها به module_repr() و پشتیبانی از آن حذف شده‌اند. (مشارکت‌شده توسط Barry Warsaw در gh-97850.)

  • importlib.util.set_package، importlib.util.set_loader و importlib.util.module_for_loader همگی حذف شده‌اند. (مشارکت‌شده توسط Brett Cannon و Nikita Sobolev در gh-65961 و gh-97850.)

  • پشتیبانی از APIهای find_loader() و find_module() حذف شده است. (مشارکت‌شده توسط Barry Warsaw در gh-98040.)

  • importlib.abc.Finder، pkgutil.ImpImporter و pkgutil.ImpLoader حذف شده‌اند. (مشارکت‌شده توسط Barry Warsaw در gh-98040.)

imp¶

• ماژول imp حذف شده است. (مشارکت‌شده توسط Barry Warsaw در gh-98040.)

  برای مهاجرت، به جدول تناظر زیر مراجعه کنید:

  imp	importlib
  imp.NullImporter	None را در sys.path_importer_cache درج کنید
  imp.cache_from_source()	importlib.util.cache_from_source()
  imp.find_module()	importlib.util.find_spec()
  imp.get_magic()	importlib.util.MAGIC_NUMBER
  imp.get_suffixes()	importlib.machinery.SOURCE_SUFFIXES، importlib.machinery.EXTENSION_SUFFIXES و importlib.machinery.BYTECODE_SUFFIXES
  imp.get_tag()	sys.implementation.cache_tag
  imp.load_module()	importlib.import_module()
  imp.new_module(name)	types.ModuleType(name)
  imp.reload()	importlib.reload()
  imp.source_from_cache()	importlib.util.source_from_cache()
  imp.load_source()	به ادامه مراجعه کنید

  imp.load_source() را با این جایگزین کنید:

  import importlib.util
  import importlib.machinery
  
  def load_source(modname, filename):
      loader = importlib.machinery.SourceFileLoader(modname, filename)
      spec = importlib.util.spec_from_file_location(modname, filename, loader=loader)
      module = importlib.util.module_from_spec(spec)
      # The module is always executed and not cached in sys.modules.
      # Uncomment the following line to cache the module.
      # sys.modules[module.__name__] = module
      loader.exec_module(module)
      return module
  

• حذف توابع و ویژگی‌های imp بدون جایگزین:

  • توابع بدون مستندات:

    • imp.init_builtin()

    • imp.load_compiled()

    • imp.load_dynamic()

    • imp.load_package()

  • imp.lock_held()، imp.acquire_lock()، imp.release_lock(): طرح‌واره‌ی قفل‌بندی در پایتون 3.3 به قفل‌های به‌ازای هر ماژول تغییر کرده است.

  • ثابت‌های imp.find_module(): SEARCH_ERROR، PY_SOURCE، PY_COMPILED، C_EXTENSION، PY_RESOURCE، PKG_DIRECTORY، C_BUILTIN، PY_FROZEN، PY_CODERESOURCE، IMP_HOOK.

io¶

• io.OpenWrapper و _pyio.OpenWrapper از io که در Python 3.10 منسوخ شده بودند، حذف شدند: به‌جای آن‌ها فقط از open() استفاده کنید. تابع open() (io.open()) یک تابع توکار است. از Python 3.10 به بعد، _pyio.open() نیز یک متد ایستا است. (مشارکت‌شده توسط Victor Stinner در gh-94169.)

locale¶

• تابع locale.format() ماژول locale که در پایتون 3.7 منسوخ شده بود، حذف شد؛ به‌جای آن از locale.format_string() استفاده کنید. (مشارکت‌شده توسط Victor Stinner در gh-94226.)

smtpd¶

• ماژول smtpd که در پایتون 3.4.7 و 3.5.4 منسوخ شده بود، مطابق با زمان‌بندی تعیین‌شده در PEP 594 حذف شده است. به جای آن از ماژول aiosmtpd در PyPI یا هر سرور مبتنی بر asyncio دیگری استفاده کنید. (با مشارکت Oleg Iarygin در gh-93243.)

sqlite3¶

• ویژگی‌های مستندنشده‌ی sqlite3 زیر که در پایتون 3.10 منسوخ شده بودند، اکنون حذف شده‌اند:

  • sqlite3.enable_shared_cache()

  • sqlite3.OptimizedUnicode

  اگر باید از نهانگاه اشتراکی استفاده شود، پایگاه داده را در حالت URI با استفاده از پارامتر پرس‌وجوی cache=shared باز کنید.

  کارخانه‌ی متن (text factory) sqlite3.OptimizedUnicode از پایتون 3.3 به بعد مستعاری برای str بوده است. کدی که پیش‌تر کارخانه‌ی متن را روی OptimizedUnicode تنظیم می‌کرد، می‌تواند یا به‌طور صریح از str استفاده کند، یا بر مقدار پیش‌فرض تکیه کند که آن هم str است.

  (مشارکت‌شده توسط Erlend E. Aasland در gh-92548.)

ssl¶

• تابع ssl.RAND_pseudo_bytes() ماژول ssl که در پایتون 3.6 منسوخ شده بود، حذف شد؛ به‌جای آن از os.urandom() یا ssl.RAND_bytes() استفاده کنید. (مشارکت‌شده توسط Victor Stinner در gh-94199.)

• تابع ssl.match_hostname() حذف شد. این تابع در پایتون 3.7 منسوخ شده بود. از پایتون 3.7، OpenSSL تطبیق نام میزبان را انجام می‌دهد و پایتون دیگر از تابع ssl.match_hostname() استفاده نمی‌کند. (مشارکت‌شده توسط ویکتور استینر در gh-94199.)

• تابع ssl.wrap_socket() که در Python 3.7 منسوخ شده بود، حذف شد: به‌جای آن، یک شیء ssl.SSLContext ایجاد کنید و متد ssl.SSLContext.wrap_socket آن را فراخوانی کنید. هر بسته‌ای که هنوز از ssl.wrap_socket() استفاده می‌کند، خراب و نا‌امن است. این تابع نه افزونه SNI در TLS را ارسال می‌کند و نه نام میزبان سرور را اعتبارسنجی می‌کند. کد مشمول CWE 295 (اعتبارسنجی نادرست گواهی) است. (مشارکت‌شده توسط Victor Stinner در gh-94199.)

unittest¶

• حذف بسیاری از قابلیت‌های مدت‌ها منسوخ‌شده‌ی unittest:

  • تعدادی از نام‌های مستعار متدهای TestCase:

    نام مستعار منسوخ	نام متد	منسوخ در
    failUnless	assertTrue()	3.1
    failIf	assertFalse()	3.1
    failUnlessEqual	assertEqual()	3.1
    failIfEqual	assertNotEqual()	3.1
    failUnlessAlmostEqual	assertAlmostEqual()	3.1
    failIfAlmostEqual	assertNotAlmostEqual()	3.1
    failUnlessRaises	assertRaises()	3.1
    assert_	assertTrue()	3.2
    assertEquals	assertEqual()	3.2
    assertNotEquals	assertNotEqual()	3.2
    assertAlmostEquals	assertAlmostEqual()	3.2
    assertNotAlmostEquals	assertNotAlmostEqual()	3.2
    assertRegexpMatches	assertRegex()	3.2
    assertRaisesRegexp	assertRaisesRegex()	3.2
    assertNotRegexpMatches	assertNotRegex()	3.5

    می‌توانید برای مدرن‌سازی خودکار آزمون‌های واحد خود از https://github.com/isidentical/teyit استفاده کنید.

  • متد مستندنشده و معیوب assertDictContainsSubset از TestCase (در پایتون 3.2 منسوخ شده).

  • پارامتر مستندسازی‌نشده‌ی use_load_tests در TestLoader.loadTestsFromModule (منسوخ و نادیده گرفته‌شده از پایتون 3.5).

  • نام مستعاری برای کلاس TextTestResult: _TextTestResult (در پایتون 3.2 منسوخ شده است).

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

webbrowser¶

• پشتیبانی از مرورگرهای منسوخ از webbrowser حذف شد. مرورگرهای حذف‌شده عبارت‌اند از: Grail، Mosaic، Netscape، Galeon، Skipstone، Iceape، Firebird و نسخه‌های 35 و پایین‌تر Firefox (gh-102871).

xml.etree.ElementTree¶

• متد ElementTree.Element.copy() از پیاده‌سازی خالص پایتون، که در پایتون 3.10 منسوخ شده بود، حذف شد؛ به‌جای آن از تابع copy.copy() استفاده کنید. پیاده‌سازی C از xml.etree.ElementTree متد copy() ندارد و فقط متد __copy__() دارد. (مشارکت‌شده توسط Victor Stinner در gh-94383.)

zipimport¶

• متدهای find_loader() و find_module() ماژول zipimport که در پایتون 3.10 منسوخ شده بودند، حذف شدند؛ به‌جای آن‌ها از متد find_spec() استفاده کنید. برای توضیح دلایل این تغییر به PEP 451 مراجعه کنید. (نوشته‌شده توسط Victor Stinner در gh-94379.)

موارد دیگر¶

• قاعده‌ی suspicious از Makefile مستندات و Doc/tools/rstlint.py حذف شد، هر دو به نفع sphinx-lint. (مشارکت‌شده توسط Julien Palard در gh-98179.)

• پارامترهای keyfile و certfile از ماژول‌های ftplib، imaplib، poplib و smtplib و همچنین پارامترهای key_file، cert_file و check_hostname از ماژول http.client حذف شدند که همگی از پایتون 3.6 منسوخ شده بودند. به‌جای آن‌ها از پارامتر context (ssl_context در imaplib) استفاده کنید. (مشارکت‌کننده: Victor Stinner در gh-94172.)

• هک‌های سازگاری Jython از چندین ماژول و آزمون کتابخانه استاندارد حذف شدند. (مشارکت‌شده توسط نیکیتا سوبولف در gh-99482.)

• حذف پرچم _use_broken_old_ctypes_structure_semantics_ از ماژول ctypes. (مشارکت‌شده توسط Nikita Sobolev در gh-99285.)

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

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

• قابلیت randrange() که از پایتون 3.10 منسوخ شده بود، حذف شد. پیش‌تر، randrange(10.0) بدون اتلاف به randrange(10) تبدیل می‌شد. اکنون، استثنای TypeError ایجاد می‌شود. علاوه بر این، استثنایی که برای مقادیر غیرصحیح مانند randrange(10.5) یا randrange('10') ایجاد می‌شد، از ValueError به TypeError تغییر کرده است. این تغییر همچنین از اشکالاتی جلوگیری می‌کند که در آن‌ها randrange(1e25) به‌صورت بی‌صدا از بازه‌ای بزرگ‌تر از بازه‌ی randrange(10**25) انتخاب می‌کرد. (در ابتدا توسط Serhiy Storchaka پیشنهاد شد gh-86388.)

• argparse.ArgumentParser هنگام خواندن آرگومان‌ها از پرونده (مثلاً گزینه‌ی fromfile_prefix_chars)، کدگذاری و هندلر خطا را از کدگذاری متن پیش‌فرض (مثلاً locale.getpreferredencoding(False)) به filesystem encoding and error handler تغییر داد. در ویندوز، پرونده‌های آرگومان باید به‌جای کدپیج ANSI با UTF-8 کدگذاری شوند.

• ماژول smtpd مبتنی بر asyncore که در پایتون 3.4.7 و 3.5.4 منسوخ شده بود، حذف شد. جایگزین توصیه‌شده، ماژول aiosmtpd مبتنی بر asyncio در PyPI است.

• shlex.split(): ارسال None برای آرگومان s اکنون به‌جای خواندن sys.stdin، استثنا ایجاد می‌کند. این قابلیت در Python 3.9 منسوخ شده بود. (مشارکت‌شده توسط Victor Stinner در gh-94352.)

• ماژول os دیگر مسیرهای شبه‌بایت مانند نوع‌های bytearray و memoryview را نمی‌پذیرد: برای رشته‌های بایتی، فقط نوع دقیق bytes پذیرفته می‌شود. (مشارکت Victor Stinner در gh-98393.)

• syslog.openlog() و syslog.closelog() اکنون در صورت استفاده در زیرمفسرها شکست می‌خورند. از syslog.syslog() هنوز هم می‌توان در زیرمفسرها استفاده کرد، اما اکنون تنها در صورتی که syslog.openlog() پیش‌تر در مفسر اصلی فراخوانی شده باشد. این محدودیت‌های جدید بر مفسر اصلی اعمال نمی‌شوند، بنابراین تنها گروه بسیار کوچکی از کاربران ممکن است تحت تأثیر قرار گیرند. این تغییر به جداسازی مفسر کمک می‌کند. علاوه بر این، syslog پوششی حول منابع سراسری در سطح فرایند است که بهتر است از مفسر اصلی مدیریت شوند. (مشارکت‌شده توسط Donghee Na در gh-99127.)

• رفتار قفل‌گذاری مستندنشده‌ی @cached_property حذف شده است، زیرا قفل آن میان همه‌ی نمونه‌های کلاس مشترک بود و به رقابت شدید بر سر قفل (lock contention) منجر می‌شد. این بدان معناست که تابع getter یک پراپرتی نهانگاهی، اکنون ممکن است برای یک نمونه‌ی واحد بیش از یک بار اجرا شود، اگر دو نخ با هم رقابت کنند. برای اکثر پراپرتی‌های نهانگاهی ساده (مثلاً پراپرتی‌هایی که هم‌توان هستند و صرفاً مقداری را بر اساس ویژگی‌های دیگر نمونه محاسبه می‌کنند) این مشکلی نخواهد داشت. اگر همگام‌سازی لازم باشد، قفل‌گذاری را درون تابع getter پراپرتی نهانگاهی یا در اطراف نقاط دسترسی چندنخی پیاده‌سازی کنید.

• sys._current_exceptions() اکنون نگاشتی از شناسه‌ی نخ به نمونه‌ای از استثنا برمی‌گرداند، نه به تاپل (typ, exc, tb). (مشارکت Irit Katriel در gh-103176.)

• هنگام استخراج پرونده‌های tar با استفاده از tarfile یا shutil.unpack_archive()، آرگومان filter را برای محدود کردن قابلیت‌هایی که ممکن است غافلگیرکننده یا خطرناک باشند ارسال کنید. برای جزئیات به فیلترهای استخراج مراجعه کنید.

• خروجی توابع tokenize.tokenize() و tokenize.generate_tokens() اکنون به دلیل تغییرات معرفی‌شده در PEP 701 تغییر کرده است. این بدان معناست که توکن‌های STRING دیگر برای اف‌استرینگ‌ها تولید نمی‌شوند و در عوض، توکن‌های توصیف‌شده در PEP 701 اکنون تولید می‌شوند: توکن‌های FSTRING_START، FSTRING_MIDDLE و FSTRING_END اکنون برای بخش‌های «رشته‌ای» اف‌استرینگ، در کنار توکن‌های مناسب برای توکن‌سازی در اجزای عبارت، تولید می‌شوند. برای مثال، نسخه‌ی قدیمی توکن‌ساز برای اف‌استرینگ f"start {1+1} end" این توکن‌ها را تولید می‌کرد:

  1,0-1,18:           STRING         'f"start {1+1} end"'
  

  در حالی که نسخه جدید تولید می‌کند:

  1,0-1,2:            FSTRING_START  'f"'
  1,2-1,8:            FSTRING_MIDDLE 'start '
  1,8-1,9:            OP             '{'
  1,9-1,10:           NUMBER         '1'
  1,10-1,11:          OP             '+'
  1,11-1,12:          NUMBER         '1'
  1,12-1,13:          OP             '}'
  1,13-1,17:          FSTRING_MIDDLE ' end'
  1,17-1,18:          FSTRING_END    '"'
  

  علاوه بر این، ممکن است در نتیجه‌ی تغییرات مورد نیاز برای پشتیبانی از PEP 701، برخی تغییرات رفتاری جزئی رخ دهد. برخی از این تغییرات عبارت‌اند از:

  • ویژگی type توکن‌هایی که هنگام توکن‌سازی برخی نویسه‌های نامعتبر پایتون مانند ! تولید می‌شوند، از ERRORTOKEN به OP تغییر کرده است.

  • رشته‌های تک‌سطری ناقص نیز اکنون مانند رشته‌های چندسطری ناقص، استثنای tokenize.TokenError را ایجاد می‌کنند.

  • برخی از کدهای ناقص یا نامعتبر پایتون اکنون هنگام توکن‌سازی، به‌جای بازگرداندن توکن‌های ERRORTOKEN دلخواه، tokenize.TokenError ایجاد می‌کنند.

  • ترکیب تب و فاصله به‌عنوان تورفتگی در یک پرونده دیگر پشتیبانی نمی‌شود و استثنای TabError ایجاد می‌کند.

• ماژول threading اکنون انتظار دارد که ماژول _thread دارای ویژگی _is_main_interpreter باشد. این تابعی بدون آرگومان است که اگر مفسر فعلی، مفسر اصلی باشد، True برمی‌گرداند.

  هر کتابخانه یا برنامه‌ای که ماژول _thread سفارشی ارائه می‌دهد، باید _is_main_interpreter() را نیز فراهم کند. (نگاه کنید به gh-112826.)

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

• PEP 697: معرفی سطح ناپایدار API زبان C که برای ابزارهای سطح پایین مانند اشکال‌زدا‌ها و کامپایلرهای JIT در نظر گرفته‌شده است. این API ممکن است در هر نسخه‌ی فرعی سی‌پایتون بدون هشدارهای منسوخ‌سازی تغییر کند. محتویات آن با پیشوند PyUnstable_ در نام‌ها مشخص می‌شوند.

  سازنده‌های شیء کد:

  • PyUnstable_Code_New() (تغییرنام‌یافته از PyCode_New)

  • PyUnstable_Code_NewWithPosOnlyArgs() (تغییرنام‌یافته از PyCode_NewWithPosOnlyArgs)

  فضای ذخیره‌سازی اضافی برای شیءهای کد (PEP 523):

  • PyUnstable_Eval_RequestCodeExtraIndex() (تغییرنام‌یافته از _PyEval_RequestCodeExtraIndex)

  • PyUnstable_Code_GetExtra() (تغییرنام‌یافته از _PyCode_GetExtra)

  • PyUnstable_Code_SetExtra() (که از _PyCode_SetExtra تغییر نام یافته است)

  نام‌های اصلی تا زمانی که API مربوطه تغییر کند، همچنان در دسترس خواهند بود.

  (مشارکت Petr Viktorin در gh-101101.)

• PEP 697: افزودن یک API برای توسعه دادن نوع‌هایی که چیدمان حافظه‌ی نمونه‌هایشان مات است:

  • PyType_Spec.basicsize می‌تواند صفر یا منفی باشد تا به ارث بردن یا گسترش دادن اندازه کلاس پایه را مشخص کند.

  • PyObject_GetTypeData() و PyType_GetTypeDataSize() برای امکان دسترسی به داده‌های نمونه‌ی مخصوص زیرکلاس افزوده شدند.

  • Py_TPFLAGS_ITEMS_AT_END و PyObject_GetItemData() افزوده شدند تا امکان گسترش ایمن برخی نوع‌های با اندازه‌ی متغیر، از جمله PyType_Type، فراهم شود.

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

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

• تابع جدید C API محدود PyType_FromMetaclass() اضافه شد که تابع موجود PyType_FromModuleAndSpec() را با استفاده از یک آرگومان فراکلاس اضافی تعمیم می‌دهد. (با مشارکت Wenzel Jakob در gh-93012.)

• API برای ایجاد اشیایی که می‌توان با استفاده از پروتکل vectorcall آن‌ها را فراخوانی کرد، به API محدود اضافه شد:

  • Py_TPFLAGS_HAVE_VECTORCALL

  • PyVectorcall_NARGS()

  • PyVectorcall_Call()

  • vectorcallfunc

  اکنون هنگامی که متد __call__() کلاس دوباره انتساب داده می‌شود، پرچم Py_TPFLAGS_HAVE_VECTORCALL از کلاس حذف می‌شود. این کار استفاده از vectorcall را با نوع‌های تغییرپذیر ایمن می‌سازد (یعنی نوع‌های هیپ بدون پرچم تغییرناپذیری، Py_TPFLAGS_IMMUTABLETYPE). نوع‌های تغییرپذیری که tp_call را بازنویسی نمی‌کنند، اکنون پرچم Py_TPFLAGS_HAVE_VECTORCALL را به ارث می‌برند. (مشارکت‌شده توسط Petr Viktorin در gh-93274.)

  پرچم‌های Py_TPFLAGS_MANAGED_DICT و Py_TPFLAGS_MANAGED_WEAKREF افزوده شده‌اند. این امر به کلاس‌های توسعه‌ای امکان می‌دهد تا با دفترداری کمتر، مصرف حافظه کمتر و دسترسی سریع‌تر، از __dict__ شیء و ارجاع‌های ضعیف پشتیبانی کنند.

• API برای انجام فراخوانی‌ها با استفاده از پروتکل vectorcall به API محدود اضافه شد:

  • PyObject_Vectorcall()

  • PyObject_VectorcallMethod()

  • PY_VECTORCALL_ARGUMENTS_OFFSET

  این بدان معناست که هر دو سمت ورودی و خروجی پروتکل فراخوانی برداری (vector call) اکنون در API محدود در دسترس هستند. (با مشارکت Wenzel Jakob در gh-98586.)

• دو تابع عمومی جدید، PyEval_SetProfileAllThreads() و PyEval_SetTraceAllThreads()، اضافه شدند که اجازه می‌دهند توابع ردگیری و پروفایل‌گیری در همه‌ی نخ‌های در حال اجرا، علاوه بر نخ فراخواننده، تنظیم شوند. (مشارکت‌شده توسط Pablo Galindo در gh-93503.)

• افزودن تابع جدید PyFunction_SetVectorcall() به API زبان C که فیلد vectorcall یک PyFunctionObject داده‌شده را تنظیم می‌کند. (مشارکت‌شده توسط Andrew Frost در gh-92257.)

• API زبان C اکنون اجازه می‌دهد تا از طریق PyDict_AddWatcher()، PyDict_Watch() و API‌های مرتبط، کال‌بک‌هایی ثبت شوند که هرگاه یک دیکشنری تغییر داده شود، فراخوانی می‌شوند. این قابلیت برای استفاده توسط مفسرهای بهینه‌ساز، کامپایلرهای JIT یا اشکال‌زداها در نظر گرفته شده است. (مشارکت‌شده توسط کارل مایر در gh-91052.)

• افزودن API‌های PyType_AddWatcher() و PyType_Watch() برای ثبت کردن کال‌بک‌ها به‌منظور دریافت اطلاع‌رسانی هنگام تغییر یک نوع. (مشارکت‌شده توسط کارل مایر در gh-91051.)

• افزودن API‌های PyCode_AddWatcher() و PyCode_ClearWatcher() برای ثبت کال‌بک‌هایی که هنگام ایجاد و نابودی اشیاء کد اطلاع‌رسانی دریافت می‌کنند. (با مشارکت Itamar Oren در gh-91054.)

• افزودن توابع PyFrame_GetVar() و PyFrame_GetVarString() برای گرفتن متغیر فریم بر اساس نام آن. (مشارکت‌شده توسط Victor Stinner در gh-91248.)

• توابع PyErr_GetRaisedException() و PyErr_SetRaisedException() برای ذخیره و بازیابی استثنای فعلی اضافه شدند. این توابع به‌جای سه آرگومان توابع اکنون منسوخ‌شده‌ی PyErr_Fetch() و PyErr_Restore()، تنها یک شیء استثنا را برمی‌گردانند و می‌پذیرند. این کار کمتر مستعد خطا و کمی کارآمدتر است. (مشارکت Mark Shannon در gh-101578.)

• _PyErr_ChainExceptions1 که یک نمونه‌ی استثنا دریافت می‌کند اضافه شد تا جایگزین _PyErr_ChainExceptions در API قدیمی شود که اکنون منسوخ شده است. (مشارکت Mark Shannon در gh-101578.)

• توابع PyException_GetArgs() و PyException_SetArgs() به‌عنوان توابعی راحت برای بازیابی و تغییر args که به سازنده‌ی استثنا پاس داده می‌شود، اضافه شدند. (مشارکت Mark Shannon در gh-101578.)

• افزودن PyErr_DisplayException() که یک نمونه استثنا می‌گیرد، برای جایگزینی PyErr_Display() مربوط به API قدیمی. (مشارکت از طرف ایریت کاتریل در gh-102755).

• PEP 683: معرفی اشیاء نامیرا، که به اشیاء اجازه می‌دهد شمارش ارجاع را دور بزنند، و تغییرات مرتبط با C-API:

  • _Py_IMMORTAL_REFCNT: شمارش ارجاعی که یک شیء را تعریف می‌کند

  • _Py_IsImmortal بررسی می‌کند که آیا یک شیء دارای شمارش ارجاع نامیرا است یا خیر.

  • PyObject_HEAD_INIT اکنون شمارش ارجاع را مقداردهی اولیه می‌کند به

  • SSTATE_INTERNED_IMMORTAL شناسه‌ای برای اشیاء یونیکد درونی‌سازی‌شده

  • SSTATE_INTERNED_IMMORTAL شناسه‌ای برای اشیاء یونیکد درونی‌سازی‌شده

  • اشیایی که درون‌سازی (intern) شده‌اند. این امر اکنون لازم است تا refleak.py بتواند شمارش ارجاع و بلوک‌های تخصیص‌یافته را به‌درستی پیگیری کند

  (مشارکت‌شده توسط Eddie Elizondo در gh-84436.)

• PEP 684: افزودن تابع جدید Py_NewInterpreterFromConfig() و PyInterpreterConfig که می‌توان از آن‌ها برای ایجاد زیرمفسرهایی با قفل‌های مفسر سراسری اختصاصی خودشان استفاده کرد. (برای اطلاعات بیشتر به PEP 684: قفل مفسر سراسری به ازای هر مفسر مراجعه کنید.) (مشارکت‌شده توسط Eric Snow در gh-104110.)

• در نسخه‌ی 3.12 از C API محدود، توابع Py_INCREF() و Py_DECREF() اکنون به‌صورت فراخوانی‌های تابع مات پیاده‌سازی شده‌اند تا جزئیات پیاده‌سازی را پنهان کنند. (مشارکت‌شده توسط Victor Stinner در gh-105387.)

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

• API‌های قدیمی یونیکد مبتنی بر نمایش Py_UNICODE* حذف شده‌اند. لطفاً به API‌های مبتنی بر UTF-8 یا wchar_t* مهاجرت کنید.

• توابع تجزیه‌ی آرگومان مانند PyArg_ParseTuple() دیگر از قالب‌های مبتنی بر Py_UNICODE* (مانند u و Z) پشتیبانی نمی‌کنند. لطفاً به قالب‌های دیگر یونیکد مانند s، z، es و U مهاجرت کنید.

• مقدار tp_weaklist برای همه‌ی نوع‌های توکار ایستا همیشه NULL است. این یک فیلد صرفاً داخلی در PyTypeObject است، اما به این تغییر اشاره می‌کنیم چرا که ممکن است کسی به هر حال مستقیماً به این فیلد دسترسی داشته باشد. برای جلوگیری از خرابی، به جای آن استفاده از C-API عمومی موجود را در نظر بگیرید، یا در صورت نیاز، از ماکرو (صرفاً داخلی) _PyObject_GET_WEAKREFS_LISTPTR() استفاده کنید.

• این PyTypeObject.tp_subclasses که صرفاً داخلی است، ممکن است اکنون اشاره‌گر شیء معتبری نباشد. نوع آن برای بازتاب این موضوع به void* تغییر یافت. این را برای حالتی ذکر می‌کنیم که کسی اتفاقاً مستقیماً به این فیلد صرفاً داخلی دسترسی داشته باشد.

  برای به‌دست‌آوردن فهرستی از زیرکلاس‌ها، متد پایتونی __subclasses__() را فراخوانی کنید (برای مثال با استفاده از PyObject_CallMethod()).

• افزودن پشتیبانی از گزینه‌های قالب‌بندی بیشتر (چپ‌چین کردن، مبنای هشت، مبنای شانزده با حروف بزرگ، رشته‌های C از نوع intmax_t، ptrdiff_t و wchar_t، عرض و دقت متغیر) در PyUnicode_FromFormat() و PyUnicode_FromFormatV(). (مشارکت Serhiy Storchaka در gh-98836.)

• نویسه قالب ناشناخته در PyUnicode_FromFormat() و PyUnicode_FromFormatV() اکنون یک SystemError برپا می‌کند. در نسخه‌های قبلی، این نویسه باعث می‌شد تمام باقی‌مانده‌ی رشته قالب عیناً به رشته نتیجه کپی شود و هر آرگومان اضافی دور ریخته شود. (مشارکت‌شده توسط Serhiy Storchaka در gh-95781.)

• اصلاح جایگذاری نادرست علامت در PyUnicode_FromFormat() و PyUnicode_FromFormatV(). (ارائه‌شده توسط Philip Georgi در gh-95504.)

• کلاس‌های توسعه‌ای که می‌خواهند جایگاه __dict__ یا ارجاع ضعیف اضافه کنند، باید به‌ترتیب به‌جای tp_dictoffset و tp_weaklistoffset از Py_TPFLAGS_MANAGED_DICT و Py_TPFLAGS_MANAGED_WEAKREF استفاده کنند. استفاده از tp_dictoffset و tp_weaklistoffset همچنان پشتیبانی می‌شود، اما از وراثت چندگانه به‌طور کامل پشتیبانی نمی‌کند (gh-95589) و ممکن است کارایی بدتر باشد. کلاس‌هایی که Py_TPFLAGS_MANAGED_DICT را اعلام می‌کنند، باید برای پیمایش و پاک‌سازی دیکشنری‌های نمونه‌های خود، _PyObject_VisitManagedDict() و _PyObject_ClearManagedDict() را فراخوانی کنند. برای پاک‌سازی ارجاع‌های ضعیف، مانند قبل PyObject_ClearWeakRefs() را فراخوانی کنید.

• تابع PyUnicode_FSDecoder() دیگر مسیرهای شبه‌بایت مانند نوع‌های bytearray و memoryview را نمی‌پذیرد: برای رشته‌های بایتی، فقط نوع دقیق bytes پذیرفته می‌شود. (مشارکت‌شده توسط Victor Stinner در gh-98393.)

• ماکروهای Py_CLEAR، Py_SETREF و Py_XSETREF اکنون آرگومان‌های خود را فقط یک بار ارزیابی می‌کنند. اگر آرگومانی اثر جانبی داشته باشد، این اثرهای جانبی دیگر تکرار نمی‌شوند. (مشارکت‌شده توسط ویکتور استینر در gh-98724.)

• نشانگر خطای مفسر اکنون همیشه نرمال‌سازی می‌شود. این بدان معناست که PyErr_SetObject()، PyErr_SetString() و سایر توابعی که نشانگر خطا را تنظیم می‌کنند، اکنون استثنا را پیش از ذخیره کردن آن نرمال‌سازی می‌کنند. (مشارکت‌شده توسط Mark Shannon در gh-101578.)

• _Py_RefTotal دیگر معتبر نیست و تنها برای سازگاری با ABI حفظ شده است. توجه داشته باشید که این یک متغیر سراسری داخلی است و تنها در نسخه‌های دیباگ در دسترس است. اگر اتفاقاً از آن استفاده می‌کنید، باید استفاده از _Py_GetGlobalRefTotal() را آغاز کنید.

• توابع زیر اکنون فراکلاس مناسبی را برای نوع تازه‌ایجادشده انتخاب می‌کنند:

  • PyType_FromSpec()

  • PyType_FromSpecWithBases()

  • PyType_FromModuleAndSpec()

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

  توجه داشته باشید که PyType_FromMetaclass() (که در Python 3.12 اضافه‌شده است) از پیش ایجاد کلاس‌هایی را که فراکلاس آن‌ها tp_new را بازنویسی می‌کند، ممنوع کرده است (__new__() در پایتون).

  از آنجا که tp_new تقریباً همه‌ی کارهایی را که توابع PyType_From* انجام می‌دهند بازنویسی می‌کند، این دو با یکدیگر ناسازگارند. رفتار موجود -- نادیده گرفتن فراکلاس در چند مرحله از ایجاد نوع -- به‌طور کلی ناامن است، زیرا (فرا)کلاس‌ها فرض می‌کنند که tp_new فراخوانی شده است. هیچ راه‌حل جایگزین عمومی ساده‌ای وجود ندارد. ممکن است یکی از موارد زیر برای شما کار کند:

  • اگر فراکلاس در کنترل شماست، از استفاده از tp_new در آن پرهیز کنید:

    • اگر بتوان از مقداردهی اولیه صرف‌نظر کرد، می‌توان آن را در عوض در tp_init انجام داد.

    • اگر فراکلاس نیازی به نمونه‌سازی از پایتون ندارد، tp_new آن را با استفاده از پرچم Py_TPFLAGS_DISALLOW_INSTANTIATION برابر NULL قرار دهید. این کار آن را برای توابع PyType_From* قابل قبول می‌کند.

  • از توابع PyType_From* پرهیز کنید: اگر به ویژگی‌های مختص C (جایگاه‌ها یا تعیین اندازه نمونه) نیاز ندارید، نوع‌ها را با فراخوانی فراکلاس ایجاد کنید.

  • اگر می‌دانید که می‌توان با اطمینان از tp_new صرف‌نظر کرد، هشدار منسوخ‌شدگی را با استفاده از warnings.catch_warnings() پایتون فیلتر کنید.

• PyOS_InputHook و PyOS_ReadlineFunctionPointer دیگر در زیرمفسرها فراخوانی نمی‌شوند. دلیل این امر آن است که کلاینت‌ها به‌طور کلی به وضعیت سراسری در سطح فرایند متکی هستند (از آنجا که این کال‌بک‌ها هیچ راهی برای بازیابی وضعیت ماژول توسعه‌ای ندارند).

  این کار همچنین از موقعیت‌هایی جلوگیری می‌کند که در آن‌ها ممکن است ماژول‌های توسعه‌ای در یک زیرمفسر اجرا شوند که از آن پشتیبانی نمی‌کنند (یا هنوز در آن بارگذاری نشده‌اند). برای اطلاعات بیشتر به gh-104668 مراجعه کنید.

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

  • PyUnstable_Long_IsCompact()

  • PyUnstable_Long_CompactValue()

• تخصیص‌دهنده‌های سفارشی که از طریق PyMem_SetAllocator() تنظیم می‌شوند، اکنون باید صرف‌نظر از دامنه حافظه، نخ‌ایمن باشند. تخصیص‌دهنده‌هایی که وضعیت مخصوص خود را ندارند، از جمله «قلاب‌ها»، تحت تأثیر قرار نمی‌گیرند. اگر تخصیص‌دهنده سفارشی شما از قبل نخ‌ایمن نیست و به راهنمایی نیاز دارید، لطفاً یک issue جدید در GitHub ایجاد کنید و @ericsnowcurrently را در CC قرار دهید.

منسوخ¶

• مطابق با PEP 699، فیلد ma_version_tag در PyDictObject برای ماژول‌های توسعه‌ای منسوخ شده است. دسترسی به این فیلد، در زمان کامپایل یک هشدار کامپایلر تولید خواهد کرد. این فیلد در پایتون 3.14 حذف خواهد شد. (مشارکت‌شده توسط Ramvikrams و Kumar Aditya در gh-101193. PEP نوشته‌ی Ken Jin.)

• منسوخ کردن متغیر پیکربندی سراسری:

  • Py_DebugFlag: از PyConfig.parser_debug استفاده کنید

  • Py_VerboseFlag: از PyConfig.verbose استفاده کنید

  • Py_QuietFlag: از PyConfig.quiet استفاده کنید

  • Py_InteractiveFlag: از PyConfig.interactive استفاده کنید

  • Py_InspectFlag: از PyConfig.inspect استفاده کنید

  • Py_OptimizeFlag: از PyConfig.optimization_level استفاده کنید

  • Py_NoSiteFlag: از PyConfig.site_import استفاده کنید

  • Py_BytesWarningFlag: از PyConfig.bytes_warning استفاده کنید

  • Py_FrozenFlag: از PyConfig.pathconfig_warnings استفاده کنید

  • Py_IgnoreEnvironmentFlag: از PyConfig.use_environment استفاده کنید

  • Py_DontWriteBytecodeFlag: از PyConfig.write_bytecode استفاده کنید

  • Py_NoUserSiteDirectory: از PyConfig.user_site_directory استفاده کنید

  • Py_UnbufferedStdioFlag: از PyConfig.buffered_stdio استفاده کنید

  • Py_HashRandomizationFlag: از PyConfig.use_hash_seed و PyConfig.hash_seed استفاده کنید

  • Py_IsolatedFlag: از PyConfig.isolated استفاده کنید

  • Py_LegacyWindowsFSEncodingFlag: استفاده از PyPreConfig.legacy_windows_fs_encoding

  • Py_LegacyWindowsStdioFlag: استفاده از PyConfig.legacy_windows_stdio

  • Py_FileSystemDefaultEncoding: از PyConfig.filesystem_encoding استفاده کنید

  • Py_HasFileSystemDefaultEncoding: از PyConfig.filesystem_encoding استفاده کنید

  • Py_FileSystemDefaultEncodeErrors: از PyConfig.filesystem_errors استفاده کنید

  • Py_UTF8Mode: از PyPreConfig.utf8_mode استفاده کنید (نگاه کنید به Py_PreInitialize())

  به جای آن باید از API Py_InitializeFromConfig() به همراه PyConfig استفاده کرد. (مشارکت Victor Stinner در gh-77782.)

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

• سرآیند structmember.h منسوخ شده است، هرچند همچنان در دسترس است و برنامه‌ای برای حذف آن وجود ندارد.

  محتویات آن اکنون تنها با گنجاندن Python.h در دسترس است، با افزودن پیشوند Py در صورتی که وجود نداشته باشد:

  • PyMemberDef، PyMember_GetOne() و PyMember_SetOne()

  • ماکروهای نوع مانند Py_T_INT، Py_T_DOUBLE و غیره (پیش‌تر T_INT، T_DOUBLE و غیره)

  • پرچم‌های Py_READONLY (پیش‌تر READONLY) و Py_AUDIT_READ (پیش‌تر تماماً با حروف بزرگ)

  چندین آیتم از Python.h در دسترس قرار نمی‌گیرند:

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

  • T_NONE (پیش‌تر مستندنشده و بسیار عجیب‌وغریب)

  • ماکروی WRITE_RESTRICTED که کاری انجام نمی‌دهد.

  • ماکروهای RESTRICTED و READ_RESTRICTED، معادل‌های Py_AUDIT_READ.

  • در برخی پیکربندی‌ها، <stddef.h> از Python.h گنجانده نمی‌شود. هنگام استفاده از offsetof() باید آن را به‌صورت دستی گنجاند.

  سرآیند منسوخ همچنان محتوای اصلی خود را با نام‌های اصلی ارائه می‌دهد. کد قدیمی شما می‌تواند بدون تغییر باقی بماند، مگر اینکه include اضافی و ماکروهای بدون فضای نام برایتان بسیار آزاردهنده باشند.

  (ارائه شده در gh-47146 توسط Petr Viktorin، بر پایه‌ی کارهای پیشین Alexander Belopolsky و Matthias Braun.)

• PyErr_Fetch() و PyErr_Restore() منسوخ شده‌اند. به جای آن‌ها از PyErr_GetRaisedException() و PyErr_SetRaisedException() استفاده کنید. (مشارکت‌شده توسط Mark Shannon در gh-101578.)

• PyErr_Display() منسوخ شده است. به جای آن از PyErr_DisplayException() استفاده کنید. (مشارکت‌شده توسط Irit Katriel در gh-102755).

• _PyErr_ChainExceptions منسوخ شده است. به جای آن از _PyErr_ChainExceptions1 استفاده کنید. (مشارکت‌شده توسط Irit Katriel در gh-102192.)

• استفاده از PyType_FromSpec()، PyType_FromSpecWithBases() یا PyType_FromModuleAndSpec() برای ایجاد کلاسی که فراکلاس آن tp_new را بازنویسی می‌کند، منسوخ شده است. به جای آن، فراکلاس را فراخوانی کنید.

حذف‌شده¶

• حذف پرونده‌ی سرآیند token.h. هرگز هیچ API عمومی C برای توکن‌ساز وجود نداشت. پرونده‌ی سرآیند token.h فقط برای استفاده‌ی درونی‌های پایتون طراحی‌شده بود. (مشارکت‌شده توسط Victor Stinner در gh-92651.)

• APIهای قدیمی یونیکد حذف شده‌اند. برای جزئیات به PEP 623 مراجعه کنید.

  • PyUnicode_WCHAR_KIND

  • PyUnicode_AS_UNICODE()

  • PyUnicode_AsUnicode()

  • PyUnicode_AsUnicodeAndSize()

  • PyUnicode_AS_DATA()

  • PyUnicode_FromUnicode()

  • PyUnicode_GET_SIZE()

  • PyUnicode_GetSize()

  • PyUnicode_GET_DATA_SIZE()

• ماکروی تابع PyUnicode_InternImmortal() حذف شد. (مشارکت‌شده توسط Victor Stinner در gh-85858.)