PEP 657: مکان‌های ریزدانه‌ی خطا در ردگیری‌ها¶

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

Traceback (most recent call last):
  File "distance.py", line 11, in <module>
    print(manhattan_distance(p1, p2))
          ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "distance.py", line 6, in manhattan_distance
    return abs(point_1.x - point_2.x) + abs(point_1.y - point_2.y)
                           ^^^^^^^^^
AttributeError: 'NoneType' object has no attribute 'x'

نسخه‌های قبلی مفسر فقط به سطر اشاره می‌کردند، که باعث می‌شد مبهم باشد کدام شیء None بوده است. این خطاهای بهبودیافته هنگام کار با اشیای dict به‌شدت تودرتو و فراخوانی‌های متعدد تابع نیز می‌توانند مفید باشند:

Traceback (most recent call last):
  File "query.py", line 37, in <module>
    magic_arithmetic('foo')
  File "query.py", line 18, in magic_arithmetic
    return add_counts(x) / 25
           ^^^^^^^^^^^^^
  File "query.py", line 24, in add_counts
    return 25 + query_user(user1) + query_user(user2)
                ^^^^^^^^^^^^^^^^^
  File "query.py", line 32, in query_user
    return 1 + query_count(db, response['a']['b']['c']['user'], retry=True)
                               ~~~~~~~~~~~~~~~~~~^^^^^
TypeError: 'NoneType' object is not subscriptable

همچنین عبارت‌های حسابی پیچیده:

Traceback (most recent call last):
  File "calculation.py", line 54, in <module>
    result = (x / y / z) * (a / b / c)
              ~~~~~~^~~
ZeroDivisionError: division by zero

علاوه بر این، اطلاعات مورد استفاده در قابلیت ردگیری بهبودیافته از طریق یک API عمومی در دسترس قرار گرفته است که می‌توان از آن برای برقراری تناظر میان دستورالعمل‌های bytecode و مکان کد منبع استفاده کرد. این اطلاعات را می‌توان با استفاده از موارد زیر بازیابی کرد:

• متد codeobject.co_positions() در پایتون.

• تابع PyCode_Addr2Location() در API زبان C.

برای جزئیات بیشتر به PEP 657 مراجعه کنید. (مشارکت‌شده توسط Pablo Galindo، Batuhan Taskaya و Ammar Askar در bpo-43950.)

PEP 654: گروه‌های استثنا و except*¶

PEP 654 ویژگی‌هایی زبانی معرفی می‌کند که به یک برنامه امکان می‌دهد تا چندین استثنای نامرتبط را به‌طور هم‌زمان برخاست دهد و مدیریت کند. نوع‌های توکار ExceptionGroup و BaseExceptionGroup امکان گروه‌بندی استثناها و برخاست دادن آن‌ها با هم را فراهم می‌کنند، و سینتکس جدید except*، except را برای تطبیق زیرگروه‌های گروه‌های استثنا تعمیم می‌دهد.

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

(مشارکت‌شده توسط Irit Katriel در bpo-45292. PEP نوشته‌شده توسط Irit Katriel، Yury Selivanov و Guido van Rossum.)

PEP 678: می‌توان استثناها را با یادداشت‌ها غنی کرد¶

متد add_note() به BaseException اضافه شده است. از این متد می‌توان برای غنی‌سازی استثناها با اطلاعات زمینه‌ای که در زمان پرتاب استثنا در دسترس نیست، استفاده کرد. یادداشت‌های اضافه‌شده در ردگیری پشته‌ی پیش‌فرض ظاهر می‌شوند.

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

(مشارکت‌شده توسط Irit Katriel در bpo-45607. PEP نوشته‌شده توسط Zac Hatfield-Dodds.)

بهبودهای راه‌انداز py.exe ویندوز¶

نسخه‌ی مدیر نصب پایتون که به همراه پایتون 3.11 ارائه می‌شود، به‌طور قابل توجهی به‌روزرسانی شده است. این راه‌انداز اکنون با استفاده از آرگومان -V:<company>/<tag> به‌جای آرگومان محدود -<major>.<minor>، از سینتکس شرکت/برچسب تعریف‌شده در PEP 514 پشتیبانی می‌کند. این امکان را فراهم می‌کند که توزیع‌هایی غیر از PythonCore — یعنی همان توزیعی که در python.org میزبانی می‌شود — راه‌اندازی شوند.

هنگام استفاده از گزینش‌گرهای -V:، می‌توان شرکت یا برچسب را حذف کرد، اما همه‌ی نصب‌ها جستجو خواهند شد. برای مثال، -V:OtherPython/ «بهترین» برچسب ثبت‌شده برای OtherPython را انتخاب می‌کند، در حالی که -V:3.11 یا -V:/3.11 «بهترین» توزیع دارای برچسب 3.11 را انتخاب می‌کند.

هنگام استفاده از آرگومان‌های قدیمی -<major>، -<major>.<minor>، -<major>-<bitness> یا -<major>.<minor>-<bitness>، تمام رفتار موجود از نسخه‌های گذشته باید حفظ شود و تنها نسخه‌های PythonCore انتخاب خواهند شد. با این حال، پسوند -64 اکنون به معنای «۳۲بیتی نیست» است (نه لزوماً x86-64)، زیرا پلتفرم‌های ۶۴بیتی متعددی پشتیبانی می‌شوند. ران‌تایم‌های ۳۲بیتی با بررسی برچسب ران‌تایم از نظر وجود پسوند -32 تشخیص داده می‌شوند. همه‌ی نسخه‌های پایتون از 3.5 به بعد این مورد را در ساخت‌های ۳۲بیتی خود گنجانده‌اند.

PEP 646: نوع‌های عام چندآرگومانی (variadic generics)¶

PEP 484 پیش‌تر TypeVar را معرفی کرد که امکان ساخت عام‌های پارامتری‌سازی‌شده با یک نوع واحد را فراهم می‌کند. PEP 646 TypeVarTuple را اضافه می‌کند که امکان پارامتری‌سازی با تعداد دلخواهی از نوع‌ها را فراهم می‌کند. به عبارت دیگر، TypeVarTuple یک متغیر نوع variadic (variadic) است که عام‌های variadic را ممکن می‌سازد.

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

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

(ارائه‌شده توسط Matthew Rahtz در bpo-43224، همراه با مشارکت‌های Serhiy Storchaka و Jelle Zijlstra. PEP (پیشنهاد بهبود پایتون) نوشته‌شده توسط Mark Mendoza، Matthew Rahtz، Pradeep Kumar Srinivasan و Vincent Siles.)

PEP 655: نشانه‌گذاری آیتم‌های منفرد TypedDict به‌عنوان الزامی یا غیرالزامی¶

Required و NotRequired راهی سرراست برای علامت‌گذاری اینکه آیا آیتم‌های منفرد در یک TypedDict باید موجود باشند یا نه، ارائه می‌دهند. پیش‌تر، این کار تنها با استفاده از وراثت ممکن بود.

همه فیلدها همچنان به‌طور پیش‌فرض الزامی هستند، مگر آنکه پارامتر total به False تنظیم شود، که در این صورت همه فیلدها همچنان به‌طور پیش‌فرض غیرالزامی هستند. برای مثال، موارد زیر یک TypedDict با یک کلید الزامی و یک کلید غیرالزامی مشخص می‌کند:

class Movie(TypedDict):
   title: str
   year: NotRequired[int]

m1: Movie = {"title": "Black Panther", "year": 2018}  # OK
m2: Movie = {"title": "Star Wars"}  # OK (year is not required)
m3: Movie = {"year": 2022}  # ERROR (missing required field title)

تعریف زیر معادل است:

class Movie(TypedDict, total=False):
   title: Required[str]
   year: int

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

(مشارکت‌شده توسط David Foster و Jelle Zijlstra در bpo-47087. PEP نوشته‌شده توسط David Foster.)

PEP 673: نوع Self¶

حاشیه‌نویسی جدید Self راهی ساده و شهودی برای حاشیه‌نویسی کردن متدهایی که نمونه‌ای از کلاس خود را برمی‌گردانند فراهم می‌کند. این همانند رویکرد مبتنی بر TypeVar که در PEP 484 مشخص شده است، رفتار می‌کند؛ اما مختصرتر و آسان‌تر برای دنبال کردن است.

از موارد استفاده‌ی رایج می‌توان به سازنده‌های جایگزینی که به‌صورت classmethod ارائه می‌شوند و متدهای __enter__() که self را برمی‌گردانند اشاره کرد:

class MyLock:
    def __enter__(self) -> Self:
        self.lock()
        return self

    ...

class MyInt:
    @classmethod
    def fromhex(cls, s: str) -> Self:
        return cls(int(s, 16))

    ...

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

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

(مشارکت‌شده توسط James Hilton-Balfe در bpo-46534. PEP نوشته‌شده توسط Pradeep Kumar Srinivasan و James Hilton-Balfe.)

PEP 675: نوع رشته لفظی دلخواه¶

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

برای مثال، یک تابع پرس‌وجوی SQL را می‌توان به شرح زیر حاشیه‌نویسی کرد:

def run_query(sql: LiteralString) -> ...
    ...

def caller(
    arbitrary_string: str,
    query_string: LiteralString,
    table_name: LiteralString,
) -> None:
    run_query("SELECT * FROM students")       # ok
    run_query(query_string)                   # ok
    run_query("SELECT * FROM " + table_name)  # ok
    run_query(arbitrary_string)               # type checker error
    run_query(                                # type checker error
        f"SELECT * FROM students WHERE name = {arbitrary_string}"
    )

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

(ارائه‌شده توسط Jelle Zijlstra در bpo-47088. PEP نوشته‌شده توسط Pradeep Kumar Srinivasan و Graham Bleaney.)

