مدیران زمینه درون پرانتز¶

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

with (CtxManager() as example):
    ...

with (
    CtxManager1(),
    CtxManager2()
):
    ...

with (CtxManager1() as example,
      CtxManager2()):
    ...

with (CtxManager1(),
      CtxManager2() as example):
    ...

with (
    CtxManager1() as example1,
    CtxManager2() as example2
):
    ...

همچنین می‌توان در انتهای گروه محصورشده از یک کامای انتهایی استفاده کرد:

with (
    CtxManager1() as example1,
    CtxManager2() as example2,
    CtxManager3() as example3,
):
    ...

این سینتکس جدید از قابلیت‌های غیر LL(1) پارسر جدید استفاده می‌کند. برای جزئیات بیشتر به PEP 617 مراجعه کنید.

(مشارکت‌شده توسط Guido van Rossum، Pablo Galindo و Lysandros Nikolaou در bpo-12782 و bpo-40334.)

پیام‌های خطای بهتر¶

expected = {9: 1, 18: 2, 19: 2, 27: 3, 28: 3, 29: 3, 36: 4, 37: 4,
            38: 4, 39: 4, 45: 5, 46: 5, 47: 5, 48: 5, 49: 5, 54: 6,
some_other_code = foo()

File "example.py", line 3
    some_other_code = foo()
                    ^
SyntaxError: invalid syntax

File "example.py", line 1
    expected = {9: 1, 18: 2, 19: 2, 27: 3, 28: 3, 29: 3, 36: 4, 37: 4,
               ^
SyntaxError: '{' was never closed

>>> foo(x, z for z in range(10), t, w)
  File "<stdin>", line 1
    foo(x, z for z in range(10), t, w)
           ^
SyntaxError: Generator expression must be parenthesized

>>> foo(x, z for z in range(10), t, w)
  File "<stdin>", line 1
    foo(x, z for z in range(10), t, w)
           ^^^^^^^^^^^^^^^^^^^^
SyntaxError: Generator expression must be parenthesized

>>> def foo():
...    if lel:
...    x = 2
  File "<stdin>", line 3
    x = 2
    ^
IndentationError: expected an indented block after 'if' statement in line 2

>>> collections.namedtoplo
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
AttributeError: module 'collections' has no attribute 'namedtoplo'. Did you mean: namedtuple?

>>> schwarzschild_black_hole = None
>>> schwarschild_black_hole
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
NameError: name 'schwarschild_black_hole' is not defined. Did you mean: schwarzschild_black_hole?

PEP 626: شماره‌های دقیق سطر برای اشکال‌زدایی و ابزارهای دیگر¶

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

ویژگی f_lineno در اشیاء فریم همیشه شماره سطر مورد انتظار را در بر خواهد گرفت.

ویژگی codeobject.co_lnotab از اشیای کد منسوخ شده است و در نسخه‌ی 3.12 حذف خواهد شد. کدهایی که نیاز دارند آفست را به شماره سطر تبدیل کنند، باید به جای آن از روش co_lines() استفاده کنند.

PEP 634: تطبیق الگوی ساختاری¶

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

match subject:
    case <pattern_1>:
        <action_1>
    case <pattern_2>:
        <action_2>
    case <pattern_3>:
        <action_3>
    case _:
        <action_wildcard>

def http_error(status):
    match status:
        case 400:
            return "Bad request"
        case 404:
            return "Not found"
        case 418:
            return "I'm a teapot"
        case _:
            return "Something's wrong with the internet"

case 401 | 403 | 404:
    return "Not allowed"

def http_error(status):
    match status:
        case 400:
            return "Bad request"
        case 404:
            return "Not found"
        case 418:
            return "I'm a teapot"

# point is an (x, y) tuple
match point:
    case (0, 0):
        print("Origin")
    case (0, y):
        print(f"Y={y}")
    case (x, 0):
        print(f"X={x}")
    case (x, y):
        print(f"X={x}, Y={y}")
    case _:
        raise ValueError("Not a point")

class Point:
    def __init__(self, x, y):
        self.x = x
        self.y = y

def location(point):
    match point:
        case Point(x=0, y=0):
            print("Origin is the point's location.")
        case Point(x=0, y=y):
            print(f"Y={y} and the point is on the y-axis.")
        case Point(x=x, y=0):
            print(f"X={x} and the point is on the x-axis.")
        case Point():
            print("The point is located somewhere else on the plane.")
        case _:
            print("Not a point")

Point(1, var)
Point(1, y=var)
Point(x=1, y=var)
Point(y=var, x=1)

match points:
    case []:
        print("No points in the list.")
    case [Point(0, 0)]:
        print("The origin is the only point in the list.")
    case [Point(x, y)]:
        print(f"A single point {x}, {y} is in the list.")
    case [Point(0, y1), Point(0, y2)]:
        print(f"Two points on the Y axis at {y1}, {y2} are in the list.")
    case _:
        print("Something else is found in the list.")

match test_variable:
    case ('warning', code, 40):
        print("A warning has been received.")
    case ('error', code, _):
        print(f"An error {code} occurred.")

match point:
    case Point(x, y) if x == y:
        print(f"The point is located on the diagonal Y=X at {x}.")
    case Point(x, y):
        print(f"Point is not on the diagonal.")

گزینه‌ی اختیاری EncodingWarning و encoding="locale"¶

کدگذاری پیش‌فرض TextIOWrapper و open() به پلتفرم و locale وابسته است. از آنجا که در بیشتر پلتفرم‌های یونیکس از UTF-8 استفاده می‌شود، حذف گزینه‌ی encoding هنگام باز کردن پرونده‌های UTF-8 (مثلاً JSON، YAML، TOML، Markdown) اشکال بسیار رایجی است. برای مثال:

# BUG: "rb" mode or encoding="utf-8" should be used.
with open("data.json") as f:
    data = json.load(f)

برای یافتن این نوع اشکال، یک EncodingWarning اختیاری اضافه شده است. این هشدار زمانی نشان داده می‌شود که sys.flags.warn_default_encoding برابر با true باشد و از کدگذاری پیش‌فرض وابسته به locale استفاده شود.

گزینه‌ی -X warn_default_encoding و PYTHONWARNDEFAULTENCODING برای فعال‌سازی هشدار افزوده شده‌اند.

برای اطلاعات بیشتر به کدگذاری متن مراجعه کنید.

PEP 604: عملگر جدید اجتماع نوع¶

یک عملگر جدید برای اجتماع نوع‌ها معرفی شد که سینتکس X | Y را ممکن می‌سازد. این کار راهی تمیزتر برای بیان «نوع X یا نوع Y» به‌جای استفاده از typing.Union فراهم می‌کند، به‌ویژه در راهنماهای نوع.

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

def square(number: Union[int, float]) -> Union[int, float]:
    return number ** 2

اکنون می‌توان راهنماهای نوع را به شیوه‌ای موجزتر نوشت:

def square(number: int | float) -> int | float:
    return number ** 2

این سینتکس جدید همچنین به عنوان آرگومان دوم برای isinstance() و issubclass() پذیرفته می‌شود:

>>> isinstance(1, int | str)
True

برای جزئیات بیشتر به نوع اجتماعی (Union Type) و PEP 604 مراجعه کنید.

(با مشارکت Maggie Moss و Philippe Prados در bpo-41428، و با افزوده‌های Yurii Karabas و Serhiy Storchaka در bpo-44490.)

PEP 612: متغیرهای مشخصات پارامتر¶

دو گزینه جدید برای بهبود اطلاعاتی که برای Callable مربوط به PEP 484 به بررسی‌گرهای نوع ایستا ارائه می‌شود، به ماژول typing اضافه شده‌اند.

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

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

برای جزئیات بیشتر به typing.Callable، typing.ParamSpec، typing.Concatenate، typing.ParamSpecArgs، typing.ParamSpecKwargs و PEP 612 مراجعه کنید.

(مشارکت‌شده توسط کن جین در bpo-41559، با بهبودهای جزئی از سوی یله زیلسترا در bpo-43783. PEP نوشته‌شده توسط مارک مندوزا.)

PEP 613: TypeAlias¶

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

StrCache = 'Cache[str]'  # a type alias
LOG_PREFIX = 'LOG[DEBUG]'  # a module constant

اکنون ماژول typing یک مقدار خاص TypeAlias دارد که به شما اجازه می‌دهد مستعارهای نوع را به‌طور صریح‌تر اعلان کنید:

StrCache: TypeAlias = 'Cache[str]'  # a type alias
LOG_PREFIX = 'LOG[DEBUG]'  # a module constant

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

(با مشارکت میخائیل گولوبف در bpo-41923.)

PEP 647: نگهبان‌های نوع تعریف‌شده توسط کاربر¶

TypeGuard برای حاشیه‌نویسی توابع نگهبان نوع (type guard) و بهبود اطلاعاتی که در حین محدودسازی نوع (type narrowing) به بررسی‌گرهای نوع ایستا ارائه می‌شود، به ماژول typing افزوده شده است. برای اطلاعات بیشتر، لطفاً مستندات TypeGuardو PEP 647 را مشاهده کنید.

(ارائه‌شده توسط Ken Jin و Guido van Rossum در bpo-43766. PEP نوشته‌شده توسط Eric Traut.)

asyncio¶

متد مفقود connect_accepted_socket() افزوده شد. (مشارکت‌شده توسط الکس گرونهولم در bpo-41332.)

argparse¶

عبارت گمراه‌کننده‌ی «optional arguments» در راهنمای argparse با «options» جایگزین شد. ممکن است برخی آزمون‌ها در صورتی که به تطبیق دقیق خروجی تکیه دارند، نیازمند اصلاح باشند. (مشارکت‌شده توسط Raymond Hettinger در bpo-9694.)

array¶

متد index() از array.array اکنون پارامترهای اختیاری start و stop دارد. (مشارکت Anders Lorentsen و Zackery Spytz در bpo-31956.)

asynchat, asyncore, smtpd¶

این ماژول‌ها از پایتون 3.6 در مستندات ماژول‌شان به‌عنوان منسوک علامت‌گذاری شده‌اند. اکنون یک DeprecationWarning در زمان ایمپورت به هر سه‌ی این ماژول‌ها اضافه شده است.

base64¶

افزودن base64.b32hexencode() و base64.b32hexdecode() برای پشتیبانی از کدگذاری Base32 با الفبای مبنای شانزده‌ی توسعه‌یافته.

bdb¶

افزودن clearBreakpoints() برای بازنشانی همه‌ی نقطه‌های توقف تنظیم‌شده. (مشارکت‌شده توسط Irit Katriel در bpo-24160.)

bisect¶

امکان ارائه یک تابع کلید به APIهای ماژول bisect افزوده شد. (مشارکت Raymond Hettinger در bpo-4356.)

codecs¶

تابع codecs.unregister() برای لغو ثبت یک تابع جست‌وجوی کدک اضافه شد. (مشارکت Hai Shi در bpo-41842.)

collections.abc¶

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

contextlib¶

یک مدیر زمینه contextlib.aclosing() برای بستن ایمن تولیدگرهای ناهمگام و اشیایی که نماینده منابع آزادشده به‌صورت ناهمگام هستند، اضافه شد. (مشارکت Joongi Kim و John Belmonte در bpo-41229.)

پشتیبانی از مدیر زمینه ناهمگام به contextlib.nullcontext() اضافه شد. (مشارکت‌شده توسط Tom Gringauz در bpo-41543.)

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

curses¶

توابع رنگ توسعه‌یافته‌ای که در ncurses 6.1 افزوده شده‌اند، به‌صورت شفاف توسط curses.color_content()، curses.init_color()، curses.init_pair() و curses.pair_content() استفاده خواهند شد. یک تابع جدید، curses.has_extended_color_support()، نشان می‌دهد که آیا پشتیبانی از رنگ‌های توسعه‌یافته توسط کتابخانه‌ی زیرین ncurses فراهم شده است یا خیر. (مشارکت‌شده توسط Jeffrey Kintscher و Hans Petter Jansson در bpo-36982.)

ثابت‌های BUTTON5_* اکنون در ماژول curses در دسترس قرار گرفته‌اند، در صورتی که توسط کتابخانه curses زیرین فراهم شده باشند. (با مشارکت Zackery Spytz در bpo-39273.)

dataclasses¶

from dataclasses import dataclass

@dataclass(kw_only=True)
class Birthday:
    name: str
    birthday: datetime.date

from dataclasses import dataclass, field

@dataclass
class Birthday:
    name: str
    birthday: datetime.date = field(kw_only=True)

from dataclasses import dataclass, KW_ONLY

@dataclass
class Point:
    x: float
    y: float
    _: KW_ONLY
    z: float = 0.0
    t: float = 0.0

distutils¶

کل بسته‌ی distutils منسوخ شده است و در پایتون 3.12 حذف خواهد شد. کارکرد آن برای مشخص‌کردن ساخت بسته‌ها پیش‌تر به‌طور کامل توسط بسته‌های شخص ثالث setuptools و packaging جایگزین شده است و بیشتر APIهای پرکاربرد دیگر نیز در جای دیگری از کتابخانه استاندارد در دسترس هستند (مانند platform، shutil، subprocess یا sysconfig). هیچ برنامه‌ای برای انتقال کارکردهای دیگر از distutils وجود ندارد و برنامه‌هایی که از توابع دیگر استفاده می‌کنند باید برای تهیه‌ی رونوشت‌های خصوصی از کد برنامه‌ریزی کنند. برای بحث به PEP 632 مراجعه کنید.

فرمان bdist_wininst که در پایتون 3.8 منسوخ شده بود، حذف شد. فرمان bdist_wheel اکنون برای توزیع بسته‌های دودویی در ویندوز توصیه می‌شود. (مشارکت‌شده توسط Victor Stinner در bpo-42802.)

doctest¶

هنگامی که یک ماژول __loader__ را تعریف نمی‌کند، به __spec__.loader بازمی‌گردد. (مشارکت‌شده توسط Brett Cannon در bpo-42133.)

encodings¶

encodings.normalize_encoding() اکنون نویسه‌های غیر‌اسکی را نادیده می‌گیرد. (مشارکت‌شده توسط Hai Shi در bpo-39337.)

enum¶

__repr__() کلاس Enum اکنون enum_name.member_name را برمی‌گرداند و __str__() اکنون member_name را برمی‌گرداند. enum‌های کتابخانه استاندارد که به‌صورت ثابت‌های ماژول در دسترس‌اند، repr`ی برابر با ``module_name.member_name`() دارند. (مشارکت‌شده توسط Ethan Furman در bpo-40066.)

افزودن enum.StrEnum برای enum‌هایی که همه‌ی اعضای آن‌ها رشته هستند. (مشارکت‌شده توسط Ethan Furman در bpo-41816.)

fileinput¶

افزودن پارامترهای encoding و errors به fileinput.input() و fileinput.FileInput. (مشارکت‌شده توسط Inada Naoki در bpo-43712.)

fileinput.hook_compressed() اکنون هنگامی که mode برابر با "r" است و پرونده فشرده است، مانند پرونده‌های فشرده‌نشده، شیء TextIOWrapper را برمی‌گرداند. (مشارکت Inada Naoki در bpo-5758.)

faulthandler¶

ماژول faulthandler اکنون تشخیص می‌دهد که آیا خطای مهلکی در حین زباله‌روبی رخ داده است. (مشارکت‌شده توسط Victor Stinner در bpo-44466.)

gc¶

افزودن قلاب‌های حسابرسی برای gc.get_objects()، gc.get_referrers() و gc.get_referents(). (مشارکت‌شده توسط Pablo Galindo در bpo-43439.)

glob¶

افزودن پارامترهای root_dir و dir_fd به glob() و iglob() که امکان تعیین پوشه ریشه برای جستجو را فراهم می‌کنند. (مشارکت Serhiy Storchaka در bpo-38144.)

hashlib¶

ماژول hashlib به OpenSSL 1.1.1 یا جدیدتر نیاز دارد. (مشارکت‌شده توسط Christian Heimes در PEP 644 و bpo-43669.)

ماژول hashlib پشتیبانی اولیه‌ای از OpenSSL 3.0.0 دارد. (مشارکت Christian Heimes در bpo-38820 و مسائل دیگر.)

جایگزین پایتون خالصِ pbkdf2_hmac() منسوخ شده است. در آینده PBKDF2-HMAC تنها زمانی دسترس‌پذیر خواهد بود که پایتون با پشتیبانی OpenSSL ساخته شده باشد. (مشارکت‌شده توسط Christian Heimes در bpo-43880.)

hmac¶

ماژول hmac اکنون به‌طور داخلی از پیاده‌سازی HMAC در OpenSSL استفاده می‌کند. (مشارکت‌شده توسط Christian Heimes در bpo-40645.)

IDLE و idlelib¶

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

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

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

نوار کناری پوسته اضافه شد. اعلان اصلی («>>>») به نوار کناری منتقل شد. اعلان‌های ثانویه («...») به نوار کناری اضافه شدند. کلیک چپ و کشیدن اختیاری، یک یا چند سطر از متن را انتخاب می‌کند، مانند نوار کناری شماره سطر در ویرایشگر. کلیک راست پس از انتخاب سطرهای متن، منوی زمینه‌ای را با گزینه «کپی همراه با اعلان‌ها» نمایش می‌دهد. این کار، اعلان‌های نوار کناری و سطرهای متن انتخاب‌شده را با هم زیپ می‌کند. این گزینه در منوی زمینه متن نیز ظاهر می‌شود. (مشارکت‌شده توسط Tal Einat در bpo-37903.)

برای تورفتگی دادن به کد تعاملی، به‌جای تب از فاصله استفاده کنید. این کار باعث می‌شود ورودی‌های کد تعاملی «درست به نظر برسند». امکان‌پذیر کردن این کار، انگیزه‌ی اصلی برای افزودن نوار کناری پوسته بود. (مشارکت‌شده توسط تری جان ریدی در bpo-37892.)

کلیدواژه‌های نرم جدید match، case و _ در دستورهای تطبیق الگو برجسته‌سازی می‌شوند. با این حال، این برجسته‌سازی بی‌نقص نیست و در برخی موارد نادر، از جمله برخی _ ها در الگوهای case، نادرست خواهد بود. (مشارکت‌شده توسط Tal Einat در bpo-44010.)

جدید در نسخه‌های نگهداری 3.10.

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

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

importlib.metadata¶

برابری قابلیت‌ها با importlib_metadata 4.6 (تاریخچه).

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

importlib.metadata.packages_distributions() برای حل کردن ماژول‌ها و بسته‌های سطح بالای پایتون به importlib.metadata.Distribution مربوط به آن‌ها افزوده شد.

inspect¶

هنگامی که یک ماژول __loader__ را تعریف نمی‌کند، به __spec__.loader بازمی‌گردد. (مشارکت‌شده توسط Brett Cannon در bpo-42133.)

افزودن inspect.get_annotations() که حاشیه‌نویسی‌های تعریف‌شده روی یک شیء را به‌صورت ایمن محاسبه می‌کند. این تابع پیچیدگی‌های دسترسی به حاشیه‌نویسی‌ها روی انواع مختلف اشیاء را مدیریت می‌کند و درباره شیء‌ای که بررسی می‌کند، فرض‌های بسیار کمی دارد. inspect.get_annotations() همچنین می‌تواند حاشیه‌نویسی‌های رشته‌شده (stringized) را به‌درستی از حالت رشته خارج کند (un-stringize). inspect.get_annotations() اکنون به‌عنوان بهترین روش برای دسترسی به دیکشنری حاشیه‌نویسی‌های تعریف‌شده روی هر شیء پایتون در نظر گرفته می‌شود؛ برای اطلاعات بیشتر درباره بهترین روش‌های کار با حاشیه‌نویسی‌ها، لطفاً بهترین شیوه‌های حاشیه‌نویسی را ببینید. در همین راستا، inspect.signature()، inspect.Signature.from_callable() و inspect.Signature.from_function() اکنون برای بازیابی حاشیه‌نویسی‌ها inspect.get_annotations() را فراخوانی می‌کنند. این بدان معناست که inspect.signature() و inspect.Signature.from_callable() نیز اکنون می‌توانند حاشیه‌نویسی‌های رشته‌شده را از حالت رشته خارج کنند. (مشارکت از Larry Hastings در bpo-43817.)

itertools¶

افزودن itertools.pairwise(). (مشارکت‌شده توسط Raymond Hettinger در bpo-38200.)

linecache¶

هنگامی که یک ماژول __loader__ را تعریف نمی‌کند، به __spec__.loader بازمی‌گردد. (مشارکت‌شده توسط Brett Cannon در bpo-42133.)

os¶

افزودن پشتیبانی از os.cpu_count() برای VxWorks RTOS. (با مشارکت Peixing Xin در bpo-41440.)

تابع جدید os.eventfd() و توابع کمکی مرتبط برای پوشش دادن فراخوانی سیستمی eventfd2 در لینوکس اضافه شد. (مشارکت‌شده توسط Christian Heimes در bpo-41001.)

افزودن os.splice() که اجازه می‌دهد داده‌ها بین دو توصیف‌گر پرونده، بدون کپی‌برداری میان فضای نشانی هسته و فضای نشانی کاربر، جابه‌جا شوند، که در آن یکی از توصیف‌گرهای پرونده باید به یک پایپ اشاره کند. (مشارکت Pablo Galindo در bpo-41625.)

افزودن O_EVTONLY، O_FSYNC، O_SYMLINK و O_NOFOLLOW_ANY برای macOS. (مشارکت‌شده توسط Donghee Na در bpo-43106.)

os.path¶

os.path.realpath() اکنون یک آرگومان فقط‌کلیدواژه‌ای به نام strict را می‌پذیرد. وقتی روی True تنظیم شود، اگر مسیری وجود نداشته باشد یا با حلقه‌ی پیوند نمادین مواجه شود، OSError مطرح می‌شود. (مشارکت‌شده توسط Barney Gale در bpo-43757.)

pathlib¶

پشتیبانی از اسلایس به PurePath.parents اضافه شد. (ارائه‌شده توسط Joshua Cannon در bpo-35498.)

افزودن پشتیبانی از اندیس‌گذاری منفی به PurePath.parents. (مشارکت‌شده توسط Yaroslav Pankovych در bpo-21041.)

افزودن متد Path.hardlink_to که جایگزین link_to() می‌شود. متد جدید همان ترتیب آرگومان‌های symlink_to() را دارد. (با مشارکت Barney Gale در bpo-39950.)

pathlib.Path.stat() و chmod() اکنون یک آرگومان فقط‌کلیدواژه‌ای follow_symlinks را برای سازگاری با توابع متناظر در ماژول os می‌پذیرند. (مشارکت‌شده توسط Barney Gale در bpo-39906.)

platform¶

تابع platform.freedesktop_os_release() برای بازیابی شناسایی سیستم‌عامل از پرونده استاندارد freedesktop.org os-release اضافه شد. (ارائه‌شده توسط Christian Heimes در bpo-28468.)

pprint¶

pprint.pprint() اکنون آرگومان کلیدواژه‌ای جدید underscore_numbers را می‌پذیرد. (مشارکت‌شده توسط sblondon در bpo-42914.)

pprint اکنون می‌تواند نمونه‌های dataclasses.dataclass را به‌زیبایی چاپ کند (pretty-print). (مشارکت‌شده توسط Lewis Gaul در bpo-43080.)

py_compile¶

افزودن گزینه‌ی --quiet به رابط خط فرمان py_compile. (مشارکت‌شده توسط گریگوری شِوچنکو در bpo-38731.)

pyclbr¶

یک ویژگی end_lineno به اشیاء Function و Class در درختی که توسط pyclbr.readmodule() و pyclbr.readmodule_ex() بازگردانده می‌شود، اضافه شد. این ویژگی با lineno (شروع) موجود مطابقت دارد. (مشارکت‌شده توسط Aviral Srivastava در bpo-38307.)

shelve¶

ماژول shelve اکنون هنگام ایجاد قفسه‌ها، به‌طور پیش‌فرض از pickle.DEFAULT_PROTOCOL به‌جای پروتکل 3 ماژول pickle استفاده می‌کند. (مشارکت‌شده توسط Zackery Spytz در bpo-34204.)

statistics¶

افزودن توابع covariance()، correlation() پیرسون و linear_regression() ساده. (مشارکت‌شده توسط Tymoteusz Wołodźko در bpo-38490.)

site¶

هنگامی که یک ماژول __loader__ را تعریف نمی‌کند، به __spec__.loader بازمی‌گردد. (مشارکت‌شده توسط Brett Cannon در bpo-42133.)

socket¶

استثنای socket.timeout اکنون مستعار TimeoutError است. (مشارکت Christian Heimes در bpo-42413.)

افزودن گزینه‌ای برای ایجاد سوکت‌های MPTCP با IPPROTO_MPTCP (مشارکت‌شده توسط Rui Cunha در bpo-43571.)

افزودن گزینه‌ی IP_RECVTOS برای دریافت نوع سرویس (ToS) یا فیلد‌های DSCP/ECN (مشارکت‌شده توسط Georg Sauthoff در bpo-44077.)

ssl¶

ماژول ssl به OpenSSL 1.1.1 یا جدیدتر نیاز دارد. (مشارکت‌شده توسط کریستین هایمز در PEP 644 و bpo-43669.)

ماژول ssl پشتیبانی اولیه از OpenSSL 3.0.0 و گزینه جدید OP_IGNORE_UNEXPECTED_EOF دارد. (مشارکت‌شده توسط Christian Heimes در bpo-38820، bpo-43794، bpo-43788، bpo-43791، bpo-43799، bpo-43920، bpo-43789 و bpo-43811.)

تابع منسوخ و استفاده از ثابت‌های منسوخ اکنون به یک DeprecationWarning منجر می‌شوند. ssl.SSLContext.options به‌طور پیش‌فرض دارای OP_NO_SSLv2 و OP_NO_SSLv3 است و بنابراین نمی‌تواند درباره‌ی تنظیم مجدد پرچم هشدار دهد. بخش منسوخ‌شده‌ها فهرستی از قابلیت‌های منسوخ را در بر می‌گیرد. (مشارکت‌شده توسط Christian Heimes در bpo-43880.)

ماژول ssl اکنون تنظیمات پیش‌فرض امن‌تری دارد. رمزهای فاقد محرمانگی پیش‌رو (forward secrecy) یا SHA-1 MAC به‌طور پیش‌فرض غیرفعال هستند. سطح امنیتی ۲، کلیدهای ضعیف RSA، DH و ECC با امنیت کمتر از ۱۱۲ بیت را ممنوع می‌کند. SSLContext به‌طور پیش‌فرض حداقل نسخه‌ی پروتکل TLS 1.2 را به کار می‌برد. این تنظیمات بر اساس پژوهش‌های Hynek Schlawack است. (نوشته‌ی Christian Heimes در bpo-43998.)

پروتکل‌های منسوخ SSL 3.0، TLS 1.0 و TLS 1.1 دیگر به‌طور رسمی پشتیبانی نمی‌شوند. پایتون به‌طور فعال آن‌ها را مسدود نمی‌کند. با این حال، گزینه‌های ساخت OpenSSL، پیکربندی‌های توزیع، وصل‌های فروشنده و بدنه‌های رمز ممکن است مانع از یک دست‌دهی موفق شوند.

پارامتر timeout به تابع ssl.get_server_certificate() افزوده شد. (با مشارکت Zackery Spytz در bpo-31870.)

ماژول ssl از نوع‌های هیپ (heap-types) و مقداردهی اولیه چندمرحله‌ای (multi-phase initialization) استفاده می‌کند. (مشارکت‌شده توسط کریستین هایمز در bpo-42333.)

پرچم راستی‌آزمایی جدید VERIFY_X509_PARTIAL_CHAIN افزوده شده است. (مشارکت‌شده توسط l0x در bpo-40849.)

sqlite3¶

افزودن رویدادهای حسابرسی برای connect()، enable_load_extension() و load_extension(). (مشارکت‌شده توسط Erlend E. Aasland در bpo-43762.)

sys¶

افزودن ویژگی sys.orig_argv: فهرست آرگومان‌های اصلی خط فرمان که به پرونده اجرایی پایتون ارسال شده‌اند. (مشارکت‌شده توسط Victor Stinner در bpo-23427.)

افزودن sys.stdlib_module_names که شامل فهرست نام ماژول‌های کتابخانه استاندارد است. (نوشته‌ی Victor Stinner در bpo-42955.)

_thread¶

_thread.interrupt_main() اکنون یک شماره سیگنال اختیاری برای شبیه‌سازی می‌پذیرد (پیش‌فرض همچنان signal.SIGINT است). (مشارکت آنتوان پی‌ترو در bpo-43356.)

threading¶

افزودن threading.gettrace() و threading.getprofile() برای بازیابی توابعی که به ترتیب توسط threading.settrace() و threading.setprofile() تنظیم‌شده‌اند. (ارائه‌شده توسط Mario Corchero در bpo-42251.)

افزودن threading.__excepthook__ برای امکان بازیابی مقدار اصلی threading.excepthook() در صورتی که به مقداری خراب یا متفاوت تنظیم‌شده باشد. (مشارکت Mario Corchero در bpo-42308.)

traceback¶

توابع format_exception()، format_exception_only() و print_exception() اکنون می‌توانند یک شیء استثنا را به‌عنوان آرگومان فقط‌جایگاهی بپذیرند. (مشارکت‌شده توسط Zackery Spytz و Matthias Bussonnier در bpo-26389.)

types¶

کلاس‌های types.EllipsisType، types.NoneType و types.NotImplementedType بازمعرفی شدند و مجموعه‌ای جدید از نوع‌ها را فراهم می‌کنند که به‌سادگی توسط بررسی‌گرهای نوع قابل تفسیر است. (مشارکت‌شده توسط Bas van Beek در bpo-41810.)

typing¶

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

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

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

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

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

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

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

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

افزودن تابع جدید typing.is_typeddict() برای درون‌نگری اینکه آیا یک حاشیه‌نویسی typing.TypedDict است یا خیر. (مشارکت‌شده توسط Patrick Reader در bpo-41792.)

زیرکلاس‌های typing.Protocol که تنها متغیرهای داده در آن‌ها تعریف شده‌اند، اکنون هنگام بررسی با isinstance استثنای TypeError ایجاد می‌کنند، مگر آن‌که با @runtime_checkable دکوراتور شده باشند. پیش‌تر، این بررسی‌ها بی‌صدا پاس می‌شدند. کاربرانی که پروتکل‌های زمان اجرا می‌خواهند، باید زیرکلاس‌های خود را با دکوراتور runtime_checkable دکوراتور کنند. (مشارکت‌شده توسط Yurii Karabas در bpo-38908.)

ایمپورت کردن از زیرماژول‌های typing.io و typing.re اکنون DeprecationWarning نشان می‌دهد. این زیرماژول‌ها از پایتون 3.8 منسوخ شده‌اند و در نسخه‌ی آینده‌ی پایتون حذف خواهند شد. هر چیزی که متعلق به آن زیرماژول‌هاست، باید به‌جای آن‌ها مستقیماً از typing ایمپورت شود. (مشارکت‌شده توسط Sebastian Rittau در bpo-38291.)

unittest¶

متد جدید assertNoLogs() به‌عنوان مکمل متد موجود assertLogs() اضافه شد. (نوشته‌ی Kit Yan Choi در bpo-39385.)

urllib.parse¶

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

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

xml¶

افزودن کلاس LexicalHandler به ماژول xml.sax.handler. (مشارکت‌شده توسط Jonathan Gossage و Zackery Spytz در bpo-35018.)

zipimport¶

افزودن متدهای مرتبط با PEP 451: find_spec()، zipimport.zipimporter.create_module() و zipimport.zipimporter.exec_module(). (با مشارکت Brett Cannon در bpo-42131.)

متد invalidate_caches() افزوده شد. (با مشارکت Desmond Cheong در bpo-14678.)

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

• اکنون هنگام کامپایل نحوی که پیش‌تر معتبر بود، اگر بلافاصله پس از مقدار لفظی عددی کلیدواژه‌ای بیاید (مانند 0in x)، هشدار منسوخ‌شدن نشان داده می‌شود. در نسخه‌های آینده، این هشدار به هشدار نحوی و در نهایت به خطای نحوی تغییر داده خواهد شد. برای از بین بردن این هشدار و سازگار کردن کد با نسخه‌های آینده، فقط کافی است بین مقدار لفظی عددی و کلیدواژه‌ی پس از آن یک فاصله اضافه کنید. (مشارکت‌شده توسط Serhiy Storchaka در bpo-43833.)

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

• پارامترهای etype توابع format_exception()، format_exception_only() و print_exception() در ماژول traceback به exc تغییر نام داده‌شده‌اند. (مشارکت‌شده توسط Zackery Spytz و Matthias Bussonnier در bpo-26389.)

• atexit: در زمان خروج از پایتون، اگر کال‌بکی که با atexit.register() ثبت‌شده است شکست بخورد، استثنای آن اکنون گزارش می‌شود. پیش‌تر، تنها برخی از استثناها گزارش می‌شدند و آخرین استثنا همیشه بی‌صدا نادیده گرفته می‌شد. (مشارکت‌شده توسط Victor Stinner در bpo-42639.)

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

• socket.htons() و socket.ntohs() اکنون در صورتی که پارامتر داده‌شده در یک عدد صحیح بدون علامت ۱۶‌بیتی جا نشود، به جای DeprecationWarning استثنای OverflowError ایجاد می‌کنند. (مشارکت‌شده توسط ارلند ای. آسلند در bpo-42393.)

• پارامتر loop پس از منسوخ شدن در پایتون 3.8، از بیشترِ API سطح بالای asyncio حذف شده است.

  یک هم‌روال که در حال حاضر به این شکل است:

  async def foo(loop):
      await asyncio.sleep(1, loop=loop)
  

  باید با این جایگزین شود:

  async def foo():
      await asyncio.sleep(1)
  

  اگر foo() به‌طور خاص به‌گونه‌ای طراحی شده است که در حلقه رویدادِ در حال اجرا در نخ فعلی اجرا نشود (مثلاً در حلقه رویدادِ نخ دیگری اجرا شود)، به‌جای آن استفاده از asyncio.run_coroutine_threadsafe() را در نظر بگیرید.

  (مشارکت‌شده توسط Yurii Karabas، Andrew Svetlov، Yury Selivanov و Kyle Stanley در bpo-42392.)

• سازنده‌ی types.FunctionType اکنون در صورتی که دیکشنری globals کلید "__builtins__" نداشته باشد، توکارهای فعلی را به ارث می‌برد، به جای اینکه از {"None": None} به عنوان توکارها استفاده کند: رفتاری مشابه توابع eval() و exec(). تعریف تابع با def function(...): ... در پایتون تحت تأثیر قرار نمی‌گیرد و با این سینتکس نمی‌توان globals را بازنویسی کرد: این تابع نیز توکارهای فعلی را به ارث می‌برد. (مشارکت‌شده توسط Victor Stinner در bpo-42990.)

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

• توابع API زبان C PyParser_SimpleParseStringFlags، PyParser_SimpleParseStringFlagsFilename، PyParser_SimpleParseFileFlags و PyNode_Compile و همچنین نوع استفاده‌شده توسط این توابع، struct _node، به دلیل تغییر به پارسر جدید PEG حذف شدند.

  اکنون باید کد منبع مستقیماً به یک شیء کد کامپایل شود، برای مثال با استفاده از Py_CompileString(). سپس می‌توان شیء کد حاصل را با استفاده از، برای مثال، PyEval_EvalCode() ارزیابی کرد.

  به‌طور خاص:

  • فراخوانی PyParser_SimpleParseStringFlags و سپس PyNode_Compile را می‌توان با فراخوانی Py_CompileString() جایگزین کرد.

  • هیچ جایگزین مستقیمی برای PyParser_SimpleParseFileFlags وجود ندارد. برای کامپایل کد از یک آرگومان FILE *، باید پرونده را در C بخوانید و بافر حاصل را به Py_CompileString() ارسال کنید.

  • برای کامپایل پرونده‌ای که نام آن به‌صورت char * داده شده است، پرونده را به‌طور صریح باز کنید، آن را بخوانید و نتیجه را کامپایل کنید. یکی از راه‌های انجام این کار، استفاده از ماژول io به‌همراه PyImport_ImportModule()، PyObject_CallMethod()، PyBytes_AsString() و Py_CompileString() است، همان‌طور که در ادامه به‌صورت طرح‌وار نشان داده شده است. (اعلان‌ها و مدیریت خطا حذف شده‌اند.)

    io_module = Import_ImportModule("io");
    fileobject = PyObject_CallMethod(io_module, "open", "ss", filename, "rb");
    source_bytes_object = PyObject_CallMethod(fileobject, "read", "");
    result = PyObject_CallMethod(fileobject, "close", "");
    source_buf = PyBytes_AsString(source_bytes_object);
    code = Py_CompileString(source_buf, filename, Py_file_input);
    

  • برای شیءهای FrameObject، عضو f_lasti اکنون به‌جای آفست ساده‌ای در رشته بایت‌کد، آفست واژه‌کد (wordcode) را نشان می‌دهد. این بدان معناست که این عدد باید در ۲ ضرب شود تا با APIهایی که به‌جای آن آفست بایتی را انتظار دارند، قابل استفاده باشد (برای مثال PyCode_Addr2Line()). همچنین توجه داشته باشید که عضو f_lasti در شیءهای FrameObject پایدار تلقی نمی‌شود: لطفاً به‌جای آن از PyFrame_GetLineNumber() استفاده کنید.

PEP 652: نگهداری رابط دودویی پایدار برنامه (ABI)¶

رابط دودویی پایدار (Application Binary Interface) برای ماژول‌های توسعه‌ای یا تعبیه پایتون اکنون به‌طور صریح تعریف شده است. پایداری رابط برنامه‌نویسی کاربردی و رابط دودویی کاربردی C تضمین‌های پایداری C API و ABI را همراه با بهترین روش‌ها برای استفاده از رابط دودویی پایدار شرح می‌دهد.

(مشارکت‌شده توسط پتر ویکتورین در PEP 652 و bpo-43795.)

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

• نتیجه‌ی PyNumber_Index() اکنون همیشه نوع دقیق int دارد. پیش از این، نتیجه می‌توانست نمونه‌ای از یک زیرکلاس int باشد. (مشارکت Serhiy Storchaka در bpo-40792.)

• عضو جدید orig_argv به ساختار PyConfig اضافه شد: فهرست آرگومان‌های اصلی خط فرمان که به پرونده اجرایی پایتون پاس داده شده‌اند. (مشارکت‌شده توسط Victor Stinner در bpo-23427.)

• ماکروهای PyDateTime_DATE_GET_TZINFO() و PyDateTime_TIME_GET_TZINFO() برای دسترسی به ویژگی‌های tzinfo اشیاء datetime.datetime و datetime.time افزوده شده‌اند. (مشارکت‌شده توسط Zackery Spytz در bpo-30155.)

• افزودن تابع PyCodec_Unregister() برای لغو ثبت یک تابع جستجوی کدک. (مشارکت Hai Shi در bpo-41842.)

• تابع PyIter_Send() اضافه شد تا امکان ارسال مقدار به پیمایش‌گر بدون ایجاد کردن استثنای StopIteration را فراهم کند. (مشارکت از طرف Vladimir Matveev در bpo-41756.)

• افزودن PyUnicode_AsUTF8AndSize() به C API محدود. (با مشارکت Alex Gaynor در bpo-41784.)

• افزودن تابع PyModule_AddObjectRef(): مشابه PyModule_AddObject() است، اما در صورت موفقیت ارجاعی به مقدار نمی‌دزدد. (مشارکت‌شده توسط Victor Stinner در bpo-1635741.)

• توابع Py_NewRef() و Py_XNewRef() برای افزایش شمارش ارجاع یک شیء و برگرداندن آن شیء اضافه شدند. (ارائه‌شده توسط Victor Stinner در bpo-42262.)

• توابع PyType_FromSpecWithBases() و PyType_FromModuleAndSpec() اکنون یک کلاس منفرد را به‌عنوان آرگومان bases می‌پذیرند. (مشارکت‌شده توسط Serhiy Storchaka در bpo-42423.)

• تابع PyType_FromModuleAndSpec() اکنون جایگاه tp_doc با مقدار NULL را می‌پذیرد. (مشارکت‌شده توسط Hai Shi در bpo-41832.)

• تابع PyType_GetSlot() می‌تواند نوع‌های ایستا را بپذیرد. (مشارکت Hai Shi و Petr Viktorin در bpo-41073.)

• تابع جدید PySet_CheckExact() به C-API اضافه شد تا بررسی کند که آیا یک شیء نمونه‌ای از set است اما نمونه‌ای از یک زیرنوع نیست. (با مشارکت Pablo Galindo در bpo-43277.)

• افزودن PyErr_SetInterruptEx() که امکان ارسال شماره سیگنال برای شبیه‌سازی را فراهم می‌کند. (مشارکت‌شده توسط Antoine Pitrou در bpo-43356.)

• اکنون در صورتی از API محدود C پشتیبانی می‌شود که پایتون در حالت اشکال‌زدایی ساخته شده باشد (اگر ماکروی Py_DEBUG تعریف شده باشد). در API محدود C، اگر پایتون در حالت اشکال‌زدایی ساخته شده باشد و ماکروی Py_LIMITED_API Python 3.10 یا جدیدتر را هدف قرار دهد، توابع Py_INCREF() و Py_DECREF() اکنون به‌جای دسترسی مستقیم به عضو PyObject.ob_refcnt، به‌صورت فراخوانی توابع مبهم پیاده‌سازی شده‌اند. پشتیبانی از API محدود C در حالت اشکال‌زدایی ممکن شد، زیرا ساختار PyObject از Python 3.8 به بعد در حالت انتشار و حالت اشکال‌زدایی یکسان است (به bpo-36465 مراجعه کنید).

  API محدود C هنوز در ساخت ویژه‌ی --with-trace-refs (ماکرو Py_TRACE_REFS) پشتیبانی نمی‌شود. (مشارکت‌شده توسط Victor Stinner در bpo-43688.)

• تابع Py_Is(x, y) برای آزمودن اینکه آیا شیء x همان شیء y است اضافه شد؛ همانند x is y در پایتون. همچنین توابع Py_IsNone()، Py_IsTrue() و Py_IsFalse() برای آزمودن اینکه آیا یک شیء به‌ترتیب تک‌نمونه‌ی None، تک‌نمونه‌ی True یا تک‌نمونه‌ی False است اضافه شدند. (مشارکت‌شده توسط Victor Stinner در bpo-43753.)

• افزودن توابع جدید برای کنترل زباله‌روب از کد C: PyGC_Enable()، PyGC_Disable()، PyGC_IsEnabled(). این توابع امکان فعال‌سازی، غیرفعال‌سازی و استعلام وضعیت زباله‌روب را از کد C فراهم می‌کنند، بدون آنکه نیازی به ایمپورت کردن ماژول gc باشد.

• افزودن پرچم نوع جدید Py_TPFLAGS_DISALLOW_INSTANTIATION برای جلوگیری از ایجاد نمونه‌های نوع. (ارائه‌شده توسط ویکتور استینر در bpo-43916.)

• پرچم نوع جدید Py_TPFLAGS_IMMUTABLETYPE برای ایجاد اشیاء نوع تغییرناپذیر اضافه شد: ویژگی‌های نوع را نمی‌توان تنظیم یا حذف کرد. (با مشارکت Victor Stinner و Erlend E. Aasland در bpo-43908.)

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

• اکنون برای استفاده از قالب‌های PyArg_ParseTuple() و Py_BuildValue() که از # استفاده می‌کنند، باید ماکروی PY_SSIZE_T_CLEAN تعریف شود: es#، et#، s#، u#، y#، z#، U# و Z#. به تجزیه آرگومان‌ها و ساخت مقادیر و PEP 353 مراجعه کنید. (مشارکت‌شده توسط Victor Stinner در bpo-40943.)

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

  #if PY_VERSION_HEX < 0x030900A4
  #  define Py_SET_REFCNT(obj, refcnt) ((Py_REFCNT(obj) = (refcnt)), (void)0)
  #endif
  

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

• فراخوانی PyDict_GetItem() بدون در اختیار داشتن قفل مفسر سراسری به دلایل تاریخی مجاز بود. این کار دیگر مجاز نیست. (مشارکت‌شده توسط Victor Stinner در bpo-40839.)

• PyUnicode_FromUnicode(NULL, size) و PyUnicode_FromStringAndSize(NULL, size) اکنون DeprecationWarning ایجاد می‌کنند. برای تخصیص دادن شیء یونیکد بدون داده‌ی اولیه از PyUnicode_New() استفاده کنید. (مشارکت‌شده توسط Inada Naoki در bpo-36346.)

• ساختار خصوصی _PyUnicode_Name_CAPI از PyCapsule API unicodedata.ucnhash_CAPI به API داخلی C منتقل شده است. (با مشارکت Victor Stinner در bpo-42157.)

• توابع Py_GetPath()، Py_GetPrefix()، Py_GetExecPrefix()، Py_GetProgramFullPath()، Py_GetPythonHome() و Py_GetProgramName() اکنون اگر پیش از Py_Initialize() فراخوانی شوند (پیش از اینکه پایتون مقداردهی اولیه شود)، مقدار NULL برمی‌گردانند. از API جدید پیکربندی راه‌اندازی پایتون برای دریافت پیکربندی مسیر پایتون استفاده کنید. (مشارکت‌کرده توسط Victor Stinner در bpo-42260.)

• ماکروهای PyList_SET_ITEM()، PyTuple_SET_ITEM() و PyCell_SET() دیگر نمی‌توانند به‌عنوان مقدار چپ (l-value) یا مقدار راست (r-value) به کار روند. برای مثال، x = PyList_SET_ITEM(a, b, c) و PyList_SET_ITEM(a, b, c) = x اکنون با خطای کامپایلر شکست می‌خورند. این امر از باگ‌هایی مانند آزمون if (PyList_SET_ITEM (a, b, c) < 0) ... جلوگیری می‌کند. (مشارکت‌شده توسط Zackery Spytz و Victor Stinner در bpo-30459.)

• پرونده‌های API غیرمحدود odictobject.h، parser_interface.h، picklebufobject.h، pyarena.h، pyctype.h، pydebug.h، pyfpe.h و pytime.h به پوشه‌ی Include/cpython منتقل شده‌اند. این پرونده‌ها نباید مستقیماً include شوند، زیرا از قبل در Python.h include شده‌اند؛ پرونده‌های include را ببینید. اگر این پرونده‌ها مستقیماً include شده‌اند، به‌جای آن‌ها include کردن Python.h را در نظر بگیرید. (نوشته‌شده توسط Nicholas Sim در bpo-35134.)

• برای ایجاد اشیاء نوع تغییرناپذیر، از پرچم نوع Py_TPFLAGS_IMMUTABLETYPE استفاده کنید. برای تشخیص اینکه یک شیء نوع تغییرپذیر است یا خیر، به Py_TPFLAGS_HEAPTYPE تکیه نکنید؛ در عوض بررسی کنید که Py_TPFLAGS_IMMUTABLETYPE تنظیم‌شده باشد. (مشارکت‌شده توسط Victor Stinner و Erlend E. Aasland در bpo-43908.)

• تابع مستندسازی‌نشده Py_FrozenMain از API محدود حذف شده است. این تابع عمدتاً برای ساخت‌های سفارشی پایتون مفید است. (مشارکت‌شده توسط پتر ویکتورین در bpo-26241.)

منسوخ¶

• تابع PyUnicode_InternImmortal() اکنون منسوخ شده است و در پایتون 3.12 حذف خواهد شد: به جای آن از PyUnicode_InternInPlace() استفاده کنید. (ارائه‌شده توسط Victor Stinner در bpo-41692.)

حذف‌شده¶

• توابع Py_UNICODE_str* برای دستکاری رشته‌های Py_UNICODE* حذف شدند. (مشارکت‌شده توسط Inada Naoki در bpo-41123.)

  • Py_UNICODE_strlen: از PyUnicode_GetLength() یا PyUnicode_GET_LENGTH استفاده کنید

  • Py_UNICODE_strcat: از PyUnicode_CopyCharacters() یا PyUnicode_FromFormat() استفاده کنید

  • Py_UNICODE_strcpy، Py_UNICODE_strncpy: از PyUnicode_CopyCharacters() یا PyUnicode_Substring() استفاده کنید

  • Py_UNICODE_strcmp: از PyUnicode_Compare() استفاده کنید

  • Py_UNICODE_strncmp: از PyUnicode_Tailmatch() استفاده کنید

  • Py_UNICODE_strchr، Py_UNICODE_strrchr: از PyUnicode_FindChar() استفاده کنید

• PyUnicode_GetMax() حذف شد. لطفاً به API‌های جدید (PEP 393) مهاجرت کنید. (مشارکت‌شده توسط Inada Naoki در bpo-41103.)

• PyLong_FromUnicode() حذف شد. لطفاً به PyLong_FromUnicodeObject() مهاجرت کنید. (مشارکت‌شده توسط Inada Naoki در bpo-41103.)

• PyUnicode_AsUnicodeCopy() حذف شد. لطفاً از PyUnicode_AsUCS4Copy() یا PyUnicode_AsWideCharString() استفاده کنید (ارائه‌شده توسط Inada Naoki در bpo-41103.)

• متغیر _Py_CheckRecursionLimit حذف شد: این متغیر با ceval.recursion_limit از ساختار PyInterpreterState جایگزین شده است. (مشارکت‌شده توسط Victor Stinner در bpo-41834.)

• ماکروهای مستند‌نشده Py_ALLOW_RECURSION و Py_END_ALLOW_RECURSION و فیلد recursion_critical از ساختار PyInterpreterState حذف شدند. (مشارکت‌شده توسط Serhiy Storchaka در bpo-41936.)

• تابع مستندنشده‌ی PyOS_InitInterrupts() حذف شد. راه‌اندازی پایتون از قبل به‌طور ضمنی هندلرهای سیگنال را نصب می‌کند: به PyConfig.install_signal_handlers مراجعه کنید. (مشارکت‌شده توسط Victor Stinner در bpo-41713.)

• تابع PyAST_Validate() حذف شد. دیگر نمی‌توان شیء AST (نوع mod_ty) را با API عمومی C ساخت. این تابع پیش‌تر از API محدود C مستثنی شده بود (PEP 384). (مشارکت‌شده توسط Victor Stinner در bpo-43244.)

• حذف پرونده‌ی سرآیند symtable.h و توابع مستندنشده:

  • PyST_GetScope()

  • PySymtable_Build()

  • PySymtable_BuildObject()

  • PySymtable_Free()

  • Py_SymtableString()

  • Py_SymtableStringObject()

  تابع Py_SymtableString() به اشتباه بخشی از ABI پایدار بود، اما قابل استفاده نبود، زیرا پرونده‌ی سرآیند symtable.h از C API محدود مستثنی شده بود.

  به جای آن از ماژول symtable پایتون استفاده کنید. (مشارکت‌شده توسط Victor Stinner در bpo-43244.)

• حذف PyOS_ReadlineFunctionPointer() از سرآیندهای C API محدود و از python3.dll، کتابخانه‌ای که ABI پایدار را در ویندوز فراهم می‌کند. از آنجا که این تابع یک آرگومان FILE* می‌گیرد، نمی‌توان پایداری ABI آن را تضمین کرد. (مشارکت‌شده توسط Petr Viktorin در bpo-43868.)

• پرونده‌های سرآیند ast.h، asdl.h و Python-ast.h حذف شدند. این توابع مستند نشده بودند و از API محدود C مستثنا بودند. بیشتر نام‌های تعریف‌شده توسط این پرونده‌های سرآیند پیشوند Py نداشتند و در نتیجه می‌توانستند تداخل نام ایجاد کنند. برای مثال، Python-ast.h یک ماکروی Yield تعریف می‌کرد که با نام Yield استفاده‌شده در سرآیند <winbase.h> ویندوز تداخل داشت. به جای آن از ماژول ast پایتون استفاده کنید. (مشارکت توسط Victor Stinner در bpo-43244.)

• توابع کامپایلر و پارسر که از نوع struct _mod استفاده می‌کنند حذف شدند، زیرا API عمومی C برای AST حذف شده است:

  • PyAST_Compile()

  • PyAST_CompileEx()

  • PyAST_CompileObject()

  • PyFuture_FromAST()

  • PyFuture_FromASTObject()

  • PyParser_ASTFromFile()

  • PyParser_ASTFromFileObject()

  • PyParser_ASTFromFilename()

  • PyParser_ASTFromString()

  • PyParser_ASTFromStringObject()

  این توابع مستندسازی‌نشده بودند و از C API محدود مستثنی بودند. (مشارکت‌شده توسط Victor Stinner در bpo-43244.)

• پرونده‌ی سرآیند pyarena.h همراه با توابع حذف شده است:

  • PyArena_New()

  • PyArena_Free()

  • PyArena_Malloc()

  • PyArena_AddPyObject()

  این توابع فاقد مستندات بودند، از C API محدود مستثنی شده بودند و تنها به‌صورت داخلی توسط کامپایلر استفاده می‌شدند. (مشارکت توسط Victor Stinner در bpo-43244.)

• عضو PyThreadState.use_tracing برای بهینه‌سازی پایتون حذف شده است. (مشارکت‌شده توسط مارک شنون در bpo-43760.)

tarfile¶

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