PEP 681: تبدیل‌های دیتاکلاس¶

می‌توان از @dataclass_transform برای دکوریت کردن کلاس، فراکلاس یا تابعی که خود یک دکوراتور است استفاده کرد. وجود @dataclass_transform() به بررسی‌گر نوع ایستا می‌گوید که شیء دکوریت‌شده در ران‌تایم «جادو» انجام می‌دهد که یک کلاس را تبدیل می‌کند و به آن رفتارهایی مشابه dataclass می‌دهد.

برای مثال:

# The create_model decorator is defined by a library.
@typing.dataclass_transform()
def create_model(cls: Type[T]) -> Type[T]:
    cls.__init__ = ...
    cls.__eq__ = ...
    cls.__ne__ = ...
    return cls

# The create_model decorator can now be used to create new model classes:
@create_model
class CustomerModel:
    id: int
    name: str

c = CustomerModel(id=327, name="Eric Idle")

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

(مشارکت‌شده توسط Jelle Zijlstra در gh-91860. PEP نوشته‌شده توسط Erik De Bonte و Eric Traut.)

PEP 563 ممکن است آینده نباشد¶

PEP 563 ارزیابی به‌تعویق‌افتاده‌ی حاشیه‌نویسی‌ها (دستور آینده‌ی from __future__ import annotations) که در ابتدا برای انتشار در پایتون 3.10 برنامه‌ریزی شده بود، به‌طور نامعین به تعویق افتاده است. برای اطلاعات بیشتر، این پیام از شورای راهبری را ببینید.

asyncio¶

• کلاس TaskGroup افزوده شد؛ یک مدیر زمینه ناهمگام که گروهی از وظایف را نگه می‌دارد و هنگام خروج برای همه آن‌ها منتظر می‌ماند. برای کدهای جدید، استفاده از این کلاس به‌جای به‌کارگیری مستقیم create_task() و gather() توصیه می‌شود. (با مشارکت یوری سلیوانوف و دیگران در gh-90908.)

• timeout() افزوده شد؛ یک مدیر زمینه ناهمگام برای تعیین مهلت زمانی روی عملیات‌های ناهمگام. برای کدهای جدید، استفاده از این تابع به‌جای استفاده مستقیم از wait_for() توصیه می‌شود. (مشارکت‌شده توسط Andrew Svetlov در gh-90927.)

• کلاس Runner اضافه شد که سازوکار استفاده‌شده توسط run() را در دسترس قرار می‌دهد. (با مشارکت Andrew Svetlov در gh-91218.)

• کلاس Barrier به همراه استثنای مرتبط BrokenBarrierError به پریمیتیوهای همگام‌سازی در کتابخانه asyncio اضافه شد. (مشارکت‌شده توسط Yves Duprat و Andrew Svetlov در gh-87518.)

• آرگومان کلیدواژه‌ای all_errors به asyncio.loop.create_connection() افزوده شد تا بتوان چندین خطای اتصال را به‌صورت یک ExceptionGroup پرتاب کرد.

• متد asyncio.StreamWriter.start_tls() برای ارتقای اتصالات موجودِ مبتنی بر جریان به TLS افزوده شد. (مشارکت‌شده توسط Ian Good در bpo-34975.)

• توابع خام سوکت دیتاگرام به حلقه رویداد اضافه شدند: sock_sendto()، sock_recvfrom() و sock_recvfrom_into(). این توابع در SelectorEventLoop و ProactorEventLoop پیاده‌سازی شده‌اند. (مشارکت‌شده توسط Alex Grönholm در bpo-46805.)

• متدهای cancelling() و uncancel() به Task افزوده شدند. این متدها عمدتاً برای استفاده داخلی در نظر گرفته شده‌اند، به‌ویژه توسط TaskGroup.

contextlib¶

• مدیر زمینه‌ی chdir() که برای موازی‌سازی ایمن نیست، برای تغییر پوشه‌ی کاری جاری و سپس بازگردانی آن هنگام خروج اضافه شد. پوششی ساده حول chdir(). (مشارکت Filipe Laíns در bpo-25625)

dataclasses¶

• تغییر در بررسی تغییرپذیری پیش‌فرض فیلد، به‌طوری‌که فقط پیش‌فرض‌هایی که هش‌پذیر هستند مجاز باشند، به‌جای هر شیء‌ای که نمونه‌ای از dict، list یا set نباشد. (مشارکت‌شده توسط Eric V. Smith در bpo-44674.)

datetime¶

• افزودن datetime.UTC، یک نام مستعارِ کمکی برای datetime.timezone.utc. (مشارکت‌شده توسط Kabir Kwatra در gh-91973.)

• datetime.date.fromisoformat()، datetime.time.fromisoformat() و datetime.datetime.fromisoformat() اکنون می‌توانند برای تجزیه‌ی بیشتر قالب‌های ISO 8601 استفاده شوند (تنها به‌جز قالب‌هایی که از ساعت و دقیقه‌ی کسری پشتیبانی می‌کنند). (مشارکت Paul Ganssle در gh-80010.)

enum¶

• نام EnumMeta به EnumType تغییر یافت (EnumMeta به عنوان نام مستعار حفظ شد).

• کلاس StrEnum افزوده شد که اعضای آن می‌توانند به‌عنوان رشته استفاده شوند (و باید رشته باشند).

• کلاس ReprEnum افزوده شد که تنها __repr__() اعضا را تغییر می‌دهد، در حالی که مقادیر لفظی آن‌ها (به‌جای نام‌ها) را برای __str__() و __format__() برمی‌گرداند (که توسط str()، format() و اف‌استرینگ استفاده می‌شوند).

• متد Enum.__format__() (پیش‌فرض برای format()، str.format() و f-strings) تغییر کرد تا همیشه همان نتیجه‌ی Enum.__str__() را تولید کند: برای enumهایی که از ReprEnum ارث‌بری می‌کنند، مقدار عضو خواهد بود؛ برای همه‌ی enumهای دیگر، نام enum و نام عضو خواهد بود (مثلاً Color.RED).

• پارامتر کلاس جدید boundary به enum‌های Flag و enum FlagBoundary به همراه گزینه‌های آن افزوده شد تا نحوه‌ی برخورد با مقادیر پرچم خارج از محدوده را کنترل کند.

• دکوراتور enum verify() و enum EnumCheck به همراه گزینه‌های آن، برای بررسی کلاس‌های enum در برابر چندین محدودیت خاص افزوده شدند.

• دکوراتورهای member() و nonmember() اضافه شدند تا اطمینان حاصل شود که شیء دکوراتورشده به عضو enum تبدیل می‌شود/نمی‌شود.

• دکوراتور @property اضافه شد که مانند @property عمل می‌کند، به‌جز برای enum‌ها. به‌جای types.DynamicClassAttribute() از این استفاده کنید.

• دکوراتور enum global_enum() اضافه شد که __repr__() و __str__() را طوری تنظیم می‌کند که مقادیر را به‌عنوان اعضای ماژول خودشان به‌جای کلاس enum نمایش دهد. برای مثال، 're.ASCII' برای عضو ASCII از re.RegexFlag به‌جای 'RegexFlag.ASCII'.

• کلاس Flag بهبود یافت تا از len()، پیمایش و in/not in بر روی اعضای آن پشتیبانی کند. برای مثال، عبارت زیر اکنون کار می‌کند: len(AFlag(3)) == 2 and list(AFlag(3)) == (AFlag.ONE, AFlag.TWO)

• Enum و Flag تغییر یافتند به‌طوری‌که اعضا اکنون پیش از فراخوانی __init_subclass__() تعریف می‌شوند؛ dir() اکنون متدها و غیره از نوع‌های داده‌ی میکس‌این را شامل می‌شود.

• کلاس Flag تغییر کرد تا فقط مقادیر اصلی (توان دو) را کانونیکال در نظر بگیرد، در حالی که مقادیر مرکب (3، 6، 10 و غیره) به‌عنوان نام‌های مستعار در نظر گرفته می‌شوند؛ پرچم‌های معکوس به معادل مثبت خود تبدیل ضمنی می‌شوند.

fcntl¶

• در FreeBSD، پرچم‌های F_DUP2FD و F_DUP2FD_CLOEXEC پشتیبانی می‌شوند که به ترتیب، اولی معادل استفاده از dup2 است و دومی علاوه بر آن پرچم FD_CLOEXEC را نیز تنظیم می‌کند.

fractions¶

• پشتیبانی از مقداردهی اولیه‌ی Fraction از رشته به سبک PEP 515. (مشارکت‌شده توسط Sergey B Kirpichev در bpo-44258.)

• Fraction اکنون یک متد __int__ را پیاده‌سازی می‌کند، به‌طوری که بررسی isinstance(some_fraction, typing.SupportsInt) پاس می‌شود. (ارائه‌شده توسط Mark Dickinson در bpo-44547.)

functools¶

• @functools.singledispatch اکنون از types.UnionType و typing.Union به‌عنوان حاشیه‌نویسی برای آرگومان ارسال پشتیبانی می‌کند.:

  >>> from functools import singledispatch
  >>> @singledispatch
  ... def fun(arg, verbose=False):
  ...     if verbose:
  ...         print("Let me just say,", end=" ")
  ...     print(arg)
  ...
  >>> @fun.register
  ... def _(arg: int | float, verbose=False):
  ...     if verbose:
  ...         print("Strength in numbers, eh?", end=" ")
  ...     print(arg)
  ...
  >>> from typing import Union
  >>> @fun.register
  ... def _(arg: Union[list, set], verbose=False):
  ...     if verbose:
  ...         print("Enumerate this:")
  ...     for i, elem in enumerate(arg):
  ...         print(i, elem)
  ...
  

  (مشارکت‌شده توسط یوری کاراباس در bpo-46014.)

gzip¶

• تابع gzip.compress() اکنون هنگامی که با آرگومان mtime=0 استفاده می‌شود، سریع‌تر است، زیرا فشرده‌سازی را به‌طور کامل به یک عملیات zlib.compress() واگذار می‌کند. این تغییر یک اثر جانبی دارد: پرونده gzip در سرآیند خود یک بایت «OS» دارد. این بایت به‌طور سنتی همیشه توسط ماژول gzip روی مقدار ۲۵۵ که نشان‌دهنده‌ی «نامعلوم» است تنظیم می‌شد. اکنون، هنگام استفاده از compress() با mtime=0، ممکن است این بایت توسط کتابخانه‌ی C زیرین zlib که پایتون با آن پیوند یافته است، روی مقدار متفاوتی تنظیم شود. (برای جزئیات درباره‌ی این اثر جانبی، gh-112346 را ببینید.)

hashlib¶

• hashlib.blake2b() و hashlib.blake2s() اکنون libb2 را به نسخه‌ی داخلی (vendored) پایتون ترجیح می‌دهند. (مشارکت‌شده توسط Christian Heimes در bpo-47095.)

• ماژول داخلی _sha3 با الگوریتم‌های SHA3 و SHAKE اکنون به‌جای Keccak Code Package از tiny_sha3 استفاده می‌کند تا حجم کد و پرونده دودویی کاهش یابد. ماژول hashlib پیاده‌سازی‌های بهینه‌شده‌ی SHA3 و SHAKE از OpenSSL را ترجیح می‌دهد. این تغییر فقط بر نصب‌هایی که از OpenSSL پشتیبانی نمی‌کنند تأثیر می‌گذارد. (مشارکت‌شده توسط Christian Heimes در bpo-47098.)

• افزودن hashlib.file_digest()، تابعی کمکی برای هش‌سازی کارآمد پرونده‌ها یا اشیاء شبه‌پرونده. (ارائه‌شده توسط Christian Heimes در gh-89313.)

IDLE و idlelib¶

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

• گنجاندن اعلان‌ها هنگام ذخیره‌ی پوسته به‌همراه ورودی‌ها و خروجی‌ها. (مشارکت توسط Terry Jan Reedy در gh-95191.)

inspect¶

• افزودن getmembers_static() برای بازگرداندن همه اعضا بدون راه‌اندازی جستجوی پویا از طریق پروتکل توصیف‌گر. (مشارکت‌شده توسط Weipeng Hong در bpo-30533.)

• افزودن ismethodwrapper() برای بررسی اینکه آیا نوع یک شیء MethodWrapperType است. (مشارکت‌شده توسط Hakan Çelik در bpo-29418.)

• توابع مرتبط با فریم در ماژول inspect تغییر کرده‌اند تا نمونه‌های جدیدی از کلاس‌های FrameInfo و Traceback را بازگردانند (سازگار به عقب با رابط‌های شبیه تاپل نام‌دار پیشین) که اطلاعات موقعیت توسعه‌یافته‌ی PEP 657 (شماره سطر پایان، ستون و ستون پایان) را در بر می‌گیرند. توابع تحت تأثیر عبارت‌اند از:

  • inspect.getframeinfo()

  • inspect.getouterframes()

  • inspect.getinnerframes()،

  • inspect.stack()

  • inspect.trace()

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

locale¶

• تابع locale.getencoding() برای دریافت کدگذاری locale جاری اضافه شد. این تابع مشابه locale.getpreferredencoding(False) است، اما حالت UTF-8 پایتون را نادیده می‌گیرد.

logging¶

• تابع getLevelNamesMapping() اضافه شد تا نگاشتی از نام‌های سطوح گزارش‌گیری (مانند 'CRITICAL') به مقادیر سطوح گزارش‌گیری متناظرشان (مانند 50، به‌طور پیش‌فرض) را برگرداند. (مشارکت Andrei Kulakovin در gh-88024.)

• متد createSocket() به SysLogHandler اضافه شد تا با SocketHandler.createSocket() مطابقت داشته باشد. این متد به‌طور خودکار در طول مقداردهی اولیه‌ی هندلر و هنگام صدور یک رویداد، در صورت نبود سوکت فعال، فراخوانی می‌شود. (مشارکت‌شده توسط Kirill Pinchuk در gh-88457.)

math¶

• افزودن math.exp2(): بازگرداندن ۲ به توان x. (مشارکت‌شده توسط گیدئون میچل در bpo-45917.)

• افزودن math.cbrt(): بازگرداندن ریشه سوم x. (مشارکت‌شده توسط آجیت راماشاندران در bpo-44357.)

• رفتار دو حالت گوشه‌ای از math.pow() برای سازگاری با مشخصات IEEE 754 تغییر کرد. عملیات‌های math.pow(0.0, -math.inf) و math.pow(-0.0, -math.inf) اکنون inf را برمی‌گردانند. قبلاً این عملیات‌ها استثنای ValueError را ایجاد می‌کردند. (مشارکت Mark Dickinson در bpo-44339.)

• مقدار math.nan اکنون همیشه در دسترس است. (مشارکت‌شده توسط ویکتور استینر در bpo-46917.)

operator¶

• تابع جدید operator.call افزوده شده است، به‌طوری‌که operator.call(obj, *args, **kwargs) == obj(*args, **kwargs). (با مشارکت Antony Lee در bpo-44019.)

os¶

• در ویندوز، os.urandom() اکنون به جای CryptGenRandom() که منسوخ شده است، از BCryptGenRandom() استفاده می‌کند. (مشارکت‌شده توسط Donghee Na در bpo-44611.)

pathlib¶

• glob() و rglob() تنها پوشه‌ها را برمی‌گردانند اگر الگو به جداکننده‌ی اجزای مسیرنام ختم شود: sep یا altsep. (ارائه‌شده توسط ایسوکه کاواسوما در bpo-22276 و bpo-33392.)

re¶

• گروه‌بندی اتمی ((?>...)) و کمیت‌گذارهای مالکانه (*+، ++، ?+، {m,n}+) اکنون در عبارات باقاعده پشتیبانی می‌شوند. (مشارکت‌شده توسط Jeffrey C. Jacobs و Serhiy Storchaka در bpo-433030.)

shutil¶

• افزودن پارامتر اختیاری dir_fd در shutil.rmtree(). (مشارکت‌کرده: Serhiy Storchaka در bpo-46245.)

socket¶

• پشتیبانی از سوکت CAN برای NetBSD افزوده شد. (با مشارکت Thomas Klausner در bpo-30512.)

• create_connection() گزینه‌ای دارد که در صورت شکست در اتصال، به‌جای اینکه تنها آخرین خطا ایجاد شود، یک ExceptionGroup شامل تمام خطاها ایجاد می‌کند. (مشارکت‌شده توسط ایریت کاتریل در bpo-29980.)

sqlite3¶

• اکنون می‌توانید مجوز‌دهنده (authorizer) را با ارسال None به set_authorizer() غیرفعال کنید. (مشارکت‌شده توسط Erlend E. Aasland در bpo-44491.)

• نام ترتیب‌گذاریِ create_collation() اکنون می‌تواند شامل هر نویسه‌ی یونیکدی باشد. نام‌های ترتیب‌گذاری با نویسه‌های نامعتبر اکنون به جای sqlite3.ProgrammingError خطای UnicodeEncodeError ایجاد می‌کنند. (مشارکت‌شده توسط Erlend E. Aasland در bpo-44688.)

• استثناهای sqlite3 اکنون کد خطای توسعه‌یافته‌ی SQLite را به‌صورت sqlite_errorcode و نام خطای SQLite را به‌صورت sqlite_errorname در بر می‌گیرند. (مشارکت‌شده توسط Aviv Palivoda، Daniel Shahaf و Erlend E. Aasland در bpo-16379 و bpo-24139.)

• افزودن setlimit() و getlimit() به sqlite3.Connection برای تنظیم و دریافت محدودیت‌های SQLite به ازای هر اتصال. (با مشارکت Erlend E. Aasland در bpo-45243.)

• sqlite3 اکنون sqlite3.threadsafety را بر اساس حالت نخ‌بندی پیش‌فرضی که کتابخانه‌ی زیربنایی SQLite با آن کامپایل شده است، تنظیم می‌کند. (مشارکت اِرلِند اِی. آسلاند در bpo-45613.)

• کال‌بک‌های C ماژول sqlite3 اکنون در صورت فعال بودن ردگیری‌های کال‌بک، از استثناهای غیرقابل‌پرتاب (unraisable) استفاده می‌کنند. کاربران اکنون می‌توانند یک هندلر قلاب غیرقابل‌پرتاب (unraisable) ثبت کنند تا تجربه اشکال‌زدایی خود را بهبود بخشند. (مشارکت‌شده توسط Erlend E. Aasland در bpo-45828.)

• واکشی در حین بازگردانی دیگر InterfaceError برنمی‌انگیزد. در عوض، مدیریت این موارد را به کتابخانه SQLite واگذار می‌کنیم. (مشارکت: Erlend E. Aasland در bpo-44092.)

• متدهای serialize() و deserialize() برای سریال‌سازی و سریال‌زدایی پایگاه‌های داده به sqlite3.Connection افزوده شدند. (ارائه‌شده توسط Erlend E. Aasland در bpo-41930.)

• افزودن create_window_function() به sqlite3.Connection برای ایجاد توابع پنجره‌ای تجمیعی. (مشارکت‌شده توسط ارلند ای. آسلند در bpo-34916.)

• افزودن blobopen() به sqlite3.Connection. sqlite3.Blob امکان انجام عملیات ورودی/خروجی افزایشی بر روی بلاب‌ها را فراهم می‌کند. (مشارکت‌شده توسط آویو پالیوودا و ارلند ای. آسلند در bpo-24905.)

string¶

• افزودن get_identifiers() و is_valid() به string.Template، که به ترتیب همه‌ی جای‌نگهدارهای معتبر و اینکه آیا جای‌نگهدار نامعتبری وجود دارد یا خیر را برمی‌گردانند. (مشارکت Ben Kehoe در gh-90465.)

sys¶

• sys.exc_info() اکنون فیلدهای type و traceback را از value (نمونه‌ی استثنا) استخراج می‌کند؛ بنابراین وقتی استثنا در حین مدیریت آن تغییر داده شود، این تغییرات در نتایج فراخوانی‌های بعدی exc_info() منعکس می‌شوند. (مشارکت‌شده توسط Irit Katriel در bpo-45711.)

• افزودن sys.exception() که نمونه استثنای فعال را برمی‌گرداند (معادل sys.exc_info()[1]). (مشارکت Irit Katriel در bpo-46328.)

• افزودن پرچم sys.flags.safe_path. (مشارکت‌شده توسط Victor Stinner در gh-57684.)

sysconfig¶

• سه طرح‌واره‌ی نصب جدید (posix_venv، nt_venv و venv) افزوده شدند و زمانی استفاده می‌شوند که پایتون محیط‌های مجازی جدید ایجاد کند یا از یک محیط مجازی در حال اجرا باشد. دو طرح‌واره‌ی نخست (posix_venv و nt_venv) مختص سیستم‌عامل‌اند و به ترتیب برای غیر ویندوز و ویندوز هستند؛ venv در واقع بسته به سیستم‌عاملی که پایتون روی آن اجرا می‌شود، مستعار یکی از آن‌هاست. این موضوع برای توزیع‌کنندگان پایین‌دستی که sysconfig.get_preferred_scheme() را تغییر می‌دهند مفید است. کد شخص ثالثی که محیط‌های مجازی جدید ایجاد می‌کند، باید برای تعیین مسیرها از طرح‌واره‌ی نصب جدید venv استفاده کند، همان‌طور که venv انجام می‌دهد. (مشارکت‌شده توسط Miro Hrončok در bpo-45413.)

tempfile¶

• اشیاء SpooledTemporaryFile اکنون متدهای io.BufferedIOBase یا io.TextIOBase را به‌طور کامل پیاده‌سازی می‌کنند (بسته به حالت پرونده). این امر باعث می‌شود آن‌ها به‌درستی با APIهایی که انتظار شیء شبه‌پرونده دارند، مانند ماژول‌های فشرده‌سازی، کار کنند. (مشارکت از Carey Metcalfe در gh-70363.)

threading¶

• در یونیکس، اگر تابع sem_clockwait() در کتابخانه C موجود باشد (glibc 2.30 و نسخه‌های جدیدتر)، متد threading.Lock.acquire() اکنون برای مهلت زمانی از ساعت یکنواخت (time.CLOCK_MONOTONIC) استفاده می‌کند، نه از ساعت سیستم (time.CLOCK_REALTIME)، تا از تغییرات ساعت سیستم تأثیر نپذیرد. (مشارکت‌شده توسط ویکتور استینر در bpo-41710.)

time¶

• در یونیکس، time.sleep() اکنون در صورت موجود بودن، از تابع clock_nanosleep() یا nanosleep() استفاده می‌کند که وضوح ۱ نانوثانیه (10^-9 ثانیه) دارد، به‌جای استفاده از select() که وضوح ۱ میکروثانیه (10^-6 ثانیه) دارد. (با همکاری Benjamin Szőke و Victor Stinner در bpo-21302.)

• در ویندوز 8.1 و جدیدتر، time.sleep() اکنون از یک تایمر انتظارپذیر (waitable timer) مبتنی بر تایمرهای با وضوح بالا استفاده می‌کند که وضوحی برابر با ۱۰۰ نانوثانیه (10^-7 ثانیه) دارد. پیش از این، وضوح آن ۱ میلی‌ثانیه (10^-3 ثانیه) بود. (مشارکت‌شده توسط Benjamin Szőke، Donghee Na، Eryk Sun و Victor Stinner در bpo-21302 و bpo-45429.)

tkinter¶

• متد info_patchlevel() اضافه شد که نسخه دقیق کتابخانه Tcl را به‌صورت یک تاپل نام‌دار مشابه sys.version_info برمی‌گرداند. (مشارکت Serhiy Storchaka در gh-91827.)

traceback¶

• افزودن traceback.StackSummary.format_frame_summary() تا کاربران بتوانند بازنویسی کنند که کدام فریم‌ها در ردگیری ظاهر شوند و چگونه قالب‌بندی شوند. (مشارکت‌شده توسط Ammar Askar در bpo-44569.)

• افزودن traceback.TracebackException.print() که نمونه‌ی قالب‌بندی‌شده‌ی TracebackException را در یک پرونده چاپ می‌کند. (مشارکت‌شده توسط Irit Katriel در bpo-33809.)

typing¶

برای تغییرات عمده، به قابلیت‌های جدید مرتبط با راهنماهای نوع مراجعه کنید.

• افزودن typing.assert_never() و typing.Never. typing.assert_never() برای درخواست از بررسی‌گر نوع جهت تأیید اینکه یک سطر از کد دسترس‌ناپذیر است، مفید است. در زمان اجرا، این تابع استثنای AssertionError را برمی‌اندازد. (مشارکت‌شده توسط Jelle Zijlstra در gh-90633.)

• افزودن typing.reveal_type(). این تابع برای پرسیدن از بررسی‌گر نوع درباره‌ی اینکه چه نوعی را برای یک عبارت معین استنتاج کرده است، مفید است. در زمان اجرا، نوع مقدار دریافت‌شده را چاپ می‌کند. (مشارکت‌شده توسط Jelle Zijlstra در gh-90572.)

• افزودن typing.assert_type(). این تابع برای اینکه از بررسی‌گر نوع بخواهید تأیید کند که نوعی که برای یک عبارت معین استنباط کرده است، با نوع داده‌شده مطابقت دارد، مفید است. در زمان اجرا، این تابع صرفاً مقدار دریافت‌شده را برمی‌گرداند. (مشارکت‌کرده توسط Jelle Zijlstra در gh-90638.)

• نوع‌های typing.TypedDict اکنون می‌توانند عام باشند. (مشارکت‌شده توسط Samodya Abeysiriwardane در gh-89026.)

• نوع‌های NamedTuple اکنون می‌توانند عام باشند. (مشارکت‌شده توسط Serhiy Storchaka در bpo-43923.)

• زیرکلاس‌سازی از typing.Any مجاز است. این برای پرهیز از خطاهای بررسی‌گر نوع مرتبط با کلاس‌های بسیار پویا، مانند ماک‌ها، مفید است. (مشارکت‌شده توسط Shantanu Jain در gh-91154.)

• دکوراتور @typing.final اکنون ویژگی __final__ را روی شیء تزئین‌شده تنظیم می‌کند. (مشارکت‌شده توسط یله زیلسترا در gh-90500.)

• از تابع typing.get_overloads() می‌توان برای درون‌نگری سربارگذاری‌های یک تابع استفاده کرد. از typing.clear_overloads() می‌توان برای پاک کردن تمام سربارگذاری‌های ثبت‌شده‌ی یک تابع استفاده کرد. (مشارکت‌شده توسط Jelle Zijlstra در gh-89263.)

• متد __init__() در زیرکلاس‌های Protocol اکنون حفظ می‌شود. (مشارکت‌شده توسط Adrian Garcia Badarasco در gh-88970.)

• نمایش نوع‌های تاپل خالی (Tuple[()]) ساده‌سازی شده است. این امر بر درون‌نگری تأثیر می‌گذارد؛ برای مثال، get_args(Tuple[()]) اکنون به جای ((),) به () ارزیابی می‌شود. (مشارکت‌شده توسط Serhiy Storchaka در gh-91137.)

• سست‌کردن الزامات ران‌تایم برای حاشیه‌نویسی‌های نوع با حذف بررسی فراخوانی‌پذیری در تابع خصوصی typing._type_check. (مشارکت‌شده توسط گرگوری بورگارد در gh-90802.)

• typing.get_type_hints() اکنون از ارزیابی رشته‌ها به‌عنوان ارجاع‌های پیشرو در مستعارهای عام PEP 585 پشتیبانی می‌کند. (مشارکت‌شده توسط Niklas Rosenstein در gh-85542.)

• typing.get_type_hints() دیگر Optional را به پارامترهایی که مقدار پیش‌فرض آن‌ها None است اضافه نمی‌کند. (مشارکت‌شده توسط Nikita Sobolev در gh-90353.)

• typing.get_type_hints() اکنون از ارزیابی حاشیه‌نویسی‌های رشته‌ایِ ساده‌ی ClassVar پشتیبانی می‌کند. (مشارکت از سوی Gregory Beauregard در gh-90711.)

• @typing.no_type_check دیگر کلاس‌ها و توابع خارجی را تغییر نمی‌دهد. همچنین اکنون به‌درستی classmethodها را به‌عنوان مواردی که نباید از نظر نوع بررسی شوند علامت‌گذاری می‌کند. (با مشارکت Nikita Sobolev در gh-90729.)

unicodedata¶

• پایگاه داده‌ی یونیکد به نسخه‌ی 14.0.0 به‌روزرسانی شده است. (مشارکت‌شده توسط Benjamin Peterson در bpo-45190).

unittest¶

• متدهای enterContext() و enterClassContext() از کلاس TestCase، متد enterAsyncContext() از کلاس IsolatedAsyncioTestCase و تابع unittest.enterModuleContext() افزوده شدند. (نوشته‌ی Serhiy Storchaka در bpo-45046.)

venv¶

• هنگامی که محیط‌های مجازی جدید پایتون ایجاد می‌شوند، venv از طرح‌واره نصب sysconfig برای تعیین مسیرهای درون محیط استفاده می‌کند. وقتی پایتون در یک محیط مجازی اجرا می‌شود، همان طرح‌واره نصب پیش‌فرض است. این بدان معناست که توزیع‌کنندگان پایین‌دست می‌توانند طرح‌واره نصب پیش‌فرض sysconfig را بدون تغییر رفتار محیط‌های مجازی تغییر دهند. کدهای شخص ثالثی که محیط‌های مجازی جدید ایجاد می‌کنند نیز باید همین کار را انجام دهند. (مشارکت‌شده توسط Miro Hrončok در bpo-45413.)

warnings¶

• warnings.catch_warnings() اکنون آرگومان‌هایی برای warnings.simplefilter() می‌پذیرد و راهی مختصرتر برای نادیده گرفتن هشدارها به‌صورت محلی یا تبدیل آن‌ها به خطا فراهم می‌کند. (ارائه‌شده توسط Zac Hatfield-Dodds در bpo-47074.)

zipfile¶

• پشتیبانی از تعیین کدگذاری نام عضو برای خواندن فراداده‌ها در پوشه و سرآیند‌های پرونده‌ی یک ZipFile اضافه شد. (مشارکت‌شده توسط Stephen J. Turnbull و Serhiy Storchaka در bpo-28080.)

• ZipFile.mkdir() برای ایجاد پوشه‌های جدید درون آرشیوهای ZIP اضافه شد. (با مشارکت Sam Ezeh در gh-49083.)

• stem، suffix و suffixes به zipfile.Path افزوده شدند. (مشارکت‌شده توسط میگل بریتو در gh-88261.)

راه‌اندازی سریع‌تر¶

خواندن __pycache__ -> مارشال‌گشایی -> شیء کد تخصیص‌یافته در هیپ -> ارزیابی

شیء کدِ تخصیص‌یافته به‌طور ایستا -> ارزیابی

ران‌تایم سریع‌تر¶

متفرقه¶

• اشیاء اکنون به دلیل اینکه فضاهای نامشان به‌صورت تنبل ایجاد می‌شوند، به حافظه‌ی کمتری نیاز دارند. دیکشنری‌های فضای نام آن‌ها نیز اکنون کلیدها را آزادانه‌تر به اشتراک می‌گذارند. (مشارکت مارک شانون در bpo-45340 و bpo-40116.)

• استثناهای «بدون هزینه» (zero-cost) پیاده‌سازی شده‌اند که هزینه‌ی دستورهای try را در زمانی که هیچ استثنایی رخ نمی‌دهد، از بین می‌برند. (با مشارکت Mark Shannon در bpo-40222.)

• نمایش مختصرترِ استثناها در مفسر، زمان مورد نیاز برای گرفتن یک استثنا را حدود ۱۰ درصد کاهش داد. (مشارکت‌شده توسط Irit Katriel در bpo-45711.)

• موتور تطبیق عبارت باقاعده‌ی ماژول re تا حدی بازآرایی شده است و اکنون در پلتفرم‌های پشتیبانی‌شده از پرش‌های محاسبه‌شده (computed gotos) (یا «کد زنجیره‌ای» (threaded code)) استفاده می‌کند. در نتیجه، پایتون 3.11 بنچمارک‌های عبارت باقاعده‌ی pyperformance را تا ۱۰٪ سریع‌تر از پایتون 3.10 اجرا می‌کند. (مشارکت‌شده توسط Brandt Bucher در gh-91404.)

پرسش‌های متداول¶

درباره¶

Faster CPython به بررسی بهینه‌سازی‌هایی برای CPython می‌پردازد. تیم اصلی توسط مایکروسافت تأمین مالی می‌شود تا به‌صورت تمام‌وقت روی این کار کند. پابلو گالیندو سالگادو نیز توسط Bloomberg LP تأمین مالی می‌شود تا به‌صورت پاره‌وقت روی این پروژه کار کند. در نهایت، بسیاری از مشارکت‌کنندگان داوطلبانی از کامیونیتی هستند.

آپ‌کد‌های جدید¶

• ASYNC_GEN_WRAP، RETURN_GENERATOR و SEND، که در تولیدگرها و هم‌روال‌ها استفاده می‌شوند.

• COPY_FREE_VARS، که از نیاز به کد خاص سمت فراخواننده برای بستار‌ها جلوگیری می‌کند.

• JUMP_BACKWARD_NO_INTERRUPT، برای استفاده در حلقه‌های خاصی که مدیریت وقفه‌ها در آن‌ها نامطلوب است.

• MAKE_CELL، برای ایجاد شیءهای سلول.

• CHECK_EG_MATCH و PREP_RERAISE_STAR، برای مدیریت گروه‌های استثنا و except* جدید افزوده‌شده در PEP 654.

• PUSH_EXC_INFO، برای استفاده در هندلرهای استثنا.

• RESUME، یک عملیات بی‌اثر، برای ردگیری داخلی، اشکال‌زدایی و بررسی‌های بهینه‌سازی.

آپ‌کد‌های جایگزین‌شده¶

آپ‌کد‌های تغییر‌یافته/حذف‌شده¶

• MATCH_CLASS و MATCH_KEYS تغییر کردند تا دیگر مقدار بولی اضافی برای نشان دادن موفقیت/شکست روی پشته قرار ندهند. در عوض، None در صورت شکست به جای تاپل مقادیر استخراج‌شده روی پشته قرار می‌گیرد.

• کدهای عملی که با استثناها کار می‌کنند تغییر کردند تا بازتاب دهند که استثناها اکنون به‌جای سه آیتم، به‌صورت یک آیتم روی پشته نمایش داده می‌شوند (نگاه کنید به gh-89874).

• COPY_DICT_WITHOUT_KEYS، GEN_START، POP_BLOCK، SETUP_FINALLY و YIELD_FROM حذف شدند.

زبان/توکارها¶

• زنجیره‌سازی توصیف‌گرهای classmethod (که در bpo-19072 معرفی شد) اکنون منسوخ شده است. دیگر نمی‌توان از آن برای پوشش دادن توصیف‌گرهای دیگر مانند property استفاده کرد. طراحی اصلی این قابلیت معیوب بود و باعث بروز تعدادی مشکل پایین‌دستی شد. برای «عبور دادن» (pass-through) یک classmethod، استفاده از ویژگی __wrapped__ (که در پایتون 3.10 اضافه شد) را در نظر بگیرید. (مشارکت‌شده توسط ریموند هتینگر در gh-89519.)

• گریزهای مبنای هشت در مقادیر لفظی رشته و بایت که مقداری بزرگ‌تر از 0o377 (۲۵۵ در مبنای ده) دارند، اکنون یک DeprecationWarning تولید می‌کنند. در نسخه‌ای آینده از پایتون، این گریزها یک SyntaxWarning و در نهایت یک SyntaxError ایجاد خواهند کرد. (مشارکت‌شده توسط Serhiy Storchaka در gh-81548.)

• واگذاری int() به __trunc__() اکنون منسوخ شده است. فراخوانی int(a) زمانی که type(a) __trunc__() را پیاده‌سازی می‌کند اما __int__() یا __index__() را پیاده‌سازی نمی‌کند، اکنون یک DeprecationWarning ایجاد می‌کند. (مشارکت‌شده توسط Zackery Spytz در bpo-44977.)

ماژول‌ها¶

• PEP 594 منجر به منسوخ شدن ماژول‌های زیر شد که قرار بود در Python 3.13 حذف شوند:

  aifc	chunk	msilib	pipes	telnetlib
  audioop	crypt	nis	sndhdr	uu
  cgi	imghdr	nntplib	spwd	xdrlib
  cgitb	mailcap	ossaudiodev	sunau

  (با مشارکت Brett Cannon در bpo-47061 و Victor Stinner در gh-68966.)

• ماژول‌های asynchat، asyncore و smtpd دست‌کم از پایتون 3.6 منسوخ شده‌اند. مستندات و هشدارهای منسوخ‌شدگی آن‌ها اکنون به‌روزرسانی شده‌اند تا ذکر کنند که در پایتون 3.12 حذف خواهند شد. (مشارکت‌شده توسط Hugo van Kemenade در bpo-47022.)

• بسته‌ی lib2to3 و ابزار 2to3 اکنون منسوخ شده‌اند و ممکن است نتوانند پایتون 3.10 یا جدیدتر را تجزیه کنند. برای جزئیات به PEP 617، که پارسر جدید PEG را معرفی می‌کند، مراجعه کنید. (با مشارکت Victor Stinner در bpo-40360.)

• ماژول‌های مستندنشده sre_compile، sre_constants و sre_parse اکنون منسوخ شده‌اند. (مشارکت‌شده توسط Serhiy Storchaka در bpo-47152.)

کتابخانه استاندارد¶

• موارد زیر از زمان پایتون 3.2 در configparser منسوخ شده‌اند. هشدارهای منسوخ‌شدن آن‌ها اکنون به‌روزرسانی شده‌اند تا یادآور شوند که در پایتون 3.12 حذف خواهند شد:

  • کلاس configparser.SafeConfigParser

  • ویژگی configparser.ParsingError.filename

  • متد configparser.RawConfigParser.readfp()

  (مشارکت‌شده توسط هوگو ون کمِناده در bpo-45173.)

• configparser.LegacyInterpolation از پایتون 3.2 در رشته مستند خود منسوخ اعلام شده و در مستندات configparser فهرست نشده است. این کلاس اکنون DeprecationWarning را نشان می‌دهد و در پایتون 3.13 حذف خواهد شد. به جای آن از configparser.BasicInterpolation یا configparser.ExtendedInterpolation استفاده کنید. (مشارکت‌شده توسط هوگو ون کمِناده در bpo-46607.)

• مجموعه قدیمی‌تر توابع importlib.resources به نفع جایگزین‌های افزوده‌شده در Python 3.9 منسوخ شده‌اند و به دلیل پشتیبانی نکردن از منابع واقع در زیرپوشه‌های بسته، در نسخه‌ای آینده از پایتون حذف خواهند شد:

  • importlib.resources.contents()

  • importlib.resources.is_resource()

  • importlib.resources.open_binary()

  • importlib.resources.open_text()

  • importlib.resources.read_binary()

  • importlib.resources.read_text()

  • importlib.resources.path()

• تابع locale.getdefaultlocale() منسوخ شده است و در پایتون 3.15 حذف خواهد شد. به جای آن از توابع locale.setlocale()، locale.getpreferredencoding(False) و locale.getlocale() استفاده کنید. (مشارکت‌شده توسط Victor Stinner در gh-90817.)

• تابع locale.resetlocale() منسوخ شده است و در پایتون 3.13 حذف خواهد شد. به‌جای آن از locale.setlocale(locale.LC_ALL, "") استفاده کنید. (مشارکت‌شده توسط Victor Stinner در gh-90817.)

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

• در ماژول re، تابع re.template() و پرچم‌های متناظر re.TEMPLATE و re.T منسوخ شده‌اند، زیرا مستند نشده بودند و هدف روشنی نداشتند. این موارد در پایتون 3.13 حذف خواهند شد. (مشارکت‌شده توسط Serhiy Storchaka و Miro Hrončok در gh-92728.)

• turtle.settiltangle() از پایتون 3.1 منسوخ شده است؛ این تابع اکنون هشدار منسوخ‌شدن منتشر می‌کند و در پایتون 3.13 حذف خواهد شد. به جای آن از turtle.tiltangle() استفاده کنید (این تابع پیش‌تر به اشتباه به عنوان منسوخ علامت‌گذاری شده بود و رشته مستند آن اکنون اصلاح شده است). (مشارکت‌شده توسط Hugo van Kemenade در bpo-45837.)

• typing.Text که صرفاً برای فراهم‌کردن پشتیبانی از سازگاری بین کد پایتون 2 و پایتون 3 وجود دارد، اکنون منسوخ شده است. در حال حاضر برنامه‌ای برای حذف آن وجود ندارد، اما به کاربران توصیه می‌شود در هر جا که ممکن است، به جای آن از str استفاده کنند. (مشارکت‌شده توسط Alex Waygood در gh-92332.)

• سینتکس آرگومان کلیدواژه‌ای برای ساخت نوع‌های typing.TypedDict اکنون منسوخ شده است. پشتیبانی از آن در پایتون 3.13 حذف خواهد شد. (مشارکت‌شده توسط Jingchen Ye در gh-90224.)

• webbrowser.MacOSX منسوخ شده است و در پایتون 3.13 حذف خواهد شد. این کلاس آزمون‌نشده و مستندسازی‌نشده است و خودِ webbrowser از آن استفاده نمی‌کند. (مشارکت‌شده توسط Donghee Na در bpo-42255.)

• رفتار برگرداندن مقدار از متدهای آزمون TestCase و IsolatedAsyncioTestCase (به‌جز مقدار پیش‌فرض None) اکنون منسوخ شده است.

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

  • unittest.findTestCases()

  • unittest.makeSuite()

  • unittest.getTestCaseNames()

  به‌جای آن از متدهای TestLoader استفاده کنید:

  • unittest.TestLoader.loadTestsFromModule()

  • unittest.TestLoader.loadTestsFromTestCase()

  • unittest.TestLoader.getTestCaseNames()

  (ارائه‌شده توسط Erlend E. Aasland در bpo-5846.)

• unittest.TestProgram.usageExit() به‌عنوان منسوخ علامت‌گذاری شده است و در 3.13 حذف خواهد شد. (مشارکت‌شده توسط Carlos Damázio در gh-67048.)

ویژگی‌های جدید¶

• تابع جدید PyType_GetName() برای دریافت نام کوتاه نوع اضافه شد. (مشارکت‌شده توسط Hai Shi در bpo-42035.)

• تابع جدید PyType_GetQualName() برای دریافت نام کامل نوع اضافه شد. (مشارکت Hai Shi در bpo-42035.)

• توابع جدید PyThreadState_EnterTracing() و PyThreadState_LeaveTracing() برای تعلیق و از سر گرفتن ردیابی و پروفایل‌گیری به C API محدود اضافه شدند. (با مشارکت ویکتور استینر در bpo-43760.)

• ثابت Py_Version که همان مقدار PY_VERSION_HEX را دارد، اضافه شد. (مشارکت‌شده توسط Gabriele N. Tornetta در bpo-43931.)

• Py_buffer و APIها اکنون بخشی از API محدود و ABI پایدار هستند:

  • PyObject_CheckBuffer()

  • PyObject_GetBuffer()

  • PyBuffer_GetPointer()

  • PyBuffer_SizeFromFormat()

  • PyBuffer_ToContiguous()

  • PyBuffer_FromContiguous()

  • PyObject_CopyData()

  • PyBuffer_IsContiguous()

  • PyBuffer_FillContiguousStrides()

  • PyBuffer_FillInfo()

  • PyBuffer_Release()

  • PyMemoryView_FromBuffer()

  • جایگاه‌های نوع bf_getbuffer و bf_releasebuffer

  (با مشارکت کریستین هایمز در bpo-45459.)

• تابع PyType_GetModuleByDef() افزوده شد که در مواردی که این اطلاعات به‌طور مستقیم (از طریق PyCMethod) در دسترس نیست، برای به‌دست‌آوردن ماژولی که متدی در آن تعریف شده است استفاده می‌شود. (مشارکت Petr Viktorin در bpo-46613.)

• توابع جدیدی برای بسته‌بندی و واگشایی ممیز شناور با دقت مضاعف زبان C (سریال‌سازی و سریال‌زدایی) اضافه شدند: PyFloat_Pack2()، PyFloat_Pack4()، PyFloat_Pack8()، PyFloat_Unpack2()، PyFloat_Unpack4() و PyFloat_Unpack8(). (با مشارکت Victor Stinner در bpo-46906.)

• توابع جدیدی برای دریافت ویژگی‌های شیء فریم افزوده شد: PyFrame_GetBuiltins()، PyFrame_GetGenerator()، PyFrame_GetGlobals()، PyFrame_GetLasti().

• دو تابع جدید برای دریافت و تنظیم نمونه‌ی استثنای فعال افزوده شد: PyErr_GetHandledException() و PyErr_SetHandledException(). این توابع جایگزین‌هایی برای PyErr_SetExcInfo() و PyErr_GetExcInfo() هستند که با نمایش تاپل سه‌گانه‌ی قدیمی استثناها کار می‌کنند. (مشارکت‌شده توسط ایریت کاتریل در bpo-46343.)

• عضو PyConfig.safe_path افزوده شد. (مشارکت‌شده توسط Victor Stinner در gh-57684.)

مهاجرت به پایتون 3.11¶

• برخی ماکروها برای پرهیز از دام‌های ماکرو، به توابع درون‌خطی ایستا تبدیل‌شده‌اند. این تغییر باید عمدتاً از دید کاربران پنهان باشد، زیرا توابع جایگزین، برای پرهیز از هشدارهای کامپایلر ناشی از بررسی‌های نوع ایستا، آرگومان‌های خود را به نوع‌های مورد انتظار تبدیل نوع می‌کنند. با این حال، وقتی C API محدود روی >=3.11 تنظیم‌شده باشد، این تبدیل‌های نوع انجام نمی‌شوند و فراخوان‌کنندگان باید آرگومان‌ها را به نوع‌های مورد انتظارشان تبدیل نوع کنند. برای جزئیات بیشتر به PEP 670 مراجعه کنید. (با مشارکت Victor Stinner و Erlend E. Aasland در gh-89653.)

• تابع PyErr_SetExcInfo() دیگر از آرگومان‌های type و traceback استفاده نمی‌کند؛ مفسر اکنون این مقادیر را از نمونه‌ی استثنا (آرگومان value) به دست می‌آورد. این تابع همچنان ارجاع‌های هر سه آرگومان را می‌دزدد. (با مشارکت Irit Katriel در bpo-45711.)

• PyErr_GetExcInfo() اکنون فیلد‌های type و traceback نتیجه را از نمونه‌ی استثنا (فیلد value) به دست می‌آورد. (مشارکت‌شده توسط Irit Katriel در bpo-45711.)

• _frozen یک فیلد جدید is_package دارد که نشان می‌دهد ماژول فریزشده یک بسته است یا خیر. پیش‌تر، مقدار منفی در فیلد size نشانگر این موضوع بود. اکنون فقط مقادیر نامنفی برای size استفاده می‌شوند. (مشارکت‌شده توسط Kumar Aditya در bpo-46608.)

• _PyFrameEvalFunction() اکنون به جای PyFrameObject*، _PyInterpreterFrame* را به‌عنوان پارامتر دوم خود می‌گیرد. برای جزئیات بیشتر درباره‌ی نحوه‌ی استفاده از این نوع اشاره‌گر تابع، به PEP 523 مراجعه کنید.

• PyCode_New() و PyCode_NewWithPosOnlyArgs() اکنون یک آرگومان اضافی exception_table دریافت می‌کنند. تا حد امکان باید از استفاده از این توابع پرهیز کرد. برای به دست آوردن یک شیء کد سفارشی: یک شیء کد با استفاده از کامپایلر بسازید، سپس نسخه‌ی اصلاح‌شده‌ی آن را با متد replace به دست آورید.

• PyCodeObject دیگر فیلدهای co_code، co_varnames، co_cellvars و co_freevars را ندارد. در عوض، برای دسترسی به آن‌ها از طریق API زبان C، به ترتیب از PyCode_GetCode()، PyCode_GetVarnames()، PyCode_GetCellvars() و PyCode_GetFreevars() استفاده کنید. (مشارکت Brandt Bucher در bpo-46841 و Ken Jin در gh-92154 و gh-94936.)

• ماکروهای قدیمی سطل زباله (trashcan) (Py_TRASHCAN_SAFE_BEGIN/Py_TRASHCAN_SAFE_END) اکنون منسوخ شده‌اند. آن‌ها باید با ماکروهای جدید Py_TRASHCAN_BEGIN و Py_TRASHCAN_END جایگزین شوند.

  تابع tp_dealloc که ماکروهای قدیمی را دارد، مانند:

  static void
  mytype_dealloc(mytype *p)
  {
      PyObject_GC_UnTrack(p);
      Py_TRASHCAN_SAFE_BEGIN(p);
      ...
      Py_TRASHCAN_SAFE_END
  }
  

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

  static void
  mytype_dealloc(mytype *p)
  {
      PyObject_GC_UnTrack(p);
      Py_TRASHCAN_BEGIN(p, mytype_dealloc)
      ...
      Py_TRASHCAN_END
  }
  

  توجه داشته باشید که Py_TRASHCAN_BEGIN آرگومان دومی دارد که باید تابع تخصیص‌زدایی باشد؛ تابعی که این ماکرو در آن قرار دارد.

  برای پشتیبانی از نسخه‌های قدیمی‌تر پایتون در همان پایگاه کد (codebase)، می‌توانید ماکروهای زیر را تعریف کنید و در سراسر کد از آن‌ها استفاده کنید (منبع: این ماکروها از پایگاه کد mypy کپی شده‌اند):

  #if PY_VERSION_HEX >= 0x03080000
  #  define CPy_TRASHCAN_BEGIN(op, dealloc) Py_TRASHCAN_BEGIN(op, dealloc)
  #  define CPy_TRASHCAN_END(op) Py_TRASHCAN_END
  #else
  #  define CPy_TRASHCAN_BEGIN(op, dealloc) Py_TRASHCAN_SAFE_BEGIN(op)
  #  define CPy_TRASHCAN_END(op) Py_TRASHCAN_SAFE_END(op)
  #endif
  

• تابع PyType_Ready() اکنون هنگامی خطا ایجاد می‌کند که نوعی با پرچم Py_TPFLAGS_HAVE_GC تنظیم‌شده تعریف شود، اما تابع پیمایش (PyTypeObject.tp_traverse) نداشته باشد. (مشارکت‌شده توسط Victor Stinner در bpo-44263.)

• نوع‌های هیپ با پرچم Py_TPFLAGS_IMMUTABLETYPE اکنون می‌توانند پروتکل فراخوانی برداری (vectorcall) PEP 590 را به ارث ببرند. پیش‌تر، این تنها برای نوع‌های ایستا امکان‌پذیر بود. (مشارکت‌شده توسط Erlend E. Aasland در bpo-43908)

• از آنجا که Py_TYPE() به یک تابع ایستای درون‌خطی تغییر یافته است، Py_TYPE(obj) = new_type باید با Py_SET_TYPE(obj, new_type) جایگزین شود: تابع Py_SET_TYPE() را ببینید (از پایتون 3.9 به بعد در دسترس است). برای سازگاری با نسخه‌های پیشین، می‌توان از این ماکرو استفاده کرد:

  #if PY_VERSION_HEX < 0x030900A4 && !defined(Py_SET_TYPE)
  static inline void _Py_SET_TYPE(PyObject *ob, PyTypeObject *type)
  { ob->ob_type = type; }
  #define Py_SET_TYPE(ob, type) _Py_SET_TYPE((PyObject*)(ob), type)
  #endif
  

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

• از آنجا که Py_SIZE() به یک تابع ایستای درون‌خطی تبدیل شده است، عبارت Py_SIZE(obj) = new_size باید با Py_SET_SIZE(obj, new_size) جایگزین شود: تابع Py_SET_SIZE() را ببینید (از پایتون 3.9 در دسترس است). برای سازگاری با نسخه‌های پیشین، می‌توان از این ماکرو استفاده کرد:

  #if PY_VERSION_HEX < 0x030900A4 && !defined(Py_SET_SIZE)
  static inline void _Py_SET_SIZE(PyVarObject *ob, Py_ssize_t size)
  { ob->ob_size = size; }
  #define Py_SET_SIZE(ob, size) _Py_SET_SIZE((PyVarObject*)(ob), size)
  #endif
  

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

• وقتی ماکروی Py_LIMITED_API روی 0x030b0000 (پایتون 3.11) یا بالاتر تنظیم شده باشد، <Python.h> دیگر پرونده‌های سرآیند <stdlib.h>، <stdio.h>، <errno.h> و <string.h> را شامل نمی‌شود. ماژول‌های توسعه‌ای C باید پس از #include <Python.h> پرونده‌های سرآیند را به‌طور صریح گنجانند. (مشارکت‌شده توسط Victor Stinner در bpo-45434.)

• پرونده‌های API غیرمحدود cellobject.h، classobject.h، code.h، context.h، funcobject.h، genobject.h و longintrepr.h به پوشه‌ی Include/cpython منتقل شده‌اند. علاوه بر این، پرونده‌ی سرآیند eval.h حذف شد. این پرونده‌ها نباید مستقیماً گنجانده شوند، زیرا از قبل در Python.h گنجانده شده‌اند: Include Files. اگر این پرونده‌ها مستقیماً گنجانده شده‌اند، به‌جای آن‌ها Python.h را بگنجانید. (مشارکت‌شده توسط Victor Stinner در bpo-35134.)

• ماکروی PyUnicode_CHECK_INTERNED() از API محدود C حذف شده است. این ماکرو هرگز در آنجا قابل استفاده نبود، زیرا از ساختارهای داخلی‌ای استفاده می‌کرد که در API محدود C در دسترس نیستند. (مشارکت‌شده توسط Victor Stinner در bpo-46007.)

• توابع و نوع فریم زیر اکنون به‌طور مستقیم با #include <Python.h> در دسترس هستند و دیگر نیازی به افزودن #include <frameobject.h> نیست:

  • PyFrame_Check()

  • PyFrame_GetBack()

  • PyFrame_GetBuiltins()

  • PyFrame_GetGenerator()

  • PyFrame_GetGlobals()

  • PyFrame_GetLasti()

  • PyFrame_GetLocals()

  • PyFrame_Type

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

• اعضای ساختار PyFrameObject از API عمومی C حذف شده‌اند.

  اگرچه مستندات اشاره می‌کند که فیلدهای PyFrameObject ممکن است در هر زمان تغییر کنند، این فیلدها مدت‌هاست پایدار بوده‌اند و در چندین توسعه‌ی محبوب استفاده شده‌اند.

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

  فیلد‌های PyFrameObject:

  • f_back: از PyFrame_GetBack() استفاده کنید.

  • f_blockstack: حذف شد.

  • f_builtins: از PyFrame_GetBuiltins() استفاده کنید.

  • f_code: از PyFrame_GetCode() استفاده کنید.

  • f_gen: از PyFrame_GetGenerator() استفاده کنید.

  • f_globals: از PyFrame_GetGlobals() استفاده کنید.

  • f_iblock: حذف شد.

  • f_lasti: از PyFrame_GetLasti() استفاده کنید. کدهایی که از f_lasti به‌همراه PyCode_Addr2Line() استفاده می‌کنند، باید به‌جای آن از PyFrame_GetLineNumber() استفاده کنند؛ ممکن است سریع‌تر باشد.

  • f_lineno: از PyFrame_GetLineNumber() استفاده کنید

  • f_locals: از PyFrame_GetLocals() استفاده کنید.

  • f_stackdepth: حذف شد.

  • f_state: API عمومی ندارد (به f_frame.f_state تغییر نام داده شد).

  • f_trace: API عمومی ندارد.

  • f_trace_lines: از PyObject_GetAttrString((PyObject*)frame, "f_trace_lines") استفاده کنید.

  • f_trace_opcodes: از PyObject_GetAttrString((PyObject*)frame, "f_trace_opcodes") استفاده کنید.

  • f_localsplus: API عمومی ندارد (تغییر نام یافته به f_frame.localsplus).

  • f_valuestack: حذف شد.

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

  اشکال‌زداهایی که مستقیماً به f_locals دسترسی داشتند، باید به جای آن PyFrame_GetLocals() را فراخوانی کنند. آن‌ها دیگر نیازی به فراخوانی PyFrame_FastToLocalsWithError() یا PyFrame_LocalsToFast() ندارند؛ در واقع نباید آن توابع را فراخوانی کنند. به‌روزرسانی لازم فریم اکنون توسط ماشین مجازی مدیریت می‌شود.

  کدی که PyFrame_GetCode() را در پایتون 3.8 و قدیمی‌تر تعریف می‌کند:

  #if PY_VERSION_HEX < 0x030900B1
  static inline PyCodeObject* PyFrame_GetCode(PyFrameObject *frame)
  {
      Py_INCREF(frame->f_code);
      return frame->f_code;
  }
  #endif
  

  کدی که PyFrame_GetBack() را در پایتون 3.8 و نسخه‌های قدیمی‌تر تعریف می‌کند:

  #if PY_VERSION_HEX < 0x030900B1
  static inline PyFrameObject* PyFrame_GetBack(PyFrameObject *frame)
  {
      Py_XINCREF(frame->f_back);
      return frame->f_back;
  }
  #endif
  

  یا برای به دست آوردن این دو تابع در نسخه‌های قدیمی‌تر پایتون، از پروژه‌ی pythoncapi_compat استفاده کنید.

• تغییرات اعضای ساختار PyThreadState:

  • frame: حذف شد؛ از PyThreadState_GetFrame() استفاده کنید (تابعی که با bpo-40429 به پایتون 3.9 افزوده شد). هشدار: این تابع یک ارجاع قوی برمی‌گرداند؛ باید Py_XDECREF() را فراخوانی کنید.

  • tracing: تغییر کرده است؛ از PyThreadState_EnterTracing() و PyThreadState_LeaveTracing() استفاده کنید (توابعی که با bpo-43760 به پایتون 3.11 اضافه شدند).

  • recursion_depth: حذف شد؛ به‌جای آن از (tstate->recursion_limit - tstate->recursion_remaining) استفاده کنید.

  • stackcheck_counter: حذف شد.

  کدی که PyThreadState_GetFrame() را در پایتون 3.8 و قدیمی‌تر تعریف می‌کند:

  #if PY_VERSION_HEX < 0x030900B1
  static inline PyFrameObject* PyThreadState_GetFrame(PyThreadState *tstate)
  {
      Py_XINCREF(tstate->frame);
      return tstate->frame;
  }
  #endif
  

  کدی که PyThreadState_EnterTracing() و PyThreadState_LeaveTracing() را در پایتون 3.10 و قدیمی‌تر تعریف می‌کند:

  #if PY_VERSION_HEX < 0x030B00A2
  static inline void PyThreadState_EnterTracing(PyThreadState *tstate)
  {
      tstate->tracing++;
  #if PY_VERSION_HEX >= 0x030A00A1
      tstate->cframe->use_tracing = 0;
  #else
      tstate->use_tracing = 0;
  #endif
  }
  
  static inline void PyThreadState_LeaveTracing(PyThreadState *tstate)
  {
      int use_tracing = (tstate->c_tracefunc != NULL || tstate->c_profilefunc != NULL);
      tstate->tracing--;
  #if PY_VERSION_HEX >= 0x030A00A1
      tstate->cframe->use_tracing = use_tracing;
  #else
      tstate->use_tracing = use_tracing;
  #endif
  }
  #endif
  

  یا برای دریافت این توابع در توابع پایتون قدیمی، از پروژه‌ی pythoncapi-compat استفاده کنید.

• توزیع‌کنندگان تشویق می‌شوند که پایتون را با کتابخانه بهینه‌شده Blake2 با نام libb2 بسازند.

• اکنون باید فیلد PyConfig.module_search_paths_set روی 1 تنظیم شود تا مقداردهی اولیه از PyConfig.module_search_paths برای مقداردهی اولیه‌ی sys.path استفاده کند. در غیر این صورت، مقداردهی اولیه مسیر را دوباره محاسبه خواهد کرد و هر مقداری را که به module_search_paths افزوده شده باشد جایگزین خواهد کرد.

• PyConfig_Read() دیگر مسیر جستجوی اولیه را محاسبه نمی‌کند و هیچ مقداری را در PyConfig.module_search_paths قرار نمی‌دهد. برای محاسبه‌ی مسیرهای پیش‌فرض و سپس تغییر آن‌ها، بوت‌استرپ را به پایان برسانید و با استفاده از PySys_GetObject()، sys.path را به‌عنوان یک شیء فهرست پایتونی بازیابی کنید و آن را مستقیماً تغییر دهید.

منسوخ¶

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

  • PySys_AddWarnOptionUnicode()

  • PySys_AddWarnOption()

  • PySys_AddXOption()

  • PySys_HasWarnOptions()

  • PySys_SetArgvEx()

  • PySys_SetArgv()

  • PySys_SetPath()

  • Py_SetPath()

  • Py_SetProgramName()

  • Py_SetPythonHome()

  • Py_SetStandardStreamEncoding()

  • _Py_SetProgramFullPath()

  به جای آن از API جدید PyConfig در پیکربندی مقداردهی اولیه پایتون استفاده کنید (PEP 587). (مشارکت‌شده توسط Victor Stinner در gh-88279.)

• عضو ob_shash از PyBytesObject منسوخ شد. به جای آن از PyObject_Hash() استفاده کنید. (مشارکت‌شده توسط Inada Naoki در bpo-46864.)

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

APIهای C زیر در نسخه‌های پیشین پایتون منسوخ شده‌اند و در پایتون 3.12 حذف خواهند شد.

• PyUnicode_AS_DATA()

• PyUnicode_AS_UNICODE()

• PyUnicode_AsUnicodeAndSize()

• PyUnicode_AsUnicode()

• PyUnicode_FromUnicode()

• PyUnicode_GET_DATA_SIZE()

• PyUnicode_GET_SIZE()

• PyUnicode_GetSize()

• PyUnicode_IS_COMPACT()

• PyUnicode_IS_READY()

• PyUnicode_READY()

• PyUnicode_WSTR_LENGTH()

• _PyUnicode_AsUnicode()

• PyUnicode_WCHAR_KIND

• PyUnicodeObject

• PyUnicode_InternImmortal()

حذف‌شده¶

• PyFrame_BlockSetup() و PyFrame_BlockPop() حذف شده‌اند. (مشارکت‌شده توسط مارک شنون در bpo-40222.)

• ماکروهای ریاضی زیر با استفاده از متغیر errno حذف شدند:

  • Py_ADJUST_ERANGE1()

  • Py_ADJUST_ERANGE2()

  • Py_OVERFLOWED()

  • Py_SET_ERANGE_IF_OVERFLOW()

  • Py_SET_ERRNO_ON_MATH_ERROR()

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

• ماکروهای Py_UNICODE_COPY() و Py_UNICODE_FILL() که از پایتون 3.3 منسوخ شده بودند، حذف شدند. به‌جای آن‌ها از توابع PyUnicode_CopyCharacters() یا memcpy() (رشته‌ی wchar_t*) و PyUnicode_Fill() استفاده کنید. (مشارکت‌شده توسط ویکتور استینر در bpo-41123.)

• پرونده‌ی سرآیند pystrhex.h حذف شد. این پرونده فقط شامل توابع خصوصی است. افزونه‌های C باید فقط پرونده‌ی سرآیند اصلی <Python.h> را شامل کنند. (مشارکت‌شده توسط Victor Stinner در bpo-45434.)

• ماکروی Py_FORCE_DOUBLE() حذف شد. این ماکرو توسط ماکروی Py_IS_INFINITY() استفاده می‌شد. (مشارکت‌شده توسط Victor Stinner در bpo-45440.)

• موارد زیر هنگامی که Py_LIMITED_API تعریف شده باشد، دیگر در دسترس نیستند:

  • PyMarshal_WriteLongToFile()

  • PyMarshal_WriteObjectToFile()

  • PyMarshal_ReadObjectFromString()

  • PyMarshal_WriteObjectToString()

  • ماکروی Py_MARSHAL_VERSION

  این‌ها بخشی از API محدود نیستند.

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

• تابع PyWeakref_GET_OBJECT() از API محدود C حذف شد. این تابع هیچ‌وقت کار نمی‌کرد زیرا ساختار PyWeakReference در API محدود C به صورت کدر (opaque) است. (مشارکت‌کرده توسط Victor Stinner در bpo-35134.)

• ماکرو PyHeapType_GET_MEMBERS() حذف شد. این ماکرو به اشتباه در API عمومی C افشا شده بود و تنها باید به‌صورت داخلی توسط پایتون استفاده شود. در عوض از عضو PyTypeObject.tp_members استفاده کنید. (مشارکت‌شده توسط Victor Stinner در bpo-40170.)

• ماکروی HAVE_PY_SET_53BIT_PRECISION حذف شد (به API داخلی C منتقل شد). (با مشارکت Victor Stinner در bpo-45412.)

• APIهای کدگذارِ Py_UNICODE حذف شدند، زیرا از پایتون 3.3 منسوخ شده‌اند، کم استفاده می‌شوند و نسبت به جایگزین‌های توصیه‌شده ناکارآمد هستند.

  توابع حذف‌شده عبارت‌اند از:

  • PyUnicode_Encode()

  • PyUnicode_EncodeASCII()

  • PyUnicode_EncodeLatin1()

  • PyUnicode_EncodeUTF7()

  • PyUnicode_EncodeUTF8()

  • PyUnicode_EncodeUTF16()

  • PyUnicode_EncodeUTF32()

  • PyUnicode_EncodeUnicodeEscape()

  • PyUnicode_EncodeRawUnicodeEscape()

  • PyUnicode_EncodeCharmap()

  • PyUnicode_TranslateCharmap()

  • PyUnicode_EncodeDecimal()

  • PyUnicode_TransformDecimalToASCII()

  برای جزئیات و راهنمای مهاجرت، به PEP 624 و راهنمای مهاجرت مراجعه کنید. (مشارکت‌شده توسط Inada Naoki در bpo-44029.)

tarfile¶

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

OpenSSL¶

• نسخه‌های ویندوز و نصب‌کننده‌های macOS از python.org اکنون از OpenSSL 3.0 استفاده می‌کنند.