From 82ff8d997c10e7e596ab52f85bd661ba27236764 Mon Sep 17 00:00:00 2001 From: invincible627 Date: Fri, 21 Aug 2026 18:46:57 +0330 Subject: [PATCH 01/11] Translation of the library/__main__.po file up to line 145 --- GLOSSARY.md | 3 +-- library/__main__.po | 40 +++++++++++++++++++++++++++++----------- 2 files changed, 30 insertions(+), 13 deletions(-) diff --git a/GLOSSARY.md b/GLOSSARY.md index d41aff9ac..205d23469 100644 --- a/GLOSSARY.md +++ b/GLOSSARY.md @@ -54,8 +54,7 @@ | loader | بارگذار | | local | محلی | | loop | حلقه | -| method | متد | -| method | روش | +| method | متد، روش | | mock | ماک | | module | ماژول | | mutable | تغییرپذیر | diff --git a/library/__main__.po b/library/__main__.po index 63508f3a5..07a82b795 100644 --- a/library/__main__.po +++ b/library/__main__.po @@ -23,7 +23,7 @@ msgstr "" "Plural-Forms: nplurals=2; plural=(n > 1);\n" msgid ":mod:`!__main__` --- Top-level code environment" -msgstr "" +msgstr ":mod:`!__main__` --- محیط سطح‌بالای کد" msgid "In Python, the special name ``__main__`` is used for two important constructs:" msgstr "در پایتون، از نام ویژه‌ی ``__main__`` برای دو ساختار مهم استفاده می‌شود:" @@ -65,43 +65,49 @@ msgstr "" "'concurrent.futures.process'" msgid "However, if the module is executed in the top-level code environment, its ``__name__`` is set to the string ``'__main__'``." -msgstr "با این حال، اگر ماژول در محیط کد سطح بالا اجرا شود، ``__name__`` آن به رشته‌ی ``'__main__'`` تنظیم می‌شود." +msgstr "با این حال، اگر ماژول در محیط کد سطح‌بالا اجرا شود، ``__name__`` آن به رشته‌ی ``'__main__'`` تنظیم می‌شود." msgid "What is the \"top-level code environment\"?" -msgstr "" +msgstr "محیط \"سطح‌بالای کد چیست\"?" msgid "``__main__`` is the name of the environment where top-level code is run. \"Top-level code\" is the first user-specified Python module that starts running. It's \"top-level\" because it imports all other modules that the program needs. Sometimes \"top-level code\" is called an *entry point* to the application." -msgstr "" +msgstr "``__main__`` نام محیطی است که کد سطح‌بالا در آن اجرا می‌شود. \"کد سطح‌بالا\" اولین ماژول پایتونی است که توسط کاربر مشخص می‌شود و شروع به اجرا می‌کند. به آن \"سطح‌بالا\" گفته می‌شود زیرا همه‌ی ماژول‌های دیگری را که برنامه به آن‌ها نیاز دارد، ایمپورت می‌کند. گاهی به \"کد سطح‌بالا\" *نقطه‌ی ورود* برنامه نیز گفته می‌شود." msgid "The top-level code environment can be:" -msgstr "" +msgstr "محیط سطح‌بالای کد می‌تواند باشد:" msgid "the scope of an interactive prompt::" -msgstr "" + msgstr "محدوده‌ی یک دستور تعاملی::" msgid "" ">>> __name__\n" "'__main__'" msgstr "" +">>> __name__\n" +"'__main__'" msgid "the Python module passed to the Python interpreter as a file argument:" -msgstr "" +msgstr "ماژول پایتونی که به‌عنوان آرگومان فایل به مفسر پایتون پاس داده می‌شود:" msgid "" "$ python helloworld.py\n" "Hello, world!" msgstr "" +"$ python helloworld.py\n" +"Hello, world!" msgid "the Python module or package passed to the Python interpreter with the :option:`-m` argument:" -msgstr "" +msgstr "ماژول یا بسته‌ی پایتونی که با آرگومان :option:`-m` به مفسر پایتون پاس داده می‌شود:" msgid "" "$ python -m tarfile\n" "usage: tarfile.py [-h] [-v] (...)" msgstr "" +"$ python -m tarfile\n" +"usage: tarfile.py [-h] [-v] (...)" msgid "Python code read by the Python interpreter from standard input:" -msgstr "" +msgstr "کد پایتون توسط مفسر پایتون از ورودی استاندارد خوانده می‌شود:" msgid "" "$ echo \"import this\" | python\n" @@ -111,9 +117,15 @@ msgid "" "Explicit is better than implicit.\n" "..." msgstr "" +"$ echo \"import this\" | python\n" +"The Zen of Python, by Tim Peters\n" +"\n" +"Beautiful is better than ugly.\n" +"Explicit is better than implicit.\n" +"..." msgid "Python code passed to the Python interpreter with the :option:`-c` argument:" -msgstr "" +msgstr "کد پایتون با آرگومان :option:`-c` به مفسر پایتون پاس داده می‌شود:" msgid "" "$ python -c \"import this\"\n" @@ -123,9 +135,15 @@ msgid "" "Explicit is better than implicit.\n" "..." msgstr "" +"$ python -c \"import this\"\n" +"The Zen of Python, by Tim Peters\n" +"\n" +"Beautiful is better than ugly.\n" +"Explicit is better than implicit.\n" +"..." msgid "In each of these situations, the top-level module's ``__name__`` is set to ``'__main__'``." -msgstr "" +msgstr "در هر کدام از این موقعیت‌ها، ``__name__`` ماژول سطح‌بالا به ``'__main__'`` تنظیم می‌شود." msgid "As a result, a module can discover whether or not it is running in the top-level environment by checking its own ``__name__``, which allows a common idiom for conditionally executing code when the module is not initialized from an import statement::" msgstr "" From eecf4a942655a60d2af25bbd159af66e97d7bd68 Mon Sep 17 00:00:00 2001 From: invincible627 Date: Fri, 21 Aug 2026 19:09:36 +0330 Subject: [PATCH 02/11] =?UTF-8?q?Add=20some=20semispaces=20(=E2=80=8C)=20i?= =?UTF-8?q?n=20tutorial/classes.po=20file?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- tutorial/classes.po | 80 ++++++++++++++++++++++----------------------- 1 file changed, 40 insertions(+), 40 deletions(-) diff --git a/tutorial/classes.po b/tutorial/classes.po index 950a471e0..90277527b 100644 --- a/tutorial/classes.po +++ b/tutorial/classes.po @@ -34,7 +34,7 @@ msgid "Classes provide a means of bundling data and functionality together. Cre msgstr "کلاس‌ها وسیله‌ای را برای بسته‌بندی کردن داده و عملکرد با هم فراهم می‌کنند. ایجاد یک کلاس جدید، نوع جدیدی ایجاد می‌کند که اجازه می‌دهد موارد جدیدی از آن نوع ساخته شود. هر نمونه از کلاس می‌تواند صفاتی داشته باشد که به آن متصل شده‌اند تا وضعیت آن را حفظ کنند. نمونه‌های کلاس می‌توانند همچنین متد‌هایی (که توسط کلاس تعریف شده‌اند) داشته باشند تا وضعیت آن را تغییر دهند." msgid "Compared with other programming languages, Python's class mechanism adds classes with a minimum of new syntax and semantics. It is a mixture of the class mechanisms found in C++ and Modula-3. Python classes provide all the standard features of Object Oriented Programming: the class inheritance mechanism allows multiple base classes, a derived class can override any methods of its base class or classes, and a method can call the method of a base class with the same name. Objects can contain arbitrary amounts and kinds of data. As is true for modules, classes partake of the dynamic nature of Python: they are created at runtime, and can be modified further after creation." -msgstr "در مقایسه با دیگر زبانهای برنامه‌نویسی، مکانیزم کلاس در پایتون کلاس‌ها را با حداقل قواعد و معناشناسی جدید اضافه می‌کند. این مکانیزم ترکیبی از مکانیزم‌های کلاسی است که در C++ و Modula-3 یافت می‌شود. کلاس‌های پایتون تمام ویژگیهای استاندارد برنامه‌نویسی شیءگرا را فراهم می‌کنند: مکانیزم ارث بری کلاس‌ها اجازه می‌دهد کلاس‌های پایه‌ی متعددی داشته باشید، یک کلاس مشتق می‌تواند هر یک از متد‌های کلاس‌های پایه‌ی خود را بازنویسی کند و یک متد می‌تواند متدی از کلاس پایه با همان نام را فراخوانی کند. اشیاء می‌توانند حاوی مقادیر و انواع داده‌ای دلخواه باشند. همان‌طور که برای ماژول‌ها صادق است، کلاس‌ها نیز از طبیعت پویا در پایتون برخوردارند: آن‌ها در زمان اجرا ایجاد می‌شوند و می‌توانند پس از ایجاد بیشتر تغییر داده شوند." +msgstr "در مقایسه با دیگر زبان‌های برنامه‌نویسی، مکانیزم کلاس در پایتون کلاس‌ها را با حداقل قواعد و معناشناسی جدید اضافه می‌کند. این مکانیزم ترکیبی از مکانیزم‌های کلاسی است که در C++ و Modula-3 یافت می‌شود. کلاس‌های پایتون تمام ویژگی‌های استاندارد برنامه‌نویسی شیءگرا را فراهم می‌کنند: مکانیزم ارث بری کلاس‌ها اجازه می‌دهد کلاس‌های پایه‌ی متعددی داشته باشید، یک کلاس مشتق می‌تواند هر یک از متد‌های کلاس‌های پایه‌ی خود را بازنویسی کند و یک متد می‌تواند متدی از کلاس پایه با همان نام را فراخوانی کند. اشیاء می‌توانند حاوی مقادیر و انواع داده‌ای دلخواه باشند. همان‌طور که برای ماژول‌ها صادق است، کلاس‌ها نیز از طبیعت پویا در پایتون برخوردارند: آن‌ها در زمان اجرا ایجاد می‌شوند و می‌توانند پس از ایجاد بیشتر تغییر داده شوند." msgid "In C++ terminology, normally class members (including the data members) are *public* (except see below :ref:`tut-private`), and all member functions are *virtual*. As in Modula-3, there are no shorthands for referencing the object's members from its methods: the method function is declared with an explicit first argument representing the object, which is provided implicitly by the call. As in Smalltalk, classes themselves are objects. This provides semantics for importing and renaming. Unlike C++ and Modula-3, built-in types can be used as base classes for extension by the user. Also, like in C++, most built-in operators with special syntax (arithmetic operators, subscripting etc.) can be redefined for class instances." msgstr "در اصطلاحات C++، معمولاً اعضای کلاس (از جمله اعضای داده) *public* هستند (به جز موردی که در پایین :ref:`tut-private` ذکر شده است)، و تمامی توابع عضو مجازی هستند. همان‌طور که در Modula-3، هیچ میانبر‌هایی برای ارجاع به اعضای شیء از متد‌های آن وجود ندارد: تابع متد با یک آرگومان اول صریح که نمایانگر شیء است، اعلام می‌شود که این آرگومان به صورت ضمنی توسط فراخوانی فراهم می‌شود. همان‌طور که در Smalltalk، خود کلاس‌ها اشیاء هستند. این ویژگی معناشناسی برای وارد کردن و تغییر نام را فراهم می‌آورد. برخلاف C++ و Modula-3، نوع‌های داخلی می‌توانند به‌عنوان کلاس‌های پایه برای توسعه توسط کاربر استفاده شوند. همچنین، مانند C++، بیشتر عملگر‌های داخلی با نحوی خاص (عملگر‌های ریاضی، زیرنویسی و غیره) می‌توانند برای نمونه‌های کلاس بازتعریف شوند." @@ -46,7 +46,7 @@ msgid "A Word About Names and Objects" msgstr "سخنی درباره‌ی نام‌ها و اشیاء" msgid "Objects have individuality, and multiple names (in multiple scopes) can be bound to the same object. This is known as aliasing in other languages. This is usually not appreciated on a first glance at Python, and can be safely ignored when dealing with immutable basic types (numbers, strings, tuples). However, aliasing has a possibly surprising effect on the semantics of Python code involving mutable objects such as lists, dictionaries, and most other types. This is usually used to the benefit of the program, since aliases behave like pointers in some respects. For example, passing an object is cheap since only a pointer is passed by the implementation; and if a function modifies an object passed as an argument, the caller will see the change --- this eliminates the need for two different argument passing mechanisms as in Pascal." -msgstr "اشیاء هویت فردی دارند و چندین نام (در چندین محدوده) می‌توانند به یک شیء مشخص متصل شوند. این در زبانهای دیگر با نام «اسم‌های مستعار» شناخته می‌شود. این ویژگی معمولاً در نگاه اول به پایتون چندان جلب توجه نمی‌کند و هنگام کار با انواع پایه‌ی تغییرناپذیر (اعداد، رشته‌ها، تاپل‌ها) می‌توان آن را نادیده گرفت. با این حال، نام‌های مستعار می‌توانند تأثیری شگفت‌آور بر معناشناسی کد پایتونی داشته باشند، به‌ویژه هنگامی که با اشیاء تغییرپذیر مانند فهرستها، دیکشنری‌ها و بیشتر انواع دیگر سروکار داریم. این ویژگی معمولاً به سود برنامه تمام می‌شود، چون نام‌های مستعار از برخی جهات مانند اشاره‌گرها (pointer) رفتار می‌کنند. برای مثال، ارسال یک شیء به‌عنوان آرگومان ارزان است، چون پیاده‌سازی فقط یک اشاره‌گر را ارسال می‌کند؛ و اگر تابعی شیء‌ای را که به‌عنوان آرگومان دریافت کرده تغییر دهد، فراخوان‌نده تغییر را مشاهده خواهد کرد --- این کار نیاز به دو مکانیزم متفاوت برای ارسال آرگومان (مانند آنچه در پاسکال وجود دارد) را از بین می‌برد." +msgstr "اشیاء هویت فردی دارند و چندین نام (در چندین محدوده) می‌توانند به یک شیء مشخص متصل شوند. این در زبان‌های دیگر با نام «اسم‌های مستعار» شناخته می‌شود. این ویژگی معمولاً در نگاه اول به پایتون چندان جلب توجه نمی‌کند و هنگام کار با انواع پایه‌ی تغییرناپذیر (اعداد، رشته‌ها، تاپل‌ها) می‌توان آن را نادیده گرفت. با این حال، نام‌های مستعار می‌توانند تأثیری شگفت‌آور بر معناشناسی کد پایتونی داشته باشند، به‌ویژه هنگامی که با اشیاء تغییرپذیر مانند فهرستها، دیکشنری‌ها و بیشتر انواع دیگر سروکار داریم. این ویژگی معمولاً به سود برنامه تمام می‌شود، چون نام‌های مستعار از برخی جهات مانند اشاره‌گرها (pointer) رفتار می‌کنند. برای مثال، ارسال یک شیء به‌عنوان آرگومان ارزان است، چون پیاده‌سازی فقط یک اشاره‌گر را ارسال می‌کند؛ و اگر تابعی شیء‌ای را که به‌عنوان آرگومان دریافت کرده تغییر دهد، فراخوان‌نده تغییر را مشاهده خواهد کرد --- این کار نیاز به دو مکانیزم متفاوت برای ارسال آرگومان (مانند آنچه در پاسکال وجود دارد) را از بین می‌برد." msgid "Python Scopes and Namespaces" msgstr "محدوده‌ها و فضای نام‌ها در پایتون" @@ -58,13 +58,13 @@ msgid "Let's begin with some definitions." msgstr "بیایید با چند تعریف شروع کنیم." msgid "A *namespace* is a mapping from names to objects. Most namespaces are currently implemented as Python dictionaries, but that's normally not noticeable in any way (except for performance), and it may change in the future. Examples of namespaces are: the set of built-in names (containing functions such as :func:`abs`, and built-in exception names); the global names in a module; and the local names in a function invocation. In a sense the set of attributes of an object also form a namespace. The important thing to know about namespaces is that there is absolutely no relation between names in different namespaces; for instance, two different modules may both define a function ``maximize`` without confusion --- users of the modules must prefix it with the module name." -msgstr "«فضای نام» *namespace* نگاشتی است از نام‌ها به اشیا. بیشتر فضای نام‌ها در حال حاضر به‌صورت دیکشنری‌های پایتون پیاده‌سازی شده‌اند، اما معمولاً این موضوع (به جز در بازدهی قابل مشاهده نیست و ممکن است در آینده تغییر کند. مثالهایی از فضای نام عبارت‌اند از: مجموعه نام‌های داخلی (که شامل توابعی مثل :func:`abs` و نام‌های استثنائات داخلی است)؛ نام‌های سراسری در یک ماژول؛ و نام‌های محلی در یک فراخوانی تابع. به نوعی، مجموعه صفات «attributes» یک شیء نیز یک فضای نام را تشکیل می‌دهد. نکته‌ی مهم درباره‌ی فضای نام‌ها این است که هیچ ارتباطی بین نام‌ها در فضای نام‌های مختلف وجود ندارد؛ برای مثال، دو ماژول مختلف می‌توانند هر دو تابعی با نام ``maximize`` تعریف کنند بدون اینکه ابهامی پیش بیاید — استفاده‌کنندگان از ماژول‌ها باید نام ماژول را به‌عنوان پیشوند بیاورند." +msgstr "«فضای نام» *namespace* نگاشتی است از نام‌ها به اشیا. بیشتر فضای نام‌ها در حال حاضر به‌صورت دیکشنری‌های پایتون پیاده‌سازی شده‌اند، اما معمولاً این موضوع (به جز در بازدهی قابل مشاهده نیست و ممکن است در آینده تغییر کند. مثال‌هایی از فضای نام عبارت‌اند از: مجموعه نام‌های داخلی (که شامل توابعی مثل :func:`abs` و نام‌های استثنائات داخلی است)؛ نام‌های سراسری در یک ماژول؛ و نام‌های محلی در یک فراخوانی تابع. به نوعی، مجموعه صفات «attributes» یک شیء نیز یک فضای نام را تشکیل می‌دهد. نکته‌ی مهم درباره‌ی فضای نام‌ها این است که هیچ ارتباطی بین نام‌ها در فضای نام‌های مختلف وجود ندارد؛ برای مثال، دو ماژول مختلف می‌توانند هر دو تابعی با نام ``maximize`` تعریف کنند بدون اینکه ابهامی پیش بیاید — استفاده‌کنندگان از ماژول‌ها باید نام ماژول را به‌عنوان پیشوند بیاورند." msgid "By the way, I use the word *attribute* for any name following a dot --- for example, in the expression ``z.real``, ``real`` is an attribute of the object ``z``. Strictly speaking, references to names in modules are attribute references: in the expression ``modname.funcname``, ``modname`` is a module object and ``funcname`` is an attribute of it. In this case there happens to be a straightforward mapping between the module's attributes and the global names defined in the module: they share the same namespace! [#]_" -msgstr "به‌هرحال، من واژه‌ی *ویژگی* «*attribute*» را برای هر نامی که بعد از یک نقطه بیاید به کار می‌برم — برای مثال، در عبارت ``z.real``, ``real`` یک ویژگی شیء ``z`` است. از نظر دقیق‌تر، ارجاع به نام‌ها در ماژول‌ها نیز نوعی ارجاع به ویژگی محسوب می‌شود: در عبارت ``modname.funcname``, ``modname`` یک شیء ماژول است و ``funcname`` یکی از ویژگیهای آن است. در این حالت، نگاشتی ساده و مستقیم بین ویژگیهای ماژول و نام‌های سراسری تعریف‌شده در آن وجود دارد: هر دو یک فضای نام (namespace) را به اشتراک می‌گذارند! [#]_" +msgstr "به‌هرحال، من واژه‌ی *ویژگی* «*attribute*» را برای هر نامی که بعد از یک نقطه بیاید به کار می‌برم — برای مثال، در عبارت ``z.real``, ``real`` یک ویژگی شیء ``z`` است. از نظر دقیق‌تر، ارجاع به نام‌ها در ماژول‌ها نیز نوعی ارجاع به ویژگی محسوب می‌شود: در عبارت ``modname.funcname``, ``modname`` یک شیء ماژول است و ``funcname`` یکی از ویژگی‌های آن است. در این حالت، نگاشتی ساده و مستقیم بین ویژگی‌های ماژول و نام‌های سراسری تعریف‌شده در آن وجود دارد: هر دو یک فضای نام (namespace) را به اشتراک می‌گذارند! [#]_" msgid "Attributes may be read-only or writable. In the latter case, assignment to attributes is possible. Module attributes are writable: you can write ``modname.the_answer = 42``. Writable attributes may also be deleted with the :keyword:`del` statement. For example, ``del modname.the_answer`` will remove the attribute :attr:`!the_answer` from the object named by ``modname``." -msgstr "ویژگیها ممکن است فقط خواندنی یا قابل نوشتن باشند. در حالت دوم، اختصاص دادن به ویژگیها ممکن است. ویژگیهای ماژول قابل نوشتن هستند: می‌توانید ``modname.the_answer = 42`` را بنویسید. ویژگیهای قابل نوشتن را می‌توان با دستور :keyword:`del` نیز حذف کرد. به‌عنوان مثال، ``del modname.the_answer`` ویژگی :attr:`!the_answer` را از شیئی که توسط ``modname`` نامگذاری شده است حذف خواهد کرد." +msgstr "ویژگی‌ها ممکن است فقط خواندنی یا قابل نوشتن باشند. در حالت دوم، اختصاص دادن به ویژگی‌ها ممکن است. ویژگی‌های ماژول قابل نوشتن هستند: می‌توانید ``modname.the_answer = 42`` را بنویسید. ویژگی‌های قابل نوشتن را می‌توان با دستور :keyword:`del` نیز حذف کرد. به‌عنوان مثال، ``del modname.the_answer`` ویژگی :attr:`!the_answer` را از شیئی که توسط ``modname`` نامگذاری شده است حذف خواهد کرد." msgid "Namespaces are created at different moments and have different lifetimes. The namespace containing the built-in names is created when the Python interpreter starts up, and is never deleted. The global namespace for a module is created when the module definition is read in; normally, module namespaces also last until the interpreter quits. The statements executed by the top-level invocation of the interpreter, either read from a script file or interactively, are considered part of a module called :mod:`__main__`, so they have their own global namespace. (The built-in names actually also live in a module; this is called :mod:`builtins`.)" msgstr "فضا‌های نام در لحظات مختلف ایجاد می‌شوند و دارای طول عمر‌های متفاوتی هستند. فضای نام که شامل نام‌های داخلی است، زمانی که مفسر پایتون شروع به کار می‌کند ایجاد می‌شود و هرگز حذف نمی‌شود. فضای نام عمومی برای یک ماژول زمانی که تعریف ماژول خوانده می‌شود ایجاد می‌گردد؛ به‌طور معمول، فضا‌های نام ماژول نیز تا زمانی که مفسر پایان یابد باقی می‌مانند. دستوراتی که توسط اجرای سطح بالای مفسر، یا از فایل اسکریپت خوانده شده یا به‌طور تعاملی اجرا می‌شوند، به‌عنوان بخشی از ماژولی به نام :mod:`__main__` در نظر گرفته می‌شوند، بنابراین آن‌ها فضای نام عمومی خود را دارند. (نام‌های درون‌ساخت نیز در واقع در یک ماژول قرار دارند؛ این ماژول :mod:`builtins` نامیده می‌شود.)" @@ -91,25 +91,25 @@ msgid "the outermost scope (searched last) is the namespace containing built-in msgstr "بیرونی‌ترین محدوده (که آخر از همه جست‌وجو می‌شود) فضای نامی است که شامل نام‌های توکار است" msgid "If a name is declared global, then all references and assignments go directly to the next-to-last scope containing the module's global names. To rebind variables found outside of the innermost scope, the :keyword:`nonlocal` statement can be used; if not declared nonlocal, those variables are read-only (an attempt to write to such a variable will simply create a *new* local variable in the innermost scope, leaving the identically named outer variable unchanged)." -msgstr "اگر یک نام به‌عنوان سراسری اعلام شود، تمام ارجاعها و تخصیص‌ها مستقیماً به محدوده‌ی یکی‌مانده‌به‌آخر که شامل نام‌های سراسری ماژول است، می‌روند. برای اتصال مجدد متغیرهایی که در خارج از درونی‌ترین محدوده یافت می‌شوند، می‌توان از دستور :keyword:`nonlocal` استفاده کرد؛ اگر به‌عنوان nonlocal اعلام نشوند، آن متغیرها فقط‌خواندنی هستند (تلاش برای نوشتن در چنین متغیری، صرفاً یک متغیر محلی *جدید* در درونی‌ترین محدوده ایجاد می‌کند و متغیر بیرونی با همان نام را بدون تغییر باقی می‌گذارد)." +msgstr "اگر یک نام به‌عنوان سراسری اعلام شود، تمام ارجاعها و تخصیص‌ها مستقیماً به محدوده‌ی یکی‌مانده‌به‌آخر که شامل نام‌های سراسری ماژول است، می‌روند. برای اتصال مجدد متغیر‌هایی که در خارج از درونی‌ترین محدوده یافت می‌شوند، می‌توان از دستور :keyword:`nonlocal` استفاده کرد؛ اگر به‌عنوان nonlocal اعلام نشوند، آن متغیر‌ها فقط‌خواندنی هستند (تلاش برای نوشتن در چنین متغیری، صرفاً یک متغیر محلی *جدید* در درونی‌ترین محدوده ایجاد می‌کند و متغیر بیرونی با همان نام را بدون تغییر باقی می‌گذارد)." msgid "Usually, the local scope references the local names of the (textually) current function. Outside functions, the local scope references the same namespace as the global scope: the module's namespace. Class definitions place yet another namespace in the local scope." msgstr "معمولاً، محدوده‌ی محلی به نام‌های محلی تابع جاری (از نظر متنی) ارجاع می‌دهد. در خارج از توابع، محدوده‌ی محلی به همان فضای نامی ارجاع می‌دهد که محدوده‌ی سراسری به آن ارجاع می‌دهد: فضای نام ماژول. تعاریف کلاس‌ها، فضای نام دیگری را در محدوده‌ی محلی قرار می‌دهند." msgid "It is important to realize that scopes are determined textually: the global scope of a function defined in a module is that module's namespace, no matter from where or by what alias the function is called. On the other hand, the actual search for names is done dynamically, at run time --- however, the language definition is evolving towards static name resolution, at \"compile\" time, so don't rely on dynamic name resolution! (In fact, local variables are already determined statically.)" -msgstr "درک این نکته مهم است که محدوده‌ها به‌صورت متنی (بر اساس جایگاه در کد) تعیین می‌شوند: محدوده‌ی سراسری تابعی که در یک ماژول تعریف شده است، همان فضای نام آن ماژول است، فرقی نمی‌کند که تابع از کجا یا با چه نام مستعاری فراخوانی شود. از سوی دیگر، جست‌وجوی واقعی برای نام‌ها به‌صورت پویا (داینامیک) و در زمان اجرا انجام می‌شود --- با این حال، تعریف زبان به سمت و سوی حلِ ایستا (استاتیک) نام‌ها در زمان «کامپایل» پیش می‌رود، پس به حلِ پویای نام‌ها اعتماد نکنید! (در واقع، متغیرهای محلی از قبل به‌صورت ایستا تعیین می‌شوند.)" +msgstr "درک این نکته مهم است که محدوده‌ها به‌صورت متنی (بر اساس جایگاه در کد) تعیین می‌شوند: محدوده‌ی سراسری تابعی که در یک ماژول تعریف شده است، همان فضای نام آن ماژول است، فرقی نمی‌کند که تابع از کجا یا با چه نام مستعاری فراخوانی شود. از سوی دیگر، جست‌وجوی واقعی برای نام‌ها به‌صورت پویا (داینامیک) و در زمان اجرا انجام می‌شود --- با این حال، تعریف زبان به سمت و سوی حلِ ایستا (استاتیک) نام‌ها در زمان «کامپایل» پیش می‌رود، پس به حلِ پویای نام‌ها اعتماد نکنید! (در واقع، متغیر‌های محلی از قبل به‌صورت ایستا تعیین می‌شوند.)" msgid "A special quirk of Python is that -- if no :keyword:`global` or :keyword:`nonlocal` statement is in effect -- assignments to names always go into the innermost scope. Assignments do not copy data --- they just bind names to objects. The same is true for deletions: the statement ``del x`` removes the binding of ``x`` from the namespace referenced by the local scope. In fact, all operations that introduce new names use the local scope: in particular, :keyword:`import` statements and function definitions bind the module or function name in the local scope." msgstr "یک ویژگی خاص پایتون این است که --- اگر دستور :keyword:`global` یا :keyword:`nonlocal` فعال نباشد --- تخصیص‌های (مقداردهی‌های) نام‌ها همیشه به درونی‌ترین محدوده (محلی‌ترین) می‌روند. تخصیص‌ها داده‌ها را کپی نمی‌کنند --- بلکه فقط نام‌ها را به اشیاء متصل می‌کنند. همین موضوع در مورد حذف‌ها نیز صادق است: دستور ``del x`` اتصال ``x`` را از فضای نامی که توسط محدوده‌ی محلی ارجاع داده شده است، حذف می‌کند. در واقع، تمام عملیاتی که نام‌های جدیدی معرفی می‌کنند از محدوده‌ی محلی استفاده می‌کنند: به‌ویژه، دستورات :keyword:`import` و تعاریف توابع، نام ماژول یا تابع را در محدوده‌ی محلی متصل می‌کنند." msgid "The :keyword:`global` statement can be used to indicate that particular variables live in the global scope and should be rebound there; the :keyword:`nonlocal` statement indicates that particular variables live in an enclosing scope and should be rebound there." -msgstr "از دستور :keyword:`global` می‌توان برای نشان دادن این استفاده کرد که متغیرهای خاصی در محدوده‌ی سراسری قرار دارند و باید در همان محدوده دوباره متصل شوند؛ دستور :keyword:`nonlocal` نشان می‌دهد که متغیرهای خاصی در یک محدوده‌ی محاط‌شونده قرار دارند و باید در آن محدوده دوباره متصل شوند." +msgstr "از دستور :keyword:`global` می‌توان برای نشان دادن این استفاده کرد که متغیر‌های خاصی در محدوده‌ی سراسری قرار دارند و باید در همان محدوده دوباره متصل شوند؛ دستور :keyword:`nonlocal` نشان می‌دهد که متغیر‌های خاصی در یک محدوده‌ی محاط‌شونده قرار دارند و باید در آن محدوده دوباره متصل شوند." msgid "Scopes and Namespaces Example" msgstr "مثال محدوده‌ها و فضای نام‌ها" msgid "This is an example demonstrating how to reference the different scopes and namespaces, and how :keyword:`global` and :keyword:`nonlocal` affect variable binding::" -msgstr "این مثالی است که نحوه‌ی ارجاع به محدوده‌ها و فضای نام‌های مختلف، و تأثیر دستورات :keyword:`global` و :keyword:`nonlocal` بر اتصال متغیرها را نشان می‌دهد::" +msgstr "این مثالی است که نحوه‌ی ارجاع به محدوده‌ها و فضای نام‌های مختلف، و تأثیر دستورات :keyword:`global` و :keyword:`nonlocal` بر اتصال متغیر‌ها را نشان می‌دهد::" msgid "" "def scope_test():\n" @@ -209,10 +209,10 @@ msgid "Class definitions, like function definitions (:keyword:`def` statements) msgstr "تعاریف کلاس‌ها، مانند تعاریف توابع (دستورات :keyword:`def`)، باید قبل از اینکه تأثیری داشته باشند، اجرا شوند. (به‌طور تئوری می‌توانید یک تعریف کلاس را در یک شاخه از دستور :keyword:`if` یا داخل یک تابع قرار دهید.)" msgid "In practice, the statements inside a class definition will usually be function definitions, but other statements are allowed, and sometimes useful --- we'll come back to this later. The function definitions inside a class normally have a peculiar form of argument list, dictated by the calling conventions for methods --- again, this is explained later." -msgstr "در عمل، دستورات داخل یک تعریف کلاس معمولاً تعاریف توابع هستند، اما دستورات دیگری نیز مجاز هستند و گاهی مفیدند --- بعداً به این موضوع بازخواهیم گشت. تعاریف توابع داخل یک کلاس معمولاً دارای شکل خاصی از فهرست آرگومان‌ها هستند که توسط قراردادهای فراخوانی برای متدها تعیین می‌شود --- باز هم، این موضوع بعداً توضیح داده می‌شود." +msgstr "در عمل، دستورات داخل یک تعریف کلاس معمولاً تعاریف توابع هستند، اما دستورات دیگری نیز مجاز هستند و گاهی مفیدند --- بعداً به این موضوع بازخواهیم گشت. تعاریف توابع داخل یک کلاس معمولاً دارای شکل خاصی از فهرست آرگومان‌ها هستند که توسط قراردادهای فراخوانی برای متد‌ها تعیین می‌شود --- باز هم، این موضوع بعداً توضیح داده می‌شود." msgid "When a class definition is entered, a new namespace is created, and used as the local scope --- thus, all assignments to local variables go into this new namespace. In particular, function definitions bind the name of the new function here." -msgstr "هنگامی که یک تعریف کلاس وارد می‌شود، یک فضای نام جدید ایجاد شده و به‌عنوان محدوده‌ی محلی استفاده می‌شود --- بنابراین، تمام تخصیص‌ها به متغیرهای محلی به این فضای نام جدید می‌روند. به‌ویژه، تعاریف توابع، نام تابع جدید را در اینجا متصل می‌کنند." +msgstr "هنگامی که یک تعریف کلاس وارد می‌شود، یک فضای نام جدید ایجاد شده و به‌عنوان محدوده‌ی محلی استفاده می‌شود --- بنابراین، تمام تخصیص‌ها به متغیر‌های محلی به این فضای نام جدید می‌روند. به‌ویژه، تعاریف توابع، نام تابع جدید را در اینجا متصل می‌کنند." msgid "When a class definition is left normally (via the end), a *class object* is created. This is basically a wrapper around the contents of the namespace created by the class definition; we'll learn more about class objects in the next section. The original local scope (the one in effect just before the class definition was entered) is reinstated, and the class object is bound here to the class name given in the class definition header (:class:`!ClassName` in the example)." msgstr "هنگامی که یک تعریف کلاس به‌طور عادی (با رسیدن به انتها) ترک می‌شود، یک *شیء کلاس* ایجاد می‌شود. این در اصل یک پوسته (wrapper) پیرامون محتویات فضای نامی است که توسط تعریف کلاس ایجاد شده است؛ در بخش بعدی بیشتر درباره‌ی اشیاء کلاس خواهیم آموخت. محدوده‌ی محلی اصلی (همان محدوده‌ای که درست قبل از ورود به تعریف کلاس فعال بود) بازیابی می‌شود، و شیء کلاس در اینجا به نام کلاسی که در سرآیند تعریف کلاس داده شده است، متصل می‌شود (:class:`!ClassName` در مثال)." @@ -221,10 +221,10 @@ msgid "Class Objects" msgstr "اشیاء کلاس" msgid "Class objects support two kinds of operations: attribute references and instantiation." -msgstr "اشیاء کلاس از دو نوع عملیات پشتیبانی می‌کنند: ارجاع به ویژگیها و نمونه‌سازی." +msgstr "اشیاء کلاس از دو نوع عملیات پشتیبانی می‌کنند: ارجاع به ویژگی‌ها و نمونه‌سازی." msgid "*Attribute references* use the standard syntax used for all attribute references in Python: ``obj.name``. Valid attribute names are all the names that were in the class's namespace when the class object was created. So, if the class definition looked like this::" -msgstr "*ارجاع به ویژگیها* از همان دستور زبان استاندارد که برای همه‌ی ارجاعها به ویژگیها در پایتون استفاده می‌شود، پیروی می‌کند: ``obj.name``. نام‌های ویژگی معتبر، همه‌ی نام‌هایی هستند که در هنگام ایجاد شیء کلاس، در فضای نام آن کلاس وجود داشته‌اند. بنابراین، اگر تعریف کلاس به این شکل بود::" +msgstr "*ارجاع به ویژگی‌ها* از همان دستور زبان استاندارد که برای همه‌ی ارجاعها به ویژگی‌ها در پایتون استفاده می‌شود، پیروی می‌کند: ``obj.name``. نام‌های ویژگی معتبر، همه‌ی نام‌هایی هستند که در هنگام ایجاد شیء کلاس، در فضای نام آن کلاس وجود داشته‌اند. بنابراین، اگر تعریف کلاس به این شکل بود::" msgid "" "class MyClass:\n" @@ -242,7 +242,7 @@ msgstr "" " return 'hello world'" msgid "then ``MyClass.i`` and ``MyClass.f`` are valid attribute references, returning an integer and a function object, respectively. Class attributes can also be assigned to, so you can change the value of ``MyClass.i`` by assignment. :attr:`~type.__doc__` is also a valid attribute, returning the docstring belonging to the class: ``\"A simple example class\"``." -msgstr "سپس ``MyClass.i`` و ``MyClass.f`` ارجاعهای ویژگی معتبری هستند که به‌ترتیب یک عدد صحیح و یک شیء تابع را برمی‌گردانند. به ویژگیهای کلاس نیز می‌توان مقدار داد، بنابراین می‌توانید مقدار ``MyClass.i`` را با تخصیص (مقداردهی) تغییر دهید. :attr:`~type.__doc__` نیز یک ویژگی معتبر است که رشته‌ی مستند (docstring) متعلق به کلاس را برمی‌گرداند: ``\"A simple example class\"``." +msgstr "سپس ``MyClass.i`` و ``MyClass.f`` ارجاعهای ویژگی معتبری هستند که به‌ترتیب یک عدد صحیح و یک شیء تابع را برمی‌گردانند. به ویژگی‌های کلاس نیز می‌توان مقدار داد، بنابراین می‌توانید مقدار ``MyClass.i`` را با تخصیص (مقداردهی) تغییر دهید. :attr:`~type.__doc__` نیز یک ویژگی معتبر است که رشته‌ی مستند (docstring) متعلق به کلاس را برمی‌گرداند: ``\"A simple example class\"``." msgid "Class *instantiation* uses function notation. Just pretend that the class object is a parameterless function that returns a new instance of the class. For example (assuming the above class)::" msgstr "*نمونه‌سازی* کلاس از نماد توابع استفاده می‌کند. فقط تصور کنید که شیء کلاس، یک تابع بدون پارامتر است که یک نمونه‌ی جدید از کلاس را برمی‌گرداند. برای مثال (با فرض کلاس بالا)::" @@ -292,10 +292,10 @@ msgid "Instance Objects" msgstr "اشیاء نمونه" msgid "Now what can we do with instance objects? The only operations understood by instance objects are attribute references. There are two kinds of valid attribute names: data attributes and methods." -msgstr "حالا با اشیاء نمونه چه کاری می‌توانیم انجام دهیم؟ تنها عملیاتی که اشیاء نمونه می‌فهمند، ارجاع به ویژگیها (attribute references) است. دو نوع نام ویژگی معتبر وجود دارد: ویژگیهای داده (data attributes) و متدها (methods)." +msgstr "حالا با اشیاء نمونه چه کاری می‌توانیم انجام دهیم؟ تنها عملیاتی که اشیاء نمونه می‌فهمند، ارجاع به ویژگی‌ها (attribute references) است. دو نوع نام ویژگی معتبر وجود دارد: ویژگی‌های داده (data attributes) و متد‌ها (methods)." msgid "*Data attributes* correspond to \"instance variables\" in Smalltalk, and to \"data members\" in C++. Data attributes need not be declared; like local variables, they spring into existence when they are first assigned to. For example, if ``x`` is the instance of :class:`!MyClass` created above, the following piece of code will print the value ``16``, without leaving a trace::" -msgstr "*ویژگیهای داده* معادل «متغیرهای نمونه» در زبان اسمالتاک و «عضوهای داده» در ++C هستند. ویژگیهای داده نیازی به اعلام ندارند؛ مانند متغیرهای محلی، هنگامی که برای اولین بار به آنها مقدار داده می‌شود، به‌وجود می‌آیند. برای مثال، اگر ``x`` نمونه‌ای از :class:`!MyClass` باشد که در بالا ایجاد شده است، قطعه کد زیر مقدار ``16`` را چاپ می‌کند، بدون اینکه هیچ اثری از خود بر جای بگذارد::" +msgstr "*ویژگی‌های داده* معادل «متغیر‌های نمونه» در زبان اسمالتاک و «عضوهای داده» در ++C هستند. ویژگی‌های داده نیازی به اعلام ندارند؛ مانند متغیر‌های محلی، هنگامی که برای اولین بار به آن‌ها مقدار داده می‌شود، به‌وجود می‌آیند. برای مثال، اگر ``x`` نمونه‌ای از :class:`!MyClass` باشد که در بالا ایجاد شده است، قطعه کد زیر مقدار ``16`` را چاپ می‌کند، بدون اینکه هیچ اثری از خود بر جای بگذارد::" msgid "" "x.counter = 1\n" @@ -314,7 +314,7 @@ msgid "The other kind of instance attribute reference is a *method*. A method is msgstr "نوع دیگر ارجاع به ویژگی نمونه، *متد* است. متد، تابعی است که «به» یک شیء تعلق دارد." msgid "Valid method names of an instance object depend on its class. By definition, all attributes of a class that are function objects define corresponding methods of its instances. So in our example, ``x.f`` is a valid method reference, since ``MyClass.f`` is a function, but ``x.i`` is not, since ``MyClass.i`` is not. But ``x.f`` is not the same thing as ``MyClass.f`` --- it is a *method object*, not a function object." -msgstr "نام‌های متد معتبر یک شیء نمونه به کلاس آن بستگی دارد. طبق تعریف، تمام ویژگیهای یک کلاس که شیء تابع هستند، متدهای متناظر با نمونه‌های آن را تعریف می‌کنند. بنابراین در مثال ما، ``x.f`` یک ارجاع متد معتبر است، زیرا ``MyClass.f`` یک تابع است، اما ``x.i`` معتبر نیست، زیرا ``MyClass.i`` تابع نیست. اما ``x.f`` با ``MyClass.f`` یکسان نیست --- بلکه یک *شیء متد* است، نه یک شیء تابع." +msgstr "نام‌های متد معتبر یک شیء نمونه به کلاس آن بستگی دارد. طبق تعریف، تمام ویژگی‌های یک کلاس که شیء تابع هستند، متد‌های متناظر با نمونه‌های آن را تعریف می‌کنند. بنابراین در مثال ما، ``x.f`` یک ارجاع متد معتبر است، زیرا ``MyClass.f`` یک تابع است، اما ``x.i`` معتبر نیست، زیرا ``MyClass.i`` تابع نیست. اما ``x.f`` با ``MyClass.f`` یکسان نیست --- بلکه یک *شیء متد* است، نه یک شیء تابع." msgid "Method Objects" msgstr "متد اشیاء" @@ -344,16 +344,16 @@ msgid "What exactly happens when a method is called? You may have noticed that msgstr "دقیقاً وقتی یک متد فراخوانی می‌شود، چه اتفاقی می‌افتد؟ احتمالاً متوجه شده‌اید که ``x.f()`` در بالا بدون هیچ آرگومانی فراخوانی شد، حتی اگر تعریف تابع :meth:`!f` یک آرگومان را مشخص کرده بود. چه بر سر آن آرگومان آمد؟ مسلماً پایتون وقتی یک تابع که به آرگومان نیاز دارد، بدون هیچ آرگومانی فراخوانی می‌شود، یک استثنا ایجاد می‌کند --- حتی اگر آن آرگومان واقعاً استفاده نشود..." msgid "Actually, you may have guessed the answer: the special thing about methods is that the instance object is passed as the first argument of the function. In our example, the call ``x.f()`` is exactly equivalent to ``MyClass.f(x)``. In general, calling a method with a list of *n* arguments is equivalent to calling the corresponding function with an argument list that is created by inserting the method's instance object before the first argument." -msgstr "در واقع، شاید پاسخ را حدس زده باشید: نکته‌ی ویژه در مورد متدها این است که شیء نمونه به‌عنوان اولین آرگومان تابع ارسال می‌شود. در مثال ما، فراخوانی ``x.f()`` دقیقاً معادل ``MyClass.f(x)`` است. به طور کلی، فراخوانی یک متد با فهرستی از *n* آرگومان معادل فراخوانی تابع متناظر با فهرست آرگومانی است که با قرار دادن شیء نمونه‌ی متد قبل از اولین آرگومان ایجاد می‌شود." +msgstr "در واقع، شاید پاسخ را حدس زده باشید: نکته‌ی ویژه در مورد متد‌ها این است که شیء نمونه به‌عنوان اولین آرگومان تابع ارسال می‌شود. در مثال ما، فراخوانی ``x.f()`` دقیقاً معادل ``MyClass.f(x)`` است. به طور کلی، فراخوانی یک متد با فهرستی از *n* آرگومان معادل فراخوانی تابع متناظر با فهرست آرگومانی است که با قرار دادن شیء نمونه‌ی متد قبل از اولین آرگومان ایجاد می‌شود." msgid "In general, methods work as follows. When a non-data attribute of an instance is referenced, the instance's class is searched. If the name denotes a valid class attribute that is a function object, references to both the instance object and the function object are packed into a method object. When the method object is called with an argument list, a new argument list is constructed from the instance object and the argument list, and the function object is called with this new argument list." -msgstr "به طور کلی، متدها به صورت زیر کار می‌کنند. هنگامی که به یک ویژگی غیرداده‌ای از یک نمونه ارجاع داده می‌شود، کلاس آن نمونه جست‌وجو می‌شود. اگر آن نام نشان‌دهنده‌ی یک ویژگی کلاس معتبر باشد که یک شیء تابع است، ارجاعات به هر دو شیء نمونه و شیء تابع در یک شیء متد بسته‌بندی می‌شوند. هنگامی که شیء متد با یک فهرست آرگومان فراخوانی می‌شود، یک فهرست آرگومان جدید از شیء نمونه و فهرست آرگومان ساخته می‌شود و شیء تابع با این فهرست آرگومان جدید فراخوانی می‌شود." +msgstr "به طور کلی، متد‌ها به صورت زیر کار می‌کنند. هنگامی که به یک ویژگی غیرداده‌ای از یک نمونه ارجاع داده می‌شود، کلاس آن نمونه جست‌وجو می‌شود. اگر آن نام نشان‌دهنده‌ی یک ویژگی کلاس معتبر باشد که یک شیء تابع است، ارجاعات به هر دو شیء نمونه و شیء تابع در یک شیء متد بسته‌بندی می‌شوند. هنگامی که شیء متد با یک فهرست آرگومان فراخوانی می‌شود، یک فهرست آرگومان جدید از شیء نمونه و فهرست آرگومان ساخته می‌شود و شیء تابع با این فهرست آرگومان جدید فراخوانی می‌شود." msgid "Class and Instance Variables" msgstr "کلاس و متغیر‌های نمونه" msgid "Generally speaking, instance variables are for data unique to each instance and class variables are for attributes and methods shared by all instances of the class::" -msgstr "به‌طور کلی، متغیرهای نمونه برای داده‌هایی هستند که مختص به هر نمونه و متغیرهای کلاس برای ویژگیها و متدهایی هستند که بین همه‌ی نمونه‌ها از آن کلاس مشترک هستند::" +msgstr "به‌طور کلی، متغیر‌های نمونه برای داده‌هایی هستند که مختص به هر نمونه و متغیر‌های کلاس برای ویژگی‌ها و متد‌هایی هستند که بین همه‌ی نمونه‌ها از آن کلاس مشترک هستند::" msgid "" "class Dog:\n" @@ -502,13 +502,13 @@ msgstr "" "storage east" msgid "Data attributes may be referenced by methods as well as by ordinary users (\"clients\") of an object. In other words, classes are not usable to implement pure abstract data types. In fact, nothing in Python makes it possible to enforce data hiding --- it is all based upon convention. (On the other hand, the Python implementation, written in C, can completely hide implementation details and control access to an object if necessary; this can be used by extensions to Python written in C.)" -msgstr "ویژگیهای داده ممکن است هم توسط متدها و هم توسط کاربران عادی (\"clients\") یک شیء ارجاع داده شوند. به عبارت دیگر، کلاس‌ها برای پیاده‌سازی انواع داده‌ی انتزاعی خالص قابل استفاده نیستند. در واقع، هیچ چیزی در پایتون امکان اعمال پنهان‌سازی داده را فراهم نمی‌کند --- همه‌چیز بر اساس قرارداد است. (از سوی دیگر، پیاده‌سازی پایتون که به زبان C نوشته شده است، می‌تواند جزئیات پیاده‌سازی را کاملاً پنهان کند و در صورت نیاز دسترسی به یک شیء را کنترل کند؛ این قابلیت می‌تواند توسط افزونه‌های پایتون که به زبان C نوشته می‌شوند، استفاده شود.)" +msgstr "ویژگی‌های داده ممکن است هم توسط متد‌ها و هم توسط کاربران عادی (\"clients\") یک شیء ارجاع داده شوند. به عبارت دیگر، کلاس‌ها برای پیاده‌سازی انواع داده‌ی انتزاعی خالص قابل استفاده نیستند. در واقع، هیچ چیزی در پایتون امکان اعمال پنهان‌سازی داده را فراهم نمی‌کند --- همه‌چیز بر اساس قرارداد است. (از سوی دیگر، پیاده‌سازی پایتون که به زبان C نوشته شده است، می‌تواند جزئیات پیاده‌سازی را کاملاً پنهان کند و در صورت نیاز دسترسی به یک شیء را کنترل کند؛ این قابلیت می‌تواند توسط افزونه‌های پایتون که به زبان C نوشته می‌شوند، استفاده شود.)" msgid "Clients should use data attributes with care --- clients may mess up invariants maintained by the methods by stamping on their data attributes. Note that clients may add data attributes of their own to an instance object without affecting the validity of the methods, as long as name conflicts are avoided --- again, a naming convention can save a lot of headaches here." -msgstr "کاربران (clients) باید با احتیاط از ویژگیهای داده استفاده کنند --- کاربران ممکن است ناورداهای حفظ‌شده توسط متدها را با دستکاری در ویژگیهای داده‌شان به هم بریزند. توجه داشته باشید که کاربران ممکن است ویژگیهای داده‌ی خود را به یک شیء نمونه اضافه کنند بدون اینکه بر صحت متدها تأثیر بگذارند، تا زمانی که تداخل نام‌ها اجتناب شود --- باز هم، یک قرارداد نام‌گذاری می‌تواند از بسیاری از سردرگمی‌ها در اینجا جلوگیری کند." +msgstr "کاربران (clients) باید با احتیاط از ویژگی‌های داده استفاده کنند --- کاربران ممکن است ناورداهای حفظ‌شده توسط متد‌ها را با دستکاری در ویژگی‌های داده‌شان به هم بریزند. توجه داشته باشید که کاربران ممکن است ویژگی‌های داده‌ی خود را به یک شیء نمونه اضافه کنند بدون اینکه بر صحت متد‌ها تأثیر بگذارند، تا زمانی که تداخل نام‌ها اجتناب شود --- باز هم، یک قرارداد نام‌گذاری می‌تواند از بسیاری از سردرگمی‌ها در اینجا جلوگیری کند." msgid "There is no shorthand for referencing data attributes (or other methods!) from within methods. I find that this actually increases the readability of methods: there is no chance of confusing local variables and instance variables when glancing through a method." -msgstr "هیچ گونه میان‌بری برای ارجاع به ویژگیهای داده (یا سایر متدها!) از درون متدها وجود ندارد. به نظر من، این موضوع در واقع خوانایی متدها را افزایش می‌دهد: هیچ شانسی برای اشتباه گرفتن متغیرهای محلی و متغیرهای نمونه هنگام مرور سریع یک متد وجود ندارد." +msgstr "هیچ گونه میان‌بری برای ارجاع به ویژگی‌های داده (یا سایر متد‌ها!) از درون متد‌ها وجود ندارد. به نظر من، این موضوع در واقع خوانایی متد‌ها را افزایش می‌دهد: هیچ شانسی برای اشتباه گرفتن متغیر‌های محلی و متغیر‌های نمونه هنگام مرور سریع یک متد وجود ندارد." msgid "Often, the first argument of a method is called ``self``. This is nothing more than a convention: the name ``self`` has absolutely no special meaning to Python. Note, however, that by not following the convention your code may be less readable to other Python programmers, and it is also conceivable that a *class browser* program might be written that relies upon such a convention." msgstr "معمولاً، اولین آرگومان یک متد ``self`` نامیده می‌شود. این چیزی بیش از یک قرارداد نیست: نام ``self`` هیچ معنی خاصی برای پایتون ندارد. با این حال، توجه داشته باشید که با رعایت نکردن این قرارداد، کد شما ممکن است برای سایر برنامه‌نویسان پایتون کمتر خوانا باشد، و همچنین قابل‌تصور است که یک برنامه *مرورگر کلاس* (class browser) نوشته شود که به چنین قراردادی وابسته باشد." @@ -542,10 +542,10 @@ msgstr "" " h = g" msgid "Now ``f``, ``g`` and ``h`` are all attributes of class :class:`!C` that refer to function objects, and consequently they are all methods of instances of :class:`!C` --- ``h`` being exactly equivalent to ``g``. Note that this practice usually only serves to confuse the reader of a program." -msgstr "اکنون ``f``، ``g`` و ``h`` همگی ویژگیهای کلاس :class:`!C` هستند که به اشیاء تابع اشاره دارند، و در نتیجه همگی متدهایی از نمونه‌های :class:`!C` هستند --- ``h`` دقیقاً معادل ``g`` است. توجه داشته باشید که این روش معمولاً فقط باعث سردرگمی خواننده‌ی برنامه می‌شود." +msgstr "اکنون ``f``، ``g`` و ``h`` همگی ویژگی‌های کلاس :class:`!C` هستند که به اشیاء تابع اشاره دارند، و در نتیجه همگی متد‌هایی از نمونه‌های :class:`!C` هستند --- ``h`` دقیقاً معادل ``g`` است. توجه داشته باشید که این روش معمولاً فقط باعث سردرگمی خواننده‌ی برنامه می‌شود." msgid "Methods may call other methods by using method attributes of the ``self`` argument::" -msgstr "متدها می‌توانند سایر متدها را با استفاده از ویژگیهای متد آرگومان ``self`` فراخوانی کنند::" +msgstr "متد‌ها می‌توانند سایر متد‌ها را با استفاده از ویژگی‌های متد آرگومان ``self`` فراخوانی کنند::" msgid "" "class Bag:\n" @@ -571,7 +571,7 @@ msgstr "" " self.add(x)" msgid "Methods may reference global names in the same way as ordinary functions. The global scope associated with a method is the module containing its definition. (A class is never used as a global scope.) While one rarely encounters a good reason for using global data in a method, there are many legitimate uses of the global scope: for one thing, functions and modules imported into the global scope can be used by methods, as well as functions and classes defined in it. Usually, the class containing the method is itself defined in this global scope, and in the next section we'll find some good reasons why a method would want to reference its own class." -msgstr "متدها ممکن است به نام‌های سراسری به همان روشی که توابع معمولی اشاره می‌کنند، ارجاع دهند. محدوده‌ی سراسری مرتبط با یک متد، ماژولی است که شامل تعریف آن است. (یک کلاس هرگز به‌عنوان محدوده‌ی سراسری استفاده نمی‌شود.) اگرچه به ندرت دلیل خوبی برای استفاده از داده‌های سراسری در یک متد یافت می‌شود، اما کاربردهای مشروع زیادی برای محدوده‌ی سراسری وجود دارد: برای یک چیز، توابع و ماژول‌هایی که به محدوده‌ی سراسری ایمپورت شده‌اند، می‌توانند توسط متدها استفاده شوند، همچنین توابع و کلاس‌های تعریف‌شده در آن. معمولاً، کلاسی که شامل متد است، خود در این محدوده‌ی سراسری تعریف می‌شود، و در بخش بعدی دلایل خوبی خواهیم یافت که چرا یک متد ممکن است بخواهد به کلاس خودش ارجاع دهد." +msgstr "متد‌ها ممکن است به نام‌های سراسری به همان روشی که توابع معمولی اشاره می‌کنند، ارجاع دهند. محدوده‌ی سراسری مرتبط با یک متد، ماژولی است که شامل تعریف آن است. (یک کلاس هرگز به‌عنوان محدوده‌ی سراسری استفاده نمی‌شود.) اگرچه به ندرت دلیل خوبی برای استفاده از داده‌های سراسری در یک متد یافت می‌شود، اما کاربردهای مشروع زیادی برای محدوده‌ی سراسری وجود دارد: برای یک چیز، توابع و ماژول‌هایی که به محدوده‌ی سراسری ایمپورت شده‌اند، می‌توانند توسط متد‌ها استفاده شوند، همچنین توابع و کلاس‌های تعریف‌شده در آن. معمولاً، کلاسی که شامل متد است، خود در این محدوده‌ی سراسری تعریف می‌شود، و در بخش بعدی دلایل خوبی خواهیم یافت که چرا یک متد ممکن است بخواهد به کلاس خودش ارجاع دهد." msgid "Each value is an object, and therefore has a *class* (also called its *type*). It is stored as ``object.__class__``." msgstr "هر مقدار یک شیء است، و بنابراین دارای یک *کلاس* (که به آن *تایپ* نیز گفته می‌شود) می‌باشد. این مقدار به‌صورت ``object.__class__`` ذخیره می‌شود." @@ -604,13 +604,13 @@ msgid "class DerivedClassName(modname.BaseClassName):" msgstr "class DerivedClassName(modname.BaseClassName):" msgid "Execution of a derived class definition proceeds the same as for a base class. When the class object is constructed, the base class is remembered. This is used for resolving attribute references: if a requested attribute is not found in the class, the search proceeds to look in the base class. This rule is applied recursively if the base class itself is derived from some other class." -msgstr "اجرای تعریف یک کلاس مشتق‌شده به همان شیوه‌ای است که برای یک کلاس پایه انجام می‌شود. هنگامی که شیء کلاس ساخته می‌شود، کلاس پایه به خاطر سپرده می‌شود. این (اطلاعات) برای حل کردن ارجاعات به ویژگیها استفاده می‌شود: اگر ویژگی درخواستی در کلاس یافت نشود، جست‌وجو در کلاس پایه ادامه می‌یابد. این قاعده به‌صورت بازگشتی اعمال می‌شود اگر خود کلاس پایه از کلاس دیگری مشتق شده باشد." +msgstr "اجرای تعریف یک کلاس مشتق‌شده به همان شیوه‌ای است که برای یک کلاس پایه انجام می‌شود. هنگامی که شیء کلاس ساخته می‌شود، کلاس پایه به خاطر سپرده می‌شود. این (اطلاعات) برای حل کردن ارجاعات به ویژگی‌ها استفاده می‌شود: اگر ویژگی درخواستی در کلاس یافت نشود، جست‌وجو در کلاس پایه ادامه می‌یابد. این قاعده به‌صورت بازگشتی اعمال می‌شود اگر خود کلاس پایه از کلاس دیگری مشتق شده باشد." msgid "There's nothing special about instantiation of derived classes: ``DerivedClassName()`` creates a new instance of the class. Method references are resolved as follows: the corresponding class attribute is searched, descending down the chain of base classes if necessary, and the method reference is valid if this yields a function object." msgstr "هیچ نکته‌ی خاصی درباره‌ی نمونه‌سازی کلاس‌های مشتق‌شده وجود ندارد: ``DerivedClassName()`` یک نمونه‌ی جدید از کلاس ایجاد می‌کند. ارجاعهای متد به‌صورت زیر حل می‌شوند: ویژگی کلاس متناظر جست‌وجو می‌شود، در صورت لزوم در زنجیره‌ی کلاس‌های پایه به پایین می‌رود، و ارجاع متد در صورتی معتبر است که این جست‌وجو به یک شیء تابع منجر شود." msgid "Derived classes may override methods of their base classes. Because methods have no special privileges when calling other methods of the same object, a method of a base class that calls another method defined in the same base class may end up calling a method of a derived class that overrides it. (For C++ programmers: all methods in Python are effectively ``virtual``.)" -msgstr "کلاس‌های مشتق‌شده ممکن است متدهای کلاس‌های پایه‌ی خود را بازنویسی کنند. از آنجایی که متدها هنگام فراخوانی سایر متدهای همان شیء، امتیاز ویژه‌ای ندارند، یک متد از یک کلاس پایه که متد دیگری را که در همان کلاس پایه تعریف شده فراخوانی می‌کند، ممکن است در نهایت متدی از یک کلاس مشتق‌شده را فراخوانی کند که آن را بازنویسی کرده است. (برای برنامه‌نویسان C++: تمام متدها در پایتون به‌طور مؤثر ``virtual`` هستند.)" +msgstr "کلاس‌های مشتق‌شده ممکن است متد‌های کلاس‌های پایه‌ی خود را بازنویسی کنند. از آنجایی که متد‌ها هنگام فراخوانی سایر متد‌های همان شیء، امتیاز ویژه‌ای ندارند، یک متد از یک کلاس پایه که متد دیگری را که در همان کلاس پایه تعریف شده فراخوانی می‌کند، ممکن است در نهایت متدی از یک کلاس مشتق‌شده را فراخوانی کند که آن را بازنویسی کرده است. (برای برنامه‌نویسان C++: تمام متد‌ها در پایتون به‌طور مؤثر ``virtual`` هستند.)" msgid "An overriding method in a derived class may in fact want to extend rather than simply replace the base class method of the same name. There is a simple way to call the base class method directly: just call ``BaseClassName.methodname(self, arguments)``. This is occasionally useful to clients as well. (Note that this only works if the base class is accessible as ``BaseClassName`` in the global scope.)" msgstr "یک متد بازنویسی‌شده در یک کلاس مشتق‌شده ممکن است در واقع بخواهد به جای اینکه صرفاً متد کلاس پایه را با همین نام جایگزین کند، آن را گسترش دهد. یک راه ساده برای فراخوانی مستقیم متد کلاس پایه وجود دارد: فقط ``BaseClassName.methodname(self, arguments)`` را فراخوانی کنید. این روش گاهی برای کاربران (clients) نیز مفید است. (توجه داشته باشید که این روش تنها زمانی کار می‌کند که کلاس پایه به‌عنوان ``BaseClassName`` در محدوده‌ی سراسری (global scope) قابل دسترسی باشد.)" @@ -646,19 +646,19 @@ msgstr "" " " msgid "For most purposes, in the simplest cases, you can think of the search for attributes inherited from a parent class as depth-first, left-to-right, not searching twice in the same class where there is an overlap in the hierarchy. Thus, if an attribute is not found in :class:`!DerivedClassName`, it is searched for in :class:`!Base1`, then (recursively) in the base classes of :class:`!Base1`, and if it was not found there, it was searched for in :class:`!Base2`, and so on." -msgstr "برای بیشتر کاربردها، در ساده‌ترین موارد، می‌توانید جست‌وجو برای ویژگیهای به‌ارث‌برده‌شده از یک کلاس والد را به‌صورت عمق‌اول، چپ‌به‌راست، بدون جست‌وجوی دوباره در همان کلاس در جایی که همپوشانی در سلسله‌مراتب وجود دارد، در نظر بگیرید. بنابراین، اگر ویژگی‌ای در :class:`!DerivedClassName` یافت نشد، در :class:`!Base1` جست‌وجو می‌شود، سپس (به‌صورت بازگشتی) در کلاس‌های پایه‌ی :class:`!Base1`، و اگر در آنجا یافت نشد، در :class:`!Base2` جست‌وجو می‌شود، و به همین ترتیب." +msgstr "برای بیشتر کاربردها، در ساده‌ترین موارد، می‌توانید جست‌وجو برای ویژگی‌های به‌ارث‌برده‌شده از یک کلاس والد را به‌صورت عمق‌اول، چپ‌به‌راست، بدون جست‌وجوی دوباره در همان کلاس در جایی که همپوشانی در سلسله‌مراتب وجود دارد، در نظر بگیرید. بنابراین، اگر ویژگی‌ای در :class:`!DerivedClassName` یافت نشد، در :class:`!Base1` جست‌وجو می‌شود، سپس (به‌صورت بازگشتی) در کلاس‌های پایه‌ی :class:`!Base1`، و اگر در آنجا یافت نشد، در :class:`!Base2` جست‌وجو می‌شود، و به همین ترتیب." msgid "In fact, it is slightly more complex than that; the method resolution order changes dynamically to support cooperative calls to :func:`super`. This approach is known in some other multiple-inheritance languages as call-next-method and is more powerful than the super call found in single-inheritance languages." -msgstr "در واقع، این موضوع کمی پیچیده‌تر از این است؛ ترتیب حل متد به‌صورت پویا تغییر می‌کند تا از فراخوانی‌های مشارکتی به :func:`super` پشتیبانی کند. این رویکرد در برخی دیگر از زبانهای دارای ارث‌بری چندگانه با نام call-next-method شناخته می‌شود و از فراخوانی super موجود در زبانهای دارای ارث‌بری تکی قدرتمندتر است." +msgstr "در واقع، این موضوع کمی پیچیده‌تر از این است؛ ترتیب حل متد به‌صورت پویا تغییر می‌کند تا از فراخوانی‌های مشارکتی به :func:`super` پشتیبانی کند. این رویکرد در برخی دیگر از زبان‌های دارای ارث‌بری چندگانه با نام call-next-method شناخته می‌شود و از فراخوانی super موجود در زبان‌های دارای ارث‌بری تکی قدرتمندتر است." msgid "Dynamic ordering is necessary because all cases of multiple inheritance exhibit one or more diamond relationships (where at least one of the parent classes can be accessed through multiple paths from the bottommost class). For example, all classes inherit from :class:`object`, so any case of multiple inheritance provides more than one path to reach :class:`object`. To keep the base classes from being accessed more than once, the dynamic algorithm linearizes the search order in a way that preserves the left-to-right ordering specified in each class, that calls each parent only once, and that is monotonic (meaning that a class can be subclassed without affecting the precedence order of its parents). Taken together, these properties make it possible to design reliable and extensible classes with multiple inheritance. For more detail, see :ref:`python_2.3_mro`." -msgstr "ترتیب‌دهی پویا ضروری است زیرا همه‌ی موارد ارث‌بری چندگانه دارای یک یا چند رابطه‌ی الماسی هستند (جایی که حداقل یکی از کلاس‌های والد از طریق چندین مسیر از پایین‌ترین کلاس قابل دسترسی است). برای مثال، همه‌ی کلاس‌ها از :class:`object` ارث‌بری می‌کنند، بنابراین هر موردی از ارث‌بری چندگانه بیش از یک مسیر برای رسیدن به :class:`object` فراهم می‌کند. برای جلوگیری از دسترسی بیش از یک بار به کلاس‌های پایه، الگوریتم پویا ترتیب جست‌وجو را به‌گونه‌ای خطی‌سازی می‌کند که ترتیب چپ‌به‌راست مشخص‌شده در هر کلاس را حفظ کند، که هر والد را فقط یک بار فراخوانی می‌کند، و یکنواخت است (به این معنی که یک کلاس می‌تواند زیرکلاس‌ داشته باشد بدون اینکه بر ترتیب اولویت والدین آن تأثیر بگذارد). این ویژگیها در کنار هم، طراحی کلاس‌های قابل اعتماد و قابل توسعه با ارث‌بری چندگانه را ممکن می‌سازند. برای جزئیات بیشتر، به :ref:`python_2.3_mro` مراجعه کنید." +msgstr "ترتیب‌دهی پویا ضروری است زیرا همه‌ی موارد ارث‌بری چندگانه دارای یک یا چند رابطه‌ی الماسی هستند (جایی که حداقل یکی از کلاس‌های والد از طریق چندین مسیر از پایین‌ترین کلاس قابل دسترسی است). برای مثال، همه‌ی کلاس‌ها از :class:`object` ارث‌بری می‌کنند، بنابراین هر موردی از ارث‌بری چندگانه بیش از یک مسیر برای رسیدن به :class:`object` فراهم می‌کند. برای جلوگیری از دسترسی بیش از یک بار به کلاس‌های پایه، الگوریتم پویا ترتیب جست‌وجو را به‌گونه‌ای خطی‌سازی می‌کند که ترتیب چپ‌به‌راست مشخص‌شده در هر کلاس را حفظ کند، که هر والد را فقط یک بار فراخوانی می‌کند، و یکنواخت است (به این معنی که یک کلاس می‌تواند زیرکلاس‌ داشته باشد بدون اینکه بر ترتیب اولویت والدین آن تأثیر بگذارد). این ویژگی‌ها در کنار هم، طراحی کلاس‌های قابل اعتماد و قابل توسعه با ارث‌بری چندگانه را ممکن می‌سازند. برای جزئیات بیشتر، به :ref:`python_2.3_mro` مراجعه کنید." msgid "Private Variables" msgstr "متغیر‌های خصوصی" msgid "\"Private\" instance variables that cannot be accessed except from inside an object don't exist in Python. However, there is a convention that is followed by most Python code: a name prefixed with an underscore (e.g. ``_spam``) should be treated as a non-public part of the API (whether it is a function, a method or a data member). It should be considered an implementation detail and subject to change without notice." -msgstr "متغیرهای نمونه‌ای «خصوصی» که جز از درون یک شیء قابل دسترسی نیستند، در پایتون وجود ندارند. با این حال، یک قرارداد وجود دارد که توسط بیشتر کدهای پایتون دنبال می‌شود: یک نام که با زیرخط آغاز می‌شود (مثلاً ``_spam``) باید به‌عنوان بخشی غیرعمومی از API در نظر گرفته شود (خواه یک تابع، یک متد یا یک عضو داده باشد). باید به‌عنوان یک جزئیات پیاده‌سازی در نظر گرفته شود و ممکن است بدون اطلاع‌رسانی تغییر کند." +msgstr "متغیر‌های نمونه‌ای «خصوصی» که جز از درون یک شیء قابل دسترسی نیستند، در پایتون وجود ندارند. با این حال، یک قرارداد وجود دارد که توسط بیشتر کدهای پایتون دنبال می‌شود: یک نام که با زیرخط آغاز می‌شود (مثلاً ``_spam``) باید به‌عنوان بخشی غیرعمومی از API در نظر گرفته شود (خواه یک تابع، یک متد یا یک عضو داده باشد). باید به‌عنوان یک جزئیات پیاده‌سازی در نظر گرفته شود و ممکن است بدون اطلاع‌رسانی تغییر کند." msgid "Since there is a valid use-case for class-private members (namely to avoid name clashes of names with names defined by subclasses), there is limited support for such a mechanism, called :dfn:`name mangling`. Any identifier of the form ``__spam`` (at least two leading underscores, at most one trailing underscore) is textually replaced with ``_classname__spam``, where ``classname`` is the current class name with leading underscore(s) stripped. This mangling is done without regard to the syntactic position of the identifier, as long as it occurs within the definition of a class." msgstr "از آنجا که یک مورد استفاده‌ی معتبر برای اعضای خصوصی کلاس وجود دارد (به‌ویژه برای جلوگیری از برخورد نام‌ها با نام‌های تعریف‌شده توسط زیرکلاس‌ها)، پشتیبانی محدودی برای چنین مکانیزمی، به نام :dfn:`name mangling` (دستکاری نام) وجود دارد. هر شناسه‌ای به شکل ``__spam`` (حداقل دو زیرخط در ابتدا، حداکثر یک زیرخط در انتها) به‌صورت متنی با ``_classname__spam`` جایگزین می‌شود، که در آن ``classname`` نام کلاس جاری است با زیرخط‌های ابتدایی حذف‌شده. این دستکاری بدون در نظر گرفتن جایگاه نحوی شناسه انجام می‌شود، تا زمانی که درون تعریف یک کلاس رخ دهد." @@ -667,7 +667,7 @@ msgid "The :ref:`private name mangling specifications ` f msgstr "برای جزئیات و موارد خاص، به :ref:`مشخصات دستکاری نام‌های خصوصی ` مراجعه کنید." msgid "Name mangling is helpful for letting subclasses override methods without breaking intraclass method calls. For example::" -msgstr "دستکاری نام برای این مفید است که به زیرکلاس‌ها اجازه دهد متدها را بدون شکستن فراخوانی‌های متد درون‌کلاسی بازنویسی کنند. برای مثال::" +msgstr "دستکاری نام برای این مفید است که به زیرکلاس‌ها اجازه دهد متد‌ها را بدون شکستن فراخوانی‌های متد درون‌کلاسی بازنویسی کنند. برای مثال::" msgid "" "class Mapping:\n" @@ -754,13 +754,13 @@ msgstr "" "1000" msgid "A piece of Python code that expects a particular abstract data type can often be passed a class that emulates the methods of that data type instead. For instance, if you have a function that formats some data from a file object, you can define a class with methods :meth:`~io.TextIOBase.read` and :meth:`~io.TextIOBase.readline` that get the data from a string buffer instead, and pass it as an argument." -msgstr "یک قطعه کد پایتون که انتظار یک نوع دادهٔ انتزاعی خاص را دارد، اغلب می‌تواند به جای آن، یک کلاس دریافت کند که متدهای آن نوع داده را شبیه‌سازی می‌کند. برای مثال، اگر تابعی دارید که داده‌هایی را از یک شیء فایل قالب‌بندی می‌کند، می‌توانید کلاسی تعریف کنید با متدهای :meth:`~io.TextIOBase.read` و :meth:`~io.TextIOBase.readline` که داده‌ها را از یک بافر رشته‌ای دریافت می‌کنند، و آن را به‌عنوان آرگومان به تابع ارسال کنید." +msgstr "یک قطعه کد پایتون که انتظار یک نوع دادهٔ انتزاعی خاص را دارد، اغلب می‌تواند به جای آن، یک کلاس دریافت کند که متد‌های آن نوع داده را شبیه‌سازی می‌کند. برای مثال، اگر تابعی دارید که داده‌هایی را از یک شیء فایل قالب‌بندی می‌کند، می‌توانید کلاسی تعریف کنید با متد‌های :meth:`~io.TextIOBase.read` و :meth:`~io.TextIOBase.readline` که داده‌ها را از یک بافر رشته‌ای دریافت می‌کنند، و آن را به‌عنوان آرگومان به تابع ارسال کنید." msgid ":ref:`Instance method objects ` have attributes, too: :attr:`m.__self__ ` is the instance object with the method :meth:`!m`, and :attr:`m.__func__ ` is the :ref:`function object ` corresponding to the method." -msgstr ":ref:`اشیاء متد نمونه ` نیز ویژگیهایی دارند: :attr:`m.__self__ ` شیء نمونه‌ای است که متد :meth:`!m` به آن تعلق دارد، و :attr:`m.__func__ ` همان :ref:`شیء تابع ` متناظر با آن متد است." +msgstr ":ref:`اشیاء متد نمونه ` نیز ویژگی‌هایی دارند: :attr:`m.__self__ ` شیء نمونه‌ای است که متد :meth:`!m` به آن تعلق دارد، و :attr:`m.__func__ ` همان :ref:`شیء تابع ` متناظر با آن متد است." msgid "Iterators" -msgstr "تکرارگرها" +msgstr "تکرارگر‌ها" msgid "By now you have probably noticed that most container objects can be looped over using a :keyword:`for` statement::" msgstr "تا اینجا احتمالاً متوجه شده‌اید که می‌توان روی بیشتر اشیاء ظرف با استفاده از دستور :keyword:`for` حلقه زد::" @@ -789,7 +789,7 @@ msgstr "" " print(line, end='')" msgid "This style of access is clear, concise, and convenient. The use of iterators pervades and unifies Python. Behind the scenes, the :keyword:`for` statement calls :func:`iter` on the container object. The function returns an iterator object that defines the method :meth:`~iterator.__next__` which accesses elements in the container one at a time. When there are no more elements, :meth:`~iterator.__next__` raises a :exc:`StopIteration` exception which tells the :keyword:`!for` loop to terminate. You can call the :meth:`~iterator.__next__` method using the :func:`next` built-in function; this example shows how it all works::" -msgstr "این سبک دسترسی واضح، مختصر و راحت است. استفاده از تکرارگرها در همه‌جا نفوذ کرده و پایتون را یکپارچه می‌کنند. در پشت صحنه، دستور :keyword:`for` تابع :func:`iter` را روی شیء ظرف فراخوانی می‌کند. این تابع یک شیء تکرارگر برمی‌گرداند که متد :meth:`~iterator.__next__` را تعریف می‌کند که به المان‌ها در ظرف یکی یکی دسترسی پیدا می‌کند. وقتی المان‌ها تمام شوند، :meth:`~iterator.__next__` یک استثنای :exc:`StopIteration` ایجاد می‌کند که به حلقه‌ی :keyword:`!for` می‌گوید پایان یابد. می‌توانید متد :meth:`~iterator.__next__` را با استفاده از تابع داخلی :func:`next` فراخوانی کنید؛ این مثال نشان می‌دهد که چگونه همه‌چیز کار می‌کند::" +msgstr "این سبک دسترسی واضح، مختصر و راحت است. استفاده از تکرارگر‌ها در همه‌جا نفوذ کرده و پایتون را یکپارچه می‌کنند. در پشت صحنه، دستور :keyword:`for` تابع :func:`iter` را روی شیء ظرف فراخوانی می‌کند. این تابع یک شیء تکرارگر برمی‌گرداند که متد :meth:`~iterator.__next__` را تعریف می‌کند که به المان‌ها در ظرف یکی یکی دسترسی پیدا می‌کند. وقتی المان‌ها تمام شوند، :meth:`~iterator.__next__` یک استثنای :exc:`StopIteration` ایجاد می‌کند که به حلقه‌ی :keyword:`!for` می‌گوید پایان یابد. می‌توانید متد :meth:`~iterator.__next__` را با استفاده از تابع داخلی :func:`next` فراخوانی کنید؛ این مثال نشان می‌دهد که چگونه همه‌چیز کار می‌کند::" msgid "" ">>> s = 'abc'\n" @@ -914,13 +914,13 @@ msgstr "" "g" msgid "Anything that can be done with generators can also be done with class-based iterators as described in the previous section. What makes generators so compact is that the :meth:`~iterator.__iter__` and :meth:`~generator.__next__` methods are created automatically." -msgstr "هر چیزی که با تولیدگرها قابل انجام است، می‌تواند با استفاده از تکرارگرهای مبتنی بر کلاس نیز انجام شود، همانطور که در بخش قبلی توضیح داده شد. آنچه تولیدگر‌ها را فشرده می‌کند، این است که روش‌های :meth:`~iterator.__iter__` و :meth:`~generator.__next__` به‌طور خودکار ایجاد می‌شوند." +msgstr "هر چیزی که با تولیدگر‌ها قابل انجام است، می‌تواند با استفاده از تکرارگر‌های مبتنی بر کلاس نیز انجام شود، همانطور که در بخش قبلی توضیح داده شد. آنچه تولیدگر‌ها را فشرده می‌کند، این است که روش‌های :meth:`~iterator.__iter__` و :meth:`~generator.__next__` به‌طور خودکار ایجاد می‌شوند." msgid "Another key feature is that the local variables and execution state are automatically saved between calls. This made the function easier to write and much more clear than an approach using instance variables like ``self.index`` and ``self.data``." msgstr "یکی دیگر از ویژگی‌های کلیدواژه‌ای این است که متغیر‌های محلی و وضعیت اجرا به‌طور خودکار بین فراخوانی‌ها ذخیره می‌شوند. این امر نوشتن تابع را آسان‌تر و خیلی واضح‌تر از رویکردی که از متغیر‌های نمونه‌ای مانند ``self.index`` و ``self.data`` استفاده می‌کند، کرده است." msgid "In addition to automatic method creation and saving program state, when generators terminate, they automatically raise :exc:`StopIteration`. In combination, these features make it easy to create iterators with no more effort than writing a regular function." -msgstr "علاوه بر ایجاد خودکار متد‌ها و ذخیره سازی وضعیت برنامه، زمانی که تولیدگر‌ها خاتمه می‌یابند، به‌طور خودکار :exc:`StopIteration` را ایجاد می‌کنند. این ویژگیها به صورت ترکیبی، ساختن تکرارگرها را به همان سادگی نوشتن یک تابع عادی امکان پذیر می‌سازند." +msgstr "علاوه بر ایجاد خودکار متد‌ها و ذخیره سازی وضعیت برنامه، زمانی که تولیدگر‌ها خاتمه می‌یابند، به‌طور خودکار :exc:`StopIteration` را ایجاد می‌کنند. این ویژگی‌ها به صورت ترکیبی، ساختن تکرارگر‌ها را به همان سادگی نوشتن یک تابع عادی امکان پذیر می‌سازند." msgid "Generator Expressions" msgstr "عبارات تولیدگر" @@ -929,7 +929,7 @@ msgid "Some simple generators can be coded succinctly as expressions using a syn msgstr "برخی از تولیدگر‌های ساده را می‌توان به‌صورت مختصر به‌عنوان عبارت کدنویسی کرد، با استفاده از یک نحو مشابه درک‌فهرستها اما با پرانتز به جای کروشه‌ی باز. این عبارت‌ها برای شرایطی طراحی شده‌اند که تولیدگر بلافاصله توسط یک تابع محاط‌شونده استفاده می‌شود. عبارت‌های تولیدگر فشرده‌تر هستند اما نسبت به تعاریف کامل تولیدگر، انعطاف‌پذیری کمتری دارند و معمولاً نسبت به درک‌فهرستهای معادل، با حافظه سازگارتر هستند." msgid "Examples::" -msgstr "مثالها::" +msgstr "مثال‌ها::" msgid "" ">>> sum(i*i for i in range(10)) # sum of squares\n" From 0f5e735cd216eb32de4a4dbae9eb45ec878c9993 Mon Sep 17 00:00:00 2001 From: invincible627 Date: Fri, 21 Aug 2026 19:35:14 +0330 Subject: [PATCH 03/11] =?UTF-8?q?Revert=20"Add=20some=20semispaces=20(?= =?UTF-8?q?=E2=80=8C)=20in=20tutorial/classes.po=20file"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit eecf4a942655a60d2af25bbd159af66e97d7bd68. --- tutorial/classes.po | 80 ++++++++++++++++++++++----------------------- 1 file changed, 40 insertions(+), 40 deletions(-) diff --git a/tutorial/classes.po b/tutorial/classes.po index 90277527b..950a471e0 100644 --- a/tutorial/classes.po +++ b/tutorial/classes.po @@ -34,7 +34,7 @@ msgid "Classes provide a means of bundling data and functionality together. Cre msgstr "کلاس‌ها وسیله‌ای را برای بسته‌بندی کردن داده و عملکرد با هم فراهم می‌کنند. ایجاد یک کلاس جدید، نوع جدیدی ایجاد می‌کند که اجازه می‌دهد موارد جدیدی از آن نوع ساخته شود. هر نمونه از کلاس می‌تواند صفاتی داشته باشد که به آن متصل شده‌اند تا وضعیت آن را حفظ کنند. نمونه‌های کلاس می‌توانند همچنین متد‌هایی (که توسط کلاس تعریف شده‌اند) داشته باشند تا وضعیت آن را تغییر دهند." msgid "Compared with other programming languages, Python's class mechanism adds classes with a minimum of new syntax and semantics. It is a mixture of the class mechanisms found in C++ and Modula-3. Python classes provide all the standard features of Object Oriented Programming: the class inheritance mechanism allows multiple base classes, a derived class can override any methods of its base class or classes, and a method can call the method of a base class with the same name. Objects can contain arbitrary amounts and kinds of data. As is true for modules, classes partake of the dynamic nature of Python: they are created at runtime, and can be modified further after creation." -msgstr "در مقایسه با دیگر زبان‌های برنامه‌نویسی، مکانیزم کلاس در پایتون کلاس‌ها را با حداقل قواعد و معناشناسی جدید اضافه می‌کند. این مکانیزم ترکیبی از مکانیزم‌های کلاسی است که در C++ و Modula-3 یافت می‌شود. کلاس‌های پایتون تمام ویژگی‌های استاندارد برنامه‌نویسی شیءگرا را فراهم می‌کنند: مکانیزم ارث بری کلاس‌ها اجازه می‌دهد کلاس‌های پایه‌ی متعددی داشته باشید، یک کلاس مشتق می‌تواند هر یک از متد‌های کلاس‌های پایه‌ی خود را بازنویسی کند و یک متد می‌تواند متدی از کلاس پایه با همان نام را فراخوانی کند. اشیاء می‌توانند حاوی مقادیر و انواع داده‌ای دلخواه باشند. همان‌طور که برای ماژول‌ها صادق است، کلاس‌ها نیز از طبیعت پویا در پایتون برخوردارند: آن‌ها در زمان اجرا ایجاد می‌شوند و می‌توانند پس از ایجاد بیشتر تغییر داده شوند." +msgstr "در مقایسه با دیگر زبانهای برنامه‌نویسی، مکانیزم کلاس در پایتون کلاس‌ها را با حداقل قواعد و معناشناسی جدید اضافه می‌کند. این مکانیزم ترکیبی از مکانیزم‌های کلاسی است که در C++ و Modula-3 یافت می‌شود. کلاس‌های پایتون تمام ویژگیهای استاندارد برنامه‌نویسی شیءگرا را فراهم می‌کنند: مکانیزم ارث بری کلاس‌ها اجازه می‌دهد کلاس‌های پایه‌ی متعددی داشته باشید، یک کلاس مشتق می‌تواند هر یک از متد‌های کلاس‌های پایه‌ی خود را بازنویسی کند و یک متد می‌تواند متدی از کلاس پایه با همان نام را فراخوانی کند. اشیاء می‌توانند حاوی مقادیر و انواع داده‌ای دلخواه باشند. همان‌طور که برای ماژول‌ها صادق است، کلاس‌ها نیز از طبیعت پویا در پایتون برخوردارند: آن‌ها در زمان اجرا ایجاد می‌شوند و می‌توانند پس از ایجاد بیشتر تغییر داده شوند." msgid "In C++ terminology, normally class members (including the data members) are *public* (except see below :ref:`tut-private`), and all member functions are *virtual*. As in Modula-3, there are no shorthands for referencing the object's members from its methods: the method function is declared with an explicit first argument representing the object, which is provided implicitly by the call. As in Smalltalk, classes themselves are objects. This provides semantics for importing and renaming. Unlike C++ and Modula-3, built-in types can be used as base classes for extension by the user. Also, like in C++, most built-in operators with special syntax (arithmetic operators, subscripting etc.) can be redefined for class instances." msgstr "در اصطلاحات C++، معمولاً اعضای کلاس (از جمله اعضای داده) *public* هستند (به جز موردی که در پایین :ref:`tut-private` ذکر شده است)، و تمامی توابع عضو مجازی هستند. همان‌طور که در Modula-3، هیچ میانبر‌هایی برای ارجاع به اعضای شیء از متد‌های آن وجود ندارد: تابع متد با یک آرگومان اول صریح که نمایانگر شیء است، اعلام می‌شود که این آرگومان به صورت ضمنی توسط فراخوانی فراهم می‌شود. همان‌طور که در Smalltalk، خود کلاس‌ها اشیاء هستند. این ویژگی معناشناسی برای وارد کردن و تغییر نام را فراهم می‌آورد. برخلاف C++ و Modula-3، نوع‌های داخلی می‌توانند به‌عنوان کلاس‌های پایه برای توسعه توسط کاربر استفاده شوند. همچنین، مانند C++، بیشتر عملگر‌های داخلی با نحوی خاص (عملگر‌های ریاضی، زیرنویسی و غیره) می‌توانند برای نمونه‌های کلاس بازتعریف شوند." @@ -46,7 +46,7 @@ msgid "A Word About Names and Objects" msgstr "سخنی درباره‌ی نام‌ها و اشیاء" msgid "Objects have individuality, and multiple names (in multiple scopes) can be bound to the same object. This is known as aliasing in other languages. This is usually not appreciated on a first glance at Python, and can be safely ignored when dealing with immutable basic types (numbers, strings, tuples). However, aliasing has a possibly surprising effect on the semantics of Python code involving mutable objects such as lists, dictionaries, and most other types. This is usually used to the benefit of the program, since aliases behave like pointers in some respects. For example, passing an object is cheap since only a pointer is passed by the implementation; and if a function modifies an object passed as an argument, the caller will see the change --- this eliminates the need for two different argument passing mechanisms as in Pascal." -msgstr "اشیاء هویت فردی دارند و چندین نام (در چندین محدوده) می‌توانند به یک شیء مشخص متصل شوند. این در زبان‌های دیگر با نام «اسم‌های مستعار» شناخته می‌شود. این ویژگی معمولاً در نگاه اول به پایتون چندان جلب توجه نمی‌کند و هنگام کار با انواع پایه‌ی تغییرناپذیر (اعداد، رشته‌ها، تاپل‌ها) می‌توان آن را نادیده گرفت. با این حال، نام‌های مستعار می‌توانند تأثیری شگفت‌آور بر معناشناسی کد پایتونی داشته باشند، به‌ویژه هنگامی که با اشیاء تغییرپذیر مانند فهرستها، دیکشنری‌ها و بیشتر انواع دیگر سروکار داریم. این ویژگی معمولاً به سود برنامه تمام می‌شود، چون نام‌های مستعار از برخی جهات مانند اشاره‌گرها (pointer) رفتار می‌کنند. برای مثال، ارسال یک شیء به‌عنوان آرگومان ارزان است، چون پیاده‌سازی فقط یک اشاره‌گر را ارسال می‌کند؛ و اگر تابعی شیء‌ای را که به‌عنوان آرگومان دریافت کرده تغییر دهد، فراخوان‌نده تغییر را مشاهده خواهد کرد --- این کار نیاز به دو مکانیزم متفاوت برای ارسال آرگومان (مانند آنچه در پاسکال وجود دارد) را از بین می‌برد." +msgstr "اشیاء هویت فردی دارند و چندین نام (در چندین محدوده) می‌توانند به یک شیء مشخص متصل شوند. این در زبانهای دیگر با نام «اسم‌های مستعار» شناخته می‌شود. این ویژگی معمولاً در نگاه اول به پایتون چندان جلب توجه نمی‌کند و هنگام کار با انواع پایه‌ی تغییرناپذیر (اعداد، رشته‌ها، تاپل‌ها) می‌توان آن را نادیده گرفت. با این حال، نام‌های مستعار می‌توانند تأثیری شگفت‌آور بر معناشناسی کد پایتونی داشته باشند، به‌ویژه هنگامی که با اشیاء تغییرپذیر مانند فهرستها، دیکشنری‌ها و بیشتر انواع دیگر سروکار داریم. این ویژگی معمولاً به سود برنامه تمام می‌شود، چون نام‌های مستعار از برخی جهات مانند اشاره‌گرها (pointer) رفتار می‌کنند. برای مثال، ارسال یک شیء به‌عنوان آرگومان ارزان است، چون پیاده‌سازی فقط یک اشاره‌گر را ارسال می‌کند؛ و اگر تابعی شیء‌ای را که به‌عنوان آرگومان دریافت کرده تغییر دهد، فراخوان‌نده تغییر را مشاهده خواهد کرد --- این کار نیاز به دو مکانیزم متفاوت برای ارسال آرگومان (مانند آنچه در پاسکال وجود دارد) را از بین می‌برد." msgid "Python Scopes and Namespaces" msgstr "محدوده‌ها و فضای نام‌ها در پایتون" @@ -58,13 +58,13 @@ msgid "Let's begin with some definitions." msgstr "بیایید با چند تعریف شروع کنیم." msgid "A *namespace* is a mapping from names to objects. Most namespaces are currently implemented as Python dictionaries, but that's normally not noticeable in any way (except for performance), and it may change in the future. Examples of namespaces are: the set of built-in names (containing functions such as :func:`abs`, and built-in exception names); the global names in a module; and the local names in a function invocation. In a sense the set of attributes of an object also form a namespace. The important thing to know about namespaces is that there is absolutely no relation between names in different namespaces; for instance, two different modules may both define a function ``maximize`` without confusion --- users of the modules must prefix it with the module name." -msgstr "«فضای نام» *namespace* نگاشتی است از نام‌ها به اشیا. بیشتر فضای نام‌ها در حال حاضر به‌صورت دیکشنری‌های پایتون پیاده‌سازی شده‌اند، اما معمولاً این موضوع (به جز در بازدهی قابل مشاهده نیست و ممکن است در آینده تغییر کند. مثال‌هایی از فضای نام عبارت‌اند از: مجموعه نام‌های داخلی (که شامل توابعی مثل :func:`abs` و نام‌های استثنائات داخلی است)؛ نام‌های سراسری در یک ماژول؛ و نام‌های محلی در یک فراخوانی تابع. به نوعی، مجموعه صفات «attributes» یک شیء نیز یک فضای نام را تشکیل می‌دهد. نکته‌ی مهم درباره‌ی فضای نام‌ها این است که هیچ ارتباطی بین نام‌ها در فضای نام‌های مختلف وجود ندارد؛ برای مثال، دو ماژول مختلف می‌توانند هر دو تابعی با نام ``maximize`` تعریف کنند بدون اینکه ابهامی پیش بیاید — استفاده‌کنندگان از ماژول‌ها باید نام ماژول را به‌عنوان پیشوند بیاورند." +msgstr "«فضای نام» *namespace* نگاشتی است از نام‌ها به اشیا. بیشتر فضای نام‌ها در حال حاضر به‌صورت دیکشنری‌های پایتون پیاده‌سازی شده‌اند، اما معمولاً این موضوع (به جز در بازدهی قابل مشاهده نیست و ممکن است در آینده تغییر کند. مثالهایی از فضای نام عبارت‌اند از: مجموعه نام‌های داخلی (که شامل توابعی مثل :func:`abs` و نام‌های استثنائات داخلی است)؛ نام‌های سراسری در یک ماژول؛ و نام‌های محلی در یک فراخوانی تابع. به نوعی، مجموعه صفات «attributes» یک شیء نیز یک فضای نام را تشکیل می‌دهد. نکته‌ی مهم درباره‌ی فضای نام‌ها این است که هیچ ارتباطی بین نام‌ها در فضای نام‌های مختلف وجود ندارد؛ برای مثال، دو ماژول مختلف می‌توانند هر دو تابعی با نام ``maximize`` تعریف کنند بدون اینکه ابهامی پیش بیاید — استفاده‌کنندگان از ماژول‌ها باید نام ماژول را به‌عنوان پیشوند بیاورند." msgid "By the way, I use the word *attribute* for any name following a dot --- for example, in the expression ``z.real``, ``real`` is an attribute of the object ``z``. Strictly speaking, references to names in modules are attribute references: in the expression ``modname.funcname``, ``modname`` is a module object and ``funcname`` is an attribute of it. In this case there happens to be a straightforward mapping between the module's attributes and the global names defined in the module: they share the same namespace! [#]_" -msgstr "به‌هرحال، من واژه‌ی *ویژگی* «*attribute*» را برای هر نامی که بعد از یک نقطه بیاید به کار می‌برم — برای مثال، در عبارت ``z.real``, ``real`` یک ویژگی شیء ``z`` است. از نظر دقیق‌تر، ارجاع به نام‌ها در ماژول‌ها نیز نوعی ارجاع به ویژگی محسوب می‌شود: در عبارت ``modname.funcname``, ``modname`` یک شیء ماژول است و ``funcname`` یکی از ویژگی‌های آن است. در این حالت، نگاشتی ساده و مستقیم بین ویژگی‌های ماژول و نام‌های سراسری تعریف‌شده در آن وجود دارد: هر دو یک فضای نام (namespace) را به اشتراک می‌گذارند! [#]_" +msgstr "به‌هرحال، من واژه‌ی *ویژگی* «*attribute*» را برای هر نامی که بعد از یک نقطه بیاید به کار می‌برم — برای مثال، در عبارت ``z.real``, ``real`` یک ویژگی شیء ``z`` است. از نظر دقیق‌تر، ارجاع به نام‌ها در ماژول‌ها نیز نوعی ارجاع به ویژگی محسوب می‌شود: در عبارت ``modname.funcname``, ``modname`` یک شیء ماژول است و ``funcname`` یکی از ویژگیهای آن است. در این حالت، نگاشتی ساده و مستقیم بین ویژگیهای ماژول و نام‌های سراسری تعریف‌شده در آن وجود دارد: هر دو یک فضای نام (namespace) را به اشتراک می‌گذارند! [#]_" msgid "Attributes may be read-only or writable. In the latter case, assignment to attributes is possible. Module attributes are writable: you can write ``modname.the_answer = 42``. Writable attributes may also be deleted with the :keyword:`del` statement. For example, ``del modname.the_answer`` will remove the attribute :attr:`!the_answer` from the object named by ``modname``." -msgstr "ویژگی‌ها ممکن است فقط خواندنی یا قابل نوشتن باشند. در حالت دوم، اختصاص دادن به ویژگی‌ها ممکن است. ویژگی‌های ماژول قابل نوشتن هستند: می‌توانید ``modname.the_answer = 42`` را بنویسید. ویژگی‌های قابل نوشتن را می‌توان با دستور :keyword:`del` نیز حذف کرد. به‌عنوان مثال، ``del modname.the_answer`` ویژگی :attr:`!the_answer` را از شیئی که توسط ``modname`` نامگذاری شده است حذف خواهد کرد." +msgstr "ویژگیها ممکن است فقط خواندنی یا قابل نوشتن باشند. در حالت دوم، اختصاص دادن به ویژگیها ممکن است. ویژگیهای ماژول قابل نوشتن هستند: می‌توانید ``modname.the_answer = 42`` را بنویسید. ویژگیهای قابل نوشتن را می‌توان با دستور :keyword:`del` نیز حذف کرد. به‌عنوان مثال، ``del modname.the_answer`` ویژگی :attr:`!the_answer` را از شیئی که توسط ``modname`` نامگذاری شده است حذف خواهد کرد." msgid "Namespaces are created at different moments and have different lifetimes. The namespace containing the built-in names is created when the Python interpreter starts up, and is never deleted. The global namespace for a module is created when the module definition is read in; normally, module namespaces also last until the interpreter quits. The statements executed by the top-level invocation of the interpreter, either read from a script file or interactively, are considered part of a module called :mod:`__main__`, so they have their own global namespace. (The built-in names actually also live in a module; this is called :mod:`builtins`.)" msgstr "فضا‌های نام در لحظات مختلف ایجاد می‌شوند و دارای طول عمر‌های متفاوتی هستند. فضای نام که شامل نام‌های داخلی است، زمانی که مفسر پایتون شروع به کار می‌کند ایجاد می‌شود و هرگز حذف نمی‌شود. فضای نام عمومی برای یک ماژول زمانی که تعریف ماژول خوانده می‌شود ایجاد می‌گردد؛ به‌طور معمول، فضا‌های نام ماژول نیز تا زمانی که مفسر پایان یابد باقی می‌مانند. دستوراتی که توسط اجرای سطح بالای مفسر، یا از فایل اسکریپت خوانده شده یا به‌طور تعاملی اجرا می‌شوند، به‌عنوان بخشی از ماژولی به نام :mod:`__main__` در نظر گرفته می‌شوند، بنابراین آن‌ها فضای نام عمومی خود را دارند. (نام‌های درون‌ساخت نیز در واقع در یک ماژول قرار دارند؛ این ماژول :mod:`builtins` نامیده می‌شود.)" @@ -91,25 +91,25 @@ msgid "the outermost scope (searched last) is the namespace containing built-in msgstr "بیرونی‌ترین محدوده (که آخر از همه جست‌وجو می‌شود) فضای نامی است که شامل نام‌های توکار است" msgid "If a name is declared global, then all references and assignments go directly to the next-to-last scope containing the module's global names. To rebind variables found outside of the innermost scope, the :keyword:`nonlocal` statement can be used; if not declared nonlocal, those variables are read-only (an attempt to write to such a variable will simply create a *new* local variable in the innermost scope, leaving the identically named outer variable unchanged)." -msgstr "اگر یک نام به‌عنوان سراسری اعلام شود، تمام ارجاعها و تخصیص‌ها مستقیماً به محدوده‌ی یکی‌مانده‌به‌آخر که شامل نام‌های سراسری ماژول است، می‌روند. برای اتصال مجدد متغیر‌هایی که در خارج از درونی‌ترین محدوده یافت می‌شوند، می‌توان از دستور :keyword:`nonlocal` استفاده کرد؛ اگر به‌عنوان nonlocal اعلام نشوند، آن متغیر‌ها فقط‌خواندنی هستند (تلاش برای نوشتن در چنین متغیری، صرفاً یک متغیر محلی *جدید* در درونی‌ترین محدوده ایجاد می‌کند و متغیر بیرونی با همان نام را بدون تغییر باقی می‌گذارد)." +msgstr "اگر یک نام به‌عنوان سراسری اعلام شود، تمام ارجاعها و تخصیص‌ها مستقیماً به محدوده‌ی یکی‌مانده‌به‌آخر که شامل نام‌های سراسری ماژول است، می‌روند. برای اتصال مجدد متغیرهایی که در خارج از درونی‌ترین محدوده یافت می‌شوند، می‌توان از دستور :keyword:`nonlocal` استفاده کرد؛ اگر به‌عنوان nonlocal اعلام نشوند، آن متغیرها فقط‌خواندنی هستند (تلاش برای نوشتن در چنین متغیری، صرفاً یک متغیر محلی *جدید* در درونی‌ترین محدوده ایجاد می‌کند و متغیر بیرونی با همان نام را بدون تغییر باقی می‌گذارد)." msgid "Usually, the local scope references the local names of the (textually) current function. Outside functions, the local scope references the same namespace as the global scope: the module's namespace. Class definitions place yet another namespace in the local scope." msgstr "معمولاً، محدوده‌ی محلی به نام‌های محلی تابع جاری (از نظر متنی) ارجاع می‌دهد. در خارج از توابع، محدوده‌ی محلی به همان فضای نامی ارجاع می‌دهد که محدوده‌ی سراسری به آن ارجاع می‌دهد: فضای نام ماژول. تعاریف کلاس‌ها، فضای نام دیگری را در محدوده‌ی محلی قرار می‌دهند." msgid "It is important to realize that scopes are determined textually: the global scope of a function defined in a module is that module's namespace, no matter from where or by what alias the function is called. On the other hand, the actual search for names is done dynamically, at run time --- however, the language definition is evolving towards static name resolution, at \"compile\" time, so don't rely on dynamic name resolution! (In fact, local variables are already determined statically.)" -msgstr "درک این نکته مهم است که محدوده‌ها به‌صورت متنی (بر اساس جایگاه در کد) تعیین می‌شوند: محدوده‌ی سراسری تابعی که در یک ماژول تعریف شده است، همان فضای نام آن ماژول است، فرقی نمی‌کند که تابع از کجا یا با چه نام مستعاری فراخوانی شود. از سوی دیگر، جست‌وجوی واقعی برای نام‌ها به‌صورت پویا (داینامیک) و در زمان اجرا انجام می‌شود --- با این حال، تعریف زبان به سمت و سوی حلِ ایستا (استاتیک) نام‌ها در زمان «کامپایل» پیش می‌رود، پس به حلِ پویای نام‌ها اعتماد نکنید! (در واقع، متغیر‌های محلی از قبل به‌صورت ایستا تعیین می‌شوند.)" +msgstr "درک این نکته مهم است که محدوده‌ها به‌صورت متنی (بر اساس جایگاه در کد) تعیین می‌شوند: محدوده‌ی سراسری تابعی که در یک ماژول تعریف شده است، همان فضای نام آن ماژول است، فرقی نمی‌کند که تابع از کجا یا با چه نام مستعاری فراخوانی شود. از سوی دیگر، جست‌وجوی واقعی برای نام‌ها به‌صورت پویا (داینامیک) و در زمان اجرا انجام می‌شود --- با این حال، تعریف زبان به سمت و سوی حلِ ایستا (استاتیک) نام‌ها در زمان «کامپایل» پیش می‌رود، پس به حلِ پویای نام‌ها اعتماد نکنید! (در واقع، متغیرهای محلی از قبل به‌صورت ایستا تعیین می‌شوند.)" msgid "A special quirk of Python is that -- if no :keyword:`global` or :keyword:`nonlocal` statement is in effect -- assignments to names always go into the innermost scope. Assignments do not copy data --- they just bind names to objects. The same is true for deletions: the statement ``del x`` removes the binding of ``x`` from the namespace referenced by the local scope. In fact, all operations that introduce new names use the local scope: in particular, :keyword:`import` statements and function definitions bind the module or function name in the local scope." msgstr "یک ویژگی خاص پایتون این است که --- اگر دستور :keyword:`global` یا :keyword:`nonlocal` فعال نباشد --- تخصیص‌های (مقداردهی‌های) نام‌ها همیشه به درونی‌ترین محدوده (محلی‌ترین) می‌روند. تخصیص‌ها داده‌ها را کپی نمی‌کنند --- بلکه فقط نام‌ها را به اشیاء متصل می‌کنند. همین موضوع در مورد حذف‌ها نیز صادق است: دستور ``del x`` اتصال ``x`` را از فضای نامی که توسط محدوده‌ی محلی ارجاع داده شده است، حذف می‌کند. در واقع، تمام عملیاتی که نام‌های جدیدی معرفی می‌کنند از محدوده‌ی محلی استفاده می‌کنند: به‌ویژه، دستورات :keyword:`import` و تعاریف توابع، نام ماژول یا تابع را در محدوده‌ی محلی متصل می‌کنند." msgid "The :keyword:`global` statement can be used to indicate that particular variables live in the global scope and should be rebound there; the :keyword:`nonlocal` statement indicates that particular variables live in an enclosing scope and should be rebound there." -msgstr "از دستور :keyword:`global` می‌توان برای نشان دادن این استفاده کرد که متغیر‌های خاصی در محدوده‌ی سراسری قرار دارند و باید در همان محدوده دوباره متصل شوند؛ دستور :keyword:`nonlocal` نشان می‌دهد که متغیر‌های خاصی در یک محدوده‌ی محاط‌شونده قرار دارند و باید در آن محدوده دوباره متصل شوند." +msgstr "از دستور :keyword:`global` می‌توان برای نشان دادن این استفاده کرد که متغیرهای خاصی در محدوده‌ی سراسری قرار دارند و باید در همان محدوده دوباره متصل شوند؛ دستور :keyword:`nonlocal` نشان می‌دهد که متغیرهای خاصی در یک محدوده‌ی محاط‌شونده قرار دارند و باید در آن محدوده دوباره متصل شوند." msgid "Scopes and Namespaces Example" msgstr "مثال محدوده‌ها و فضای نام‌ها" msgid "This is an example demonstrating how to reference the different scopes and namespaces, and how :keyword:`global` and :keyword:`nonlocal` affect variable binding::" -msgstr "این مثالی است که نحوه‌ی ارجاع به محدوده‌ها و فضای نام‌های مختلف، و تأثیر دستورات :keyword:`global` و :keyword:`nonlocal` بر اتصال متغیر‌ها را نشان می‌دهد::" +msgstr "این مثالی است که نحوه‌ی ارجاع به محدوده‌ها و فضای نام‌های مختلف، و تأثیر دستورات :keyword:`global` و :keyword:`nonlocal` بر اتصال متغیرها را نشان می‌دهد::" msgid "" "def scope_test():\n" @@ -209,10 +209,10 @@ msgid "Class definitions, like function definitions (:keyword:`def` statements) msgstr "تعاریف کلاس‌ها، مانند تعاریف توابع (دستورات :keyword:`def`)، باید قبل از اینکه تأثیری داشته باشند، اجرا شوند. (به‌طور تئوری می‌توانید یک تعریف کلاس را در یک شاخه از دستور :keyword:`if` یا داخل یک تابع قرار دهید.)" msgid "In practice, the statements inside a class definition will usually be function definitions, but other statements are allowed, and sometimes useful --- we'll come back to this later. The function definitions inside a class normally have a peculiar form of argument list, dictated by the calling conventions for methods --- again, this is explained later." -msgstr "در عمل، دستورات داخل یک تعریف کلاس معمولاً تعاریف توابع هستند، اما دستورات دیگری نیز مجاز هستند و گاهی مفیدند --- بعداً به این موضوع بازخواهیم گشت. تعاریف توابع داخل یک کلاس معمولاً دارای شکل خاصی از فهرست آرگومان‌ها هستند که توسط قراردادهای فراخوانی برای متد‌ها تعیین می‌شود --- باز هم، این موضوع بعداً توضیح داده می‌شود." +msgstr "در عمل، دستورات داخل یک تعریف کلاس معمولاً تعاریف توابع هستند، اما دستورات دیگری نیز مجاز هستند و گاهی مفیدند --- بعداً به این موضوع بازخواهیم گشت. تعاریف توابع داخل یک کلاس معمولاً دارای شکل خاصی از فهرست آرگومان‌ها هستند که توسط قراردادهای فراخوانی برای متدها تعیین می‌شود --- باز هم، این موضوع بعداً توضیح داده می‌شود." msgid "When a class definition is entered, a new namespace is created, and used as the local scope --- thus, all assignments to local variables go into this new namespace. In particular, function definitions bind the name of the new function here." -msgstr "هنگامی که یک تعریف کلاس وارد می‌شود، یک فضای نام جدید ایجاد شده و به‌عنوان محدوده‌ی محلی استفاده می‌شود --- بنابراین، تمام تخصیص‌ها به متغیر‌های محلی به این فضای نام جدید می‌روند. به‌ویژه، تعاریف توابع، نام تابع جدید را در اینجا متصل می‌کنند." +msgstr "هنگامی که یک تعریف کلاس وارد می‌شود، یک فضای نام جدید ایجاد شده و به‌عنوان محدوده‌ی محلی استفاده می‌شود --- بنابراین، تمام تخصیص‌ها به متغیرهای محلی به این فضای نام جدید می‌روند. به‌ویژه، تعاریف توابع، نام تابع جدید را در اینجا متصل می‌کنند." msgid "When a class definition is left normally (via the end), a *class object* is created. This is basically a wrapper around the contents of the namespace created by the class definition; we'll learn more about class objects in the next section. The original local scope (the one in effect just before the class definition was entered) is reinstated, and the class object is bound here to the class name given in the class definition header (:class:`!ClassName` in the example)." msgstr "هنگامی که یک تعریف کلاس به‌طور عادی (با رسیدن به انتها) ترک می‌شود، یک *شیء کلاس* ایجاد می‌شود. این در اصل یک پوسته (wrapper) پیرامون محتویات فضای نامی است که توسط تعریف کلاس ایجاد شده است؛ در بخش بعدی بیشتر درباره‌ی اشیاء کلاس خواهیم آموخت. محدوده‌ی محلی اصلی (همان محدوده‌ای که درست قبل از ورود به تعریف کلاس فعال بود) بازیابی می‌شود، و شیء کلاس در اینجا به نام کلاسی که در سرآیند تعریف کلاس داده شده است، متصل می‌شود (:class:`!ClassName` در مثال)." @@ -221,10 +221,10 @@ msgid "Class Objects" msgstr "اشیاء کلاس" msgid "Class objects support two kinds of operations: attribute references and instantiation." -msgstr "اشیاء کلاس از دو نوع عملیات پشتیبانی می‌کنند: ارجاع به ویژگی‌ها و نمونه‌سازی." +msgstr "اشیاء کلاس از دو نوع عملیات پشتیبانی می‌کنند: ارجاع به ویژگیها و نمونه‌سازی." msgid "*Attribute references* use the standard syntax used for all attribute references in Python: ``obj.name``. Valid attribute names are all the names that were in the class's namespace when the class object was created. So, if the class definition looked like this::" -msgstr "*ارجاع به ویژگی‌ها* از همان دستور زبان استاندارد که برای همه‌ی ارجاعها به ویژگی‌ها در پایتون استفاده می‌شود، پیروی می‌کند: ``obj.name``. نام‌های ویژگی معتبر، همه‌ی نام‌هایی هستند که در هنگام ایجاد شیء کلاس، در فضای نام آن کلاس وجود داشته‌اند. بنابراین، اگر تعریف کلاس به این شکل بود::" +msgstr "*ارجاع به ویژگیها* از همان دستور زبان استاندارد که برای همه‌ی ارجاعها به ویژگیها در پایتون استفاده می‌شود، پیروی می‌کند: ``obj.name``. نام‌های ویژگی معتبر، همه‌ی نام‌هایی هستند که در هنگام ایجاد شیء کلاس، در فضای نام آن کلاس وجود داشته‌اند. بنابراین، اگر تعریف کلاس به این شکل بود::" msgid "" "class MyClass:\n" @@ -242,7 +242,7 @@ msgstr "" " return 'hello world'" msgid "then ``MyClass.i`` and ``MyClass.f`` are valid attribute references, returning an integer and a function object, respectively. Class attributes can also be assigned to, so you can change the value of ``MyClass.i`` by assignment. :attr:`~type.__doc__` is also a valid attribute, returning the docstring belonging to the class: ``\"A simple example class\"``." -msgstr "سپس ``MyClass.i`` و ``MyClass.f`` ارجاعهای ویژگی معتبری هستند که به‌ترتیب یک عدد صحیح و یک شیء تابع را برمی‌گردانند. به ویژگی‌های کلاس نیز می‌توان مقدار داد، بنابراین می‌توانید مقدار ``MyClass.i`` را با تخصیص (مقداردهی) تغییر دهید. :attr:`~type.__doc__` نیز یک ویژگی معتبر است که رشته‌ی مستند (docstring) متعلق به کلاس را برمی‌گرداند: ``\"A simple example class\"``." +msgstr "سپس ``MyClass.i`` و ``MyClass.f`` ارجاعهای ویژگی معتبری هستند که به‌ترتیب یک عدد صحیح و یک شیء تابع را برمی‌گردانند. به ویژگیهای کلاس نیز می‌توان مقدار داد، بنابراین می‌توانید مقدار ``MyClass.i`` را با تخصیص (مقداردهی) تغییر دهید. :attr:`~type.__doc__` نیز یک ویژگی معتبر است که رشته‌ی مستند (docstring) متعلق به کلاس را برمی‌گرداند: ``\"A simple example class\"``." msgid "Class *instantiation* uses function notation. Just pretend that the class object is a parameterless function that returns a new instance of the class. For example (assuming the above class)::" msgstr "*نمونه‌سازی* کلاس از نماد توابع استفاده می‌کند. فقط تصور کنید که شیء کلاس، یک تابع بدون پارامتر است که یک نمونه‌ی جدید از کلاس را برمی‌گرداند. برای مثال (با فرض کلاس بالا)::" @@ -292,10 +292,10 @@ msgid "Instance Objects" msgstr "اشیاء نمونه" msgid "Now what can we do with instance objects? The only operations understood by instance objects are attribute references. There are two kinds of valid attribute names: data attributes and methods." -msgstr "حالا با اشیاء نمونه چه کاری می‌توانیم انجام دهیم؟ تنها عملیاتی که اشیاء نمونه می‌فهمند، ارجاع به ویژگی‌ها (attribute references) است. دو نوع نام ویژگی معتبر وجود دارد: ویژگی‌های داده (data attributes) و متد‌ها (methods)." +msgstr "حالا با اشیاء نمونه چه کاری می‌توانیم انجام دهیم؟ تنها عملیاتی که اشیاء نمونه می‌فهمند، ارجاع به ویژگیها (attribute references) است. دو نوع نام ویژگی معتبر وجود دارد: ویژگیهای داده (data attributes) و متدها (methods)." msgid "*Data attributes* correspond to \"instance variables\" in Smalltalk, and to \"data members\" in C++. Data attributes need not be declared; like local variables, they spring into existence when they are first assigned to. For example, if ``x`` is the instance of :class:`!MyClass` created above, the following piece of code will print the value ``16``, without leaving a trace::" -msgstr "*ویژگی‌های داده* معادل «متغیر‌های نمونه» در زبان اسمالتاک و «عضوهای داده» در ++C هستند. ویژگی‌های داده نیازی به اعلام ندارند؛ مانند متغیر‌های محلی، هنگامی که برای اولین بار به آن‌ها مقدار داده می‌شود، به‌وجود می‌آیند. برای مثال، اگر ``x`` نمونه‌ای از :class:`!MyClass` باشد که در بالا ایجاد شده است، قطعه کد زیر مقدار ``16`` را چاپ می‌کند، بدون اینکه هیچ اثری از خود بر جای بگذارد::" +msgstr "*ویژگیهای داده* معادل «متغیرهای نمونه» در زبان اسمالتاک و «عضوهای داده» در ++C هستند. ویژگیهای داده نیازی به اعلام ندارند؛ مانند متغیرهای محلی، هنگامی که برای اولین بار به آنها مقدار داده می‌شود، به‌وجود می‌آیند. برای مثال، اگر ``x`` نمونه‌ای از :class:`!MyClass` باشد که در بالا ایجاد شده است، قطعه کد زیر مقدار ``16`` را چاپ می‌کند، بدون اینکه هیچ اثری از خود بر جای بگذارد::" msgid "" "x.counter = 1\n" @@ -314,7 +314,7 @@ msgid "The other kind of instance attribute reference is a *method*. A method is msgstr "نوع دیگر ارجاع به ویژگی نمونه، *متد* است. متد، تابعی است که «به» یک شیء تعلق دارد." msgid "Valid method names of an instance object depend on its class. By definition, all attributes of a class that are function objects define corresponding methods of its instances. So in our example, ``x.f`` is a valid method reference, since ``MyClass.f`` is a function, but ``x.i`` is not, since ``MyClass.i`` is not. But ``x.f`` is not the same thing as ``MyClass.f`` --- it is a *method object*, not a function object." -msgstr "نام‌های متد معتبر یک شیء نمونه به کلاس آن بستگی دارد. طبق تعریف، تمام ویژگی‌های یک کلاس که شیء تابع هستند، متد‌های متناظر با نمونه‌های آن را تعریف می‌کنند. بنابراین در مثال ما، ``x.f`` یک ارجاع متد معتبر است، زیرا ``MyClass.f`` یک تابع است، اما ``x.i`` معتبر نیست، زیرا ``MyClass.i`` تابع نیست. اما ``x.f`` با ``MyClass.f`` یکسان نیست --- بلکه یک *شیء متد* است، نه یک شیء تابع." +msgstr "نام‌های متد معتبر یک شیء نمونه به کلاس آن بستگی دارد. طبق تعریف، تمام ویژگیهای یک کلاس که شیء تابع هستند، متدهای متناظر با نمونه‌های آن را تعریف می‌کنند. بنابراین در مثال ما، ``x.f`` یک ارجاع متد معتبر است، زیرا ``MyClass.f`` یک تابع است، اما ``x.i`` معتبر نیست، زیرا ``MyClass.i`` تابع نیست. اما ``x.f`` با ``MyClass.f`` یکسان نیست --- بلکه یک *شیء متد* است، نه یک شیء تابع." msgid "Method Objects" msgstr "متد اشیاء" @@ -344,16 +344,16 @@ msgid "What exactly happens when a method is called? You may have noticed that msgstr "دقیقاً وقتی یک متد فراخوانی می‌شود، چه اتفاقی می‌افتد؟ احتمالاً متوجه شده‌اید که ``x.f()`` در بالا بدون هیچ آرگومانی فراخوانی شد، حتی اگر تعریف تابع :meth:`!f` یک آرگومان را مشخص کرده بود. چه بر سر آن آرگومان آمد؟ مسلماً پایتون وقتی یک تابع که به آرگومان نیاز دارد، بدون هیچ آرگومانی فراخوانی می‌شود، یک استثنا ایجاد می‌کند --- حتی اگر آن آرگومان واقعاً استفاده نشود..." msgid "Actually, you may have guessed the answer: the special thing about methods is that the instance object is passed as the first argument of the function. In our example, the call ``x.f()`` is exactly equivalent to ``MyClass.f(x)``. In general, calling a method with a list of *n* arguments is equivalent to calling the corresponding function with an argument list that is created by inserting the method's instance object before the first argument." -msgstr "در واقع، شاید پاسخ را حدس زده باشید: نکته‌ی ویژه در مورد متد‌ها این است که شیء نمونه به‌عنوان اولین آرگومان تابع ارسال می‌شود. در مثال ما، فراخوانی ``x.f()`` دقیقاً معادل ``MyClass.f(x)`` است. به طور کلی، فراخوانی یک متد با فهرستی از *n* آرگومان معادل فراخوانی تابع متناظر با فهرست آرگومانی است که با قرار دادن شیء نمونه‌ی متد قبل از اولین آرگومان ایجاد می‌شود." +msgstr "در واقع، شاید پاسخ را حدس زده باشید: نکته‌ی ویژه در مورد متدها این است که شیء نمونه به‌عنوان اولین آرگومان تابع ارسال می‌شود. در مثال ما، فراخوانی ``x.f()`` دقیقاً معادل ``MyClass.f(x)`` است. به طور کلی، فراخوانی یک متد با فهرستی از *n* آرگومان معادل فراخوانی تابع متناظر با فهرست آرگومانی است که با قرار دادن شیء نمونه‌ی متد قبل از اولین آرگومان ایجاد می‌شود." msgid "In general, methods work as follows. When a non-data attribute of an instance is referenced, the instance's class is searched. If the name denotes a valid class attribute that is a function object, references to both the instance object and the function object are packed into a method object. When the method object is called with an argument list, a new argument list is constructed from the instance object and the argument list, and the function object is called with this new argument list." -msgstr "به طور کلی، متد‌ها به صورت زیر کار می‌کنند. هنگامی که به یک ویژگی غیرداده‌ای از یک نمونه ارجاع داده می‌شود، کلاس آن نمونه جست‌وجو می‌شود. اگر آن نام نشان‌دهنده‌ی یک ویژگی کلاس معتبر باشد که یک شیء تابع است، ارجاعات به هر دو شیء نمونه و شیء تابع در یک شیء متد بسته‌بندی می‌شوند. هنگامی که شیء متد با یک فهرست آرگومان فراخوانی می‌شود، یک فهرست آرگومان جدید از شیء نمونه و فهرست آرگومان ساخته می‌شود و شیء تابع با این فهرست آرگومان جدید فراخوانی می‌شود." +msgstr "به طور کلی، متدها به صورت زیر کار می‌کنند. هنگامی که به یک ویژگی غیرداده‌ای از یک نمونه ارجاع داده می‌شود، کلاس آن نمونه جست‌وجو می‌شود. اگر آن نام نشان‌دهنده‌ی یک ویژگی کلاس معتبر باشد که یک شیء تابع است، ارجاعات به هر دو شیء نمونه و شیء تابع در یک شیء متد بسته‌بندی می‌شوند. هنگامی که شیء متد با یک فهرست آرگومان فراخوانی می‌شود، یک فهرست آرگومان جدید از شیء نمونه و فهرست آرگومان ساخته می‌شود و شیء تابع با این فهرست آرگومان جدید فراخوانی می‌شود." msgid "Class and Instance Variables" msgstr "کلاس و متغیر‌های نمونه" msgid "Generally speaking, instance variables are for data unique to each instance and class variables are for attributes and methods shared by all instances of the class::" -msgstr "به‌طور کلی، متغیر‌های نمونه برای داده‌هایی هستند که مختص به هر نمونه و متغیر‌های کلاس برای ویژگی‌ها و متد‌هایی هستند که بین همه‌ی نمونه‌ها از آن کلاس مشترک هستند::" +msgstr "به‌طور کلی، متغیرهای نمونه برای داده‌هایی هستند که مختص به هر نمونه و متغیرهای کلاس برای ویژگیها و متدهایی هستند که بین همه‌ی نمونه‌ها از آن کلاس مشترک هستند::" msgid "" "class Dog:\n" @@ -502,13 +502,13 @@ msgstr "" "storage east" msgid "Data attributes may be referenced by methods as well as by ordinary users (\"clients\") of an object. In other words, classes are not usable to implement pure abstract data types. In fact, nothing in Python makes it possible to enforce data hiding --- it is all based upon convention. (On the other hand, the Python implementation, written in C, can completely hide implementation details and control access to an object if necessary; this can be used by extensions to Python written in C.)" -msgstr "ویژگی‌های داده ممکن است هم توسط متد‌ها و هم توسط کاربران عادی (\"clients\") یک شیء ارجاع داده شوند. به عبارت دیگر، کلاس‌ها برای پیاده‌سازی انواع داده‌ی انتزاعی خالص قابل استفاده نیستند. در واقع، هیچ چیزی در پایتون امکان اعمال پنهان‌سازی داده را فراهم نمی‌کند --- همه‌چیز بر اساس قرارداد است. (از سوی دیگر، پیاده‌سازی پایتون که به زبان C نوشته شده است، می‌تواند جزئیات پیاده‌سازی را کاملاً پنهان کند و در صورت نیاز دسترسی به یک شیء را کنترل کند؛ این قابلیت می‌تواند توسط افزونه‌های پایتون که به زبان C نوشته می‌شوند، استفاده شود.)" +msgstr "ویژگیهای داده ممکن است هم توسط متدها و هم توسط کاربران عادی (\"clients\") یک شیء ارجاع داده شوند. به عبارت دیگر، کلاس‌ها برای پیاده‌سازی انواع داده‌ی انتزاعی خالص قابل استفاده نیستند. در واقع، هیچ چیزی در پایتون امکان اعمال پنهان‌سازی داده را فراهم نمی‌کند --- همه‌چیز بر اساس قرارداد است. (از سوی دیگر، پیاده‌سازی پایتون که به زبان C نوشته شده است، می‌تواند جزئیات پیاده‌سازی را کاملاً پنهان کند و در صورت نیاز دسترسی به یک شیء را کنترل کند؛ این قابلیت می‌تواند توسط افزونه‌های پایتون که به زبان C نوشته می‌شوند، استفاده شود.)" msgid "Clients should use data attributes with care --- clients may mess up invariants maintained by the methods by stamping on their data attributes. Note that clients may add data attributes of their own to an instance object without affecting the validity of the methods, as long as name conflicts are avoided --- again, a naming convention can save a lot of headaches here." -msgstr "کاربران (clients) باید با احتیاط از ویژگی‌های داده استفاده کنند --- کاربران ممکن است ناورداهای حفظ‌شده توسط متد‌ها را با دستکاری در ویژگی‌های داده‌شان به هم بریزند. توجه داشته باشید که کاربران ممکن است ویژگی‌های داده‌ی خود را به یک شیء نمونه اضافه کنند بدون اینکه بر صحت متد‌ها تأثیر بگذارند، تا زمانی که تداخل نام‌ها اجتناب شود --- باز هم، یک قرارداد نام‌گذاری می‌تواند از بسیاری از سردرگمی‌ها در اینجا جلوگیری کند." +msgstr "کاربران (clients) باید با احتیاط از ویژگیهای داده استفاده کنند --- کاربران ممکن است ناورداهای حفظ‌شده توسط متدها را با دستکاری در ویژگیهای داده‌شان به هم بریزند. توجه داشته باشید که کاربران ممکن است ویژگیهای داده‌ی خود را به یک شیء نمونه اضافه کنند بدون اینکه بر صحت متدها تأثیر بگذارند، تا زمانی که تداخل نام‌ها اجتناب شود --- باز هم، یک قرارداد نام‌گذاری می‌تواند از بسیاری از سردرگمی‌ها در اینجا جلوگیری کند." msgid "There is no shorthand for referencing data attributes (or other methods!) from within methods. I find that this actually increases the readability of methods: there is no chance of confusing local variables and instance variables when glancing through a method." -msgstr "هیچ گونه میان‌بری برای ارجاع به ویژگی‌های داده (یا سایر متد‌ها!) از درون متد‌ها وجود ندارد. به نظر من، این موضوع در واقع خوانایی متد‌ها را افزایش می‌دهد: هیچ شانسی برای اشتباه گرفتن متغیر‌های محلی و متغیر‌های نمونه هنگام مرور سریع یک متد وجود ندارد." +msgstr "هیچ گونه میان‌بری برای ارجاع به ویژگیهای داده (یا سایر متدها!) از درون متدها وجود ندارد. به نظر من، این موضوع در واقع خوانایی متدها را افزایش می‌دهد: هیچ شانسی برای اشتباه گرفتن متغیرهای محلی و متغیرهای نمونه هنگام مرور سریع یک متد وجود ندارد." msgid "Often, the first argument of a method is called ``self``. This is nothing more than a convention: the name ``self`` has absolutely no special meaning to Python. Note, however, that by not following the convention your code may be less readable to other Python programmers, and it is also conceivable that a *class browser* program might be written that relies upon such a convention." msgstr "معمولاً، اولین آرگومان یک متد ``self`` نامیده می‌شود. این چیزی بیش از یک قرارداد نیست: نام ``self`` هیچ معنی خاصی برای پایتون ندارد. با این حال، توجه داشته باشید که با رعایت نکردن این قرارداد، کد شما ممکن است برای سایر برنامه‌نویسان پایتون کمتر خوانا باشد، و همچنین قابل‌تصور است که یک برنامه *مرورگر کلاس* (class browser) نوشته شود که به چنین قراردادی وابسته باشد." @@ -542,10 +542,10 @@ msgstr "" " h = g" msgid "Now ``f``, ``g`` and ``h`` are all attributes of class :class:`!C` that refer to function objects, and consequently they are all methods of instances of :class:`!C` --- ``h`` being exactly equivalent to ``g``. Note that this practice usually only serves to confuse the reader of a program." -msgstr "اکنون ``f``، ``g`` و ``h`` همگی ویژگی‌های کلاس :class:`!C` هستند که به اشیاء تابع اشاره دارند، و در نتیجه همگی متد‌هایی از نمونه‌های :class:`!C` هستند --- ``h`` دقیقاً معادل ``g`` است. توجه داشته باشید که این روش معمولاً فقط باعث سردرگمی خواننده‌ی برنامه می‌شود." +msgstr "اکنون ``f``، ``g`` و ``h`` همگی ویژگیهای کلاس :class:`!C` هستند که به اشیاء تابع اشاره دارند، و در نتیجه همگی متدهایی از نمونه‌های :class:`!C` هستند --- ``h`` دقیقاً معادل ``g`` است. توجه داشته باشید که این روش معمولاً فقط باعث سردرگمی خواننده‌ی برنامه می‌شود." msgid "Methods may call other methods by using method attributes of the ``self`` argument::" -msgstr "متد‌ها می‌توانند سایر متد‌ها را با استفاده از ویژگی‌های متد آرگومان ``self`` فراخوانی کنند::" +msgstr "متدها می‌توانند سایر متدها را با استفاده از ویژگیهای متد آرگومان ``self`` فراخوانی کنند::" msgid "" "class Bag:\n" @@ -571,7 +571,7 @@ msgstr "" " self.add(x)" msgid "Methods may reference global names in the same way as ordinary functions. The global scope associated with a method is the module containing its definition. (A class is never used as a global scope.) While one rarely encounters a good reason for using global data in a method, there are many legitimate uses of the global scope: for one thing, functions and modules imported into the global scope can be used by methods, as well as functions and classes defined in it. Usually, the class containing the method is itself defined in this global scope, and in the next section we'll find some good reasons why a method would want to reference its own class." -msgstr "متد‌ها ممکن است به نام‌های سراسری به همان روشی که توابع معمولی اشاره می‌کنند، ارجاع دهند. محدوده‌ی سراسری مرتبط با یک متد، ماژولی است که شامل تعریف آن است. (یک کلاس هرگز به‌عنوان محدوده‌ی سراسری استفاده نمی‌شود.) اگرچه به ندرت دلیل خوبی برای استفاده از داده‌های سراسری در یک متد یافت می‌شود، اما کاربردهای مشروع زیادی برای محدوده‌ی سراسری وجود دارد: برای یک چیز، توابع و ماژول‌هایی که به محدوده‌ی سراسری ایمپورت شده‌اند، می‌توانند توسط متد‌ها استفاده شوند، همچنین توابع و کلاس‌های تعریف‌شده در آن. معمولاً، کلاسی که شامل متد است، خود در این محدوده‌ی سراسری تعریف می‌شود، و در بخش بعدی دلایل خوبی خواهیم یافت که چرا یک متد ممکن است بخواهد به کلاس خودش ارجاع دهد." +msgstr "متدها ممکن است به نام‌های سراسری به همان روشی که توابع معمولی اشاره می‌کنند، ارجاع دهند. محدوده‌ی سراسری مرتبط با یک متد، ماژولی است که شامل تعریف آن است. (یک کلاس هرگز به‌عنوان محدوده‌ی سراسری استفاده نمی‌شود.) اگرچه به ندرت دلیل خوبی برای استفاده از داده‌های سراسری در یک متد یافت می‌شود، اما کاربردهای مشروع زیادی برای محدوده‌ی سراسری وجود دارد: برای یک چیز، توابع و ماژول‌هایی که به محدوده‌ی سراسری ایمپورت شده‌اند، می‌توانند توسط متدها استفاده شوند، همچنین توابع و کلاس‌های تعریف‌شده در آن. معمولاً، کلاسی که شامل متد است، خود در این محدوده‌ی سراسری تعریف می‌شود، و در بخش بعدی دلایل خوبی خواهیم یافت که چرا یک متد ممکن است بخواهد به کلاس خودش ارجاع دهد." msgid "Each value is an object, and therefore has a *class* (also called its *type*). It is stored as ``object.__class__``." msgstr "هر مقدار یک شیء است، و بنابراین دارای یک *کلاس* (که به آن *تایپ* نیز گفته می‌شود) می‌باشد. این مقدار به‌صورت ``object.__class__`` ذخیره می‌شود." @@ -604,13 +604,13 @@ msgid "class DerivedClassName(modname.BaseClassName):" msgstr "class DerivedClassName(modname.BaseClassName):" msgid "Execution of a derived class definition proceeds the same as for a base class. When the class object is constructed, the base class is remembered. This is used for resolving attribute references: if a requested attribute is not found in the class, the search proceeds to look in the base class. This rule is applied recursively if the base class itself is derived from some other class." -msgstr "اجرای تعریف یک کلاس مشتق‌شده به همان شیوه‌ای است که برای یک کلاس پایه انجام می‌شود. هنگامی که شیء کلاس ساخته می‌شود، کلاس پایه به خاطر سپرده می‌شود. این (اطلاعات) برای حل کردن ارجاعات به ویژگی‌ها استفاده می‌شود: اگر ویژگی درخواستی در کلاس یافت نشود، جست‌وجو در کلاس پایه ادامه می‌یابد. این قاعده به‌صورت بازگشتی اعمال می‌شود اگر خود کلاس پایه از کلاس دیگری مشتق شده باشد." +msgstr "اجرای تعریف یک کلاس مشتق‌شده به همان شیوه‌ای است که برای یک کلاس پایه انجام می‌شود. هنگامی که شیء کلاس ساخته می‌شود، کلاس پایه به خاطر سپرده می‌شود. این (اطلاعات) برای حل کردن ارجاعات به ویژگیها استفاده می‌شود: اگر ویژگی درخواستی در کلاس یافت نشود، جست‌وجو در کلاس پایه ادامه می‌یابد. این قاعده به‌صورت بازگشتی اعمال می‌شود اگر خود کلاس پایه از کلاس دیگری مشتق شده باشد." msgid "There's nothing special about instantiation of derived classes: ``DerivedClassName()`` creates a new instance of the class. Method references are resolved as follows: the corresponding class attribute is searched, descending down the chain of base classes if necessary, and the method reference is valid if this yields a function object." msgstr "هیچ نکته‌ی خاصی درباره‌ی نمونه‌سازی کلاس‌های مشتق‌شده وجود ندارد: ``DerivedClassName()`` یک نمونه‌ی جدید از کلاس ایجاد می‌کند. ارجاعهای متد به‌صورت زیر حل می‌شوند: ویژگی کلاس متناظر جست‌وجو می‌شود، در صورت لزوم در زنجیره‌ی کلاس‌های پایه به پایین می‌رود، و ارجاع متد در صورتی معتبر است که این جست‌وجو به یک شیء تابع منجر شود." msgid "Derived classes may override methods of their base classes. Because methods have no special privileges when calling other methods of the same object, a method of a base class that calls another method defined in the same base class may end up calling a method of a derived class that overrides it. (For C++ programmers: all methods in Python are effectively ``virtual``.)" -msgstr "کلاس‌های مشتق‌شده ممکن است متد‌های کلاس‌های پایه‌ی خود را بازنویسی کنند. از آنجایی که متد‌ها هنگام فراخوانی سایر متد‌های همان شیء، امتیاز ویژه‌ای ندارند، یک متد از یک کلاس پایه که متد دیگری را که در همان کلاس پایه تعریف شده فراخوانی می‌کند، ممکن است در نهایت متدی از یک کلاس مشتق‌شده را فراخوانی کند که آن را بازنویسی کرده است. (برای برنامه‌نویسان C++: تمام متد‌ها در پایتون به‌طور مؤثر ``virtual`` هستند.)" +msgstr "کلاس‌های مشتق‌شده ممکن است متدهای کلاس‌های پایه‌ی خود را بازنویسی کنند. از آنجایی که متدها هنگام فراخوانی سایر متدهای همان شیء، امتیاز ویژه‌ای ندارند، یک متد از یک کلاس پایه که متد دیگری را که در همان کلاس پایه تعریف شده فراخوانی می‌کند، ممکن است در نهایت متدی از یک کلاس مشتق‌شده را فراخوانی کند که آن را بازنویسی کرده است. (برای برنامه‌نویسان C++: تمام متدها در پایتون به‌طور مؤثر ``virtual`` هستند.)" msgid "An overriding method in a derived class may in fact want to extend rather than simply replace the base class method of the same name. There is a simple way to call the base class method directly: just call ``BaseClassName.methodname(self, arguments)``. This is occasionally useful to clients as well. (Note that this only works if the base class is accessible as ``BaseClassName`` in the global scope.)" msgstr "یک متد بازنویسی‌شده در یک کلاس مشتق‌شده ممکن است در واقع بخواهد به جای اینکه صرفاً متد کلاس پایه را با همین نام جایگزین کند، آن را گسترش دهد. یک راه ساده برای فراخوانی مستقیم متد کلاس پایه وجود دارد: فقط ``BaseClassName.methodname(self, arguments)`` را فراخوانی کنید. این روش گاهی برای کاربران (clients) نیز مفید است. (توجه داشته باشید که این روش تنها زمانی کار می‌کند که کلاس پایه به‌عنوان ``BaseClassName`` در محدوده‌ی سراسری (global scope) قابل دسترسی باشد.)" @@ -646,19 +646,19 @@ msgstr "" " " msgid "For most purposes, in the simplest cases, you can think of the search for attributes inherited from a parent class as depth-first, left-to-right, not searching twice in the same class where there is an overlap in the hierarchy. Thus, if an attribute is not found in :class:`!DerivedClassName`, it is searched for in :class:`!Base1`, then (recursively) in the base classes of :class:`!Base1`, and if it was not found there, it was searched for in :class:`!Base2`, and so on." -msgstr "برای بیشتر کاربردها، در ساده‌ترین موارد، می‌توانید جست‌وجو برای ویژگی‌های به‌ارث‌برده‌شده از یک کلاس والد را به‌صورت عمق‌اول، چپ‌به‌راست، بدون جست‌وجوی دوباره در همان کلاس در جایی که همپوشانی در سلسله‌مراتب وجود دارد، در نظر بگیرید. بنابراین، اگر ویژگی‌ای در :class:`!DerivedClassName` یافت نشد، در :class:`!Base1` جست‌وجو می‌شود، سپس (به‌صورت بازگشتی) در کلاس‌های پایه‌ی :class:`!Base1`، و اگر در آنجا یافت نشد، در :class:`!Base2` جست‌وجو می‌شود، و به همین ترتیب." +msgstr "برای بیشتر کاربردها، در ساده‌ترین موارد، می‌توانید جست‌وجو برای ویژگیهای به‌ارث‌برده‌شده از یک کلاس والد را به‌صورت عمق‌اول، چپ‌به‌راست، بدون جست‌وجوی دوباره در همان کلاس در جایی که همپوشانی در سلسله‌مراتب وجود دارد، در نظر بگیرید. بنابراین، اگر ویژگی‌ای در :class:`!DerivedClassName` یافت نشد، در :class:`!Base1` جست‌وجو می‌شود، سپس (به‌صورت بازگشتی) در کلاس‌های پایه‌ی :class:`!Base1`، و اگر در آنجا یافت نشد، در :class:`!Base2` جست‌وجو می‌شود، و به همین ترتیب." msgid "In fact, it is slightly more complex than that; the method resolution order changes dynamically to support cooperative calls to :func:`super`. This approach is known in some other multiple-inheritance languages as call-next-method and is more powerful than the super call found in single-inheritance languages." -msgstr "در واقع، این موضوع کمی پیچیده‌تر از این است؛ ترتیب حل متد به‌صورت پویا تغییر می‌کند تا از فراخوانی‌های مشارکتی به :func:`super` پشتیبانی کند. این رویکرد در برخی دیگر از زبان‌های دارای ارث‌بری چندگانه با نام call-next-method شناخته می‌شود و از فراخوانی super موجود در زبان‌های دارای ارث‌بری تکی قدرتمندتر است." +msgstr "در واقع، این موضوع کمی پیچیده‌تر از این است؛ ترتیب حل متد به‌صورت پویا تغییر می‌کند تا از فراخوانی‌های مشارکتی به :func:`super` پشتیبانی کند. این رویکرد در برخی دیگر از زبانهای دارای ارث‌بری چندگانه با نام call-next-method شناخته می‌شود و از فراخوانی super موجود در زبانهای دارای ارث‌بری تکی قدرتمندتر است." msgid "Dynamic ordering is necessary because all cases of multiple inheritance exhibit one or more diamond relationships (where at least one of the parent classes can be accessed through multiple paths from the bottommost class). For example, all classes inherit from :class:`object`, so any case of multiple inheritance provides more than one path to reach :class:`object`. To keep the base classes from being accessed more than once, the dynamic algorithm linearizes the search order in a way that preserves the left-to-right ordering specified in each class, that calls each parent only once, and that is monotonic (meaning that a class can be subclassed without affecting the precedence order of its parents). Taken together, these properties make it possible to design reliable and extensible classes with multiple inheritance. For more detail, see :ref:`python_2.3_mro`." -msgstr "ترتیب‌دهی پویا ضروری است زیرا همه‌ی موارد ارث‌بری چندگانه دارای یک یا چند رابطه‌ی الماسی هستند (جایی که حداقل یکی از کلاس‌های والد از طریق چندین مسیر از پایین‌ترین کلاس قابل دسترسی است). برای مثال، همه‌ی کلاس‌ها از :class:`object` ارث‌بری می‌کنند، بنابراین هر موردی از ارث‌بری چندگانه بیش از یک مسیر برای رسیدن به :class:`object` فراهم می‌کند. برای جلوگیری از دسترسی بیش از یک بار به کلاس‌های پایه، الگوریتم پویا ترتیب جست‌وجو را به‌گونه‌ای خطی‌سازی می‌کند که ترتیب چپ‌به‌راست مشخص‌شده در هر کلاس را حفظ کند، که هر والد را فقط یک بار فراخوانی می‌کند، و یکنواخت است (به این معنی که یک کلاس می‌تواند زیرکلاس‌ داشته باشد بدون اینکه بر ترتیب اولویت والدین آن تأثیر بگذارد). این ویژگی‌ها در کنار هم، طراحی کلاس‌های قابل اعتماد و قابل توسعه با ارث‌بری چندگانه را ممکن می‌سازند. برای جزئیات بیشتر، به :ref:`python_2.3_mro` مراجعه کنید." +msgstr "ترتیب‌دهی پویا ضروری است زیرا همه‌ی موارد ارث‌بری چندگانه دارای یک یا چند رابطه‌ی الماسی هستند (جایی که حداقل یکی از کلاس‌های والد از طریق چندین مسیر از پایین‌ترین کلاس قابل دسترسی است). برای مثال، همه‌ی کلاس‌ها از :class:`object` ارث‌بری می‌کنند، بنابراین هر موردی از ارث‌بری چندگانه بیش از یک مسیر برای رسیدن به :class:`object` فراهم می‌کند. برای جلوگیری از دسترسی بیش از یک بار به کلاس‌های پایه، الگوریتم پویا ترتیب جست‌وجو را به‌گونه‌ای خطی‌سازی می‌کند که ترتیب چپ‌به‌راست مشخص‌شده در هر کلاس را حفظ کند، که هر والد را فقط یک بار فراخوانی می‌کند، و یکنواخت است (به این معنی که یک کلاس می‌تواند زیرکلاس‌ داشته باشد بدون اینکه بر ترتیب اولویت والدین آن تأثیر بگذارد). این ویژگیها در کنار هم، طراحی کلاس‌های قابل اعتماد و قابل توسعه با ارث‌بری چندگانه را ممکن می‌سازند. برای جزئیات بیشتر، به :ref:`python_2.3_mro` مراجعه کنید." msgid "Private Variables" msgstr "متغیر‌های خصوصی" msgid "\"Private\" instance variables that cannot be accessed except from inside an object don't exist in Python. However, there is a convention that is followed by most Python code: a name prefixed with an underscore (e.g. ``_spam``) should be treated as a non-public part of the API (whether it is a function, a method or a data member). It should be considered an implementation detail and subject to change without notice." -msgstr "متغیر‌های نمونه‌ای «خصوصی» که جز از درون یک شیء قابل دسترسی نیستند، در پایتون وجود ندارند. با این حال، یک قرارداد وجود دارد که توسط بیشتر کدهای پایتون دنبال می‌شود: یک نام که با زیرخط آغاز می‌شود (مثلاً ``_spam``) باید به‌عنوان بخشی غیرعمومی از API در نظر گرفته شود (خواه یک تابع، یک متد یا یک عضو داده باشد). باید به‌عنوان یک جزئیات پیاده‌سازی در نظر گرفته شود و ممکن است بدون اطلاع‌رسانی تغییر کند." +msgstr "متغیرهای نمونه‌ای «خصوصی» که جز از درون یک شیء قابل دسترسی نیستند، در پایتون وجود ندارند. با این حال، یک قرارداد وجود دارد که توسط بیشتر کدهای پایتون دنبال می‌شود: یک نام که با زیرخط آغاز می‌شود (مثلاً ``_spam``) باید به‌عنوان بخشی غیرعمومی از API در نظر گرفته شود (خواه یک تابع، یک متد یا یک عضو داده باشد). باید به‌عنوان یک جزئیات پیاده‌سازی در نظر گرفته شود و ممکن است بدون اطلاع‌رسانی تغییر کند." msgid "Since there is a valid use-case for class-private members (namely to avoid name clashes of names with names defined by subclasses), there is limited support for such a mechanism, called :dfn:`name mangling`. Any identifier of the form ``__spam`` (at least two leading underscores, at most one trailing underscore) is textually replaced with ``_classname__spam``, where ``classname`` is the current class name with leading underscore(s) stripped. This mangling is done without regard to the syntactic position of the identifier, as long as it occurs within the definition of a class." msgstr "از آنجا که یک مورد استفاده‌ی معتبر برای اعضای خصوصی کلاس وجود دارد (به‌ویژه برای جلوگیری از برخورد نام‌ها با نام‌های تعریف‌شده توسط زیرکلاس‌ها)، پشتیبانی محدودی برای چنین مکانیزمی، به نام :dfn:`name mangling` (دستکاری نام) وجود دارد. هر شناسه‌ای به شکل ``__spam`` (حداقل دو زیرخط در ابتدا، حداکثر یک زیرخط در انتها) به‌صورت متنی با ``_classname__spam`` جایگزین می‌شود، که در آن ``classname`` نام کلاس جاری است با زیرخط‌های ابتدایی حذف‌شده. این دستکاری بدون در نظر گرفتن جایگاه نحوی شناسه انجام می‌شود، تا زمانی که درون تعریف یک کلاس رخ دهد." @@ -667,7 +667,7 @@ msgid "The :ref:`private name mangling specifications ` f msgstr "برای جزئیات و موارد خاص، به :ref:`مشخصات دستکاری نام‌های خصوصی ` مراجعه کنید." msgid "Name mangling is helpful for letting subclasses override methods without breaking intraclass method calls. For example::" -msgstr "دستکاری نام برای این مفید است که به زیرکلاس‌ها اجازه دهد متد‌ها را بدون شکستن فراخوانی‌های متد درون‌کلاسی بازنویسی کنند. برای مثال::" +msgstr "دستکاری نام برای این مفید است که به زیرکلاس‌ها اجازه دهد متدها را بدون شکستن فراخوانی‌های متد درون‌کلاسی بازنویسی کنند. برای مثال::" msgid "" "class Mapping:\n" @@ -754,13 +754,13 @@ msgstr "" "1000" msgid "A piece of Python code that expects a particular abstract data type can often be passed a class that emulates the methods of that data type instead. For instance, if you have a function that formats some data from a file object, you can define a class with methods :meth:`~io.TextIOBase.read` and :meth:`~io.TextIOBase.readline` that get the data from a string buffer instead, and pass it as an argument." -msgstr "یک قطعه کد پایتون که انتظار یک نوع دادهٔ انتزاعی خاص را دارد، اغلب می‌تواند به جای آن، یک کلاس دریافت کند که متد‌های آن نوع داده را شبیه‌سازی می‌کند. برای مثال، اگر تابعی دارید که داده‌هایی را از یک شیء فایل قالب‌بندی می‌کند، می‌توانید کلاسی تعریف کنید با متد‌های :meth:`~io.TextIOBase.read` و :meth:`~io.TextIOBase.readline` که داده‌ها را از یک بافر رشته‌ای دریافت می‌کنند، و آن را به‌عنوان آرگومان به تابع ارسال کنید." +msgstr "یک قطعه کد پایتون که انتظار یک نوع دادهٔ انتزاعی خاص را دارد، اغلب می‌تواند به جای آن، یک کلاس دریافت کند که متدهای آن نوع داده را شبیه‌سازی می‌کند. برای مثال، اگر تابعی دارید که داده‌هایی را از یک شیء فایل قالب‌بندی می‌کند، می‌توانید کلاسی تعریف کنید با متدهای :meth:`~io.TextIOBase.read` و :meth:`~io.TextIOBase.readline` که داده‌ها را از یک بافر رشته‌ای دریافت می‌کنند، و آن را به‌عنوان آرگومان به تابع ارسال کنید." msgid ":ref:`Instance method objects ` have attributes, too: :attr:`m.__self__ ` is the instance object with the method :meth:`!m`, and :attr:`m.__func__ ` is the :ref:`function object ` corresponding to the method." -msgstr ":ref:`اشیاء متد نمونه ` نیز ویژگی‌هایی دارند: :attr:`m.__self__ ` شیء نمونه‌ای است که متد :meth:`!m` به آن تعلق دارد، و :attr:`m.__func__ ` همان :ref:`شیء تابع ` متناظر با آن متد است." +msgstr ":ref:`اشیاء متد نمونه ` نیز ویژگیهایی دارند: :attr:`m.__self__ ` شیء نمونه‌ای است که متد :meth:`!m` به آن تعلق دارد، و :attr:`m.__func__ ` همان :ref:`شیء تابع ` متناظر با آن متد است." msgid "Iterators" -msgstr "تکرارگر‌ها" +msgstr "تکرارگرها" msgid "By now you have probably noticed that most container objects can be looped over using a :keyword:`for` statement::" msgstr "تا اینجا احتمالاً متوجه شده‌اید که می‌توان روی بیشتر اشیاء ظرف با استفاده از دستور :keyword:`for` حلقه زد::" @@ -789,7 +789,7 @@ msgstr "" " print(line, end='')" msgid "This style of access is clear, concise, and convenient. The use of iterators pervades and unifies Python. Behind the scenes, the :keyword:`for` statement calls :func:`iter` on the container object. The function returns an iterator object that defines the method :meth:`~iterator.__next__` which accesses elements in the container one at a time. When there are no more elements, :meth:`~iterator.__next__` raises a :exc:`StopIteration` exception which tells the :keyword:`!for` loop to terminate. You can call the :meth:`~iterator.__next__` method using the :func:`next` built-in function; this example shows how it all works::" -msgstr "این سبک دسترسی واضح، مختصر و راحت است. استفاده از تکرارگر‌ها در همه‌جا نفوذ کرده و پایتون را یکپارچه می‌کنند. در پشت صحنه، دستور :keyword:`for` تابع :func:`iter` را روی شیء ظرف فراخوانی می‌کند. این تابع یک شیء تکرارگر برمی‌گرداند که متد :meth:`~iterator.__next__` را تعریف می‌کند که به المان‌ها در ظرف یکی یکی دسترسی پیدا می‌کند. وقتی المان‌ها تمام شوند، :meth:`~iterator.__next__` یک استثنای :exc:`StopIteration` ایجاد می‌کند که به حلقه‌ی :keyword:`!for` می‌گوید پایان یابد. می‌توانید متد :meth:`~iterator.__next__` را با استفاده از تابع داخلی :func:`next` فراخوانی کنید؛ این مثال نشان می‌دهد که چگونه همه‌چیز کار می‌کند::" +msgstr "این سبک دسترسی واضح، مختصر و راحت است. استفاده از تکرارگرها در همه‌جا نفوذ کرده و پایتون را یکپارچه می‌کنند. در پشت صحنه، دستور :keyword:`for` تابع :func:`iter` را روی شیء ظرف فراخوانی می‌کند. این تابع یک شیء تکرارگر برمی‌گرداند که متد :meth:`~iterator.__next__` را تعریف می‌کند که به المان‌ها در ظرف یکی یکی دسترسی پیدا می‌کند. وقتی المان‌ها تمام شوند، :meth:`~iterator.__next__` یک استثنای :exc:`StopIteration` ایجاد می‌کند که به حلقه‌ی :keyword:`!for` می‌گوید پایان یابد. می‌توانید متد :meth:`~iterator.__next__` را با استفاده از تابع داخلی :func:`next` فراخوانی کنید؛ این مثال نشان می‌دهد که چگونه همه‌چیز کار می‌کند::" msgid "" ">>> s = 'abc'\n" @@ -914,13 +914,13 @@ msgstr "" "g" msgid "Anything that can be done with generators can also be done with class-based iterators as described in the previous section. What makes generators so compact is that the :meth:`~iterator.__iter__` and :meth:`~generator.__next__` methods are created automatically." -msgstr "هر چیزی که با تولیدگر‌ها قابل انجام است، می‌تواند با استفاده از تکرارگر‌های مبتنی بر کلاس نیز انجام شود، همانطور که در بخش قبلی توضیح داده شد. آنچه تولیدگر‌ها را فشرده می‌کند، این است که روش‌های :meth:`~iterator.__iter__` و :meth:`~generator.__next__` به‌طور خودکار ایجاد می‌شوند." +msgstr "هر چیزی که با تولیدگرها قابل انجام است، می‌تواند با استفاده از تکرارگرهای مبتنی بر کلاس نیز انجام شود، همانطور که در بخش قبلی توضیح داده شد. آنچه تولیدگر‌ها را فشرده می‌کند، این است که روش‌های :meth:`~iterator.__iter__` و :meth:`~generator.__next__` به‌طور خودکار ایجاد می‌شوند." msgid "Another key feature is that the local variables and execution state are automatically saved between calls. This made the function easier to write and much more clear than an approach using instance variables like ``self.index`` and ``self.data``." msgstr "یکی دیگر از ویژگی‌های کلیدواژه‌ای این است که متغیر‌های محلی و وضعیت اجرا به‌طور خودکار بین فراخوانی‌ها ذخیره می‌شوند. این امر نوشتن تابع را آسان‌تر و خیلی واضح‌تر از رویکردی که از متغیر‌های نمونه‌ای مانند ``self.index`` و ``self.data`` استفاده می‌کند، کرده است." msgid "In addition to automatic method creation and saving program state, when generators terminate, they automatically raise :exc:`StopIteration`. In combination, these features make it easy to create iterators with no more effort than writing a regular function." -msgstr "علاوه بر ایجاد خودکار متد‌ها و ذخیره سازی وضعیت برنامه، زمانی که تولیدگر‌ها خاتمه می‌یابند، به‌طور خودکار :exc:`StopIteration` را ایجاد می‌کنند. این ویژگی‌ها به صورت ترکیبی، ساختن تکرارگر‌ها را به همان سادگی نوشتن یک تابع عادی امکان پذیر می‌سازند." +msgstr "علاوه بر ایجاد خودکار متد‌ها و ذخیره سازی وضعیت برنامه، زمانی که تولیدگر‌ها خاتمه می‌یابند، به‌طور خودکار :exc:`StopIteration` را ایجاد می‌کنند. این ویژگیها به صورت ترکیبی، ساختن تکرارگرها را به همان سادگی نوشتن یک تابع عادی امکان پذیر می‌سازند." msgid "Generator Expressions" msgstr "عبارات تولیدگر" @@ -929,7 +929,7 @@ msgid "Some simple generators can be coded succinctly as expressions using a syn msgstr "برخی از تولیدگر‌های ساده را می‌توان به‌صورت مختصر به‌عنوان عبارت کدنویسی کرد، با استفاده از یک نحو مشابه درک‌فهرستها اما با پرانتز به جای کروشه‌ی باز. این عبارت‌ها برای شرایطی طراحی شده‌اند که تولیدگر بلافاصله توسط یک تابع محاط‌شونده استفاده می‌شود. عبارت‌های تولیدگر فشرده‌تر هستند اما نسبت به تعاریف کامل تولیدگر، انعطاف‌پذیری کمتری دارند و معمولاً نسبت به درک‌فهرستهای معادل، با حافظه سازگارتر هستند." msgid "Examples::" -msgstr "مثال‌ها::" +msgstr "مثالها::" msgid "" ">>> sum(i*i for i in range(10)) # sum of squares\n" From cde8912403f7ed0419166bbb81132d5a70ba5e65 Mon Sep 17 00:00:00 2001 From: invincible627 Date: Sat, 22 Aug 2026 20:21:17 +0330 Subject: [PATCH 04/11] translating part of library/__main__.po msgid "Note that if the module didn't encapsulate code inside the ``main`` function but instead put it directly within the ``if __name__ == '__main__'`` block, the ``phrase`` variable would be global to the entire module. This is error-prone as other functions within the module could be unintentionally using the global variable instead of a local name. A ``main`` function solves this problem." --- GLOSSARY.md | 1 + library/__main__.po | 36 +++++++++++++++++++++++++++++------- 2 files changed, 30 insertions(+), 7 deletions(-) diff --git a/GLOSSARY.md b/GLOSSARY.md index 205d23469..d63e57b54 100644 --- a/GLOSSARY.md +++ b/GLOSSARY.md @@ -65,6 +65,7 @@ | parameter | پارامتر | | positional | جایگاهی | | property | ویژگی، پراپرتی، خصوصیت | +| pass | پاس دادن | | quotation | علامت نقل‌وقول | | raise | پرتاب | | return | بازگشت، برگرداندن | diff --git a/library/__main__.po b/library/__main__.po index 07a82b795..20e4ea0f6 100644 --- a/library/__main__.po +++ b/library/__main__.po @@ -146,28 +146,31 @@ msgid "In each of these situations, the top-level module's ``__name__`` is set t msgstr "در هر کدام از این موقعیت‌ها، ``__name__`` ماژول سطح‌بالا به ``'__main__'`` تنظیم می‌شود." msgid "As a result, a module can discover whether or not it is running in the top-level environment by checking its own ``__name__``, which allows a common idiom for conditionally executing code when the module is not initialized from an import statement::" -msgstr "" +msgstr "در نتیجه، یک ماژول می‌تواند با بررسی ``__name__`` خود متوجه شود که آیا در محیط سطح‌بالا اجرا می‌شود یا نه، که این امکان یک الگوی رایج برای اجرای شرطی کد را فراهم می‌کند زمانی که ماژول از یک دستور ایمپورت مقداردهی اولیه نشده است::" msgid "" "if __name__ == '__main__':\n" " # Execute when the module is not initialized from an import statement.\n" " ..." msgstr "" +"if __name__ == '__main__':\n" +" # وقتی ماژول با دستور ایمپورت راه‌اندازی نشده باشد اجرا می‌شود.\n" +" ..." msgid "For a more detailed look at how ``__name__`` is set in all situations, see the tutorial section :ref:`tut-modules`." -msgstr "" +msgstr "برای نگاهی دقیق‌تر به نحوه‌ی تنظیم ``__name__`` در همه‌ی موقعیت‌ها، به بخش آموزش :ref:`tut-modules` مراجعه کنید." msgid "Idiomatic Usage" -msgstr "" +msgstr "استفاده‌ی اصطلاحی" msgid "Some modules contain code that is intended for script use only, like parsing command-line arguments or fetching data from standard input. If a module like this was imported from a different module, for example to unit test it, the script code would unintentionally execute as well." -msgstr "" +msgstr "بعضی ماژول‌ها دارای کدی هستند که فقط برای استفاده‌ی اسکریپتی در نظر گرفته شده است، مانند تجزیه‌ی آرگومان‌های خط فرمان یا دریافت داده از ورودی استاندارد. اگر چنین ماژولی از ماژول دیگری ایمپورت شود، مثلاً برای یونیت‌تست آن، کد اسکریپتی نیز به‌طور ناخواسته اجرا خواهد شد." msgid "This is where using the ``if __name__ == '__main__'`` code block comes in handy. Code within this block won't run unless the module is executed in the top-level environment." -msgstr "" +msgstr "اینجاست که استفاده از بلوک کد ``if __name__ == '__main__'`` به کار می‌آید. کد داخل این بلوک اجرا نمی‌شود مگر اینکه ماژول در محیط سطح‌بالا اجرا شود." msgid "Putting as few statements as possible in the block below ``if __name__ == '__main__'`` can improve code clarity and correctness. Most often, a function named ``main`` encapsulates the program's primary behavior::" -msgstr "" +msgstr "قرار دادن کمترین تعداد دستور ممکن در بلوک زیر ``if __name__ == '__main__'`` می‌تواند وضوح و صحت کد را بهبود بخشد. اغلب، یک تابع به نام ``main`` رفتار اصلی برنامه را در خود محصور می‌کند::" msgid "" "# echo.py\n" @@ -190,9 +193,28 @@ msgid "" "if __name__ == '__main__':\n" " sys.exit(main()) # next section explains the use of sys.exit" msgstr "" +"# echo.py\n" +"\n" +"import shlex\n" +"import sys\n" +"\n" +"def echo(phrase: str) -> None:\n" +" \"\"\"یک پوشش ساختگی برای print.\"\"\"\n" +" # برای اهداف نمایشی، می‌توانید تصور کنید که منطق ارزشمندی\n" +" # و قابل استفاده‌ی مجددی درون این تابع وجود دارد\n" +" print(phrase)\n" +"\n" +"def main() -> int:\n" +" \"\"\"آرگومان‌های ورودی را به خروجی استاندارد بازتاب می‌دهد\"\"\"\n" +" phrase = shlex.join(sys.argv)\n" +" echo(phrase)\n" +" return 0\n" +"\n" +"if __name__ == '__main__':\n" +" sys.exit(main()) # بخش بعدی استفاده از sys.exit را توضیح می‌دهد" msgid "Note that if the module didn't encapsulate code inside the ``main`` function but instead put it directly within the ``if __name__ == '__main__'`` block, the ``phrase`` variable would be global to the entire module. This is error-prone as other functions within the module could be unintentionally using the global variable instead of a local name. A ``main`` function solves this problem." -msgstr "" +msgstr "توجه داشته باشید که اگر ماژول کد را درون تابع ``main`` محصور نمی‌کرد و به جای آن مستقیماً آن را درون بلوک ``if __name__ == '__main__'`` قرار می‌داد، متغیر ``phrase`` برای کل ماژول سراسری می‌شد. این امر مستعد خطا است، زیرا ممکن است سایر توابع درون ماژول به‌طور ناخواسته از متغیر سراسری به جای یک نام محلی استفاده کنند. تابع ``main`` این مشکل را حل می‌کند." msgid "Using a ``main`` function has the added benefit of the ``echo`` function itself being isolated and importable elsewhere. When ``echo.py`` is imported, the ``echo`` and ``main`` functions will be defined, but neither of them will be called, because ``__name__ != '__main__'``." msgstr "" From 8994a375023ae2f0cd2747539bb8b5f07800acb9 Mon Sep 17 00:00:00 2001 From: invincible627 Date: Sun, 23 Aug 2026 18:21:31 +0330 Subject: [PATCH 05/11] transation part of library/__main__.po msgid "By proactively following this convention ourselves, our module will have the same behavior when run directly (i.e. ``python echo.py``) as it will have if we later package it as a console script entry-point in a pip-installable package." --- library/__main__.po | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/library/__main__.po b/library/__main__.po index 20e4ea0f6..234a0186d 100644 --- a/library/__main__.po +++ b/library/__main__.po @@ -217,22 +217,22 @@ msgid "Note that if the module didn't encapsulate code inside the ``main`` funct msgstr "توجه داشته باشید که اگر ماژول کد را درون تابع ``main`` محصور نمی‌کرد و به جای آن مستقیماً آن را درون بلوک ``if __name__ == '__main__'`` قرار می‌داد، متغیر ``phrase`` برای کل ماژول سراسری می‌شد. این امر مستعد خطا است، زیرا ممکن است سایر توابع درون ماژول به‌طور ناخواسته از متغیر سراسری به جای یک نام محلی استفاده کنند. تابع ``main`` این مشکل را حل می‌کند." msgid "Using a ``main`` function has the added benefit of the ``echo`` function itself being isolated and importable elsewhere. When ``echo.py`` is imported, the ``echo`` and ``main`` functions will be defined, but neither of them will be called, because ``__name__ != '__main__'``." -msgstr "" +msgstr "استفاده از تابع ``main`` این مزیت اضافی را دارد که خود تابع ``echo`` ایزوله و قابل ایمپورت در جای دیگر است. وقتی ``echo.py`` ایمپورت می‌شود، توابع ``echo`` و ``main`` تعریف می‌شوند، اما هیچ‌کدام از آن‌ها فراخوانی نمی‌شوند، زیرا ``__name__ != '__main__'`` است." msgid "Packaging Considerations" -msgstr "" +msgstr "ملاحظات بسته‌بندی" msgid "``main`` functions are often used to create command-line tools by specifying them as entry points for console scripts. When this is done, `pip `_ inserts the function call into a template script, where the return value of ``main`` is passed into :func:`sys.exit`. For example::" -msgstr "" +msgstr "توابع ``main`` اغلب برای ساختن ابزارهای خط فرمان با مشخص کردن آن‌ها به‌عنوان نقاط ورودی برای اسکریپت‌های کنسولی استفاده می‌شوند. وقتی این کار انجام می‌شود، `pip `_ فراخوانی تابع را در یک اسکریپت الگو قرار می‌دهد، جایی که مقدار بازگشتی ``main`` به :func:`sys.exit` پاس داده می‌شود. برای مثال::" msgid "sys.exit(main())" -msgstr "" +msgstr "sys.exit(main())" msgid "Since the call to ``main`` is wrapped in :func:`sys.exit`, the expectation is that your function will return some value acceptable as an input to :func:`sys.exit`; typically, an integer or ``None`` (which is implicitly returned if your function does not have a return statement)." -msgstr "" +msgstr "از آنجایی که فراخوانی ``main`` در :func:`sys.exit` پیچیده شده است، انتظار می‌رود که تابع شما مقداری را برگرداند که به‌عنوان ورودی برای :func:`sys.exit` قابل‌قبول باشد؛ معمولاً یک عدد صحیح یا ``None`` (که اگر تابع شما دستور return نداشته باشد، به‌صورت ضمنی برگردانده می‌شود)." msgid "By proactively following this convention ourselves, our module will have the same behavior when run directly (i.e. ``python echo.py``) as it will have if we later package it as a console script entry-point in a pip-installable package." -msgstr "" +msgstr "با پیروی فعالانه‌ی خودمان از این قرارداد، ماژول ما هنگام اجرای مستقیم (یعنی ``python echo.py``) همان رفتاری را خواهد داشت که در صورت بسته‌بندی بعدی آن به‌عنوان یک نقطه‌ی ورودی اسکریپت کنسول در یک بسته‌ی قابل نصب با pip خواهد داشت." msgid "In particular, be careful about returning strings from your ``main`` function. :func:`sys.exit` will interpret a string argument as a failure message, so your program will have an exit code of ``1``, indicating failure, and the string will be written to :data:`sys.stderr`. The ``echo.py`` example from earlier exemplifies using the ``sys.exit(main())`` convention." msgstr "" From 4c677e8867b46ad81c1aa2ff545e3c104a41fb5e Mon Sep 17 00:00:00 2001 From: invincible627 Date: Tue, 25 Aug 2026 15:34:37 +0330 Subject: [PATCH 06/11] translation of part of __main.po file --- GLOSSARY.md | 3 +-- library/__main__.po | 27 +++++++++++++++++++-------- 2 files changed, 20 insertions(+), 10 deletions(-) diff --git a/GLOSSARY.md b/GLOSSARY.md index d63e57b54..daea57994 100644 --- a/GLOSSARY.md +++ b/GLOSSARY.md @@ -17,7 +17,7 @@ | character | نویسه | | class | کلاس | | command line | خط فرمان | -| community | کامیونیتی | +| community | کامیونیتی، انجمن | | component | کامپوننت | | custom | سفارشی، اختصاصی | | decorator | دکوراتور، آراینده | @@ -65,7 +65,6 @@ | parameter | پارامتر | | positional | جایگاهی | | property | ویژگی، پراپرتی، خصوصیت | -| pass | پاس دادن | | quotation | علامت نقل‌وقول | | raise | پرتاب | | return | بازگشت، برگرداندن | diff --git a/library/__main__.po b/library/__main__.po index 234a0186d..33c8bc326 100644 --- a/library/__main__.po +++ b/library/__main__.po @@ -235,16 +235,16 @@ msgid "By proactively following this convention ourselves, our module will have msgstr "با پیروی فعالانه‌ی خودمان از این قرارداد، ماژول ما هنگام اجرای مستقیم (یعنی ``python echo.py``) همان رفتاری را خواهد داشت که در صورت بسته‌بندی بعدی آن به‌عنوان یک نقطه‌ی ورودی اسکریپت کنسول در یک بسته‌ی قابل نصب با pip خواهد داشت." msgid "In particular, be careful about returning strings from your ``main`` function. :func:`sys.exit` will interpret a string argument as a failure message, so your program will have an exit code of ``1``, indicating failure, and the string will be written to :data:`sys.stderr`. The ``echo.py`` example from earlier exemplifies using the ``sys.exit(main())`` convention." -msgstr "" +msgstr "به‌ویژه، در مورد بازگرداندن رشته‌ها از تابع ``main`` خود دقت کنید. :func:`sys.exit` یک آرگومان رشته‌ای را به‌عنوان پیام شکست تفسیر می‌کند، بنابراین برنامه‌ی شما کد خروجی ``1`` را خواهد داشت که نشان‌دهنده‌ی شکست است و رشته به :data:`sys.stderr` نوشته می‌شود. مثال ``echo.py`` از قبل، استفاده از قرارداد ``sys.exit(main())`` را به‌خوبی نشان می‌دهد." msgid "`Python Packaging User Guide `_ contains a collection of tutorials and references on how to distribute and install Python packages with modern tools." -msgstr "" +msgstr "`Python Packaging User Guide `_ شامل مجموعه‌ای از آموزش‌ها و مراجع درباره‌ی نحوه‌ی توزیع و نصب بسته‌های پایتون با ابزارهای مدرن است." msgid "``__main__.py`` in Python Packages" -msgstr "" +msgstr "``__main__.py`` در بسته‌های پایتون" msgid "If you are not familiar with Python packages, see section :ref:`tut-packages` of the tutorial. Most commonly, the ``__main__.py`` file is used to provide a command-line interface for a package. Consider the following hypothetical package, \"bandclass\":" -msgstr "" +msgstr "اگر با بسته‌های پایتون آشنایی ندارید، به بخش :ref:`tut-packages` از آموزش مراجعه کنید. معمولاً، از فایل ``__main__.py`` برای ارائه‌ی یک رابط خط فرمان برای یک بسته استفاده می‌شود. بسته‌ی فرضی زیر را در نظر بگیرید، \"bandclass\":" msgid "" "bandclass\n" @@ -252,15 +252,19 @@ msgid "" " ├── __main__.py\n" " └── student.py" msgstr "" +"bandclass\n" +" ├── __init__.py\n" +" ├── __main__.py\n" +" └── student.py" msgid "``__main__.py`` will be executed when the package itself is invoked directly from the command line using the :option:`-m` flag. For example:" -msgstr "" +msgstr "``__main__.py`` زمانی اجرا می‌شود که خود بسته مستقیماً از خط فرمان با استفاده از پرچم :option:`-m` فراخوانی شود. برای مثال:" msgid "$ python -m bandclass" -msgstr "" +msgstr "$ python -m bandclass" msgid "This command will cause ``__main__.py`` to run. How you utilize this mechanism will depend on the nature of the package you are writing, but in this hypothetical case, it might make sense to allow the teacher to search for students::" -msgstr "" +msgstr "این دستور باعث اجرای ``__main__.py`` می‌شود. نحوه‌ی استفاده‌ی شما از این مکانیزم به ماهیت بسته‌ای که می‌نویسید بستگی دارد، اما در این حالت فرضی، ممکن است منطقی باشد که به معلم اجازه دهید دانش‌آموزان را جستجو کند::" msgid "" "# bandclass/__main__.py\n" @@ -271,9 +275,16 @@ msgid "" "student_name = sys.argv[1] if len(sys.argv) >= 2 else ''\n" "print(f'Found student: {search_students(student_name)}')" msgstr "" +"# bandclass/__main__.py\n" +"\n" +"import sys\n" +"from .student import search_students\n" +"\n" +"student_name = sys.argv[1] if len(sys.argv) >= 2 else ''\n" +"print(f'Found student: {search_students(student_name)}')" msgid "Note that ``from .student import search_students`` is an example of a relative import. This import style can be used when referencing modules within a package. For more details, see :ref:`intra-package-references` in the :ref:`tut-modules` section of the tutorial." -msgstr "" +msgstr "توجه داشته باشید که ``from .student import search_students`` مثالی از یک ایمپورت نسبی است. این سبک ایمپورت را می‌توان هنگام ارجاع به ماژول‌های درون یک بسته استفاده کرد. برای اطلاعات بیشتر، به :ref:`intra-package-references` در بخش :ref:`tut-modules` از آموزش مراجعه کنید." msgid "The content of ``__main__.py`` typically isn't fenced with an ``if __name__ == '__main__'`` block. Instead, those files are kept short and import functions to execute from other modules. Those other modules can then be easily unit-tested and are properly reusable." msgstr "" From f1049521d7b70d612af66a83572041d4b4e39ce7 Mon Sep 17 00:00:00 2001 From: invincible627 Date: Thu, 27 Aug 2026 15:51:57 +0330 Subject: [PATCH 07/11] Complete translation of library/__main__.po --- library/__main__.po | 79 ++++++++++++++++++++++++++++++++++++--------- 1 file changed, 63 insertions(+), 16 deletions(-) diff --git a/library/__main__.po b/library/__main__.po index 33c8bc326..73ff80f55 100644 --- a/library/__main__.po +++ b/library/__main__.po @@ -287,37 +287,40 @@ msgid "Note that ``from .student import search_students`` is an example of a rel msgstr "توجه داشته باشید که ``from .student import search_students`` مثالی از یک ایمپورت نسبی است. این سبک ایمپورت را می‌توان هنگام ارجاع به ماژول‌های درون یک بسته استفاده کرد. برای اطلاعات بیشتر، به :ref:`intra-package-references` در بخش :ref:`tut-modules` از آموزش مراجعه کنید." msgid "The content of ``__main__.py`` typically isn't fenced with an ``if __name__ == '__main__'`` block. Instead, those files are kept short and import functions to execute from other modules. Those other modules can then be easily unit-tested and are properly reusable." -msgstr "" +msgstr "محتوای ``__main__.py`` معمولاً با یک بلوک ``if __name__ == '__main__'`` محصور نمی‌شود. در عوض، آن فایل‌ها کوتاه نگه داشته می‌شوند و توابعی را برای اجرا از ماژول‌های دیگر ایمپورت می‌کنند. سپس آن ماژول‌های دیگر را می‌توان به‌راحتی یونیت‌تست کرد و به‌درستی قابل استفاده‌ی مجدد هستند." msgid "If used, an ``if __name__ == '__main__'`` block will still work as expected for a ``__main__.py`` file within a package, because its ``__name__`` attribute will include the package's path if imported::" -msgstr "" +msgstr "اگر استفاده شود، یک بلوک ``if __name__ == '__main__'`` همچنان برای یک فایل ``__main__.py`` درون یک بسته به‌طور مورد انتظار کار خواهد کرد، زیرا ویژگی ``__name__`` آن در صورت ایمپورت، مسیر بسته را شامل خواهد شد::" msgid "" ">>> import asyncio.__main__\n" ">>> asyncio.__main__.__name__\n" "'asyncio.__main__'" msgstr "" +">>> import asyncio.__main__\n" +">>> asyncio.__main__.__name__\n" +"'asyncio.__main__'" msgid "This won't work for ``__main__.py`` files in the root directory of a ``.zip`` file though. Hence, for consistency, a minimal ``__main__.py`` without a ``__name__`` check is preferred." -msgstr "" +msgstr "با این حال، این برای فایل‌های ``__main__.py`` در پوشهٔ ریشهٔ یک فایل ``.zip`` کار نخواهد کرد. بنابراین، برای یکدستی، یک ``__main__.py`` حداقلی بدون بررسی ``__name__`` ترجیح داده می‌شود." msgid "See :mod:`venv` for an example of a package with a minimal ``__main__.py`` in the standard library. It doesn't contain a ``if __name__ == '__main__'`` block. You can invoke it with ``python -m venv [directory]``." -msgstr "" +msgstr "برای مثال یک بسته با یک ``__main__.py`` حداقلی در کتابخانه‌ی استاندارد، به :mod:`venv` مراجعه کنید. این بسته شامل یک بلوک ``if __name__ == '__main__'`` نمی‌شود. می‌توانید آن را با ``python -m venv [directory]`` فراخوانی کنید." msgid "See :mod:`runpy` for more details on the :option:`-m` flag to the interpreter executable." -msgstr "" +msgstr "برای جزئیات بیشتر درباره‌ی پرچم :option:`-m` به مفسر اجرایی، به :mod:`runpy` مراجعه کنید." msgid "See :mod:`zipapp` for how to run applications packaged as *.zip* files. In this case Python looks for a ``__main__.py`` file in the root directory of the archive." -msgstr "" +msgstr "برای نحوه‌ی اجرای برنامه‌های بسته‌بندی‌شده به‌عنوان فایل‌های *.zip*، به :mod:`zipapp` مراجعه کنید. در این حالت، پایتون به دنبال یک فایل ``__main__.py`` در پوشه‌ی ریشه‌ی بایگانی می‌گردد." msgid "``import __main__``" -msgstr "" +msgstr "``import __main__``" msgid "Regardless of which module a Python program was started with, other modules running within that same program can import the top-level environment's scope (:term:`namespace`) by importing the ``__main__`` module. This doesn't import a ``__main__.py`` file but rather whichever module that received the special name ``'__main__'``." -msgstr "" +msgstr "صرف‌نظر از اینکه یک برنامه‌ی پایتون با کدام ماژول شروع شده است، سایر ماژول‌هایی که در همان برنامه اجرا می‌شوند می‌توانند با ایمپورت کردن ماژول ``__main__``، به محدوده‌ی محیط سطح‌بالا (:term:`namespace`) دسترسی پیدا کنند. این کار یک فایل ``__main__.py`` را ایمپورت نمی‌کند، بلکه هر ماژولی که نام ویژه‌ی ``'__main__'`` را دریافت کرده است، ایمپورت می‌شود." msgid "Here is an example module that consumes the ``__main__`` namespace::" -msgstr "" +msgstr "در اینجا یک مثال از ماژول آورده شده است که از فضای نام ``__main__`` استفاده می‌کند::" msgid "" "# namely.py\n" @@ -333,9 +336,21 @@ msgid "" "\n" " print(__main__.my_name)" msgstr "" +"# namely.py\n" +"\n" +"import __main__\n" +"\n" +"def did_user_define_their_name():\n" +" return 'my_name' in dir(__main__)\n" +"\n" +"def print_user_name():\n" +" if not did_user_define_their_name():\n" +" raise ValueError('Define the variable `my_name`!')\n" +"\n" +" print(__main__.my_name)" msgid "Example usage of this module could be as follows::" -msgstr "" +msgstr "یک نمونه استفاده از این ماژول می‌تواند به صورت زیر باشد::" msgid "" "# start.py\n" @@ -355,31 +370,51 @@ msgid "" "if __name__ == \"__main__\":\n" " sys.exit(main())" msgstr "" +"# start.py\n" +"\n" +"import sys\n" +"\n" +"from namely import print_user_name\n" +"\n" +"# my_name = \"Dinsdale\"\n" +"\n" +"def main():\n" +" try:\n" +" print_user_name()\n" +" except ValueError as ve:\n" +" return str(ve)\n" +"\n" +"if __name__ == \"__main__\":\n" +" sys.exit(main())" msgid "Now, if we started our program, the result would look like this:" -msgstr "" +msgstr "اکنون، اگر ما برنامه‌مان را شروع کنیم، نتیجه مثل زیر می‌شود::" msgid "" "$ python start.py\n" "Define the variable `my_name`!" msgstr "" +"$ python start.py\n" +"Define the variable `my_name`!" msgid "The exit code of the program would be 1, indicating an error. Uncommenting the line with ``my_name = \"Dinsdale\"`` fixes the program and now it exits with status code 0, indicating success:" -msgstr "" +msgstr "کد خروجی برنامه ۱ خواهد بود که نشان‌دهنده‌ی خطا است. خارج کردن خط ``my_name = \"Dinsdale\"`` از حالت توضیح (کامنت)، برنامه را اصلاح می‌کند و اکنون با کد وضعیت ۰ خارج می‌شود که نشان‌دهنده‌ی موفقیت است:" msgid "" "$ python start.py\n" "Dinsdale" msgstr "" +"$ python start.py\n" +"Dinsdale" msgid "Note that importing ``__main__`` doesn't cause any issues with unintentionally running top-level code meant for script use which is put in the ``if __name__ == \"__main__\"`` block of the ``start`` module. Why does this work?" -msgstr "" +msgstr "توجه داشته باشید که ایمپورت کردن ``__main__`` هیچ مشکلی در اجرای ناخواسته‌ی کد سطح‌بالا که برای استفاده‌ی اسکریپتی در نظر گرفته شده و در بلوک ``if __name__ == \"__main__\"`` ماژول ``start`` قرار دارد، ایجاد نمی‌کند. چرا این کار می‌کند؟" msgid "Python inserts an empty ``__main__`` module in :data:`sys.modules` at interpreter startup, and populates it by running top-level code. In our example this is the ``start`` module which runs line by line and imports ``namely``. In turn, ``namely`` imports ``__main__`` (which is really ``start``). That's an import cycle! Fortunately, since the partially populated ``__main__`` module is present in :data:`sys.modules`, Python passes that to ``namely``. See :ref:`Special considerations for __main__ ` in the import system's reference for details on how this works." -msgstr "" +msgstr "پایتون در زمان راه‌اندازی مفسر، یک ماژول خالی ``__main__`` را در :data:`sys.modules` قرار می‌دهد و آن را با اجرای کد سطح‌بالا پر می‌کند. در مثال ما، این ماژول ``start`` است که خط به خط اجرا می‌شود و ``namely`` را ایمپورت می‌کند. در ادامه، ``namely`` ماژول ``__main__`` (که در واقع همان ``start`` است) را ایمپورت می‌کند. این یک چرخه‌ی ایمپورت است! خوشبختانه، از آنجایی که ماژول ``__main__`` تا حدی پر شده در :data:`sys.modules` وجود دارد، پایتون آن را به ``namely`` می‌دهد. برای جزئیات بیشتر درباره‌ی نحوه‌ی کار این مکانیزم، به :ref:`Special considerations for __main__ ` در مرجع سیستم ایمپورت مراجعه کنید." msgid "The Python REPL is another example of a \"top-level environment\", so anything defined in the REPL becomes part of the ``__main__`` scope::" -msgstr "" +msgstr "REPL پایتون مثال دیگری از یک «محیط سطح‌بالا» است، بنابراین هر چیزی که در REPL تعریف شود، بخشی از محدوده‌ی ``__main__`` می‌شود::" msgid "" ">>> import namely\n" @@ -395,6 +430,18 @@ msgid "" ">>> namely.print_user_name()\n" "Jabberwocky" msgstr "" +">>> import namely\n" +">>> namely.did_user_define_their_name()\n" +"False\n" +">>> namely.print_user_name()\n" +"Traceback (most recent call last):\n" +"...\n" +"ValueError: Define the variable `my_name`!\n" +">>> my_name = 'Jabberwocky'\n" +">>> namely.did_user_define_their_name()\n" +"True\n" +">>> namely.print_user_name()\n" +"Jabberwocky" msgid "The ``__main__`` scope is used in the implementation of :mod:`pdb` and :mod:`rlcompleter`." -msgstr "" +msgstr "محدوده‌ی ``__main__`` در پیاده‌سازی :mod:`pdb` و :mod:`rlcompleter` استفاده می‌شود." From a7c7c613ed04eb0ffe10a866597d22e10b389e02 Mon Sep 17 00:00:00 2001 From: invincible627 Date: Thu, 27 Aug 2026 18:11:05 +0330 Subject: [PATCH 08/11] Update GLOSSARY.md --- GLOSSARY.md | 173 +++++++++++++++++++++++++++++----------------------- 1 file changed, 96 insertions(+), 77 deletions(-) diff --git a/GLOSSARY.md b/GLOSSARY.md index daea57994..04c2b8a73 100644 --- a/GLOSSARY.md +++ b/GLOSSARY.md @@ -5,80 +5,99 @@ > این واژه‌نامه با الهام از واژه‌نامه پروژهٔ ترجمه مستندات Vue.js به فارسی تهیه شده و از ساختار و توضیحات دقیق اون استفاده شده. با تشکر از مشارکت‌کنندگان این پروژه برای زحماتشون: > https://github.com/vuejs-translations/docs-fa/blob/main/GLOSSARY.md -| English | فارسی | -| ---------------- | ------------------------ | -| accessibility | دسترسی‌پذیری | -| argument | آرگومان | -| async | ناهمگام، غیرهمگام | -| attribute | ویژگی، صفت، شاخصه | -| boolean | بولی | -| built-in | توکار، درونی، درون‌ساخته | -| callback | کال‌بک، فراخوانی بازگشتی | -| character | نویسه | -| class | کلاس | -| command line | خط فرمان | -| community | کامیونیتی، انجمن | -| component | کامپوننت | -| custom | سفارشی، اختصاصی | -| decorator | دکوراتور، آراینده | -| debugging | اشکال‌زدایی، دیباگ کردن | -| deprecated | منسوخ، از رده خارج شده | -| dependency | وابستگی | -| dictionary | دیکشنری | -| directory | پوشه | -| DOM | DOM | -| element | المان، عنصر | -| endpoint | پایانه | -| escape | خنثی کردن | -| ecosystem | اکوسیستم | -| event | رویداد | -| exception | استثنا | -| expression | عبارت | -| function | تابع | -| generator | تولیدگر | -| global | سراسری | -| import | ایمپورت | -| immutable | تغییرناپذیر | -| index | اندیس، شماره | -| instance | نمونه | -| integer | عدد صحیح | -| interface | رابط | -| interpreter | مفسر | -| item | آیتم | -| iterable | تکرارپذیر | -| keyword | کلیدواژه | -| keyword argument | آرگومان کلیدواژه‌ای | -| list | فهرست | -| list comprehension | درک فهرستی | -| load | بارگذاری | -| loader | بارگذار | -| local | محلی | -| loop | حلقه | -| method | متد، روش | -| mock | ماک | -| module | ماژول | -| mutable | تغییرپذیر | -| namespace | نام‌فضا | -| object | شیء | -| operator | عملگر | -| package | بسته | -| parameter | پارامتر | -| positional | جایگاهی | -| property | ویژگی، پراپرتی، خصوصیت | -| quotation | علامت نقل‌وقول | -| raise | پرتاب | -| return | بازگشت، برگرداندن | -| runtime | ران‌تایم | -| scope | محدوده | -| shadowing | پوشاندن | -| stack traceback | ردگیری پشته | -| statement | دستور | -| string | رشته | -| syntax | سینتکس، نحو | -| Tracking | پیگیری | -| type | نوع، نوع داده، تایپ | -| unit test | یونیت تست | -| unpacking | واگشایی | -| value | مقدار | -| variable | متغیر | -| wrapper | پوششی، دربرگیرنده | +| English | فارسی | +| ------------------ | ----------------------- | +| accessibility | دسترسی‌پذیری | +| API | API | +| argument | آرگومان | +| async | ناهمگام، غیرهمگام | +| attribute | ویژگی، صفت، شاخصه | +| await | await | +| boolean | بولی | +| built-in | توکار، درونی، درون‌ساخته | +| cache | نهانگاه | +| callback | کال‌بک، فراخوانی بازگشتی | +| character | نویسه | +| class | کلاس | +| command line | خط فرمان | +| community | کامیونیتی، انجمن | +| component | کامپوننت | +| context management | مدیریت زمینه | +| coroutine | هم‌روال | +| custom | سفارشی، اختصاصی | +| debugging | اشکال‌زدایی، دیباگ کردن | +| decoding | کدگشایی | +| decorator | دکوراتور، آراینده | +| dependency | وابستگی | +| deprecated | منسوخ، از رده خارج شده | +| dictionary | دیکشنری | +| directory | پوشه | +| DOM | DOM | +| duck-typing | نوع‌دهی اردکی | +| ecosystem | اکوسیستم | +| element | المان، عنصر | +| encoding | کدگذاری | +| endpoint | پایانه | +| escape | خنثی کردن | +| event | رویداد | +| exception | استثنا | +| expression | عبارت | +| f-string | اف‌استرینگ | +| function | تابع | +| garbage collection | زباله‌روبی | +| generator | تولیدگر | +| generic function | تابع عام، تابع عمومی | +| global | سراسری | +| hexadecimal | مبنای شانزده | +| immortal | نامیرا | +| immutable | تغییرناپذیر | +| import | ایمپورت | +| index | اندیس، شماره | +| instance | نمونه | +| integer | عدد صحیح | +| interface | رابط | +| interpreter | مفسر | +| item | آیتم | +| iterable | تکرارپذیر | +| keyword | کلیدواژه | +| keyword argument | آرگومان کلیدواژه‌ای | +| list | فهرست | +| list comprehension | درک فهرستی | +| load | بارگذاری | +| loader | بارگذار | +| local | محلی | +| loop | حلقه | +| metaclass | فراکلاس | +| method | متد، روش | +| mock | ماک | +| module | ماژول | +| mutable | تغییرپذیر | +| namespace | نام‌فضا | +| object | شیء | +| operator | عملگر | +| package | بسته | +| parallelism | موازی‌سازی | +| parameter | پارامتر | +| positional | جایگاهی | +| property | ویژگی، پراپرتی، خصوصیت | +| quotation | علامت نقل‌قول | +| race | رقابت | +| raise | پرتاب | +| return | بازگشت، برگرداندن | +| runtime | ران‌تایم | +| scope | محدوده | +| shadowing | پوشاندن | +| shell | پوسته | +| stack traceback | ردگیری پشته | +| statement | دستور | +| string | رشته | +| syntactic sugar | قند نحوی | +| syntax | سینتکس، نحو | +| thread | نخ | +| tracking | پیگیری | +| type | نوع، نوع داده، تایپ | +| unit test | یونیت تست | +| unpacking | واگشایی | +| value | مقدار | +| variable | متغیر | +| wrapper | پوششی، دربرگیرنده | From b3899815954ef9ab2421cec9e42b7137d877902e Mon Sep 17 00:00:00 2001 From: invincible627 Date: Thu, 27 Aug 2026 23:58:45 +0330 Subject: [PATCH 09/11] Revert "Update GLOSSARY.md" This reverts commit a7c7c613ed04eb0ffe10a866597d22e10b389e02. --- GLOSSARY.md | 173 +++++++++++++++++++++++----------------------------- 1 file changed, 77 insertions(+), 96 deletions(-) diff --git a/GLOSSARY.md b/GLOSSARY.md index 04c2b8a73..daea57994 100644 --- a/GLOSSARY.md +++ b/GLOSSARY.md @@ -5,99 +5,80 @@ > این واژه‌نامه با الهام از واژه‌نامه پروژهٔ ترجمه مستندات Vue.js به فارسی تهیه شده و از ساختار و توضیحات دقیق اون استفاده شده. با تشکر از مشارکت‌کنندگان این پروژه برای زحماتشون: > https://github.com/vuejs-translations/docs-fa/blob/main/GLOSSARY.md -| English | فارسی | -| ------------------ | ----------------------- | -| accessibility | دسترسی‌پذیری | -| API | API | -| argument | آرگومان | -| async | ناهمگام، غیرهمگام | -| attribute | ویژگی، صفت، شاخصه | -| await | await | -| boolean | بولی | -| built-in | توکار، درونی، درون‌ساخته | -| cache | نهانگاه | -| callback | کال‌بک، فراخوانی بازگشتی | -| character | نویسه | -| class | کلاس | -| command line | خط فرمان | -| community | کامیونیتی، انجمن | -| component | کامپوننت | -| context management | مدیریت زمینه | -| coroutine | هم‌روال | -| custom | سفارشی، اختصاصی | -| debugging | اشکال‌زدایی، دیباگ کردن | -| decoding | کدگشایی | -| decorator | دکوراتور، آراینده | -| dependency | وابستگی | -| deprecated | منسوخ، از رده خارج شده | -| dictionary | دیکشنری | -| directory | پوشه | -| DOM | DOM | -| duck-typing | نوع‌دهی اردکی | -| ecosystem | اکوسیستم | -| element | المان، عنصر | -| encoding | کدگذاری | -| endpoint | پایانه | -| escape | خنثی کردن | -| event | رویداد | -| exception | استثنا | -| expression | عبارت | -| f-string | اف‌استرینگ | -| function | تابع | -| garbage collection | زباله‌روبی | -| generator | تولیدگر | -| generic function | تابع عام، تابع عمومی | -| global | سراسری | -| hexadecimal | مبنای شانزده | -| immortal | نامیرا | -| immutable | تغییرناپذیر | -| import | ایمپورت | -| index | اندیس، شماره | -| instance | نمونه | -| integer | عدد صحیح | -| interface | رابط | -| interpreter | مفسر | -| item | آیتم | -| iterable | تکرارپذیر | -| keyword | کلیدواژه | -| keyword argument | آرگومان کلیدواژه‌ای | -| list | فهرست | -| list comprehension | درک فهرستی | -| load | بارگذاری | -| loader | بارگذار | -| local | محلی | -| loop | حلقه | -| metaclass | فراکلاس | -| method | متد، روش | -| mock | ماک | -| module | ماژول | -| mutable | تغییرپذیر | -| namespace | نام‌فضا | -| object | شیء | -| operator | عملگر | -| package | بسته | -| parallelism | موازی‌سازی | -| parameter | پارامتر | -| positional | جایگاهی | -| property | ویژگی، پراپرتی، خصوصیت | -| quotation | علامت نقل‌قول | -| race | رقابت | -| raise | پرتاب | -| return | بازگشت، برگرداندن | -| runtime | ران‌تایم | -| scope | محدوده | -| shadowing | پوشاندن | -| shell | پوسته | -| stack traceback | ردگیری پشته | -| statement | دستور | -| string | رشته | -| syntactic sugar | قند نحوی | -| syntax | سینتکس، نحو | -| thread | نخ | -| tracking | پیگیری | -| type | نوع، نوع داده، تایپ | -| unit test | یونیت تست | -| unpacking | واگشایی | -| value | مقدار | -| variable | متغیر | -| wrapper | پوششی، دربرگیرنده | +| English | فارسی | +| ---------------- | ------------------------ | +| accessibility | دسترسی‌پذیری | +| argument | آرگومان | +| async | ناهمگام، غیرهمگام | +| attribute | ویژگی، صفت، شاخصه | +| boolean | بولی | +| built-in | توکار، درونی، درون‌ساخته | +| callback | کال‌بک، فراخوانی بازگشتی | +| character | نویسه | +| class | کلاس | +| command line | خط فرمان | +| community | کامیونیتی، انجمن | +| component | کامپوننت | +| custom | سفارشی، اختصاصی | +| decorator | دکوراتور، آراینده | +| debugging | اشکال‌زدایی، دیباگ کردن | +| deprecated | منسوخ، از رده خارج شده | +| dependency | وابستگی | +| dictionary | دیکشنری | +| directory | پوشه | +| DOM | DOM | +| element | المان، عنصر | +| endpoint | پایانه | +| escape | خنثی کردن | +| ecosystem | اکوسیستم | +| event | رویداد | +| exception | استثنا | +| expression | عبارت | +| function | تابع | +| generator | تولیدگر | +| global | سراسری | +| import | ایمپورت | +| immutable | تغییرناپذیر | +| index | اندیس، شماره | +| instance | نمونه | +| integer | عدد صحیح | +| interface | رابط | +| interpreter | مفسر | +| item | آیتم | +| iterable | تکرارپذیر | +| keyword | کلیدواژه | +| keyword argument | آرگومان کلیدواژه‌ای | +| list | فهرست | +| list comprehension | درک فهرستی | +| load | بارگذاری | +| loader | بارگذار | +| local | محلی | +| loop | حلقه | +| method | متد، روش | +| mock | ماک | +| module | ماژول | +| mutable | تغییرپذیر | +| namespace | نام‌فضا | +| object | شیء | +| operator | عملگر | +| package | بسته | +| parameter | پارامتر | +| positional | جایگاهی | +| property | ویژگی، پراپرتی، خصوصیت | +| quotation | علامت نقل‌وقول | +| raise | پرتاب | +| return | بازگشت، برگرداندن | +| runtime | ران‌تایم | +| scope | محدوده | +| shadowing | پوشاندن | +| stack traceback | ردگیری پشته | +| statement | دستور | +| string | رشته | +| syntax | سینتکس، نحو | +| Tracking | پیگیری | +| type | نوع، نوع داده، تایپ | +| unit test | یونیت تست | +| unpacking | واگشایی | +| value | مقدار | +| variable | متغیر | +| wrapper | پوششی، دربرگیرنده | From 8e34011f0e10df695da8b3e11d91e489e9d22247 Mon Sep 17 00:00:00 2001 From: invincible627 Date: Fri, 28 Aug 2026 00:03:58 +0330 Subject: [PATCH 10/11] Revert "Merge branch '3.14' into Translation_of_the_library/__main__.po_file" This reverts commit 1276fb129c3be294a54cc274f57b3b2794d5625a, reversing changes made to a7c7c613ed04eb0ffe10a866597d22e10b389e02. --- .github/ISSUE_TEMPLATE/config.yml | 2 +- .github/workflows/build-and-deploy.yml | 2 +- .github/workflows/lint.yml | 2 +- .github/workflows/sync-with-cpython.yml | 83 +- .readthedocs.yml | 2 +- CONTRIBUTING.md | 6 +- README.md | 4 +- STATUS.md | 1079 +++--- TEAM.md | 2 +- about.po | 4 +- bugs.po | 4 +- c-api/abstract.po | 4 +- c-api/allocation.po | 4 +- c-api/apiabiversion.po | 4 +- c-api/arg.po | 4 +- c-api/bool.po | 4 +- c-api/buffer.po | 6 +- c-api/bytearray.po | 4 +- c-api/bytes.po | 6 +- c-api/call.po | 4 +- c-api/capsule.po | 4 +- c-api/cell.po | 4 +- c-api/code.po | 6 +- c-api/codec.po | 4 +- c-api/complex.po | 4 +- c-api/concrete.po | 4 +- c-api/contextvars.po | 4 +- c-api/conversion.po | 4 +- c-api/coro.po | 4 +- c-api/curses.po | 2 +- c-api/datetime.po | 4 +- c-api/descriptor.po | 58 +- c-api/dict.po | 6 +- c-api/exceptions.po | 33 +- c-api/extension-modules.po | 2 +- c-api/file.po | 4 +- c-api/float.po | 4 +- c-api/frame.po | 55 +- c-api/function.po | 4 +- c-api/gcsupport.po | 4 +- c-api/gen.po | 12 +- c-api/hash.po | 4 +- c-api/import.po | 4 +- c-api/index.po | 4 +- c-api/init.po | 4 +- c-api/init_config.po | 15 +- c-api/interp-lifecycle.po | 2 +- c-api/intro.po | 17 +- c-api/iter.po | 4 +- c-api/iterator.po | 4 +- c-api/lifecycle.po | 2 +- c-api/list.po | 8 +- c-api/long.po | 4 +- c-api/mapping.po | 4 +- c-api/marshal.po | 4 +- c-api/memory.po | 8 +- c-api/memoryview.po | 4 +- c-api/method.po | 4 +- c-api/module.po | 8 +- c-api/monitoring.po | 4 +- c-api/none.po | 4 +- c-api/number.po | 4 +- c-api/object.po | 4 +- c-api/objimpl.po | 4 +- c-api/perfmaps.po | 46 +- c-api/picklebuffer.po | 2 +- c-api/profiling.po | 2 +- c-api/refcounting.po | 4 +- c-api/reflection.po | 4 +- c-api/sequence.po | 6 +- c-api/set.po | 6 +- c-api/slice.po | 4 +- c-api/stable.po | 4 +- c-api/structures.po | 8 +- c-api/subinterpreters.po | 2 +- c-api/synchronization.po | 2 +- c-api/sys.po | 4 +- c-api/threads.po | 4 +- c-api/time.po | 4 +- c-api/tls.po | 2 +- c-api/tuple.po | 10 +- c-api/type.po | 6 +- c-api/typehints.po | 4 +- c-api/typeobj.po | 8 +- c-api/unicode.po | 6 +- c-api/utilities.po | 4 +- c-api/veryhigh.po | 80 +- c-api/weakref.po | 8 +- contents.po | 4 +- copyright.po | 4 +- deprecations/c-api-pending-removal-in-3.14.po | 4 +- deprecations/c-api-pending-removal-in-3.15.po | 4 +- deprecations/c-api-pending-removal-in-3.16.po | 2 +- deprecations/c-api-pending-removal-in-3.18.po | 2 +- .../c-api-pending-removal-in-future.po | 4 +- deprecations/index.po | 12 +- deprecations/pending-removal-in-3.13.po | 4 +- deprecations/pending-removal-in-3.14.po | 4 +- deprecations/pending-removal-in-3.15.po | 12 +- deprecations/pending-removal-in-3.16.po | 4 +- deprecations/pending-removal-in-3.17.po | 2 +- deprecations/pending-removal-in-3.18.po | 2 +- deprecations/pending-removal-in-3.19.po | 2 +- deprecations/pending-removal-in-future.po | 4 +- distributing/index.po | 4 +- extending/building.po | 4 +- extending/embedding.po | 4 +- extending/extending.po | 8 +- extending/index.po | 4 +- extending/newtypes.po | 4 +- extending/newtypes_tutorial.po | 4 +- extending/windows.po | 4 +- faq/design.po | 6 +- faq/extending.po | 4 +- faq/general.po | 4 +- faq/gui.po | 4 +- faq/index.po | 4 +- faq/installed.po | 4 +- faq/library.po | 4 +- faq/programming.po | 6 +- faq/windows.po | 4 +- glossary.po | 1063 +++--- howto/a-conceptual-overview-of-asyncio.po | 4 +- howto/annotations.po | 6 +- howto/argparse-optparse.po | 4 +- howto/argparse.po | 4 +- howto/clinic.po | 4 +- howto/cporting.po | 4 +- howto/curses.po | 6 +- howto/descriptor.po | 14 +- howto/enum.po | 8 +- howto/free-threading-extensions.po | 4 +- howto/free-threading-python.po | 4 +- howto/functional.po | 4 +- howto/gdb_helpers.po | 4 +- howto/index.po | 4 +- howto/instrumentation.po | 4 +- howto/ipaddress.po | 4 +- howto/isolating-extensions.po | 4 +- howto/logging-cookbook.po | 6 +- howto/logging.po | 4 +- howto/mro.po | 6 +- howto/perf_profiling.po | 4 +- howto/pyporting.po | 4 +- howto/regex.po | 4 +- howto/remote_debugging.po | 2 +- howto/sockets.po | 4 +- howto/sorting.po | 6 +- howto/timerfd.po | 4 +- howto/unicode.po | 4 +- howto/urllib2.po | 4 +- improve-page-nojs.po | 2 +- improve-page.po | 2 +- installing/index.po | 4 +- library/__future__.po | 4 +- library/__main__.po | 4 +- library/_thread.po | 4 +- library/abc.po | 30 +- library/aifc.po | 4 +- library/allos.po | 4 +- library/annotationlib.po | 2 +- library/archiving.po | 4 +- library/argparse.po | 4 +- library/array.po | 4 +- library/ast.po | 6 +- library/asynchat.po | 4 +- library/asyncio-api-index.po | 4 +- library/asyncio-dev.po | 4 +- library/asyncio-eventloop.po | 39 +- library/asyncio-exceptions.po | 4 +- library/asyncio-extending.po | 4 +- library/asyncio-future.po | 4 +- library/asyncio-graph.po | 10 +- library/asyncio-llapi-index.po | 4 +- library/asyncio-platforms.po | 10 +- library/asyncio-policy.po | 4 +- library/asyncio-protocol.po | 4 +- library/asyncio-queue.po | 9 +- library/asyncio-runner.po | 4 +- library/asyncio-stream.po | 7 +- library/asyncio-subprocess.po | 4 +- library/asyncio-sync.po | 4 +- library/asyncio-task.po | 10 +- library/asyncio-threading.po | 131 - library/asyncio-tools.po | 154 - library/asyncio.po | 16 +- library/asyncore.po | 4 +- library/atexit.po | 4 +- library/audioop.po | 4 +- library/audit_events.po | 4 +- library/base64.po | 4 +- library/bdb.po | 4 +- library/binary.po | 4 +- library/binascii.po | 4 +- library/bisect.po | 6 +- library/builtins.po | 4 +- library/bz2.po | 4 +- library/calendar.po | 6 +- library/cgi.po | 4 +- library/cgitb.po | 4 +- library/chunk.po | 4 +- library/cmath.po | 4 +- library/cmd.po | 4 +- library/cmdline.po | 4 +- library/cmdlinelibs.po | 4 +- library/code.po | 4 +- library/codecs.po | 7 +- library/codeop.po | 4 +- library/collections.abc.po | 4 +- library/collections.po | 6 +- library/colorsys.po | 4 +- library/compileall.po | 4 +- library/compression.po | 2 +- library/compression.zstd.po | 6 +- library/concurrency.po | 4 +- library/concurrent.futures.po | 10 +- library/concurrent.interpreters.po | 4 +- library/concurrent.po | 4 +- library/configparser.po | 4 +- library/constants.po | 4 +- library/contextlib.po | 20 +- library/contextvars.po | 4 +- library/copy.po | 4 +- library/copyreg.po | 4 +- library/crypt.po | 4 +- library/crypto.po | 4 +- library/csv.po | 37 +- library/ctypes.po | 8 +- library/curses.ascii.po | 12 +- library/curses.panel.po | 18 +- library/curses.po | 120 +- library/custominterp.po | 4 +- library/dataclasses.po | 18 +- library/datatypes.po | 4 +- library/datetime.po | 4 +- library/dbm.po | 4 +- library/debug.po | 4 +- library/decimal.po | 4 +- library/development.po | 4 +- library/devmode.po | 4 +- library/dialog.po | 77 +- library/difflib.po | 138 +- library/dis.po | 4 +- library/distribution.po | 4 +- library/distutils.po | 4 +- library/doctest.po | 4 +- library/email.charset.po | 4 +- library/email.compat32-message.po | 4 +- library/email.contentmanager.po | 4 +- library/email.encoders.po | 4 +- library/email.errors.po | 4 +- library/email.examples.po | 4 +- library/email.generator.po | 4 +- library/email.header.po | 4 +- library/email.headerregistry.po | 4 +- library/email.iterators.po | 4 +- library/email.message.po | 4 +- library/email.mime.po | 4 +- library/email.parser.po | 4 +- library/email.po | 4 +- library/email.policy.po | 4 +- library/email.utils.po | 4 +- library/ensurepip.po | 4 +- library/enum.po | 18 +- library/errno.po | 4 +- library/exceptions.po | 4 +- library/faulthandler.po | 4 +- library/fcntl.po | 4 +- library/filecmp.po | 6 +- library/fileformats.po | 4 +- library/fileinput.po | 4 +- library/filesys.po | 4 +- library/fnmatch.po | 6 +- library/fractions.po | 4 +- library/frameworks.po | 4 +- library/ftplib.po | 4 +- library/functional.po | 4 +- library/functions.po | 117 +- library/functools.po | 18 +- library/gc.po | 4 +- library/getopt.po | 7 +- library/getpass.po | 4 +- library/gettext.po | 4 +- library/glob.po | 10 +- library/graphlib.po | 4 +- library/grp.po | 4 +- library/gzip.po | 4 +- library/hashlib.po | 4 +- library/heapq.po | 4 +- library/hmac.po | 4 +- library/html.entities.po | 4 +- library/html.parser.po | 4 +- library/html.po | 4 +- library/http.client.po | 4 +- library/http.cookiejar.po | 66 +- library/http.cookies.po | 4 +- library/http.po | 4 +- library/http.server.po | 60 +- library/i18n.po | 4 +- library/idle.po | 4 +- library/imaplib.po | 25 +- library/imghdr.po | 4 +- library/imp.po | 4 +- library/importlib.metadata.po | 4 +- library/importlib.po | 4 +- library/importlib.resources.abc.po | 4 +- library/importlib.resources.po | 4 +- library/index.po | 4 +- library/inspect.po | 21 +- library/internet.po | 4 +- library/intro.po | 4 +- library/io.po | 4 +- library/ipaddress.po | 4 +- library/ipc.po | 4 +- library/itertools.po | 4 +- library/json.po | 4 +- library/keyword.po | 4 +- library/language.po | 4 +- library/linecache.po | 4 +- library/locale.po | 4 +- library/logging.config.po | 4 +- library/logging.handlers.po | 4 +- library/logging.po | 4 +- library/lzma.po | 116 +- library/mailbox.po | 4 +- library/mailcap.po | 4 +- library/markup.po | 4 +- library/marshal.po | 4 +- library/math.po | 4 +- library/mimetypes.po | 8 +- library/mm.po | 4 +- library/mmap.po | 4 +- library/modulefinder.po | 4 +- library/modules.po | 4 +- library/msilib.po | 4 +- library/msvcrt.po | 4 +- library/multiprocessing.po | 4 +- library/multiprocessing.shared_memory.po | 4 +- library/netdata.po | 4 +- library/netrc.po | 4 +- library/nis.po | 4 +- library/nntplib.po | 4 +- library/numbers.po | 20 +- library/numeric.po | 4 +- library/operator.po | 4 +- library/optparse.po | 4 +- library/os.path.po | 4 +- library/os.po | 109 +- library/ossaudiodev.po | 4 +- library/pathlib.po | 4 +- library/pdb.po | 4 +- library/persistence.po | 4 +- library/pickle.po | 4 +- library/pickletools.po | 4 +- library/pipes.po | 4 +- library/pkgutil.po | 4 +- library/platform.po | 10 +- library/plistlib.po | 4 +- library/poplib.po | 4 +- library/posix.po | 4 +- library/pprint.po | 4 +- library/profile.po | 4 +- library/pty.po | 4 +- library/pwd.po | 4 +- library/py_compile.po | 4 +- library/pyclbr.po | 4 +- library/pydoc.po | 4 +- library/pyexpat.po | 4 +- library/python.po | 4 +- library/queue.po | 4 +- library/quopri.po | 4 +- library/random.po | 4 +- library/re.po | 6 +- library/readline.po | 4 +- library/removed.po | 4 +- library/reprlib.po | 4 +- library/resource.po | 4 +- library/rlcompleter.po | 4 +- library/runpy.po | 4 +- library/sched.po | 4 +- library/secrets.po | 6 +- library/security_warnings.po | 4 +- library/select.po | 4 +- library/selectors.po | 4 +- library/shelve.po | 4 +- library/shlex.po | 4 +- library/shutil.po | 4 +- library/signal.po | 4 +- library/site.po | 4 +- library/smtpd.po | 4 +- library/smtplib.po | 4 +- library/sndhdr.po | 4 +- library/socket.po | 105 +- library/socketserver.po | 4 +- library/spwd.po | 4 +- library/sqlite3.po | 4 +- library/ssl.po | 4 +- library/stat.po | 4 +- library/statistics.po | 4 +- library/stdtypes.po | 28 +- library/string.po | 6 +- library/string.templatelib.po | 2 +- library/stringprep.po | 4 +- library/struct.po | 8 +- library/subprocess.po | 4 +- library/sunau.po | 4 +- library/superseded.po | 4 +- library/symtable.po | 4 +- library/sys.monitoring.po | 4 +- library/sys.po | 6 +- library/sys_path_init.po | 4 +- library/sysconfig.po | 4 +- library/syslog.po | 4 +- library/tabnanny.po | 4 +- library/tarfile.po | 6 +- library/telnetlib.po | 4 +- library/tempfile.po | 6 +- library/termios.po | 4 +- library/test.po | 24 +- library/text.po | 4 +- library/textwrap.po | 4 +- library/threading.po | 4 +- library/threadsafety.po | 2 +- library/time.po | 4 +- library/timeit.po | 4 +- library/tk.po | 4 +- library/tkinter.colorchooser.po | 12 +- library/tkinter.dnd.po | 26 +- library/tkinter.font.po | 28 +- library/tkinter.messagebox.po | 11 +- library/tkinter.po | 3105 +---------------- library/tkinter.scrolledtext.po | 8 +- library/tkinter.ttk.po | 277 +- library/token.po | 4 +- library/tokenize.po | 4 +- library/tomllib.po | 4 +- library/trace.po | 4 +- library/traceback.po | 4 +- library/tracemalloc.po | 4 +- library/tty.po | 4 +- library/turtle.po | 4 +- library/types.po | 4 +- library/typing.po | 14 +- library/unicodedata.po | 4 +- library/unittest.mock-examples.po | 4 +- library/unittest.mock.po | 6 +- library/unittest.po | 18 +- library/unix.po | 4 +- library/urllib.error.po | 4 +- library/urllib.parse.po | 20 +- library/urllib.po | 4 +- library/urllib.request.po | 6 +- library/urllib.robotparser.po | 4 +- library/uu.po | 7 +- library/uuid.po | 4 +- library/venv.po | 4 +- library/warnings.po | 33 +- library/wave.po | 4 +- library/weakref.po | 4 +- library/webbrowser.po | 4 +- library/windows.po | 4 +- library/winreg.po | 4 +- library/winsound.po | 4 +- library/wsgiref.po | 4 +- library/xdrlib.po | 4 +- library/xml.dom.minidom.po | 4 +- library/xml.dom.po | 4 +- library/xml.dom.pulldom.po | 4 +- library/xml.etree.elementtree.po | 4 +- library/xml.po | 4 +- library/xml.sax.handler.po | 4 +- library/xml.sax.po | 4 +- library/xml.sax.reader.po | 4 +- library/xml.sax.utils.po | 4 +- library/xmlrpc.client.po | 4 +- library/xmlrpc.po | 4 +- library/xmlrpc.server.po | 4 +- library/zipapp.po | 4 +- library/zipfile.po | 4 +- library/zipimport.po | 4 +- library/zlib.po | 4 +- library/zoneinfo.po | 4 +- license.po | 52 +- reference/compound_stmts.po | 16 +- reference/datamodel.po | 8 +- reference/executionmodel.po | 4 +- reference/expressions.po | 93 +- reference/grammar.po | 4 +- reference/import.po | 4 +- reference/index.po | 4 +- reference/introduction.po | 4 +- reference/lexical_analysis.po | 4 +- reference/simple_stmts.po | 6 +- reference/toplevel_components.po | 4 +- reports/contributor_stats_latest.png | Bin 50429 -> 50565 bytes scripts/fix_term_refs.py | 307 -- scripts/generate_status_table.py | 26 +- scripts/po_sync.py | 313 -- scripts/unstage_cosmetic.py | 74 - scripts/update_po_headers.py | 4 +- scripts/update_python_version.py | 174 +- sphinx.po | 4 +- tutorial/appendix.po | 4 +- tutorial/appetite.po | 4 +- tutorial/classes.po | 20 +- tutorial/controlflow.po | 28 +- tutorial/datastructures.po | 20 +- tutorial/errors.po | 14 +- tutorial/floatingpoint.po | 6 +- tutorial/index.po | 4 +- tutorial/inputoutput.po | 20 +- tutorial/interactive.po | 6 +- tutorial/interpreter.po | 4 +- tutorial/introduction.po | 26 +- tutorial/modules.po | 16 +- tutorial/stdlib.po | 12 +- tutorial/stdlib2.po | 16 +- tutorial/venv.po | 9 +- tutorial/whatnow.po | 4 +- using/android.po | 4 +- using/cmdline.po | 4 +- using/configure.po | 4 +- using/editors.po | 4 +- using/index.po | 4 +- using/ios.po | 4 +- using/mac.po | 4 +- using/unix.po | 4 +- using/windows.po | 10 +- whatsnew/2.0.po | 4 +- whatsnew/2.1.po | 4 +- whatsnew/2.2.po | 4 +- whatsnew/2.3.po | 4 +- whatsnew/2.4.po | 148 +- whatsnew/2.5.po | 178 +- whatsnew/2.6.po | 226 +- whatsnew/2.7.po | 6 +- whatsnew/3.0.po | 4 +- whatsnew/3.1.po | 4 +- whatsnew/3.10.po | 10 +- whatsnew/3.11.po | 14 +- whatsnew/3.12.po | 20 +- whatsnew/3.13.po | 14 +- whatsnew/3.14.po | 13 +- whatsnew/3.2.po | 22 +- whatsnew/3.3.po | 12 +- whatsnew/3.4.po | 12 +- whatsnew/3.5.po | 10 +- whatsnew/3.6.po | 4 +- whatsnew/3.7.po | 10 +- whatsnew/3.8.po | 14 +- whatsnew/3.9.po | 4 +- whatsnew/changelog.po | 4 +- whatsnew/index.po | 4 +- 553 files changed, 3497 insertions(+), 8117 deletions(-) delete mode 100644 library/asyncio-threading.po delete mode 100644 library/asyncio-tools.po delete mode 100644 scripts/fix_term_refs.py delete mode 100644 scripts/po_sync.py delete mode 100644 scripts/unstage_cosmetic.py diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index 4631ba934..fcaba00bf 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -1,5 +1,5 @@ blank_issues_enabled: true contact_links: - name: راهنمای مشارکت (CONTRIBUTING.md) - url: https://github.com/python/python-docs-fa/blob/3.14/CONTRIBUTING.md + url: https://github.com/revisto/python-docs-fa/blob/3.14/CONTRIBUTING.md about: پیش از ثبت issue، لطفاً راهنمای مشارکت و README را مطالعه کنید diff --git a/.github/workflows/build-and-deploy.yml b/.github/workflows/build-and-deploy.yml index 8755a386d..0b7815df0 100644 --- a/.github/workflows/build-and-deploy.yml +++ b/.github/workflows/build-and-deploy.yml @@ -25,7 +25,7 @@ jobs: uses: actions/checkout@v4 with: repository: python/cpython - ref: v3.14.7 + ref: v3.14.6 - name: Set up Python uses: actions/setup-python@v4 diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml index 66e781edf..169ee002a 100644 --- a/.github/workflows/lint.yml +++ b/.github/workflows/lint.yml @@ -19,7 +19,7 @@ jobs: uses: actions/checkout@v4 with: repository: python/cpython - ref: v3.14.7 + ref: v3.14.6 - name: Set up Python uses: actions/setup-python@v4 diff --git a/.github/workflows/sync-with-cpython.yml b/.github/workflows/sync-with-cpython.yml index ddffe89e6..2433581e0 100644 --- a/.github/workflows/sync-with-cpython.yml +++ b/.github/workflows/sync-with-cpython.yml @@ -6,9 +6,9 @@ on: workflow_dispatch: inputs: cpython_tag: - description: 'CPython tag to sync against (e.g. v3.14.7)' + description: 'CPython tag to sync against (e.g. v3.14.6)' required: false - default: 'v3.14.7' + default: 'v3.14.6' permissions: contents: write @@ -21,8 +21,6 @@ concurrency: jobs: sync: runs-on: ubuntu-latest - env: - CPYTHON_TAG: ${{ github.event.inputs.cpython_tag || 'v3.14.7' }} steps: - name: Checkout translation repo uses: actions/checkout@v4 @@ -40,12 +38,41 @@ jobs: - name: Install Python dependencies run: pip install sphinx sphinx-intl - # Item 4: fetch/build/merge/validate now all live in one shared - # module (scripts/po_sync.py) instead of inline bash/awk here, so - # this workflow can't drift from update_python_version.py the way - # it did before (missing --no-location --no-wrap on one side). - - name: Sync msgids (fetch, build gettext, merge, validate) - run: python scripts/po_sync.py sync-only "$CPYTHON_TAG" + - name: Checkout CPython docs only (sparse) + run: | + git clone \ + --depth 1 \ + --filter=blob:none \ + --sparse \ + --branch ${{ github.event.inputs.cpython_tag || 'v3.14.6' }} \ + https://github.com/python/cpython.git \ + .cpython-src + cd .cpython-src + git sparse-checkout set Doc Include + + - name: Install CPython doc dependencies + run: | + python -m venv .cpython-src/Doc/venv + .cpython-src/Doc/venv/bin/pip install \ + -r .cpython-src/Doc/requirements.txt + + - name: Build .pot templates + run: | + cd .cpython-src/Doc + ./venv/bin/sphinx-build \ + -b gettext \ + . \ + ../../.pot-templates + + - name: Merge .pot into .po files + run: | + find .pot-templates -name "*.pot" | while read f; do + rel="${f#.pot-templates/}" + po="${rel%.pot}.po" + if [ -f "$po" ]; then + msgmerge --update --backup=off --no-location --no-wrap "$po" "$f" + fi + done - name: Ensure translation label exists env: @@ -60,6 +87,7 @@ jobs: - name: Open issue for fuzzy strings env: GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} + CPYTHON_TAG: ${{ github.event.inputs.cpython_tag || 'v3.14.6' }} run: | tmpfile=$(mktemp) while IFS= read -r f; do @@ -102,11 +130,41 @@ jobs: fi rm -f "$tmpfile" + - name: Validate .po files + run: | + tmpfile=$(mktemp) + find . -name "*.po" \ + -not -path "./.git/*" \ + -not -path "./.cpython-src/*" \ + -not -path "./.pot-templates/*" | while read f; do + msgfmt --check "$f" -o /dev/null || echo "FAIL: $f" >> "$tmpfile" + done + if [ -s "$tmpfile" ]; then + cat "$tmpfile" + rm -f "$tmpfile" + exit 1 + fi + rm -f "$tmpfile" + + - name: Clean up scratch files + run: rm -rf .cpython-src .pot-templates + - name: Stage changes run: git add --all - name: Unstage POT-Creation-Date-only changes - run: python scripts/unstage_cosmetic.py + run: | + git diff --staged --name-only | while read f; do + if git diff --staged -U0 -- "$f" \ + | grep '^[+-]' \ + | grep -v '^[+-][+-][+-]' \ + | grep -qv 'POT-Creation-Date'; then + : # has real changes, keep staged + else + git restore --staged "$f" + git restore "$f" + fi + done - name: Commit if changed run: | @@ -116,5 +174,6 @@ jobs: echo "Nothing to commit, skipping." exit 0 fi - git commit -m "chore: sync msgids with CPython $CPYTHON_TAG" + git commit -m \ + "chore: sync msgids with CPython ${{ github.event.inputs.cpython_tag || 'v3.14.6' }}" git push \ No newline at end of file diff --git a/.readthedocs.yml b/.readthedocs.yml index f2f5b514b..6d2628525 100644 --- a/.readthedocs.yml +++ b/.readthedocs.yml @@ -29,7 +29,7 @@ build: fi echo "Continuing build." exit 0 - - git clone --depth 1 --branch v3.14.7 https://github.com/python/cpython venv/cpython + - git clone --depth 1 --branch v3.14.6 https://github.com/python/cpython venv/cpython - pip install -r venv/cpython/Doc/requirements.txt - mkdir -p venv/cpython/Doc/locales/fa/LC_MESSAGES - cp --parents *.po venv/cpython/Doc/locales/fa/LC_MESSAGES/ diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index f7780cce6..ba9021f22 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -10,7 +10,7 @@ ```bash git clone https://github.com//python-docs-fa.git cd python-docs-fa - git remote add upstream https://github.com/python/python-docs-fa.git + git remote add upstream https://github.com/revisto/python-docs-fa.git ``` 2. یک شاخه برای کارتان بسازید (نام شاخه باید گویا باشد، مثلاً `translate-something`): ```bash @@ -45,7 +45,7 @@ 2. فایل `.po` مورد نظر را با [Poedit](https://poedit.net) یا هر ویرایشگر متنی باز کنید. - در Poedit رشته‌های ترجمه‌نشده یا `fuzzy` را از پنل فیلتر (Filter) پیدا کنید. 3. متن `msgid` را ترجمه کنید و در `msgstr` وارد کنید. -4. **نشانه‌گذاری‌های Sphinx** مثل `` :class:`int` `` ، `` :func:`repr` `` ، `` :ref:`...` `` ، `` ``code`` `` و **جای‌گذارها** مثل `%s` یا `{name}` را دقیقاً بدون تغییر نگه دارید؛ فقط متن اطراف آن‌ها ترجمه می‌شود. در `` :term:`target` ``، اگر عبارت داخل بک‌تیک با شناسهٔ واژه‌نامه یکی است، می‌توانید آن را به شکل `` :term:`ترجمه ` `` بنویسید تا هم متن ترجمه‌شده نمایش داده شود و هم لینک درست کار کند؛ در این حالت فقط بخش نمایشی (پیش از `<`) ترجمه می‌شود و `target` داخل `<>` باید دقیقاً همان شناسهٔ انگلیسی اصلی (بدون تغییر) باقی بماند، چون تغییر آن لینک را خراب می‌کند. +4. **نشانه‌گذاری‌های Sphinx** مثل `` :class:`int` `` ، `` :func:`repr` `` ، `` :ref:`...` `` ، `` ``code`` `` و **جای‌گذارها** مثل `%s` یا `{name}` را دقیقاً بدون تغییر نگه دارید؛ فقط متن اطراف آن‌ها ترجمه می‌شود. ترجمهٔ `target` در `` :term:`text ` `` ممنوع است چون لینک را خراب می‌کند. 5. داخل کدها (بلوک‌های `code-block`) نام متغیرها، توابع و کلمات کلیدی را ترجمه نکنید؛ فقط رشته‌ها و کامنت‌ها را می‌توانید ترجمه کنید. 6. از [واژه‌نامهٔ پروژه (GLOSSARY.md)](GLOSSARY.md) برای ثابت نگه‌داشتن اصطلاحات استفاده کنید. 7. اگر به اصطلاحی برخوردید که در واژه‌نامه نبود، ترجمه‌ای برای آن انتخاب کنید و به واژه‌نامه اضافه کنید. @@ -105,7 +105,7 @@ python3 scripts/update_po_headers.py --dry-run # فقط اصلاح فیلد Language-Team بدون دست‌زدن به اعتبارها python3 scripts/update_po_headers.py --no-credits \ - --language-team "Persian (https://github.com/python/python-docs-fa/)" \ + --language-team "Persian (https://github.com/revisto/python-docs-fa/)" \ bugs.po tutorial/ # ادغام نام‌های جدید با فهرست موجود (نام‌های قبلی حذف نمی‌شوند) diff --git a/README.md b/README.md index d9b1c70b6..c164d7792 100644 --- a/README.md +++ b/README.md @@ -44,6 +44,6 @@ ### مشارکت‌های کاربران -![نمودار مشارکت‌های کاربران؛ Revisto 3984، sepehr-rs 2210، danialbehzadi 677، invincible627 358، khosro_o 63، ParhamF 41، Ariyan_Bolandi 37، nikovinix7878 13، thaghgoo 12، Ramiz_222 10](reports/contributor_stats_latest.png) -(به‌روزرسانی: 2026-08-27) +![نمودار مشارکت‌های کاربران؛ Revisto 3984، sepehr-rs 1630، danialbehzadi 677، invincible627 358، khosro_o 63، ParhamF 41، Ariyan_Bolandi 37، nikovinix7878 13، thaghgoo 12، Ramiz_222 10](reports/contributor_stats_latest.png) +(به‌روزرسانی: 2026-08-21) \ No newline at end of file diff --git a/STATUS.md b/STATUS.md index 2684c4f87..e4b40150b 100644 --- a/STATUS.md +++ b/STATUS.md @@ -1,545 +1,542 @@ ### وضعیت ترجمه فایل‌ها -(به‌روزرسانی: 2026-08-27) +(به‌روزرسانی: 2026-08-21) -| فایل | ترجمه‌شده | مبهم | تعداد ترجمه‌شده | تعداد ترجمه‌نشده | -|:-----|:-----------:|:-----------:|:-----------:|:-----------:| -| about.po | 100.0% | 0.0% | 10 | 0 | -| bugs.po | 100.0% | 0.0% | 31 | 0 | -| c-api/abstract.po | 100.0% | 0.0% | 3 | 0 | -| c-api/allocation.po | 100.0% | 0.0% | 40 | 0 | -| c-api/apiabiversion.po | 100.0% | 0.0% | 60 | 0 | -| c-api/bool.po | 100.0% | 0.0% | 11 | 0 | -| c-api/bytearray.po | 100.0% | 0.0% | 23 | 0 | -| contents.po | 100.0% | 0.0% | 1 | 0 | -| copyright.po | 100.0% | 0.0% | 7 | 0 | -| glossary.po | 100.0% | 0.0% | 499 | 0 | -| improve-page-nojs.po | 100.0% | 0.0% | 6 | 0 | -| improve-page.po | 100.0% | 0.0% | 8 | 0 | -| library/__future__.po | 100.0% | 0.0% | 49 | 0 | -| library/functions.po | 100.0% | 0.0% | 521 | 0 | -| sphinx.po | 100.0% | 0.0% | 112 | 0 | -| tutorial/appendix.po | 100.0% | 0.0% | 28 | 0 | -| tutorial/appetite.po | 100.0% | 0.0% | 17 | 0 | -| tutorial/classes.po | 100.0% | 0.0% | 149 | 0 | -| tutorial/controlflow.po | 100.0% | 0.0% | 226 | 0 | -| tutorial/datastructures.po | 100.0% | 0.0% | 127 | 0 | -| tutorial/errors.po | 100.0% | 0.0% | 96 | 0 | -| tutorial/floatingpoint.po | 100.0% | 0.0% | 76 | 0 | -| tutorial/index.po | 100.0% | 0.0% | 9 | 0 | -| tutorial/inputoutput.po | 100.0% | 0.0% | 112 | 0 | -| tutorial/interactive.po | 100.0% | 0.0% | 7 | 0 | -| tutorial/interpreter.po | 100.0% | 0.0% | 33 | 0 | -| tutorial/introduction.po | 100.0% | 0.0% | 120 | 0 | -| tutorial/modules.po | 100.0% | 0.0% | 117 | 0 | -| tutorial/stdlib.po | 100.0% | 0.0% | 67 | 0 | -| tutorial/stdlib2.po | 100.0% | 0.0% | 65 | 0 | -| tutorial/venv.po | 100.0% | 0.0% | 43 | 0 | -| tutorial/whatnow.po | 100.0% | 0.0% | 18 | 0 | -| library/__main__.po | 13.9% | 0.0% | 10 | 62 | -| c-api/dict.po | 2.8% | 0.0% | 3 | 106 | -| library/json.po | 1.1% | 0.0% | 2 | 175 | -| c-api/arg.po | 0.0% | 0.0% | 0 | 205 | -| c-api/buffer.po | 0.0% | 0.0% | 0 | 119 | -| c-api/bytes.po | 0.0% | 0.0% | 0 | 77 | -| c-api/call.po | 0.0% | 0.0% | 0 | 99 | -| c-api/capsule.po | 0.0% | 0.0% | 0 | 36 | -| c-api/cell.po | 0.0% | 0.0% | 0 | 11 | -| c-api/code.po | 0.0% | 0.0% | 0 | 82 | -| c-api/codec.po | 0.0% | 0.0% | 0 | 30 | -| c-api/complex.po | 0.0% | 0.0% | 0 | 35 | -| c-api/concrete.po | 0.0% | 0.0% | 0 | 16 | -| c-api/contextvars.po | 0.0% | 0.0% | 0 | 38 | -| c-api/conversion.po | 0.0% | 0.0% | 0 | 55 | -| c-api/coro.po | 0.0% | 0.0% | 0 | 6 | -| c-api/curses.po | 0.0% | 0.0% | 0 | 28 | -| c-api/datetime.po | 0.0% | 0.0% | 0 | 65 | -| c-api/descriptor.po | 0.0% | 0.0% | 0 | 33 | -| c-api/exceptions.po | 0.0% | 0.0% | 0 | 274 | -| c-api/extension-modules.po | 0.0% | 0.0% | 0 | 50 | -| c-api/file.po | 0.0% | 0.0% | 0 | 31 | -| c-api/float.po | 0.0% | 0.0% | 0 | 58 | -| c-api/frame.po | 0.0% | 0.0% | 0 | 61 | -| c-api/function.po | 0.0% | 0.0% | 0 | 43 | -| c-api/gcsupport.po | 0.0% | 0.0% | 0 | 68 | -| c-api/gen.po | 0.0% | 0.0% | 0 | 18 | -| c-api/hash.po | 0.0% | 0.0% | 0 | 40 | -| c-api/import.po | 0.0% | 0.0% | 0 | 67 | -| c-api/index.po | 0.0% | 0.0% | 0 | 2 | -| c-api/init.po | 0.0% | 0.0% | 0 | 8 | -| c-api/init_config.po | 0.0% | 0.0% | 0 | 639 | -| c-api/interp-lifecycle.po | 0.0% | 0.0% | 0 | 202 | -| c-api/intro.po | 0.0% | 0.0% | 0 | 217 | -| c-api/iter.po | 0.0% | 0.0% | 0 | 12 | -| c-api/iterator.po | 0.0% | 0.0% | 0 | 24 | -| c-api/lifecycle.po | 0.0% | 0.0% | 0 | 45 | -| c-api/list.po | 0.0% | 0.0% | 0 | 38 | -| c-api/long.po | 0.0% | 0.0% | 0 | 179 | -| c-api/mapping.po | 0.0% | 0.0% | 0 | 23 | -| c-api/marshal.po | 0.0% | 0.0% | 0 | 17 | -| c-api/memory.po | 0.0% | 0.0% | 0 | 219 | -| c-api/memoryview.po | 0.0% | 0.0% | 0 | 15 | -| c-api/method.po | 0.0% | 0.0% | 0 | 20 | -| c-api/module.po | 0.0% | 0.0% | 0 | 135 | -| c-api/monitoring.po | 0.0% | 0.0% | 0 | 55 | -| c-api/none.po | 0.0% | 0.0% | 0 | 7 | -| c-api/number.po | 0.0% | 0.0% | 0 | 48 | -| c-api/object.po | 0.0% | 0.0% | 0 | 147 | -| c-api/objimpl.po | 0.0% | 0.0% | 0 | 2 | -| c-api/perfmaps.po | 0.0% | 0.0% | 0 | 24 | -| c-api/picklebuffer.po | 0.0% | 0.0% | 0 | 16 | -| c-api/profiling.po | 0.0% | 0.0% | 0 | 46 | -| c-api/refcounting.po | 0.0% | 0.0% | 0 | 50 | -| c-api/reflection.po | 0.0% | 0.0% | 0 | 17 | -| c-api/sequence.po | 0.0% | 0.0% | 0 | 32 | -| c-api/set.po | 0.0% | 0.0% | 0 | 35 | -| c-api/slice.po | 0.0% | 0.0% | 0 | 25 | -| c-api/stable.po | 0.0% | 0.0% | 0 | 45 | -| c-api/structures.po | 0.0% | 0.0% | 0 | 206 | -| c-api/subinterpreters.po | 0.0% | 0.0% | 0 | 87 | -| c-api/synchronization.po | 0.0% | 0.0% | 0 | 58 | -| c-api/sys.po | 0.0% | 0.0% | 0 | 87 | -| c-api/threads.po | 0.0% | 0.0% | 0 | 176 | -| c-api/time.po | 0.0% | 0.0% | 0 | 27 | -| c-api/tls.po | 0.0% | 0.0% | 0 | 27 | -| c-api/tuple.po | 0.0% | 0.0% | 0 | 47 | -| c-api/type.po | 0.0% | 0.0% | 0 | 137 | -| c-api/typehints.po | 0.0% | 0.0% | 0 | 7 | -| c-api/typeobj.po | 0.0% | 0.0% | 0 | 764 | -| c-api/unicode.po | 0.0% | 0.0% | 0 | 414 | -| c-api/utilities.po | 0.0% | 0.0% | 0 | 2 | -| c-api/veryhigh.po | 0.0% | 0.0% | 0 | 86 | -| c-api/weakref.po | 0.0% | 0.0% | 0 | 23 | -| deprecations/c-api-pending-removal-in-3.14.po | 0.0% | 0.0% | 0 | 3 | -| deprecations/c-api-pending-removal-in-3.15.po | 0.0% | 0.0% | 0 | 45 | -| deprecations/c-api-pending-removal-in-3.16.po | 0.0% | 0.0% | 0 | 2 | -| deprecations/c-api-pending-removal-in-3.18.po | 0.0% | 0.0% | 0 | 22 | -| deprecations/c-api-pending-removal-in-future.po | 0.0% | 0.0% | 0 | 20 | -| deprecations/index.po | 0.0% | 0.0% | 0 | 230 | -| deprecations/pending-removal-in-3.13.po | 0.0% | 0.0% | 0 | 33 | -| deprecations/pending-removal-in-3.14.po | 0.0% | 0.0% | 0 | 33 | -| deprecations/pending-removal-in-3.15.po | 0.0% | 0.0% | 0 | 29 | -| deprecations/pending-removal-in-3.16.po | 0.0% | 0.0% | 0 | 36 | -| deprecations/pending-removal-in-3.17.po | 0.0% | 0.0% | 0 | 9 | -| deprecations/pending-removal-in-3.18.po | 0.0% | 0.0% | 0 | 3 | -| deprecations/pending-removal-in-3.19.po | 0.0% | 0.0% | 0 | 3 | -| deprecations/pending-removal-in-future.po | 0.0% | 0.0% | 0 | 70 | -| distributing/index.po | 0.0% | 0.0% | 0 | 2 | -| extending/building.po | 0.0% | 0.0% | 0 | 6 | -| extending/embedding.po | 0.0% | 0.0% | 0 | 59 | -| extending/extending.po | 0.0% | 0.0% | 0 | 226 | -| extending/index.po | 0.0% | 0.0% | 0 | 11 | -| extending/newtypes.po | 0.0% | 0.0% | 0 | 117 | -| extending/newtypes_tutorial.po | 0.0% | 0.0% | 0 | 180 | -| extending/windows.po | 0.0% | 0.0% | 0 | 28 | -| faq/design.po | 0.0% | 0.0% | 0 | 172 | -| faq/extending.po | 0.0% | 0.0% | 0 | 64 | -| faq/general.po | 0.0% | 0.0% | 0 | 98 | -| faq/gui.po | 0.0% | 0.0% | 0 | 16 | -| faq/index.po | 0.0% | 0.0% | 0 | 1 | -| faq/installed.po | 0.0% | 0.0% | 0 | 15 | -| faq/library.po | 0.0% | 0.0% | 0 | 153 | -| faq/programming.po | 0.0% | 0.0% | 0 | 506 | -| faq/windows.po | 0.0% | 0.0% | 0 | 58 | -| howto/a-conceptual-overview-of-asyncio.po | 0.0% | 0.0% | 0 | 93 | -| howto/annotations.po | 0.0% | 0.0% | 0 | 52 | -| howto/argparse-optparse.po | 0.0% | 0.0% | 0 | 20 | -| howto/argparse.po | 0.0% | 0.0% | 0 | 145 | -| howto/clinic.po | 0.0% | 0.0% | 0 | 2 | -| howto/cporting.po | 0.0% | 0.0% | 0 | 5 | -| howto/curses.po | 0.0% | 0.0% | 0 | 121 | -| howto/descriptor.po | 0.0% | 0.0% | 0 | 230 | -| howto/enum.po | 0.0% | 0.0% | 0 | 309 | -| howto/free-threading-extensions.po | 0.0% | 0.0% | 0 | 106 | -| howto/free-threading-python.po | 0.0% | 0.0% | 0 | 67 | -| howto/functional.po | 0.0% | 0.0% | 0 | 252 | -| howto/gdb_helpers.po | 0.0% | 0.0% | 0 | 86 | -| howto/index.po | 0.0% | 0.0% | 0 | 30 | -| howto/instrumentation.po | 0.0% | 0.0% | 0 | 99 | -| howto/ipaddress.po | 0.0% | 0.0% | 0 | 65 | -| howto/isolating-extensions.po | 0.0% | 0.0% | 0 | 134 | -| howto/logging-cookbook.po | 0.0% | 0.0% | 0 | 435 | -| howto/logging.po | 0.0% | 0.0% | 0 | 250 | -| howto/mro.po | 0.0% | 0.0% | 0 | 120 | -| howto/perf_profiling.po | 0.0% | 0.0% | 0 | 50 | -| howto/pyporting.po | 0.0% | 0.0% | 0 | 13 | -| howto/regex.po | 0.0% | 0.0% | 0 | 337 | -| howto/remote_debugging.po | 0.0% | 0.0% | 0 | 146 | -| howto/sockets.po | 0.0% | 0.0% | 0 | 63 | -| howto/sorting.po | 0.0% | 0.0% | 0 | 92 | -| howto/timerfd.po | 0.0% | 0.0% | 0 | 12 | -| howto/unicode.po | 0.0% | 0.0% | 0 | 145 | -| howto/urllib2.po | 0.0% | 0.0% | 0 | 100 | -| installing/index.po | 0.0% | 0.0% | 0 | 53 | -| library/_thread.po | 0.0% | 0.0% | 0 | 52 | -| library/abc.po | 0.0% | 0.0% | 0 | 60 | -| library/aifc.po | 0.0% | 0.0% | 0 | 3 | -| library/allos.po | 0.0% | 0.0% | 0 | 2 | -| library/annotationlib.po | 0.0% | 0.0% | 0 | 158 | -| library/archiving.po | 0.0% | 0.0% | 0 | 2 | -| library/argparse.po | 0.0% | 0.0% | 0 | 408 | -| library/array.po | 0.0% | 0.0% | 0 | 89 | -| library/ast.po | 0.0% | 0.0% | 0 | 339 | -| library/asynchat.po | 0.0% | 0.0% | 0 | 4 | -| library/asyncio-api-index.po | 0.0% | 0.0% | 0 | 100 | -| library/asyncio-dev.po | 0.0% | 0.0% | 0 | 84 | -| library/asyncio-eventloop.po | 0.0% | 0.0% | 0 | 426 | -| library/asyncio-exceptions.po | 0.0% | 0.0% | 0 | 19 | -| library/asyncio-extending.po | 0.0% | 0.0% | 0 | 27 | -| library/asyncio-future.po | 0.0% | 0.0% | 0 | 66 | -| library/asyncio-graph.po | 0.0% | 0.0% | 0 | 32 | -| library/asyncio-llapi-index.po | 0.0% | 0.0% | 0 | 238 | -| library/asyncio-platforms.po | 0.0% | 0.0% | 0 | 27 | -| library/asyncio-policy.po | 0.0% | 0.0% | 0 | 36 | -| library/asyncio-protocol.po | 0.0% | 0.0% | 0 | 194 | -| library/asyncio-queue.po | 0.0% | 0.0% | 0 | 49 | -| library/asyncio-runner.po | 0.0% | 0.0% | 0 | 41 | -| library/asyncio-stream.po | 0.0% | 0.0% | 0 | 105 | -| library/asyncio-subprocess.po | 0.0% | 0.0% | 0 | 80 | -| library/asyncio-sync.po | 0.0% | 0.0% | 0 | 100 | -| library/asyncio-task.po | 0.0% | 0.0% | 0 | 277 | -| library/asyncio-threading.po | 0.0% | 0.0% | 0 | 21 | -| library/asyncio-tools.po | 0.0% | 0.0% | 0 | 22 | -| library/asyncio.po | 0.0% | 0.0% | 0 | 36 | -| library/asyncore.po | 0.0% | 0.0% | 0 | 4 | -| library/atexit.po | 0.0% | 0.0% | 0 | 22 | -| library/audioop.po | 0.0% | 0.0% | 0 | 3 | -| library/audit_events.po | 0.0% | 0.0% | 0 | 26 | -| library/base64.po | 0.0% | 0.0% | 0 | 78 | -| library/bdb.po | 0.0% | 0.0% | 0 | 119 | -| library/binary.po | 0.0% | 0.0% | 0 | 4 | -| library/binascii.po | 0.0% | 0.0% | 0 | 38 | -| library/bisect.po | 0.0% | 0.0% | 0 | 36 | -| library/builtins.po | 0.0% | 0.0% | 0 | 9 | -| library/bz2.po | 0.0% | 0.0% | 0 | 75 | -| library/calendar.po | 0.0% | 0.0% | 0 | 117 | -| library/cgi.po | 0.0% | 0.0% | 0 | 4 | -| library/cgitb.po | 0.0% | 0.0% | 0 | 4 | -| library/chunk.po | 0.0% | 0.0% | 0 | 3 | -| library/cmath.po | 0.0% | 0.0% | 0 | 124 | -| library/cmd.po | 0.0% | 0.0% | 0 | 50 | -| library/cmdline.po | 0.0% | 0.0% | 0 | 53 | -| library/cmdlinelibs.po | 0.0% | 0.0% | 0 | 3 | -| library/code.po | 0.0% | 0.0% | 0 | 33 | -| library/codecs.po | 0.0% | 0.0% | 0 | 565 | -| library/codeop.po | 0.0% | 0.0% | 0 | 14 | -| library/collections.abc.po | 0.0% | 0.0% | 0 | 142 | -| library/collections.po | 0.0% | 0.0% | 0 | 244 | -| library/colorsys.po | 0.0% | 0.0% | 0 | 13 | -| library/compileall.po | 0.0% | 0.0% | 0 | 63 | -| library/compression.po | 0.0% | 0.0% | 0 | 7 | -| library/compression.zstd.po | 0.0% | 0.0% | 0 | 174 | -| library/concurrency.po | 0.0% | 0.0% | 0 | 3 | -| library/concurrent.futures.po | 0.0% | 0.0% | 0 | 121 | -| library/concurrent.interpreters.po | 0.0% | 0.0% | 0 | 87 | -| library/concurrent.po | 0.0% | 0.0% | 0 | 4 | -| library/configparser.po | 0.0% | 0.0% | 0 | 226 | -| library/constants.po | 0.0% | 0.0% | 0 | 22 | -| library/contextlib.po | 0.0% | 0.0% | 0 | 172 | -| library/contextvars.po | 0.0% | 0.0% | 0 | 66 | -| library/copy.po | 0.0% | 0.0% | 0 | 32 | -| library/copyreg.po | 0.0% | 0.0% | 0 | 12 | -| library/crypt.po | 0.0% | 0.0% | 0 | 4 | -| library/crypto.po | 0.0% | 0.0% | 0 | 3 | -| library/csv.po | 0.0% | 0.0% | 0 | 130 | -| library/ctypes.po | 0.0% | 0.0% | 0 | 676 | -| library/curses.ascii.po | 0.0% | 0.0% | 0 | 69 | -| library/curses.panel.po | 0.0% | 0.0% | 0 | 25 | -| library/curses.po | 0.0% | 0.0% | 0 | 503 | -| library/custominterp.po | 0.0% | 0.0% | 0 | 3 | -| library/dataclasses.po | 0.0% | 0.0% | 0 | 162 | -| library/datatypes.po | 0.0% | 0.0% | 0 | 4 | -| library/datetime.po | 0.0% | 0.0% | 0 | 658 | -| library/dbm.po | 0.0% | 0.0% | 0 | 108 | -| library/debug.po | 0.0% | 0.0% | 0 | 2 | -| library/decimal.po | 0.0% | 0.0% | 0 | 386 | -| library/development.po | 0.0% | 0.0% | 0 | 3 | -| library/devmode.po | 0.0% | 0.0% | 0 | 58 | -| library/dialog.po | 0.0% | 0.0% | 0 | 68 | -| library/difflib.po | 0.0% | 0.0% | 0 | 150 | -| library/dis.po | 0.0% | 0.0% | 0 | 414 | -| library/distribution.po | 0.0% | 0.0% | 0 | 2 | -| library/distutils.po | 0.0% | 0.0% | 0 | 3 | -| library/doctest.po | 0.0% | 0.0% | 0 | 379 | -| library/email.charset.po | 0.0% | 0.0% | 0 | 44 | -| library/email.compat32-message.po | 0.0% | 0.0% | 0 | 115 | -| library/email.contentmanager.po | 0.0% | 0.0% | 0 | 42 | -| library/email.encoders.po | 0.0% | 0.0% | 0 | 15 | -| library/email.errors.po | 0.0% | 0.0% | 0 | 26 | -| library/email.examples.po | 0.0% | 0.0% | 0 | 20 | -| library/email.generator.po | 0.0% | 0.0% | 0 | 41 | -| library/email.header.po | 0.0% | 0.0% | 0 | 46 | -| library/email.headerregistry.po | 0.0% | 0.0% | 0 | 111 | -| library/email.iterators.po | 0.0% | 0.0% | 0 | 12 | -| library/email.message.po | 0.0% | 0.0% | 0 | 111 | -| library/email.mime.po | 0.0% | 0.0% | 0 | 38 | -| library/email.parser.po | 0.0% | 0.0% | 0 | 48 | -| library/email.po | 0.0% | 0.0% | 0 | 23 | -| library/email.policy.po | 0.0% | 0.0% | 0 | 108 | -| library/email.utils.po | 0.0% | 0.0% | 0 | 36 | -| library/ensurepip.po | 0.0% | 0.0% | 0 | 40 | -| library/enum.po | 0.0% | 0.0% | 0 | 257 | -| library/errno.po | 0.0% | 0.0% | 0 | 161 | -| library/exceptions.po | 0.0% | 0.0% | 0 | 204 | -| library/faulthandler.po | 0.0% | 0.0% | 0 | 53 | -| library/fcntl.po | 0.0% | 0.0% | 0 | 54 | -| library/filecmp.po | 0.0% | 0.0% | 0 | 42 | -| library/fileformats.po | 0.0% | 0.0% | 0 | 2 | -| library/fileinput.po | 0.0% | 0.0% | 0 | 46 | -| library/filesys.po | 0.0% | 0.0% | 0 | 8 | -| library/fnmatch.po | 0.0% | 0.0% | 0 | 38 | -| library/fractions.po | 0.0% | 0.0% | 0 | 41 | -| library/frameworks.po | 0.0% | 0.0% | 0 | 5 | -| library/ftplib.po | 0.0% | 0.0% | 0 | 99 | -| library/functional.po | 0.0% | 0.0% | 0 | 3 | -| library/functools.po | 0.0% | 0.0% | 0 | 126 | -| library/gc.po | 0.0% | 0.0% | 0 | 67 | -| library/getopt.po | 0.0% | 0.0% | 0 | 37 | -| library/getpass.po | 0.0% | 0.0% | 0 | 16 | -| library/gettext.po | 0.0% | 0.0% | 0 | 129 | -| library/glob.po | 0.0% | 0.0% | 0 | 46 | -| library/graphlib.po | 0.0% | 0.0% | 0 | 40 | -| library/grp.po | 0.0% | 0.0% | 0 | 27 | -| library/gzip.po | 0.0% | 0.0% | 0 | 71 | -| library/hashlib.po | 0.0% | 0.0% | 0 | 170 | -| library/heapq.po | 0.0% | 0.0% | 0 | 73 | -| library/hmac.po | 0.0% | 0.0% | 0 | 27 | -| library/html.entities.po | 0.0% | 0.0% | 0 | 9 | -| library/html.parser.po | 0.0% | 0.0% | 0 | 64 | -| library/html.po | 0.0% | 0.0% | 0 | 8 | -| library/http.client.po | 0.0% | 0.0% | 0 | 118 | -| library/http.cookiejar.po | 0.0% | 0.0% | 0 | 159 | -| library/http.cookies.po | 0.0% | 0.0% | 0 | 52 | -| library/http.po | 0.0% | 0.0% | 0 | 247 | -| library/http.server.po | 0.0% | 0.0% | 0 | 141 | -| library/i18n.po | 0.0% | 0.0% | 0 | 3 | -| library/idle.po | 0.0% | 0.0% | 0 | 297 | -| library/imaplib.po | 0.0% | 0.0% | 0 | 134 | -| library/imghdr.po | 0.0% | 0.0% | 0 | 4 | -| library/imp.po | 0.0% | 0.0% | 0 | 4 | -| library/importlib.metadata.po | 0.0% | 0.0% | 0 | 120 | -| library/importlib.po | 0.0% | 0.0% | 0 | 284 | -| library/importlib.resources.abc.po | 0.0% | 0.0% | 0 | 37 | -| library/importlib.resources.po | 0.0% | 0.0% | 0 | 53 | -| library/index.po | 0.0% | 0.0% | 0 | 5 | -| library/inspect.po | 0.0% | 0.0% | 0 | 420 | -| library/internet.po | 0.0% | 0.0% | 0 | 7 | -| library/intro.po | 0.0% | 0.0% | 0 | 32 | -| library/io.po | 0.0% | 0.0% | 0 | 289 | -| library/ipaddress.po | 0.0% | 0.0% | 0 | 168 | -| library/ipc.po | 0.0% | 0.0% | 0 | 4 | -| library/itertools.po | 0.0% | 0.0% | 0 | 198 | -| library/keyword.po | 0.0% | 0.0% | 0 | 7 | -| library/language.po | 0.0% | 0.0% | 0 | 3 | -| library/linecache.po | 0.0% | 0.0% | 0 | 17 | -| library/locale.po | 0.0% | 0.0% | 0 | 163 | -| library/logging.config.po | 0.0% | 0.0% | 0 | 171 | -| library/logging.handlers.po | 0.0% | 0.0% | 0 | 276 | -| library/logging.po | 0.0% | 0.0% | 0 | 372 | -| library/lzma.po | 0.0% | 0.0% | 0 | 128 | -| library/mailbox.po | 0.0% | 0.0% | 0 | 307 | -| library/mailcap.po | 0.0% | 0.0% | 0 | 3 | -| library/markup.po | 0.0% | 0.0% | 0 | 2 | -| library/marshal.po | 0.0% | 0.0% | 0 | 56 | -| library/math.po | 0.0% | 0.0% | 0 | 268 | -| library/mimetypes.po | 0.0% | 0.0% | 0 | 68 | -| library/mm.po | 0.0% | 0.0% | 0 | 2 | -| library/mmap.po | 0.0% | 0.0% | 0 | 65 | -| library/modulefinder.po | 0.0% | 0.0% | 0 | 16 | -| library/modules.po | 0.0% | 0.0% | 0 | 3 | -| library/msilib.po | 0.0% | 0.0% | 0 | 3 | -| library/msvcrt.po | 0.0% | 0.0% | 0 | 47 | -| library/multiprocessing.po | 0.0% | 0.0% | 0 | 620 | -| library/multiprocessing.shared_memory.po | 0.0% | 0.0% | 0 | 56 | -| library/netdata.po | 0.0% | 0.0% | 0 | 2 | -| library/netrc.po | 0.0% | 0.0% | 0 | 19 | -| library/nis.po | 0.0% | 0.0% | 0 | 3 | -| library/nntplib.po | 0.0% | 0.0% | 0 | 3 | -| library/numbers.po | 0.0% | 0.0% | 0 | 34 | -| library/numeric.po | 0.0% | 0.0% | 0 | 3 | -| library/operator.po | 0.0% | 0.0% | 0 | 189 | -| library/optparse.po | 0.0% | 0.0% | 0 | 532 | -| library/os.path.po | 0.0% | 0.0% | 0 | 110 | -| library/os.po | 0.0% | 0.0% | 0 | 1075 | -| library/ossaudiodev.po | 0.0% | 0.0% | 0 | 3 | -| library/pathlib.po | 0.0% | 0.0% | 0 | 445 | -| library/pdb.po | 0.0% | 0.0% | 0 | 179 | -| library/persistence.po | 0.0% | 0.0% | 0 | 3 | -| library/pickle.po | 0.0% | 0.0% | 0 | 251 | -| library/pickletools.po | 0.0% | 0.0% | 0 | 19 | -| library/pipes.po | 0.0% | 0.0% | 0 | 4 | -| library/pkgutil.po | 0.0% | 0.0% | 0 | 49 | -| library/platform.po | 0.0% | 0.0% | 0 | 89 | -| library/plistlib.po | 0.0% | 0.0% | 0 | 51 | -| library/poplib.po | 0.0% | 0.0% | 0 | 53 | -| library/posix.po | 0.0% | 0.0% | 0 | 21 | -| library/pprint.po | 0.0% | 0.0% | 0 | 50 | -| library/profile.po | 0.0% | 0.0% | 0 | 181 | -| library/pty.po | 0.0% | 0.0% | 0 | 21 | -| library/pwd.po | 0.0% | 0.0% | 0 | 36 | -| library/py_compile.po | 0.0% | 0.0% | 0 | 30 | -| library/pyclbr.po | 0.0% | 0.0% | 0 | 26 | -| library/pydoc.po | 0.0% | 0.0% | 0 | 25 | -| library/pyexpat.po | 0.0% | 0.0% | 0 | 165 | -| library/python.po | 0.0% | 0.0% | 0 | 3 | -| library/queue.po | 0.0% | 0.0% | 0 | 58 | -| library/quopri.po | 0.0% | 0.0% | 0 | 13 | -| library/random.po | 0.0% | 0.0% | 0 | 138 | -| library/re.po | 0.0% | 0.0% | 0 | 445 | -| library/readline.po | 0.0% | 0.0% | 0 | 59 | -| library/removed.po | 0.0% | 0.0% | 0 | 2 | -| library/reprlib.po | 0.0% | 0.0% | 0 | 39 | -| library/resource.po | 0.0% | 0.0% | 0 | 110 | -| library/rlcompleter.po | 0.0% | 0.0% | 0 | 13 | -| library/runpy.po | 0.0% | 0.0% | 0 | 40 | -| library/sched.po | 0.0% | 0.0% | 0 | 25 | -| library/secrets.po | 0.0% | 0.0% | 0 | 39 | -| library/security_warnings.po | 0.0% | 0.0% | 0 | 17 | -| library/select.po | 0.0% | 0.0% | 0 | 209 | -| library/selectors.po | 0.0% | 0.0% | 0 | 58 | -| library/shelve.po | 0.0% | 0.0% | 0 | 40 | -| library/shlex.po | 0.0% | 0.0% | 0 | 77 | -| library/shutil.po | 0.0% | 0.0% | 0 | 194 | -| library/signal.po | 0.0% | 0.0% | 0 | 143 | -| library/site.po | 0.0% | 0.0% | 0 | 61 | -| library/smtpd.po | 0.0% | 0.0% | 0 | 4 | -| library/smtplib.po | 0.0% | 0.0% | 0 | 124 | -| library/sndhdr.po | 0.0% | 0.0% | 0 | 4 | -| library/socket.po | 0.0% | 0.0% | 0 | 385 | -| library/socketserver.po | 0.0% | 0.0% | 0 | 99 | -| library/spwd.po | 0.0% | 0.0% | 0 | 4 | -| library/sqlite3.po | 0.0% | 0.0% | 0 | 480 | -| library/ssl.po | 0.0% | 0.0% | 0 | 547 | -| library/stat.po | 0.0% | 0.0% | 0 | 92 | -| library/statistics.po | 0.0% | 0.0% | 0 | 248 | -| library/stdtypes.po | 0.0% | 0.0% | 0 | 1582 | -| library/string.po | 0.0% | 0.0% | 0 | 224 | -| library/string.templatelib.po | 0.0% | 0.0% | 0 | 56 | -| library/stringprep.po | 0.0% | 0.0% | 0 | 25 | -| library/struct.po | 0.0% | 0.0% | 0 | 205 | -| library/subprocess.po | 0.0% | 0.0% | 0 | 314 | -| library/sunau.po | 0.0% | 0.0% | 0 | 3 | -| library/superseded.po | 0.0% | 0.0% | 0 | 4 | -| library/symtable.po | 0.0% | 0.0% | 0 | 73 | -| library/sys.monitoring.po | 0.0% | 0.0% | 0 | 119 | -| library/sys.po | 0.0% | 0.0% | 0 | 478 | -| library/sys_path_init.po | 0.0% | 0.0% | 0 | 27 | -| library/sysconfig.po | 0.0% | 0.0% | 0 | 136 | -| library/syslog.po | 0.0% | 0.0% | 0 | 31 | -| library/tabnanny.po | 0.0% | 0.0% | 0 | 11 | -| library/tarfile.po | 0.0% | 0.0% | 0 | 363 | -| library/telnetlib.po | 0.0% | 0.0% | 0 | 4 | -| library/tempfile.po | 0.0% | 0.0% | 0 | 88 | -| library/termios.po | 0.0% | 0.0% | 0 | 25 | -| library/test.po | 0.0% | 0.0% | 0 | 337 | -| library/text.po | 0.0% | 0.0% | 0 | 3 | -| library/textwrap.po | 0.0% | 0.0% | 0 | 58 | -| library/threading.po | 0.0% | 0.0% | 0 | 284 | -| library/threadsafety.po | 0.0% | 0.0% | 0 | 122 | -| library/time.po | 0.0% | 0.0% | 0 | 280 | -| library/timeit.po | 0.0% | 0.0% | 0 | 68 | -| library/tk.po | 0.0% | 0.0% | 0 | 8 | -| library/tkinter.colorchooser.po | 0.0% | 0.0% | 0 | 8 | -| library/tkinter.dnd.po | 0.0% | 0.0% | 0 | 20 | -| library/tkinter.font.po | 0.0% | 0.0% | 0 | 37 | -| library/tkinter.messagebox.po | 0.0% | 0.0% | 0 | 43 | -| library/tkinter.po | 0.0% | 0.0% | 0 | 1236 | -| library/tkinter.scrolledtext.po | 0.0% | 0.0% | 0 | 7 | -| library/tkinter.ttk.po | 0.0% | 0.0% | 0 | 476 | -| library/token.po | 0.0% | 0.0% | 0 | 100 | -| library/tokenize.po | 0.0% | 0.0% | 0 | 52 | -| library/tomllib.po | 0.0% | 0.0% | 0 | 52 | -| library/trace.po | 0.0% | 0.0% | 0 | 43 | -| library/traceback.po | 0.0% | 0.0% | 0 | 118 | -| library/tracemalloc.po | 0.0% | 0.0% | 0 | 156 | -| library/tty.po | 0.0% | 0.0% | 0 | 17 | -| library/turtle.po | 0.0% | 0.0% | 0 | 691 | -| library/types.po | 0.0% | 0.0% | 0 | 105 | -| library/typing.po | 0.0% | 0.0% | 0 | 833 | -| library/unicodedata.po | 0.0% | 0.0% | 0 | 43 | -| library/unittest.mock-examples.po | 0.0% | 0.0% | 0 | 182 | -| library/unittest.mock.po | 0.0% | 0.0% | 0 | 448 | -| library/unittest.po | 0.0% | 0.0% | 0 | 560 | -| library/unix.po | 0.0% | 0.0% | 0 | 2 | -| library/urllib.error.po | 0.0% | 0.0% | 0 | 15 | -| library/urllib.parse.po | 0.0% | 0.0% | 0 | 169 | -| library/urllib.po | 0.0% | 0.0% | 0 | 7 | -| library/urllib.request.po | 0.0% | 0.0% | 0 | 295 | -| library/urllib.robotparser.po | 0.0% | 0.0% | 0 | 19 | -| library/uu.po | 0.0% | 0.0% | 0 | 4 | -| library/uuid.po | 0.0% | 0.0% | 0 | 79 | -| library/venv.po | 0.0% | 0.0% | 0 | 137 | -| library/warnings.po | 0.0% | 0.0% | 0 | 160 | -| library/wave.po | 0.0% | 0.0% | 0 | 61 | -| library/weakref.po | 0.0% | 0.0% | 0 | 96 | -| library/webbrowser.po | 0.0% | 0.0% | 0 | 90 | -| library/windows.po | 0.0% | 0.0% | 0 | 2 | -| library/winreg.po | 0.0% | 0.0% | 0 | 176 | -| library/winsound.po | 0.0% | 0.0% | 0 | 40 | -| library/wsgiref.po | 0.0% | 0.0% | 0 | 135 | -| library/xdrlib.po | 0.0% | 0.0% | 0 | 3 | -| library/xml.dom.minidom.po | 0.0% | 0.0% | 0 | 56 | -| library/xml.dom.po | 0.0% | 0.0% | 0 | 235 | -| library/xml.dom.pulldom.po | 0.0% | 0.0% | 0 | 30 | -| library/xml.etree.elementtree.po | 0.0% | 0.0% | 0 | 266 | -| library/xml.po | 0.0% | 0.0% | 0 | 27 | -| library/xml.sax.handler.po | 0.0% | 0.0% | 0 | 104 | -| library/xml.sax.po | 0.0% | 0.0% | 0 | 32 | -| library/xml.sax.reader.po | 0.0% | 0.0% | 0 | 75 | -| library/xml.sax.utils.po | 0.0% | 0.0% | 0 | 15 | -| library/xmlrpc.client.po | 0.0% | 0.0% | 0 | 113 | -| library/xmlrpc.po | 0.0% | 0.0% | 0 | 5 | -| library/xmlrpc.server.po | 0.0% | 0.0% | 0 | 57 | -| library/zipapp.po | 0.0% | 0.0% | 0 | 77 | -| library/zipfile.po | 0.0% | 0.0% | 0 | 216 | -| library/zipimport.po | 0.0% | 0.0% | 0 | 39 | -| library/zlib.po | 0.0% | 0.0% | 0 | 96 | -| library/zoneinfo.po | 0.0% | 0.0% | 0 | 84 | -| license.po | 0.0% | 0.0% | 0 | 129 | -| reference/compound_stmts.po | 0.0% | 0.0% | 0 | 480 | -| reference/datamodel.po | 0.0% | 0.0% | 0 | 913 | -| reference/executionmodel.po | 0.0% | 0.0% | 0 | 145 | -| reference/expressions.po | 0.0% | 0.0% | 0 | 595 | -| reference/grammar.po | 0.0% | 0.0% | 0 | 7 | -| reference/import.po | 0.0% | 0.0% | 0 | 202 | -| reference/index.po | 0.0% | 0.0% | 0 | 2 | -| reference/introduction.po | 0.0% | 0.0% | 0 | 56 | -| reference/lexical_analysis.po | 0.0% | 0.0% | 0 | 476 | -| reference/simple_stmts.po | 0.0% | 0.0% | 0 | 291 | -| reference/toplevel_components.po | 0.0% | 0.0% | 0 | 32 | -| using/android.po | 0.0% | 0.0% | 0 | 27 | -| using/cmdline.po | 0.0% | 0.0% | 0 | 265 | -| using/configure.po | 0.0% | 0.0% | 0 | 468 | -| using/editors.po | 0.0% | 0.0% | 0 | 6 | -| using/index.po | 0.0% | 0.0% | 0 | 2 | -| using/ios.po | 0.0% | 0.0% | 0 | 91 | -| using/mac.po | 0.0% | 0.0% | 0 | 94 | -| using/unix.po | 0.0% | 0.0% | 0 | 63 | -| using/windows.po | 0.0% | 0.0% | 0 | 576 | -| whatsnew/2.0.po | 0.0% | 0.0% | 0 | 207 | -| whatsnew/2.1.po | 0.0% | 0.0% | 0 | 154 | -| whatsnew/2.2.po | 0.0% | 0.0% | 0 | 216 | -| whatsnew/2.3.po | 0.0% | 0.0% | 0 | 387 | -| whatsnew/2.4.po | 0.0% | 0.0% | 0 | 319 | -| whatsnew/2.5.po | 0.0% | 0.0% | 0 | 452 | -| whatsnew/2.6.po | 0.0% | 0.0% | 0 | 626 | -| whatsnew/2.7.po | 0.0% | 0.0% | 0 | 498 | -| whatsnew/3.0.po | 0.0% | 0.0% | 0 | 212 | -| whatsnew/3.1.po | 0.0% | 0.0% | 0 | 132 | -| whatsnew/3.10.po | 0.0% | 0.0% | 0 | 550 | -| whatsnew/3.11.po | 0.0% | 0.0% | 0 | 776 | -| whatsnew/3.12.po | 0.0% | 0.0% | 0 | 856 | -| whatsnew/3.13.po | 0.0% | 0.0% | 0 | 933 | -| whatsnew/3.14.po | 0.0% | 0.0% | 0 | 1054 | -| whatsnew/3.2.po | 0.0% | 0.0% | 0 | 576 | -| whatsnew/3.3.po | 0.0% | 0.0% | 0 | 682 | -| whatsnew/3.4.po | 0.0% | 0.0% | 0 | 517 | -| whatsnew/3.5.po | 0.0% | 0.0% | 0 | 578 | -| whatsnew/3.6.po | 0.0% | 0.0% | 0 | 544 | -| whatsnew/3.7.po | 0.0% | 0.0% | 0 | 568 | -| whatsnew/3.8.po | 0.0% | 0.0% | 0 | 513 | -| whatsnew/3.9.po | 0.0% | 0.0% | 0 | 380 | -| whatsnew/changelog.po | 0.0% | 0.0% | 0 | 1 | -| whatsnew/index.po | 0.0% | 0.0% | 0 | 3 | -| **مجموع** | **3.9%** | **0.0%** | **2706** | **67536** | +| File | Translated | Fuzzy | +|:-----|:-----------:|:-----------:| +| about.po | 100.0% | 0.0% | +| bugs.po | 100.0% | 0.0% | +| c-api/abstract.po | 100.0% | 0.0% | +| c-api/allocation.po | 100.0% | 0.0% | +| c-api/apiabiversion.po | 100.0% | 0.0% | +| c-api/bool.po | 100.0% | 0.0% | +| c-api/bytearray.po | 100.0% | 0.0% | +| contents.po | 100.0% | 0.0% | +| copyright.po | 100.0% | 0.0% | +| improve-page-nojs.po | 100.0% | 0.0% | +| improve-page.po | 100.0% | 0.0% | +| library/__future__.po | 100.0% | 0.0% | +| library/functions.po | 100.0% | 0.0% | +| sphinx.po | 100.0% | 0.0% | +| tutorial/appendix.po | 100.0% | 0.0% | +| tutorial/appetite.po | 100.0% | 0.0% | +| tutorial/classes.po | 100.0% | 0.0% | +| tutorial/controlflow.po | 100.0% | 0.0% | +| tutorial/datastructures.po | 100.0% | 0.0% | +| tutorial/errors.po | 100.0% | 0.0% | +| tutorial/floatingpoint.po | 100.0% | 0.0% | +| tutorial/index.po | 100.0% | 0.0% | +| tutorial/inputoutput.po | 100.0% | 0.0% | +| tutorial/interactive.po | 100.0% | 0.0% | +| tutorial/interpreter.po | 100.0% | 0.0% | +| tutorial/introduction.po | 100.0% | 0.0% | +| tutorial/modules.po | 100.0% | 0.0% | +| tutorial/stdlib.po | 100.0% | 0.0% | +| tutorial/stdlib2.po | 100.0% | 0.0% | +| tutorial/venv.po | 100.0% | 0.0% | +| tutorial/whatnow.po | 100.0% | 0.0% | +| library/__main__.po | 13.9% | 0.0% | +| c-api/dict.po | 2.8% | 0.0% | +| library/json.po | 1.1% | 0.0% | +| c-api/arg.po | 0.0% | 0.0% | +| c-api/buffer.po | 0.0% | 0.0% | +| c-api/bytes.po | 0.0% | 0.0% | +| c-api/call.po | 0.0% | 0.0% | +| c-api/capsule.po | 0.0% | 0.0% | +| c-api/cell.po | 0.0% | 0.0% | +| c-api/code.po | 0.0% | 0.0% | +| c-api/codec.po | 0.0% | 0.0% | +| c-api/complex.po | 0.0% | 0.0% | +| c-api/concrete.po | 0.0% | 0.0% | +| c-api/contextvars.po | 0.0% | 0.0% | +| c-api/conversion.po | 0.0% | 0.0% | +| c-api/coro.po | 0.0% | 0.0% | +| c-api/curses.po | 0.0% | 0.0% | +| c-api/datetime.po | 0.0% | 0.0% | +| c-api/descriptor.po | 0.0% | 0.0% | +| c-api/exceptions.po | 0.0% | 0.0% | +| c-api/extension-modules.po | 0.0% | 0.0% | +| c-api/file.po | 0.0% | 0.0% | +| c-api/float.po | 0.0% | 0.0% | +| c-api/frame.po | 0.0% | 0.0% | +| c-api/function.po | 0.0% | 0.0% | +| c-api/gcsupport.po | 0.0% | 0.0% | +| c-api/gen.po | 0.0% | 0.0% | +| c-api/hash.po | 0.0% | 0.0% | +| c-api/import.po | 0.0% | 0.0% | +| c-api/index.po | 0.0% | 0.0% | +| c-api/init.po | 0.0% | 0.0% | +| c-api/init_config.po | 0.0% | 0.0% | +| c-api/interp-lifecycle.po | 0.0% | 0.0% | +| c-api/intro.po | 0.0% | 0.0% | +| c-api/iter.po | 0.0% | 0.0% | +| c-api/iterator.po | 0.0% | 0.0% | +| c-api/lifecycle.po | 0.0% | 0.0% | +| c-api/list.po | 0.0% | 0.0% | +| c-api/long.po | 0.0% | 0.0% | +| c-api/mapping.po | 0.0% | 0.0% | +| c-api/marshal.po | 0.0% | 0.0% | +| c-api/memory.po | 0.0% | 0.0% | +| c-api/memoryview.po | 0.0% | 0.0% | +| c-api/method.po | 0.0% | 0.0% | +| c-api/module.po | 0.0% | 0.0% | +| c-api/monitoring.po | 0.0% | 0.0% | +| c-api/none.po | 0.0% | 0.0% | +| c-api/number.po | 0.0% | 0.0% | +| c-api/object.po | 0.0% | 0.0% | +| c-api/objimpl.po | 0.0% | 0.0% | +| c-api/perfmaps.po | 0.0% | 0.0% | +| c-api/picklebuffer.po | 0.0% | 0.0% | +| c-api/profiling.po | 0.0% | 0.0% | +| c-api/refcounting.po | 0.0% | 0.0% | +| c-api/reflection.po | 0.0% | 0.0% | +| c-api/sequence.po | 0.0% | 0.0% | +| c-api/set.po | 0.0% | 0.0% | +| c-api/slice.po | 0.0% | 0.0% | +| c-api/stable.po | 0.0% | 0.0% | +| c-api/structures.po | 0.0% | 0.0% | +| c-api/subinterpreters.po | 0.0% | 0.0% | +| c-api/synchronization.po | 0.0% | 0.0% | +| c-api/sys.po | 0.0% | 0.0% | +| c-api/threads.po | 0.0% | 0.0% | +| c-api/time.po | 0.0% | 0.0% | +| c-api/tls.po | 0.0% | 0.0% | +| c-api/tuple.po | 0.0% | 0.0% | +| c-api/type.po | 0.0% | 0.0% | +| c-api/typehints.po | 0.0% | 0.0% | +| c-api/typeobj.po | 0.0% | 0.0% | +| c-api/unicode.po | 0.0% | 0.0% | +| c-api/utilities.po | 0.0% | 0.0% | +| c-api/veryhigh.po | 0.0% | 0.0% | +| c-api/weakref.po | 0.0% | 0.0% | +| deprecations/c-api-pending-removal-in-3.14.po | 0.0% | 0.0% | +| deprecations/c-api-pending-removal-in-3.15.po | 0.0% | 0.0% | +| deprecations/c-api-pending-removal-in-3.16.po | 0.0% | 0.0% | +| deprecations/c-api-pending-removal-in-3.18.po | 0.0% | 0.0% | +| deprecations/c-api-pending-removal-in-future.po | 0.0% | 0.0% | +| deprecations/index.po | 0.0% | 0.0% | +| deprecations/pending-removal-in-3.13.po | 0.0% | 0.0% | +| deprecations/pending-removal-in-3.14.po | 0.0% | 0.0% | +| deprecations/pending-removal-in-3.15.po | 0.0% | 0.0% | +| deprecations/pending-removal-in-3.16.po | 0.0% | 0.0% | +| deprecations/pending-removal-in-3.17.po | 0.0% | 0.0% | +| deprecations/pending-removal-in-3.18.po | 0.0% | 0.0% | +| deprecations/pending-removal-in-3.19.po | 0.0% | 0.0% | +| deprecations/pending-removal-in-future.po | 0.0% | 0.0% | +| distributing/index.po | 0.0% | 0.0% | +| extending/building.po | 0.0% | 0.0% | +| extending/embedding.po | 0.0% | 0.0% | +| extending/extending.po | 0.0% | 0.0% | +| extending/index.po | 0.0% | 0.0% | +| extending/newtypes.po | 0.0% | 0.0% | +| extending/newtypes_tutorial.po | 0.0% | 0.0% | +| extending/windows.po | 0.0% | 0.0% | +| faq/design.po | 0.0% | 0.0% | +| faq/extending.po | 0.0% | 0.0% | +| faq/general.po | 0.0% | 0.0% | +| faq/gui.po | 0.0% | 0.0% | +| faq/index.po | 0.0% | 0.0% | +| faq/installed.po | 0.0% | 0.0% | +| faq/library.po | 0.0% | 0.0% | +| faq/programming.po | 0.0% | 0.0% | +| faq/windows.po | 0.0% | 0.0% | +| glossary.po | 0.0% | 0.0% | +| howto/a-conceptual-overview-of-asyncio.po | 0.0% | 0.0% | +| howto/annotations.po | 0.0% | 0.0% | +| howto/argparse-optparse.po | 0.0% | 0.0% | +| howto/argparse.po | 0.0% | 0.0% | +| howto/clinic.po | 0.0% | 0.0% | +| howto/cporting.po | 0.0% | 0.0% | +| howto/curses.po | 0.0% | 0.0% | +| howto/descriptor.po | 0.0% | 0.0% | +| howto/enum.po | 0.0% | 0.0% | +| howto/free-threading-extensions.po | 0.0% | 0.0% | +| howto/free-threading-python.po | 0.0% | 0.0% | +| howto/functional.po | 0.0% | 0.0% | +| howto/gdb_helpers.po | 0.0% | 0.0% | +| howto/index.po | 0.0% | 0.0% | +| howto/instrumentation.po | 0.0% | 0.0% | +| howto/ipaddress.po | 0.0% | 0.0% | +| howto/isolating-extensions.po | 0.0% | 0.0% | +| howto/logging-cookbook.po | 0.0% | 0.0% | +| howto/logging.po | 0.0% | 0.0% | +| howto/mro.po | 0.0% | 0.0% | +| howto/perf_profiling.po | 0.0% | 0.0% | +| howto/pyporting.po | 0.0% | 0.0% | +| howto/regex.po | 0.0% | 0.0% | +| howto/remote_debugging.po | 0.0% | 0.0% | +| howto/sockets.po | 0.0% | 0.0% | +| howto/sorting.po | 0.0% | 0.0% | +| howto/timerfd.po | 0.0% | 0.0% | +| howto/unicode.po | 0.0% | 0.0% | +| howto/urllib2.po | 0.0% | 0.0% | +| installing/index.po | 0.0% | 0.0% | +| library/_thread.po | 0.0% | 0.0% | +| library/abc.po | 0.0% | 0.0% | +| library/aifc.po | 0.0% | 0.0% | +| library/allos.po | 0.0% | 0.0% | +| library/annotationlib.po | 0.0% | 0.0% | +| library/archiving.po | 0.0% | 0.0% | +| library/argparse.po | 0.0% | 0.0% | +| library/array.po | 0.0% | 0.0% | +| library/ast.po | 0.0% | 0.0% | +| library/asynchat.po | 0.0% | 0.0% | +| library/asyncio-api-index.po | 0.0% | 0.0% | +| library/asyncio-dev.po | 0.0% | 0.0% | +| library/asyncio-eventloop.po | 0.0% | 0.0% | +| library/asyncio-exceptions.po | 0.0% | 0.0% | +| library/asyncio-extending.po | 0.0% | 0.0% | +| library/asyncio-future.po | 0.0% | 0.0% | +| library/asyncio-graph.po | 0.0% | 0.0% | +| library/asyncio-llapi-index.po | 0.0% | 0.0% | +| library/asyncio-platforms.po | 0.0% | 0.0% | +| library/asyncio-policy.po | 0.0% | 0.0% | +| library/asyncio-protocol.po | 0.0% | 0.0% | +| library/asyncio-queue.po | 0.0% | 0.0% | +| library/asyncio-runner.po | 0.0% | 0.0% | +| library/asyncio-stream.po | 0.0% | 0.0% | +| library/asyncio-subprocess.po | 0.0% | 0.0% | +| library/asyncio-sync.po | 0.0% | 0.0% | +| library/asyncio-task.po | 0.0% | 0.0% | +| library/asyncio.po | 0.0% | 0.0% | +| library/asyncore.po | 0.0% | 0.0% | +| library/atexit.po | 0.0% | 0.0% | +| library/audioop.po | 0.0% | 0.0% | +| library/audit_events.po | 0.0% | 0.0% | +| library/base64.po | 0.0% | 0.0% | +| library/bdb.po | 0.0% | 0.0% | +| library/binary.po | 0.0% | 0.0% | +| library/binascii.po | 0.0% | 0.0% | +| library/bisect.po | 0.0% | 0.0% | +| library/builtins.po | 0.0% | 0.0% | +| library/bz2.po | 0.0% | 0.0% | +| library/calendar.po | 0.0% | 0.0% | +| library/cgi.po | 0.0% | 0.0% | +| library/cgitb.po | 0.0% | 0.0% | +| library/chunk.po | 0.0% | 0.0% | +| library/cmath.po | 0.0% | 0.0% | +| library/cmd.po | 0.0% | 0.0% | +| library/cmdline.po | 0.0% | 0.0% | +| library/cmdlinelibs.po | 0.0% | 0.0% | +| library/code.po | 0.0% | 0.0% | +| library/codecs.po | 0.0% | 0.0% | +| library/codeop.po | 0.0% | 0.0% | +| library/collections.abc.po | 0.0% | 0.0% | +| library/collections.po | 0.0% | 0.0% | +| library/colorsys.po | 0.0% | 0.0% | +| library/compileall.po | 0.0% | 0.0% | +| library/compression.po | 0.0% | 0.0% | +| library/compression.zstd.po | 0.0% | 0.0% | +| library/concurrency.po | 0.0% | 0.0% | +| library/concurrent.futures.po | 0.0% | 0.0% | +| library/concurrent.interpreters.po | 0.0% | 0.0% | +| library/concurrent.po | 0.0% | 0.0% | +| library/configparser.po | 0.0% | 0.0% | +| library/constants.po | 0.0% | 0.0% | +| library/contextlib.po | 0.0% | 0.0% | +| library/contextvars.po | 0.0% | 0.0% | +| library/copy.po | 0.0% | 0.0% | +| library/copyreg.po | 0.0% | 0.0% | +| library/crypt.po | 0.0% | 0.0% | +| library/crypto.po | 0.0% | 0.0% | +| library/csv.po | 0.0% | 0.0% | +| library/ctypes.po | 0.0% | 0.0% | +| library/curses.ascii.po | 0.0% | 0.0% | +| library/curses.panel.po | 0.0% | 0.0% | +| library/curses.po | 0.0% | 0.0% | +| library/custominterp.po | 0.0% | 0.0% | +| library/dataclasses.po | 0.0% | 0.0% | +| library/datatypes.po | 0.0% | 0.0% | +| library/datetime.po | 0.0% | 0.0% | +| library/dbm.po | 0.0% | 0.0% | +| library/debug.po | 0.0% | 0.0% | +| library/decimal.po | 0.0% | 0.0% | +| library/development.po | 0.0% | 0.0% | +| library/devmode.po | 0.0% | 0.0% | +| library/dialog.po | 0.0% | 0.0% | +| library/difflib.po | 0.0% | 0.0% | +| library/dis.po | 0.0% | 0.0% | +| library/distribution.po | 0.0% | 0.0% | +| library/distutils.po | 0.0% | 0.0% | +| library/doctest.po | 0.0% | 0.0% | +| library/email.charset.po | 0.0% | 0.0% | +| library/email.compat32-message.po | 0.0% | 0.0% | +| library/email.contentmanager.po | 0.0% | 0.0% | +| library/email.encoders.po | 0.0% | 0.0% | +| library/email.errors.po | 0.0% | 0.0% | +| library/email.examples.po | 0.0% | 0.0% | +| library/email.generator.po | 0.0% | 0.0% | +| library/email.header.po | 0.0% | 0.0% | +| library/email.headerregistry.po | 0.0% | 0.0% | +| library/email.iterators.po | 0.0% | 0.0% | +| library/email.message.po | 0.0% | 0.0% | +| library/email.mime.po | 0.0% | 0.0% | +| library/email.parser.po | 0.0% | 0.0% | +| library/email.po | 0.0% | 0.0% | +| library/email.policy.po | 0.0% | 0.0% | +| library/email.utils.po | 0.0% | 0.0% | +| library/ensurepip.po | 0.0% | 0.0% | +| library/enum.po | 0.0% | 0.0% | +| library/errno.po | 0.0% | 0.0% | +| library/exceptions.po | 0.0% | 0.0% | +| library/faulthandler.po | 0.0% | 0.0% | +| library/fcntl.po | 0.0% | 0.0% | +| library/filecmp.po | 0.0% | 0.0% | +| library/fileformats.po | 0.0% | 0.0% | +| library/fileinput.po | 0.0% | 0.0% | +| library/filesys.po | 0.0% | 0.0% | +| library/fnmatch.po | 0.0% | 0.0% | +| library/fractions.po | 0.0% | 0.0% | +| library/frameworks.po | 0.0% | 0.0% | +| library/ftplib.po | 0.0% | 0.0% | +| library/functional.po | 0.0% | 0.0% | +| library/functools.po | 0.0% | 0.0% | +| library/gc.po | 0.0% | 0.0% | +| library/getopt.po | 0.0% | 0.0% | +| library/getpass.po | 0.0% | 0.0% | +| library/gettext.po | 0.0% | 0.0% | +| library/glob.po | 0.0% | 0.0% | +| library/graphlib.po | 0.0% | 0.0% | +| library/grp.po | 0.0% | 0.0% | +| library/gzip.po | 0.0% | 0.0% | +| library/hashlib.po | 0.0% | 0.0% | +| library/heapq.po | 0.0% | 0.0% | +| library/hmac.po | 0.0% | 0.0% | +| library/html.entities.po | 0.0% | 0.0% | +| library/html.parser.po | 0.0% | 0.0% | +| library/html.po | 0.0% | 0.0% | +| library/http.client.po | 0.0% | 0.0% | +| library/http.cookiejar.po | 0.0% | 0.0% | +| library/http.cookies.po | 0.0% | 0.0% | +| library/http.po | 0.0% | 0.0% | +| library/http.server.po | 0.0% | 0.0% | +| library/i18n.po | 0.0% | 0.0% | +| library/idle.po | 0.0% | 0.0% | +| library/imaplib.po | 0.0% | 0.0% | +| library/imghdr.po | 0.0% | 0.0% | +| library/imp.po | 0.0% | 0.0% | +| library/importlib.metadata.po | 0.0% | 0.0% | +| library/importlib.po | 0.0% | 0.0% | +| library/importlib.resources.abc.po | 0.0% | 0.0% | +| library/importlib.resources.po | 0.0% | 0.0% | +| library/index.po | 0.0% | 0.0% | +| library/inspect.po | 0.0% | 0.0% | +| library/internet.po | 0.0% | 0.0% | +| library/intro.po | 0.0% | 0.0% | +| library/io.po | 0.0% | 0.0% | +| library/ipaddress.po | 0.0% | 0.0% | +| library/ipc.po | 0.0% | 0.0% | +| library/itertools.po | 0.0% | 0.0% | +| library/keyword.po | 0.0% | 0.0% | +| library/language.po | 0.0% | 0.0% | +| library/linecache.po | 0.0% | 0.0% | +| library/locale.po | 0.0% | 0.0% | +| library/logging.config.po | 0.0% | 0.0% | +| library/logging.handlers.po | 0.0% | 0.0% | +| library/logging.po | 0.0% | 0.0% | +| library/lzma.po | 0.0% | 0.0% | +| library/mailbox.po | 0.0% | 0.0% | +| library/mailcap.po | 0.0% | 0.0% | +| library/markup.po | 0.0% | 0.0% | +| library/marshal.po | 0.0% | 0.0% | +| library/math.po | 0.0% | 0.0% | +| library/mimetypes.po | 0.0% | 0.0% | +| library/mm.po | 0.0% | 0.0% | +| library/mmap.po | 0.0% | 0.0% | +| library/modulefinder.po | 0.0% | 0.0% | +| library/modules.po | 0.0% | 0.0% | +| library/msilib.po | 0.0% | 0.0% | +| library/msvcrt.po | 0.0% | 0.0% | +| library/multiprocessing.po | 0.0% | 0.0% | +| library/multiprocessing.shared_memory.po | 0.0% | 0.0% | +| library/netdata.po | 0.0% | 0.0% | +| library/netrc.po | 0.0% | 0.0% | +| library/nis.po | 0.0% | 0.0% | +| library/nntplib.po | 0.0% | 0.0% | +| library/numbers.po | 0.0% | 0.0% | +| library/numeric.po | 0.0% | 0.0% | +| library/operator.po | 0.0% | 0.0% | +| library/optparse.po | 0.0% | 0.0% | +| library/os.path.po | 0.0% | 0.0% | +| library/os.po | 0.0% | 0.0% | +| library/ossaudiodev.po | 0.0% | 0.0% | +| library/pathlib.po | 0.0% | 0.0% | +| library/pdb.po | 0.0% | 0.0% | +| library/persistence.po | 0.0% | 0.0% | +| library/pickle.po | 0.0% | 0.0% | +| library/pickletools.po | 0.0% | 0.0% | +| library/pipes.po | 0.0% | 0.0% | +| library/pkgutil.po | 0.0% | 0.0% | +| library/platform.po | 0.0% | 0.0% | +| library/plistlib.po | 0.0% | 0.0% | +| library/poplib.po | 0.0% | 0.0% | +| library/posix.po | 0.0% | 0.0% | +| library/pprint.po | 0.0% | 0.0% | +| library/profile.po | 0.0% | 0.0% | +| library/pty.po | 0.0% | 0.0% | +| library/pwd.po | 0.0% | 0.0% | +| library/py_compile.po | 0.0% | 0.0% | +| library/pyclbr.po | 0.0% | 0.0% | +| library/pydoc.po | 0.0% | 0.0% | +| library/pyexpat.po | 0.0% | 0.0% | +| library/python.po | 0.0% | 0.0% | +| library/queue.po | 0.0% | 0.0% | +| library/quopri.po | 0.0% | 0.0% | +| library/random.po | 0.0% | 0.0% | +| library/re.po | 0.0% | 0.0% | +| library/readline.po | 0.0% | 0.0% | +| library/removed.po | 0.0% | 0.0% | +| library/reprlib.po | 0.0% | 0.0% | +| library/resource.po | 0.0% | 0.0% | +| library/rlcompleter.po | 0.0% | 0.0% | +| library/runpy.po | 0.0% | 0.0% | +| library/sched.po | 0.0% | 0.0% | +| library/secrets.po | 0.0% | 0.0% | +| library/security_warnings.po | 0.0% | 0.0% | +| library/select.po | 0.0% | 0.0% | +| library/selectors.po | 0.0% | 0.0% | +| library/shelve.po | 0.0% | 0.0% | +| library/shlex.po | 0.0% | 0.0% | +| library/shutil.po | 0.0% | 0.0% | +| library/signal.po | 0.0% | 0.0% | +| library/site.po | 0.0% | 0.0% | +| library/smtpd.po | 0.0% | 0.0% | +| library/smtplib.po | 0.0% | 0.0% | +| library/sndhdr.po | 0.0% | 0.0% | +| library/socket.po | 0.0% | 0.0% | +| library/socketserver.po | 0.0% | 0.0% | +| library/spwd.po | 0.0% | 0.0% | +| library/sqlite3.po | 0.0% | 0.0% | +| library/ssl.po | 0.0% | 0.0% | +| library/stat.po | 0.0% | 0.0% | +| library/statistics.po | 0.0% | 0.0% | +| library/stdtypes.po | 0.0% | 0.0% | +| library/string.po | 0.0% | 0.0% | +| library/string.templatelib.po | 0.0% | 0.0% | +| library/stringprep.po | 0.0% | 0.0% | +| library/struct.po | 0.0% | 0.0% | +| library/subprocess.po | 0.0% | 0.0% | +| library/sunau.po | 0.0% | 0.0% | +| library/superseded.po | 0.0% | 0.0% | +| library/symtable.po | 0.0% | 0.0% | +| library/sys.monitoring.po | 0.0% | 0.0% | +| library/sys.po | 0.0% | 0.0% | +| library/sys_path_init.po | 0.0% | 0.0% | +| library/sysconfig.po | 0.0% | 0.0% | +| library/syslog.po | 0.0% | 0.0% | +| library/tabnanny.po | 0.0% | 0.0% | +| library/tarfile.po | 0.0% | 0.0% | +| library/telnetlib.po | 0.0% | 0.0% | +| library/tempfile.po | 0.0% | 0.0% | +| library/termios.po | 0.0% | 0.0% | +| library/test.po | 0.0% | 0.0% | +| library/text.po | 0.0% | 0.0% | +| library/textwrap.po | 0.0% | 0.0% | +| library/threading.po | 0.0% | 0.0% | +| library/threadsafety.po | 0.0% | 0.0% | +| library/time.po | 0.0% | 0.0% | +| library/timeit.po | 0.0% | 0.0% | +| library/tk.po | 0.0% | 0.0% | +| library/tkinter.colorchooser.po | 0.0% | 0.0% | +| library/tkinter.dnd.po | 0.0% | 0.0% | +| library/tkinter.font.po | 0.0% | 0.0% | +| library/tkinter.messagebox.po | 0.0% | 0.0% | +| library/tkinter.po | 0.0% | 0.0% | +| library/tkinter.scrolledtext.po | 0.0% | 0.0% | +| library/tkinter.ttk.po | 0.0% | 0.0% | +| library/token.po | 0.0% | 0.0% | +| library/tokenize.po | 0.0% | 0.0% | +| library/tomllib.po | 0.0% | 0.0% | +| library/trace.po | 0.0% | 0.0% | +| library/traceback.po | 0.0% | 0.0% | +| library/tracemalloc.po | 0.0% | 0.0% | +| library/tty.po | 0.0% | 0.0% | +| library/turtle.po | 0.0% | 0.0% | +| library/types.po | 0.0% | 0.0% | +| library/typing.po | 0.0% | 0.0% | +| library/unicodedata.po | 0.0% | 0.0% | +| library/unittest.mock-examples.po | 0.0% | 0.0% | +| library/unittest.mock.po | 0.0% | 0.0% | +| library/unittest.po | 0.0% | 0.0% | +| library/unix.po | 0.0% | 0.0% | +| library/urllib.error.po | 0.0% | 0.0% | +| library/urllib.parse.po | 0.0% | 0.0% | +| library/urllib.po | 0.0% | 0.0% | +| library/urllib.request.po | 0.0% | 0.0% | +| library/urllib.robotparser.po | 0.0% | 0.0% | +| library/uu.po | 0.0% | 0.0% | +| library/uuid.po | 0.0% | 0.0% | +| library/venv.po | 0.0% | 0.0% | +| library/warnings.po | 0.0% | 0.0% | +| library/wave.po | 0.0% | 0.0% | +| library/weakref.po | 0.0% | 0.0% | +| library/webbrowser.po | 0.0% | 0.0% | +| library/windows.po | 0.0% | 0.0% | +| library/winreg.po | 0.0% | 0.0% | +| library/winsound.po | 0.0% | 0.0% | +| library/wsgiref.po | 0.0% | 0.0% | +| library/xdrlib.po | 0.0% | 0.0% | +| library/xml.dom.minidom.po | 0.0% | 0.0% | +| library/xml.dom.po | 0.0% | 0.0% | +| library/xml.dom.pulldom.po | 0.0% | 0.0% | +| library/xml.etree.elementtree.po | 0.0% | 0.0% | +| library/xml.po | 0.0% | 0.0% | +| library/xml.sax.handler.po | 0.0% | 0.0% | +| library/xml.sax.po | 0.0% | 0.0% | +| library/xml.sax.reader.po | 0.0% | 0.0% | +| library/xml.sax.utils.po | 0.0% | 0.0% | +| library/xmlrpc.client.po | 0.0% | 0.0% | +| library/xmlrpc.po | 0.0% | 0.0% | +| library/xmlrpc.server.po | 0.0% | 0.0% | +| library/zipapp.po | 0.0% | 0.0% | +| library/zipfile.po | 0.0% | 0.0% | +| library/zipimport.po | 0.0% | 0.0% | +| library/zlib.po | 0.0% | 0.0% | +| library/zoneinfo.po | 0.0% | 0.0% | +| license.po | 0.0% | 0.0% | +| reference/compound_stmts.po | 0.0% | 0.0% | +| reference/datamodel.po | 0.0% | 0.0% | +| reference/executionmodel.po | 0.0% | 0.0% | +| reference/expressions.po | 0.0% | 0.0% | +| reference/grammar.po | 0.0% | 0.0% | +| reference/import.po | 0.0% | 0.0% | +| reference/index.po | 0.0% | 0.0% | +| reference/introduction.po | 0.0% | 0.0% | +| reference/lexical_analysis.po | 0.0% | 0.0% | +| reference/simple_stmts.po | 0.0% | 0.0% | +| reference/toplevel_components.po | 0.0% | 0.0% | +| using/android.po | 0.0% | 0.0% | +| using/cmdline.po | 0.0% | 0.0% | +| using/configure.po | 0.0% | 0.0% | +| using/editors.po | 0.0% | 0.0% | +| using/index.po | 0.0% | 0.0% | +| using/ios.po | 0.0% | 0.0% | +| using/mac.po | 0.0% | 0.0% | +| using/unix.po | 0.0% | 0.0% | +| using/windows.po | 0.0% | 0.0% | +| whatsnew/2.0.po | 0.0% | 0.0% | +| whatsnew/2.1.po | 0.0% | 0.0% | +| whatsnew/2.2.po | 0.0% | 0.0% | +| whatsnew/2.3.po | 0.0% | 0.0% | +| whatsnew/2.4.po | 0.0% | 0.0% | +| whatsnew/2.5.po | 0.0% | 0.0% | +| whatsnew/2.6.po | 0.0% | 0.0% | +| whatsnew/2.7.po | 0.0% | 0.0% | +| whatsnew/3.0.po | 0.0% | 0.0% | +| whatsnew/3.1.po | 0.0% | 0.0% | +| whatsnew/3.10.po | 0.0% | 0.0% | +| whatsnew/3.11.po | 0.0% | 0.0% | +| whatsnew/3.12.po | 0.0% | 0.0% | +| whatsnew/3.13.po | 0.0% | 0.0% | +| whatsnew/3.14.po | 0.0% | 0.0% | +| whatsnew/3.2.po | 0.0% | 0.0% | +| whatsnew/3.3.po | 0.0% | 0.0% | +| whatsnew/3.4.po | 0.0% | 0.0% | +| whatsnew/3.5.po | 0.0% | 0.0% | +| whatsnew/3.6.po | 0.0% | 0.0% | +| whatsnew/3.7.po | 0.0% | 0.0% | +| whatsnew/3.8.po | 0.0% | 0.0% | +| whatsnew/3.9.po | 0.0% | 0.0% | +| whatsnew/changelog.po | 0.0% | 0.0% | +| whatsnew/index.po | 0.0% | 0.0% | diff --git a/TEAM.md b/TEAM.md index 4b187607f..de3b3f202 100644 --- a/TEAM.md +++ b/TEAM.md @@ -1,7 +1,7 @@ | User | Role | Translated Count | |:-----|:------:|:------------------:| | Revisto | coordinator | 3984 | -| sepehr-rs | coordinator | 2210 | +| sepehr-rs | coordinator | 1630 | | danialbehzadi | reviewer | 677 | | invincible627 | translator | 358 | | khosro_o | reviewer | 63 | diff --git a/about.po b/about.po index e62834b0e..92d447c5d 100644 --- a/about.po +++ b/about.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:47+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/bugs.po b/bugs.po index 8062ab76d..8fd79f19c 100644 --- a/bugs.po +++ b/bugs.po @@ -16,10 +16,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-26 07:53+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/abstract.po b/c-api/abstract.po index 94ff5477f..9627d8c51 100644 --- a/c-api/abstract.po +++ b/c-api/abstract.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:47+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/allocation.po b/c-api/allocation.po index 753da7321..5e573f30e 100644 --- a/c-api/allocation.po +++ b/c-api/allocation.po @@ -20,10 +20,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 14:55+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/apiabiversion.po b/c-api/apiabiversion.po index b04049e8f..cb82275a4 100644 --- a/c-api/apiabiversion.po +++ b/c-api/apiabiversion.po @@ -17,10 +17,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:47+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/arg.po b/c-api/arg.po index 04a11a7b3..ca883a002 100644 --- a/c-api/arg.po +++ b/c-api/arg.po @@ -15,10 +15,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:47+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/bool.po b/c-api/bool.po index fbd7ca7e7..ccddc5deb 100644 --- a/c-api/bool.po +++ b/c-api/bool.po @@ -13,9 +13,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/buffer.po b/c-api/buffer.po index 2d11569e3..a2f555fbd 100644 --- a/c-api/buffer.po +++ b/c-api/buffer.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:47+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -177,7 +177,7 @@ msgstr "" msgid "Controls the :c:member:`~Py_buffer.readonly` field. If set, the exporter MUST provide a writable buffer or else report failure. Otherwise, the exporter MAY provide either a read-only or writable buffer, but the choice MUST be consistent for all consumers. For example, :c:expr:`PyBUF_SIMPLE | PyBUF_WRITABLE` can be used to request a simple writable buffer." msgstr "" -msgid "This is an alias to :c:macro:`PyBUF_WRITABLE`." +msgid "This is a :term:`soft deprecated` alias to :c:macro:`PyBUF_WRITABLE`." msgstr "" msgid "Controls the :c:member:`~Py_buffer.format` field. If set, this field MUST be filled in correctly. Otherwise, this field MUST be ``NULL``." diff --git a/c-api/bytearray.po b/c-api/bytearray.po index caad0d221..6ef87c5e7 100644 --- a/c-api/bytearray.po +++ b/c-api/bytearray.po @@ -15,10 +15,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:47+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/bytes.po b/c-api/bytes.po index a2e513cdf..3d969b276 100644 --- a/c-api/bytes.po +++ b/c-api/bytes.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:47+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -198,7 +198,7 @@ msgstr "" msgid "Previously, :exc:`TypeError` was raised when embedded null bytes were encountered in the bytes object." msgstr "" -msgid "Create a new bytes object in *\\*bytes* containing the contents of *newpart* appended to *bytes*; the caller will own the new reference. The reference to the old value of *bytes* will be \":term:`stolen `\". If the new object cannot be created, the old reference to *bytes* will still be \"stolen\", the value of *\\*bytes* will be set to ``NULL``, and the appropriate exception will be set." +msgid "Create a new bytes object in *\\*bytes* containing the contents of *newpart* appended to *bytes*; the caller will own the new reference. The reference to the old value of *bytes* will be stolen. If the new object cannot be created, the old reference to *bytes* will still be discarded and the value of *\\*bytes* will be set to ``NULL``; the appropriate exception will be set." msgstr "" msgid "If *newpart* implements the buffer protocol, then the buffer must not be mutated while the new bytes object is being created." diff --git a/c-api/call.po b/c-api/call.po index c58eba555..9747bb6df 100644 --- a/c-api/call.po +++ b/c-api/call.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:47+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/capsule.po b/c-api/capsule.po index 98619c925..d69bdb21b 100644 --- a/c-api/capsule.po +++ b/c-api/capsule.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:47+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/cell.po b/c-api/cell.po index ee3a9bf4c..1c9405925 100644 --- a/c-api/cell.po +++ b/c-api/cell.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/code.po b/c-api/code.po index 3d3d9df23..18f4900d4 100644 --- a/c-api/code.po +++ b/c-api/code.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:48+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -131,7 +131,7 @@ msgstr "" msgid "There may already be a pending exception set on entry to the callback. In this case, the callback should return ``0`` with the same exception still set. This means the callback may not call any other API that can set an exception unless it saves and clears the exception state first, and restores it before returning." msgstr "" -msgid "This is a function that does nothing." +msgid "This is a :term:`soft deprecated` function that does nothing." msgstr "" msgid "Prior to Python 3.10, this function would perform basic optimizations to a code object." diff --git a/c-api/codec.po b/c-api/codec.po index 0ef3359ca..fc52e9dfe 100644 --- a/c-api/codec.po +++ b/c-api/codec.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/complex.po b/c-api/complex.po index a6f3f2a23..43926010f 100644 --- a/c-api/complex.po +++ b/c-api/complex.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:48+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/concrete.po b/c-api/concrete.po index da2b910ec..a6ac052f1 100644 --- a/c-api/concrete.po +++ b/c-api/concrete.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:48+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/contextvars.po b/c-api/contextvars.po index 956cf9492..2a82d9245 100644 --- a/c-api/contextvars.po +++ b/c-api/contextvars.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:48+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/conversion.po b/c-api/conversion.po index 7e12c603c..28af6eb84 100644 --- a/c-api/conversion.po +++ b/c-api/conversion.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/coro.po b/c-api/coro.po index a46edf671..1290c85c3 100644 --- a/c-api/coro.po +++ b/c-api/coro.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:48+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/curses.po b/c-api/curses.po index af243bf38..ece122d41 100644 --- a/c-api/curses.po +++ b/c-api/curses.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/c-api/datetime.po b/c-api/datetime.po index 1fd43cd4a..3841a7423 100644 --- a/c-api/datetime.po +++ b/c-api/datetime.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:48+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/descriptor.po b/c-api/descriptor.po index c9fc9ebd0..f73f9dc02 100644 --- a/c-api/descriptor.po +++ b/c-api/descriptor.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:48+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -32,69 +32,21 @@ msgstr "" msgid "The type object for the built-in descriptor types." msgstr "" -msgid "Create a new get-set descriptor for extension type *type* from the :c:type:`PyGetSetDef` structure *getset*." -msgstr "" - -msgid "Get-set descriptors expose attributes implemented by C getter and setter functions rather than stored directly in the instance. This is the same kind of descriptor created for entries in :c:member:`~PyTypeObject.tp_getset`, and it appears in Python as a :class:`types.GetSetDescriptorType` object." -msgstr "" - -msgid "On success, return a :term:`strong reference` to the descriptor. Return ``NULL`` with an exception set on failure." -msgstr "" - -msgid "Create a new member descriptor for extension type *type* from the :c:type:`PyMemberDef` structure *member*." -msgstr "" - -msgid "Member descriptors expose fields in the type's C struct as Python attributes. This is the same kind of descriptor created for entries in :c:member:`~PyTypeObject.tp_members`, and it appears in Python as a :class:`types.MemberDescriptorType` object." -msgstr "" - msgid "The type object for member descriptor objects created from :c:type:`PyMemberDef` structures. These descriptors expose fields of a C struct as attributes on a type, and correspond to :class:`types.MemberDescriptorType` objects in Python." msgstr "" -msgid "The type object for get/set descriptor objects created from :c:type:`PyGetSetDef` structures. These descriptors implement attributes whose value is computed by C getter and setter functions, and are used for many built-in type attributes. They correspond to :class:`types.GetSetDescriptorType` objects in Python." -msgstr "" - -msgid "Create a new method descriptor for extension type *type* from the :c:type:`PyMethodDef` structure *meth*." -msgstr "" - -msgid "Method descriptors expose C functions as methods on a type. This is the same kind of descriptor created for entries in :c:member:`~PyTypeObject.tp_methods`, and it appears in Python as a :class:`types.MethodDescriptorType` object." -msgstr "" - -msgid "The type object for method descriptor objects created from :c:type:`PyMethodDef` structures. These descriptors expose C functions as methods on a type, and correspond to :class:`types.MethodDescriptorType` objects in Python." +msgid "The type object for get/set descriptor objects created from :c:type:`PyGetSetDef` structures. These descriptors implement attributes whose value is computed by C getter and setter functions, and are used for many built-in type attributes." msgstr "" -msgid "Describes a slot wrapper used by :c:func:`PyDescr_NewWrapper`." -msgstr "" - -msgid "Each ``wrapperbase`` record stores the Python-visible name and metadata for a special method implemented by a type slot, together with the wrapper function used to adapt that slot to Python's calling convention." -msgstr "" - -msgid "Create a new wrapper descriptor for extension type *type* from the :c:struct:`wrapperbase` structure *base* and the wrapped slot function pointer *wrapped*." -msgstr "" - -msgid "Wrapper descriptors expose special methods implemented by type slots. This is the same kind of descriptor that CPython creates for slot-based special methods such as ``__repr__`` or ``__add__``, and it appears in Python as a :class:`types.WrapperDescriptorType` object." +msgid "The type object for method descriptor objects created from :c:type:`PyMethodDef` structures. These descriptors expose C functions as methods on a type, and correspond to :class:`types.MemberDescriptorType` objects in Python." msgstr "" msgid "The type object for wrapper descriptor objects created by :c:func:`PyDescr_NewWrapper` and :c:func:`PyWrapper_New`. Wrapper descriptors are used internally to expose special methods implemented via wrapper structures, and appear in Python as :class:`types.WrapperDescriptorType` objects." msgstr "" -msgid "Create a new class method descriptor for extension type *type* from the :c:type:`PyMethodDef` structure *method*." -msgstr "" - -msgid "Class method descriptors expose C methods that receive the class rather than an instance when accessed. This is the same kind of descriptor created for ``METH_CLASS`` entries in :c:member:`~PyTypeObject.tp_methods`, and it appears in Python as a :class:`types.ClassMethodDescriptorType` object." -msgstr "" - msgid "Return non-zero if the descriptor object *descr* describes a data attribute, or ``0`` if it describes a method. *descr* must be a descriptor object; there is no error checking." msgstr "" -msgid "Create a new bound wrapper object from the wrapper descriptor *d* and the instance *self*." -msgstr "" - -msgid "This is the bound form of a wrapper descriptor created by :c:func:`PyDescr_NewWrapper`. CPython creates these objects when a slot wrapper is accessed through an instance, and they appear in Python as :class:`types.MethodWrapperType` objects." -msgstr "" - -msgid "On success, return a :term:`strong reference` to the wrapper object. Return ``NULL`` with an exception set on failure." -msgstr "" - msgid "Built-in descriptors" msgstr "" @@ -104,7 +56,7 @@ msgstr "" msgid "The type of class method objects. This is the same object as :class:`classmethod` in the Python layer." msgstr "" -msgid "The type object for C-level class method descriptor objects. This is the type of the descriptors created for :func:`classmethod` defined in C extension types, and corresponds to :class:`types.ClassMethodDescriptorType` objects in Python." +msgid "The type object for C-level class method descriptor objects. This is the type of the descriptors created for :func:`classmethod` defined in C extension types, and is the same object as :class:`classmethod` in Python." msgstr "" msgid "Create a new :class:`classmethod` object wrapping *callable*. *callable* must be a callable object and must not be ``NULL``." diff --git a/c-api/dict.po b/c-api/dict.po index 0e3063a78..110f87749 100644 --- a/c-api/dict.po +++ b/c-api/dict.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:48+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -63,7 +63,7 @@ msgstr "" msgid "Return a new dictionary that contains the same key-value pairs as *p*." msgstr "" -msgid "Insert *val* into the dictionary *p* with a key of *key*. *key* must be :term:`hashable`; if it isn't, :exc:`TypeError` will be raised. Return ``0`` on success or ``-1`` on failure. This function *does not* \":term:`steal`\" a reference to *val*." +msgid "Insert *val* into the dictionary *p* with a key of *key*. *key* must be :term:`hashable`; if it isn't, :exc:`TypeError` will be raised. Return ``0`` on success or ``-1`` on failure. This function *does not* steal a reference to *val*." msgstr "" msgid "This is the same as :c:func:`PyDict_SetItem`, but *key* is specified as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:`PyObject*`." diff --git a/c-api/exceptions.po b/c-api/exceptions.po index 638e7b6d8..76e610b9e 100644 --- a/c-api/exceptions.po +++ b/c-api/exceptions.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:48+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -84,18 +84,6 @@ msgstr "" msgid "Print the standard traceback display of ``exc`` to ``sys.stderr``, including chained exceptions and notes." msgstr "" -msgid "Legacy variant of :c:func:`PyErr_DisplayException`." -msgstr "" - -msgid "Print the exception *value* with its traceback to :data:`sys.stderr`. If *value* has no traceback set, *tb* is used as its traceback. The first argument is ignored." -msgstr "" - -msgid "If :data:`sys.stderr` is ``None``, nothing is printed. If :data:`sys.stderr` is not set, the exception is dumped to the C ``stderr`` stream instead." -msgstr "" - -msgid "Use :c:func:`PyErr_DisplayException` instead." -msgstr "" - msgid "Raising exceptions" msgstr "" @@ -256,13 +244,10 @@ msgstr "" msgid ":c:func:`PyErr_GetHandledException`, to save the exception currently being handled." msgstr "" -msgid "Set *exc* as the exception currently being raised, clearing the existing exception if one is set. If *exc* is ``NULL``, just clear the existing exception." -msgstr "" - -msgid "*exc* must be a valid exception or ``NULL``." +msgid "Set *exc* as the exception currently being raised, clearing the existing exception if one is set." msgstr "" -msgid "This call \":term:`steals `\" a reference to *exc*." +msgid "This call steals a reference to *exc*, which must be a valid exception." msgstr "" msgid "Use :c:func:`PyErr_GetRaisedException` instead." @@ -327,13 +312,13 @@ msgstr "" msgid "This function is not normally used by code that wants to handle exceptions. Rather, it can be used when code needs to save and restore the exception state temporarily. Use :c:func:`PyErr_SetExcInfo` to restore or clear the exception state." msgstr "" -msgid "Set the exception info, as known from ``sys.exc_info()``. This refers to an exception that was *already caught*, not to an exception that was freshly raised. This function \":term:`steals `\" the references of the arguments. To clear the exception state, pass ``NULL`` for all three arguments. This function is kept for backwards compatibility. Prefer using :c:func:`PyErr_SetHandledException`." +msgid "Set the exception info, as known from ``sys.exc_info()``. This refers to an exception that was *already caught*, not to an exception that was freshly raised. This function steals the references of the arguments. To clear the exception state, pass ``NULL`` for all three arguments. This function is kept for backwards compatibility. Prefer using :c:func:`PyErr_SetHandledException`." msgstr "" msgid "This function is not normally used by code that wants to handle exceptions. Rather, it can be used when code needs to save and restore the exception state temporarily. Use :c:func:`PyErr_GetExcInfo` to read the exception state." msgstr "" -msgid "The ``type`` and ``traceback`` arguments are no longer used and can be NULL. The interpreter now derives them from the exception instance (the ``value`` argument). The function still \":term:`steals `\" references of all three arguments." +msgid "The ``type`` and ``traceback`` arguments are no longer used and can be NULL. The interpreter now derives them from the exception instance (the ``value`` argument). The function still steals references of all three arguments." msgstr "" msgid "Signal Handling" @@ -441,13 +426,13 @@ msgstr "" msgid "Return the context (another exception instance during whose handling *ex* was raised) associated with the exception as a new reference, as accessible from Python through the :attr:`~BaseException.__context__` attribute. If there is no context associated, this returns ``NULL``." msgstr "" -msgid "Set the context associated with the exception to *ctx*. Use ``NULL`` to clear it. There is no type check to make sure that *ctx* is an exception instance. This \":term:`steals `\" a reference to *ctx*." +msgid "Set the context associated with the exception to *ctx*. Use ``NULL`` to clear it. There is no type check to make sure that *ctx* is an exception instance. This steals a reference to *ctx*." msgstr "" msgid "Return the cause (either an exception instance, or ``None``, set by ``raise ... from ...``) associated with the exception as a new reference, as accessible from Python through the :attr:`~BaseException.__cause__` attribute." msgstr "" -msgid "Set the cause associated with the exception to *cause*. Use ``NULL`` to clear it. There is no type check to make sure that *cause* is either an exception instance or ``None``. This \":term:`steals `\" a reference to *cause*." +msgid "Set the cause associated with the exception to *cause*. Use ``NULL`` to clear it. There is no type check to make sure that *cause* is either an exception instance or ``None``. This steals a reference to *cause*." msgstr "" msgid "The :attr:`~BaseException.__suppress_context__` attribute is implicitly set to ``True`` by this function." @@ -534,7 +519,7 @@ msgstr "" msgid "Ends a :c:func:`Py_EnterRecursiveCall`. Must be called once for each *successful* invocation of :c:func:`Py_EnterRecursiveCall`." msgstr "" -msgid "Properly implementing :c:member:`~PyTypeObject.tp_repr` for container types requires special recursion handling. In addition to protecting the stack, :c:member:`~PyTypeObject.tp_repr` also needs to track objects to prevent cycles. The following two functions facilitate this functionality. Effectively, these are the C equivalent to :deco:`reprlib.recursive_repr`." +msgid "Properly implementing :c:member:`~PyTypeObject.tp_repr` for container types requires special recursion handling. In addition to protecting the stack, :c:member:`~PyTypeObject.tp_repr` also needs to track objects to prevent cycles. The following two functions facilitate this functionality. Effectively, these are the C equivalent to :func:`reprlib.recursive_repr`." msgstr "" msgid "Called at the beginning of the :c:member:`~PyTypeObject.tp_repr` implementation to detect cycles." diff --git a/c-api/extension-modules.po b/c-api/extension-modules.po index db72a05b6..ec3a3911f 100644 --- a/c-api/extension-modules.po +++ b/c-api/extension-modules.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/c-api/file.po b/c-api/file.po index a8a9239a9..0cc630fa6 100644 --- a/c-api/file.po +++ b/c-api/file.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:48+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/float.po b/c-api/float.po index 55d61abdf..beb30aff7 100644 --- a/c-api/float.po +++ b/c-api/float.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:48+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/frame.po b/c-api/frame.po index 434725255..19c854f4c 100644 --- a/c-api/frame.po +++ b/c-api/frame.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2022-11-05 19:48+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -172,54 +172,3 @@ msgstr "" msgid "Return the currently executing line number, or -1 if there is no line number." msgstr "" - -msgid "An array of executable kinds (executor types) for frames, used for internal debugging and tracing." -msgstr "" - -msgid "Tools like debuggers and profilers can use this to identify the type of execution context associated with a frame (such as to filter out internal frames). The entries are indexed by the following constants:" -msgstr "" - -msgid "Constant" -msgstr "" - -msgid "Description" -msgstr "" - -msgid "The frame is internal (For example: inlined) and should be skipped by tools." -msgstr "" - -msgid "The frame corresponds to a standard Python function." -msgstr "" - -msgid "The frame corresponds to a function defined in native code." -msgstr "" - -msgid "The frame corresponds to a method on a class instance." -msgstr "" - -msgid "However, Python's C API lacks a function to read the executable kind from a frame. Instead, use this recipe:" -msgstr "" - -msgid "" -"int\n" -"get_executable_kind(PyFrameObject *frame)\n" -"{\n" -" _PyInterpreterFrame *f = frame->f_frame;\n" -" PyObject *exec = PyStackRef_AsPyObjectBorrow(f->f_executable);\n" -"\n" -" if (PyCode_Check(exec)) {\n" -" return PyUnstable_EXECUTABLE_KIND_PY_FUNCTION;\n" -" }\n" -" if (PyMethod_Check(exec)) {\n" -" return PyUnstable_EXECUTABLE_KIND_BUILTIN_FUNCTION;\n" -" }\n" -" if (Py_IS_TYPE(exec, &PyMethodDescr_Type)) {\n" -" return PyUnstable_EXECUTABLE_KIND_METHOD_DESCRIPTOR;\n" -" }\n" -"\n" -" return PyUnstable_EXECUTABLE_KIND_SKIP;\n" -"}" -msgstr "" - -msgid "The number of entries in :c:data:`PyUnstable_ExecutableKinds`." -msgstr "" diff --git a/c-api/function.po b/c-api/function.po index 65722d5a9..5c381d71b 100644 --- a/c-api/function.po +++ b/c-api/function.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:48+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/gcsupport.po b/c-api/gcsupport.po index c940948df..afecfea8a 100644 --- a/c-api/gcsupport.po +++ b/c-api/gcsupport.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:48+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/gen.po b/c-api/gen.po index 4a83cb955..6920d84f9 100644 --- a/c-api/gen.po +++ b/c-api/gen.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -39,10 +39,10 @@ msgstr "" msgid "Return true if *ob*'s type is :c:type:`PyGen_Type`; *ob* must not be ``NULL``. This function always succeeds." msgstr "" -msgid "Create and return a new generator object based on the *frame* object. A reference to *frame* is \":term:`stolen `\" by this function (even on error). The argument must not be ``NULL``." +msgid "Create and return a new generator object based on the *frame* object. A reference to *frame* is stolen by this function. The argument must not be ``NULL``." msgstr "" -msgid "Create and return a new generator object based on the *frame* object, with ``__name__`` and ``__qualname__`` set to *name* and *qualname*. A reference to *frame* is \":term:`stolen `\" by this function (even on error). The *frame* argument must not be ``NULL``." +msgid "Create and return a new generator object based on the *frame* object, with ``__name__`` and ``__qualname__`` set to *name* and *qualname*. A reference to *frame* is stolen by this function. The *frame* argument must not be ``NULL``." msgstr "" msgid "Return a new :term:`strong reference` to the code object wrapped by *gen*. This function always succeeds." @@ -57,7 +57,7 @@ msgstr "" msgid "The type object corresponding to asynchronous generator objects. This is available as :class:`types.AsyncGeneratorType` in the Python layer." msgstr "" -msgid "Create a new asynchronous generator wrapping *frame*, with ``__name__`` and ``__qualname__`` set to *name* and *qualname*. *frame* is \":term:`stolen `\" by this function (even on error) and must not be ``NULL``." +msgid "Create a new asynchronous generator wrapping *frame*, with ``__name__`` and ``__qualname__`` set to *name* and *qualname*. *frame* is stolen by this function and must not be ``NULL``." msgstr "" msgid "On success, this function returns a :term:`strong reference` to the new asynchronous generator. On failure, this function returns ``NULL`` with an exception set." @@ -69,7 +69,7 @@ msgstr "" msgid "Deprecated API" msgstr "" -msgid "This is an API that was included in Python's C API by mistake." +msgid "This is a :term:`soft deprecated` API that was included in Python's C API by mistake." msgstr "" msgid "It is solely here for completeness; do not use this API." diff --git a/c-api/hash.po b/c-api/hash.po index 6c7b97596..33a2612ce 100644 --- a/c-api/hash.po +++ b/c-api/hash.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-02-23 14:15+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/import.po b/c-api/import.po index c495a7e92..1a3c11abb 100644 --- a/c-api/import.po +++ b/c-api/import.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:48+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/index.po b/c-api/index.po index 26bf83010..4dc2519e3 100644 --- a/c-api/index.po +++ b/c-api/index.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:48+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/init.po b/c-api/init.po index e0661be5c..f27f4b0c3 100644 --- a/c-api/init.po +++ b/c-api/init.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-17 04:35+0000\n" "PO-Revision-Date: 2021-06-28 00:49+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/init_config.po b/c-api/init_config.po index 9a045c9cb..1bdd49b73 100644 --- a/c-api/init_config.po +++ b/c-api/init_config.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:49+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -738,9 +738,6 @@ msgstr "" msgid "Raises an :ref:`auditing event ` ``cpython.PyConfig_Set`` with arguments ``name``, ``value``." msgstr "" -msgid "The function now replaces :data:`sys.flags` (create a new object), instead of modifying :data:`sys.flags` in-place." -msgstr "" - msgid "PyConfig C API" msgstr "" @@ -1234,10 +1231,10 @@ msgstr "" msgid "See also :c:member:`PyConfig.exec_prefix`." msgstr "" -msgid "Python base executable: ``sys._base_executable``." +msgid "Python base executable: :data:`sys._base_executable`." msgstr "" -msgid "Set by the ``__PYVENV_LAUNCHER__`` environment variable." +msgid "Set by the :envvar:`__PYVENV_LAUNCHER__` environment variable." msgstr "" msgid "Set from :c:member:`PyConfig.executable` if ``NULL``." @@ -1621,7 +1618,7 @@ msgstr "" msgid "On macOS, use :envvar:`PYTHONEXECUTABLE` environment variable if set." msgstr "" -msgid "If the ``WITH_NEXT_FRAMEWORK`` macro is defined, use ``__PYVENV_LAUNCHER__`` environment variable if set." +msgid "If the ``WITH_NEXT_FRAMEWORK`` macro is defined, use :envvar:`__PYVENV_LAUNCHER__` environment variable if set." msgstr "" msgid "Use ``argv[0]`` of :c:member:`~PyConfig.argv` if available and non-empty." @@ -1804,7 +1801,7 @@ msgstr "" msgid "Options of the :mod:`warnings` module to build warnings filters, lowest to highest priority: :data:`sys.warnoptions`." msgstr "" -msgid "The :mod:`warnings` module adds :data:`sys.warnoptions` in the reverse order: the last :c:member:`PyConfig.warnoptions` item becomes the first item of ``warnings.filters`` which is checked first (highest priority)." +msgid "The :mod:`warnings` module adds :data:`sys.warnoptions` in the reverse order: the last :c:member:`PyConfig.warnoptions` item becomes the first item of :data:`warnings.filters` which is checked first (highest priority)." msgstr "" msgid "The :option:`-W` command line options adds its value to :c:member:`~PyConfig.warnoptions`, it can be used multiple times." diff --git a/c-api/interp-lifecycle.po b/c-api/interp-lifecycle.po index 508702e09..99c32ff3b 100644 --- a/c-api/interp-lifecycle.po +++ b/c-api/interp-lifecycle.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/c-api/intro.po b/c-api/intro.po index 1bd1cbefe..7a4412379 100644 --- a/c-api/intro.po +++ b/c-api/intro.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:49+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -373,13 +373,13 @@ msgstr "" msgid "Consider using the C99 standard suffixes ``LL`` and ``LLU`` directly." msgstr "" -msgid "This is an alias to :c:func:`!memcpy`." +msgid "This is a :term:`soft deprecated` alias to :c:func:`!memcpy`. Use :c:func:`!memcpy` directly instead." msgstr "" -msgid "Use :c:func:`!memcpy` directly instead." +msgid "The macro is :term:`soft deprecated`." msgstr "" -msgid "This is an alias to the C99-standard ``va_copy`` function." +msgid "This is a :term:`soft deprecated` alias to the C99-standard ``va_copy`` function." msgstr "" msgid "Historically, this would use a compiler-specific method to copy a ``va_list``." @@ -421,10 +421,7 @@ msgstr "" msgid "The reference count behavior of functions in the Python/C API is best explained in terms of *ownership of references*. Ownership pertains to references, never to objects (objects are not owned: they are always shared). \"Owning a reference\" means being responsible for calling Py_DECREF on it when the reference is no longer needed. Ownership can also be transferred, meaning that the code that receives ownership of the reference then becomes responsible for eventually releasing it by calling :c:func:`Py_DECREF` or :c:func:`Py_XDECREF` when it's no longer needed---or passing on this responsibility (usually to its caller). When a function passes ownership of a reference on to its caller, the caller is said to receive a *new* reference. When no ownership is transferred, the caller is said to *borrow* the reference. Nothing needs to be done for a :term:`borrowed reference`." msgstr "" -msgid "Conversely, when a calling function passes in a reference to an object, there are two possibilities: the function *steals* a reference to the object, or it does not." -msgstr "" - -msgid "*Stealing a reference* means that when you pass a reference to a function, that function assumes that it now owns that reference. Since the new owner can use :c:func:`!Py_DECREF` at its discretion, you (the caller) must not use that reference after the call." +msgid "Conversely, when a calling function passes in a reference to an object, there are two possibilities: the function *steals* a reference to the object, or it does not. *Stealing a reference* means that when you pass a reference to a function, that function assumes that it now owns that reference, and you are not responsible for it any longer." msgstr "" msgid "Few functions steal references; the two notable exceptions are :c:func:`PyList_SetItem` and :c:func:`PyTuple_SetItem`, which steal a reference to the item (but not to the tuple or list into which the item is put!). These functions were designed to steal a reference because of a common idiom for populating a tuple or list with newly created objects; for example, the code to create the tuple ``(1, 2, \"three\")`` could look like this (forgetting about error handling for the moment; a better way to code this is shown below)::" @@ -679,7 +676,7 @@ msgstr "" msgid "In addition to the reference count debugging described below, extra checks are performed, see :ref:`Python Debug Build `." msgstr "" -msgid "Defining ``Py_TRACE_REFS`` enables reference tracing (see the :option:`configure --with-trace-refs option <--with-trace-refs>`). When defined, a circular doubly linked list of active objects is maintained by adding two extra fields to every :c:type:`PyObject`. Total allocations are tracked as well. Upon exit, all existing references are printed. (In interactive mode this happens after every statement run by the interpreter.)" +msgid "Defining :c:macro:`Py_TRACE_REFS` enables reference tracing (see the :option:`configure --with-trace-refs option <--with-trace-refs>`). When defined, a circular doubly linked list of active objects is maintained by adding two extra fields to every :c:type:`PyObject`. Total allocations are tracked as well. Upon exit, all existing references are printed. (In interactive mode this happens after every statement run by the interpreter.)" msgstr "" msgid "Please refer to :file:`Misc/SpecialBuilds.txt` in the Python source distribution for more detailed information." diff --git a/c-api/iter.po b/c-api/iter.po index 35d70b8b5..185615c00 100644 --- a/c-api/iter.po +++ b/c-api/iter.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/iterator.po b/c-api/iterator.po index 50655a5d4..a53dc29a8 100644 --- a/c-api/iterator.po +++ b/c-api/iterator.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/lifecycle.po b/c-api/lifecycle.po index 606767cf1..434538d56 100644 --- a/c-api/lifecycle.po +++ b/c-api/lifecycle.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/c-api/list.po b/c-api/list.po index 0ea2bcf7c..6f4a3fea5 100644 --- a/c-api/list.po +++ b/c-api/list.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:49+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -64,7 +64,7 @@ msgstr "" msgid "Set the item at index *index* in list to *item*. Return ``0`` on success. If *index* is out of bounds, return ``-1`` and set an :exc:`IndexError` exception." msgstr "" -msgid "This function \":term:`steals `\" a reference to *item*, even on error. On success, it discards a reference to an item already in the list at the affected position (unless it was ``NULL``)." +msgid "This function \"steals\" a reference to *item* and discards a reference to an item already in the list at the affected position." msgstr "" msgid "Macro form of :c:func:`PyList_SetItem` without error checking. This is normally only used to fill in new lists where there is no previous content." @@ -73,7 +73,7 @@ msgstr "" msgid "Bounds checking is performed as an assertion if Python is built in :ref:`debug mode ` or :option:`with assertions <--with-assertions>`." msgstr "" -msgid "This macro \":term:`steals `\" a reference to *item*, and, unlike :c:func:`PyList_SetItem`, does *not* discard a reference to any item that is being replaced; any reference in *list* at position *i* will be leaked." +msgid "This macro \"steals\" a reference to *item*, and, unlike :c:func:`PyList_SetItem`, does *not* discard a reference to any item that is being replaced; any reference in *list* at position *i* will be leaked." msgstr "" msgid "In the :term:`free-threaded build`, this macro has no internal synchronization. It is normally only used to fill in new lists where no other thread has a reference to the list. If the list may be shared, use :c:func:`PyList_SetItem` instead, which uses a :term:`per-object lock`." diff --git a/c-api/long.po b/c-api/long.po index f5da800e2..38582836a 100644 --- a/c-api/long.po +++ b/c-api/long.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:49+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/mapping.po b/c-api/mapping.po index 5f3603b70..5c6d2352c 100644 --- a/c-api/mapping.po +++ b/c-api/mapping.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:49+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/marshal.po b/c-api/marshal.po index 36d67c41a..7d419c898 100644 --- a/c-api/marshal.po +++ b/c-api/marshal.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/memory.po b/c-api/memory.po index 571ae15aa..61901419e 100644 --- a/c-api/memory.po +++ b/c-api/memory.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:49+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -57,7 +57,7 @@ msgstr "" msgid "In this example, the memory request for the I/O buffer is handled by the C library allocator. The Python memory manager is involved only in the allocation of the bytes object returned as a result." msgstr "" -msgid "In most situations, however, it is recommended to allocate memory from the Python heap specifically because the latter is under control of the Python memory manager. For example, this is required when the interpreter is extended with new object types written in C. Another reason for using the Python heap is the desire to *inform* the Python memory manager about the memory needs of the extension module. Even when the requested memory is used exclusively for internal, highly specific purposes, delegating all memory requests to the Python memory manager causes the interpreter to have a more accurate image of its memory footprint as a whole. Consequently, under certain circumstances, the Python memory manager may or may not trigger appropriate actions, like garbage collection, memory compaction or other preventive procedures. Note that by using the C library allocator as shown in the previous example, the allocated memory for the I/O buffer completely escapes the Python memory manager." +msgid "In most situations, however, it is recommended to allocate memory from the Python heap specifically because the latter is under control of the Python memory manager. For example, this is required when the interpreter is extended with new object types written in C. Another reason for using the Python heap is the desire to *inform* the Python memory manager about the memory needs of the extension module. Even when the requested memory is used exclusively for internal, highly specific purposes, delegating all memory requests to the Python memory manager causes the interpreter to have a more accurate image of its memory footprint as a whole. Consequently, under certain circumstances, the Python memory manager may or may not trigger appropriate actions, like garbage collection, memory compaction or other preventive procedures. Note that by using the C library allocator as shown in the previous example, the allocated memory for the I/O buffer escapes completely the Python memory manager." msgstr "" msgid "The :envvar:`PYTHONMALLOC` environment variable can be used to configure the memory allocators used by Python." @@ -108,7 +108,7 @@ msgstr "" msgid "Requesting zero bytes returns a distinct non-``NULL`` pointer if possible, as if ``PyMem_RawMalloc(1)`` had been called instead. The memory will not have been initialized in any way." msgstr "" -msgid "Allocates *nelem* elements each of size *elsize* bytes and returns a pointer of type :c:expr:`void*` to the allocated memory, or ``NULL`` if the request fails. The memory is initialized to zeros." +msgid "Allocates *nelem* elements each whose size in bytes is *elsize* and returns a pointer of type :c:expr:`void*` to the allocated memory, or ``NULL`` if the request fails. The memory is initialized to zeros." msgstr "" msgid "Requesting zero elements or elements of size zero bytes returns a distinct non-``NULL`` pointer if possible, as if ``PyMem_RawCalloc(1, 1)`` had been called instead." diff --git a/c-api/memoryview.po b/c-api/memoryview.po index f349208b9..7d59cd517 100644 --- a/c-api/memoryview.po +++ b/c-api/memoryview.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:49+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/method.po b/c-api/method.po index 4bd9d3fca..470a639da 100644 --- a/c-api/method.po +++ b/c-api/method.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:49+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/module.po b/c-api/module.po index 4d23e76ab..135c0b41d 100644 --- a/c-api/module.po +++ b/c-api/module.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:49+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -324,7 +324,7 @@ msgstr "" msgid "The number of different *name* strings passed to this function should be kept small, usually by only using statically allocated strings as *name*. For names that aren't known at compile time, prefer calling :c:func:`PyUnicode_FromString` and :c:func:`PyObject_SetAttr` directly. For more details, see :c:func:`PyUnicode_InternFromString`, which may be used internally to create a key object." msgstr "" -msgid "Similar to :c:func:`PyModule_AddObjectRef`, but \":term:`steals `\" a reference to *value* (even on error). It can be called with a result of function that returns a new reference without bothering to check its result or even saving it to a variable." +msgid "Similar to :c:func:`PyModule_AddObjectRef`, but \"steals\" a reference to *value*. It can be called with a result of function that returns a new reference without bothering to check its result or even saving it to a variable." msgstr "" msgid "" @@ -333,7 +333,7 @@ msgid "" "}" msgstr "" -msgid "Similar to :c:func:`PyModule_AddObjectRef`, but :term:`steals ` a reference to *value* on success (if it returns ``0``)." +msgid "Similar to :c:func:`PyModule_AddObjectRef`, but steals a reference to *value* on success (if it returns ``0``)." msgstr "" msgid "The new :c:func:`PyModule_Add` or :c:func:`PyModule_AddObjectRef` functions are recommended, since it is easy to introduce reference leaks by misusing the :c:func:`PyModule_AddObject` function." diff --git a/c-api/monitoring.po b/c-api/monitoring.po index 5f394e5b3..01f211f6f 100644 --- a/c-api/monitoring.po +++ b/c-api/monitoring.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-05-11 01:07+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/none.po b/c-api/none.po index 068fa838a..da8bdc197 100644 --- a/c-api/none.po +++ b/c-api/none.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:49+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/number.po b/c-api/number.po index b7834293f..7c99a8d34 100644 --- a/c-api/number.po +++ b/c-api/number.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:49+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/object.po b/c-api/object.po index ada0d57e1..12c9f1926 100644 --- a/c-api/object.po +++ b/c-api/object.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:49+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/objimpl.po b/c-api/objimpl.po index 90df64831..1dfc781a1 100644 --- a/c-api/objimpl.po +++ b/c-api/objimpl.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/perfmaps.po b/c-api/perfmaps.po index 185760430..84fe36f65 100644 --- a/c-api/perfmaps.po +++ b/c-api/perfmaps.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2023-05-24 13:07+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -52,45 +52,3 @@ msgstr "" msgid "Close the perf map file opened by :c:func:`PyUnstable_PerfMapState_Init`. This is called by the runtime itself during interpreter shut-down. In general, there shouldn't be a reason to explicitly call this, except to handle specific scenarios such as forking." msgstr "" - -msgid "Open the ``/tmp/perf-$pid.map`` file and append the content of *parent_filename* to it." -msgstr "" - -msgid "This function is available on all platforms but only generates output on platforms that support perf maps (currently only Linux). On other platforms, it does nothing." -msgstr "" - -msgid "Compile the given code object using the current perf trampoline." -msgstr "" - -msgid "The \"current\" trampoline is the one set by the runtime or the most recent :c:func:`PyUnstable_PerfTrampoline_SetPersistAfterFork` call." -msgstr "" - -msgid "If no trampoline is set, falls back to normal compilation (no perf map entry)." -msgstr "" - -msgid "Parameters" -msgstr "" - -msgid "The code object to compile." -msgstr "" - -msgid "Returns" -msgstr "" - -msgid "0 on success, -1 on failure." -msgstr "" - -msgid "Set whether the perf trampoline should persist after a fork." -msgstr "" - -msgid "If ``enable`` is true (non-zero): perf map file remains open/valid post-fork. Child process inherits all existing perf map entries." -msgstr "" - -msgid "If ``enable`` is false (zero): perf map closes post-fork. Child process gets empty perf map." -msgstr "" - -msgid "Default: false (clears on fork)." -msgstr "" - -msgid "1 to enable, 0 to disable." -msgstr "" diff --git a/c-api/picklebuffer.po b/c-api/picklebuffer.po index bb05e03c3..297631506 100644 --- a/c-api/picklebuffer.po +++ b/c-api/picklebuffer.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/c-api/profiling.po b/c-api/profiling.po index bbce616bf..73b2dda14 100644 --- a/c-api/profiling.po +++ b/c-api/profiling.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/c-api/refcounting.po b/c-api/refcounting.po index b463f520b..93162db37 100644 --- a/c-api/refcounting.po +++ b/c-api/refcounting.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:50+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/reflection.po b/c-api/reflection.po index 41efd1470..a6e3a0c5d 100644 --- a/c-api/reflection.po +++ b/c-api/reflection.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:50+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/sequence.po b/c-api/sequence.po index 5c1792208..9ffef5b00 100644 --- a/c-api/sequence.po +++ b/c-api/sequence.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:50+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -49,7 +49,7 @@ msgstr "" msgid "Return the slice of sequence object *o* between *i1* and *i2*, or ``NULL`` on failure. This is the equivalent of the Python expression ``o[i1:i2]``." msgstr "" -msgid "Assign object *v* to the *i*\\ th element of *o*. Raise an exception and return ``-1`` on failure; return ``0`` on success. This is the equivalent of the Python statement ``o[i] = v``. This function *does not* \":term:`steal`\" a reference to *v*." +msgid "Assign object *v* to the *i*\\ th element of *o*. Raise an exception and return ``-1`` on failure; return ``0`` on success. This is the equivalent of the Python statement ``o[i] = v``. This function *does not* steal a reference to *v*." msgstr "" msgid "If *v* is ``NULL``, the element is deleted, but this feature is deprecated in favour of using :c:func:`PySequence_DelItem`." diff --git a/c-api/set.po b/c-api/set.po index fcd28f225..bff21cd14 100644 --- a/c-api/set.po +++ b/c-api/set.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:50+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -105,7 +105,7 @@ msgstr "" msgid "Deprecated API" msgstr "" -msgid "A constant representing the size of an internal preallocated table inside :c:type:`PySetObject` instances." +msgid "A :term:`soft deprecated` constant representing the size of an internal preallocated table inside :c:type:`PySetObject` instances." msgstr "" msgid "This is documented solely for completeness, as there are no guarantees that a given version of CPython uses preallocated tables with a fixed size. In code that does not deal with unstable set internals, :c:macro:`!PySet_MINSIZE` can be replaced with a small constant like ``8``." diff --git a/c-api/slice.po b/c-api/slice.po index fb3fada50..f23f596b8 100644 --- a/c-api/slice.po +++ b/c-api/slice.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/stable.po b/c-api/stable.po index 80d66ec9b..3e0198572 100644 --- a/c-api/stable.po +++ b/c-api/stable.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/structures.po b/c-api/structures.po index d484582b6..c55efc86d 100644 --- a/c-api/structures.po +++ b/c-api/structures.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:50+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -276,10 +276,10 @@ msgstr "" msgid "These two constants are not used to indicate the calling convention but the binding when used with methods of classes. These may not be used for functions defined for modules. At most one of these flags may be set for any given method." msgstr "" -msgid "The method will be passed the type object as the first parameter rather than an instance of the type. This is used to create *class methods*, similar to what is created when using the :deco:`classmethod` built-in decorator." +msgid "The method will be passed the type object as the first parameter rather than an instance of the type. This is used to create *class methods*, similar to what is created when using the :func:`classmethod` built-in function." msgstr "" -msgid "The method will be passed ``NULL`` as the first parameter rather than an instance of the type. This is used to create *static methods*, similar to what is created when using the :deco:`staticmethod` built-in decorator." +msgid "The method will be passed ``NULL`` as the first parameter rather than an instance of the type. This is used to create *static methods*, similar to what is created when using the :func:`staticmethod` built-in function." msgstr "" msgid "One other constant controls whether a method is loaded in place of another definition with the same method name." diff --git a/c-api/subinterpreters.po b/c-api/subinterpreters.po index ddf903b22..e0257aa01 100644 --- a/c-api/subinterpreters.po +++ b/c-api/subinterpreters.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/c-api/synchronization.po b/c-api/synchronization.po index 78cd1c0e6..d693708c3 100644 --- a/c-api/synchronization.po +++ b/c-api/synchronization.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/c-api/sys.po b/c-api/sys.po index c78f1f1f6..06ca1bcf4 100644 --- a/c-api/sys.po +++ b/c-api/sys.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/threads.po b/c-api/threads.po index b7626dba7..b2fa14bf6 100644 --- a/c-api/threads.po +++ b/c-api/threads.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" @@ -456,7 +456,7 @@ msgstr "" msgid "This function only runs pending calls in the main interpreter." msgstr "" -msgid "Asynchronously raise an exception in a thread. The *id* argument is the thread id of the target thread; *exc* is the exception object to be raised. This function does not :term:`steal` any references to *exc*. To prevent naive misuse, you must write your own C extension to call this. Must be called with an :term:`attached thread state`. Returns the number of thread states modified; this is normally one, but will be zero if the thread id isn't found. If *exc* is ``NULL``, the pending exception (if any) for the thread is cleared. This raises no exceptions." +msgid "Asynchronously raise an exception in a thread. The *id* argument is the thread id of the target thread; *exc* is the exception object to be raised. This function does not steal any references to *exc*. To prevent naive misuse, you must write your own C extension to call this. Must be called with an :term:`attached thread state`. Returns the number of thread states modified; this is normally one, but will be zero if the thread id isn't found. If *exc* is ``NULL``, the pending exception (if any) for the thread is cleared. This raises no exceptions." msgstr "" msgid "The type of the *id* parameter changed from :c:expr:`long` to :c:expr:`unsigned long`." diff --git a/c-api/time.po b/c-api/time.po index af03410e6..e9ffddc69 100644 --- a/c-api/time.po +++ b/c-api/time.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-05-11 01:07+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/tls.po b/c-api/tls.po index 1072341cc..a704278c5 100644 --- a/c-api/tls.po +++ b/c-api/tls.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/c-api/tuple.po b/c-api/tuple.po index a7f842954..b64c462cf 100644 --- a/c-api/tuple.po +++ b/c-api/tuple.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:50+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -68,7 +68,7 @@ msgstr "" msgid "Insert a reference to object *o* at position *pos* of the tuple pointed to by *p*. Return ``0`` on success. If *pos* is out of bounds, return ``-1`` and set an :exc:`IndexError` exception." msgstr "" -msgid "This function \":term:`steals `\" a reference to *o* and discards a reference to an item already in the tuple at the affected position (unless it was NULL)." +msgid "This function \"steals\" a reference to *o* and discards a reference to an item already in the tuple at the affected position." msgstr "" msgid "Like :c:func:`PyTuple_SetItem`, but does no error checking, and should *only* be used to fill in brand new tuples." @@ -77,7 +77,7 @@ msgstr "" msgid "Bounds checking is performed as an assertion if Python is built in :ref:`debug mode ` or :option:`with assertions <--with-assertions>`." msgstr "" -msgid "This function \":term:`steals `\" a reference to *o*, and, unlike :c:func:`PyTuple_SetItem`, does *not* discard a reference to any item that is being replaced; any reference in the tuple at position *pos* will be leaked." +msgid "This function \"steals\" a reference to *o*, and, unlike :c:func:`PyTuple_SetItem`, does *not* discard a reference to any item that is being replaced; any reference in the tuple at position *pos* will be leaked." msgstr "" msgid "This macro should *only* be used on tuples that are newly created. Using this macro on a tuple that is already in use (or in other words, has a refcount > 1) could lead to undefined behavior." @@ -149,7 +149,7 @@ msgstr "" msgid "Sets the field at index *pos* of the struct sequence *p* to value *o*. Like :c:func:`PyTuple_SET_ITEM`, this should only be used to fill in brand new instances." msgstr "" -msgid "This function \":term:`steals `\" a reference to *o*." +msgid "This function \"steals\" a reference to *o*." msgstr "" msgid "Alias to :c:func:`PyStructSequence_SetItem`." diff --git a/c-api/type.po b/c-api/type.po index 785296949..79336411b 100644 --- a/c-api/type.po +++ b/c-api/type.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:50+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -308,7 +308,7 @@ msgstr "" msgid "If zero, :c:member:`~PyTypeObject.tp_itemsize` is inherited. Extending arbitrary variable-sized classes is dangerous, since some types use a fixed offset for variable-sized memory, which can then overlap fixed-sized memory used by a subclass. To help prevent mistakes, inheriting ``itemsize`` is only possible in the following situations:" msgstr "" -msgid "The base is not variable-sized (its :c:member:`~PyTypeObject.tp_itemsize` is zero)." +msgid "The base is not variable-sized (its :c:member:`~PyTypeObject.tp_itemsize`)." msgstr "" msgid "The requested :c:member:`PyType_Spec.basicsize` is positive, suggesting that the memory layout of the base class is known." diff --git a/c-api/typehints.po b/c-api/typehints.po index 1b2f1da69..ca7beff8d 100644 --- a/c-api/typehints.po +++ b/c-api/typehints.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/typeobj.po b/c-api/typeobj.po index bd65827b2..a1efe89ab 100644 --- a/c-api/typeobj.po +++ b/c-api/typeobj.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:50+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -1496,7 +1496,7 @@ msgstr "" msgid "This flag is present in header files, but is not be used. It will be removed in a future version of CPython" msgstr "" -msgid "This macro does nothing. Historically, this would indicate that the :c:member:`~PyTypeObject.tp_version_tag` field was available and initialized." +msgid "This is a :term:`soft deprecated` macro that does nothing. Historically, this would indicate that the :c:member:`~PyTypeObject.tp_version_tag` field was available and initialized." msgstr "" msgid "This bit indicates that instances of this type will have an \"inline values\" array (containing the object's attributes) placed directly after the end of the object." @@ -2401,7 +2401,7 @@ msgstr "" msgid "The export counter decrement in step (1) must be atomic." msgstr "" -msgid "Resource cleanup when the counter reaches zero must be done atomically, as the final release may race with concurrent releases from other threads and deallocation must only happen once." +msgid "Resource cleanup when the counter reaches zero must be done atomically, as the final release may race with concurrent releases from other threads and dellocation must only happen once." msgstr "" msgid "The exporter MUST use the :c:member:`~Py_buffer.internal` field to keep track of buffer-specific resources. This field is guaranteed to remain constant, while a consumer MAY pass a copy of the original buffer as the *view* argument." diff --git a/c-api/unicode.po b/c-api/unicode.po index 03d66dc17..a0826fb39 100644 --- a/c-api/unicode.po +++ b/c-api/unicode.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:50+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -540,7 +540,7 @@ msgstr "" msgid "The API returns ``NULL`` if there was an error. The caller is responsible for decref'ing the returned objects." msgstr "" -msgid "Append the string *right* to the end of *p_left*. *p_left* must point to a :term:`strong reference` to a Unicode object; :c:func:`!PyUnicode_Append` releases (\":term:`steals `\") this reference." +msgid "Append the string *right* to the end of *p_left*. *p_left* must point to a :term:`strong reference` to a Unicode object; :c:func:`!PyUnicode_Append` releases (\"steals\") this reference." msgstr "" msgid "On error, set *\\*p_left* to ``NULL`` and set an exception." diff --git a/c-api/utilities.po b/c-api/utilities.po index cdd7ab33c..eb3b64e10 100644 --- a/c-api/utilities.po +++ b/c-api/utilities.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:50+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/c-api/veryhigh.po b/c-api/veryhigh.po index 025e6f785..f13f554fe 100644 --- a/c-api/veryhigh.po +++ b/c-api/veryhigh.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -177,85 +177,9 @@ msgstr "" msgid "See :ref:`compiler flags ` in documentation of the :py:mod:`!ast` Python module, which exports these constants under the same names." msgstr "" -msgid "Low-level flags" -msgstr "" - -msgid "The following flags and masks serve narrow needs of the standard library and interactive interpreters. Code outside the standard library rarely has a reason to use them. They are considered implementation details and may change at any time." -msgstr "" - -msgid "This flag is a private interface between the compiler and the :mod:`codeop` module. Do not use it; its behavior is unsupported and may change without warning." -msgstr "" - -msgid "With this flag set, when compilation fails because the source text ends where more input is expected, for example in the middle of an indented block or an unterminated string literal, the error raised is the undocumented ``_IncompleteInputError``, a subclass of :exc:`SyntaxError`. The :mod:`codeop` module sets this flag, together with :c:macro:`PyCF_DONT_IMPLY_DEDENT`, to tell input that is incomplete apart from input with a real syntax error, so that interactive interpreters know when to prompt for another line instead of reporting an error." -msgstr "" - -msgid "By default, when compiling with the :c:var:`Py_single_input` start symbol, reaching the end of the source text implicitly closes any open indented blocks. With this flag set, open blocks are only closed if the last line of the source ends with a newline; otherwise, compilation fails with a :exc:`SyntaxError`:" -msgstr "" - -msgid "" -"PyCompilerFlags flags = {\n" -" .cf_flags = 0,\n" -" .cf_feature_version = PY_MINOR_VERSION,\n" -"};\n" -"const char *source = \"if a:\\n pass\";\n" -"\n" -"/* The \"if\" block is closed implicitly;\n" -" this returns a code object: */\n" -"Py_CompileStringFlags(source, \"\", Py_single_input, &flags);\n" -"\n" -"/* With the flag, this fails with a SyntaxError,\n" -" because the last line does not end with a newline: */\n" -"flags.cf_flags = PyCF_DONT_IMPLY_DEDENT;\n" -"Py_CompileStringFlags(source, \"\", Py_single_input, &flags);" -msgstr "" - -msgid "The :mod:`codeop` module uses this flag to detect incomplete interactive input. While the user is still typing inside an indented block, the source does not yet end with a newline, so it fails to compile and the user is prompted for another line." -msgstr "" - -msgid "Read the source text as UTF-8, ignoring its :pep:`263` encoding declaration (\"coding cookie\"), if any:" -msgstr "" - -msgid "" -"PyCompilerFlags flags = {\n" -" .cf_flags = 0,\n" -" .cf_feature_version = PY_MINOR_VERSION,\n" -"};\n" -"const char *source = \"# coding: latin-1\\ns = '\\xe9'\\n\";\n" -"\n" -"/* The coding cookie is honored: byte 0xE9 is decoded as\n" -" Latin-1, and this returns a code object that sets s to \"é\": */\n" -"Py_CompileStringFlags(source, \"\", Py_file_input, &flags);\n" -"\n" -"/* With the flag, the cookie is ignored and compilation fails\n" -" with a SyntaxError, because 0xE9 is not valid UTF-8: */\n" -"flags.cf_flags = PyCF_IGNORE_COOKIE;\n" -"Py_CompileStringFlags(source, \"\", Py_file_input, &flags);" -msgstr "" - -msgid "The :func:`compile`, :func:`eval` and :func:`exec` built-in functions set this flag when the source is a :class:`str` object, because they pass the text to the parser encoded as UTF-8." -msgstr "" - -msgid "Mark the source text as known to be UTF-8 encoded. The :func:`compile`, :func:`eval` and :func:`exec` built-in functions set this flag, but it currently has no effect." -msgstr "" - msgid "The \"``PyCF``\" flags above can be combined with \"``CO_FUTURE``\" flags such as :c:macro:`CO_FUTURE_ANNOTATIONS` to enable features normally selectable using :ref:`future statements `. See :ref:`c_codeobject_flags` for a complete list." msgstr "" -msgid "The following masks combine several flags:" -msgstr "" - -msgid "Bitmask of all ``CO_FUTURE`` flags (see :ref:`c_codeobject_flags`), which select features normally enabled by :ref:`future statements `. When code compiled with a ``PyCompilerFlags *flags`` argument contains a ``from __future__ import`` statement, the flag for the imported feature is added to *flags*, so that code executed later in the same context inherits it." -msgstr "" - -msgid "Do not use this mask in new code. It is kept only so that old code passing its flags to :func:`compile` keeps working." -msgstr "" - -msgid "Bitmask of flags for obsolete future features that no longer have any effect." -msgstr "" - -msgid "Bitmask of all ``PyCF`` flags that change how the source is compiled, such as :c:macro:`PyCF_ONLY_AST`. The :func:`compile` built-in function uses this mask to validate its *flags* argument." -msgstr "" - msgid "Available start symbols" msgstr "" diff --git a/c-api/weakref.po b/c-api/weakref.po index 4742a4168..5fb003089 100644 --- a/c-api/weakref.po +++ b/c-api/weakref.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:50+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -41,13 +41,13 @@ msgstr "" msgid "Return non-zero if *ob* is a proxy object. This function always succeeds." msgstr "" -msgid "Return a weak reference object for the object *ob*. This will always return a new reference, but is not guaranteed to create a new object; an existing reference object may be returned. The second parameter, *callback*, can be a callable object that receives notification when *ob* is garbage collected; it should accept a single parameter, which will be the weak reference object itself. *callback* may also be ``None`` or ``NULL``. If *ob* is not a weakly referenceable object, this will raise :exc:`TypeError` and return ``NULL``." +msgid "Return a weak reference object for the object *ob*. This will always return a new reference, but is not guaranteed to create a new object; an existing reference object may be returned. The second parameter, *callback*, can be a callable object that receives notification when *ob* is garbage collected; it should accept a single parameter, which will be the weak reference object itself. *callback* may also be ``None`` or ``NULL``. If *ob* is not a weakly referenceable object, or if *callback* is not callable, ``None``, or ``NULL``, this will return ``NULL`` and raise :exc:`TypeError`." msgstr "" msgid ":c:func:`PyType_SUPPORTS_WEAKREFS` for checking if *ob* is weakly referenceable." msgstr "" -msgid "Return a weak reference proxy object for the object *ob*. This will always return a new reference, but is not guaranteed to create a new object; an existing proxy object may be returned. The second parameter, *callback*, can be a callable object that receives notification when *ob* is garbage collected; it should accept a single parameter, which will be the weak reference object itself. *callback* may also be ``None`` or ``NULL``. If *ob* weakly referenceable object, this will raise :exc:`TypeError` and return ``NULL``." +msgid "Return a weak reference proxy object for the object *ob*. This will always return a new reference, but is not guaranteed to create a new object; an existing proxy object may be returned. The second parameter, *callback*, can be a callable object that receives notification when *ob* is garbage collected; it should accept a single parameter, which will be the weak reference object itself. *callback* may also be ``None`` or ``NULL``. If *ob* is not a weakly referenceable object, or if *callback* is not callable, ``None``, or ``NULL``, this will return ``NULL`` and raise :exc:`TypeError`." msgstr "" msgid "Get a :term:`strong reference` to the referenced object from a weak reference, *ref*, into *\\*pobj*." diff --git a/contents.po b/contents.po index 555d2d0e4..b6427159e 100644 --- a/contents.po +++ b/contents.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-17 04:35+0000\n" "PO-Revision-Date: 2021-06-28 00:47+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/copyright.po b/copyright.po index 20de3b9fa..8381c9346 100644 --- a/copyright.po +++ b/copyright.po @@ -15,10 +15,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:47+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/deprecations/c-api-pending-removal-in-3.14.po b/deprecations/c-api-pending-removal-in-3.14.po index 96b378692..85a203521 100644 --- a/deprecations/c-api-pending-removal-in-3.14.po +++ b/deprecations/c-api-pending-removal-in-3.14.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-08-02 14:17+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/deprecations/c-api-pending-removal-in-3.15.po b/deprecations/c-api-pending-removal-in-3.15.po index 7e8acc9c9..23ccfde58 100644 --- a/deprecations/c-api-pending-removal-in-3.15.po +++ b/deprecations/c-api-pending-removal-in-3.15.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-08-02 14:17+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/deprecations/c-api-pending-removal-in-3.16.po b/deprecations/c-api-pending-removal-in-3.16.po index 2c58be540..b686d7df8 100644 --- a/deprecations/c-api-pending-removal-in-3.16.po +++ b/deprecations/c-api-pending-removal-in-3.16.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-17 04:35+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/deprecations/c-api-pending-removal-in-3.18.po b/deprecations/c-api-pending-removal-in-3.18.po index d4412efa9..f5e1f7aff 100644 --- a/deprecations/c-api-pending-removal-in-3.18.po +++ b/deprecations/c-api-pending-removal-in-3.18.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/deprecations/c-api-pending-removal-in-future.po b/deprecations/c-api-pending-removal-in-future.po index 0a8cf1c6c..3db8fd8ac 100644 --- a/deprecations/c-api-pending-removal-in-future.po +++ b/deprecations/c-api-pending-removal-in-future.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-08-02 14:17+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/deprecations/index.po b/deprecations/index.po index 8a09fbcba..a98b0b009 100644 --- a/deprecations/index.po +++ b/deprecations/index.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-07-29 04:07+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -57,6 +57,12 @@ msgstr "" msgid "``load_module()`` method: use ``exec_module()`` instead." msgstr "" +msgid ":class:`locale`:" +msgstr "" + +msgid "The :func:`~locale.getdefaultlocale` function has been deprecated since Python 3.11. Its removal was originally planned for Python 3.13 (:gh:`90817`), but has been postponed to Python 3.15. Use :func:`~locale.getlocale`, :func:`~locale.setlocale`, and :func:`~locale.getencoding` instead. (Contributed by Hugo van Kemenade in :gh:`111187`.)" +msgstr "" + msgid ":mod:`pathlib`:" msgstr "" @@ -96,7 +102,7 @@ msgstr "" msgid "When using the functional syntax of :class:`~typing.TypedDict`\\s, failing to pass a value to the *fields* parameter (``TD = TypedDict(\"TD\")``) or passing ``None`` (``TD = TypedDict(\"TD\", None)``) has been deprecated since Python 3.13. Use ``class TD(TypedDict): pass`` or ``TD = TypedDict(\"TD\", {})`` to create a TypedDict with zero field." msgstr "" -msgid "The :deco:`typing.no_type_check_decorator` decorator function has been deprecated since Python 3.13. After eight years in the :mod:`typing` module, it has yet to be supported by any major type checker." +msgid "The :func:`typing.no_type_check_decorator` decorator function has been deprecated since Python 3.13. After eight years in the :mod:`typing` module, it has yet to be supported by any major type checker." msgstr "" msgid ":mod:`wave`:" diff --git a/deprecations/pending-removal-in-3.13.po b/deprecations/pending-removal-in-3.13.po index 79ed62c94..cc9cc8e16 100644 --- a/deprecations/pending-removal-in-3.13.po +++ b/deprecations/pending-removal-in-3.13.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-17 04:35+0000\n" "PO-Revision-Date: 2024-07-26 14:16+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/deprecations/pending-removal-in-3.14.po b/deprecations/pending-removal-in-3.14.po index 20c456b7e..a46f5eb0a 100644 --- a/deprecations/pending-removal-in-3.14.po +++ b/deprecations/pending-removal-in-3.14.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-07-20 00:54+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/deprecations/pending-removal-in-3.15.po b/deprecations/pending-removal-in-3.15.po index 074e441a1..0030131e7 100644 --- a/deprecations/pending-removal-in-3.15.po +++ b/deprecations/pending-removal-in-3.15.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-07-20 00:54+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -54,6 +54,12 @@ msgstr "" msgid "``load_module()`` method: use ``exec_module()`` instead." msgstr "" +msgid ":class:`locale`:" +msgstr "" + +msgid "The :func:`~locale.getdefaultlocale` function has been deprecated since Python 3.11. Its removal was originally planned for Python 3.13 (:gh:`90817`), but has been postponed to Python 3.15. Use :func:`~locale.getlocale`, :func:`~locale.setlocale`, and :func:`~locale.getencoding` instead. (Contributed by Hugo van Kemenade in :gh:`111187`.)" +msgstr "" + msgid ":mod:`pathlib`:" msgstr "" @@ -93,7 +99,7 @@ msgstr "" msgid "When using the functional syntax of :class:`~typing.TypedDict`\\s, failing to pass a value to the *fields* parameter (``TD = TypedDict(\"TD\")``) or passing ``None`` (``TD = TypedDict(\"TD\", None)``) has been deprecated since Python 3.13. Use ``class TD(TypedDict): pass`` or ``TD = TypedDict(\"TD\", {})`` to create a TypedDict with zero field." msgstr "" -msgid "The :deco:`typing.no_type_check_decorator` decorator function has been deprecated since Python 3.13. After eight years in the :mod:`typing` module, it has yet to be supported by any major type checker." +msgid "The :func:`typing.no_type_check_decorator` decorator function has been deprecated since Python 3.13. After eight years in the :mod:`typing` module, it has yet to be supported by any major type checker." msgstr "" msgid ":mod:`wave`:" diff --git a/deprecations/pending-removal-in-3.16.po b/deprecations/pending-removal-in-3.16.po index ba1dd7272..02cf24ded 100644 --- a/deprecations/pending-removal-in-3.16.po +++ b/deprecations/pending-removal-in-3.16.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-07-20 00:54+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/deprecations/pending-removal-in-3.17.po b/deprecations/pending-removal-in-3.17.po index 41cfa5b08..44dea1c82 100644 --- a/deprecations/pending-removal-in-3.17.po +++ b/deprecations/pending-removal-in-3.17.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/deprecations/pending-removal-in-3.18.po b/deprecations/pending-removal-in-3.18.po index b2f32bdea..b7573783f 100644 --- a/deprecations/pending-removal-in-3.18.po +++ b/deprecations/pending-removal-in-3.18.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/deprecations/pending-removal-in-3.19.po b/deprecations/pending-removal-in-3.19.po index 47a1313ad..fca62156b 100644 --- a/deprecations/pending-removal-in-3.19.po +++ b/deprecations/pending-removal-in-3.19.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/deprecations/pending-removal-in-future.po b/deprecations/pending-removal-in-future.po index c86589a0f..c2c940b70 100644 --- a/deprecations/pending-removal-in-future.po +++ b/deprecations/pending-removal-in-future.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-07-20 00:54+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/distributing/index.po b/distributing/index.po index 96d2c1604..7e9318782 100644 --- a/distributing/index.po +++ b/distributing/index.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:50+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/extending/building.po b/extending/building.po index 76cd9c2ec..89cce51f9 100644 --- a/extending/building.po +++ b/extending/building.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:51+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/extending/embedding.po b/extending/embedding.po index 7b15a4b3c..861826635 100644 --- a/extending/embedding.po +++ b/extending/embedding.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:51+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/extending/extending.po b/extending/extending.po index 51478f7fd..6933d9166 100644 --- a/extending/extending.po +++ b/extending/extending.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:51+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -459,7 +459,7 @@ msgstr "" msgid "So far we have concentrated on making C functions callable from Python. The reverse is also useful: calling Python functions from C. This is especially the case for libraries that support so-called \"callback\" functions. If a C interface makes use of callbacks, the equivalent Python often needs to provide a callback mechanism to the Python programmer; the implementation will require calling the Python callback functions from a C callback. Other uses are also imaginable." msgstr "" -msgid "Fortunately, the Python interpreter is easily called recursively, and there is a standard interface to call a Python function. (If you're interested in how to call the Python parser with a particular string as input, see :ref:`veryhigh`.)" +msgid "Fortunately, the Python interpreter is easily called recursively, and there is a standard interface to call a Python function. (I won't dwell on how to call the Python parser with a particular string as input --- if you're interested, have a look at the implementation of the :option:`-c` command line option in :file:`Modules/main.c` from the Python source code.)" msgstr "" msgid "Calling a Python function is easy. First, the Python program must somehow pass you the Python function object. You should provide a function (or some other interface) to do this. When this function is called, save a pointer to the Python function object (be careful to :c:func:`Py_INCREF` it!) in a global variable --- or wherever you see fit. For example, the following function might be part of a module definition::" @@ -765,7 +765,7 @@ msgstr "" msgid "Since Python makes heavy use of :c:func:`malloc` and :c:func:`free`, it needs a strategy to avoid memory leaks as well as the use of freed memory. The chosen method is called :dfn:`reference counting`. The principle is simple: every object contains a counter, which is incremented when a reference to the object is stored somewhere, and which is decremented when a reference to it is deleted. When the counter reaches zero, the last reference to the object has been deleted and the object is freed." msgstr "" -msgid "An alternative strategy is called :dfn:`automatic garbage collection`. (Sometimes, reference counting is also referred to as a garbage collection strategy, hence the use of \"automatic\" to distinguish the two.) The big advantage of automatic garbage collection is that the user doesn't need to call :c:func:`free` explicitly. (Another claimed advantage is an improvement in speed or memory usage --- this is no hard fact however.) The disadvantage is that for C, there is no truly portable automatic garbage collector, while reference counting can be implemented portably (as long as the functions :c:func:`malloc` and :c:func:`free` are available --- which the C Standard guarantees). Maybe some day a sufficiently portable automatic garbage collector will be available for C. Until then, we'll have to live with reference counts." +msgid "An alternative strategy is called :dfn:`automatic garbage collection`. (Sometimes, reference counting is also referred to as a garbage collection strategy, hence my use of \"automatic\" to distinguish the two.) The big advantage of automatic garbage collection is that the user doesn't need to call :c:func:`free` explicitly. (Another claimed advantage is an improvement in speed or memory usage --- this is no hard fact however.) The disadvantage is that for C, there is no truly portable automatic garbage collector, while reference counting can be implemented portably (as long as the functions :c:func:`malloc` and :c:func:`free` are available --- which the C Standard guarantees). Maybe some day a sufficiently portable automatic garbage collector will be available for C. Until then, we'll have to live with reference counts." msgstr "" msgid "While Python uses the traditional reference counting implementation, it also offers a cycle detector that works to detect reference cycles. This allows applications to not worry about creating direct or indirect circular references; these are the weakness of garbage collection implemented using only reference counting. Reference cycles consist of objects which contain (possibly indirect) references to themselves, so that each object in the cycle has a reference count which is non-zero. Typical reference counting implementations are not able to reclaim the memory belonging to any objects in a reference cycle, or referenced from the objects in the cycle, even though there are no further references to the cycle itself." diff --git a/extending/index.po b/extending/index.po index 17852e6af..cb617ebef 100644 --- a/extending/index.po +++ b/extending/index.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/extending/newtypes.po b/extending/newtypes.po index 560920b51..b680816e6 100644 --- a/extending/newtypes.po +++ b/extending/newtypes.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:52+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/extending/newtypes_tutorial.po b/extending/newtypes_tutorial.po index eae368146..415229571 100644 --- a/extending/newtypes_tutorial.po +++ b/extending/newtypes_tutorial.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:52+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/extending/windows.po b/extending/windows.po index ce5389ecb..abbb6b94c 100644 --- a/extending/windows.po +++ b/extending/windows.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/faq/design.po b/faq/design.po index 8e463720f..2aeadd428 100644 --- a/faq/design.po +++ b/faq/design.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:52+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -224,7 +224,7 @@ msgstr "" msgid "Why isn't there a switch or case statement in Python?" msgstr "" -msgid "In general, structured switch statements execute one block of code when an expression has a particular value or set of values. Since Python 3.10 one can easily match literal values, or constants within a namespace, with a ``match ... case`` statement. See :ref:`the specification ` and :ref:`the tutorial ` for more information about :keyword:`match` statements. An older alternative is a sequence of ``if... elif... elif... else``." +msgid "In general, structured switch statements execute one block of code when an expression has a particular value or set of values. Since Python 3.10 one can easily match literal values, or constants within a namespace, with a ``match ... case`` statement. An older alternative is a sequence of ``if... elif... elif... else``." msgstr "" msgid "For cases where you need to choose from a very large number of possibilities, you can create a dictionary mapping case values to functions to call. For example::" diff --git a/faq/extending.po b/faq/extending.po index 4b441631a..df6dee6d7 100644 --- a/faq/extending.po +++ b/faq/extending.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:52+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/faq/general.po b/faq/general.po index 6fb86a72d..9b7ac3983 100644 --- a/faq/general.po +++ b/faq/general.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:52+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/faq/gui.po b/faq/gui.po index 28dfccd93..77f99862d 100644 --- a/faq/gui.po +++ b/faq/gui.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:52+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/faq/index.po b/faq/index.po index 42f13aab8..ea9de2d61 100644 --- a/faq/index.po +++ b/faq/index.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-17 04:35+0000\n" "PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/faq/installed.po b/faq/installed.po index 66060f892..30294b31b 100644 --- a/faq/installed.po +++ b/faq/installed.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:52+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/faq/library.po b/faq/library.po index 276d5c65f..5491709be 100644 --- a/faq/library.po +++ b/faq/library.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:52+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/faq/programming.po b/faq/programming.po index 2ce5cbea7..280d6b119 100644 --- a/faq/programming.po +++ b/faq/programming.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:52+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -1832,7 +1832,7 @@ msgstr "" msgid "How do I cache method calls?" msgstr "" -msgid "The two principal tools for caching methods are :deco:`functools.cached_property` and :deco:`functools.lru_cache`. The former stores results at the instance level and the latter at the class level." +msgid "The two principal tools for caching methods are :func:`functools.cached_property` and :func:`functools.lru_cache`. The former stores results at the instance level and the latter at the class level." msgstr "" msgid "The ``cached_property`` approach only works with methods that do not take any arguments. It does not create a reference to the instance. The cached method result will be kept only as long as the instance is alive." diff --git a/faq/windows.po b/faq/windows.po index 7d493c64e..7041e4e47 100644 --- a/faq/windows.po +++ b/faq/windows.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:52+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/glossary.po b/glossary.po index e4bfe397f..1d6e4234a 100644 --- a/glossary.po +++ b/glossary.po @@ -16,255 +16,247 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" -"PO-Revision-Date: 2026-08-26 08:03+0330\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" +"PO-Revision-Date: 2021-06-28 00:47+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=(n > 1);\n" -"X-Generator: Poedit 3.6\n" msgid "Glossary" -msgstr "واژه‌نامه" +msgstr "" msgid "``>>>``" -msgstr "``>>>``" +msgstr "" msgid "The default Python prompt of the :term:`interactive` shell. Often seen for code examples which can be executed interactively in the interpreter." -msgstr "اعلان پیش‌فرض پایتون در پوستهٔ :term:`تعاملی `. اغلب برای نمونه‌های کدی دیده می‌شود که می‌توان آن‌ها را به‌صورت تعاملی در مفسر اجرا کرد." +msgstr "" msgid "``...``" -msgstr "``...``" +msgstr "" msgid "Can refer to:" -msgstr "می‌تواند به موارد زیر اشاره کند:" +msgstr "" msgid "The default Python prompt of the :term:`interactive` shell when entering the code for an indented code block, when within a pair of matching left and right delimiters (parentheses, square brackets, curly braces or triple quotes), or after specifying a decorator." -msgstr "اعلان پیش‌فرض پایتون در پوستهٔ :term:`تعاملی ` هنگام وارد کردن کد برای یک بلوک کد تورفته، زمانی که درون یک جفت جداکنندهٔ چپ و راست متناظر (پرانتزها، کروشه‌ها، آکولادها یا علامت‌های نقل‌قول سه‌گانه) قرار دارید، یا پس از مشخص کردن یک دکوراتور." +msgstr "" msgid "The three dots form of the :ref:`Ellipsis ` object." -msgstr "شکل سه‌نقطه‌ای شیء :ref:`Ellipsis `." +msgstr "" msgid "abstract base class" -msgstr "کلاس پایهٔ انتزاعی" +msgstr "" msgid "Abstract base classes complement :term:`duck-typing` by providing a way to define interfaces when other techniques like :func:`hasattr` would be clumsy or subtly wrong (for example with :ref:`magic methods `). ABCs introduce virtual subclasses, which are classes that don't inherit from a class but are still recognized by :func:`isinstance` and :func:`issubclass`; see the :mod:`abc` module documentation. Python comes with many built-in ABCs for data structures (in the :mod:`collections.abc` module), numbers (in the :mod:`numbers` module), streams (in the :mod:`io` module), import finders and loaders (in the :mod:`importlib.abc` module). You can create your own ABCs with the :mod:`abc` module." -msgstr "کلاس‌های پایهٔ انتزاعی با فراهم کردن روشی برای تعریف رابط‌ها، زمانی که تکنیک‌های دیگری مانند :func:`hasattr` دست‌وپاگیر یا به‌طور ضمنی نادرست هستند (برای مثال با :ref:`magic methods `)، :term:`نوع‌دهی اردکی ` را تکمیل می‌کنند. ABCها زیرکلاس‌های مجازی معرفی می‌کنند، که کلاس‌هایی هستند که از یک کلاس دیگر به ارث نمی‌برند اما همچنان توسط :func:`isinstance` و :func:`issubclass` شناخته می‌شوند؛ مستندات ماژول :mod:`abc` را ببینید. پایتون همراه با ABCهای توکار بسیاری برای ساختارهای داده (در ماژول :mod:`collections.abc`)، اعداد (در ماژول :mod:`numbers`)، جریان‌ها (در ماژول :mod:`io`)، یابنده‌ها و بارگذارهای ایمپورت (در ماژول :mod:`importlib.abc`) ارائه می‌شود. شما می‌توانید ABCهای سفارشی خود را با ماژول :mod:`abc` ایجاد کنید." +msgstr "" msgid "annotate function" -msgstr "توابع حاشیه‌گذاری" +msgstr "" msgid "A callable that can be called to retrieve the :term:`annotations ` of an object. Annotate functions are usually :term:`functions `, automatically generated as the :attr:`~object.__annotate__` attribute of functions, classes, and modules. Annotate functions are a subset of :term:`evaluate functions `." -msgstr "فراخوانی‌پذیری که می‌توان آن را برای بازیابی :term:`حاشیه‌گذاری ` یک شیء فراخوانی کرد. توابع حاشیه‌گذاری معمولاً :term:`توابعی ` هستند که به‌صورت خودکار به‌عنوان ویژگی :attr:`~object.__annotate__` توابع، کلاس‌ها و ماژول‌ها تولید می‌شوند. توابع حاشیه‌گذاری زیرمجموعه‌ای از :term:`توابع ارزیابی ` هستند." +msgstr "" msgid "annotation" -msgstr "حاشیه‌گذاری" +msgstr "" msgid "A label associated with a variable, a class attribute or a function parameter or return value, used by convention as a :term:`type hint`." -msgstr "برچسبی مرتبط با یک متغیر، یک ویژگی کلاس، یا یک پارامتر تابع یا مقدار بازگشتی، که طبق قرارداد به‌عنوان یک :term:`راهنمای نوع ` استفاده می‌شود." +msgstr "" msgid "Annotations of local variables cannot be accessed at runtime, but annotations of global variables, class attributes, and functions can be retrieved by calling :func:`annotationlib.get_annotations` on modules, classes, and functions, respectively." -msgstr "حاشیه‌گذاری‌های متغیرهای محلی را نمی‌توان در زمان ران‌تایم دسترسی کرد، اما حاشیه‌گذاری‌های متغیرهای سراسری، ویژگی‌های کلاس و توابع را می‌توان با فراخوانی :func:`annotationlib.get_annotations` به‌ترتیب روی ماژول‌ها، کلاس‌ها و توابع بازیابی کرد." +msgstr "" msgid "See :term:`variable annotation`, :term:`function annotation`, :pep:`484`, :pep:`526`, and :pep:`649`, which describe this functionality. Also see :ref:`annotations-howto` for best practices on working with annotations." -msgstr "همچنین به :term:`حاشیه‌نویسی متغیر `، :term:`حاشیه‌گذاری تابع `، :pep:`484`، :pep:`526` و :pep:`649` مراجعه کنید که این قابلیت را توضیح می‌دهند. همچنین برای بهترین روش‌ها در کار با حاشیه‌گذاری‌ها، :ref:`annotations-howto` را ببینید." +msgstr "" msgid "argument" -msgstr "آرگومان" +msgstr "" msgid "A value passed to a :term:`function` (or :term:`method`) when calling the function. There are two kinds of argument:" -msgstr "مقداری که هنگام فراخوانی یک :term:`تابع ` (یا :term:`متد `) به آن تابع ارسال می‌شود. دو نوع آرگومان وجود دارد:" +msgstr "" msgid ":dfn:`keyword argument`: an argument preceded by an identifier (e.g. ``name=``) in a function call or passed as a value in a dictionary preceded by ``**``. For example, ``3`` and ``5`` are both keyword arguments in the following calls to :func:`complex`::" -msgstr ":dfn:`keyword argument`: آرگومانی که در فراخوانی تابع با یک شناسه (برای مثال ``name=``) پیش از آن قرار گرفته است، یا به‌عنوان مقداری در یک دیکشنری که پیش از آن ``**`` آمده است، ارسال می‌شود. برای مثال، ``3`` و ``5`` هر دو در فراخوانی‌های زیر از :func:`complex` آرگومان کلیدواژه‌ای هستند::" +msgstr "" msgid "" "complex(real=3, imag=5)\n" "complex(**{'real': 3, 'imag': 5})" msgstr "" -"complex(real=3, imag=5)\n" -"complex(**{'real': 3, 'imag': 5})" msgid ":dfn:`positional argument`: an argument that is not a keyword argument. Positional arguments can appear at the beginning of an argument list and/or be passed as elements of an :term:`iterable` preceded by ``*``. For example, ``3`` and ``5`` are both positional arguments in the following calls::" -msgstr ":dfn:`positional argument`: آرگومانی که آرگومان کلیدواژه‌ای نیست. آرگومان‌های جایگاهی می‌توانند در ابتدای یک فهرست آرگومان ظاهر شوند و/یا به‌عنوان عناصر یک :term:`تکرارپذیر ` که پیش از آن ``*`` آمده است، ارسال شوند. برای مثال، ``3`` و ``5`` هر دو در فراخوانی‌های زیر آرگومان جایگاهی هستند::" +msgstr "" msgid "" "complex(3, 5)\n" "complex(*(3, 5))" msgstr "" -"complex(3, 5)\n" -"complex(*(3, 5))" msgid "Arguments are assigned to the named local variables in a function body. See the :ref:`calls` section for the rules governing this assignment. Syntactically, any expression can be used to represent an argument; the evaluated value is assigned to the local variable." -msgstr "آرگومان‌ها به متغیرهای محلی نام‌گذاری‌شده در بدنهٔ یک تابع اختصاص داده می‌شوند. برای قوانین حاکم بر این تخصیص، بخش :ref:`calls` را ببینید. از نظر سینتکس، هر عبارتی می‌تواند برای نمایش یک آرگومان استفاده شود؛ مقدار ارزیابی‌شده به متغیر محلی اختصاص داده می‌شود." +msgstr "" msgid "See also the :term:`parameter` glossary entry, the FAQ question on :ref:`the difference between arguments and parameters `, and :pep:`362`." -msgstr "همچنین به ورودی واژه‌نامه‌ای :term:`پارامتر `، پرسش متداول دربارهٔ :ref:`تفاوت بین آرگومان‌ها و پارامترها ` و :pep:`362` مراجعه کنید." +msgstr "" msgid "asynchronous context manager" -msgstr "مدیر زمینهٔ ناهمگام" +msgstr "" msgid "An object which controls the environment seen in an :keyword:`async with` statement by defining :meth:`~object.__aenter__` and :meth:`~object.__aexit__` methods. Introduced by :pep:`492`." -msgstr "شی‌ءای که با تعریف متدهای :meth:`~object.__aenter__` و :meth:`~object.__aexit__`، محیط مشاهده‌شده در یک دستور :keyword:`async with` را کنترل می‌کند. این قابلیت توسط :pep:`492` معرفی شد." +msgstr "" msgid "asynchronous generator" -msgstr "تولیدگر ناهمگام" - -msgid "Informally used to mean either an :term:`asynchronous generator function` or an :term:`asynchronous generator iterator`, depending on context. The formal terms :term:`asynchronous generator function` and :term:`asynchronous generator iterator` are uncommon in practice; \"asynchronous generator\" alone is almost always sufficient." -msgstr "به‌صورت غیررسمی برای اشاره به یک :term:`تابع تولیدگر ناهمگام ` یا یک :term:`تکرارگر تولیدگر ناهمگام `، بسته به زمینه، استفاده می‌شود. اصطلاحات رسمی :term:`تابع تولیدگر ناهمگام ` و :term:`تکرارگر تولیدگر ناهمگام ` در عمل کمتر استفاده می‌شوند؛ «تولیدگر ناهمگام» به‌تنهایی تقریباً همیشه کافی است." +msgstr "" -msgid "asynchronous generator function" -msgstr "تابع تولیدگر ناهمگام" +msgid "A function which returns an :term:`asynchronous generator iterator`. It looks like a coroutine function defined with :keyword:`async def` except that it contains :keyword:`yield` expressions for producing a series of values usable in an :keyword:`async for` loop." +msgstr "" -msgid "A function which returns an :term:`asynchronous generator iterator`. It looks like a coroutine function defined with :keyword:`async def` except that it contains :keyword:`yield` expressions for producing a series of values usable in an :keyword:`async for` loop. See :pep:`525`." -msgstr "تابعی که یک :term:`تکرارگر تولیدگر ناهمگام ` بازمی‌گرداند. این تابع شبیه یک تابع هم‌روال که با :keyword:`async def` تعریف شده است به نظر می‌رسد، با این تفاوت که شامل عبارت‌های :keyword:`yield` برای تولید مجموعه‌ای از مقادیر قابل استفاده در یک حلقهٔ :keyword:`async for` است. :pep:`525` را ببینید." +msgid "Usually refers to an asynchronous generator function, but may refer to an *asynchronous generator iterator* in some contexts. In cases where the intended meaning isn't clear, using the full terms avoids ambiguity." +msgstr "" msgid "An asynchronous generator function may contain :keyword:`await` expressions as well as :keyword:`async for`, and :keyword:`async with` statements." -msgstr "یک تابع تولیدگر ناهمگام ممکن است علاوه بر عبارت‌های :keyword:`async for` و دستورهای :keyword:`async with`، شامل عبارت‌های :keyword:`await` نیز باشد." +msgstr "" msgid "asynchronous generator iterator" -msgstr "تکرارگر تولیدگر ناهمگام" +msgstr "" -msgid "An object created by an :term:`asynchronous generator function`." -msgstr "شی‌ءای که توسط یک :term:`تابع تولیدگر ناهمگام ` ایجاد می‌شود." +msgid "An object created by an :term:`asynchronous generator` function." +msgstr "" msgid "This is an :term:`asynchronous iterator` which when called using the :meth:`~object.__anext__` method returns an awaitable object which will execute the body of the asynchronous generator function until the next :keyword:`yield` expression." -msgstr "این یک :term:`تکرارگر ناهمگام ` است که هنگام فراخوانی با استفاده از متد :meth:`~object.__anext__`، یک شیء awaitable بازمی‌گرداند که بدنهٔ تابع تولیدگر ناهمگام را تا عبارت :keyword:`yield` بعدی اجرا خواهد کرد." +msgstr "" msgid "Each :keyword:`yield` temporarily suspends processing, remembering the execution state (including local variables and pending try-statements). When the *asynchronous generator iterator* effectively resumes with another awaitable returned by :meth:`~object.__anext__`, it picks up where it left off. See :pep:`492` and :pep:`525`." -msgstr "هر :keyword:`yield` پردازش را به‌طور موقت متوقف می‌کند و وضعیت اجرا (شامل متغیرهای محلی و دستورهای try در انتظار) را به خاطر می‌سپارد. هنگامی که *تکرارگر تولیدگر ناهمگام* عملاً با یک شیء awaitable دیگر که توسط :meth:`~object.__anext__` بازگردانده شده است ادامه می‌یابد، از همان نقطه‌ای که متوقف شده بود ادامه می‌دهد. :pep:`492` و :pep:`525` را ببینید." +msgstr "" msgid "asynchronous iterable" -msgstr "تکرارپذیر ناهمگام" +msgstr "" msgid "An object, that can be used in an :keyword:`async for` statement. Must return an :term:`asynchronous iterator` from its :meth:`~object.__aiter__` method. Introduced by :pep:`492`." -msgstr "شی‌ءای که می‌تواند در یک دستور :keyword:`async for` استفاده شود. باید از متد :meth:`~object.__aiter__` خود یک :term:`تکرارگر ناهمگام ` بازگرداند. این قابلیت توسط :pep:`492` معرفی شد." +msgstr "" msgid "asynchronous iterator" -msgstr "تکرارگر ناهمگام" +msgstr "" msgid "An object that implements the :meth:`~object.__aiter__` and :meth:`~object.__anext__` methods. :meth:`~object.__anext__` must return an :term:`awaitable` object. :keyword:`async for` resolves the awaitables returned by an asynchronous iterator's :meth:`~object.__anext__` method until it raises a :exc:`StopAsyncIteration` exception. Introduced by :pep:`492`." -msgstr "شی‌ءای که متدهای :meth:`~object.__aiter__` و :meth:`~object.__anext__` را پیاده‌سازی می‌کند. :meth:`~object.__anext__` باید یک شیء :term:`awaitable ` بازگرداند. :keyword:`async for` اشیای awaitable بازگردانده‌شده توسط متد :meth:`~object.__anext__` یک تکرارگر ناهمگام را تا زمانی که یک استثنای :exc:`StopAsyncIteration` پرتاب شود، حل می‌کند. این قابلیت توسط :pep:`492` معرفی شد." +msgstr "" msgid "atomic operation" -msgstr "عملیات اتمی" +msgstr "" msgid "An operation that appears to execute as a single, indivisible step: no other thread can observe it half-done, and its effects become visible all at once. Python does not guarantee that high-level statements are atomic (for example, ``x += 1`` performs multiple bytecode operations and is not atomic). Atomicity is only guaranteed where explicitly documented. See also :term:`race condition` and :term:`data race`." -msgstr "عملیاتی که به نظر می‌رسد به‌عنوان یک گام واحد و تقسیم‌ناپذیر اجرا می‌شود: هیچ نخ دیگری نمی‌تواند اجرای ناقص آن را مشاهده کند و اثرات آن یکباره قابل مشاهده می‌شوند. پایتون تضمین نمی‌کند که دستورهای سطح بالا اتمی باشند (برای مثال، ``x += 1`` چندین عملیات بایت‌کد انجام می‌دهد و اتمی نیست). اتمی بودن فقط در مواردی تضمین می‌شود که به‌صراحت مستند شده باشند. همچنین :term:`شرط رقابت ` و :term:`رقابت داده ` را ببینید." +msgstr "" msgid "attached thread state" -msgstr "وضعیت نخ متصل" +msgstr "" msgid "A :term:`thread state` that is active for the current OS thread." -msgstr "یک :term:`وضعیت نخ اجرایی ` که برای نخ فعلی سیستم‌عامل فعال است." +msgstr "" msgid "When a :term:`thread state` is attached, the OS thread has access to the full Python C API and can safely invoke the bytecode interpreter." -msgstr "هنگامی که یک :term:`وضعیت نخ اجرایی ` متصل است، نخ سیستم‌عامل به تمام API زبان C پایتون دسترسی دارد و می‌تواند به‌طور ایمن مفسر بایت‌کد را فراخوانی کند." +msgstr "" msgid "Unless a function explicitly notes otherwise, attempting to call the C API without an attached thread state will result in a fatal error or undefined behavior. A thread state can be attached and detached explicitly by the user through the C API, or implicitly by the runtime, including during blocking C calls and by the bytecode interpreter in between calls." -msgstr "مگر این‌که یک تابع به‌طور صریح خلاف آن را ذکر کند، تلاش برای فراخوانی API زبان C بدون یک وضعیت نخ متصل، به یک خطای مهلک یا رفتار تعریف‌نشده منجر خواهد شد. یک وضعیت نخ می‌تواند به‌صورت صریح توسط کاربر از طریق API زبان C متصل و جدا شود، یا به‌صورت ضمنی توسط ران‌تایم، از جمله در طول فراخوانی‌های C مسدودکننده و توسط مفسر بایت‌کد در بین فراخوانی‌ها، مدیریت شود." +msgstr "" msgid "On most builds of Python, having an attached thread state implies that the caller holds the :term:`GIL` for the current interpreter, so only one OS thread can have an attached thread state at a given moment. In :term:`free-threaded builds ` of Python, threads can concurrently hold an attached thread state, allowing for true parallelism of the bytecode interpreter." -msgstr "در بیشتر ساخت‌های پایتون، داشتن یک وضعیت نخ متصل به این معناست که فراخواننده :term:`GIL ` را برای مفسر فعلی در اختیار دارد، بنابراین در یک لحظهٔ مشخص فقط یک نخ سیستم‌عامل می‌تواند یک وضعیت نخ متصل داشته باشد. در :term:`ساخت نخ‌آزاد ` پایتون، نخ‌ها می‌توانند به‌طور هم‌زمان وضعیت نخ متصل داشته باشند، که امکان موازی‌سازی واقعی مفسر بایت‌کد را فراهم می‌کند." +msgstr "" msgid "attribute" -msgstr "ویژگی" +msgstr "" msgid "A value associated with an object which is usually referenced by name using dotted expressions. For example, if an object *o* has an attribute *a* it would be referenced as *o.a*." -msgstr "مقداری مرتبط با یک شیء که معمولاً با استفاده از عبارت‌های نقطه‌ای و با نام به آن ارجاع داده می‌شود. برای مثال، اگر یک شیء *o* دارای یک ویژگی *a* باشد، با *o.a* به آن ارجاع داده خواهد شد." +msgstr "" msgid "It is possible to give an object an attribute whose name is not an identifier as defined by :ref:`identifiers`, for example using :func:`setattr`, if the object allows it. Such an attribute will not be accessible using a dotted expression, and would instead need to be retrieved with :func:`getattr`." -msgstr "اگر شیء اجازه دهد، می‌توان با استفاده از :func:`setattr`، ویژگی‌ای با نامی که یک شناسه مطابق تعریف :ref:`identifiers` نیست به آن اختصاص داد. چنین ویژگی‌ای با استفاده از یک عبارت نقطه‌ای قابل دسترسی نخواهد بود و باید در عوض با :func:`getattr` بازیابی شود." +msgstr "" msgid "awaitable" -msgstr "awaitable" +msgstr "" msgid "An object that can be used in an :keyword:`await` expression. Can be a :term:`coroutine` or an object with an :meth:`~object.__await__` method. See also :pep:`492`." -msgstr "شیءای که می‌تواند در یک عبارت :keyword:`await` استفاده شود. می‌تواند یک :term:`هم‌روال ` یا شی‌ءای با متد :meth:`~object.__await__` باشد. همچنین :pep:`492` را ببینید." +msgstr "" msgid "BDFL" -msgstr "BDFL" +msgstr "" msgid "Benevolent Dictator For Life, a.k.a. `Guido van Rossum `_, Python's creator." -msgstr "Benevolent Dictator For Life، نام دیگر `Guido van Rossum `_، خالق پایتون." +msgstr "" msgid "binary file" -msgstr "فایل دودویی" +msgstr "" msgid "A :term:`file object` able to read and write :term:`bytes-like objects `. Examples of binary files are files opened in binary mode (``'rb'``, ``'wb'`` or ``'rb+'``), :data:`sys.stdin.buffer `, :data:`sys.stdout.buffer `, and instances of :class:`io.BytesIO` and :class:`gzip.GzipFile`." -msgstr "یک :term:`شیء فایل ` که می‌تواند :term:`شیء شبه‌بایت ` را بخواند و بنویسد. نمونه‌هایی از فایل‌های دودویی، فایل‌هایی هستند که در حالت دودویی باز شده‌اند (``'rb'``، ``'wb'`` یا ``'rb+'``)، :data:`sys.stdin.buffer `، :data:`sys.stdout.buffer ` و نمونه‌هایی از :class:`io.BytesIO` و :class:`gzip.GzipFile`." +msgstr "" msgid "See also :term:`text file` for a file object able to read and write :class:`str` objects." -msgstr "همچنین :term:`فایل متنی ` را برای یک شیء فایل که می‌تواند اشیای :class:`str` را بخواند و بنویسد ببینید." +msgstr "" msgid "borrowed reference" -msgstr "ارجاع قرض‌گرفته‌شده" +msgstr "" msgid "In Python's C API, a borrowed reference is a reference to an object, where the code using the object does not own the reference. It becomes a dangling pointer if the object is destroyed. For example, a garbage collection can remove the last :term:`strong reference` to the object and so destroy it." -msgstr "در API زبان C پایتون، ارجاع قرض‌گرفته‌شده ارجاعی به یک شیء است که در آن کدی که از شیء استفاده می‌کند مالک ارجاع نیست. اگر شیء نابود شود، این ارجاع به یک اشاره‌گر آویزان تبدیل می‌شود. برای مثال، جمع‌آوری زباله می‌تواند آخرین :term:`ارجاع قوی ` به شیء را حذف کند و در نتیجه آن را نابود کند." +msgstr "" msgid "Calling :c:func:`Py_INCREF` on the :term:`borrowed reference` is recommended to convert it to a :term:`strong reference` in-place, except when the object cannot be destroyed before the last usage of the borrowed reference. The :c:func:`Py_NewRef` function can be used to create a new :term:`strong reference`." -msgstr "فراخوانی :c:func:`Py_INCREF` روی :term:`ارجاع قرض‌گرفته‌شده ` توصیه می‌شود تا آن را درجا به یک :term:`ارجاع قوی ` تبدیل کند، مگر زمانی که شیء نمی‌تواند پیش از آخرین استفاده از ارجاع قرض‌گرفته‌شده نابود شود. تابع :c:func:`Py_NewRef` می‌تواند برای ایجاد یک :term:`ارجاع قوی ` جدید استفاده شود." +msgstr "" msgid "bytes-like object" -msgstr "شیء شبه‌بایت" +msgstr "" msgid "An object that supports the :ref:`bufferobjects` and can export a C-:term:`contiguous` buffer. This includes all :class:`bytes`, :class:`bytearray`, and :class:`array.array` objects, as well as many common :class:`memoryview` objects. Bytes-like objects can be used for various operations that work with binary data; these include compression, saving to a binary file, and sending over a socket." -msgstr "شی‌ءای که از :ref:`bufferobjects` پشتیبانی می‌کند و می‌تواند یک بافر C-:term:`پیوسته ` صادر کند. این شامل همهٔ اشیای :class:`bytes`، :class:`bytearray` و :class:`array.array` و همچنین بسیاری از اشیای رایج :class:`memoryview` می‌شود. اشیای شبه‌بایت می‌توانند برای عملیات مختلفی که با داده‌های دودویی کار می‌کنند استفاده شوند؛ از جمله فشرده‌سازی، ذخیره در یک فایل دودویی و ارسال از طریق یک سوکت." +msgstr "" msgid "Some operations need the binary data to be mutable. The documentation often refers to these as \"read-write bytes-like objects\". Example mutable buffer objects include :class:`bytearray` and a :class:`memoryview` of a :class:`bytearray`. Other operations require the binary data to be stored in immutable objects (\"read-only bytes-like objects\"); examples of these include :class:`bytes` and a :class:`memoryview` of a :class:`bytes` object." -msgstr "برخی عملیات‌ها نیاز دارند که داده‌های دودویی تغییرپذیر باشند. مستندات اغلب به این موارد با عنوان «اشیای شبه‌بایت خواندن-نوشتن» اشاره می‌کنند. نمونه‌هایی از اشیای بافر تغییرپذیر شامل :class:`bytearray` و یک :class:`memoryview` از یک :class:`bytearray` هستند. عملیات‌های دیگر نیاز دارند که داده‌های دودویی در اشیای تغییرناپذیر ذخیره شوند («اشیای شبه‌بایت فقط‌خواندنی»)؛ نمونه‌هایی از این موارد شامل :class:`bytes` و یک :class:`memoryview` از یک شیء :class:`bytes` هستند." +msgstr "" msgid "bytecode" -msgstr "بایت‌کد" +msgstr "" msgid "Python source code is compiled into bytecode, the internal representation of a Python program in the CPython interpreter. The bytecode is also cached in ``.pyc`` files so that executing the same file is faster the second time (recompilation from source to bytecode can be avoided). This \"intermediate language\" is said to run on a :term:`virtual machine` that executes the machine code corresponding to each bytecode. Do note that bytecodes are not expected to work between different Python virtual machines, nor to be stable between Python releases." -msgstr "کد منبع پایتون به بایت‌کد کامپایل می‌شود؛ بایت‌کد نمایش داخلی یک برنامهٔ پایتون در مفسر CPython است. بایت‌کد همچنین در فایل‌های ``.pyc`` ذخیره می‌شود تا اجرای همان فایل در بار دوم سریع‌تر باشد (می‌توان از کامپایل دوباره از منبع به بایت‌کد جلوگیری کرد). گفته می‌شود این «زبان میانی» روی یک :term:`ماشین مجازی ` اجرا می‌شود که کد ماشین متناظر با هر بایت‌کد را اجرا می‌کند. توجه داشته باشید که انتظار نمی‌رود بایت‌کدها بین ماشین‌های مجازی مختلف پایتون کار کنند یا بین نسخه‌های مختلف پایتون پایدار باشند." +msgstr "" msgid "A list of bytecode instructions can be found in the documentation for :ref:`the dis module `." -msgstr "فهرستی از دستورهای بایت‌کد را می‌توان در مستندات :ref:`the dis module ` یافت." +msgstr "" msgid "callable" -msgstr "فراخوانی‌پذیر" +msgstr "" msgid "A callable is an object that can be called, possibly with a set of arguments (see :term:`argument`), with the following syntax::" -msgstr "یک فراخوانی‌پذیر شی‌ءای است که می‌توان آن را، احتمالاً با مجموعه‌ای از آرگومان‌ها (به :term:`آرگومان ` مراجعه کنید)، با سینتکس زیر فراخوانی کرد::" +msgstr "" msgid "callable(argument1, argument2, argumentN)" -msgstr "callable(argument1, argument2, argumentN)" +msgstr "" msgid "A :term:`function`, and by extension a :term:`method`, is a callable. An instance of a class that implements the :meth:`~object.__call__` method is also a callable." -msgstr "یک :term:`تابع ` و به‌تبع آن یک :term:`متد `، یک فراخوانی‌پذیر است. یک نمونه از یک کلاس که متد :meth:`~object.__call__` را پیاده‌سازی می‌کند نیز یک فراخوانی‌پذیر است." +msgstr "" msgid "callback" -msgstr "کال‌بک" +msgstr "" msgid "A subroutine function which is passed as an argument to be executed at some point in the future." -msgstr "یک تابع زیرروال که به‌عنوان آرگومان ارسال می‌شود تا در نقطه‌ای در آینده اجرا شود." +msgstr "" msgid "class" -msgstr "کلاس" +msgstr "" msgid "A template for creating user-defined objects. Class definitions normally contain method definitions which operate on instances of the class." -msgstr "الگویی برای ایجاد اشیای تعریف‌شده توسط کاربر. تعریف‌های کلاس معمولاً شامل تعریف‌های متد هستند که روی نمونه‌های کلاس عمل می‌کنند." +msgstr "" msgid "class variable" -msgstr "متغیر کلاس" +msgstr "" msgid "A variable defined in a class and intended to be modified only at class level (i.e., not in an instance of the class)." -msgstr "متغیری که در یک کلاس تعریف شده است و قرار است فقط در سطح کلاس تغییر داده شود (یعنی نه در یک نمونه از کلاس)." +msgstr "" msgid "closure variable" -msgstr "متغیر بستار" +msgstr "" msgid "A :term:`free variable` referenced from a :term:`nested scope` that is defined in an outer scope rather than being resolved at runtime from the globals or builtin namespaces. May be explicitly defined with the :keyword:`nonlocal` keyword to allow write access, or implicitly defined if the variable is only being read." -msgstr "یک :term:`متغیر آزاد ` که از یک :term:`محدودهٔ تو‌در‌تو ` ارجاع داده می‌شود و در یک محدودهٔ بیرونی تعریف شده است، به‌جای این‌که در زمان ران‌تایم از نام‌فضاهای سراسری یا توکار حل شود. ممکن است به‌طور صریح با کلیدواژهٔ :keyword:`nonlocal` تعریف شود تا امکان دسترسی نوشتن فراهم شود، یا اگر متغیر فقط خوانده می‌شود، به‌طور ضمنی تعریف شود." +msgstr "" msgid "For example, in the ``inner`` function in the following code, both ``x`` and ``print`` are :term:`free variables `, but only ``x`` is a *closure variable*::" -msgstr "برای مثال، در تابع ``inner`` در کد زیر، هر دو مورد ``x`` و ``print`` :term:`متغیر آزاد ` هستند، اما فقط ``x`` یک *متغیر بستار* است::" +msgstr "" msgid "" "def outer():\n" @@ -275,124 +267,117 @@ msgid "" " print(x)\n" " return inner" msgstr "" -"def outer():\n" -" x = 0\n" -" def inner():\n" -" nonlocal x\n" -" x += 1\n" -" print(x)\n" -" return inner" msgid "Due to the :attr:`codeobject.co_freevars` attribute (which, despite its name, only includes the names of closure variables rather than listing all referenced free variables), the more general :term:`free variable` term is sometimes used even when the intended meaning is to refer specifically to closure variables." -msgstr "به‌دلیل ویژگی :attr:`codeobject.co_freevars` (که با وجود نامش، فقط نام‌های متغیرهای بستار را شامل می‌شود و همهٔ متغیرهای آزاد ارجاع‌داده‌شده را فهرست نمی‌کند)، اصطلاح کلی‌تر :term:`متغیر آزاد ` گاهی حتی زمانی استفاده می‌شود که معنای مورد نظر به‌طور مشخص اشاره به متغیرهای بستار دارد." +msgstr "" msgid "complex number" -msgstr "عدد مختلط" +msgstr "" msgid "An extension of the familiar real number system in which all numbers are expressed as a sum of a real part and an imaginary part. Imaginary numbers are real multiples of the imaginary unit (the square root of ``-1``), often written ``i`` in mathematics or ``j`` in engineering. Python has built-in support for complex numbers, which are written with this latter notation; the imaginary part is written with a ``j`` suffix, e.g., ``3+1j``. To get access to complex equivalents of the :mod:`math` module, use :mod:`cmath`. Use of complex numbers is a fairly advanced mathematical feature. If you're not aware of a need for them, it's almost certain you can safely ignore them." -msgstr "گسترشی از سیستم آشنای اعداد حقیقی که در آن همهٔ اعداد به‌صورت مجموع یک بخش حقیقی و یک بخش موهومی بیان می‌شوند. اعداد موهومی مضرب‌های حقیقی واحد موهومی (ریشهٔ دوم ``-1``) هستند که در ریاضیات اغلب با ``i`` و در مهندسی با ``j`` نوشته می‌شود. پایتون پشتیبانی توکار از اعداد مختلط دارد که با این نمادگذاری اخیر نوشته می‌شوند؛ بخش موهومی با پسوند ``j`` نوشته می‌شود، برای مثال ``3+1j``. برای دسترسی به معادل‌های مختلط ماژول :mod:`math`، از :mod:`cmath` استفاده کنید. استفاده از اعداد مختلط یک ویژگی نسبتاً پیشرفتهٔ ریاضی است. اگر از نیاز به آن‌ها آگاه نیستید، تقریباً قطعی است که می‌توانید با خیال راحت آن‌ها را نادیده بگیرید." +msgstr "" msgid "concurrency" -msgstr "هم‌زمانی" +msgstr "" msgid "The ability of a computer program to perform multiple tasks at the same time. Python provides libraries for writing programs that make use of different forms of concurrency. :mod:`asyncio` is a library for dealing with asynchronous tasks and coroutines. :mod:`threading` provides access to operating system threads and :mod:`multiprocessing` to operating system processes. Multi-core processors can execute threads and processes on different CPU cores at the same time (see :term:`parallelism`)." -msgstr "توانایی یک برنامهٔ کامپیوتری برای انجام چندین کار در یک زمان. پایتون کتابخانه‌هایی برای نوشتن برنامه‌هایی که از شکل‌های مختلف هم‌زمانی استفاده می‌کنند فراهم می‌کند. :mod:`asyncio` کتابخانه‌ای برای کار با وظایف ناهمگام و coroutineها است. :mod:`threading` دسترسی به نخ‌های سیستم‌عامل و :mod:`multiprocessing` دسترسی به پردازه‌های سیستم‌عامل را فراهم می‌کنند. پردازنده‌های چند‌هسته‌ای می‌توانند نخ‌ها و پردازه‌ها را روی هسته‌های مختلف CPU به‌طور هم‌زمان اجرا کنند (به :term:`موازی‌سازی ` مراجعه کنید)." +msgstr "" msgid "concurrent modification" -msgstr "تغییر هم‌زمان" +msgstr "" msgid "When multiple threads modify shared data at the same time. Concurrent modification without proper synchronization can cause :term:`race conditions `, and might also trigger a :term:`data race `, data corruption, or both." -msgstr "هنگامی که چندین نخ در یک زمان داده‌های اشتراکی را تغییر می‌دهند. تغییر هم‌زمان بدون همگام‌سازی مناسب می‌تواند باعث :term:`شرط رقابت ` شود و همچنین ممکن است یک :term:`رقابت داده `، خرابی داده یا هر دو را ایجاد کند." +msgstr "" msgid "context" -msgstr "زمینه" +msgstr "" msgid "This term has different meanings depending on where and how it is used. Some common meanings:" -msgstr "این اصطلاح بسته به محل و نحوهٔ استفاده، معانی متفاوتی دارد. برخی از معانی رایج:" +msgstr "" msgid "The temporary state or environment established by a :term:`context manager` via a :keyword:`with` statement." -msgstr "وضعیت یا محیط موقتی که توسط یک :term:`مدیر زمینه ` از طریق یک دستور :keyword:`with` ایجاد می‌شود." +msgstr "" msgid "The collection of key­value bindings associated with a particular :class:`contextvars.Context` object and accessed via :class:`~contextvars.ContextVar` objects. Also see :term:`context variable`." -msgstr "مجموعهٔ اتصال‌های کلید-مقدار مرتبط با یک شیء :class:`contextvars.Context` خاص و قابل دسترسی از طریق اشیای :class:`~contextvars.ContextVar`. همچنین :term:`متغیر زمینه ` را ببینید." +msgstr "" msgid "A :class:`contextvars.Context` object. Also see :term:`current context`." -msgstr "یک شیء :class:`contextvars.Context`. همچنین :term:`زمینه فعلی ` را ببینید." +msgstr "" msgid "context management protocol" -msgstr "پروتکل مدیریت زمینه" +msgstr "" msgid "The :meth:`~object.__enter__` and :meth:`~object.__exit__` methods called by the :keyword:`with` statement. See :pep:`343`." -msgstr "متدهای :meth:`~object.__enter__` و :meth:`~object.__exit__` که توسط دستور :keyword:`with` فراخوانی می‌شوند. :pep:`343` را ببینید." +msgstr "" msgid "context manager" -msgstr "مدیر زمینه" +msgstr "" msgid "An object which implements the :term:`context management protocol` and controls the environment seen in a :keyword:`with` statement. See :pep:`343`." -msgstr "شی‌ءای که :term:`پروتکل مدیریت زمینه ` را پیاده‌سازی می‌کند و محیط مشاهده‌شده در یک دستور :keyword:`with` را کنترل می‌کند. :pep:`343` را ببینید." +msgstr "" msgid "context variable" -msgstr "متغیر زمینه" +msgstr "" msgid "A variable whose value depends on which context is the :term:`current context`. Values are accessed via :class:`contextvars.ContextVar` objects. Context variables are primarily used to isolate state between concurrent asynchronous tasks." -msgstr "متغیری که مقدار آن به این بستگی دارد که کدام زمینه :term:`زمینه فعلی ` است. مقادیر از طریق اشیای :class:`contextvars.ContextVar` قابل دسترسی هستند. متغیرهای زمینه عمدتاً برای جداسازی وضعیت بین وظایف ناهمگام هم‌زمان استفاده می‌شوند." +msgstr "" msgid "contiguous" -msgstr "پیوسته" +msgstr "" msgid "A buffer is considered contiguous exactly if it is either *C-contiguous* or *Fortran contiguous*. Zero-dimensional buffers are C and Fortran contiguous. In one-dimensional arrays, the items must be laid out in memory next to each other, in order of increasing indexes starting from zero. In multidimensional C-contiguous arrays, the last index varies the fastest when visiting items in order of memory address. However, in Fortran contiguous arrays, the first index varies the fastest." -msgstr "یک بافر دقیقاً پیوسته در نظر گرفته می‌شود اگر یا *C-contiguous* یا *Fortran contiguous* باشد. بافرهای صفر‌بعدی هم C و هم Fortran پیوسته هستند. در آرایه‌های یک‌بعدی، آیتم‌ها باید در حافظه در کنار یکدیگر و به‌ترتیب اندیس‌های افزایشی که از صفر شروع می‌شوند قرار گرفته باشند. در آرایه‌های چندبعدی C-contiguous، هنگام بازدید از آیتم‌ها به‌ترتیب آدرس حافظه، آخرین اندیس سریع‌ترین تغییر را دارد. با این حال، در آرایه‌های Fortran contiguous، اولین اندیس سریع‌ترین تغییر را دارد." +msgstr "" msgid "coroutine" -msgstr "هم‌روال" +msgstr "" msgid "Coroutines are a more generalized form of subroutines. Subroutines are entered at one point and exited at another point. Coroutines can be entered, exited, and resumed at many different points. They can be implemented with the :keyword:`async def` statement. See also :pep:`492`." -msgstr "هم‌روال‌ها شکل کلی‌تری از زیرروال‌ها هستند. زیرروال‌ها از یک نقطه وارد و از نقطه‌ای دیگر خارج می‌شوند. هم‌روال‌ها می‌توانند از نقاط مختلفی وارد، خارج و از سر گرفته شوند. آن‌ها می‌توانند با دستور :keyword:`async def` پیاده‌سازی شوند. همچنین :pep:`492` را ببینید." +msgstr "" msgid "coroutine function" -msgstr "تابع هم‌روال" +msgstr "" msgid "A function which returns a :term:`coroutine` object. A coroutine function may be defined with the :keyword:`async def` statement, and may contain :keyword:`await`, :keyword:`async for`, and :keyword:`async with` keywords. These were introduced by :pep:`492`." -msgstr "تابعی که یک شیء :term:`هم‌روال ` بازمی‌گرداند. یک تابع هم‌روال می‌تواند با دستور :keyword:`async def` تعریف شود و می‌تواند شامل کلیدواژه‌های :keyword:`await`، :keyword:`async for` و :keyword:`async with` باشد. این موارد توسط :pep:`492` معرفی شدند." +msgstr "" msgid "CPython" -msgstr "CPython" +msgstr "" msgid "The canonical implementation of the Python programming language, as distributed on `python.org `_. The term \"CPython\" is used when necessary to distinguish this implementation from others such as Jython or IronPython." -msgstr "پیاده‌سازی مرجع زبان برنامه‌نویسی پایتون، همان‌طور که در `python.org `_ توزیع می‌شود. اصطلاح «CPython» در مواقعی استفاده می‌شود که لازم باشد این پیاده‌سازی از موارد دیگری مانند Jython یا IronPython متمایز شود." +msgstr "" msgid "current context" -msgstr "زمینه فعلی" +msgstr "" msgid "The :term:`context` (:class:`contextvars.Context` object) that is currently used by :class:`~contextvars.ContextVar` objects to access (get or set) the values of :term:`context variables `. Each thread has its own current context. Frameworks for executing asynchronous tasks (see :mod:`asyncio`) associate each task with a context which becomes the current context whenever the task starts or resumes execution." -msgstr ":term:`زمینه ` (:class:`contextvars.Context`) که در حال حاضر توسط اشیای :class:`~contextvars.ContextVar` برای دسترسی (دریافت یا تنظیم) مقادیر :term:`متغیر زمینه ` استفاده می‌شود. هر نخ، زمینهٔ فعلی خود را دارد. چارچوب‌های اجرای وظایف ناهمگام (به :mod:`asyncio` مراجعه کنید) هر وظیفه را با یک زمینه مرتبط می‌کنند که هر زمان وظیفه شروع یا ادامهٔ اجرا می‌دهد، به زمینهٔ فعلی تبدیل می‌شود." +msgstr "" msgid "cyclic isolate" -msgstr "جدایهٔ چرخه‌ای" +msgstr "" msgid "A subgroup of one or more objects that reference each other in a reference cycle, but are not referenced by objects outside the group. The goal of the :term:`cyclic garbage collector ` is to identify these groups and break the reference cycles so that the memory can be reclaimed." -msgstr "زیرگروهی شامل یک یا چند شیء که در یک چرخهٔ ارجاع به یکدیگر ارجاع می‌دهند، اما توسط اشیای خارج از گروه ارجاع داده نمی‌شوند. هدف :term:`زباله‌روبی ` شناسایی این گروه‌ها و شکستن چرخه‌های ارجاع است تا حافظه بتواند بازیابی شود." +msgstr "" msgid "data race" -msgstr "رقابت داده" +msgstr "" msgid "A situation where multiple threads access the same memory location concurrently, at least one of the accesses is a write, and the threads do not use any synchronization to control their access. Data races lead to :term:`non-deterministic` behavior and can cause data corruption. Proper use of :term:`locks ` and other :term:`synchronization primitives ` prevents data races. Note that data races can only happen in native code, but that :term:`native code` might be exposed in a Python API. See also :term:`race condition` and :term:`thread-safe`." -msgstr "وضعیتی که در آن چندین نخ به یک محل حافظهٔ یکسان به‌طور هم‌زمان دسترسی دارند، دست‌کم یکی از دسترسی‌ها نوشتن است و نخ‌ها برای کنترل دسترسی خود از هیچ همگام‌سازی‌ای استفاده نمی‌کنند. رقابت‌های داده به رفتار :term:`غیرقطعی ` منجر می‌شوند و می‌توانند باعث خرابی داده شوند. استفادهٔ درست از :term:`قفل ` و دیگر :term:`اولیه ` از رقابت‌های داده جلوگیری می‌کند. توجه داشته باشید که رقابت‌های داده فقط در کد بومی رخ می‌دهند، اما آن :term:`کد بومی ` ممکن است در یک API پایتون در معرض استفاده قرار گرفته باشد. همچنین :term:`شرط رقابت ` و :term:`ایمن برای نخ‌های اجرایی ` را ببینید." +msgstr "" msgid "deadlock" -msgstr "بن‌بست" +msgstr "" msgid "A situation in which two or more tasks (threads, processes, or coroutines) wait indefinitely for each other to release resources or complete actions, preventing any from making progress. For example, if thread A holds lock 1 and waits for lock 2, while thread B holds lock 2 and waits for lock 1, both threads will wait indefinitely. In Python this often arises from acquiring multiple locks in conflicting orders or from circular join/await dependencies. Deadlocks can be avoided by always acquiring multiple :term:`locks ` in a consistent order. See also :term:`lock` and :term:`reentrant`." -msgstr "وضعیتی که در آن دو یا چند وظیفه (نخ‌ها، پردازه‌ها یا هم‌روال‌ها) به‌طور نامحدود منتظر می‌مانند تا یکدیگر منابع را آزاد کنند یا اقداماتی را کامل کنند، و در نتیجه هیچ‌کدام نمی‌توانند پیشرفت کنند. برای مثال، اگر نخ A قفل ۱ را در اختیار داشته باشد و منتظر قفل ۲ باشد، در حالی که نخ B قفل ۲ را در اختیار دارد و منتظر قفل ۱ است، هر دو نخ به‌طور نامحدود منتظر خواهند ماند. در پایتون، این وضعیت اغلب از دریافت چندین قفل با ترتیب‌های ناسازگار یا از وابستگی‌های join/await چرخه‌ای ایجاد می‌شود. می‌توان با همیشه دریافت کردن چندین :term:`قفل ` به یک ترتیب ثابت از بن‌بست‌ها جلوگیری کرد. همچنین :term:`قفل ` و :term:`بازورودپذیر ` را ببینید." +msgstr "" msgid "decorator" -msgstr "دکوراتور" +msgstr "" -msgid "A function returning another function, usually applied as a function transformation using the ``@wrapper`` syntax. Common examples for decorators are :deco:`classmethod` and :deco:`staticmethod`." -msgstr "تابعی که تابع دیگری را بازمی‌گرداند و معمولاً با استفاده از سینتکس ``@wrapper`` به‌عنوان یک تبدیل تابع اعمال می‌شود. نمونه‌های رایج دکوراتورها :func:`classmethod` و :func:`staticmethod` هستند." +msgid "A function returning another function, usually applied as a function transformation using the ``@wrapper`` syntax. Common examples for decorators are :func:`classmethod` and :func:`staticmethod`." +msgstr "" msgid "The decorator syntax is merely syntactic sugar, the following two function definitions are semantically equivalent::" -msgstr "سینتکس دکوراتور صرفاً یک قند نحوی (syntactic sugar) است؛ دو تعریف تابع زیر از نظر معنایی معادل هستند::" +msgstr "" msgid "" "def f(arg):\n" @@ -403,597 +388,577 @@ msgid "" "def f(arg):\n" " ..." msgstr "" -"def f(arg):\n" -" ...\n" -"f = staticmethod(f)\n" -"\n" -"@staticmethod\n" -"def f(arg):\n" -" ..." msgid "The same concept exists for classes, but is less commonly used there. See the documentation for :ref:`function definitions ` and :ref:`class definitions ` for more about decorators." -msgstr "همین مفهوم برای کلاس‌ها نیز وجود دارد، اما استفاده از آن در آنجا کمتر رایج است. برای اطلاعات بیشتر دربارهٔ دکوراتورها، مستندات :ref:`function definitions ` و :ref:`class definitions ` را ببینید." +msgstr "" msgid "descriptor" -msgstr "توصیف‌گر" +msgstr "" msgid "Any object which defines the methods :meth:`~object.__get__`, :meth:`~object.__set__`, or :meth:`~object.__delete__`. When a class attribute is a descriptor, its special binding behavior is triggered upon attribute lookup. Normally, using *a.b* to get, set or delete an attribute looks up the object named *b* in the class dictionary for *a*, but if *b* is a descriptor, the respective descriptor method gets called. Understanding descriptors is a key to a deep understanding of Python because they are the basis for many features including functions, methods, properties, class methods, static methods, and reference to super classes." -msgstr "هر شی‌ءای که متدهای :meth:`~object.__get__`، :meth:`~object.__set__` یا :meth:`~object.__delete__` را تعریف کند. هنگامی که یک ویژگی کلاس یک توصیف‌گر باشد، رفتار اتصال ویژهٔ آن هنگام جست‌وجوی ویژگی فعال می‌شود. معمولاً استفاده از *a.b* برای دریافت، تنظیم یا حذف یک ویژگی، شیء با نام *b* را در دیکشنری کلاس *a* جست‌وجو می‌کند، اما اگر *b* یک توصیف‌گر باشد، متد مربوط به توصیف‌گر فراخوانی می‌شود. درک توصیف‌گرها کلیدی برای درک عمیق پایتون است، زیرا آن‌ها پایهٔ بسیاری از قابلیت‌ها از جمله توابع، متدها، ویژگی‌ها، متدهای کلاس، متدهای ایستا و ارجاع به کلاس‌های بالادستی هستند." +msgstr "" msgid "For more information about descriptors' methods, see :ref:`descriptors` or the :ref:`Descriptor How To Guide `." -msgstr "برای اطلاعات بیشتر دربارهٔ متدهای توصیف‌گرها، :ref:`descriptors` یا :ref:`Descriptor How To Guide ` را ببینید." +msgstr "" msgid "dictionary" -msgstr "دیکشنری" +msgstr "" msgid "An associative array, where arbitrary keys are mapped to values. The keys can be any object with :meth:`~object.__hash__` and :meth:`~object.__eq__` methods. Called a hash in Perl." -msgstr "یک آرایهٔ انجمنی که در آن کلیدهای دلخواه به مقادیر نگاشت می‌شوند. کلیدها می‌توانند هر شیءای باشند که متدهای :meth:`~object.__hash__` و :meth:`~object.__eq__` را داشته باشد. در Perl به آن hash گفته می‌شود." +msgstr "" msgid "dictionary comprehension" -msgstr "درک دیکشنری" +msgstr "" msgid "A compact way to process all or part of the elements in an iterable and return a dictionary with the results. ``results = {n: n ** 2 for n in range(10)}`` generates a dictionary containing key ``n`` mapped to value ``n ** 2``. See :ref:`comprehensions`." -msgstr "روشی فشرده برای پردازش همه یا بخشی از عناصر یک تکرارپذیر و بازگرداندن یک دیکشنری با نتایج. ``results = {n: n ** 2 for n in range(10)}`` یک دیکشنری ایجاد می‌کند که شامل کلید ``n`` نگاشت‌شده به مقدار ``n ** 2`` است. :ref:`comprehensions` را ببینید." +msgstr "" msgid "dictionary view" -msgstr "نمای دیکشنری" +msgstr "" msgid "The objects returned from :meth:`dict.keys`, :meth:`dict.values`, and :meth:`dict.items` are called dictionary views. They provide a dynamic view on the dictionary’s entries, which means that when the dictionary changes, the view reflects these changes. To force the dictionary view to become a full list use ``list(dictview)``. See :ref:`dict-views`." -msgstr "اشیایی که توسط :meth:`dict.keys`، :meth:`dict.values` و :meth:`dict.items` بازگردانده می‌شوند، نماهای دیکشنری نامیده می‌شوند. آن‌ها نمایی پویا از ورودی‌های دیکشنری فراهم می‌کنند، به این معنا که هنگام تغییر دیکشنری، نما نیز این تغییرات را منعکس می‌کند. برای تبدیل نمای دیکشنری به یک فهرست کامل از ``list(dictview)`` استفاده کنید. :ref:`dict-views` را ببینید." +msgstr "" msgid "docstring" -msgstr "رشتهٔ مستندات" +msgstr "" msgid "A string literal which appears as the first expression in a class, function or module. While ignored when the suite is executed, it is recognized by the compiler and put into the :attr:`~definition.__doc__` attribute of the enclosing class, function or module. Since it is available via introspection, it is the canonical place for documentation of the object." -msgstr "یک مقدار رشته‌ای که به‌عنوان اولین عبارت در یک کلاس، تابع یا ماژول ظاهر می‌شود. اگرچه هنگام اجرای مجموعه نادیده گرفته می‌شود، توسط کامپایلر شناسایی شده و در ویژگی :attr:`~definition.__doc__` کلاس، تابع یا ماژول دربرگیرنده قرار داده می‌شود. از آنجا که از طریق درون‌بینی در دسترس است، مکان استاندارد برای مستندسازی شیء محسوب می‌شود." +msgstr "" msgid "duck-typing" -msgstr "نوع‌دهی اردکی" +msgstr "" msgid "A programming style which does not look at an object's type to determine if it has the right interface; instead, the method or attribute is simply called or used (\"If it looks like a duck and quacks like a duck, it must be a duck.\") By emphasizing interfaces rather than specific types, well-designed code improves its flexibility by allowing polymorphic substitution. Duck-typing avoids tests using :func:`type` or :func:`isinstance`. (Note, however, that duck-typing can be complemented with :term:`abstract base classes `.) Instead, it typically employs :func:`hasattr` tests or :term:`EAFP` programming." -msgstr "سبک برنامه‌نویسی‌ای که برای تعیین داشتن رابط مناسب توسط یک شیء، به نوع آن نگاه نمی‌کند؛ در عوض، متد یا ویژگی به‌سادگی فراخوانی یا استفاده می‌شود («اگر شبیه اردک است و مانند اردک صدا می‌دهد، پس باید اردک باشد.»). با تأکید بر رابط‌ها به‌جای نوع‌های خاص، کد با طراحی خوب با امکان جایگزینی چندریخت، انعطاف‌پذیری خود را افزایش می‌دهد. نوع‌دهی اردکی از آزمون‌های مبتنی بر :func:`type` یا :func:`isinstance` اجتناب می‌کند. (با این حال، توجه داشته باشید که نوع‌دهی اردکی می‌تواند با :term:`کلاس پایهٔ انتزاعی ` تکمیل شود.) در عوض، معمولاً از آزمون‌های :func:`hasattr` یا برنامه‌نویسی :term:`EAFP ` استفاده می‌کند." +msgstr "" msgid "dunder" -msgstr "داندر" +msgstr "" msgid "An informal short-hand for \"double underscore\", used when talking about a :term:`special method`. For example, ``__init__`` is often pronounced \"dunder init\"." -msgstr "یک شکل کوتاه و غیررسمی برای «دو زیرخط» که هنگام صحبت دربارهٔ یک :term:`متد ویژه ` استفاده می‌شود. برای مثال، ``__init__`` اغلب «داندر اینیت» تلفظ می‌شود." +msgstr "" msgid "EAFP" -msgstr "EAFP" +msgstr "" msgid "Easier to ask for forgiveness than permission. This common Python coding style assumes the existence of valid keys or attributes and catches exceptions if the assumption proves false. This clean and fast style is characterized by the presence of many :keyword:`try` and :keyword:`except` statements. The technique contrasts with the :term:`LBYL` style common to many other languages such as C." -msgstr "آسان‌تر است که درخواست بخشش کنید تا اجازه. این سبک رایج کدنویسی پایتون وجود کلیدها یا ویژگی‌های معتبر را فرض می‌کند و اگر این فرض نادرست باشد، استثناها را دریافت می‌کند. این سبک پاک و سریع با وجود تعداد زیادی دستورهای :keyword:`try` و :keyword:`except` شناخته می‌شود. این روش در تضاد با سبک :term:`LBYL ` است که در بسیاری از زبان‌های دیگر مانند C رایج است." +msgstr "" msgid "evaluate function" -msgstr "تابع ارزیابی" +msgstr "" msgid "A function that can be called to evaluate a lazily evaluated attribute of an object, such as the value of type aliases created with the :keyword:`type` statement." -msgstr "تابعی که می‌توان آن را برای ارزیابی یک ویژگی با ارزیابی تنبل یک شیء فراخوانی کرد، مانند مقدار نام‌های مستعار نوع که با دستور :keyword:`type` ایجاد شده‌اند." +msgstr "" msgid "expression" -msgstr "عبارت" +msgstr "" msgid "A piece of syntax which can be evaluated to some value. In other words, an expression is an accumulation of expression elements like literals, names, attribute access, operators or function calls which all return a value. In contrast to many other languages, not all language constructs are expressions. There are also :term:`statement`\\s which cannot be used as expressions, such as :keyword:`while`. Assignments are also statements, not expressions." -msgstr "بخشی از سینتکس که می‌تواند به یک مقدار ارزیابی شود. به بیان دیگر، یک عبارت مجموعه‌ای از عناصر عبارت مانند لفظ‌ها، نام‌ها، دسترسی به ویژگی، عملگرها یا فراخوانی‌های تابع است که همه مقداری بازمی‌گردانند. برخلاف بسیاری از زبان‌های دیگر، همهٔ ساختارهای زبان عبارت نیستند. همچنین :term:`دستور `\\هایی وجود دارند که نمی‌توان از آن‌ها به‌عنوان عبارت استفاده کرد، مانند :keyword:`while`. تخصیص‌ها نیز دستور هستند، نه عبارت." +msgstr "" msgid "extension module" -msgstr "ماژول افزونه" +msgstr "" msgid "A module written in C or C++, using Python's C API to interact with the core and with user code." -msgstr "ماژول نوشته‌شده به زبان C یا C++ که از API زبان C پایتون برای تعامل با هسته و کد کاربر استفاده می‌کند." +msgstr "" msgid "f-string" -msgstr "اف‌استرینگ" +msgstr "" msgid "f-strings" -msgstr "اف‌استرینگ‌ها" +msgstr "" msgid "String literals prefixed with ``f`` or ``F`` are commonly called \"f-strings\" which is short for :ref:`formatted string literals `. See also :pep:`498`." -msgstr "رشته‌های لفظی که با ``f`` یا ``F`` پیشوندگذاری شده‌اند، معمولاً «اف‌استرینگ» نامیده می‌شوند که کوتاه‌شدهٔ :ref:`formatted string literals ` است. همچنین :pep:`498` را ببینید." +msgstr "" msgid "file object" -msgstr "شیء فایل" +msgstr "" msgid "An object exposing a file-oriented API (with methods such as :meth:`!read` or :meth:`!write`) to an underlying resource. Depending on the way it was created, a file object can mediate access to a real on-disk file or to another type of storage or communication device (for example standard input/output, in-memory buffers, sockets, pipes, etc.). File objects are also called :dfn:`file-like objects` or :dfn:`streams`." -msgstr "شی‌ءای که یک API فایل‌محور (با متدهایی مانند :meth:`!read` یا :meth:`!write`) برای یک منبع زیربنایی ارائه می‌دهد. بسته به نحوهٔ ایجاد آن، یک شیء فایل می‌تواند دسترسی به یک فایل واقعی روی دیسک یا نوع دیگری از فضای ذخیره‌سازی یا دستگاه ارتباطی را مدیریت کند (برای مثال ورودی/خروجی استاندارد، بافرهای درون‌حافظه‌ای، سوکت‌ها، پایپ‌ها و غیره). اشیای فایل همچنین با نام‌های :dfn:`file-like objects` یا :dfn:`streams` شناخته می‌شوند." +msgstr "" msgid "There are actually three categories of file objects: raw :term:`binary files `, buffered :term:`binary files ` and :term:`text files `. Their interfaces are defined in the :mod:`io` module. The canonical way to create a file object is by using the :func:`open` function." -msgstr "در واقع سه دسته از اشیای فایل وجود دارد: :term:`فایل دودویی ` خام، :term:`فایل دودویی ` بافرشده و :term:`فایل متنی `. رابط‌های آن‌ها در ماژول :mod:`io` تعریف شده‌اند. روش استاندارد ایجاد یک شیء فایل، استفاده از تابع :func:`open` است." +msgstr "" msgid "file-like object" -msgstr "شیء شبه‌فایل" +msgstr "" msgid "A synonym for :term:`file object`." -msgstr "هم‌معنای :term:`شیء فایل `." +msgstr "" msgid "filesystem encoding and error handler" -msgstr "کدگذاری سیستم فایل و مدیریت‌کنندهٔ خطا" +msgstr "" msgid "Encoding and error handler used by Python to decode bytes from the operating system and encode Unicode to the operating system." -msgstr "کدگذاری و مدیریت‌کنندهٔ خطایی که پایتون برای کدگشایی بایت‌ها از سیستم‌عامل و کدگذاری یونیکد به سیستم‌عامل استفاده می‌کند." +msgstr "" msgid "The filesystem encoding must guarantee to successfully decode all bytes below 128. If the file system encoding fails to provide this guarantee, API functions can raise :exc:`UnicodeError`." -msgstr "کدگذاری سیستم فایل باید تضمین کند که همهٔ بایت‌های کمتر از ۱۲۸ را با موفقیت کدگشایی می‌کند. اگر کدگذاری سیستم فایل نتواند این تضمین را ارائه دهد، توابع API ممکن است استثنای :exc:`UnicodeError` ایجاد کنند." +msgstr "" msgid "The :func:`sys.getfilesystemencoding` and :func:`sys.getfilesystemencodeerrors` functions can be used to get the filesystem encoding and error handler." -msgstr "از توابع :func:`sys.getfilesystemencoding` و :func:`sys.getfilesystemencodeerrors` می‌توان برای دریافت کدگذاری سیستم فایل و مدیریت‌کنندهٔ خطا استفاده کرد." +msgstr "" msgid "The :term:`filesystem encoding and error handler` are configured at Python startup by the :c:func:`PyConfig_Read` function: see :c:member:`~PyConfig.filesystem_encoding` and :c:member:`~PyConfig.filesystem_errors` members of :c:type:`PyConfig`." -msgstr ":term:`کدگذاری سیستم فایل و مدیریت‌کنندهٔ خطا ` در هنگام راه‌اندازی پایتون توسط تابع :c:func:`PyConfig_Read` پیکربندی می‌شوند: اعضای :c:member:`~PyConfig.filesystem_encoding` و :c:member:`~PyConfig.filesystem_errors` از :c:type:`PyConfig` را ببینید." +msgstr "" msgid "See also the :term:`locale encoding`." -msgstr "همچنین :term:`کدگذاری محلی ` را ببینید." +msgstr "" msgid "finder" -msgstr "یابنده" +msgstr "" msgid "An object that tries to find the :term:`loader` for a module that is being imported." -msgstr "شیءای که تلاش می‌کند :term:`بارگذار ` مربوط به ماژولی را که در حال ایمپورت شدن است پیدا کند." +msgstr "" msgid "There are two types of finder: :term:`meta path finders ` for use with :data:`sys.meta_path`, and :term:`path entry finders ` for use with :data:`sys.path_hooks`." -msgstr "دو نوع یابنده وجود دارد: :term:`یابندهٔ مسیر فراداده ` برای استفاده با :data:`sys.meta_path` و :term:`یابندهٔ ورودی مسیر ` برای استفاده با :data:`sys.path_hooks`." +msgstr "" msgid "See :ref:`finders-and-loaders` and :mod:`importlib` for much more detail." -msgstr "برای جزئیات بسیار بیشتر، :ref:`finders-and-loaders` و :mod:`importlib` را ببینید." +msgstr "" msgid "floor division" -msgstr "تقسیم کف" +msgstr "" msgid "Mathematical division that rounds down to nearest integer. The floor division operator is ``//``. For example, the expression ``11 // 4`` evaluates to ``2`` in contrast to the ``2.75`` returned by float true division. Note that ``(-11) // 4`` is ``-3`` because that is ``-2.75`` rounded *downward*. See :pep:`238`." -msgstr "تقسیم ریاضی که به نزدیک‌ترین عدد صحیح پایین گرد می‌شود. عملگر تقسیم کف ``//`` است. برای مثال، عبارت ``11 // 4`` به ``2`` ارزیابی می‌شود، در حالی که تقسیم حقیقی با عدد اعشاری مقدار ``2.75`` را بازمی‌گرداند. توجه داشته باشید که ``(-11) // 4`` برابر ``-3`` است، زیرا ``-2.75`` به سمت *پایین* گرد می‌شود. :pep:`238` را ببینید." +msgstr "" msgid "free threading" -msgstr "نخ‌گذاری آزاد" +msgstr "" msgid "A threading model where multiple threads can run Python bytecode simultaneously within the same interpreter. This is in contrast to the :term:`global interpreter lock` which allows only one thread to execute Python bytecode at a time. See :pep:`703`." -msgstr "مدل نخ‌ای که در آن چندین نخ می‌توانند بایت‌کد پایتون را به‌طور هم‌زمان درون همان مفسر اجرا کنند. این در تضاد با :term:`قفل مفسر سراسری ` است که اجازه می‌دهد فقط یک نخ در هر زمان بایت‌کد پایتون را اجرا کند. :pep:`703` را ببینید." +msgstr "" msgid "free-threaded build" -msgstr "ساخت نخ‌آزاد" +msgstr "" msgid "A build of :term:`CPython` that supports :term:`free threading`, configured using the :option:`--disable-gil` option before compilation." -msgstr "ساختی از :term:`CPython ` که از :term:`نخ‌گذاری آزاد ` پشتیبانی می‌کند و با استفاده از گزینهٔ :option:`--disable-gil` پیش از کامپایل پیکربندی شده است." +msgstr "" msgid "See :ref:`freethreading-python-howto`." -msgstr ":ref:`freethreading-python-howto` را ببینید." +msgstr "" msgid "free variable" -msgstr "متغیر آزاد" +msgstr "" msgid "Formally, as defined in the :ref:`language execution model `, a free variable is any variable used in a namespace which is not a local variable in that namespace. See :term:`closure variable` for an example. Pragmatically, due to the name of the :attr:`codeobject.co_freevars` attribute, the term is also sometimes used as a synonym for :term:`closure variable`." -msgstr "به‌صورت رسمی، همان‌طور که در :ref:`language execution model ` تعریف شده است، یک متغیر آزاد هر متغیری است که در یک نام‌فضا استفاده می‌شود اما در آن نام‌فضا یک متغیر محلی نیست. برای نمونه، :term:`متغیر بستار ` را ببینید. از نظر عملی، به‌دلیل نام ویژگی :attr:`codeobject.co_freevars`، این اصطلاح گاهی به‌عنوان مترادفی برای :term:`متغیر بستار ` نیز استفاده می‌شود." +msgstr "" msgid "function" -msgstr "تابع" +msgstr "" msgid "A series of statements which returns some value to a caller. It can also be passed zero or more :term:`arguments ` which may be used in the execution of the body. See also :term:`parameter`, :term:`method`, and the :ref:`function` section." -msgstr "مجموعه‌ای از دستورها که مقداری را به یک فراخواننده بازمی‌گرداند. همچنین می‌تواند صفر یا چند :term:`آرگومان ` دریافت کند که ممکن است در اجرای بدنه استفاده شوند. همچنین :term:`پارامتر `، :term:`متد ` و بخش :ref:`function` را ببینید." +msgstr "" msgid "function annotation" -msgstr "حاشیه‌گذاری تابع" +msgstr "" msgid "An :term:`annotation` of a function parameter or return value." -msgstr "یک :term:`حاشیه‌گذاری ` برای پارامتر یک تابع یا مقدار بازگشتی." +msgstr "" msgid "Function annotations are usually used for :term:`type hints `: for example, this function is expected to take two :class:`int` arguments and is also expected to have an :class:`int` return value::" -msgstr "حاشیه‌گذاری‌های تابع معمولاً برای :term:`راهنمای نوع ` استفاده می‌شوند: برای مثال، انتظار می‌رود این تابع دو آرگومان :class:`int` دریافت کند و همچنین یک مقدار بازگشتی :class:`int` داشته باشد::" +msgstr "" msgid "" "def sum_two_numbers(a: int, b: int) -> int:\n" " return a + b" msgstr "" -"def sum_two_numbers(a: int, b: int) -> int:\n" -" return a + b" msgid "Function annotation syntax is explained in section :ref:`function`." -msgstr "نحو حاشیه‌گذاری تابع در بخش :ref:`function` توضیح داده شده است." +msgstr "" msgid "See :term:`variable annotation` and :pep:`484`, which describe this functionality. Also see :ref:`annotations-howto` for best practices on working with annotations." -msgstr "به :term:`حاشیه‌نویسی متغیر ` و :pep:`484` مراجعه کنید که این قابلیت را توضیح می‌دهند. همچنین برای بهترین روش‌ها در کار با حاشیه‌گذاری‌ها، :ref:`annotations-howto` را ببینید." +msgstr "" msgid "__future__" -msgstr "__future__" +msgstr "" msgid "A :ref:`future statement `, ``from __future__ import ``, directs the compiler to compile the current module using syntax or semantics that will become standard in a future release of Python. The :mod:`__future__` module documents the possible values of *feature*. By importing this module and evaluating its variables, you can see when a new feature was first added to the language and when it will (or did) become the default::" -msgstr "یک :ref:`future statement `، یعنی ``from __future__ import ``, به کامپایلر دستور می‌دهد ماژول فعلی را با استفاده از سینتکس یا معناشناسی‌ای کامپایل کند که در یک انتشار آیندهٔ پایتون استاندارد خواهد شد. ماژول :mod:`__future__` مقادیر ممکن *feature* را مستند می‌کند. با ایمپورت این ماژول و ارزیابی متغیرهای آن، می‌توانید ببینید چه زمانی یک ویژگی جدید برای اولین بار به زبان اضافه شده است و چه زمانی به حالت پیش‌فرض تبدیل خواهد شد (یا شده است)::" +msgstr "" msgid "" ">>> import __future__\n" ">>> __future__.division\n" "_Feature((2, 2, 0, 'alpha', 2), (3, 0, 0, 'alpha', 0), 8192)" msgstr "" -">>> import __future__\n" -">>> __future__.division\n" -"_Feature((2, 2, 0, 'alpha', 2), (3, 0, 0, 'alpha', 0), 8192)" msgid "garbage collection" -msgstr "زباله‌روبی" +msgstr "" msgid "The process of freeing memory when it is not used anymore. Python performs garbage collection via reference counting and a cyclic garbage collector that is able to detect and break reference cycles. The garbage collector can be controlled using the :mod:`gc` module." -msgstr "فرایند آزادسازی حافظه هنگامی که دیگر استفاده نمی‌شود. پایتون زباله‌روبی را از طریق شمارش ارجاع‌ها و یک زباله‌روب چرخه‌ای که قادر به شناسایی و شکستن چرخه‌های ارجاع است انجام می‌دهد. زباله‌روب را می‌توان با استفاده از ماژول :mod:`gc` کنترل کرد." +msgstr "" msgid "generator" -msgstr "تولیدگر" - -msgid "Informally used to mean either a :term:`generator function` or a :term:`generator iterator`, depending on context. The formal terms :term:`generator function` and :term:`generator iterator` are uncommon in practice; \"generator\" alone is almost always sufficient." -msgstr "به‌صورت غیررسمی برای اشاره به یک :term:`تابع تولیدگر ` یا یک :term:`تکرارگر تولیدگر `، بسته به زمینه، استفاده می‌شود. اصطلاحات رسمی :term:`تابع تولیدگر ` و :term:`تکرارگر تولیدگر ` در عمل کمتر استفاده می‌شوند؛ «تولیدگر» به‌تنهایی تقریباً همیشه کافی است." +msgstr "" -msgid "generator function" -msgstr "تابع تولیدگر" +msgid "A function which returns a :term:`generator iterator`. It looks like a normal function except that it contains :keyword:`yield` expressions for producing a series of values usable in a for-loop or that can be retrieved one at a time with the :func:`next` function." +msgstr "" -msgid "A function which returns a :term:`generator` object. It looks like a normal function except that it contains :keyword:`yield` expressions for producing a series of values usable in a :keyword:`for`\\-loop or that can be retrieved one at a time with the :func:`next` function. See :ref:`yieldexpr`." -msgstr "تابعی که یک شیء :term:`تولیدگر ` بازمی‌گرداند. این تابع شبیه یک تابع معمولی است، با این تفاوت که شامل عبارت‌های :keyword:`yield` برای تولید مجموعه‌ای از مقادیر قابل استفاده در یک حلقهٔ :keyword:`for` یا قابل بازیابی یکی‌یکی با تابع :func:`next` است. :ref:`yieldexpr` را ببینید." +msgid "Usually refers to a generator function, but may refer to a *generator iterator* in some contexts. In cases where the intended meaning isn't clear, using the full terms avoids ambiguity." +msgstr "" msgid "generator iterator" -msgstr "تکرارگر تولیدگر" - -msgid "An object created by a :term:`generator function` or a :term:`generator expression`." -msgstr "شیءای که توسط یک :term:`تابع تولیدگر ` یا یک :term:`عبارت تولیدگر ` ایجاد می‌شود." +msgstr "" -msgid "Each :keyword:`yield` temporarily suspends processing, remembering the execution state (including local variables and pending try-statements). When the *generator iterator* resumes, it picks up where it left off (in contrast to functions which start fresh on every invocation)." -msgstr "هر :keyword:`yield` پردازش را به‌طور موقت متوقف می‌کند و وضعیت اجرا (شامل متغیرهای محلی و دستورهای try در انتظار) را به خاطر می‌سپارد. هنگامی که *تکرارگر تولیدگر* ادامهٔ اجرا می‌دهد، از همان نقطه‌ای که متوقف شده بود ادامه می‌دهد (برخلاف توابع که در هر فراخوانی از ابتدا شروع می‌شوند)." +msgid "An object created by a :term:`generator` function." +msgstr "" -msgid "Generator iterators also implement the :meth:`~generator.send` method to send a value into the suspended generator, and the :meth:`~generator.throw` method to raise an exception at the point where the generator was paused. See :ref:`generator-methods`." -msgstr "تکرارگرهای تولیدگر همچنین متد :meth:`~generator.send` را برای ارسال یک مقدار به تولیدگر متوقف‌شده و متد :meth:`~generator.throw` را برای پرتاب یک استثنا در نقطه‌ای که تولیدگر در آن متوقف شده است، پیاده‌سازی می‌کنند. بخش :ref:`generator-methods` را ببینید." +msgid "Each :keyword:`yield` temporarily suspends processing, remembering the execution state (including local variables and pending try-statements). When the *generator iterator* resumes, it picks up where it left off (in contrast to functions which start fresh on every invocation)." +msgstr "" msgid "generator expression" -msgstr "عبارت تولیدگر" +msgstr "" msgid "An :term:`expression` that returns an :term:`iterator`. It looks like a normal expression followed by a :keyword:`!for` clause defining a loop variable, range, and an optional :keyword:`!if` clause. The combined expression generates values for an enclosing function::" -msgstr "یک :term:`عبارت ` که یک :term:`تکرارگر ` بازمی‌گرداند. این عبارت شبیه یک عبارت معمولی است که پس از آن یک بند :keyword:`!for` برای تعریف متغیر حلقه، محدوده و یک بند اختیاری :keyword:`!if` قرار گرفته است. عبارت ترکیبی، مقادیری را برای یک تابع دربرگیرنده تولید می‌کند::" +msgstr "" msgid "" ">>> sum(i*i for i in range(10)) # sum of squares 0, 1, 4, ... 81\n" "285" msgstr "" -">>> sum(i*i for i in range(10)) # sum of squares 0, 1, 4, ... 81\n" -"285" msgid "generic function" -msgstr "تابع عمومی" +msgstr "" msgid "A function composed of multiple functions implementing the same operation for different types. Which implementation should be used during a call is determined by the dispatch algorithm." -msgstr "تابعی که از چندین تابع تشکیل شده است که یک عملیات یکسان را برای نوع‌های مختلف پیاده‌سازی می‌کنند. این‌که هنگام یک فراخوانی کدام پیاده‌سازی استفاده شود، توسط الگوریتم ارسال تعیین می‌شود." +msgstr "" -msgid "See also the :term:`single dispatch` glossary entry, the :deco:`functools.singledispatch` decorator, and :pep:`443`." -msgstr "همچنین به ورودی واژه‌نامه‌ای :term:`توزیع تک‌گانه `، دکوریتور :func:`functools.singledispatch` و :pep:`443` مراجعه کنید." +msgid "See also the :term:`single dispatch` glossary entry, the :func:`functools.singledispatch` decorator, and :pep:`443`." +msgstr "" msgid "generic type" -msgstr "نوع عمومی" +msgstr "" msgid "A :term:`type` that can be parameterized; typically a :ref:`container class` such as :class:`list` or :class:`dict`. Used for :term:`type hints ` and :term:`annotations `." -msgstr "یک :term:`نوع ` که می‌تواند پارامتری شود؛ معمولاً یک :ref:`container class` مانند :class:`list` یا :class:`dict`. برای :term:`راهنمای نوع ` و :term:`حاشیه‌گذاری ` استفاده می‌شود." +msgstr "" msgid "For more details, see :ref:`generic alias types`, :pep:`483`, :pep:`484`, :pep:`585`, and the :mod:`typing` module." -msgstr "برای جزئیات بیشتر، :ref:`generic alias types`، :pep:`483`، :pep:`484`، :pep:`585` و ماژول :mod:`typing` را ببینید." +msgstr "" msgid "GIL" -msgstr "GIL" +msgstr "" msgid "See :term:`global interpreter lock`." -msgstr ":term:`قفل مفسر سراسری ` را ببینید." +msgstr "" msgid "global interpreter lock" -msgstr "قفل مفسر سراسری" +msgstr "" msgid "The mechanism used by the :term:`CPython` interpreter to assure that only one thread executes Python :term:`bytecode` at a time. This simplifies the CPython implementation by making the object model (including critical built-in types such as :class:`dict`) implicitly safe against concurrent access. Locking the entire interpreter makes it easier for the interpreter to be multi-threaded, at the expense of much of the parallelism afforded by multi-processor machines." -msgstr "سازوکاری که توسط مفسر :term:`CPython ` استفاده می‌شود تا تضمین کند در هر زمان فقط یک نخ :term:`بایت‌کد ` پایتون را اجرا می‌کند. این کار پیاده‌سازی CPython را ساده‌تر می‌کند، زیرا مدل شیء (شامل نوع‌های توکار مهمی مانند :class:`dict`) به‌طور ضمنی در برابر دسترسی هم‌زمان ایمن می‌شود. قفل کردن کل مفسر باعث می‌شود چندنخی کردن مفسر آسان‌تر شود، اما به قیمت از دست دادن بخش زیادی از موازی‌سازی‌ای که ماشین‌های چندپردازنده‌ای فراهم می‌کنند." +msgstr "" msgid "However, some extension modules, either standard or third-party, are designed so as to release the GIL when doing computationally intensive tasks such as compression or hashing. Also, the GIL is always released when doing I/O." -msgstr "با این حال، برخی ماژول‌های افزونه، چه استاندارد و چه شخص ثالث، به‌گونه‌ای طراحی شده‌اند که هنگام انجام وظایف محاسباتی سنگین مانند فشرده‌سازی یا درهم‌سازی، GIL را آزاد کنند. همچنین، GIL همیشه هنگام انجام عملیات ورودی/خروجی آزاد می‌شود." +msgstr "" msgid "As of Python 3.13, the GIL can be disabled using the :option:`--disable-gil` build configuration. After building Python with this option, code must be run with :option:`-X gil=0 <-X>` or after setting the :envvar:`PYTHON_GIL=0 ` environment variable. This feature enables improved performance for multi-threaded applications and makes it easier to use multi-core CPUs efficiently. For more details, see :pep:`703`." -msgstr "از پایتون ۳.۱۳، می‌توان GIL را با استفاده از پیکربندی ساخت :option:`--disable-gil` غیرفعال کرد. پس از ساخت پایتون با این گزینه، کد باید با :option:`-X gil=0 <-X>` یا پس از تنظیم متغیر محیطی :envvar:`PYTHON_GIL=0 ` اجرا شود. این ویژگی عملکرد بهتر برای برنامه‌های چندنخی را فراهم می‌کند و استفادهٔ مؤثرتر از CPUهای چند‌هسته‌ای را آسان‌تر می‌سازد. برای جزئیات بیشتر، :pep:`703` را ببینید." +msgstr "" msgid "In prior versions of Python's C API, a function might declare that it requires the GIL to be held in order to use it. This refers to having an :term:`attached thread state`." -msgstr "در نسخه‌های پیشین API زبان C پایتون، یک تابع ممکن بود اعلام کند که برای استفاده از آن، لازم است GIL در اختیار گرفته شده باشد. این موضوع به داشتن یک :term:`وضعیت نخ متصل ` اشاره دارد." +msgstr "" msgid "global state" -msgstr "وضعیت سراسری" +msgstr "" msgid "Data that is accessible throughout a program, such as module-level variables, class variables, or C static variables in :term:`extension modules `. In multi-threaded programs, global state shared between threads typically requires synchronization to avoid :term:`race conditions ` and :term:`data races `." -msgstr "داده‌ای که در سراسر یک برنامه قابل دسترسی است، مانند متغیرهای سطح ماژول، متغیرهای کلاس یا متغیرهای ایستای C در :term:`ماژول افزونه `. در برنامه‌های چندنخی، وضعیت سراسری اشتراک‌گذاری‌شده بین نخ‌ها معمولاً برای جلوگیری از :term:`شرط رقابت ` و :term:`رقابت داده ` به همگام‌سازی نیاز دارد." +msgstr "" msgid "hash-based pyc" -msgstr "pyc مبتنی بر هش" +msgstr "" msgid "A bytecode cache file that uses the hash rather than the last-modified time of the corresponding source file to determine its validity. See :ref:`pyc-invalidation`." -msgstr "یک فایل نهانگاه بایت‌کد که به‌جای زمان آخرین تغییر فایل منبع متناظر، از هش آن برای تعیین اعتبار خود استفاده می‌کند. :ref:`pyc-invalidation` را ببینید." +msgstr "" msgid "hashable" -msgstr "قابل درهم‌سازی" +msgstr "" msgid "An object is *hashable* if it has a hash value which never changes during its lifetime (it needs a :meth:`~object.__hash__` method), and can be compared to other objects (it needs an :meth:`~object.__eq__` method). Hashable objects which compare equal must have the same hash value." -msgstr "یک شیء *قابل درهم‌سازی* است اگر دارای یک مقدار هش باشد که در طول عمر آن هرگز تغییر نمی‌کند (به یک متد :meth:`~object.__hash__` نیاز دارد) و بتوان آن را با اشیای دیگر مقایسه کرد (به یک متد :meth:`~object.__eq__` نیاز دارد). اشیای قابل درهم‌سازی که برابر مقایسه می‌شوند باید مقدار هش یکسانی داشته باشند." +msgstr "" msgid "Hashability makes an object usable as a dictionary key and a set member, because these data structures use the hash value internally." -msgstr "قابل درهم‌سازی بودن باعث می‌شود یک شیء به‌عنوان کلید دیکشنری و عضو مجموعه قابل استفاده باشد، زیرا این ساختارهای داده مقدار هش را به‌صورت داخلی استفاده می‌کنند." +msgstr "" msgid "Most of Python's immutable built-in objects are hashable; mutable containers (such as lists or dictionaries) are not; immutable containers (such as tuples and frozensets) are only hashable if their elements are hashable. Objects which are instances of user-defined classes are hashable by default. They all compare unequal (except with themselves), and their hash value is derived from their :func:`id`." -msgstr "بیشتر اشیای توکار تغییرناپذیر پایتون قابل درهم‌سازی هستند؛ محفظه‌های تغییرپذیر (مانند فهرست‌ها یا دیکشنری‌ها) قابل درهم‌سازی نیستند؛ محفظه‌های تغییرناپذیر (مانند تاپل‌ها یا frozensetها) فقط در صورتی قابل درهم‌سازی هستند که عناصرشان قابل درهم‌سازی باشند. اشیایی که نمونه‌هایی از کلاس‌های تعریف‌شده توسط کاربر هستند، به‌طور پیش‌فرض قابل درهم‌سازی هستند. همهٔ آن‌ها نابرابر مقایسه می‌شوند (به‌جز با خودشان) و مقدار هش آن‌ها از :func:`id` آن‌ها مشتق می‌شود." +msgstr "" msgid "IDLE" -msgstr "IDLE" +msgstr "" msgid "An Integrated Development and Learning Environment for Python. :ref:`idle` is a basic editor and interpreter environment which ships with the standard distribution of Python." -msgstr "یک محیط توسعه و یادگیری یکپارچه برای پایتون. :ref:`idle` یک محیط ویرایشگر و مفسر پایه است که همراه با توزیع استاندارد پایتون ارائه می‌شود." +msgstr "" msgid "immortal" -msgstr "نامیرا" +msgstr "" msgid "*Immortal objects* are a CPython implementation detail introduced in :pep:`683`." -msgstr "*اشیای نامیرا* یک جزئیات پیاده‌سازی CPython هستند که در :pep:`683` معرفی شده‌اند." +msgstr "" msgid "If an object is immortal, its :term:`reference count` is never modified, and therefore it is never deallocated while the interpreter is running. For example, :const:`True` and :const:`None` are immortal in CPython." -msgstr "اگر یک شیء نامیرا باشد، :term:`شمارندهٔ ارجاع ` آن هرگز تغییر نمی‌کند و بنابراین تا زمانی که مفسر در حال اجرا است، هرگز آزاد نمی‌شود. برای مثال، :const:`True` و :const:`None` در CPython نامیرا هستند." +msgstr "" msgid "Immortal objects can be identified via :func:`sys._is_immortal`, or via :c:func:`PyUnstable_IsImmortal` in the C API." -msgstr "اشیای نامیرا را می‌توان از طریق :func:`sys._is_immortal` یا از طریق :c:func:`PyUnstable_IsImmortal` در API زبان C شناسایی کرد." +msgstr "" msgid "immutable" -msgstr "تغییرناپذیر" +msgstr "" msgid "An object with a fixed value. Immutable objects include numbers, strings and tuples. Such an object cannot be altered. A new object has to be created if a different value has to be stored. They play an important role in places where a constant hash value is needed, for example as a key in a dictionary. Immutable objects are inherently :term:`thread-safe` because their state cannot be modified after creation, eliminating concerns about improperly synchronized :term:`concurrent modification`." -msgstr "شیءای با مقدار ثابت. اشیای تغییرناپذیر شامل اعداد، نخ‌ها و تاپل‌ها هستند. چنین شی‌ءای نمی‌تواند تغییر داده شود. اگر لازم باشد مقدار متفاوتی ذخیره شود، باید شیء جدیدی ایجاد شود. آن‌ها در جاهایی که مقدار هش ثابت لازم است، برای مثال به‌عنوان یک کلید در یک دیکشنری، نقش مهمی دارند. اشیای تغییرناپذیر ذاتاً :term:`ایمن برای نخ‌های اجرایی ` هستند، زیرا وضعیت آن‌ها پس از ایجاد قابل تغییر نیست و نگرانی‌ها دربارهٔ :term:`تغییر هم‌زمان ` که به‌درستی همگام‌سازی نشده است، از بین می‌رود." +msgstr "" msgid "import path" -msgstr "مسیر ایمپورت" +msgstr "" msgid "A list of locations (or :term:`path entries `) that are searched by the :term:`path based finder` for modules to import. During import, this list of locations usually comes from :data:`sys.path`, but for subpackages it may also come from the parent package's ``__path__`` attribute." -msgstr "فهرستی از مکان‌ها (یا :term:`ورودی مسیر `) که توسط :term:`یابندهٔ مبتنی بر مسیر ` برای ماژول‌های قابل ایمپورت جست‌وجو می‌شود. هنگام ایمپورت، این فهرست از مکان‌ها معمولاً از :data:`sys.path` می‌آید، اما برای زیر‌بسته‌ها ممکن است از ویژگی ``__path__`` بستهٔ والد نیز به‌دست آید." +msgstr "" msgid "importing" -msgstr "ایمپورت کردن" +msgstr "" msgid "The process by which Python code in one module is made available to Python code in another module." -msgstr "فرایندی که طی آن کد پایتون در یک ماژول برای کد پایتون در ماژولی دیگر در دسترس قرار می‌گیرد." +msgstr "" msgid "importer" -msgstr "ایمپورت‌کننده" +msgstr "" msgid "An object that both finds and loads a module; both a :term:`finder` and :term:`loader` object." -msgstr "شی‌ءای که هم یک ماژول را پیدا می‌کند و هم آن را بارگذاری می‌کند؛ هم یک شیء :term:`یابنده ` و هم یک شیء :term:`بارگذار `." +msgstr "" msgid "index" -msgstr "اندیس" +msgstr "" msgid "A numeric value that represents the position of an element in a :term:`sequence`." -msgstr "مقداری عددی که موقعیت یک المان را در یک :term:`دنباله ` نشان می‌دهد." +msgstr "" msgid "In Python, indexing starts at zero. For example, ``things[0]`` names the *first* element of ``things``; ``things[1]`` names the second one." -msgstr "در پایتون، اندیس‌گذاری از صفر شروع می‌شود. برای مثال، ``things[0]`` نخستین المان ``things`` را نام‌گذاری می‌کند؛ ``things[1]`` دومین مورد را نام‌گذاری می‌کند." +msgstr "" msgid "In some contexts, Python allows negative indexes for counting from the end of a sequence, and indexing using :term:`slices `." -msgstr "در برخی زمینه‌ها، پایتون اجازه می‌دهد از اندیس‌های منفی برای شمارش از انتهای یک دنباله و از اندیس‌گذاری با استفاده از :term:`برش ` استفاده شود." +msgstr "" msgid "See also :term:`subscript`." -msgstr "همچنین :term:`زیرنویس ` را ببینید." +msgstr "" msgid "interactive" -msgstr "تعاملی" +msgstr "" msgid "Python has an interactive interpreter which means you can enter statements and expressions at the interpreter prompt, immediately execute them and see their results. Just launch ``python`` with no arguments (possibly by selecting it from your computer's main menu). It is a very powerful way to test out new ideas or inspect modules and packages (remember ``help(x)``). For more on interactive mode, see :ref:`tut-interac`." -msgstr "پایتون یک مفسر تعاملی دارد، یعنی می‌توانید دستورها و عبارت‌ها را در اعلان مفسر وارد کنید، آن‌ها را بلافاصله اجرا کنید و نتایجشان را ببینید. فقط ``python`` را بدون آرگومان اجرا کنید (احتمالاً با انتخاب آن از منوی اصلی رایانهٔ خود). این روش بسیار قدرتمندی برای آزمایش ایده‌های جدید یا بررسی ماژول‌ها و بسته‌ها است (``help(x)`` را به خاطر داشته باشید). برای اطلاعات بیشتر دربارهٔ حالت تعاملی، :ref:`tut-interac` را ببینید." +msgstr "" msgid "interpreted" -msgstr "تفسیری" +msgstr "" msgid "Python is an interpreted language, as opposed to a compiled one, though the distinction can be blurry because of the presence of the bytecode compiler. This means that source files can be run directly without explicitly creating an executable which is then run. Interpreted languages typically have a shorter development/debug cycle than compiled ones, though their programs generally also run more slowly. See also :term:`interactive`." -msgstr "پایتون زبانی تفسیری است، در مقابل زبان‌های کامپایل‌شده، هرچند به‌دلیل وجود کامپایلر بایت‌کد، این تمایز می‌تواند مبهم باشد. این یعنی فایل‌های منبع را می‌توان بدون ایجاد صریح یک فایل اجرایی که سپس اجرا شود، مستقیماً اجرا کرد. زبان‌های تفسیری معمولاً چرخهٔ توسعه/اشکال‌زدایی کوتاه‌تری نسبت به زبان‌های کامپایل‌شده دارند، هرچند برنامه‌های آن‌ها معمولاً کندتر اجرا می‌شوند. همچنین :term:`تعاملی ` را ببینید." +msgstr "" msgid "interpreter shutdown" -msgstr "خاموشی مفسر" +msgstr "" msgid "When asked to shut down, the Python interpreter enters a special phase where it gradually releases all allocated resources, such as modules and various critical internal structures. It also makes several calls to the :term:`garbage collector `. This can trigger the execution of code in user-defined destructors or weakref callbacks. Code executed during the shutdown phase can encounter various exceptions as the resources it relies on may not function anymore (common examples are library modules or the warnings machinery)." -msgstr "هنگامی که از مفسر پایتون خواسته می‌شود خاموش شود، وارد مرحلهٔ ویژه‌ای می‌شود که در آن به‌تدریج همهٔ منابع تخصیص‌یافته، مانند ماژول‌ها و ساختارهای داخلی مهم مختلف، آزاد می‌شوند. همچنین چندین فراخوانی به :term:`زباله‌روبی ` انجام می‌دهد. این کار می‌تواند اجرای کد در نابودگرهای تعریف‌شده توسط کاربر یا کال‌بک‌های weakref را فعال کند. کدی که در مرحلهٔ خاموشی اجرا می‌شود ممکن است با استثناهای مختلفی روبه‌رو شود، زیرا منابعی که به آن‌ها وابسته است ممکن است دیگر کار نکنند (نمونه‌های رایج شامل ماژول‌های کتابخانه یا سازوکار هشدارها هستند)." +msgstr "" msgid "The main reason for interpreter shutdown is that the ``__main__`` module or the script being run has finished executing." -msgstr "دلیل اصلی خاموشی مفسر این است که ماژول ``__main__`` یا اسکریپتی که در حال اجرا است، اجرای خود را به پایان رسانده است." +msgstr "" msgid "iterable" -msgstr "تکرارپذیر" +msgstr "" msgid "An object capable of returning its members one at a time. Examples of iterables include all sequence types (such as :class:`list`, :class:`str`, and :class:`tuple`) and some non-sequence types like :class:`dict`, :term:`file objects `, and objects of any classes you define with an :meth:`~object.__iter__` method or with a :meth:`~object.__getitem__` method that implements :term:`sequence` semantics." -msgstr "شیءای که قادر است اعضای خود را یکی‌یکی بازگرداند. نمونه‌هایی از تکرارپذیرها شامل همهٔ نوع‌های دنباله‌ای (مانند :class:`list`، :class:`str` و :class:`tuple`) و برخی نوع‌های غیرتوالی مانند :class:`dict`، :term:`شیء فایل ` و اشیای هر کلاسی که شما با متد :meth:`~object.__iter__` یا با متد :meth:`~object.__getitem__` که معناشناسی :term:`دنباله ` را پیاده‌سازی می‌کند تعریف می‌کنید، هستند." +msgstr "" msgid "Iterables can be used in a :keyword:`for` loop and in many other places where a sequence is needed (:func:`zip`, :func:`map`, ...). When an iterable object is passed as an argument to the built-in function :func:`iter`, it returns an iterator for the object. This iterator is good for one pass over the set of values. When using iterables, it is usually not necessary to call :func:`iter` or deal with iterator objects yourself. The :keyword:`for` statement does that automatically for you, creating a temporary unnamed variable to hold the iterator for the duration of the loop. See also :term:`iterator`, :term:`sequence`, and :term:`generator`." -msgstr "تکرارپذیرها را می‌توان در یک حلقهٔ :keyword:`for` و در بسیاری از مکان‌های دیگری که یک دنباله لازم است (:func:`zip`، :func:`map` و ...) استفاده کرد. هنگامی که یک شیء تکرارپذیر به‌عنوان آرگومان به تابع توکار :func:`iter` داده می‌شود، یک تکرارگر برای آن شیء بازمی‌گرداند. این تکرارگر برای یک بار پیمایش مجموعهٔ مقادیر مناسب است. هنگام استفاده از تکرارپذیرها، معمولاً لازم نیست خودتان :func:`iter` را فراخوانی کنید یا با اشیای تکرارگر سروکار داشته باشید. دستور :keyword:`for` این کار را به‌طور خودکار برای شما انجام می‌دهد و یک متغیر موقتِ بدون نام ایجاد می‌کند تا در طول حلقه تکرارگر را نگه دارد. همچنین :term:`تکرارگر `، :term:`دنباله ` و :term:`تولیدگر ` را ببینید." +msgstr "" msgid "iterator" -msgstr "تکرارگر" +msgstr "" msgid "An object representing a stream of data. Repeated calls to the iterator's :meth:`~iterator.__next__` method (or passing it to the built-in function :func:`next`) return successive items in the stream. When no more data are available a :exc:`StopIteration` exception is raised instead. At this point, the iterator object is exhausted and any further calls to its :meth:`!__next__` method just raise :exc:`StopIteration` again. Iterators are required to have an :meth:`~iterator.__iter__` method that returns the iterator object itself so every iterator is also iterable and may be used in most places where other iterables are accepted. One notable exception is code which attempts multiple iteration passes. A container object (such as a :class:`list`) produces a fresh new iterator each time you pass it to the :func:`iter` function or use it in a :keyword:`for` loop. Attempting this with an iterator will just return the same exhausted iterator object used in the previous iteration pass, making it appear like an empty container." -msgstr "شیءای که جریانی از داده‌ها را نمایش می‌دهد. فراخوانی‌های تکراری متد :meth:`~iterator.__next__` تکرارگر (یا ارسال آن به تابع توکار :func:`next`) آیتم‌های پیاپی در جریان را بازمی‌گرداند. هنگامی که دادهٔ بیشتری در دسترس نباشد، به‌جای آن استثنای :exc:`StopIteration` پرتاب می‌شود. در این نقطه، شیء تکرارگر تمام شده است و هر فراخوانی بعدی متد :meth:`!__next__` آن، دوباره فقط استثنای :exc:`StopIteration` ایجاد می‌کند. تکرارگرها باید متد :meth:`~iterator.__iter__` داشته باشند که خود شیء تکرارگر را بازمی‌گرداند، بنابراین هر تکرارگر تکرارپذیر نیز هست و می‌تواند در بیشتر جاهایی که تکرارپذیرهای دیگر پذیرفته می‌شوند استفاده شود. یک استثنای قابل توجه، کدی است که تلاش می‌کند چندین بار پیمایش انجام دهد. یک شیء محفظه‌ای (مانند :class:`list`) هر بار که به تابع :func:`iter` داده شود یا در یک حلقهٔ :keyword:`for` استفاده شود، یک تکرارگر جدید تولید می‌کند. تلاش برای انجام این کار با یک تکرارگر، فقط همان شیء تکرارگر تمام‌شده‌ای را بازمی‌گرداند که در پیمایش قبلی استفاده شده بود و باعث می‌شود مانند یک محفظهٔ خالی به نظر برسد." +msgstr "" msgid "More information can be found in :ref:`typeiter`." -msgstr "اطلاعات بیشتر را می‌توان در :ref:`typeiter` یافت." +msgstr "" msgid "CPython does not consistently apply the requirement that an iterator define :meth:`~iterator.__iter__`. And also please note that :term:`free-threaded ` CPython does not guarantee :term:`thread-safe` behavior of iterator operations." -msgstr "CPython به‌طور سازگار الزام تعریف متد :meth:`~iterator.__iter__` برای یک تکرارگر را اعمال نمی‌کند. همچنین توجه داشته باشید که CPython :term:`نخ‌گذاری آزاد ` رفتار :term:`ایمن برای نخ‌های اجرایی ` را برای عملیات تکرارگرها تضمین نمی‌کند." +msgstr "" msgid "key" -msgstr "کلید" +msgstr "" msgid "A value that identifies an entry in a :term:`mapping`. See also :term:`subscript`." -msgstr "مقداری که یک ورودی را در یک :term:`نگاشت ` شناسایی می‌کند. همچنین :term:`زیرنویس ` را ببینید." +msgstr "" msgid "key function" -msgstr "تابع کلید" +msgstr "" msgid "A key function or collation function is a callable that returns a value used for sorting or ordering. For example, :func:`locale.strxfrm` is used to produce a sort key that is aware of locale specific sort conventions." -msgstr "یک تابع کلید یا تابع هم‌ترازی، یک شیء قابل فراخوانی است که مقداری را بازمی‌گرداند که برای مرتب‌سازی یا ترتیب‌دهی استفاده می‌شود. برای مثال، :func:`locale.strxfrm` برای تولید یک کلید مرتب‌سازی که از قراردادهای مرتب‌سازی خاص یک محلی آگاه است استفاده می‌شود." +msgstr "" msgid "A number of tools in Python accept key functions to control how elements are ordered or grouped. They include :func:`min`, :func:`max`, :func:`sorted`, :meth:`list.sort`, :func:`heapq.merge`, :func:`heapq.nsmallest`, :func:`heapq.nlargest`, and :func:`itertools.groupby`." -msgstr "تعدادی از ابزارهای پایتون، توابع کلید را برای کنترل نحوهٔ ترتیب‌دهی یا گروه‌بندی المان‌ها می‌پذیرند. این ابزارها شامل :func:`min`، :func:`max`، :func:`sorted`، :meth:`list.sort`، :func:`heapq.merge`، :func:`heapq.nsmallest`، :func:`heapq.nlargest` و :func:`itertools.groupby` هستند." +msgstr "" msgid "There are several ways to create a key function. For example. the :meth:`str.casefold` method can serve as a key function for case insensitive sorts. Alternatively, a key function can be built from a :keyword:`lambda` expression such as ``lambda r: (r[0], r[2])``. Also, :func:`operator.attrgetter`, :func:`operator.itemgetter`, and :func:`operator.methodcaller` are three key function constructors. See the :ref:`Sorting HOW TO ` for examples of how to create and use key functions." -msgstr "چندین روش برای ایجاد یک تابع کلید وجود دارد. برای مثال، متد :meth:`str.casefold` می‌تواند به‌عنوان یک تابع کلید برای مرتب‌سازی‌های بدون حساسیت به بزرگی و کوچکی حروف استفاده شود. همچنین، یک تابع کلید می‌تواند از یک عبارت :keyword:`lambda` مانند ``lambda r: (r[0], r[2])`` ساخته شود. علاوه بر این، :func:`operator.attrgetter`، :func:`operator.itemgetter` و :func:`operator.methodcaller` سه سازندهٔ تابع کلید هستند. برای نمونه‌هایی از نحوهٔ ایجاد و استفاده از توابع کلید، :ref:`Sorting HOW TO ` را ببینید." +msgstr "" msgid "keyword argument" -msgstr "آرگومان کلیدواژه‌ای" +msgstr "" msgid "See :term:`argument`." -msgstr ":term:`آرگومان ` را ببینید." +msgstr "" msgid "lambda" -msgstr "lambda" +msgstr "" msgid "An anonymous inline function consisting of a single :term:`expression` which is evaluated when the function is called. The syntax to create a lambda function is ``lambda [parameters]: expression``" -msgstr "یک تابع درون‌خطی بی‌نام که از یک :term:`عبارت ` واحد تشکیل شده است و هنگام فراخوانی تابع ارزیابی می‌شود. سینتکس ایجاد یک تابع lambda به‌صورت ``lambda [parameters]: expression`` است" +msgstr "" msgid "LBYL" -msgstr "LBYL" +msgstr "" msgid "Look before you leap. This coding style explicitly tests for pre-conditions before making calls or lookups. This style contrasts with the :term:`EAFP` approach and is characterized by the presence of many :keyword:`if` statements." -msgstr "پیش از جهش نگاه کنید. این سبک کدنویسی پیش‌شرط‌ها را پیش از انجام فراخوانی‌ها یا جست‌وجوها به‌طور صریح آزمایش می‌کند. این سبک در تضاد با رویکرد :term:`EAFP ` است و با وجود تعداد زیادی دستور :keyword:`if` شناخته می‌شود." +msgstr "" msgid "In a multi-threaded environment, the LBYL approach can risk introducing a :term:`race condition` between \"the looking\" and \"the leaping\". For example, the code, ``if key in mapping: return mapping[key]`` can fail if another thread removes *key* from *mapping* after the test, but before the lookup. This issue can be solved with :term:`locks ` or by using the :term:`EAFP` approach. See also :term:`thread-safe`." -msgstr "در یک محیط چندنخی، رویکرد LBYL می‌تواند خطر ایجاد یک :term:`شرط رقابت ` بین «نگاه کردن» و «جهش کردن» را به همراه داشته باشد. برای مثال، کد ``if key in mapping: return mapping[key]`` ممکن است شکست بخورد اگر نخ‌ای دیگر پس از آزمون، اما پیش از جست‌وجو، *key* را از *mapping* حذف کند. این مشکل را می‌توان با :term:`قفل ` یا با استفاده از رویکرد :term:`EAFP ` حل کرد. همچنین :term:`ایمن برای نخ‌های اجرایی ` را ببینید." +msgstr "" msgid "lexical analyzer" -msgstr "تحلیلگر واژگانی" +msgstr "" msgid "Formal name for the *tokenizer*; see :term:`token`." -msgstr "نام رسمی برای *tokenizer*؛ :term:`توکن ` را ببینید." +msgstr "" msgid "list" -msgstr "فهرست" +msgstr "" msgid "A built-in Python :term:`sequence`. Despite its name it is more akin to an array in other languages than to a linked list since access to elements is *O*\\ (1)." -msgstr "یک :term:`دنباله ` توکار پایتون. با وجود نام آن، این نوع بیشتر شبیه یک آرایه در زبان‌های دیگر است تا یک فهرست پیوندی، زیرا دسترسی به المان‌ها *O*\\ (1) است." +msgstr "" msgid "list comprehension" -msgstr "درک فهرستی" +msgstr "" msgid "A compact way to process all or part of the elements in a sequence and return a list with the results. ``result = ['{:#04x}'.format(x) for x in range(256) if x % 2 == 0]`` generates a list of strings containing even hex numbers (0x..) in the range from 0 to 255. The :keyword:`if` clause is optional. If omitted, all elements in ``range(256)`` are processed." -msgstr "روشی فشرده برای پردازش همه یا بخشی از المان‌های یک دنباله و بازگرداندن یک فهرست با نتایج. ``result = ['{:#04x}'.format(x) for x in range(256) if x % 2 == 0]`` فهرستی از نخ‌ها شامل اعداد مبنای شانزده زوج (0x..) در محدودهٔ ۰ تا ۲۵۵ تولید می‌کند. بند :keyword:`if` اختیاری است. اگر حذف شود، همهٔ المان‌های ``range(256)`` پردازش می‌شوند." +msgstr "" msgid "lock" -msgstr "قفل" +msgstr "" msgid "A :term:`synchronization primitive` that allows only one thread at a time to access a shared resource. A thread must acquire a lock before accessing the protected resource and release it afterward. If a thread attempts to acquire a lock that is already held by another thread, it will block until the lock becomes available. Python's :mod:`threading` module provides :class:`~threading.Lock` (a basic lock) and :class:`~threading.RLock` (a :term:`reentrant` lock). Locks are used to prevent :term:`race conditions ` and ensure :term:`thread-safe` access to shared data. Alternative design patterns to locks exist such as queues, producer/consumer patterns, and thread-local state. See also :term:`deadlock`, and :term:`reentrant`." -msgstr "یک :term:`اولیه ` که در هر زمان فقط به یک نخ اجازهٔ دسترسی به یک منبع اشتراکی را می‌دهد. یک نخ باید پیش از دسترسی به منبع محافظت‌شده، یک قفل را به‌دست آورد و پس از آن آن را آزاد کند. اگر یک نخ تلاش کند قفلی را به‌دست آورد که پیش‌تر توسط نخ‌ای دیگر در اختیار گرفته شده است، تا زمانی که قفل در دسترس قرار گیرد مسدود می‌شود. ماژول :mod:`threading` پایتون، :class:`~threading.Lock` (یک قفل پایه) و :class:`~threading.RLock` (یک قفل :term:`بازورودپذیر `) را فراهم می‌کند. قفل‌ها برای جلوگیری از :term:`شرط رقابت ` و تضمین دسترسی :term:`ایمن برای نخ‌های اجرایی ` به داده‌های اشتراکی استفاده می‌شوند. الگوهای طراحی جایگزین برای قفل‌ها وجود دارند، مانند صف‌ها، الگوهای تولیدکننده/مصرف‌کننده و وضعیت محلی نخ. همچنین :term:`بن‌بست ` و :term:`بازورودپذیر ` را ببینید." +msgstr "" msgid "lock-free" -msgstr "بدون قفل" +msgstr "" msgid "An operation that does not acquire any :term:`lock` and uses atomic CPU instructions to ensure correctness. Lock-free operations can execute concurrently without blocking each other and cannot be blocked by operations that hold locks. In :term:`free-threaded ` Python, built-in types like :class:`dict` and :class:`list` provide lock-free read operations, which means other threads may observe intermediate states during multi-step modifications even when those modifications hold the :term:`per-object lock`." -msgstr "عملیاتی که هیچ :term:`قفل‌ `\\ ای به‌دست نمی‌آورد و برای تضمین درستی از دستورهای اتمی CPU استفاده می‌کند. عملیات‌های بدون قفل می‌توانند به‌طور هم‌زمان و بدون مسدود کردن یکدیگر اجرا شوند و نمی‌توانند توسط عملیات‌هایی که قفل‌ها را در اختیار دارند مسدود شوند. در پایتون :term:`نخ‌گذاری آزاد `، نوع‌های توکار مانند :class:`dict` و :class:`list` عملیات‌های خواندن بدون قفل ارائه می‌کنند، یعنی نخ‌های دیگر ممکن است در طول تغییرات چندمرحله‌ای، حتی زمانی که آن تغییرات :term:`قفلِ هر شیء ` را نگه داشته‌اند، وضعیت‌های میانی را مشاهده کنند." +msgstr "" msgid "loader" -msgstr "بارگذار" +msgstr "" msgid "An object that loads a module. It must define the :meth:`!exec_module` and :meth:`!create_module` methods to implement the :class:`~importlib.abc.Loader` interface. A loader is typically returned by a :term:`finder`. See also:" -msgstr "شیءای که یک ماژول را بارگذاری می‌کند. برای پیاده‌سازی رابط :class:`~importlib.abc.Loader` باید متدهای :meth:`!exec_module` و :meth:`!create_module` را تعریف کند. یک بارگذار معمولاً توسط یک :term:`یابنده ` بازگردانده می‌شود. همچنین ببینید:" +msgstr "" msgid ":ref:`finders-and-loaders`" -msgstr ":ref:`finders-and-loaders`" +msgstr "" msgid ":class:`importlib.abc.Loader`" -msgstr ":class:`importlib.abc.Loader`" +msgstr "" msgid ":pep:`302`" -msgstr ":pep:`302`" +msgstr "" msgid "locale encoding" -msgstr "کدگذاری محلی" +msgstr "" msgid "On Unix, it is the encoding of the LC_CTYPE locale. It can be set with :func:`locale.setlocale(locale.LC_CTYPE, new_locale) `." -msgstr "در یونیکس، این همان کدگذاری محلی LC_CTYPE است. می‌توان آن را با :func:`locale.setlocale(locale.LC_CTYPE, new_locale) ` تنظیم کرد." +msgstr "" msgid "On Windows, it is the ANSI code page (ex: ``\"cp1252\"``)." -msgstr "در ویندوز، این همان صفحهٔ کد ANSI است (برای مثال ``\"cp1252\"``)." +msgstr "" msgid "On Android and VxWorks, Python uses ``\"utf-8\"`` as the locale encoding." -msgstr "در Android و VxWorks، پایتون از ``\"utf-8\"`` به‌عنوان کدگذاری محلی استفاده می‌کند." +msgstr "" msgid ":func:`locale.getencoding` can be used to get the locale encoding." -msgstr "از :func:`locale.getencoding` می‌توان برای دریافت کدگذاری محلی استفاده کرد." +msgstr "" msgid "See also the :term:`filesystem encoding and error handler`." -msgstr "همچنین :term:`کدگذاری سیستم فایل و مدیریت‌کنندهٔ خطا ` را ببینید." +msgstr "" msgid "magic method" -msgstr "متد جادویی" +msgstr "" msgid "An informal synonym for :term:`special method`." -msgstr "یک مترادف غیررسمی برای :term:`متد ویژه `." +msgstr "" msgid "mapping" -msgstr "نگاشت" +msgstr "" msgid "A container object that supports arbitrary key lookups and implements the methods specified in the :class:`collections.abc.Mapping` or :class:`collections.abc.MutableMapping` :ref:`abstract base classes `. Examples include :class:`dict`, :class:`collections.defaultdict`, :class:`collections.OrderedDict` and :class:`collections.Counter`." -msgstr "یک شیء محفظه‌ای که از جست‌وجوی کلیدهای دلخواه پشتیبانی می‌کند و متدهای مشخص‌شده در :class:`collections.abc.Mapping` یا :class:`collections.abc.MutableMapping` :ref:`abstract base classes ` را پیاده‌سازی می‌کند. نمونه‌ها شامل :class:`dict`، :class:`collections.defaultdict`، :class:`collections.OrderedDict` و :class:`collections.Counter` هستند." +msgstr "" msgid "meta path finder" -msgstr "یابندهٔ مسیر فراداده" +msgstr "" msgid "A :term:`finder` returned by a search of :data:`sys.meta_path`. Meta path finders are related to, but different from :term:`path entry finders `." -msgstr "یک :term:`یابنده ` که از جست‌وجوی :data:`sys.meta_path` بازگردانده می‌شود. یابنده‌های مسیر فراداده با :term:`یابندهٔ ورودی مسیر ` مرتبط هستند، اما با آن‌ها تفاوت دارند." +msgstr "" msgid "See :class:`importlib.abc.MetaPathFinder` for the methods that meta path finders implement." -msgstr "برای متدهایی که یابنده‌های مسیر فراداده پیاده‌سازی می‌کنند، :class:`importlib.abc.MetaPathFinder` را ببینید." +msgstr "" msgid "metaclass" -msgstr "فراکلاس" +msgstr "" msgid "The class of a class. Class definitions create a class name, a class dictionary, and a list of base classes. The metaclass is responsible for taking those three arguments and creating the class. Most object oriented programming languages provide a default implementation. What makes Python special is that it is possible to create custom metaclasses. Most users never need this tool, but when the need arises, metaclasses can provide powerful, elegant solutions. They have been used for logging attribute access, adding thread-safety, tracking object creation, implementing singletons, and many other tasks." -msgstr "کلاس یک کلاس. تعریف‌های کلاس یک نام کلاس، یک دیکشنری کلاس و یک فهرست از کلاس‌های پایه ایجاد می‌کنند. فراکلاس مسئول دریافت این سه آرگومان و ایجاد کلاس است. بیشتر زبان‌های برنامه‌نویسی شیءگرا یک پیاده‌سازی پیش‌فرض ارائه می‌کنند. چیزی که پایتون را ویژه می‌کند این است که امکان ایجاد فراکلاس‌های سفارشی وجود دارد. بیشتر کاربران هرگز به این ابزار نیاز پیدا نمی‌کنند، اما هنگامی که نیاز به آن پیش بیاید، فراکلاس‌ها می‌توانند راه‌حل‌های قدرتمند و ظریفی ارائه دهند. از آن‌ها برای ثبت دسترسی به ویژگی‌ها، افزودن ایمنی نخ‌ای، پیگیری ایجاد شیء، پیاده‌سازی تک‌نمونه‌ها و بسیاری کارهای دیگر استفاده شده است." +msgstr "" msgid "More information can be found in :ref:`metaclasses`." -msgstr "اطلاعات بیشتر را می‌توان در :ref:`metaclasses` یافت." +msgstr "" msgid "method" -msgstr "متد" +msgstr "" msgid "A function which is defined inside a class body. If called as an attribute of an instance of that class, the method will get the instance object as its first :term:`argument` (which is usually called ``self``). See :term:`function` and :term:`nested scope`." -msgstr "تابعی که درون بدنهٔ یک کلاس تعریف شده است. اگر به‌عنوان یک ویژگی از یک نمونهٔ آن کلاس فراخوانی شود، متد شیء نمونه را به‌عنوان نخستین :term:`آرگومان ` خود دریافت می‌کند (که معمولاً ``self`` نامیده می‌شود). :term:`تابع ` و :term:`محدودهٔ تو‌در‌تو ` را ببینید." +msgstr "" msgid "method resolution order" -msgstr "ترتیب حل متد" +msgstr "" msgid "Method Resolution Order is the order in which base classes are searched for a member during lookup. See :ref:`python_2.3_mro` for details of the algorithm used by the Python interpreter since the 2.3 release." -msgstr "ترتیب حل متد، ترتیبی است که در آن کلاس‌های پایه هنگام جست‌وجوی یک عضو بررسی می‌شوند. برای جزئیات الگوریتمی که مفسر پایتون از انتشار ۲.۳ به بعد استفاده می‌کند، :ref:`python_2.3_mro` را ببینید." +msgstr "" msgid "module" -msgstr "ماژول" +msgstr "" msgid "An object that serves as an organizational unit of Python code. Modules have a namespace containing arbitrary Python objects. Modules are loaded into Python by the process of :term:`importing`." -msgstr "شیءای که به‌عنوان واحد سازمان‌دهی کد پایتون عمل می‌کند. ماژول‌ها یک نام‌فضا دارند که شامل اشیای دلخواه پایتون است. ماژول‌ها از طریق فرایند :term:`ایمپورت کردن ` در پایتون بارگذاری می‌شوند." +msgstr "" msgid "See also :term:`package`." -msgstr "همچنین :term:`بسته ` را ببینید." +msgstr "" msgid "module spec" -msgstr "مشخصات ماژول" +msgstr "" msgid "A namespace containing the import-related information used to load a module. An instance of :class:`importlib.machinery.ModuleSpec`." -msgstr "نام‌فضایی که شامل اطلاعات مرتبط با ایمپورت است و برای بارگذاری یک ماژول استفاده می‌شود. یک نمونه از :class:`importlib.machinery.ModuleSpec`." +msgstr "" msgid "See also :ref:`module-specs`." -msgstr "همچنین :ref:`module-specs` را ببینید." +msgstr "" msgid "MRO" -msgstr "MRO" +msgstr "" msgid "See :term:`method resolution order`." -msgstr ":term:`ترتیب حل متد ` را ببینید." +msgstr "" msgid "mutable" -msgstr "تغییرپذیر" +msgstr "" msgid "An :term:`object` with state that is allowed to change during the course of the program. In multi-threaded programs, mutable objects that are shared between threads require careful synchronization to avoid :term:`race conditions `. See also :term:`immutable`, :term:`thread-safe`, and :term:`concurrent modification`." -msgstr "یک :term:`شیء ` که وضعیت آن در طول اجرای برنامه اجازهٔ تغییر دارد. در برنامه‌های چندنخی، اشیای تغییرپذیری که بین نخ‌ها اشتراک‌گذاری می‌شوند، برای جلوگیری از :term:`شرط رقابت ` به همگام‌سازی دقیق نیاز دارند. همچنین :term:`تغییرناپذیر `، :term:`ایمن برای نخ‌های اجرایی ` و :term:`تغییر هم‌زمان ` را ببینید." +msgstr "" msgid "named tuple" -msgstr "تاپل نام‌دار" +msgstr "" msgid "The term \"named tuple\" applies to any type or class that inherits from tuple and whose indexable elements are also accessible using named attributes. The type or class may have other features as well." -msgstr "اصطلاح «تاپل نام‌دار» برای هر نوع یا کلاسی به‌کار می‌رود که از tuple ارث‌بری می‌کند و المان‌های قابل دسترسی با اندیس آن، با استفاده از ویژگی‌های نام‌دار نیز قابل دسترسی هستند. این نوع یا کلاس ممکن است ویژگی‌های دیگری نیز داشته باشد." +msgstr "" msgid "Several built-in types are named tuples, including the values returned by :func:`time.localtime` and :func:`os.stat`. Another example is :data:`sys.float_info`::" -msgstr "چندین نوع توکار، تاپل نام‌دار هستند، از جمله مقادیری که توسط :func:`time.localtime` و :func:`os.stat` بازگردانده می‌شوند. نمونهٔ دیگر :data:`sys.float_info` است::" +msgstr "" msgid "" ">>> sys.float_info[1] # indexed access\n" @@ -1003,248 +968,238 @@ msgid "" ">>> isinstance(sys.float_info, tuple) # kind of tuple\n" "True" msgstr "" -">>> sys.float_info[1] # دسترسی با اندیس\n" -"1024\n" -">>> sys.float_info.max_exp # دسترسی به فیلد نام‌گذاری‌شده\n" -"1024\n" -">>> isinstance(sys.float_info, tuple) # نوعی تاپل\n" -"True" msgid "Some named tuples are built-in types (such as the above examples). Alternatively, a named tuple can be created from a regular class definition that inherits from :class:`tuple` and that defines named fields. Such a class can be written by hand, or it can be created by inheriting :class:`typing.NamedTuple`, or with the factory function :func:`collections.namedtuple`. The latter techniques also add some extra methods that may not be found in hand-written or built-in named tuples." -msgstr "برخی تاپل‌های نام‌دار، نوع‌های توکار هستند (مانند نمونه‌های بالا). روش دیگر، ایجاد یک تاپل نام‌دار از طریق یک تعریف کلاس معمولی است که از :class:`tuple` ارث‌بری می‌کند و فیلدهای نام‌دار را تعریف می‌کند. چنین کلاسی را می‌توان به‌صورت دستی نوشت، یا با ارث‌بری از :class:`typing.NamedTuple`، یا با تابع کارخانهٔ :func:`collections.namedtuple` ایجاد کرد. دو روش اخیر همچنین چند متد اضافی اضافه می‌کنند که ممکن است در تاپل‌های نام‌دار دست‌نویس یا توکار وجود نداشته باشند." +msgstr "" msgid "namespace" -msgstr "نام‌فضا" +msgstr "" msgid "The place where a variable is stored. Namespaces are implemented as dictionaries. There are the local, global and built-in namespaces as well as nested namespaces in objects (in methods). Namespaces support modularity by preventing naming conflicts. For instance, the functions :func:`builtins.open <.open>` and :func:`os.open` are distinguished by their namespaces. Namespaces also aid readability and maintainability by making it clear which module implements a function. For instance, writing :func:`random.seed` or :func:`itertools.islice` makes it clear that those functions are implemented by the :mod:`random` and :mod:`itertools` modules, respectively." -msgstr "محلی که یک متغیر در آن ذخیره می‌شود. نام‌فضاها به‌صورت دیکشنری پیاده‌سازی می‌شوند. نام‌فضاهای محلی، سراسری و توکار، همچنین نام‌فضاهای تو‌در‌تو در اشیا (در متدها) وجود دارند. نام‌فضاها با جلوگیری از تداخل نام‌ها، پیمانه‌ای بودن را پشتیبانی می‌کنند. برای نمونه، تابع‌های :func:`builtins.open <.open>` و :func:`os.open` با استفاده از نام‌فضاهای خود از یکدیگر متمایز می‌شوند. نام‌فضاها همچنین با مشخص کردن اینکه کدام ماژول یک تابع را پیاده‌سازی می‌کند، به خوانایی و نگه‌داری‌پذیری کمک می‌کنند. برای نمونه، نوشتن :func:`random.seed` یا :func:`itertools.islice` مشخص می‌کند که این تابع‌ها به‌ترتیب توسط ماژول‌های :mod:`random` و :mod:`itertools` پیاده‌سازی شده‌اند." +msgstr "" msgid "namespace package" -msgstr "بستهٔ نام‌فضا" +msgstr "" msgid "A :term:`package` which serves only as a container for subpackages. Namespace packages may have no physical representation, and specifically are not like a :term:`regular package` because they have no ``__init__.py`` file." -msgstr "یک :term:`بسته ` که فقط به‌عنوان محفظه‌ای برای زیربسته‌ها عمل می‌کند. بسته‌های نام‌فضا ممکن است نمایش فیزیکی نداشته باشند و به‌طور مشخص مانند یک :term:`بستهٔ معمولی ` نیستند، زیرا فایل ``__init__.py`` ندارند." +msgstr "" msgid "Namespace packages allow several individually installable packages to have a common parent package. Otherwise, it is recommended to use a :term:`regular package`." -msgstr "بسته‌های نام‌فضا به چندین بستهٔ قابل نصب مستقل اجازه می‌دهند که یک بستهٔ والد مشترک داشته باشند. در غیر این صورت، توصیه می‌شود از یک :term:`بستهٔ معمولی ` استفاده کنید." +msgstr "" msgid "For more information, see :pep:`420` and :ref:`reference-namespace-package`." -msgstr "برای اطلاعات بیشتر، :pep:`420` و :ref:`reference-namespace-package` را ببینید." +msgstr "" msgid "See also :term:`module`." -msgstr "همچنین :term:`ماژول ` را ببینید." +msgstr "" msgid "native code" -msgstr "کد بومی" +msgstr "" msgid "Code that is compiled to machine instructions and runs directly on the processor, as opposed to code that is interpreted or runs in a virtual machine. In the context of Python, native code typically refers to C, C++, Rust or Fortran code in :term:`extension modules ` that can be called from Python. See also :term:`extension module`." -msgstr "کدی که به دستورهای ماشین کامپایل شده و مستقیماً روی پردازنده اجرا می‌شود، برخلاف کدی که تفسیر می‌شود یا در یک ماشین مجازی اجرا می‌شود. در زمینهٔ پایتون، کد بومی معمولاً به کد C، C++، Rust یا Fortran در :term:`ماژول افزونه ` اشاره دارد که می‌توانند از پایتون فراخوانی شوند. همچنین :term:`ماژول افزونه ` را ببینید." +msgstr "" msgid "nested scope" -msgstr "محدودهٔ تو‌در‌تو" +msgstr "" msgid "The ability to refer to a variable in an enclosing definition. For instance, a function defined inside another function can refer to variables in the outer function. Note that nested scopes by default work only for reference and not for assignment. Local variables both read and write in the innermost scope. Likewise, global variables read and write to the global namespace. The :keyword:`nonlocal` allows writing to outer scopes." -msgstr "توانایی ارجاع به یک متغیر در یک تعریف دربرگیرنده. برای مثال، تابعی که داخل تابع دیگری تعریف شده است می‌تواند به متغیرهای تابع بیرونی دسترسی داشته باشد. توجه کنید که محدوده‌های تو‌در‌تو به‌صورت پیش‌فرض فقط برای ارجاع دادن و نه برای انتساب کار می‌کنند. متغیرهای محلی هم در نزدیک‌ترین محدوده خوانده و نوشته می‌شوند. به همین ترتیب، متغیرهای سراسری از نام‌فضای سراسری خوانده و در آن نوشته می‌شوند. کلیدواژهٔ :keyword:`nonlocal` امکان نوشتن در محدوده‌های بیرونی را فراهم می‌کند." +msgstr "" msgid "new-style class" -msgstr "کلاس سبک جدید" +msgstr "" msgid "Old name for the flavor of classes now used for all class objects. In earlier Python versions, only new-style classes could use Python's newer, versatile features like :attr:`~object.__slots__`, descriptors, properties, :meth:`~object.__getattribute__`, class methods, and static methods." -msgstr "نام قدیمی برای گونه‌ای از کلاس‌ها که اکنون برای همهٔ اشیای کلاس استفاده می‌شود. در نسخه‌های قدیمی‌تر پایتون، فقط کلاس‌های سبک جدید می‌توانستند از قابلیت‌های جدیدتر و انعطاف‌پذیر پایتون مانند :attr:`~object.__slots__`، توصیف‌گرها، ویژگی‌ها، :meth:`~object.__getattribute__`، متدهای کلاس و متدهای ایستا استفاده کنند." +msgstr "" msgid "non-deterministic" -msgstr "غیرقطعی" +msgstr "" msgid "Behavior where the outcome of a program can vary between executions with the same inputs. In multi-threaded programs, non-deterministic behavior often results from :term:`race conditions ` where the relative timing or interleaving of threads affects the result. Proper synchronization using :term:`locks ` and other :term:`synchronization primitives ` helps ensure deterministic behavior." -msgstr "رفتاری که در آن نتیجهٔ یک برنامه می‌تواند بین اجراهای مختلف با ورودی‌های یکسان متفاوت باشد. در برنامه‌های چندنخی، رفتار غیرقطعی اغلب از :term:`شرط رقابت ` ناشی می‌شود که در آن زمان‌بندی نسبی یا درهم‌تنیدگی نخ‌ها بر نتیجه تأثیر می‌گذارد. همگام‌سازی مناسب با استفاده از :term:`قفل ` و دیگر :term:`اولیه ` به تضمین رفتار قطعی کمک می‌کند." +msgstr "" msgid "object" -msgstr "شیء" +msgstr "" msgid "Any data with state (attributes or value) and defined behavior (methods). Also the ultimate base class of any :term:`new-style class`." -msgstr "هر داده‌ای با وضعیت (ویژگی‌ها یا مقدار) و رفتار تعریف‌شده (متدها). همچنین کلاس پایهٔ نهایی هر :term:`کلاس سبک جدید `." +msgstr "" msgid "optimized scope" -msgstr "محدودهٔ بهینه‌شده" +msgstr "" msgid "A scope where target local variable names are reliably known to the compiler when the code is compiled, allowing optimization of read and write access to these names. The local namespaces for functions, generators, coroutines, comprehensions, and generator expressions are optimized in this fashion. Note: most interpreter optimizations are applied to all scopes, only those relying on a known set of local and nonlocal variable names are restricted to optimized scopes." -msgstr "محدوده‌ای که در آن نام‌های متغیرهای محلی هدف هنگام کامپایل کد به‌طور قابل اطمینانی برای کامپایلر شناخته شده‌اند و امکان بهینه‌سازی دسترسی خواندن و نوشتن به این نام‌ها فراهم می‌شود. نام‌فضاهای محلی برای تابع‌ها، تولیدگرها، هم‌روال‌ها، درک‌ها و عبارت‌های تولیدگر به این روش بهینه می‌شوند. توجه کنید: بیشتر بهینه‌سازی‌های مفسر روی همهٔ محدوده‌ها اعمال می‌شوند؛ تنها بهینه‌سازی‌هایی که به مجموعهٔ شناخته‌شده‌ای از نام‌های متغیرهای محلی و غیرمحلی وابسته هستند، به محدوده‌های بهینه‌شده محدود می‌شوند." +msgstr "" msgid "optional module" -msgstr "ماژول اختیاری" +msgstr "" msgid "An :term:`extension module` that is part of the :term:`standard library`, but may be absent in some builds of :term:`CPython`, usually due to missing third-party libraries or because the module is not available for a given platform." -msgstr "یک :term:`ماژول افزونه ` که بخشی از :term:`کتابخانهٔ استاندارد ` است، اما ممکن است در برخی ساخت‌های :term:`CPython ` وجود نداشته باشد؛ معمولاً به دلیل نبود کتابخانه‌های شخص ثالث یا در دسترس نبودن ماژول برای یک سکوی مشخص." +msgstr "" msgid "See :ref:`optional-module-requirements` for a list of optional modules that require third-party libraries." -msgstr "برای فهرستی از ماژول‌های اختیاری که به کتابخانه‌های شخص ثالث نیاز دارند، :ref:`optional-module-requirements` را ببینید." +msgstr "" msgid "package" -msgstr "بسته" +msgstr "" msgid "A Python :term:`module` which can contain submodules or recursively, subpackages. Technically, a package is a Python module with a ``__path__`` attribute." -msgstr "یک :term:`ماژول ` پایتون که می‌تواند شامل زیرماژول‌ها یا به‌صورت بازگشتی، زیربسته‌ها باشد. از نظر فنی، یک بسته یک ماژول پایتون با ویژگی ``__path__`` است." +msgstr "" msgid "See also :term:`regular package` and :term:`namespace package`." -msgstr "همچنین :term:`بستهٔ معمولی ` و :term:`بستهٔ نام‌فضا ` را ببینید." +msgstr "" msgid "parallelism" -msgstr "موازی‌سازی" +msgstr "" msgid "Executing multiple operations at the same time (e.g. on multiple CPU cores). In Python builds with the :term:`global interpreter lock (GIL) `, only one thread runs Python bytecode at a time, so taking advantage of multiple CPU cores typically involves multiple processes (e.g. :mod:`multiprocessing`) or native extensions that release the GIL. In :term:`free-threaded ` Python, multiple Python threads can run Python code simultaneously on different cores." -msgstr "اجرای چندین عملیات در یک زمان (برای مثال روی چند هستهٔ CPU). در ساخت‌های پایتون با :term:`قفل مفسر سراسری `، تنها یک نخ در هر لحظه بایت‌کد پایتون را اجرا می‌کند، بنابراین بهره‌گیری از چند هستهٔ CPU معمولاً شامل چند فرایند (برای مثال :mod:`multiprocessing`) یا افزونه‌های بومی است که GIL را آزاد می‌کنند. در پایتون :term:`نخ‌گذاری آزاد `، چندین نخ پایتون می‌توانند به‌طور هم‌زمان کد پایتون را روی هسته‌های مختلف اجرا کنند." +msgstr "" msgid "parameter" -msgstr "پارامتر" +msgstr "" msgid "A named entity in a :term:`function` (or method) definition that specifies an :term:`argument` (or in some cases, arguments) that the function can accept. There are five kinds of parameter:" -msgstr "یک موجودیت نام‌گذاری‌شده در تعریف یک :term:`تابع ` (یا متد) که یک :term:`آرگومان ` (یا در برخی موارد، آرگومان‌ها) را مشخص می‌کند که تابع می‌تواند بپذیرد. پنج نوع پارامتر وجود دارد:" +msgstr "" msgid ":dfn:`positional-or-keyword`: specifies an argument that can be passed either :term:`positionally ` or as a :term:`keyword argument `. This is the default kind of parameter, for example *foo* and *bar* in the following::" -msgstr ":dfn:`positional-or-keyword`: آرگومانی را مشخص می‌کند که می‌تواند به‌صورت :term:`آرگومان جایگاهی ` یا به‌عنوان یک :term:`آرگومان کلیدواژه‌ای ` ارسال شود. این نوع پیش‌فرض پارامتر است، برای مثال *foo* و *bar* در موارد زیر::" +msgstr "" msgid "def func(foo, bar=None): ..." -msgstr "def func(foo, bar=None): ..." +msgstr "" msgid ":dfn:`positional-only`: specifies an argument that can be supplied only by position. Positional-only parameters can be defined by including a ``/`` character in the parameter list of the function definition after them, for example *posonly1* and *posonly2* in the following::" -msgstr ":dfn:`positional-only`: آرگومانی را مشخص می‌کند که فقط می‌تواند بر اساس جایگاه ارائه شود. پارامترهای فقط-جایگاهی را می‌توان با قرار دادن یک نویسهٔ ``/`` در فهرست پارامترهای تعریف تابع پس از آن‌ها تعریف کرد، برای مثال *posonly1* و *posonly2* در موارد زیر::" +msgstr "" msgid "def func(posonly1, posonly2, /, positional_or_keyword): ..." -msgstr "def func(posonly1, posonly2, /, positional_or_keyword): ..." +msgstr "" msgid ":dfn:`keyword-only`: specifies an argument that can be supplied only by keyword. Keyword-only parameters can be defined by including a single var-positional parameter or bare ``*`` in the parameter list of the function definition before them, for example *kw_only1* and *kw_only2* in the following::" -msgstr ":dfn:`keyword-only`: آرگومانی را مشخص می‌کند که فقط می‌تواند با کلیدواژه ارسال شود. پارامترهای فقط کلیدواژه‌ای را می‌توان با قرار دادن یک پارامتر var-positional یا ``*`` بدون نام در فهرست پارامترهای تعریف تابع پیش از آن‌ها تعریف کرد، برای مثال *kw_only1* و *kw_only2* در موارد زیر::" +msgstr "" msgid "def func(arg, *, kw_only1, kw_only2): ..." -msgstr "def func(arg, *, kw_only1, kw_only2): ..." +msgstr "" msgid ":dfn:`var-positional`: specifies that an arbitrary sequence of positional arguments can be provided (in addition to any positional arguments already accepted by other parameters). Such a parameter can be defined by prepending the parameter name with ``*``, for example *args* in the following::" -msgstr ":dfn:`var-positional`: مشخص می‌کند که یک دنبالهٔ دلخواه از آرگومان‌های جایگاهی می‌تواند ارائه شود (علاوه بر هر آرگومان جایگاهی که پیش‌تر توسط پارامترهای دیگر پذیرفته شده است). چنین پارامتری را می‌توان با افزودن ``*`` به ابتدای نام پارامتر تعریف کرد، برای مثال *args* در موارد زیر::" +msgstr "" msgid "def func(*args, **kwargs): ..." -msgstr "def func(*args, **kwargs): ..." +msgstr "" msgid ":dfn:`var-keyword`: specifies that arbitrarily many keyword arguments can be provided (in addition to any keyword arguments already accepted by other parameters). Such a parameter can be defined by prepending the parameter name with ``**``, for example *kwargs* in the example above." -msgstr ":dfn:`var-keyword`: مشخص می‌کند که تعداد دلخواهی از آرگومان‌های کلیدواژه‌ای می‌تواند ارائه شود (علاوه بر هر آرگومان کلیدواژه‌ای که پیش‌تر توسط پارامترهای دیگر پذیرفته شده است). چنین پارامتری را می‌توان با افزودن ``**`` به ابتدای نام پارامتر تعریف کرد، برای مثال *kwargs* در مثال بالا." +msgstr "" msgid "Parameters can specify both optional and required arguments, as well as default values for some optional arguments." -msgstr "پارامترها می‌توانند هم آرگومان‌های اختیاری و ضروری، و هم مقدارهای پیش‌فرض برای برخی آرگومان‌های اختیاری را مشخص کنند." +msgstr "" msgid "See also the :term:`argument` glossary entry, the FAQ question on :ref:`the difference between arguments and parameters `, the :class:`inspect.Parameter` class, the :ref:`function` section, and :pep:`362`." -msgstr "همچنین مدخل واژه‌نامهٔ :term:`آرگومان `، پرسش متداول دربارهٔ :ref:`تفاوت بین آرگومان‌ها و پارامترها `، کلاس :class:`inspect.Parameter`، بخش :ref:`function` و :pep:`362` را ببینید." +msgstr "" msgid "per-object lock" -msgstr "قفلِ هر شیء" +msgstr "" msgid "A :term:`lock` associated with an individual object instance rather than a global lock shared across all objects. In :term:`free-threaded ` Python, built-in types like :class:`dict` and :class:`list` use per-object locks to allow concurrent operations on different objects while serializing operations on the same object. Operations that hold the per-object lock prevent other locking operations on the same object from proceeding, but do not block :term:`lock-free` operations." -msgstr "یک :term:`قفل ` مرتبط با یک نمونهٔ شیء منفرد، به‌جای یک قفل سراسری که بین همهٔ اشیا اشتراک‌گذاری شده باشد. در پایتون :term:`نخ‌گذاری آزاد `، نوع‌های توکار مانند :class:`dict` و :class:`list` از قفل‌های هر شیء استفاده می‌کنند تا امکان عملیات هم‌زمان روی اشیای مختلف را فراهم کنند، در حالی که عملیات روی همان شیء را به‌صورت ترتیبی اجرا می‌کنند. عملیات‌هایی که قفل هر شیء را نگه می‌دارند، از ادامهٔ دیگر عملیات‌های قفل‌کننده روی همان شیء جلوگیری می‌کنند، اما عملیات‌های :term:`بدون قفل ` را مسدود نمی‌کنند." +msgstr "" msgid "path entry" -msgstr "ورودی مسیر" +msgstr "" msgid "A single location on the :term:`import path` which the :term:`path based finder` consults to find modules for importing." -msgstr "یک مکان منفرد در :term:`ایمپورت مسیر ` که :term:`یابندهٔ مبتنی بر مسیر ` برای یافتن ماژول‌ها جهت ایمپورت بررسی می‌کند." +msgstr "" msgid "path entry finder" -msgstr "یابندهٔ ورودی مسیر" +msgstr "" msgid "A :term:`finder` returned by a callable on :data:`sys.path_hooks` (i.e. a :term:`path entry hook`) which knows how to locate modules given a :term:`path entry`." -msgstr "یک :term:`یابنده ` که توسط یک فراخوانی‌پذیر در :data:`sys.path_hooks` (یعنی یک :term:`قلاب ورودی مسیر `) بازگردانده می‌شود و می‌داند چگونه با داشتن یک :term:`ورودی مسیر `، ماژول‌ها را پیدا کند." +msgstr "" msgid "See :class:`importlib.abc.PathEntryFinder` for the methods that path entry finders implement." -msgstr "برای متدهایی که یابنده‌های ورودی مسیر پیاده‌سازی می‌کنند، :class:`importlib.abc.PathEntryFinder` را ببینید." +msgstr "" msgid "path entry hook" -msgstr "قلاب ورودی مسیر" +msgstr "" msgid "A callable on the :data:`sys.path_hooks` list which returns a :term:`path entry finder` if it knows how to find modules on a specific :term:`path entry`." -msgstr "یک فراخوانی‌پذیر در فهرست :data:`sys.path_hooks` که اگر بداند چگونه ماژول‌ها را در یک :term:`ورودی مسیر ` مشخص پیدا کند، یک :term:`یابندهٔ ورودی مسیر ` بازمی‌گرداند." +msgstr "" msgid "path based finder" -msgstr "یابندهٔ مبتنی بر مسیر" +msgstr "" msgid "One of the default :term:`meta path finders ` which searches an :term:`import path` for modules." -msgstr "یکی از :term:`یابندهٔ مسیر فراداده ` پیش‌فرض که یک :term:`ایمپورت مسیر ` را برای یافتن ماژول‌ها جست‌وجو می‌کند." +msgstr "" msgid "path-like object" -msgstr "شیء شبه‌مسیر" +msgstr "" msgid "An object representing a file system path. A path-like object is either a :class:`str` or :class:`bytes` object representing a path, or an object implementing the :class:`os.PathLike` protocol. An object that supports the :class:`os.PathLike` protocol can be converted to a :class:`str` or :class:`bytes` file system path by calling the :func:`os.fspath` function; :func:`os.fsdecode` and :func:`os.fsencode` can be used to guarantee a :class:`str` or :class:`bytes` result instead, respectively. Introduced by :pep:`519`." -msgstr "شی‌ءای که یک مسیر سامانهٔ فایل را نمایش می‌دهد. یک شیء شبه‌مسیر یا یک شیء :class:`str` یا :class:`bytes` است که یک مسیر را نمایش می‌دهد، یا شی‌ءای است که پروتکل :class:`os.PathLike` را پیاده‌سازی می‌کند. شی‌ءای که از پروتکل :class:`os.PathLike` پشتیبانی می‌کند، می‌تواند با فراخوانی تابع :func:`os.fspath` به یک مسیر سامانهٔ فایل :class:`str` یا :class:`bytes` تبدیل شود؛ :func:`os.fsdecode` و :func:`os.fsencode` می‌توانند به‌ترتیب برای تضمین نتیجهٔ :class:`str` یا :class:`bytes` استفاده شوند. معرفی‌شده در :pep:`519`." +msgstr "" msgid "PEP" -msgstr "PEP" +msgstr "" msgid "Python Enhancement Proposal. A PEP is a design document providing information to the Python community, or describing a new feature for Python or its processes or environment. PEPs should provide a concise technical specification and a rationale for proposed features." -msgstr "پیشنهاد بهبود پایتون. یک PEP یک سند طراحی است که اطلاعاتی را برای کامیونیتی پایتون ارائه می‌کند، یا یک ویژگی جدید برای پایتون، فرایندهای آن یا محیط آن را توصیف می‌کند. PEPها باید یک مشخصات فنی مختصر و یک منطق برای ویژگی‌های پیشنهادی ارائه کنند." +msgstr "" msgid "PEPs are intended to be the primary mechanisms for proposing major new features, for collecting community input on an issue, and for documenting the design decisions that have gone into Python. The PEP author is responsible for building consensus within the community and documenting dissenting opinions." -msgstr "PEP ها برای این طراحی شده‌اند که سازوکارهای اصلی پیشنهاد ویژگی‌های بزرگ جدید، جمع‌آوری نظرهای کامیونیتی دربارهٔ یک موضوع و مستندسازی تصمیم‌های طراحی گرفته‌شده برای پایتون باشند. نویسندهٔ PEP مسئول ایجاد توافق در کامیونیتی و مستندسازی دیدگاه‌های مخالف است." +msgstr "" msgid "See :pep:`1`." -msgstr ":pep:`1` را ببینید." +msgstr "" msgid "portion" -msgstr "بخش" +msgstr "" msgid "A set of files in a single directory (possibly stored in a zip file) that contribute to a namespace package, as defined in :pep:`420`." -msgstr "مجموعه‌ای از فایل‌ها در یک پوشهٔ واحد (که ممکن است در یک فایل zip ذخیره شده باشند) که در یک بستهٔ نام‌فضا، همان‌طور که در :pep:`420` تعریف شده است، مشارکت می‌کنند." +msgstr "" msgid "positional argument" -msgstr "آرگومان جایگاهی" +msgstr "" msgid "provisional API" -msgstr "API موقت" +msgstr "" msgid "A provisional API is one which has been deliberately excluded from the standard library's backwards compatibility guarantees. While major changes to such interfaces are not expected, as long as they are marked provisional, backwards incompatible changes (up to and including removal of the interface) may occur if deemed necessary by core developers. Such changes will not be made gratuitously -- they will occur only if serious fundamental flaws are uncovered that were missed prior to the inclusion of the API." -msgstr "یک API موقت، رابطی است که به‌طور عمدی از تضمین‌های سازگاری رو‌به‌عقب کتابخانهٔ استاندارد خارج شده است. با اینکه تغییرات بزرگ در چنین رابط‌هایی انتظار نمی‌رود، تا زمانی که موقت علامت‌گذاری شده باشند، اگر توسعه‌دهندگان اصلی آن را ضروری بدانند، تغییرات ناسازگار با نسخه‌های پیشین (تا حذف کامل رابط نیز) ممکن است رخ دهد. چنین تغییراتی بدون دلیل انجام نخواهند شد؛ آن‌ها تنها در صورتی رخ می‌دهند که نقص‌های بنیادی و جدی‌ای کشف شوند که پیش از اضافه شدن API از آن‌ها چشم‌پوشی شده بود." +msgstr "" msgid "Even for provisional APIs, backwards incompatible changes are seen as a \"solution of last resort\" - every attempt will still be made to find a backwards compatible resolution to any identified problems." -msgstr "حتی برای APIهای موقت، تغییرات ناسازگار با نسخه‌های پیشین به‌عنوان «راه‌حل آخر» در نظر گرفته می‌شوند؛ همچنان هر تلاشی برای یافتن راه‌حلی سازگار با نسخه‌های پیشین برای مشکلات شناسایی‌شده انجام خواهد شد." +msgstr "" msgid "This process allows the standard library to continue to evolve over time, without locking in problematic design errors for extended periods of time. See :pep:`411` for more details." -msgstr "این فرایند به کتابخانهٔ استاندارد اجازه می‌دهد در طول زمان به تکامل خود ادامه دهد، بدون اینکه خطاهای طراحی مشکل‌ساز را برای دوره‌های طولانی تثبیت کند. برای جزئیات بیشتر، :pep:`411` را ببینید." +msgstr "" msgid "provisional package" -msgstr "بستهٔ موقت" +msgstr "" msgid "See :term:`provisional API`." -msgstr ":term:`API موقت ` را ببینید." +msgstr "" msgid "Python 3000" -msgstr "پایتون ۳۰۰۰" +msgstr "" msgid "Nickname for the Python 3.x release line (coined long ago when the release of version 3 was something in the distant future.) This is also abbreviated \"Py3k\"." -msgstr "نام مستعار برای خط انتشار Python ۳.x (که مدت‌ها پیش، زمانی که انتشار نسخهٔ ۳ چیزی در آیندهٔ دور بود، ساخته شد.) این عبارت همچنین به‌صورت «Py3k» کوتاه می‌شود." +msgstr "" msgid "Pythonic" -msgstr "پایتونی" +msgstr "" msgid "An idea or piece of code which closely follows the most common idioms of the Python language, rather than implementing code using concepts common to other languages. For example, a common idiom in Python is to loop over all elements of an iterable using a :keyword:`for` statement. Many other languages don't have this type of construct, so people unfamiliar with Python sometimes use a numerical counter instead::" -msgstr "ایده یا بخشی از کد که به‌جای پیاده‌سازی با مفاهیم رایج در زبان‌های دیگر، به‌طور نزدیک از شیوه‌های رایج زبان پایتون پیروی می‌کند. برای مثال، یک شیوهٔ رایج در پایتون این است که با استفاده از دستور :keyword:`for` روی همهٔ المان‌های یک تکرارپذیر حلقه زده شود. بسیاری از زبان‌های دیگر چنین ساختاری ندارند، بنابراین افرادی که با پایتون آشنا نیستند گاهی به‌جای آن از یک شمارندهٔ عددی استفاده می‌کنند::" +msgstr "" msgid "" "for i in range(len(food)):\n" " print(food[i])" msgstr "" -"for i in range(len(food)):\n" -" print(food[i])" msgid "As opposed to the cleaner, Pythonic method::" -msgstr "در مقابل، روش تمیزتر و پایتونی::" +msgstr "" msgid "" "for piece in food:\n" " print(piece)" msgstr "" -"for piece in food:\n" -" print(piece)" msgid "qualified name" -msgstr "نام واجد شرایط" +msgstr "" msgid "A dotted name showing the \"path\" from a module's global scope to a class, function or method defined in that module, as defined in :pep:`3155`. For top-level functions and classes, the qualified name is the same as the object's name::" -msgstr "نامی نقطه‌گذاری‌شده که «مسیر» از محدودهٔ سراسری یک ماژول تا یک کلاس، تابع یا متد تعریف‌شده در آن ماژول را نشان می‌دهد، همان‌طور که در :pep:`3155` تعریف شده است. برای تابع‌ها و کلاس‌های سطح بالا، نام واجد شرایط همان نام شیء است::" +msgstr "" msgid "" ">>> class C:\n" @@ -1259,281 +1214,255 @@ msgid "" ">>> C.D.meth.__qualname__\n" "'C.D.meth'" msgstr "" -">>> class C:\n" -"... class D:\n" -"... def meth(self):\n" -"... pass\n" -"...\n" -">>> C.__qualname__\n" -"'C'\n" -">>> C.D.__qualname__\n" -"'C.D'\n" -">>> C.D.meth.__qualname__\n" -"'C.D.meth'" msgid "When used to refer to modules, the *fully qualified name* means the entire dotted path to the module, including any parent packages, e.g. ``email.mime.text``::" -msgstr "هنگامی که برای اشاره به ماژول‌ها استفاده می‌شود، *نام کاملاً واجد شرایط* به معنای کل مسیر نقطه‌گذاری‌شده به ماژول است که شامل هر بستهٔ والد نیز می‌شود، برای مثال ``email.mime.text``::" +msgstr "" msgid "" ">>> import email.mime.text\n" ">>> email.mime.text.__name__\n" "'email.mime.text'" msgstr "" -">>> import email.mime.text\n" -">>> email.mime.text.__name__\n" -"'email.mime.text'" msgid "race condition" -msgstr "شرط رقابت" +msgstr "" msgid "A condition of a program where the behavior depends on the relative timing or ordering of events, particularly in multi-threaded programs. Race conditions can lead to :term:`non-deterministic` behavior and bugs that are difficult to reproduce. A :term:`data race` is a specific type of race condition involving unsynchronized access to shared memory. The :term:`LBYL` coding style is particularly susceptible to race conditions in multi-threaded code. Using :term:`locks ` and other :term:`synchronization primitives ` helps prevent race conditions." -msgstr "شرایطی در یک برنامه که در آن رفتار به زمان‌بندی نسبی یا ترتیب رویدادها وابسته است، به‌ویژه در برنامه‌های چندنخی. شرایط رقابت می‌توانند به رفتار :term:`غیرقطعی ` و خطاهایی منجر شوند که بازتولید آن‌ها دشوار است. یک :term:`رقابت داده ` نوع خاصی از شرط رقابت است که شامل دسترسی بدون همگام‌سازی به حافظهٔ اشتراکی می‌شود. سبک کدنویسی :term:`LBYL ` در کد چندنخی به‌طور ویژه در برابر شرایط رقابت آسیب‌پذیر است. استفاده از :term:`قفل ` و دیگر :term:`اولیه ` به جلوگیری از شرایط رقابت کمک می‌کند." +msgstr "" msgid "reference count" -msgstr "شمارندهٔ ارجاع" +msgstr "" msgid "The number of references to an object. When the reference count of an object drops to zero, it is deallocated. Some objects are :term:`immortal` and have reference counts that are never modified, and therefore the objects are never deallocated. Reference counting is generally not visible to Python code, but it is a key element of the :term:`CPython` implementation. Programmers can call the :func:`sys.getrefcount` function to return the reference count for a particular object." -msgstr "تعداد ارجاع‌ها به یک شیء. هنگامی که تعداد ارجاع‌های یک شیء به صفر کاهش یابد، آن شیء از حافظه آزاد می‌شود. برخی اشیاء :term:`نامیرا ` هستند و تعداد ارجاع‌های آن‌ها هرگز تغییر نمی‌کند و بنابراین این اشیاء هرگز از حافظه آزاد نمی‌شوند. شمارش ارجاع‌ها عموماً برای کد پایتون قابل مشاهده نیست، اما یکی از عناصر کلیدی پیاده‌سازی :term:`CPython ` است. برنامه‌نویسان می‌توانند تابع :func:`sys.getrefcount` را فراخوانی کنند تا تعداد ارجاع‌های یک شیء خاص را برگرداند." +msgstr "" msgid "In :term:`CPython`, reference counts are not considered to be stable or well-defined values; the number of references to an object, and how that number is affected by Python code, may be different between versions." -msgstr "در :term:`CPython `، تعداد ارجاع‌ها مقادیر پایدار یا به‌خوبی تعریف‌شده‌ای در نظر گرفته نمی‌شوند؛ تعداد ارجاع‌ها به یک شیء و نحوه تأثیرپذیری این تعداد از کد پایتون ممکن است بین نسخه‌ها متفاوت باشد." +msgstr "" msgid "regular package" -msgstr "بستهٔ معمولی" +msgstr "" msgid "A traditional :term:`package`, such as a directory containing an ``__init__.py`` file." -msgstr "یک :term:`بسته ` سنتی، مانند پوشه‌ای که شامل یک فایل ``__init__.py`` است." +msgstr "" msgid "See also :term:`namespace package`." -msgstr "همچنین :term:`بستهٔ نام‌فضا ` را ببینید." +msgstr "" msgid "reentrant" -msgstr "بازورودپذیر" +msgstr "" msgid "A property of a function or :term:`lock` that allows it to be called or acquired multiple times by the same thread without causing errors or a :term:`deadlock`." -msgstr "ویژگی یک تابع یا :term:`قفل ` که به آن اجازه می‌دهد بدون ایجاد خطا یا یک :term:`بن‌بست `، چندین بار توسط یک نخ اجرایی یکسان فراخوانی یا دریافت شود." +msgstr "" msgid "For functions, reentrancy means the function can be safely called again before a previous invocation has completed, which is important when functions may be called recursively or from signal handlers. Thread-unsafe functions may be :term:`non-deterministic` if they're called reentrantly in a multithreaded program." -msgstr "در مورد توابع، بازورودپذیری به این معناست که می‌توان تابع را پیش از کامل‌شدن یک فراخوانی قبلی، دوباره با ایمنی فراخوانی کرد؛ این موضوع زمانی اهمیت دارد که توابع ممکن است به‌صورت بازگشتی یا از درون دستگردان‌های سیگنال فراخوانی شوند. توابع ناایمن برای نخ‌های اجرایی ممکن است در صورتی که در یک برنامهٔ چندنخی به‌صورت بازورودپذیر فراخوانی شوند، :term:`غیرقطعی ` باشند." +msgstr "" msgid "For locks, Python's :class:`threading.RLock` (reentrant lock) is reentrant, meaning a thread that already holds the lock can acquire it again without blocking. In contrast, :class:`threading.Lock` is not reentrant - attempting to acquire it twice from the same thread will cause a deadlock." -msgstr "در مورد قفل‌ها، :class:`threading.RLock` پایتون (قفل بازورودپذیر) بازورودپذیر است؛ یعنی نخ اجرایی‌ای که از پیش قفل را در اختیار دارد، می‌تواند دوباره آن را دریافت کند، بدون آنکه مسدود شود. در مقابل، :class:`threading.Lock` بازورودپذیر نیست؛ تلاش برای دریافت آن دو بار از همان نخ اجرایی باعث یک بن‌بست می‌شود." +msgstr "" msgid "See also :term:`lock` and :term:`deadlock`." -msgstr "همچنین :term:`قفل ` و :term:`بن‌بست ` را ببینید." +msgstr "" msgid "REPL" -msgstr "REPL" +msgstr "" msgid "An acronym for the \"read–eval–print loop\", another name for the :term:`interactive` interpreter shell." -msgstr "سرواژهٔ «read–eval–print loop» و نام دیگری برای پوستهٔ مفسر :term:`تعاملی ` است." +msgstr "" msgid "__slots__" -msgstr "__slots__" +msgstr "" msgid "A declaration inside a class that saves memory by pre-declaring space for instance attributes and eliminating instance dictionaries. Though popular, the technique is somewhat tricky to get right and is best reserved for rare cases where there are large numbers of instances in a memory-critical application." -msgstr "یک اعلان درون یک کلاس که با پیش‌اعلام فضای موردنیاز برای ویژگی‌های نمونه و حذف دیکشنری‌های نمونه، در حافظه صرفه‌جویی می‌کند. با وجود محبوبیت این روش، پیاده‌سازی درست آن تا حدی دشوار است و بهتر است آن را به موارد نادری محدود کنید که تعداد نمونه‌ها زیاد است و برنامه از نظر حافظه حساس است." +msgstr "" msgid "sequence" -msgstr "دنباله" +msgstr "" msgid "An :term:`iterable` which supports efficient element access using integer indices via the :meth:`~object.__getitem__` special method and defines a :meth:`~object.__len__` method that returns the length of the sequence. Some built-in sequence types are :class:`list`, :class:`str`, :class:`tuple`, and :class:`bytes`. Note that :class:`dict` also supports :meth:`~object.__getitem__` and :meth:`!__len__`, but is considered a mapping rather than a sequence because the lookups use arbitrary :term:`hashable` keys rather than integers." -msgstr "یک :term:`تکرارپذیر ` که از دسترسی کارآمد به المان‌ها با استفاده از اندیس‌های عدد صحیح از طریق متد ویژهٔ :meth:`~object.__getitem__` پشتیبانی می‌کند و متد :meth:`~object.__len__` را تعریف می‌کند که طول دنباله را برمی‌گرداند. برخی از انواع دنبالهٔ توکار عبارت‌اند از :class:`list`، :class:`str`، :class:`tuple` و :class:`bytes`. توجه کنید که :class:`dict` نیز از :meth:`~object.__getitem__` و :meth:`!__len__` پشتیبانی می‌کند، اما به‌جای دنباله، نگاشت در نظر گرفته می‌شود، زیرا جست‌وجوها از کلیدهای :term:`قابل درهم‌سازی ` دلخواه به‌جای اعداد صحیح استفاده می‌کنند." +msgstr "" msgid "The :class:`collections.abc.Sequence` abstract base class defines a much richer interface that goes beyond just :meth:`~object.__getitem__` and :meth:`~object.__len__`, adding :meth:`~sequence.count`, :meth:`~sequence.index`, :meth:`~object.__contains__`, and :meth:`~object.__reversed__`. Types that implement this expanded interface can be registered explicitly using :func:`~abc.ABCMeta.register`. For more documentation on sequence methods generally, see :ref:`Common Sequence Operations `." -msgstr "کلاس پایهٔ انتزاعی :class:`collections.abc.Sequence` رابط بسیار غنی‌تری را تعریف می‌کند که فراتر از صرفاً :meth:`~object.__getitem__` و :meth:`~object.__len__` است و :meth:`~sequence.count`، :meth:`~sequence.index`، :meth:`~object.__contains__` و :meth:`~object.__reversed__` را نیز اضافه می‌کند. نوع‌هایی که این رابط گسترش‌یافته را پیاده‌سازی می‌کنند، می‌توانند به‌طور صریح با استفاده از :func:`~abc.ABCMeta.register` ثبت شوند. برای مستندات بیشتر دربارهٔ متدهای دنباله به‌طور کلی، :ref:`Common Sequence Operations ` را ببینید." +msgstr "" msgid "set comprehension" -msgstr "درک مجموعه‌ای" +msgstr "" msgid "A compact way to process all or part of the elements in an iterable and return a set with the results. ``results = {c for c in 'abracadabra' if c not in 'abc'}`` generates the set of strings ``{'r', 'd'}``. See :ref:`comprehensions`." -msgstr "روشی فشرده برای پردازش همه یا بخشی از المان‌های یک تکرارپذیر و بازگرداندن یک مجموعه با نتایج. ``results = {c for c in 'abracadabra' if c not in 'abc'}`` مجموعه‌ای از رشته‌ها به‌شکل ``{'r', 'd'}`` تولید می‌کند. :ref:`comprehensions` را ببینید." +msgstr "" msgid "single dispatch" -msgstr "توزیع تک‌گانه" +msgstr "" msgid "A form of :term:`generic function` dispatch where the implementation is chosen based on the type of a single argument." -msgstr "نوعی توزیع :term:`تابع عمومی ` که در آن پیاده‌سازی بر اساس نوع یک آرگومان واحد انتخاب می‌شود." +msgstr "" msgid "slice" -msgstr "برش" +msgstr "" msgid "An object of type :class:`slice`, used to describe a portion of a :term:`sequence`. A slice object is created when using the :ref:`slicing ` form of :ref:`subscript notation `, with colons inside square brackets, such as in ``variable_name[1:3:5]``." -msgstr "یک شیء از نوع :class:`slice` که برای توصیف بخشی از یک :term:`دنباله ` استفاده می‌شود. یک شیء برش هنگام استفاده از شکل :ref:`slicing ` در :ref:`subscript notation `، با دو نقطه درون کروشه‌ها، مانند ``variable_name[1:3:5]``، ایجاد می‌شود." +msgstr "" msgid "soft deprecated" -msgstr "منسوخ‌سازی نرم" +msgstr "" msgid "A soft deprecated API should not be used in new code, but it is safe for already existing code to use it. The API remains documented and tested, but will not be enhanced further." -msgstr "از یک API که به‌صورت منسوخ‌سازی نرم علامت‌گذاری شده است نباید در کد جدید استفاده شود، اما استفاده از آن در کدهای موجود ایمن است. این API همچنان مستندسازی و آزمایش می‌شود، اما دیگر بهبود داده نخواهد شد." +msgstr "" msgid "Soft deprecation, unlike normal deprecation, does not plan on removing the API and will not emit warnings." -msgstr "منسوخ‌سازی نرم، برخلاف منسوخ‌سازی معمولی، قصد حذف API را ندارد و هیچ هشداری نیز ایجاد نمی‌کند." +msgstr "" msgid "See `PEP 387: Soft Deprecation `_." -msgstr "`PEP 387: Soft Deprecation `_ را نیز ببینید." +msgstr "" msgid "special method" -msgstr "متد ویژه" +msgstr "" msgid "A method that is called implicitly by Python to execute a certain operation on a type, such as addition. Such methods have names starting and ending with double underscores. Special methods are documented in :ref:`specialnames`." -msgstr "متدی که به‌طور ضمنی توسط پایتون فراخوانی می‌شود تا عملیاتی خاص را روی یک نوع، مانند جمع، اجرا کند. نام این متدها با دو زیرخط آغاز و با دو زیرخط پایان می‌یابد. متدهای ویژه در :ref:`specialnames` مستند شده‌اند." +msgstr "" msgid "standard library" -msgstr "کتابخانهٔ استاندارد" +msgstr "" msgid "The collection of :term:`packages `, :term:`modules ` and :term:`extension modules ` distributed as a part of the official Python interpreter package. The exact membership of the collection may vary based on platform, available system libraries, or other criteria. Documentation can be found at :ref:`library-index`." -msgstr "مجموعه‌ای از :term:`بسته `، :term:`ماژول ` و :term:`ماژول افزونه ` که به‌عنوان بخشی از بستهٔ رسمی مفسر پایتون توزیع می‌شوند. اعضای دقیق این مجموعه ممکن است بر اساس سکو، کتابخانه‌های سیستمی موجود یا معیارهای دیگر متفاوت باشند. مستندات آن را می‌توانید در :ref:`library-index` پیدا کنید." +msgstr "" msgid "See also :data:`sys.stdlib_module_names` for a list of all possible standard library module names." -msgstr "همچنین :data:`sys.stdlib_module_names` را برای فهرستی از همهٔ نام‌های ممکن ماژول‌های کتابخانهٔ استاندارد ببینید." +msgstr "" msgid "statement" -msgstr "دستور" +msgstr "" msgid "A statement is part of a suite (a \"block\" of code). A statement is either an :term:`expression` or one of several constructs with a keyword, such as :keyword:`if`, :keyword:`while` or :keyword:`for`." -msgstr "دستور بخشی از یک مجموعه (یک «بلوک» کد) است. یک دستور یا یک :term:`عبارت ` است یا یکی از چند ساختار دارای کلیدواژه، مانند :keyword:`if`، :keyword:`while` یا :keyword:`for`." +msgstr "" msgid "static type checker" -msgstr "بررسی‌کنندهٔ نوع ایستا" +msgstr "" msgid "An external tool that reads Python code and analyzes it, looking for issues such as incorrect types. See also :term:`type hints ` and the :mod:`typing` module." -msgstr "یک ابزار خارجی که کد پایتون را می‌خواند و آن را تحلیل می‌کند و به‌دنبال مشکلاتی مانند نوع‌های نادرست می‌گردد. همچنین :term:`راهنمای نوع ` و ماژول :mod:`typing` را ببینید." +msgstr "" msgid "stdlib" -msgstr "stdlib" +msgstr "" msgid "An abbreviation of :term:`standard library`." -msgstr "شکل کوتاه‌شدهٔ :term:`کتابخانهٔ استاندارد `." - -msgid "steal" -msgstr "دزدیدن" - -msgid "In Python's C API, \"*stealing*\" an argument means that ownership of the argument is transferred to the called function. The caller must not use that reference after the call. Generally, functions that \"steal\" an argument do so even if they fail." -msgstr "در C API پایتون، «دزدیدن» یک آرگومان به این معناست که مالکیت آرگومان به تابع فراخوانی‌شده منتقل می‌شود. فراخواننده نباید پس از فراخوانی از آن ارجاع استفاده کند. به‌طور کلی، توابعی که یک آرگومان را «می‌دزدند»، این کار را حتی در صورت شکست نیز انجام می‌دهند." - -msgid "See :ref:`api-refcountdetails` for a full explanation." -msgstr "برای توضیح کامل، بخش :ref:`api-refcountdetails` را ببینید." +msgstr "" msgid "strong reference" -msgstr "ارجاع قوی" +msgstr "" msgid "In Python's C API, a strong reference is a reference to an object which is owned by the code holding the reference. The strong reference is taken by calling :c:func:`Py_INCREF` when the reference is created and released with :c:func:`Py_DECREF` when the reference is deleted." -msgstr "در API زبان C پایتون، ارجاع قوی ارجاعی به یک شیء است که کدی که ارجاع را در اختیار دارد، مالک آن است. ارجاع قوی هنگام ایجاد ارجاع با فراخوانی :c:func:`Py_INCREF` گرفته می‌شود و هنگام حذف ارجاع با :c:func:`Py_DECREF` آزاد می‌شود." +msgstr "" msgid "The :c:func:`Py_NewRef` function can be used to create a strong reference to an object. Usually, the :c:func:`Py_DECREF` function must be called on the strong reference before exiting the scope of the strong reference, to avoid leaking one reference." -msgstr "از تابع :c:func:`Py_NewRef` می‌توان برای ایجاد یک ارجاع قوی به یک شیء استفاده کرد. معمولاً باید تابع :c:func:`Py_DECREF` پیش از خروج از محدودهٔ ارجاع قوی، روی آن فراخوانی شود تا از نشت یک ارجاع جلوگیری شود." +msgstr "" msgid "See also :term:`borrowed reference`." -msgstr "همچنین :term:`ارجاع قرض‌گرفته‌شده ` را ببینید." +msgstr "" msgid "subscript" -msgstr "زیرنویس" +msgstr "" msgid "The expression in square brackets of a :ref:`subscription expression `, for example, the ``3`` in ``items[3]``. Usually used to select an element of a container. Also called a :term:`key` when subscripting a :term:`mapping`, or an :term:`index` when subscripting a :term:`sequence`." -msgstr "عبارت درون کروشه‌های یک :ref:`subscription expression `، برای مثال ``3`` در ``items[3]``. معمولاً برای انتخاب یک المان از یک کانتینر استفاده می‌شود. هنگام زیرنویس‌گذاری یک :term:`نگاشت `، به آن :term:`کلید ` نیز گفته می‌شود و هنگام زیرنویس‌گذاری یک :term:`دنباله `، به آن :term:`اندیس ` گفته می‌شود." +msgstr "" msgid "synchronization primitive" -msgstr "اولیه" +msgstr "" msgid "A basic building block for coordinating (synchronizing) the execution of multiple threads to ensure :term:`thread-safe` access to shared resources. Python's :mod:`threading` module provides several synchronization primitives including :class:`~threading.Lock`, :class:`~threading.RLock`, :class:`~threading.Semaphore`, :class:`~threading.Condition`, :class:`~threading.Event`, and :class:`~threading.Barrier`. Additionally, the :mod:`queue` module provides multi-producer, multi-consumer queues that are especially useful in multithreaded programs. These primitives help prevent :term:`race conditions ` and coordinate thread execution. See also :term:`lock`." -msgstr "یک سازهٔ پایه برای هماهنگ‌سازی اجرای چند نخ اجرایی، با هدف اطمینان از دسترسی :term:`ایمن برای نخ‌های اجرایی ` به منابع مشترک. ماژول :mod:`threading` پایتون چندین اولیهٔ همگام‌سازی، از جمله :class:`~threading.Lock`، :class:`~threading.RLock`، :class:`~threading.Semaphore`، :class:`~threading.Condition`، :class:`~threading.Event` و :class:`~threading.Barrier` را فراهم می‌کند. افزون بر این، ماژول :mod:`queue` صف‌های چندتولیدکننده، چندمصرف‌کننده‌ای را فراهم می‌کند که به‌ویژه در برنامه‌های چندنخی مفید هستند. این اولیه‌ها به جلوگیری از :term:`شرط رقابت ` و هماهنگ‌سازی اجرای نخ‌های اجرایی کمک می‌کنند. همچنین :term:`قفل ` را ببینید." +msgstr "" msgid "t-string" -msgstr "تی‌استرینگ" +msgstr "" msgid "t-strings" -msgstr "تی‌استرینگ‌ها" +msgstr "" msgid "String literals prefixed with ``t`` or ``T`` are commonly called \"t-strings\" which is short for :ref:`template string literals `." -msgstr "لیترال‌های رشته‌ای که با ``t`` یا ``T`` پیشوندگذاری شده‌اند، معمولاً «t-string» نامیده می‌شوند که شکل کوتاه‌شدهٔ :ref:`template string literals ` است." +msgstr "" msgid "text encoding" -msgstr "کدگذاری متن" +msgstr "" msgid "A string in Python is a sequence of Unicode code points (in range ``U+0000``--``U+10FFFF``). To store or transfer a string, it needs to be serialized as a sequence of bytes." -msgstr "یک رشته در پایتون دنباله‌ای از نقاط کد یونیکد است (در محدودهٔ ``U+0000``--``U+10FFFF``). برای ذخیره یا انتقال یک رشته، لازم است آن را به‌صورت دنباله‌ای از بایت‌ها سریال‌سازی کرد." +msgstr "" msgid "Serializing a string into a sequence of bytes is known as \"encoding\", and recreating the string from the sequence of bytes is known as \"decoding\"." -msgstr "سریال‌سازی یک رشته به‌صورت دنباله‌ای از بایت‌ها «کدگذاری» نامیده می‌شود و بازسازی رشته از دنبالهٔ بایت‌ها «کدگشایی» نام دارد." +msgstr "" msgid "There are a variety of different text serialization :ref:`codecs `, which are collectively referred to as \"text encodings\"." -msgstr "انواع مختلفی از :ref:`codecs ` برای سریال‌سازی متن وجود دارند که در مجموع «کدگذاری‌های متن» نامیده می‌شوند." +msgstr "" msgid "text file" -msgstr "فایل متنی" +msgstr "" msgid "A :term:`file object` able to read and write :class:`str` objects. Often, a text file actually accesses a byte-oriented datastream and handles the :term:`text encoding` automatically. Examples of text files are files opened in text mode (``'r'`` or ``'w'``), :data:`sys.stdin`, :data:`sys.stdout`, and instances of :class:`io.StringIO`." -msgstr "یک :term:`شیء فایل ` که می‌تواند اشیای :class:`str` را بخواند و بنویسد. یک فایل متنی اغلب در واقع به یک جریان دادهٔ بایت‌محور دسترسی دارد و :term:`کدگذاری متن ` را به‌طور خودکار مدیریت می‌کند. نمونه‌هایی از فایل‌های متنی، فایل‌هایی هستند که در حالت متنی باز شده‌اند (``'r'`` یا ``'w'``)، :data:`sys.stdin`، :data:`sys.stdout` و نمونه‌های :class:`io.StringIO`." +msgstr "" msgid "See also :term:`binary file` for a file object able to read and write :term:`bytes-like objects `." -msgstr "همچنین برای یک شیء فایل که می‌تواند :term:`شیء شبه‌بایت ` را بخواند و بنویسد، :term:`فایل دودویی ` را ببینید." +msgstr "" msgid "thread state" -msgstr "وضعیت نخ اجرایی" +msgstr "" msgid "The information used by the :term:`CPython` runtime to run in an OS thread. For example, this includes the current exception, if any, and the state of the bytecode interpreter." -msgstr "اطلاعاتی که :term:`CPython ` ران‌تایم برای اجرا در یک نخ اجرایی سیستم‌عامل استفاده می‌کند. برای مثال، این اطلاعات شامل استثنای فعلی، در صورت وجود، و وضعیت مفسر بایت‌کد است." +msgstr "" msgid "Each thread state is bound to a single OS thread, but threads may have many thread states available. At most, one of them may be :term:`attached ` at once." -msgstr "هر وضعیت نخ اجرایی به یک نخ اجرایی سیستم‌عامل واحد وابسته است، اما نخ‌های اجرایی ممکن است وضعیت‌های نخ اجرایی متعددی در دسترس داشته باشند. در هر لحظه حداکثر یکی از آن‌ها می‌تواند :term:`وضعیت نخ متصل ` باشد." +msgstr "" msgid "An :term:`attached thread state` is required to call most of Python's C API, unless a function explicitly documents otherwise. The bytecode interpreter only runs under an attached thread state." -msgstr "برای فراخوانی بیشتر API زبان C پایتون، یک :term:`وضعیت نخ متصل ` لازم است، مگر اینکه تابعی صراحتاً خلاف آن را مستند کرده باشد. مفسر بایت‌کد فقط در یک وضعیت نخ اجرایی پیوست‌شده اجرا می‌شود." +msgstr "" msgid "Each thread state belongs to a single interpreter, but each interpreter may have many thread states, including multiple for the same OS thread. Thread states from multiple interpreters may be bound to the same thread, but only one can be :term:`attached ` in that thread at any given moment." -msgstr "هر وضعیت نخ اجرایی به یک مفسر واحد تعلق دارد، اما هر مفسر ممکن است وضعیت‌های نخ اجرایی متعددی داشته باشد، از جمله چند وضعیت برای یک نخ اجرایی سیستم‌عامل یکسان. وضعیت‌های نخ اجرایی از مفسرهای متعدد ممکن است به یک نخ اجرایی یکسان وابسته باشند، اما در هر لحظه فقط یکی از آن‌ها می‌تواند در آن نخ اجرایی :term:`وضعیت نخ متصل ` باشد." +msgstr "" msgid "See :ref:`Thread State and the Global Interpreter Lock ` for more information." -msgstr "برای اطلاعات بیشتر، :ref:`Thread State and the Global Interpreter Lock ` را ببینید." +msgstr "" msgid "thread-safe" -msgstr "ایمن برای نخ‌های اجرایی" +msgstr "" msgid "A module, function, or class that behaves correctly when used by multiple threads concurrently. Thread-safe code uses appropriate :term:`synchronization primitives ` like :term:`locks ` to protect shared mutable state, or is designed to avoid shared mutable state entirely. In the :term:`free-threaded ` build, built-in types like :class:`dict`, :class:`list`, and :class:`set` use internal locking to make many operations thread-safe, although thread safety is not necessarily guaranteed. Code that is not thread-safe may experience :term:`race conditions ` and :term:`data races ` when used in multi-threaded programs." -msgstr "یک ماژول، تابع یا کلاس که هنگام استفادهٔ هم‌زمان توسط چند نخ اجرایی، به‌درستی رفتار می‌کند. کد ایمن برای نخ‌های اجرایی از :term:`اولیه ` مناسب، مانند :term:`قفل `، برای محافظت از وضعیت تغییرپذیر مشترک استفاده می‌کند یا به‌گونه‌ای طراحی شده است که به‌طور کامل از وضعیت تغییرپذیر مشترک اجتناب کند. در ساخت :term:`نخ‌گذاری آزاد `، نوع‌های توکار مانند :class:`dict`، :class:`list` و :class:`set` از قفل‌گذاری داخلی برای ایمن‌کردن بسیاری از عملیات در برابر اجرای هم‌زمان نخ‌های اجرایی استفاده می‌کنند، هرچند ایمنی در برابر نخ‌های اجرایی لزوماً تضمین‌شده نیست. کدی که برای نخ‌های اجرایی ایمن نیست، هنگام استفاده در برنامه‌های چندنخی ممکن است دچار :term:`شرط رقابت ` و :term:`رقابت داده ` شود." +msgstr "" msgid "token" -msgstr "توکن" +msgstr "" msgid "A small unit of source code, generated by the :ref:`lexical analyzer ` (also called the *tokenizer*). Names, numbers, strings, operators, newlines and similar are represented by tokens." -msgstr "واحد کوچکی از کد منبع که توسط :ref:`lexical analyzer ` (که *tokenizer* نیز نامیده می‌شود) تولید می‌شود. نام‌ها، اعداد، رشته‌ها، عملگرها، نویسه‌های خط جدید و موارد مشابه به‌صورت توکن نمایش داده می‌شوند." +msgstr "" msgid "The :mod:`tokenize` module exposes Python's lexical analyzer. The :mod:`token` module contains information on the various types of tokens." -msgstr "ماژول :mod:`tokenize` تحلیل‌گر واژگانی پایتون را در دسترس قرار می‌دهد. ماژول :mod:`token` حاوی اطلاعاتی دربارهٔ انواع مختلف توکن‌ها است." +msgstr "" msgid "triple-quoted string" -msgstr "رشتهٔ سه‌نقل‌قولی" +msgstr "" msgid "A string which is bound by three instances of either a quotation mark (\") or an apostrophe ('). While they don't provide any functionality not available with single-quoted strings, they are useful for a number of reasons. They allow you to include unescaped single and double quotes within a string and they can span multiple lines without the use of the continuation character, making them especially useful when writing docstrings." -msgstr "رشته‌ای که با سه نمونه از یکی از علامت‌های نقل‌قول (\") یا آپاستروف (') محصور شده است. با اینکه این رشته‌ها قابلیت جدیدی فراتر از رشته‌های تک‌نقل‌قولی فراهم نمی‌کنند، به دلایل متعددی مفید هستند. آن‌ها به شما اجازه می‌دهند علامت‌های نقل‌قول تکی و دوتایی را بدون خنثی‌سازی درون یک رشته قرار دهید و می‌توانند بدون استفاده از نویسهٔ ادامهٔ خط، چندین خط را دربر بگیرند؛ بنابراین هنگام نوشتن docstringها به‌ویژه مفید هستند." +msgstr "" msgid "type" -msgstr "نوع" +msgstr "" msgid "The type of a Python object determines what kind of object it is; every object has a type. An object's type is accessible as its :attr:`~object.__class__` attribute or can be retrieved with ``type(obj)``." -msgstr "نوع یک شیء پایتون تعیین می‌کند که آن شیء از چه نوعی است؛ هر شیء یک نوع دارد. نوع یک شیء به‌عنوان ویژگی :attr:`~object.__class__` آن در دسترس است یا می‌توان آن را با ``type(obj)`` به‌دست آورد." +msgstr "" msgid "type alias" -msgstr "نام مستعار نوع" +msgstr "" msgid "A synonym for a type, created by assigning the type to an identifier." -msgstr "مترادفی برای یک نوع که با نسبت‌دادن نوع به یک شناسه ایجاد می‌شود." +msgstr "" msgid "Type aliases are useful for simplifying :term:`type hints `. For example::" -msgstr "نام‌های مستعار نوع برای ساده‌سازی :term:`راهنمای نوع ` مفید هستند. برای مثال::" +msgstr "" msgid "" "def remove_gray_shades(\n" " colors: list[tuple[int, int, int]]) -> list[tuple[int, int, int]]:\n" " pass" msgstr "" -"def remove_gray_shades(\n" -" colors: list[tuple[int, int, int]]) -> list[tuple[int, int, int]]:\n" -" pass" msgid "could be made more readable like this::" -msgstr "می‌توانست به این شکل خواناتر شود::" +msgstr "" msgid "" "Color = tuple[int, int, int]\n" @@ -1541,107 +1470,95 @@ msgid "" "def remove_gray_shades(colors: list[Color]) -> list[Color]:\n" " pass" msgstr "" -"Color = tuple[int, int, int]\n" -"\n" -"def remove_gray_shades(colors: list[Color]) -> list[Color]:\n" -" pass" msgid "See :mod:`typing` and :pep:`484`, which describe this functionality." -msgstr "برای توضیح این قابلیت، :mod:`typing` و :pep:`484` را ببینید." +msgstr "" msgid "type hint" -msgstr "راهنمای نوع" +msgstr "" msgid "An :term:`annotation` that specifies the expected type for a variable, a class attribute, or a function parameter or return value." -msgstr "یک :term:`حاشیه‌گذاری ` که نوع مورد انتظار برای یک متغیر، یک ویژگی کلاس، یا یک پارامتر یا مقدار بازگشتی تابع را مشخص می‌کند." +msgstr "" msgid "Type hints are optional and are not enforced by Python but they are useful to :term:`static type checkers `. They can also aid IDEs with code completion and refactoring." -msgstr "راهنماهای نوع اختیاری هستند و پایتون آن‌ها را اعمال نمی‌کند، اما برای :term:`بررسی‌کنندهٔ نوع ایستا ` مفید هستند. آن‌ها همچنین می‌توانند به IDEها در تکمیل کد و بازآرایی کد کمک کنند." +msgstr "" msgid "Type hints of global variables, class attributes, and functions, but not local variables, can be accessed using :func:`typing.get_type_hints`." -msgstr "راهنماهای نوع متغیرهای سراسری، ویژگی‌های کلاس و توابع، اما نه متغیرهای محلی، با استفاده از :func:`typing.get_type_hints` قابل دسترسی هستند." +msgstr "" msgid "universal newlines" -msgstr "خط جدید همگانی" +msgstr "" msgid "A manner of interpreting text streams in which all of the following are recognized as ending a line: the Unix end-of-line convention ``'\\n'``, the Windows convention ``'\\r\\n'``, and the old Macintosh convention ``'\\r'``. See :pep:`278` and :pep:`3116`, as well as :func:`bytes.splitlines` for an additional use." -msgstr "روشی برای تفسیر جریان‌های متنی که در آن همهٔ موارد زیر به‌عنوان پایان یک خط شناخته می‌شوند: قرارداد پایان خط یونیکس ``'\\n'``، قرارداد ویندوز ``'\\r\\n'`` و قرارداد قدیمی مکینتاش ``'\\r'``. همچنین :pep:`278` و :pep:`3116` و نیز :func:`bytes.splitlines` را برای کاربردی دیگر ببینید." +msgstr "" msgid "variable annotation" -msgstr "حاشیه‌نویسی متغیر" +msgstr "" msgid "An :term:`annotation` of a variable or a class attribute." -msgstr "یک :term:`حاشیه‌گذاری ` برای یک متغیر یا یک ویژگی کلاس." +msgstr "" msgid "When annotating a variable or a class attribute, assignment is optional::" -msgstr "هنگام حاشیه‌نویسی یک متغیر یا یک ویژگی کلاس، انتساب اختیاری است::" +msgstr "" msgid "" "class C:\n" " field: 'annotation'" msgstr "" -"class C:\n" -" field: 'annotation'" msgid "Variable annotations are usually used for :term:`type hints `: for example this variable is expected to take :class:`int` values::" -msgstr "حاشیه‌نویسی‌های متغیر معمولاً برای :term:`راهنمای نوع ` استفاده می‌شوند؛ برای مثال، انتظار می‌رود این متغیر مقادیر :class:`int` را بپذیرد::" +msgstr "" msgid "count: int = 0" -msgstr "count: int = 0" +msgstr "" msgid "Variable annotation syntax is explained in section :ref:`annassign`." -msgstr "سینتکس حاشیه‌نویسی متغیر در بخش :ref:`annassign` توضیح داده شده است." +msgstr "" msgid "See :term:`function annotation`, :pep:`484` and :pep:`526`, which describe this functionality. Also see :ref:`annotations-howto` for best practices on working with annotations." -msgstr "همچنین :term:`حاشیه‌گذاری تابع `، :pep:`484` و :pep:`526` را که این قابلیت را توصیف می‌کنند، ببینید. برای بهترین روش‌های کار با حاشیه‌نویسی‌ها نیز :ref:`annotations-howto` را ببینید." +msgstr "" msgid "virtual environment" -msgstr "محیط مجازی" +msgstr "" msgid "A cooperatively isolated runtime environment that allows Python users and applications to install and upgrade Python distribution packages without interfering with the behaviour of other Python applications running on the same system." -msgstr "یک محیط ران‌تایم ایزوله‌شدهٔ مشارکتی که به کاربران و برنامه‌های پایتون اجازه می‌دهد بسته‌های توزیعی پایتون را بدون تداخل با رفتار سایر برنامه‌های پایتونی در حال اجرا روی همان سیستم، نصب و ارتقا دهند." +msgstr "" msgid "See also :mod:`venv`." -msgstr "همچنین :mod:`venv` را ببینید." +msgstr "" msgid "virtual machine" -msgstr "ماشین مجازی" +msgstr "" msgid "A computer defined entirely in software. Python's virtual machine executes the :term:`bytecode` emitted by the bytecode compiler." -msgstr "یک رایانه که به‌طور کامل در نرم‌افزار تعریف شده است. ماشین مجازی پایتون :term:`بایت‌کد ` تولیدشده توسط کامپایلر بایت‌کد را اجرا می‌کند." +msgstr "" msgid "walrus operator" -msgstr "عملگر والروس" +msgstr "" msgid "A light-hearted way to refer to the :ref:`assignment expression ` operator ``:=`` because it looks a bit like a walrus if you turn your head." -msgstr "روشی شوخ‌طبعانه برای اشاره به عملگر :ref:`assignment expression ` یعنی ``:=``، زیرا اگر سرتان را کمی کج کنید، ظاهر آن تا حدی شبیه یک والروس است." +msgstr "" msgid "Zen of Python" -msgstr "ذن پایتون" +msgstr "" msgid "Listing of Python design principles and philosophies that are helpful in understanding and using the language. The listing can be found by typing \"``import this``\" at the interactive prompt." -msgstr "فهرستی از اصول و فلسفه‌های طراحی پایتون که برای درک و استفاده از این زبان مفید هستند. این فهرست با واردکردن «``import this``» در اعلان تعاملی قابل مشاهده است." +msgstr "" msgid "..." -msgstr "..." +msgstr "" msgid "ellipsis literal" -msgstr "لیترال سه‌نقطه" +msgstr "" msgid "C-contiguous" -msgstr "پیوسته در C" +msgstr "" msgid "Fortran contiguous" -msgstr "پیوسته در Fortran" +msgstr "" msgid "magic" -msgstr "جادو" +msgstr "" msgid "special" -msgstr "ویژه" - -#~ msgid "Usually refers to an asynchronous generator function, but may refer to an *asynchronous generator iterator* in some contexts. In cases where the intended meaning isn't clear, using the full terms avoids ambiguity." -#~ msgstr "معمولاً به یک تابع تولیدگر ناهمگام اشاره دارد، اما در برخی زمینه‌ها ممکن است به یک *تکرارگر تولیدگر ناهمگام* اشاره کند. در مواردی که معنای مورد نظر واضح نیست، استفاده از اصطلاحات کامل از ابهام جلوگیری می‌کند." - -#~ msgid "Usually refers to a generator function, but may refer to a *generator iterator* in some contexts. In cases where the intended meaning isn't clear, using the full terms avoids ambiguity." -#~ msgstr "معمولاً به یک تابع تولیدگر اشاره دارد، اما در برخی زمینه‌ها ممکن است به یک *تکرارگر تولیدگر* اشاره کند. در مواردی که معنای مورد نظر واضح نیست، استفاده از اصطلاحات کامل از ابهام جلوگیری می‌کند." +msgstr "" diff --git a/howto/a-conceptual-overview-of-asyncio.po b/howto/a-conceptual-overview-of-asyncio.po index 9f790843e..41ed107ee 100644 --- a/howto/a-conceptual-overview-of-asyncio.po +++ b/howto/a-conceptual-overview-of-asyncio.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" @@ -116,7 +116,7 @@ msgid "" "" msgstr "" -msgid "The terms \"coroutine function\" and \"coroutine object\" are often conflated as coroutine. That can be confusing! In this article, coroutine specifically refers to a coroutine object, or more precisely, an instance of :class:`types.CoroutineType` (native coroutine). Note that coroutines can also exist as instances of :class:`collections.abc.Coroutine` -- a distinction that matters for type checking." +msgid "The terms \"coroutine function\" and \"coroutine object\" are often conflated as coroutine. That can be confusing! In this article, coroutine specifically refers to a coroutine object, or more precisely, an instance of :data:`types.CoroutineType` (native coroutine). Note that coroutines can also exist as instances of :class:`collections.abc.Coroutine` -- a distinction that matters for type checking." msgstr "" msgid "A coroutine represents the function's body or logic. A coroutine has to be explicitly started; again, merely creating the coroutine does not start it. Notably, the coroutine can be paused and resumed at various points within the function's body. That pausing and resuming ability is what allows for asynchronous behavior!" diff --git a/howto/annotations.po b/howto/annotations.po index c2199d078..e58543d8c 100644 --- a/howto/annotations.po +++ b/howto/annotations.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:52+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -126,7 +126,7 @@ msgstr "" msgid "If ``o`` is a class, use ``sys.modules[o.__module__].__dict__`` as the ``globals``, and ``dict(vars(o))`` as the ``locals``, when calling :func:`eval`." msgstr "" -msgid "If ``o`` is a wrapped callable using :func:`functools.update_wrapper`, :deco:`functools.wraps`, or :func:`functools.partial`, iteratively unwrap it by accessing either ``o.__wrapped__`` or ``o.func`` as appropriate, until you have found the root unwrapped function." +msgid "If ``o`` is a wrapped callable using :func:`functools.update_wrapper`, :func:`functools.wraps`, or :func:`functools.partial`, iteratively unwrap it by accessing either ``o.__wrapped__`` or ``o.func`` as appropriate, until you have found the root unwrapped function." msgstr "" msgid "If ``o`` is a callable (but not a class), use :attr:`o.__globals__ ` as the globals when calling :func:`eval`." diff --git a/howto/argparse-optparse.po b/howto/argparse-optparse.po index 4ecf29ef8..aeddc61ec 100644 --- a/howto/argparse-optparse.po +++ b/howto/argparse-optparse.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-10-11 14:19+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/argparse.po b/howto/argparse.po index 63e20c9be..f5d45b979 100644 --- a/howto/argparse.po +++ b/howto/argparse.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:52+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/clinic.po b/howto/clinic.po index 3ae078fca..711224e1d 100644 --- a/howto/clinic.po +++ b/howto/clinic.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:52+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/cporting.po b/howto/cporting.po index eefa4d00b..5b178be6e 100644 --- a/howto/cporting.po +++ b/howto/cporting.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/curses.po b/howto/curses.po index 94c94c121..6437ad533 100644 --- a/howto/curses.po +++ b/howto/curses.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:53+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -60,7 +60,7 @@ msgstr "" msgid "The curses library was originally written for BSD Unix; the later System V versions of Unix from AT&T added many enhancements and new functions. BSD curses is no longer maintained, having been replaced by ncurses, which is an open-source implementation of the AT&T interface. If you're using an open-source Unix such as Linux or FreeBSD, your system almost certainly uses ncurses. Since most current commercial Unix versions are based on System V code, all the functions described here will probably be available. The older versions of curses carried by some proprietary Unixes may not support everything, though." msgstr "" -msgid "The Windows version of Python doesn't include the :mod:`curses` module. The third-party :pypi:`windows-curses` package provides the same interface on Windows." +msgid "The Windows version of Python doesn't include the :mod:`curses` module. A ported version called :pypi:`UniCurses` is available." msgstr "" msgid "The Python curses module" diff --git a/howto/descriptor.po b/howto/descriptor.po index bd41fb893..0e75f4afd 100644 --- a/howto/descriptor.po +++ b/howto/descriptor.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:53+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -57,7 +57,7 @@ msgstr "" msgid "The third section provides a more technical tutorial that goes into the detailed mechanics of how descriptors work. Most people don't need this level of detail." msgstr "" -msgid "The last section has pure Python equivalents for built-in descriptors that are written in C. Read this if you're curious about how functions turn into bound methods or about the implementation of common tools like :deco:`classmethod`, :deco:`staticmethod`, :deco:`property`, and :term:`__slots__`." +msgid "The last section has pure Python equivalents for built-in descriptors that are written in C. Read this if you're curious about how functions turn into bound methods or about the implementation of common tools like :func:`classmethod`, :func:`staticmethod`, :func:`property`, and :term:`__slots__`." msgstr "" msgid "Primer" @@ -313,7 +313,7 @@ msgstr "" msgid "Traditionally, the calling class controls what happens during lookup. Descriptors invert that relationship and allow the data being looked-up to have a say in the matter." msgstr "" -msgid "Descriptors are used throughout the language. It is how functions turn into bound methods. Common tools like :deco:`classmethod`, :deco:`staticmethod`, :deco:`property`, and :deco:`functools.cached_property` are all implemented as descriptors." +msgid "Descriptors are used throughout the language. It is how functions turn into bound methods. Common tools like :func:`classmethod`, :func:`staticmethod`, :func:`property`, and :func:`functools.cached_property` are all implemented as descriptors." msgstr "" msgid "Complete Practical Example" @@ -1003,7 +1003,7 @@ msgid "" "30" msgstr "" -msgid "Using the non-data descriptor protocol, a pure Python version of :deco:`staticmethod` would look like this:" +msgid "Using the non-data descriptor protocol, a pure Python version of :func:`staticmethod` would look like this:" msgstr "" msgid "" @@ -1075,7 +1075,7 @@ msgid "" "{'a': None, 'b': None, 'r': None, 'c': None, 'd': None}" msgstr "" -msgid "Using the non-data descriptor protocol, a pure Python version of :deco:`classmethod` would look like this:" +msgid "Using the non-data descriptor protocol, a pure Python version of :func:`classmethod` would look like this:" msgstr "" msgid "" @@ -1160,7 +1160,7 @@ msgstr "" msgid "4. Improves speed. Reading instance variables is 35% faster with ``__slots__`` (as measured with Python 3.10 on an Apple M1 processor)." msgstr "" -msgid "5. Blocks tools like :deco:`functools.cached_property` which require an instance dictionary to function correctly:" +msgid "5. Blocks tools like :func:`functools.cached_property` which require an instance dictionary to function correctly:" msgstr "" msgid "" diff --git a/howto/enum.po b/howto/enum.po index 9d5d1f866..1a9f8bed3 100644 --- a/howto/enum.po +++ b/howto/enum.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:53+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -306,7 +306,7 @@ msgstr "" msgid "Ensuring unique enumeration values" msgstr "" -msgid "By default, enumerations allow multiple names as aliases for the same value. When this behavior isn't desired, you can use the :deco:`unique` decorator::" +msgid "By default, enumerations allow multiple names as aliases for the same value. When this behavior isn't desired, you can use the :func:`unique` decorator::" msgstr "" msgid "" @@ -567,7 +567,7 @@ msgstr "" msgid "Only the dataclass fields are shown in the value area, not the dataclass' name." msgstr "" -msgid "Adding :deco:`~dataclasses.dataclass` decorator to :class:`Enum` and its subclasses is not supported. It will not raise any errors, but it will produce very strange results at runtime, such as members being equal to each other::" +msgid "Adding :func:`~dataclasses.dataclass` decorator to :class:`Enum` and its subclasses is not supported. It will not raise any errors, but it will produce very strange results at runtime, such as members being equal to each other::" msgstr "" msgid "" diff --git a/howto/free-threading-extensions.po b/howto/free-threading-extensions.po index 05ee711c9..6c941461a 100644 --- a/howto/free-threading-extensions.po +++ b/howto/free-threading-extensions.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-06-20 06:42+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/free-threading-python.po b/howto/free-threading-python.po index bae52914d..61647648f 100644 --- a/howto/free-threading-python.po +++ b/howto/free-threading-python.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-10-04 14:19+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/functional.po b/howto/functional.po index 73ed84b7e..a193720dd 100644 --- a/howto/functional.po +++ b/howto/functional.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:53+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/gdb_helpers.po b/howto/gdb_helpers.po index 9fbd0970f..fc6020d59 100644 --- a/howto/gdb_helpers.po +++ b/howto/gdb_helpers.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-02-25 01:11+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/index.po b/howto/index.po index 166d05f60..2c18a7059 100644 --- a/howto/index.po +++ b/howto/index.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:53+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/instrumentation.po b/howto/instrumentation.po index 9081e7ba7..c23397d91 100644 --- a/howto/instrumentation.po +++ b/howto/instrumentation.po @@ -15,10 +15,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:53+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/ipaddress.po b/howto/ipaddress.po index c798f6eda..39ff0be20 100644 --- a/howto/ipaddress.po +++ b/howto/ipaddress.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:53+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/isolating-extensions.po b/howto/isolating-extensions.po index 328ff8620..881a4a6b4 100644 --- a/howto/isolating-extensions.po +++ b/howto/isolating-extensions.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2022-11-05 19:48+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/logging-cookbook.po b/howto/logging-cookbook.po index 3418e11ef..97dd45fdc 100644 --- a/howto/logging-cookbook.po +++ b/howto/logging-cookbook.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:53+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -1794,7 +1794,7 @@ msgid "" "class NNGSocketListener(logging.handlers.QueueListener):\n" "\n" " def __init__(self, uri, /, *handlers, **kwargs):\n" -" # Have a timeout for interruptibility, and open a\n" +" # Have a timeout for interruptability, and open a\n" " # subscriber socket\n" " socket = pynng.Sub0(listen=uri, recv_timeout=500)\n" " # The b'' subscription matches all topics\n" diff --git a/howto/logging.po b/howto/logging.po index 110464564..41547e5f4 100644 --- a/howto/logging.po +++ b/howto/logging.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:53+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/mro.po b/howto/mro.po index 061fb3d18..0dd3bed48 100644 --- a/howto/mro.po +++ b/howto/mro.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-04-19 14:15+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,7 +29,7 @@ msgstr "" msgid "This is a historical document, provided as an appendix to the official documentation. The Method Resolution Order discussed here was *introduced* in Python 2.3, but it is still used in later versions -- including Python 3." msgstr "" -msgid "By `Michele Simionato `__." +msgid "By `Michele Simionato `__." msgstr "" msgid "Abstract" diff --git a/howto/perf_profiling.po b/howto/perf_profiling.po index a1f5bcf2b..c50d8222b 100644 --- a/howto/perf_profiling.po +++ b/howto/perf_profiling.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2023-05-24 13:07+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/pyporting.po b/howto/pyporting.po index 78c71295a..861687c96 100644 --- a/howto/pyporting.po +++ b/howto/pyporting.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:53+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/regex.po b/howto/regex.po index 619594ca5..1e43e9153 100644 --- a/howto/regex.po +++ b/howto/regex.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:53+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/remote_debugging.po b/howto/remote_debugging.po index 4b907f07b..0a9ba45b1 100644 --- a/howto/remote_debugging.po +++ b/howto/remote_debugging.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/howto/sockets.po b/howto/sockets.po index 627cad844..27c6c323a 100644 --- a/howto/sockets.po +++ b/howto/sockets.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:53+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/sorting.po b/howto/sorting.po index e2137d947..0498c75f1 100644 --- a/howto/sorting.po +++ b/howto/sorting.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:53+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -378,7 +378,7 @@ msgid "" "[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]" msgstr "" -msgid "However, note that ``<`` can fall back to using :meth:`~object.__gt__` if :meth:`~object.__lt__` is not implemented (see :func:`object.__lt__` for details on the mechanics). To avoid surprises, :pep:`8` recommends that all six comparison methods be implemented. The :deco:`~functools.total_ordering` decorator is provided to make that task easier." +msgid "However, note that ``<`` can fall back to using :meth:`~object.__gt__` if :meth:`~object.__lt__` is not implemented (see :func:`object.__lt__` for details on the mechanics). To avoid surprises, :pep:`8` recommends that all six comparison methods be implemented. The :func:`~functools.total_ordering` decorator is provided to make that task easier." msgstr "" msgid "Key functions need not depend directly on the objects being sorted. A key function can also access external resources. For instance, if the student grades are stored in a dictionary, they can be used to sort a separate list of student names:" diff --git a/howto/timerfd.po b/howto/timerfd.po index 4950f295a..0388535ba 100644 --- a/howto/timerfd.po +++ b/howto/timerfd.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-05-11 01:08+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/unicode.po b/howto/unicode.po index 9acbbca1a..10f0b7585 100644 --- a/howto/unicode.po +++ b/howto/unicode.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:53+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/howto/urllib2.po b/howto/urllib2.po index 60c308766..d1840f10e 100644 --- a/howto/urllib2.po +++ b/howto/urllib2.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:53+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/improve-page-nojs.po b/improve-page-nojs.po index 5ac90b7b3..26e55fc50 100644 --- a/improve-page-nojs.po +++ b/improve-page-nojs.po @@ -12,7 +12,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: invincible627 , 2026\n" "Language-Team: none\n" diff --git a/improve-page.po b/improve-page.po index 371991af2..53df85a60 100644 --- a/improve-page.po +++ b/improve-page.po @@ -12,7 +12,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: invincible627 , 2026\n" "Language-Team: none\n" diff --git a/installing/index.po b/installing/index.po index 963a4d521..a68e164df 100644 --- a/installing/index.po +++ b/installing/index.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:54+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/__future__.po b/library/__future__.po index a864a15aa..1b22d2aef 100644 --- a/library/__future__.po +++ b/library/__future__.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-20 04:14+0000\n" "PO-Revision-Date: 2021-06-28 00:54+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/__main__.po b/library/__main__.po index 02f19e6cd..73ff80f55 100644 --- a/library/__main__.po +++ b/library/__main__.po @@ -13,9 +13,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-20 04:14+0000\n" "PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/_thread.po b/library/_thread.po index 0305e2905..e42d02634 100644 --- a/library/_thread.po +++ b/library/_thread.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:54+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/abc.po b/library/abc.po index b61aa3d9f..35a9e2fc5 100644 --- a/library/abc.po +++ b/library/abc.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:54+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -147,13 +147,13 @@ msgstr "" msgid "A decorator indicating abstract methods." msgstr "" -msgid "Using this decorator requires that the class's metaclass is :class:`ABCMeta` or is derived from it. A class that has a metaclass derived from :class:`!ABCMeta` cannot be instantiated unless all of its abstract methods and properties are overridden. The abstract methods can be called using any of the normal 'super' call mechanisms. :deco:`!abstractmethod` may be used to declare abstract methods for properties and descriptors." +msgid "Using this decorator requires that the class's metaclass is :class:`ABCMeta` or is derived from it. A class that has a metaclass derived from :class:`!ABCMeta` cannot be instantiated unless all of its abstract methods and properties are overridden. The abstract methods can be called using any of the normal 'super' call mechanisms. :func:`!abstractmethod` may be used to declare abstract methods for properties and descriptors." msgstr "" -msgid "Dynamically adding abstract methods to a class, or attempting to modify the abstraction status of a method or class once it is created, are only supported using the :func:`update_abstractmethods` function. The :deco:`!abstractmethod` only affects subclasses derived using regular inheritance; \"virtual subclasses\" registered with the ABC's :meth:`~ABCMeta.register` method are not affected." +msgid "Dynamically adding abstract methods to a class, or attempting to modify the abstraction status of a method or class once it is created, are only supported using the :func:`update_abstractmethods` function. The :func:`!abstractmethod` only affects subclasses derived using regular inheritance; \"virtual subclasses\" registered with the ABC's :meth:`~ABCMeta.register` method are not affected." msgstr "" -msgid "When :deco:`!abstractmethod` is applied in combination with other method descriptors, it should be applied as the innermost decorator, as shown in the following usage examples::" +msgid "When :func:`!abstractmethod` is applied in combination with other method descriptors, it should be applied as the innermost decorator, as shown in the following usage examples::" msgstr "" msgid "" @@ -188,7 +188,7 @@ msgid "" " x = property(_get_x, _set_x)" msgstr "" -msgid "In order to correctly interoperate with the abstract base class machinery, the descriptor must identify itself as abstract using :attr:`!__isabstractmethod__`. In general, this attribute should be ``True`` if any of the methods used to compose the descriptor are abstract. For example, Python's built-in :deco:`property` does the equivalent of::" +msgid "In order to correctly interoperate with the abstract base class machinery, the descriptor must identify itself as abstract using :attr:`!__isabstractmethod__`. In general, this attribute should be ``True`` if any of the methods used to compose the descriptor are abstract. For example, Python's built-in :class:`property` does the equivalent of::" msgstr "" msgid "" @@ -206,13 +206,13 @@ msgstr "" msgid "The :mod:`!abc` module also supports the following legacy decorators:" msgstr "" -msgid "It is now possible to use :deco:`classmethod` with :deco:`abstractmethod`, making this decorator redundant." +msgid "It is now possible to use :class:`classmethod` with :func:`abstractmethod`, making this decorator redundant." msgstr "" -msgid "A subclass of the built-in :class:`classmethod`, indicating an abstract classmethod. Otherwise it is similar to :deco:`abstractmethod`." +msgid "A subclass of the built-in :func:`classmethod`, indicating an abstract classmethod. Otherwise it is similar to :func:`abstractmethod`." msgstr "" -msgid "This special case is deprecated, as the :deco:`classmethod` decorator is now correctly identified as abstract when applied to an abstract method::" +msgid "This special case is deprecated, as the :func:`classmethod` decorator is now correctly identified as abstract when applied to an abstract method::" msgstr "" msgid "" @@ -223,13 +223,13 @@ msgid "" " ..." msgstr "" -msgid "It is now possible to use :deco:`staticmethod` with :deco:`abstractmethod`, making this decorator redundant." +msgid "It is now possible to use :class:`staticmethod` with :func:`abstractmethod`, making this decorator redundant." msgstr "" -msgid "A subclass of the built-in :class:`staticmethod`, indicating an abstract staticmethod. Otherwise it is similar to :deco:`abstractmethod`." +msgid "A subclass of the built-in :func:`staticmethod`, indicating an abstract staticmethod. Otherwise it is similar to :func:`abstractmethod`." msgstr "" -msgid "This special case is deprecated, as the :deco:`staticmethod` decorator is now correctly identified as abstract when applied to an abstract method::" +msgid "This special case is deprecated, as the :func:`staticmethod` decorator is now correctly identified as abstract when applied to an abstract method::" msgstr "" msgid "" @@ -240,13 +240,13 @@ msgid "" " ..." msgstr "" -msgid "It is now possible to use :deco:`property`, :deco:`property.getter`, :deco:`property.setter` and :deco:`property.deleter` with :deco:`abstractmethod`, making this decorator redundant." +msgid "It is now possible to use :class:`property`, :meth:`property.getter`, :meth:`property.setter` and :meth:`property.deleter` with :func:`abstractmethod`, making this decorator redundant." msgstr "" -msgid "A subclass of the built-in :class:`property`, indicating an abstract property." +msgid "A subclass of the built-in :func:`property`, indicating an abstract property." msgstr "" -msgid "This special case is deprecated, as the :deco:`property` decorator is now correctly identified as abstract when applied to an abstract method::" +msgid "This special case is deprecated, as the :func:`property` decorator is now correctly identified as abstract when applied to an abstract method::" msgstr "" msgid "" diff --git a/library/aifc.po b/library/aifc.po index 97b92e0a5..f4fda8721 100644 --- a/library/aifc.po +++ b/library/aifc.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:02+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/allos.po b/library/allos.po index 028c01b05..32188ada4 100644 --- a/library/allos.po +++ b/library/allos.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/annotationlib.po b/library/annotationlib.po index a7da97544..4199c1d9e 100644 --- a/library/annotationlib.po +++ b/library/annotationlib.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/library/archiving.po b/library/archiving.po index ec057bbaf..99727efd9 100644 --- a/library/archiving.po +++ b/library/archiving.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/argparse.po b/library/argparse.po index 269d7ed6f..1908bc24e 100644 --- a/library/argparse.po +++ b/library/argparse.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:54+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/array.po b/library/array.po index e1136324d..5d3036113 100644 --- a/library/array.po +++ b/library/array.po @@ -15,10 +15,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:54+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/ast.po b/library/ast.po index 1ecf3deee..17c5727f9 100644 --- a/library/ast.po +++ b/library/ast.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-27 06:04+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:54+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -1092,7 +1092,7 @@ msgid "" " value=Constant(value=Ellipsis))])])" msgstr "" -msgid "``try`` blocks which are followed by ``except*`` clauses. The attributes are the same as for :class:`Try` but the :class:`ExceptHandler` nodes in ``handlers`` are interpreted as ``except*`` blocks rather than ``except``." +msgid "``try`` blocks which are followed by ``except*`` clauses. The attributes are the same as for :class:`Try` but the :class:`ExceptHandler` nodes in ``handlers`` are interpreted as ``except*`` blocks rather then ``except``." msgstr "" msgid "" diff --git a/library/asynchat.po b/library/asynchat.po index 2529f8de6..69a1df20d 100644 --- a/library/asynchat.po +++ b/library/asynchat.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:02+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/asyncio-api-index.po b/library/asyncio-api-index.po index 9b2228e24..e17c07634 100644 --- a/library/asyncio-api-index.po +++ b/library/asyncio-api-index.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:54+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/asyncio-dev.po b/library/asyncio-dev.po index a39633e7b..c31574dff 100644 --- a/library/asyncio-dev.po +++ b/library/asyncio-dev.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:54+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/asyncio-eventloop.po b/library/asyncio-eventloop.po index 2f497b728..a574a3993 100644 --- a/library/asyncio-eventloop.po +++ b/library/asyncio-eventloop.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:54+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -755,13 +755,7 @@ msgstr "" msgid "Asynchronous version of :meth:`socket.connect() `." msgstr "" -msgid "With :class:`SelectorEventLoop`, *address* does not need to be resolved: for :const:`~socket.AF_INET` and :const:`~socket.AF_INET6` sockets, ``sock_connect`` first checks whether *address* is already resolved by calling :func:`socket.inet_pton`, and uses :meth:`loop.getaddrinfo` to resolve it if it is not." -msgstr "" - -msgid ":class:`ProactorEventLoop`, the default event loop on Windows, does not resolve *address*. The host must already be a numeric IP address; passing a host name raises :exc:`OSError`. Resolve the address with :meth:`loop.getaddrinfo` first, or use :meth:`loop.create_connection`, which resolves the address on every platform." -msgstr "" - -msgid "With :class:`SelectorEventLoop`, ``address`` no longer needs to be resolved." +msgid "``address`` no longer needs to be resolved. ``sock_connect`` will try to check if the *address* is already resolved by calling :func:`socket.inet_pton`. If not, :meth:`loop.getaddrinfo` will be used to resolve the *address*." msgstr "" msgid ":meth:`loop.create_connection` and :func:`asyncio.open_connection() `." @@ -815,7 +809,7 @@ msgstr "" msgid "Register the read end of *pipe* in the event loop." msgstr "" -msgid "*pipe* is a :term:`file-like object `. See :ref:`Supported pipe objects ` for the objects supported as *pipe*." +msgid "*pipe* is a :term:`file-like object `." msgstr "" msgid "Return pair ``(transport, protocol)``, where *transport* supports the :class:`ReadTransport` interface and *protocol* is an object instantiated by the *protocol_factory*." @@ -827,28 +821,10 @@ msgstr "" msgid "Register the write end of *pipe* in the event loop." msgstr "" -msgid "Return pair ``(transport, protocol)``, where *transport* supports :class:`WriteTransport` interface and *protocol* is an object instantiated by the *protocol_factory*." -msgstr "" - -msgid "Supported pipe objects" -msgstr "" - -msgid "These methods only work with objects the operating system can poll for readiness or perform overlapped I/O on. Regular files on disk are **not** supported on any platform. There is no asynchronous file I/O in asyncio; use :meth:`loop.run_in_executor` to read and write regular files without blocking the event loop." -msgstr "" - -msgid "On Unix, with :class:`SelectorEventLoop`, *pipe* must wrap one of the following:" -msgstr "" - -msgid "a pipe, such as an end of an :func:`os.pipe` pair or a FIFO created with :func:`os.mkfifo`;" -msgstr "" - -msgid "a socket;" +msgid "*pipe* is :term:`file-like object `." msgstr "" -msgid "a character device, such as a terminal." -msgstr "" - -msgid "On Windows, where only :class:`ProactorEventLoop` implements these methods, *pipe* must wrap a handle opened for overlapped I/O (that is, created with the ``FILE_FLAG_OVERLAPPED`` flag), since the handle has to be associated with an I/O completion port. Handles that were not opened for overlapped I/O are rejected. In particular, the standard streams (:data:`sys.stdin`, :data:`sys.stdout` and :data:`sys.stderr`), console handles, and the pipes created by :func:`os.pipe` are **not** opened for overlapped I/O and therefore cannot be used with these methods." +msgid "Return pair ``(transport, protocol)``, where *transport* supports :class:`WriteTransport` interface and *protocol* is an object instantiated by the *protocol_factory*." msgstr "" msgid ":class:`SelectorEventLoop` does not support the above methods on Windows. Use :class:`ProactorEventLoop` instead for Windows." @@ -1270,9 +1246,6 @@ msgstr "" msgid "Wait until the :meth:`close` method completes and all active connections have finished." msgstr "" -msgid "``wait_closed()`` now waits until the server is closed and all active connections have finished. Previously, it returned immediately if the server was already closed, even if connections were still active." -msgstr "" - msgid "List of socket-like objects, ``asyncio.trsock.TransportSocket``, which the server is listening on." msgstr "" diff --git a/library/asyncio-exceptions.po b/library/asyncio-exceptions.po index 2d8393f28..19f19b02b 100644 --- a/library/asyncio-exceptions.po +++ b/library/asyncio-exceptions.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:54+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/asyncio-extending.po b/library/asyncio-extending.po index e4ae3a66f..5ec7c7600 100644 --- a/library/asyncio-extending.po +++ b/library/asyncio-extending.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2022-11-05 19:48+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/asyncio-future.po b/library/asyncio-future.po index 6f8ced632..603c76d37 100644 --- a/library/asyncio-future.po +++ b/library/asyncio-future.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:55+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/asyncio-graph.po b/library/asyncio-graph.po index 34c054ae4..fc06b6112 100644 --- a/library/asyncio-graph.po +++ b/library/asyncio-graph.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" @@ -19,7 +19,7 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -msgid "Call graph introspection" +msgid "Call Graph Introspection" msgstr "" msgid "**Source code:** :source:`Lib/asyncio/graph.py`" @@ -28,12 +28,6 @@ msgstr "" msgid "asyncio has powerful runtime call graph introspection utilities to trace the entire call graph of a running *coroutine* or *task*, or a suspended *future*. These utilities and the underlying machinery can be used from within a Python program or by external profilers and debuggers." msgstr "" -msgid ":ref:`asyncio-introspection-tools`" -msgstr "" - -msgid "Command-line tools for inspecting tasks in another running Python process." -msgstr "" - msgid "Print the async call graph for the current task or the provided :class:`Task` or :class:`Future`." msgstr "" diff --git a/library/asyncio-llapi-index.po b/library/asyncio-llapi-index.po index adf3042f9..33c7b965a 100644 --- a/library/asyncio-llapi-index.po +++ b/library/asyncio-llapi-index.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:55+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/asyncio-platforms.po b/library/asyncio-platforms.po index 0bae4bf54..63ce1e0ee 100644 --- a/library/asyncio-platforms.po +++ b/library/asyncio-platforms.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:55+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -35,9 +35,6 @@ msgstr "" msgid ":meth:`loop.add_reader` and :meth:`loop.add_writer` cannot be used to monitor file I/O." msgstr "" -msgid ":meth:`loop.connect_read_pipe` and :meth:`loop.connect_write_pipe` cannot be used with regular files. See :ref:`Supported pipe objects ` for the objects that are accepted on each platform." -msgstr "" - msgid "Windows" msgstr "" @@ -77,9 +74,6 @@ msgstr "" msgid "The :meth:`loop.add_reader` and :meth:`loop.add_writer` methods are not supported." msgstr "" -msgid ":meth:`loop.connect_read_pipe` and :meth:`loop.connect_write_pipe` only accept a handle opened for overlapped I/O. See :ref:`Supported pipe objects ` for which objects are supported." -msgstr "" - msgid "The resolution of the monotonic clock on Windows is usually around 15.6 milliseconds. The best resolution is 0.5 milliseconds. The resolution depends on the hardware (availability of `HPET `_) and on the Windows configuration." msgstr "" diff --git a/library/asyncio-policy.po b/library/asyncio-policy.po index cf72e2124..460b923ec 100644 --- a/library/asyncio-policy.po +++ b/library/asyncio-policy.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:55+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/asyncio-protocol.po b/library/asyncio-protocol.po index 4d7b9fb64..5c016a68b 100644 --- a/library/asyncio-protocol.po +++ b/library/asyncio-protocol.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:55+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/asyncio-queue.po b/library/asyncio-queue.po index c8d4fbea8..e3d85c036 100644 --- a/library/asyncio-queue.po +++ b/library/asyncio-queue.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:55+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -78,9 +78,6 @@ msgstr "" msgid "Return an item if one is immediately available, else raise :exc:`QueueEmpty`." msgstr "" -msgid "Raises :exc:`QueueShutDown` if the queue has been shut down and is empty." -msgstr "" - msgid "Block until all items in the queue have been received and processed." msgstr "" @@ -159,7 +156,7 @@ msgstr "" msgid "Exception raised when the :meth:`~Queue.put_nowait` method is called on a queue that has reached its *maxsize*." msgstr "" -msgid "Exception raised when :meth:`~Queue.put`, :meth:`~Queue.put_nowait`, :meth:`~Queue.get` or :meth:`~Queue.get_nowait` is called on a queue which has been shut down." +msgid "Exception raised when :meth:`~Queue.put` or :meth:`~Queue.get` is called on a queue which has been shut down." msgstr "" msgid "Examples" diff --git a/library/asyncio-runner.po b/library/asyncio-runner.po index 3df32645c..7c439a44a 100644 --- a/library/asyncio-runner.po +++ b/library/asyncio-runner.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2022-11-05 19:48+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/asyncio-stream.po b/library/asyncio-stream.po index 7940931e0..8603cef1a 100644 --- a/library/asyncio-stream.po +++ b/library/asyncio-stream.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:55+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -275,9 +275,6 @@ msgstr "" msgid "This is a flow control method that interacts with the underlying IO write buffer. When the size of the buffer reaches the high watermark, *drain()* blocks until the size of the buffer is drained down to the low watermark and writing can be resumed. When there is nothing to wait for, the :meth:`drain` returns immediately." msgstr "" -msgid "When the write buffer is below the high watermark, :meth:`drain` returns immediately without yielding to the event loop. As a result, code which repeatedly calls ``write()`` followed by ``await drain()`` may prevent other tasks from running. To prevent blocking behavior, yield to the event loop explicitly with ``await asyncio.sleep(0)`` (see :func:`asyncio.sleep`)." -msgstr "" - msgid "Upgrade an existing stream-based connection to TLS." msgstr "" diff --git a/library/asyncio-subprocess.po b/library/asyncio-subprocess.po index 9bac6e1d2..c86da07be 100644 --- a/library/asyncio-subprocess.po +++ b/library/asyncio-subprocess.po @@ -15,10 +15,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:55+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/asyncio-sync.po b/library/asyncio-sync.po index c67300a5a..bb1a3c9e7 100644 --- a/library/asyncio-sync.po +++ b/library/asyncio-sync.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:55+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/asyncio-task.po b/library/asyncio-task.po index a495ee557..cf782bf92 100644 --- a/library/asyncio-task.po +++ b/library/asyncio-task.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:55+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -793,9 +793,6 @@ msgstr "" msgid "Unlike :func:`~asyncio.wait_for`, ``wait()`` does not cancel the futures when a timeout occurs." msgstr "" -msgid "If ``wait()`` is cancelled, the futures in *aws* are not cancelled and continue to run." -msgstr "" - msgid "Passing coroutine objects to ``wait()`` directly is forbidden." msgstr "" @@ -845,9 +842,6 @@ msgstr "" msgid "A :exc:`TimeoutError` is raised if the timeout occurs before all awaitables are done. This is raised by the ``async for`` loop during asynchronous iteration or by the coroutines yielded during plain iteration." msgstr "" -msgid "``as_completed()`` does not cancel the tasks running the supplied awaitables: if a timeout occurs or the iteration is cancelled, the remaining tasks continue to run." -msgstr "" - msgid "Deprecation warning is emitted if not all awaitable objects in the *aws* iterable are Future-like objects and there is no running event loop." msgstr "" diff --git a/library/asyncio-threading.po b/library/asyncio-threading.po deleted file mode 100644 index 989c77de1..000000000 --- a/library/asyncio-threading.po +++ /dev/null @@ -1,131 +0,0 @@ -# Persian translations for Python package. -# Copyright (C) 2001 Python Software Foundation -# This file is distributed under the same license as the Python package. -# Automatically generated, 2026. -# -# Translators: -# Sepehr Rasouli , 2026 -# -msgid "" -msgstr "" -"Project-Id-Version: Python 3.14\n" -"Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" -"PO-Revision-Date: 2026-08-25 20:39+0330\n" -"Last-Translator: Automatically generated\n" -"Language-Team: none\n" -"Language: fa\n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=UTF-8\n" -"Content-Transfer-Encoding: 8bit\n" - -msgid "asyncio and free-threaded Python" -msgstr "" - -msgid "asyncio uses an event loop as a scheduler to enable highly efficient concurrency by switching between tasks to allow non-blocking I/O operations. This results in better performance for I/O-bound use cases. It also allows off-loading CPU-bound work to a thread or process pool, but that is still limited by the :term:`global interpreter lock` in CPython." -msgstr "" - -msgid "However, in :ref:`free-threaded Python `, the GIL is disabled and Python can run true multi-threaded code. This means that asyncio can now take advantage of multiple CPU cores without the limitations imposed by the GIL." -msgstr "" - -msgid "Since Python 3.14, asyncio has first-class support for free-threaded Python, and the implementation of asyncio is safe to use in a multi-threaded environment." -msgstr "" - -msgid "A single event loop on one core can handle many connections concurrently, but the Python code that runs to handle each one still executes serially. Once requests involve a non-trivial amount of per-request computation, that handling becomes the bottleneck, and a single core can no longer keep up. Combining asyncio with threads is most useful here: by running an event loop per thread, the handling of different requests can run in parallel across multiple CPU cores. It is also useful when you need to run blocking or CPU-bound code from an asyncio application." -msgstr "" - -msgid "`Scaling asyncio on Free-Threaded Python `__, a blog post by Kumar Aditya which explains the internal changes that make asyncio safe and efficient under free-threaded Python, together with benchmarks of the resulting improvements." -msgstr "" - -msgid "Thread safety considerations" -msgstr "" - -msgid "While asyncio is designed to be thread-safe in a free-threaded Python environment, there are still some considerations to keep in mind when using asyncio with threads:" -msgstr "" - -msgid "**Event loop**: Each thread should have its own event loop which should not be shared across threads. This ensures that the event loop can manage its own tasks and callbacks without interference from other threads." -msgstr "" - -msgid "**Task management**: Tasks and futures created in one thread should not be awaited or manipulated from another thread." -msgstr "" - -msgid "**Thread-safe APIs**: When interacting with asyncio from multiple threads, it's important to use thread-safe APIs provided by asyncio, such as :func:`asyncio.run_coroutine_threadsafe` for submitting coroutines to an event loop from another thread. If you need to call a callback from a different thread, you can use :meth:`loop.call_soon_threadsafe` to schedule it safely." -msgstr "" - -msgid "**Synchronization**: The synchronization primitives provided by asyncio (like :class:`asyncio.Lock` and :class:`asyncio.Event`) are not designed to be used across threads. If you need to synchronize between threads, you should use the synchronization primitives from the :mod:`threading` module instead." -msgstr "" - -msgid "Using asyncio with threads" -msgstr "" - -msgid "asyncio supports running one event loop per thread, which allows you to take advantage of multiple CPU cores in a free-threaded Python environment. Each thread can run its own event loop, and tasks can be scheduled on those loops independently." -msgstr "" - -msgid "Here's an example of how to use asyncio with threads::" -msgstr "" - -msgid "" -"import asyncio\n" -"import threading\n" -"\n" -"async def worker(name: str) -> None:\n" -" print(f\"Worker {name} starting\")\n" -" await asyncio.sleep(1)\n" -" print(f\"Worker {name} done\")\n" -"\n" -"def run_loop(name: str) -> None:\n" -" asyncio.run(worker(name))\n" -"\n" -"threads = [\n" -" threading.Thread(target=run_loop, args=(f\"T{i}\",))\n" -" for i in range(4)\n" -"]\n" -"for t in threads:\n" -" t.start()\n" -"for t in threads:\n" -" t.join()" -msgstr "" - -msgid "In this example, each thread creates its own event loop with :func:`asyncio.run` and runs a coroutine on it. The threads execute concurrently, and in a free-threaded build they can run on separate CPU cores in parallel." -msgstr "" - -msgid "Producer/consumer across threads" -msgstr "" - -msgid "When a regular (non-asyncio) thread needs to hand work to an asyncio event loop running in another thread, use a thread-safe primitive such as :class:`queue.Queue` rather than :class:`asyncio.Queue`, which is only safe within a single event loop.::" -msgstr "" - -msgid "" -"import asyncio\n" -"import queue\n" -"import threading\n" -"\n" -"def producer(q: queue.Queue[int]) -> None:\n" -" for i in range(5):\n" -" print(f\"Producing {i}\")\n" -" q.put(i)\n" -" q.shutdown()\n" -"\n" -"async def consumer(q: queue.Queue[int]) -> None:\n" -" while True:\n" -" try:\n" -" item = q.get_nowait()\n" -" except queue.Empty:\n" -" await asyncio.sleep(0.1)\n" -" continue\n" -" except queue.ShutDown:\n" -" break\n" -" print(f\"Consumed {item}\")\n" -" await asyncio.sleep(item)\n" -"\n" -"q: queue.Queue[int] = queue.Queue()\n" -"consumer_thread = threading.Thread(\n" -" target=lambda: asyncio.run(consumer(q))\n" -")\n" -"consumer_thread.start()\n" -"producer(q)\n" -"consumer_thread.join()" -msgstr "" - -msgid "The producer runs on the main thread while the consumer runs inside an event loop on its own thread, yet they communicate safely through ``queue.Queue``. When the queue is empty the consumer sleeps briefly and tries again. When the producer is done it calls :meth:`~queue.Queue.shutdown`, which causes subsequent :meth:`~queue.Queue.get_nowait` calls to raise :exc:`queue.ShutDown` so the consumer can exit cleanly." -msgstr "" diff --git a/library/asyncio-tools.po b/library/asyncio-tools.po deleted file mode 100644 index 8ab367204..000000000 --- a/library/asyncio-tools.po +++ /dev/null @@ -1,154 +0,0 @@ -# Persian translations for Python package. -# Copyright (C) 2001 Python Software Foundation -# This file is distributed under the same license as the Python package. -# Automatically generated, 2026. -# -# Translators: -# Sepehr Rasouli , 2026 -# -msgid "" -msgstr "" -"Project-Id-Version: Python 3.14\n" -"Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" -"PO-Revision-Date: 2026-08-25 20:39+0330\n" -"Last-Translator: Automatically generated\n" -"Language-Team: none\n" -"Language: fa\n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=UTF-8\n" -"Content-Transfer-Encoding: 8bit\n" - -msgid "Command-line introspection tools" -msgstr "" - -msgid "**Source code:** :source:`Lib/asyncio/tools.py`" -msgstr "" - -msgid "The :mod:`!asyncio` module can be invoked as a script via ``python -m asyncio`` to inspect the task graph of another running Python process without modifying it or restarting it. The :mod:`!asyncio.tools` submodule implements this interface." -msgstr "" - -msgid "The following commands inspect the process identified by ``PID``:" -msgstr "" - -msgid "" -"$ python -m asyncio pstree PID\n" -"$ python -m asyncio ps PID" -msgstr "" - -msgid "The commands read the target process state without executing any code in it. They are only available on supported platforms and may require permission to inspect another process. See the :ref:`permission requirements ` for details." -msgstr "" - -msgid ":ref:`asyncio-graph`" -msgstr "" - -msgid "Programmatic APIs for inspecting the async call graph of a task or future in the current process." -msgstr "" - -msgid "The command examples below use this program, which creates a task hierarchy suitable for inspection and prints its process ID:" -msgstr "" - -msgid "example.py" -msgstr "" - -msgid "" -"import asyncio\n" -"import os\n" -"\n" -"async def play(track):\n" -" await asyncio.sleep(3600)\n" -" print(f\"🎵 Finished: {track}\")\n" -"\n" -"async def album(name, tracks):\n" -" async with asyncio.TaskGroup() as tg:\n" -" for track in tracks:\n" -" tg.create_task(play(track), name=track)\n" -"\n" -"async def main():\n" -" print(f\"PID: {os.getpid()}\")\n" -" async with asyncio.TaskGroup() as tg:\n" -" tg.create_task(\n" -" album(\"Sundowning\", [\"TNDNBTG\", \"Levitate\"]),\n" -" name=\"Sundowning\",\n" -" )\n" -" tg.create_task(\n" -" album(\"TMBTE\", [\"DYWTYLM\", \"Aqua Regia\"]),\n" -" name=\"TMBTE\",\n" -" )\n" -"\n" -"asyncio.run(main())" -msgstr "" - -msgid "Run the program in one terminal and leave it running:" -msgstr "" - -msgid "" -"$ python example.py\n" -"PID: 12345" -msgstr "" - -msgid "Then pass the printed process ID to the commands from another terminal. Thread IDs, task IDs, file paths, and line numbers vary between runs and source layouts." -msgstr "" - -msgid "Command-line options" -msgstr "" - -msgid "Display task and coroutine relationships as a tree. Each task is shown with its full coroutine stack, nested under the task (if any) that is awaiting it. This subcommand is useful for quickly identifying which branch of a task hierarchy is blocked and where in its coroutine stack execution has paused:" -msgstr "" - -msgid "" -"$ python -m asyncio pstree 12345\n" -"└── (T) Task-1\n" -" └── main example.py:12\n" -" └── TaskGroup.__aexit__ Lib/asyncio/taskgroups.py:75\n" -" └── TaskGroup._aexit Lib/asyncio/taskgroups.py:124\n" -" ├── (T) Sundowning\n" -" │ └── album example.py:7\n" -" │ └── TaskGroup.__aexit__ Lib/asyncio/taskgroups.py:75\n" -" │ └── TaskGroup._aexit Lib/asyncio/taskgroups.py:124\n" -" │ ├── (T) TNDNBTG\n" -" │ │ └── play example.py:4\n" -" │ │ └── sleep Lib/asyncio/tasks.py:702\n" -" │ └── (T) Levitate\n" -" │ └── play example.py:4\n" -" │ └── sleep Lib/asyncio/tasks.py:702\n" -" └── (T) TMBTE\n" -" └── album example.py:7\n" -" └── TaskGroup.__aexit__ Lib/asyncio/taskgroups.py:75\n" -" └── TaskGroup._aexit Lib/asyncio/taskgroups.py:124\n" -" ├── (T) DYWTYLM\n" -" │ └── play example.py:4\n" -" │ └── sleep Lib/asyncio/tasks.py:702\n" -" └── (T) Aqua Regia\n" -" └── play example.py:4\n" -" └── sleep Lib/asyncio/tasks.py:702" -msgstr "" - -msgid "If the await graph contains a cycle, ``pstree`` reports an error instead of printing a tree. A cycle in the await graph is unusual and typically indicates a programming error:" -msgstr "" - -msgid "" -"$ python -m asyncio pstree 12345\n" -"ERROR: await-graph contains cycles - cannot print a tree!\n" -"\n" -"cycle: Task-2 → Task-3 → Task-2" -msgstr "" - -msgid "Display a flat table of all pending tasks in the process *PID*. Each row shows the event-loop thread ID, task ID and name, coroutine stack, and the awaiting task's stack, name, and ID, if any." -msgstr "" - -msgid "This subcommand prints all tasks regardless of whether the await graph contains cycles:" -msgstr "" - -msgid "" -"$ python -m asyncio ps 12345\n" -"tid task id task name coroutine stack awaiter chain awaiter name awaiter id\n" -"------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\n" -"18445801 0x10a456060 Task-1 TaskGroup._aexit -> TaskGroup.__aexit__ -> main 0x0\n" -"18445801 0x10a439f60 Sundowning TaskGroup._aexit -> TaskGroup.__aexit__ -> album TaskGroup._aexit -> TaskGroup.__aexit__ -> main Task-1 0x10a456060\n" -"18445801 0x10a439d70 TMBTE TaskGroup._aexit -> TaskGroup.__aexit__ -> album TaskGroup._aexit -> TaskGroup.__aexit__ -> main Task-1 0x10a456060\n" -"18445801 0x10a2a3a80 TNDNBTG sleep -> play TaskGroup._aexit -> TaskGroup.__aexit__ -> album Sundowning 0x10a439f60\n" -"18445801 0x10a2a38a0 Levitate sleep -> play TaskGroup._aexit -> TaskGroup.__aexit__ -> album Sundowning 0x10a439f60\n" -"18445801 0x10a2d7150 DYWTYLM sleep -> play TaskGroup._aexit -> TaskGroup.__aexit__ -> album TMBTE 0x10a439d70\n" -"18445801 0x10a6bdaa0 Aqua Regia sleep -> play TaskGroup._aexit -> TaskGroup.__aexit__ -> album TMBTE 0x10a439d70" -msgstr "" diff --git a/library/asyncio.po b/library/asyncio.po index f94e45de6..eadbf72a0 100644 --- a/library/asyncio.po +++ b/library/asyncio.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:55+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -26,9 +26,6 @@ msgstr "" msgid "High-level APIs" msgstr "" -msgid "Introspection APIs" -msgstr "" - msgid "Low-level APIs" msgstr "" @@ -85,15 +82,6 @@ msgstr "" msgid ":ref:`synchronize ` concurrent code;" msgstr "" -msgid "For **introspection**, asyncio provides APIs and tools for:" -msgstr "" - -msgid "inspecting the :ref:`async call graph ` of tasks and futures;" -msgstr "" - -msgid "inspecting tasks in another running Python process with :ref:`command-line tools `;" -msgstr "" - msgid "Additionally, there are **low-level** APIs for *library and framework developers* to:" msgstr "" diff --git a/library/asyncore.po b/library/asyncore.po index e873e9cbc..e9d3b74d2 100644 --- a/library/asyncore.po +++ b/library/asyncore.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:02+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/atexit.po b/library/atexit.po index 8eb1a6a10..3f2c0e81a 100644 --- a/library/atexit.po +++ b/library/atexit.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/audioop.po b/library/audioop.po index 67ad1a347..b65273f79 100644 --- a/library/audioop.po +++ b/library/audioop.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:02+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/audit_events.po b/library/audit_events.po index 7bd05d393..96b96a8ba 100644 --- a/library/audit_events.po +++ b/library/audit_events.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:55+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/base64.po b/library/base64.po index 9742a6c4d..f52a2c389 100644 --- a/library/base64.po +++ b/library/base64.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:55+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/bdb.po b/library/bdb.po index 45f173c48..7caccea07 100644 --- a/library/bdb.po +++ b/library/bdb.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:55+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/binary.po b/library/binary.po index f69f2b613..7382a3787 100644 --- a/library/binary.po +++ b/library/binary.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/binascii.po b/library/binascii.po index 1e9a2d1c0..54957e73f 100644 --- a/library/binascii.po +++ b/library/binascii.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:56+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/bisect.po b/library/bisect.po index 7c3b2eba0..6a50ae708 100644 --- a/library/bisect.po +++ b/library/bisect.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:56+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -93,7 +93,7 @@ msgstr "" msgid "The *insort()* functions are *O*\\ (*n*) because the logarithmic search step is dominated by the linear time insertion step." msgstr "" -msgid "The search functions are stateless and discard key function results after they are used. Consequently, if the search functions are used in a loop, the key function may be called again and again on the same array elements. If the key function isn't fast, consider wrapping it with :py:deco:`functools.cache` to avoid duplicate computations. Alternatively, consider searching an array of precomputed keys to locate the insertion point (as shown in the examples section below)." +msgid "The search functions are stateless and discard key function results after they are used. Consequently, if the search functions are used in a loop, the key function may be called again and again on the same array elements. If the key function isn't fast, consider wrapping it with :py:func:`functools.cache` to avoid duplicate computations. Alternatively, consider searching an array of precomputed keys to locate the insertion point (as shown in the examples section below)." msgstr "" msgid "`Sorted Collections `_ is a high performance module that uses *bisect* to managed sorted collections of data." diff --git a/library/builtins.po b/library/builtins.po index ee922318d..a5c242493 100644 --- a/library/builtins.po +++ b/library/builtins.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/bz2.po b/library/bz2.po index 8126ee6eb..c39fbed7f 100644 --- a/library/bz2.po +++ b/library/bz2.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:56+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/calendar.po b/library/calendar.po index 92b02504a..3326b85f7 100644 --- a/library/calendar.po +++ b/library/calendar.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:56+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -238,7 +238,7 @@ msgstr "" msgid "Returns the day of the week (``0`` is Monday) for *year* (``1970``--...), *month* (``1``--``12``), *day* (``1``--``31``)." msgstr "" -msgid "Return a header containing abbreviated weekday names. *width* specifies the width in characters for one weekday." +msgid "Return a header containing abbreviated weekday names. *n* specifies the width in characters for one weekday." msgstr "" msgid "Returns weekday of first day of the month and number of days in month, for the specified *year* and *month*." diff --git a/library/cgi.po b/library/cgi.po index a19826a1c..46fc50f4b 100644 --- a/library/cgi.po +++ b/library/cgi.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:02+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/cgitb.po b/library/cgitb.po index 8577e7762..6f93a6236 100644 --- a/library/cgitb.po +++ b/library/cgitb.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:02+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/chunk.po b/library/chunk.po index 960972530..31e3c0147 100644 --- a/library/chunk.po +++ b/library/chunk.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:02+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/cmath.po b/library/cmath.po index 791e98057..634a050e6 100644 --- a/library/cmath.po +++ b/library/cmath.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:56+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/cmd.po b/library/cmd.po index 3b29002fe..225cde8cc 100644 --- a/library/cmd.po +++ b/library/cmd.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/cmdline.po b/library/cmdline.po index 7ec7b3c38..d5f18f8b1 100644 --- a/library/cmdline.po +++ b/library/cmdline.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-17 04:35+0000\n" "PO-Revision-Date: 2023-10-13 14:16+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/cmdlinelibs.po b/library/cmdlinelibs.po index 43d54d0ed..1b44d09ce 100644 --- a/library/cmdlinelibs.po +++ b/library/cmdlinelibs.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-12-27 14:18+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/code.po b/library/code.po index 26301b101..9c0dcc0dd 100644 --- a/library/code.po +++ b/library/code.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/codecs.po b/library/codecs.po index 8a2183b22..1853f6078 100644 --- a/library/codecs.po +++ b/library/codecs.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:56+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -1405,9 +1405,6 @@ msgstr "" msgid "Implement :rfc:`3492`. Stateful codecs are not supported." msgstr "" -msgid "The decoding and encoding algorithms scale poorly, so limit the length of untrusted input." -msgstr "" - msgid "raw_unicode_escape" msgstr "" diff --git a/library/codeop.po b/library/codeop.po index 1fe85747f..699244287 100644 --- a/library/codeop.po +++ b/library/codeop.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/collections.abc.po b/library/collections.abc.po index b6d4b1aa1..316db3fab 100644 --- a/library/collections.abc.po +++ b/library/collections.abc.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:56+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/collections.po b/library/collections.po index 7013800b4..a3540ea30 100644 --- a/library/collections.po +++ b/library/collections.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:56+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -944,7 +944,7 @@ msgid "" " self.move_to_end(key)" msgstr "" -msgid "An :class:`OrderedDict` would also be useful for implementing variants of :deco:`functools.lru_cache`:" +msgid "An :class:`OrderedDict` would also be useful for implementing variants of :func:`functools.lru_cache`:" msgstr "" msgid "" diff --git a/library/colorsys.po b/library/colorsys.po index e57637586..c3bc455c7 100644 --- a/library/colorsys.po +++ b/library/colorsys.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:57+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/compileall.po b/library/compileall.po index 9e3e37220..7c0393850 100644 --- a/library/compileall.po +++ b/library/compileall.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:57+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/compression.po b/library/compression.po index a164bf4ab..a9534e546 100644 --- a/library/compression.po +++ b/library/compression.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/library/compression.zstd.po b/library/compression.zstd.po index b02cc36df..410ef48f9 100644 --- a/library/compression.zstd.po +++ b/library/compression.zstd.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" @@ -316,7 +316,7 @@ msgstr "" msgid "The :meth:`~.bounds` method can be used on any attribute to get the valid values for that parameter." msgstr "" -msgid "Parameters are optional; any omitted parameter will have its value selected automatically." +msgid "Parameters are optional; any omitted parameter will have it's value selected automatically." msgstr "" msgid "Example getting the lower and upper bound of :attr:`~.compression_level`::" @@ -460,7 +460,7 @@ msgstr "" msgid "Each increment halves/doubles the overlap size. \"8\" means an overlap of ``window_size/2``, \"7\" means an overlap of ``window_size/4``, etc." msgstr "" -msgid "An :class:`~enum.IntEnum` containing the advanced decompression parameter keys that can be used when decompressing data. Parameters are optional; any omitted parameter will have its value selected automatically." +msgid "An :class:`~enum.IntEnum` containing the advanced decompression parameter keys that can be used when decompressing data. Parameters are optional; any omitted parameter will have it's value selected automatically." msgstr "" msgid "Example setting the :attr:`~.window_log_max` to the maximum size::" diff --git a/library/concurrency.po b/library/concurrency.po index fdbe3d584..57047b11b 100644 --- a/library/concurrency.po +++ b/library/concurrency.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:57+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/concurrent.futures.po b/library/concurrent.futures.po index b5120e87b..a9cd308cd 100644 --- a/library/concurrent.futures.po +++ b/library/concurrent.futures.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:57+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -275,6 +275,9 @@ msgstr "" msgid "*max_tasks_per_child* is an optional argument that specifies the maximum number of tasks a single process can execute before it will exit and be replaced with a fresh worker process. By default *max_tasks_per_child* is ``None`` which means worker processes will live as long as the pool. When a max is specified, the \"spawn\" multiprocessing start method will be used by default in absence of a *mp_context* parameter. This feature is incompatible with the \"fork\" start method." msgstr "" +msgid "Bugs have been reported when using the *max_tasks_per_child* feature that can result in the :class:`ProcessPoolExecutor` hanging in some circumstances. Follow its eventual resolution in :gh:`115634`." +msgstr "" + msgid "When one of the worker processes terminates abruptly, a :exc:`~concurrent.futures.process.BrokenProcessPool` error is now raised. Previously, behaviour was undefined but operations on the executor or its futures would often freeze or deadlock." msgstr "" @@ -293,9 +296,6 @@ msgstr "" msgid "The default process start method (see :ref:`multiprocessing-start-methods`) changed away from *fork*. If you require the *fork* start method for :class:`ProcessPoolExecutor` you must explicitly pass ``mp_context=multiprocessing.get_context(\"fork\")``." msgstr "" -msgid "Fixed a deadlock (:gh:`115634`) where the executor could hang after a worker process exited upon reaching its *max_tasks_per_child* limit while tasks remained queued." -msgstr "" - msgid "Attempt to terminate all living worker processes immediately by calling :meth:`Process.terminate ` on each of them. Internally, it will also call :meth:`Executor.shutdown` to ensure that all other resources associated with the executor are freed." msgstr "" diff --git a/library/concurrent.interpreters.po b/library/concurrent.interpreters.po index 0708e6b92..b684d1e7e 100644 --- a/library/concurrent.interpreters.po +++ b/library/concurrent.interpreters.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" @@ -31,7 +31,7 @@ msgstr "" msgid "The module is primarily meant to provide a basic API for managing interpreters (AKA \"subinterpreters\") and running things in them. Running mostly involves switching to an interpreter (in the current thread) and calling a function in that execution context." msgstr "" -msgid "For concurrency, interpreters themselves (and this module) don't provide much more than isolation, which on its own isn't useful. Actual concurrency is available separately through :mod:`threads ` -- see `below `_." +msgid "For concurrency, interpreters themselves (and this module) don't provide much more than isolation, which on its own isn't useful. Actual concurrency is available separately through :mod:`threads ` See `below `_" msgstr "" msgid ":class:`~concurrent.futures.InterpreterPoolExecutor`" diff --git a/library/concurrent.po b/library/concurrent.po index 201fcca22..fb5efeaba 100644 --- a/library/concurrent.po +++ b/library/concurrent.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:57+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/configparser.po b/library/configparser.po index 3d18e8bf8..f6a6b82ff 100644 --- a/library/configparser.po +++ b/library/configparser.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:57+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/constants.po b/library/constants.po index 96d117c47..56e064b92 100644 --- a/library/constants.po +++ b/library/constants.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:57+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/contextlib.po b/library/contextlib.po index 190031451..b4ad7685c 100644 --- a/library/contextlib.po +++ b/library/contextlib.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:57+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -83,13 +83,13 @@ msgstr "" msgid "At the point where the generator yields, the block nested in the :keyword:`with` statement is executed. The generator is then resumed after the block is exited. If an unhandled exception occurs in the block, it is reraised inside the generator at the point where the yield occurred. Thus, you can use a :keyword:`try`...\\ :keyword:`except`...\\ :keyword:`finally` statement to trap the error (if any), or ensure that some cleanup takes place. If an exception is trapped merely in order to log it or to perform some action (rather than to suppress it entirely), the generator must reraise that exception. Otherwise the generator context manager will indicate to the :keyword:`!with` statement that the exception has been handled, and execution will resume with the statement immediately following the :keyword:`!with` statement." msgstr "" -msgid ":deco:`contextmanager` uses :class:`ContextDecorator` so the context managers it creates can be used as decorators as well as in :keyword:`with` statements. When used as a decorator, a new generator instance is implicitly created on each function call (this allows the otherwise \"one-shot\" context managers created by :deco:`contextmanager` to meet the requirement that context managers support multiple invocations in order to be used as decorators)." +msgid ":func:`contextmanager` uses :class:`ContextDecorator` so the context managers it creates can be used as decorators as well as in :keyword:`with` statements. When used as a decorator, a new generator instance is implicitly created on each function call (this allows the otherwise \"one-shot\" context managers created by :func:`contextmanager` to meet the requirement that context managers support multiple invocations in order to be used as decorators)." msgstr "" msgid "Use of :class:`ContextDecorator`." msgstr "" -msgid "Similar to :deco:`~contextlib.contextmanager`, but creates an :ref:`asynchronous context manager `." +msgid "Similar to :func:`~contextlib.contextmanager`, but creates an :ref:`asynchronous context manager `." msgstr "" msgid "This function is a :term:`decorator` that can be used to define a factory function for :keyword:`async with` statement asynchronous context managers, without needing to create a class or separate :meth:`~object.__aenter__` and :meth:`~object.__aexit__` methods. It must be applied to an :term:`asynchronous generator` function." @@ -114,7 +114,7 @@ msgid "" " return conn.query('SELECT ...')" msgstr "" -msgid "Context managers defined with :deco:`asynccontextmanager` can be used either as decorators or with :keyword:`async with` statements::" +msgid "Context managers defined with :func:`asynccontextmanager` can be used either as decorators or with :keyword:`async with` statements::" msgstr "" msgid "" @@ -134,10 +134,10 @@ msgid "" " # ... async code ..." msgstr "" -msgid "When used as a decorator, a new generator instance is implicitly created on each function call. This allows the otherwise \"one-shot\" context managers created by :deco:`asynccontextmanager` to meet the requirement that context managers support multiple invocations in order to be used as decorators." +msgid "When used as a decorator, a new generator instance is implicitly created on each function call. This allows the otherwise \"one-shot\" context managers created by :func:`asynccontextmanager` to meet the requirement that context managers support multiple invocations in order to be used as decorators." msgstr "" -msgid "Async context managers created with :deco:`asynccontextmanager` can be used as decorators." +msgid "Async context managers created with :func:`asynccontextmanager` can be used as decorators." msgstr "" msgid "Return a context manager that closes *thing* upon completion of the block. This is basically equivalent to::" @@ -344,7 +344,7 @@ msgstr "" msgid "Context managers inheriting from ``ContextDecorator`` have to implement :meth:`~object.__enter__` and :meth:`~object.__exit__` as normal. ``__exit__`` retains its optional exception handling even when used as a decorator." msgstr "" -msgid "``ContextDecorator`` is used by :deco:`contextmanager`, so you get this functionality automatically." +msgid "``ContextDecorator`` is used by :func:`contextmanager`, so you get this functionality automatically." msgstr "" msgid "Example of ``ContextDecorator``::" @@ -565,7 +565,7 @@ msgstr "" msgid "Similar to :meth:`ExitStack.close` but properly handles awaitables." msgstr "" -msgid "Continuing the example for :deco:`asynccontextmanager`::" +msgid "Continuing the example for :func:`asynccontextmanager`::" msgstr "" msgid "" @@ -807,7 +807,7 @@ msgstr "" msgid "Files are an example of effectively single use context managers, since the first :keyword:`with` statement will close the file, preventing any further IO operations using that file object." msgstr "" -msgid "Context managers created using :deco:`contextmanager` are also single use context managers, and will complain about the underlying generator failing to yield if an attempt is made to use them a second time::" +msgid "Context managers created using :func:`contextmanager` are also single use context managers, and will complain about the underlying generator failing to yield if an attempt is made to use them a second time::" msgstr "" msgid "" diff --git a/library/contextvars.po b/library/contextvars.po index c7452ab9e..a5261a5c7 100644 --- a/library/contextvars.po +++ b/library/contextvars.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 00:57+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/copy.po b/library/copy.po index 738ac71f3..987fd692b 100644 --- a/library/copy.po +++ b/library/copy.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:03+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/copyreg.po b/library/copyreg.po index 9945c9dc8..b8c95f98c 100644 --- a/library/copyreg.po +++ b/library/copyreg.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:03+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/crypt.po b/library/crypt.po index a37fdd4cf..cb2567216 100644 --- a/library/crypt.po +++ b/library/crypt.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:02+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/crypto.po b/library/crypto.po index de381ace3..93048df0a 100644 --- a/library/crypto.po +++ b/library/crypto.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:03+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/csv.po b/library/csv.po index 42eb05dc2..9c38ae8e6 100644 --- a/library/csv.po +++ b/library/csv.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:03+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -70,14 +70,6 @@ msgid "" "Spam, Lovely Spam, Wonderful Spam" msgstr "" -msgid "where :file:`eggs.csv` contains:" -msgstr "" - -msgid "" -"Spam Spam Spam Spam Spam |Baked Beans|\n" -"Spam |Lovely Spam| |Wonderful Spam|" -msgstr "" - msgid "Return a writer object responsible for converting the user's data into delimited strings on the given file-like object. *csvfile* can be any object with a :meth:`~io.TextIOBase.write` method. If *csvfile* is a file object, it should be opened with ``newline=''`` [1]_. An optional *dialect* parameter can be given which is used to define a set of parameters specific to a particular CSV dialect. It may be an instance of a subclass of the :class:`Dialect` class or one of the strings returned by the :func:`list_dialects` function. The other optional *fmtparams* keyword arguments can be given to override individual formatting parameters in the current dialect. For full details about dialects and formatting parameters, see the :ref:`csv-fmt-params` section. To make it as easy as possible to interface with modules which implement the DB API, the value :const:`None` is written as the empty string. While this isn't a reversible transformation, it makes it easier to dump SQL NULL data values to CSV files without preprocessing the data returned from a ``cursor.fetch*`` call. All other non-string data are stringified with :func:`str` before being written." msgstr "" @@ -90,9 +82,6 @@ msgid "" " spamwriter.writerow(['Spam', 'Lovely Spam', 'Wonderful Spam'])" msgstr "" -msgid "which writes :file:`eggs.csv` containing:" -msgstr "" - msgid "Associate *dialect* with *name*. *name* must be a string. The dialect can be specified either by passing a sub-class of :class:`Dialect`, or by *fmtparams* keyword arguments, or both, with keyword arguments overriding parameters of the dialect. For full details about dialects and formatting parameters, see section :ref:`csv-fmt-params`." msgstr "" @@ -146,15 +135,6 @@ msgid "" "{'first_name': 'John', 'last_name': 'Cleese'}" msgstr "" -msgid "where :file:`names.csv` contains:" -msgstr "" - -msgid "" -"first_name,last_name\n" -"Eric,Idle\n" -"John,Cleese" -msgstr "" - msgid "Create an object which operates like a regular writer but maps dictionaries onto output rows. The *fieldnames* parameter is a :mod:`sequence ` of keys that identify the order in which values in the dictionary passed to the :meth:`~csvwriter.writerow` method are written to file *f*. The optional *restval* parameter specifies the value to be written if the dictionary is missing a key in *fieldnames*. If the dictionary passed to the :meth:`~csvwriter.writerow` method contains a key not found in *fieldnames*, the optional *extrasaction* parameter indicates what action to take. If it is set to ``'raise'``, the default value, a :exc:`ValueError` is raised. If it is set to ``'ignore'``, extra values in the dictionary are ignored. Any other optional or keyword arguments are passed to the underlying :class:`writer` instance." msgstr "" @@ -174,16 +154,6 @@ msgid "" " writer.writerow({'first_name': 'Wonderful', 'last_name': 'Spam'})" msgstr "" -msgid "which writes :file:`names.csv` containing:" -msgstr "" - -msgid "" -"first_name,last_name\n" -"Baked,Beans\n" -"Lovely,Spam\n" -"Wonderful,Spam" -msgstr "" - msgid "The :class:`Dialect` class is a container class whose attributes contain information for how to handle doublequotes, whitespace, delimiters, etc. Due to the lack of a strict CSV specification, different applications produce subtly different CSV data. :class:`Dialect` instances define how :class:`reader` and :class:`writer` instances behave." msgstr "" @@ -215,9 +185,6 @@ msgstr "" msgid "Analyze the given *sample* and return a :class:`Dialect` subclass reflecting the parameters found. If the optional *delimiters* parameter is given, it is interpreted as a string containing possible valid delimiter characters." msgstr "" -msgid "If several delimiters fit the sample equally well --- for example if both ``','`` and ``';'`` split every row consistently --- the delimiters ``','``, ``'\\t'``, ``';'``, ``' '`` and ``':'`` are preferred, in this order, no matter how many times each of them occurs." -msgstr "" - msgid "Analyze the sample text (presumed to be in CSV format) and return :const:`True` if the first row appears to be a series of column headers. Inspecting each column, one of two key criteria will be considered to estimate if the sample contains a header:" msgstr "" diff --git a/library/ctypes.po b/library/ctypes.po index f1a3ffbf5..6dabd4b32 100644 --- a/library/ctypes.po +++ b/library/ctypes.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:03+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -701,7 +701,7 @@ msgid "" ">>>" msgstr "" -msgid "If you don't want to store the instance's data in the :attr:`!_as_parameter_` instance variable, you could define a :deco:`property` which makes the attribute available on request." +msgid "If you don't want to store the instance's data in the :attr:`!_as_parameter_` instance variable, you could define a :class:`property` which makes the attribute available on request." msgstr "" msgid "Specifying the required argument types (function prototypes)" @@ -2657,7 +2657,7 @@ msgstr "" msgid "Create an array. Equivalent to ``type * length``, where *type* is a :mod:`!ctypes` data type and *length* an integer." msgstr "" -msgid "In favor of multiplication." +msgid "This function is :term:`soft deprecated` in favor of multiplication. There are no plans to remove it." msgstr "" msgid "Private, abstract base class for pointers." diff --git a/library/curses.ascii.po b/library/curses.ascii.po index a74f5634d..94a93cb54 100644 --- a/library/curses.ascii.po +++ b/library/curses.ascii.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:03+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -159,7 +159,7 @@ msgstr "" msgid "Checks for a character value that fits in the 7-bit ASCII set." msgstr "" -msgid "Checks for an ASCII blank character; space or horizontal tab." +msgid "Checks for an ASCII whitespace character; space or horizontal tab." msgstr "" msgid "Checks for an ASCII control character (in the range 0x00 to 0x1f or 0x7f)." @@ -168,7 +168,7 @@ msgstr "" msgid "Checks for an ASCII decimal digit, ``'0'`` through ``'9'``. This is equivalent to ``c in string.digits``." msgstr "" -msgid "Checks for any ASCII printable character except space." +msgid "Checks for ASCII any printable character except space." msgstr "" msgid "Checks for an ASCII lower-case character." @@ -177,7 +177,7 @@ msgstr "" msgid "Checks for any ASCII printable character including space." msgstr "" -msgid "Checks for any ASCII printable character which is not a space or an alphanumeric character." +msgid "Checks for any printable ASCII character which is not a space or an alphanumeric character." msgstr "" msgid "Checks for ASCII white-space characters; space, line feed, carriage return, form feed, horizontal tab, vertical tab." @@ -189,7 +189,7 @@ msgstr "" msgid "Checks for an ASCII hexadecimal digit. This is equivalent to ``c in string.hexdigits``." msgstr "" -msgid "Checks for an ASCII control character (ordinal values 0 to 31). Unlike :func:`iscntrl`, this does not include the delete character (0x7f)." +msgid "Checks for an ASCII control character (ordinal values 0 to 31)." msgstr "" msgid "Checks for a non-ASCII character (ordinal values 0x80 and above)." diff --git a/library/curses.panel.po b/library/curses.panel.po index 794273592..a42ab95bc 100644 --- a/library/curses.panel.po +++ b/library/curses.panel.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:03+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -32,19 +32,13 @@ msgstr "" msgid "Functions" msgstr "" -msgid "The module :mod:`!curses.panel` defines the following exception:" -msgstr "" - -msgid "Exception raised when a curses panel library function returns an error." -msgstr "" - msgid "The module :mod:`!curses.panel` defines the following functions:" msgstr "" msgid "Returns the bottom panel in the panel stack." msgstr "" -msgid "Returns a panel object, associating it with the given window *win* and placing the new panel on top of the panel stack. Be aware that you need to keep the returned panel object referenced explicitly. If you don't, the panel object is garbage collected and removed from the panel stack." +msgid "Returns a panel object, associating it with the given window *win*. Be aware that you need to keep the returned panel object referenced explicitly. If you don't, the panel object is garbage collected and removed from the panel stack." msgstr "" msgid "Returns the top panel in the panel stack." @@ -53,10 +47,10 @@ msgstr "" msgid "Updates the virtual screen after changes in the panel stack. This does not call :func:`curses.doupdate`, so you'll have to do this yourself." msgstr "" -msgid "Panel objects" +msgid "Panel Objects" msgstr "" -msgid "Panel objects, as returned by :func:`new_panel` above, are windows with a stacking order. There's always a window associated with a panel which determines the content, while the panel methods are responsible for the window's depth in the panel stack." +msgid "Panel objects, as returned by :func:`new_panel` above, are windows with a stacking order. There's always a window associated with a panel which determines the content, while the panel methods are responsible for the window's depth in the panel stack." msgstr "" msgid "Panel objects have the following methods:" @@ -86,7 +80,7 @@ msgstr "" msgid "Set the panel's user pointer to *obj*. This is used to associate an arbitrary piece of data with the panel, and can be any Python object." msgstr "" -msgid "Display the panel (which might have been hidden), placing it on top of the panel stack." +msgid "Display the panel (which might have been hidden)." msgstr "" msgid "Push panel to the top of the stack." diff --git a/library/curses.po b/library/curses.po index bf434aae2..141faaa9e 100644 --- a/library/curses.po +++ b/library/curses.po @@ -15,10 +15,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:03+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -100,9 +100,6 @@ msgstr "" msgid "Change the definition of the color-pair ``0`` to ``(fg, bg)``." msgstr "" -msgid "This is an ncurses extension." -msgstr "" - msgid "Return the output speed of the terminal in bits per second. On software terminal emulators it will have a fixed high value. Included for historical reasons; in former times, it was used to write output loops for time delays and occasionally to change interfaces depending on the line speed." msgstr "" @@ -115,7 +112,7 @@ msgstr "" msgid "Enter cbreak mode. In cbreak mode (sometimes called \"rare\" mode) normal tty line buffering is turned off and characters are available to be read one by one. However, unlike raw mode, special characters (interrupt, quit, suspend, and flow control) retain their effects on the tty driver and calling program. Calling first :func:`raw` then :func:`cbreak` leaves the terminal in cbreak mode." msgstr "" -msgid "Return the intensity of the red, green, and blue (RGB) components in the color *color_number*, which must be between ``0`` and ``COLORS - 1``. Return a 3-tuple, containing the R,G,B values for the given color, which will be between ``0`` (no component) and ``1000`` (maximum amount of component). Raise an exception if the color is not supported." +msgid "Return the intensity of the red, green, and blue (RGB) components in the color *color_number*, which must be between ``0`` and ``COLORS - 1``. Return a 3-tuple, containing the R,G,B values for the given color, which will be between ``0`` (no component) and ``1000`` (maximum amount of component)." msgstr "" msgid "Return the attribute value for displaying text in the specified color pair. Only the first 256 color pairs are supported. This attribute value can be combined with :const:`A_STANDOUT`, :const:`A_REVERSE`, and the other :const:`!A_\\*` attributes. :func:`pair_number` is the counterpart to this function." @@ -133,7 +130,7 @@ msgstr "" msgid "Insert an *ms* millisecond pause in output." msgstr "" -msgid "Update the physical screen. The curses library keeps two data structures, one representing the current physical screen contents and a virtual screen representing the desired next state. The :func:`doupdate` function updates the physical screen to match the virtual screen." +msgid "Update the physical screen. The curses library keeps two data structures, one representing the current physical screen contents and a virtual screen representing the desired next state. The :func:`doupdate` ground updates the physical screen to match the virtual screen." msgstr "" msgid "The virtual screen may be updated by a :meth:`~window.noutrefresh` call after write operations such as :meth:`~window.addstr` have been performed on a window. The normal :meth:`~window.refresh` call is simply :meth:`!noutrefresh` followed by :func:`!doupdate`; if you have to update multiple windows, you can speed performance and perhaps reduce screen flicker by issuing :meth:`!noutrefresh` calls on all windows, followed by a single :func:`!doupdate`." @@ -148,7 +145,7 @@ msgstr "" msgid "Return the user's current erase character as a one-byte bytes object. Under Unix operating systems this is a property of the controlling tty of the curses program, and is not set by the curses library itself." msgstr "" -msgid "The :func:`.filter` routine, if used, must be called before :func:`initscr` is called. The effect is that, during the initialization, :envvar:`LINES` is set to ``1``; the capabilities ``clear``, ``cup``, ``cud``, ``cud1``, ``cuu1``, ``cuu``, ``vpa`` are disabled; and the ``home`` string is set to the value of ``cr``. The effect is that the cursor is confined to the current line, and so are screen updates. This may be used for enabling character-at-a-time line editing without touching the rest of the screen." +msgid "The :func:`.filter` routine, if used, must be called before :func:`initscr` is called. The effect is that, during those calls, :envvar:`LINES` is set to ``1``; the capabilities ``clear``, ``cup``, ``cud``, ``cud1``, ``cuu1``, ``cuu``, ``vpa`` are disabled; and the ``home`` string is set to the value of ``cr``. The effect is that the cursor is confined to the current line, and so are screen updates. This may be used for enabling character-at-a-time line editing without touching the rest of the screen." msgstr "" msgid "Flash the screen. That is, change it to reverse-video and then change it back in a short interval. Some people prefer such as 'visible bell' to the audible attention signal produced by :func:`beep`." @@ -166,13 +163,13 @@ msgstr "" msgid "Return the current coordinates of the virtual screen cursor as a tuple ``(y, x)``. If :meth:`leaveok ` is currently ``True``, then return ``(-1, -1)``." msgstr "" -msgid "Read window-related data stored in the file by an earlier :meth:`window.putwin` call. The routine then creates and initializes a new window using that data, returning the new window object. The *file* argument must be a file object opened for reading in binary mode." +msgid "Read window related data stored in the file by an earlier :func:`window.putwin` call. The routine then creates and initializes a new window using that data, returning the new window object." msgstr "" msgid "Return ``True`` if the terminal can display colors; otherwise, return ``False``." msgstr "" -msgid "Return ``True`` if the module supports extended colors; otherwise, return ``False``. Extended color support allows more than 256 color pairs for terminals that support more than 16 colors (for example, xterm-256color)." +msgid "Return ``True`` if the module supports extended colors; otherwise, return ``False``. Extended color support allows more than 256 color pairs for terminals that support more than 16 colors (e.g. xterm-256color)." msgstr "" msgid "Extended color support requires ncurses version 6.1 or later." @@ -199,15 +196,9 @@ msgstr "" msgid "Initialize the library. Return a :ref:`window ` object which represents the whole screen." msgstr "" -msgid "See :func:`setupterm` for a caveat about calling it before this function." -msgstr "" - msgid "If there is an error opening the terminal, the underlying curses library may cause the interpreter to exit." msgstr "" -msgid "If *flag* is ``True``, pressing an interrupt key (interrupt, break, or quit) will flush all output in the terminal driver queue. If *flag* is ``False``, no flushing is done." -msgstr "" - msgid "Return ``True`` if :func:`resize_term` would modify the window structure, ``False`` otherwise." msgstr "" @@ -217,9 +208,6 @@ msgstr "" msgid "Return the name of the key numbered *k* as a bytes object. The name of a key generating printable ASCII character is the key's character. The name of a control-key combination is a two-byte bytes object consisting of a caret (``b'^'``) followed by the corresponding printable ASCII character. The name of an alt-key combination (128--255) is a bytes object consisting of the prefix ``b'M-'`` followed by the name of the corresponding ASCII character." msgstr "" -msgid "Raise a :exc:`ValueError` if *k* is negative." -msgstr "" - msgid "Return the user's current line kill character as a one-byte bytes object. Under Unix operating systems this is a property of the controlling tty of the curses program, and is not set by the curses library itself." msgstr "" @@ -229,10 +217,10 @@ msgstr "" msgid "If *flag* is ``True``, allow 8-bit characters to be input. If *flag* is ``False``, allow only 7-bit chars." msgstr "" -msgid "Set the maximum time in milliseconds that can elapse between press and release events in order for them to be recognized as a click, and return the previous interval value. The default value is 166 milliseconds, or one sixth of a second. Use a negative *interval* to obtain the interval value without changing it." +msgid "Set the maximum time in milliseconds that can elapse between press and release events in order for them to be recognized as a click, and return the previous interval value. The default value is 200 milliseconds, or one fifth of a second." msgstr "" -msgid "Set the mouse events to be reported, and return a tuple ``(availmask, oldmask)``. *availmask* indicates which of the specified mouse events can be reported; on complete failure it returns ``0``. *oldmask* is the previous value of the mouse event mask. If this function is never called, no mouse events are ever reported." +msgid "Set the mouse events to be reported, and return a tuple ``(availmask, oldmask)``. *availmask* indicates which of the specified mouse events can be reported; on complete failure it returns ``0``. *oldmask* is the previous value of the given window's mouse event mask. If this function is never called, no mouse events are ever reported." msgstr "" msgid "Sleep for *ms* milliseconds." @@ -241,7 +229,7 @@ msgstr "" msgid "Create and return a pointer to a new pad data structure with the given number of lines and columns. Return a pad as a window object." msgstr "" -msgid "A pad is like a window, except that it is not restricted by the screen size, and is not necessarily associated with a particular part of the screen. Pads can be used when a large window is needed, and only a part of the window will be on the screen at one time. Automatic refreshes of pads (such as from scrolling or echoing of input) do not occur. The :meth:`~window.refresh` and :meth:`~window.noutrefresh` methods of a pad require 6 arguments to specify the part of the pad to be displayed and the location on the screen to be used for the display. The arguments are *pminrow*, *pmincol*, *sminrow*, *smincol*, *smaxrow*, *smaxcol*; the *p* arguments refer to the upper-left corner of the pad region to be displayed and the *s* arguments define a clipping box on the screen within which the pad region is to be displayed." +msgid "A pad is like a window, except that it is not restricted by the screen size, and is not necessarily associated with a particular part of the screen. Pads can be used when a large window is needed, and only a part of the window will be on the screen at one time. Automatic refreshes of pads (such as from scrolling or echoing of input) do not occur. The :meth:`~window.refresh` and :meth:`~window.noutrefresh` methods of a pad require 6 arguments to specify the part of the pad to be displayed and the location on the screen to be used for the display. The arguments are *pminrow*, *pmincol*, *sminrow*, *smincol*, *smaxrow*, *smaxcol*; the *p* arguments refer to the upper left corner of the pad region to be displayed and the *s* arguments define a clipping box on the screen within which the pad region is to be displayed." msgstr "" msgid "Return a new :ref:`window `, whose left-upper corner is at ``(begin_y, begin_x)``, and whose height/width is *nlines*/*ncols*." @@ -253,9 +241,6 @@ msgstr "" msgid "Enter newline mode. This mode translates the return key into newline on input, and translates newline into return and line-feed on output. Newline mode is initially on." msgstr "" -msgid "If *flag* is ``False``, the effect is the same as calling :func:`nonl`." -msgstr "" - msgid "Leave cbreak mode. Return to normal \"cooked\" mode with line buffering." msgstr "" @@ -280,9 +265,6 @@ msgstr "" msgid "Equivalent to ``tputs(str, 1, putchar)``; emit the value of a specified terminfo capability for the current terminal. Note that the output of :func:`putp` always goes to standard output." msgstr "" -msgid ":func:`setupterm` (or :func:`initscr`) must be called first." -msgstr "" - msgid "If *flag* is ``False``, the effect is the same as calling :func:`noqiflush`. If *flag* is ``True``, or no argument is provided, the queues will be flushed when these control characters are read." msgstr "" @@ -325,12 +307,6 @@ msgstr "" msgid "Initialize the terminal. *term* is a string giving the terminal name, or ``None``; if omitted or ``None``, the value of the :envvar:`TERM` environment variable will be used. *fd* is the file descriptor to which any initialization sequences will be sent; if not supplied or ``-1``, the file descriptor for ``sys.stdout`` will be used." msgstr "" -msgid "Raise a :exc:`curses.error` if the terminal could not be found or its terminfo database entry could not be read. If the terminal has already been initialized, this function has no effect." -msgstr "" - -msgid "Calling :func:`initscr` after :func:`setupterm` leaks the terminal that :func:`setupterm` allocated: the curses library keeps only a single current terminal and does not free the previously allocated one." -msgstr "" - msgid "Must be called if the programmer wants to use colors, and before any other color manipulation routine is called. It is good practice to call this routine right after :func:`initscr`." msgstr "" @@ -352,7 +328,7 @@ msgstr "" msgid "Return the value of the string capability corresponding to the terminfo capability name *capname* as a bytes object. Return ``None`` if *capname* is not a terminfo \"string capability\", or is canceled or absent from the terminal description." msgstr "" -msgid "Instantiate the bytes object *str* with the supplied parameters, where *str* should be a parameterized string obtained from the terminfo database. For example, ``tparm(tigetstr(\"cup\"), 5, 3)`` could result in ``b'\\033[6;4H'``, the exact result depending on terminal type. Up to nine integer parameters may be supplied." +msgid "Instantiate the bytes object *str* with the supplied parameters, where *str* should be a parameterized string obtained from the terminfo database. E.g. ``tparm(tigetstr(\"cup\"), 5, 3)`` could result in ``b'\\033[6;4H'``, the exact result depending on terminal type." msgstr "" msgid "Specify that the file descriptor *fd* be used for typeahead checking. If *fd* is ``-1``, then no typeahead checking is done." @@ -391,7 +367,7 @@ msgstr "" msgid "Initialize curses and call another callable object, *func*, which should be the rest of your curses-using application. If the application raises an exception, this function will restore the terminal to a sane state before re-raising the exception and generating a traceback. The callable object *func* is then passed the main window 'stdscr' as its first argument, followed by any other arguments passed to :func:`!wrapper`. Before calling *func*, :func:`!wrapper` turns on cbreak mode, turns off echo, enables the terminal keypad, and initializes colors if the terminal has color support. On exit (whether normally or by exception) it restores cooked mode, turns on echo, and disables the terminal keypad." msgstr "" -msgid "Window objects" +msgid "Window Objects" msgstr "" msgid "Window objects, as returned by :func:`initscr` and :func:`newwin` above, have the following methods and attributes:" @@ -400,7 +376,7 @@ msgstr "" msgid "Paint character *ch* at ``(y, x)`` with attributes *attr*, overwriting any character previously painted at that location. By default, the character position and attributes are the current settings for the window object." msgstr "" -msgid "Writing outside the window, subwindow, or pad raises a :exc:`curses.error`. Attempting to write to the lower-right corner of a window, subwindow, or pad will cause an exception to be raised after the character is printed." +msgid "Writing outside the window, subwindow, or pad raises a :exc:`curses.error`. Attempting to write to the lower right corner of a window, subwindow, or pad will cause an exception to be raised after the character is printed." msgstr "" msgid "Paint at most *n* characters of the character string *str* at ``(y, x)`` with attributes *attr*, overwriting anything previously on the display." @@ -409,10 +385,10 @@ msgstr "" msgid "Paint the character string *str* at ``(y, x)`` with attributes *attr*, overwriting anything previously on the display." msgstr "" -msgid "Writing outside the window, subwindow, or pad raises :exc:`curses.error`. Attempting to write to the lower-right corner of a window, subwindow, or pad will cause an exception to be raised after the string is printed." +msgid "Writing outside the window, subwindow, or pad raises :exc:`curses.error`. Attempting to write to the lower right corner of a window, subwindow, or pad will cause an exception to be raised after the string is printed." msgstr "" -msgid "A bug in ncurses, the backend for this Python module, could cause segfaults when resizing windows. This was fixed in ncurses-6.1-20190511. If you are stuck with an earlier ncurses, you can avoid triggering it by not calling :meth:`!addstr` with a *str* that has embedded newlines; instead, call :meth:`!addstr` separately for each line." +msgid "A `bug in ncurses `_, the backend for this Python module, can cause SegFaults when resizing windows. This is fixed in ncurses-6.1-20190511. If you are stuck with an earlier ncurses, you can avoid triggering this if you do not call :func:`addstr` with a *str* that has embedded newlines. Instead, call :func:`addstr` separately for each line." msgstr "" msgid "Remove attribute *attr* from the \"background\" set applied to all writes to the current window." @@ -538,7 +514,7 @@ msgstr "" msgid "Update the current cursor position of all the ancestors of the window to reflect the current cursor position of the window." msgstr "" -msgid "Delete the character under the cursor, or at ``(y, x)`` if specified. All characters to the right on the same line are shifted one position left." +msgid "Delete any character at ``(y, x)``." msgstr "" msgid "Delete the line under the cursor. All following lines are moved up by one line." @@ -565,7 +541,7 @@ msgstr "" msgid "Return a tuple ``(y, x)`` of coordinates of upper-left corner." msgstr "" -msgid "Return the given window's current background character/attribute pair. Its components can be extracted like those of :meth:`inch`." +msgid "Return the given window's current background character/attribute pair." msgstr "" msgid "Get a character. Note that the integer returned does *not* have to be in ASCII range: function keys, keypad keys and so on are represented by numbers higher than 255. In no-delay mode, return ``-1`` if there is no input, otherwise wait until a key is pressed." @@ -583,7 +559,7 @@ msgstr "" msgid "Return the beginning coordinates of this window relative to its parent window as a tuple ``(y, x)``. Return ``(-1, -1)`` if this window has no parent." msgstr "" -msgid "Read a bytes object from the user, with primitive line editing capacity. At most *n* characters are read; *n* defaults to and cannot exceed 2047." +msgid "Read a bytes object from the user, with primitive line editing capacity. The maximum value for *n* is 2047." msgstr "" msgid "The maximum value for *n* was increased from 1023 to 2047." @@ -592,22 +568,22 @@ msgstr "" msgid "Return a tuple ``(y, x)`` of current cursor position relative to the window's upper-left corner." msgstr "" -msgid "Display a horizontal line starting at ``(y, x)`` with length *n* consisting of the character *ch* with attributes *attr*. The line stops at the right edge of the window if fewer than *n* cells are available." +msgid "Display a horizontal line starting at ``(y, x)`` with length *n* consisting of the character *ch*." msgstr "" msgid "If *flag* is ``False``, curses no longer considers using the hardware insert/delete character feature of the terminal; if *flag* is ``True``, use of character insertion and deletion is enabled. When curses is first initialized, use of character insert/delete is enabled by default." msgstr "" -msgid "If *flag* is ``True``, :mod:`!curses` will try to use hardware line editing facilities. Otherwise, curses will not use them." +msgid "If *flag* is ``True``, :mod:`!curses` will try and use hardware line editing facilities. Otherwise, line insertion/deletion are disabled." msgstr "" msgid "If *flag* is ``True``, any change in the window image automatically causes the window to be refreshed; you no longer have to call :meth:`refresh` yourself. However, it may degrade performance considerably, due to repeated calls to wrefresh. This option is disabled by default." msgstr "" -msgid "Return the character at the given position in the window. The bottom 8 bits are the character proper and the upper bits are the attributes; extract them with the :data:`A_CHARTEXT` and :data:`A_ATTRIBUTES` bit-masks, and the color pair with :func:`pair_number`. The character byte is the locale-encoded byte of the cell's character, consistent with :meth:`instr`. On a wide-character build, a character that does not fit in a single byte in the current locale has a character byte of ``0``; use :meth:`instr` to read such characters." +msgid "Return the character at the given position in the window. The bottom 8 bits are the character proper, and upper bits are the attributes." msgstr "" -msgid "Insert character *ch* with attributes *attr* before the character under the cursor, or at ``(y, x)`` if specified. All characters to the right of the cursor are shifted one position right, with the rightmost character on the line being lost. The cursor position does not change." +msgid "Paint character *ch* at ``(y, x)`` with attributes *attr*, moving the line from position *x* right by one character." msgstr "" msgid "Insert *nlines* lines into the specified window above the current line. The *nlines* bottom lines are lost. For negative *nlines*, delete *nlines* lines starting with the one under the cursor, and move the remaining lines up. The bottom *nlines* lines are cleared. The current cursor position remains the same." @@ -622,7 +598,7 @@ msgstr "" msgid "Insert a character string (as many characters as will fit on the line) before the character under the cursor. All characters to the right of the cursor are shifted right, with the rightmost characters on the line being lost. The cursor position does not change (after moving to *y*, *x*, if specified)." msgstr "" -msgid "Return a bytes object of characters, extracted from the window starting at the current cursor position, or at *y*, *x* if specified, and stopping at the end of the line. Attributes and color information are stripped from the characters. If *n* is specified, :meth:`instr` returns a string at most *n* characters long (exclusive of the trailing NUL). The maximum value for *n* is 2047." +msgid "Return a bytes object of characters, extracted from the window starting at the current cursor position, or at *y*, *x* if specified. Attributes are stripped from the characters. If *n* is specified, :meth:`instr` returns a string at most *n* characters long (exclusive of the trailing NUL). The maximum value for *n* is 2047." msgstr "" msgid "Return ``True`` if the specified line was modified since the last call to :meth:`refresh`; otherwise return ``False``. Raise a :exc:`curses.error` exception if *line* is not valid for the given window." @@ -634,7 +610,7 @@ msgstr "" msgid "If *flag* is ``True``, escape sequences generated by some keys (keypad, function keys) will be interpreted by :mod:`!curses`. If *flag* is ``False``, escape sequences will be left as is in the input stream." msgstr "" -msgid "If *flag* is ``True``, cursor is left where it is on update, instead of being at \"cursor position.\" This reduces cursor movement where possible." +msgid "If *flag* is ``True``, cursor is left where it is on update, instead of being at \"cursor position.\" This reduces cursor movement where possible. If possible the cursor will be made invisible." msgstr "" msgid "If *flag* is ``False``, cursor will always be at \"cursor position\" after an update." @@ -649,9 +625,6 @@ msgstr "" msgid "Move the window so its upper-left corner is at ``(new_y, new_x)``." msgstr "" -msgid "Moving the window so that any part of it would be off the screen is an error: the window is not moved and :exc:`curses.error` is raised." -msgstr "" - msgid "If *flag* is ``True``, :meth:`getch` will be non-blocking." msgstr "" @@ -664,9 +637,6 @@ msgstr "" msgid "Mark for refresh but wait. This function updates the data structure representing the desired state of the window, but does not force an update of the physical screen. To accomplish that, call :func:`doupdate`." msgstr "" -msgid "The 6 arguments can only be specified, and are then required, when the window is a pad created with :func:`newpad`; they have the same meaning as for :meth:`refresh`." -msgstr "" - msgid "Overlay the window on top of *destwin*. The windows need not be the same size, only the overlapping region is copied. This copy is non-destructive, which means that the current background character does not overwrite the old contents of *destwin*." msgstr "" @@ -691,13 +661,13 @@ msgstr "" msgid "Update the display immediately (sync actual screen with previous drawing/deleting methods)." msgstr "" -msgid "The 6 arguments can only be specified, and are then required, when the window is a pad created with :func:`newpad`. The additional parameters are needed to indicate what part of the pad and screen are involved. *pminrow* and *pmincol* specify the upper-left corner of the rectangle to be displayed in the pad. *sminrow*, *smincol*, *smaxrow*, and *smaxcol* specify the edges of the rectangle to be displayed on the screen. The lower-right corner of the rectangle to be displayed in the pad is calculated from the screen coordinates, since the rectangles must be the same size. Both rectangles must be entirely contained within their respective structures. Negative values of *pminrow*, *pmincol*, *sminrow*, or *smincol* are treated as if they were zero." +msgid "The 6 optional arguments can only be specified when the window is a pad created with :func:`newpad`. The additional parameters are needed to indicate what part of the pad and screen are involved. *pminrow* and *pmincol* specify the upper left-hand corner of the rectangle to be displayed in the pad. *sminrow*, *smincol*, *smaxrow*, and *smaxcol* specify the edges of the rectangle to be displayed on the screen. The lower right-hand corner of the rectangle to be displayed in the pad is calculated from the screen coordinates, since the rectangles must be the same size. Both rectangles must be entirely contained within their respective structures. Negative values of *pminrow*, *pmincol*, *sminrow*, or *smincol* are treated as if they were zero." msgstr "" msgid "Reallocate storage for a curses window to adjust its dimensions to the specified values. If either dimension is larger than the current values, the window's data is filled with blanks that have the current background rendition (as set by :meth:`bkgdset`) merged into them." msgstr "" -msgid "Scroll the screen or scrolling region. Scroll upward by *lines* lines if *lines* is positive, or downward if it is negative. Scrolling has no effect unless it has been enabled for the window with :meth:`scrollok`." +msgid "Scroll the screen or scrolling region upward by *lines* lines." msgstr "" msgid "Control what happens when the cursor of a window is moved off the edge of the window or scrolling region, either as a result of a newline action on the bottom line, or typing the last character of the last line. If *flag* is ``False``, the cursor is left on the bottom line. If *flag* is ``True``, the window is scrolled up one line. Note that in order to get the physical scrolling effect on the terminal, it is also necessary to call :meth:`idlok`." @@ -712,10 +682,7 @@ msgstr "" msgid "Turn on attribute *A_STANDOUT*." msgstr "" -msgid "Return a sub-pad, whose upper-left corner is at ``(begin_y, begin_x)``, and whose width/height is *ncols*/*nlines*. The coordinates are relative to the parent pad (unlike :meth:`subwin`, which uses screen coordinates). This method is only available for pads created with :func:`newpad`." -msgstr "" - -msgid "Return a sub-window, whose upper-left corner is at the screen-relative coordinates ``(begin_y, begin_x)``, and whose width/height is *ncols*/*nlines*." +msgid "Return a sub-window, whose upper-left corner is at ``(begin_y, begin_x)``, and whose width/height is *ncols*/*nlines*." msgstr "" msgid "By default, the sub-window will extend from the specified position to the lower right corner of the window." @@ -772,10 +739,10 @@ msgstr "" msgid "The maximum number of color pairs the terminal can support. It is defined only after the call to :func:`start_color`." msgstr "" -msgid "The width of the screen, that is, the number of columns. It is defined only after the call to :func:`initscr`. Updated by :func:`update_lines_cols`, :func:`resizeterm` and :func:`resize_term`." +msgid "The width of the screen, i.e., the number of columns. It is defined only after the call to :func:`initscr`. Updated by :func:`update_lines_cols`, :func:`resizeterm` and :func:`resize_term`." msgstr "" -msgid "The height of the screen, that is, the number of lines. It is defined only after the call to :func:`initscr`. Updated by :func:`update_lines_cols`, :func:`resizeterm` and :func:`resize_term`." +msgid "The height of the screen, i.e., the number of lines. It is defined only after the call to :func:`initscr`. Updated by :func:`update_lines_cols`, :func:`resizeterm` and :func:`resize_term`." msgstr "" msgid "Some constants are available to specify character cell attributes. The exact constants available are system dependent." @@ -1201,7 +1168,7 @@ msgstr "" msgid "ACS code" msgstr "" -msgid "alternate name for upper-right corner" +msgid "alternate name for upper right corner" msgstr "" msgid "solid square block" @@ -1213,7 +1180,7 @@ msgstr "" msgid "alternate name for horizontal line" msgstr "" -msgid "alternate name for upper-left corner" +msgid "alternate name for upper left corner" msgstr "" msgid "alternate name for top tee" @@ -1252,10 +1219,10 @@ msgstr "" msgid "less-than-or-equal-to" msgstr "" -msgid "lower-left corner" +msgid "lower left-hand corner" msgstr "" -msgid "lower-right corner" +msgid "lower right-hand corner" msgstr "" msgid "left tee" @@ -1291,7 +1258,7 @@ msgstr "" msgid "scan line 9" msgstr "" -msgid "alternate name for lower-right corner" +msgid "alternate name for lower right corner" msgstr "" msgid "alternate name for vertical line" @@ -1300,7 +1267,7 @@ msgstr "" msgid "alternate name for right tee" msgstr "" -msgid "alternate name for lower-left corner" +msgid "alternate name for lower left corner" msgstr "" msgid "alternate name for bottom tee" @@ -1321,10 +1288,10 @@ msgstr "" msgid "up arrow" msgstr "" -msgid "upper-left corner" +msgid "upper left corner" msgstr "" -msgid "upper-right corner" +msgid "upper right corner" msgstr "" msgid "vertical line" @@ -1357,9 +1324,6 @@ msgstr "" msgid "Control was down during button state change" msgstr "" -msgid "Alt was down during button state change" -msgstr "" - msgid "The following table lists the predefined colors:" msgstr "" @@ -1399,7 +1363,7 @@ msgstr "" msgid "The module :mod:`!curses.textpad` defines the following function:" msgstr "" -msgid "Draw a rectangle. The first argument must be a window object; the remaining arguments are coordinates relative to that window. The second and third arguments are the y and x coordinates of the upper-left corner of the rectangle to be drawn; the fourth and fifth arguments are the y and x coordinates of the lower-right corner. The rectangle will be drawn using VT100/IBM PC forms characters on terminals that make this possible (including xterm and most other software terminal emulators). Otherwise it will be drawn with ASCII dashes, vertical bars, and plus signs." +msgid "Draw a rectangle. The first argument must be a window object; the remaining arguments are coordinates relative to that window. The second and third arguments are the y and x coordinates of the upper left hand corner of the rectangle to be drawn; the fourth and fifth arguments are the y and x coordinates of the lower right hand corner. The rectangle will be drawn using VT100/IBM PC forms characters on terminals that make this possible (including xterm and most other software terminal emulators). Otherwise it will be drawn with ASCII dashes, vertical bars, and plus signs." msgstr "" msgid "Textbox objects" @@ -1408,16 +1372,16 @@ msgstr "" msgid "You can instantiate a :class:`Textbox` object as follows:" msgstr "" -msgid "Return a textbox widget object. The *win* argument should be a curses :ref:`window ` object in which the textbox is to be contained. If *insert_mode* is true, the textbox inserts typed characters, shifting existing text to the right, rather than overwriting it. The edit cursor of the textbox is initially located at the upper-left corner of the containing window, with coordinates ``(0, 0)``. The instance's :attr:`stripspaces` flag is initially on." +msgid "Return a textbox widget object. The *win* argument should be a curses :ref:`window ` object in which the textbox is to be contained. The edit cursor of the textbox is initially located at the upper left hand corner of the containing window, with coordinates ``(0, 0)``. The instance's :attr:`stripspaces` flag is initially on." msgstr "" msgid ":class:`Textbox` objects have the following methods:" msgstr "" -msgid "This is the entry point you will normally use. It accepts editing keystrokes until one of the termination keystrokes is entered. If *validate* is supplied, it must be a function. It will be called for each keystroke entered with the keystroke as a parameter; command dispatch is done on the result. If it returns a false value, the keystroke is ignored. This method returns the window contents as a string; whether blanks in the window are included is affected by the :attr:`stripspaces` attribute." +msgid "This is the entry point you will normally use. It accepts editing keystrokes until one of the termination keystrokes is entered. If *validator* is supplied, it must be a function. It will be called for each keystroke entered with the keystroke as a parameter; command dispatch is done on the result. This method returns the window contents as a string; whether blanks in the window are included is affected by the :attr:`stripspaces` attribute." msgstr "" -msgid "Process a single command keystroke. Returns ``1`` to continue editing, or ``0`` if a termination keystroke was processed. Here are the supported special keystrokes:" +msgid "Process a single command keystroke. Here are the supported special keystrokes:" msgstr "" msgid "Keystroke" @@ -1471,7 +1435,7 @@ msgstr "" msgid ":kbd:`Control-J`" msgstr "" -msgid "Terminate if the window is 1 line, otherwise move to the start of the next line." +msgid "Terminate if the window is 1 line, otherwise insert newline." msgstr "" msgid ":kbd:`Control-K`" diff --git a/library/custominterp.po b/library/custominterp.po index bb6fe29bb..de4ca0a4a 100644 --- a/library/custominterp.po +++ b/library/custominterp.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:03+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/dataclasses.po b/library/dataclasses.po index 0cb75a06a..338b64fe2 100644 --- a/library/dataclasses.po +++ b/library/dataclasses.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:03+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -110,24 +110,12 @@ msgstr "" msgid "If the class already defines :meth:`!__repr__`, this parameter is ignored." msgstr "" -msgid "*eq*: If true (the default), an :meth:`~object.__eq__` method will be generated." -msgstr "" - -msgid "This method compares the class by comparing each field in order. Both instances in the comparison must be of the identical type." +msgid "*eq*: If true (the default), an :meth:`~object.__eq__` method will be generated. This method compares the class as if it were a tuple of its fields, in order. Both instances in the comparison must be of the identical type." msgstr "" msgid "If the class already defines :meth:`!__eq__`, this parameter is ignored." msgstr "" -msgid "The generated ``__eq__`` method now compares each field individually (for example, ``self.a == other.a and self.b == other.b``), rather than comparing tuples of fields as in previous versions." -msgstr "" - -msgid "This change makes the comparison faster but it may alter results in cases where attributes compare equal by identity but not by value (such as ``float('nan')``)." -msgstr "" - -msgid "In Python 3.12 and earlier, the comparison was performed by creating tuples of the fields and comparing them (for example, ``(self.a, self.b) == (other.a, other.b)``)." -msgstr "" - msgid "*order*: If true (the default is ``False``), :meth:`~object.__lt__`, :meth:`~object.__le__`, :meth:`~object.__gt__`, and :meth:`~object.__ge__` methods will be generated. These compare the class as if it were a tuple of its fields, in order. Both instances in the comparison must be of the identical type. If *order* is true and *eq* is false, a :exc:`ValueError` is raised." msgstr "" diff --git a/library/datatypes.po b/library/datatypes.po index 7c40a2265..df49ac6af 100644 --- a/library/datatypes.po +++ b/library/datatypes.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/datetime.po b/library/datetime.po index de1addf3e..19ca07d4f 100644 --- a/library/datetime.po +++ b/library/datetime.po @@ -15,10 +15,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:04+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/dbm.po b/library/dbm.po index 5b64f3638..b83caae3d 100644 --- a/library/dbm.po +++ b/library/dbm.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:04+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/debug.po b/library/debug.po index a28a2ca51..c4c4c8238 100644 --- a/library/debug.po +++ b/library/debug.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/decimal.po b/library/decimal.po index 956a8658b..5db2a6c35 100644 --- a/library/decimal.po +++ b/library/decimal.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:04+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/development.po b/library/development.po index aff500ec2..21756a875 100644 --- a/library/development.po +++ b/library/development.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/devmode.po b/library/devmode.po index ca13cbd89..848f057c5 100644 --- a/library/devmode.po +++ b/library/devmode.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:04+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/dialog.po b/library/dialog.po index 38ae67ad1..6cddf9f94 100644 --- a/library/dialog.po +++ b/library/dialog.po @@ -12,16 +12,16 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=(n > 1);\n" -msgid "Tkinter dialogs" +msgid "Tkinter Dialogs" msgstr "" msgid ":mod:`!tkinter.simpledialog` --- Standard Tkinter input dialogs" @@ -33,16 +33,10 @@ msgstr "" msgid "The :mod:`!tkinter.simpledialog` module contains convenience classes and functions for creating simple modal dialogs to get a value from the user." msgstr "" -msgid "Prompt the user to enter a value of the desired type and return it, or ``None`` if the dialog is cancelled." +msgid "The above three functions provide dialogs that prompt the user to enter a value of the desired type." msgstr "" -msgid "*title* is the dialog title and *prompt* the message shown above the entry. *initialvalue* is the value initially placed in the entry. *parent* is the window over which the dialog is shown. :func:`askinteger` and :func:`askfloat` also accept *minvalue* and *maxvalue*, which bound the accepted value. :func:`askstring` also accepts *show*, a character used to mask the entered text, for example ``'*'`` to hide a password." -msgstr "" - -msgid "The base class for custom dialogs. Instantiating it shows the dialog modally and returns once the user closes it; the entered value is then available in the :attr:`!result` attribute." -msgstr "" - -msgid "The value produced by :meth:`apply`, or ``None`` if the dialog was cancelled." +msgid "The base class for custom dialogs." msgstr "" msgid "Override to construct the dialog's interface and return the widget that should have initial focus." @@ -51,21 +45,6 @@ msgstr "" msgid "Default behaviour adds OK and Cancel buttons. Override for custom button layouts." msgstr "" -msgid "Validate the data entered by the user. Return true if it is valid, in which case the dialog proceeds to :meth:`apply`; return false to keep the dialog open. The default implementation always returns true; override it to check the input." -msgstr "" - -msgid "Process the data entered by the user, for example by storing it in the :attr:`!result` attribute. Called after :meth:`validate` succeeds and just before the dialog is destroyed. The default implementation does nothing; override it to act on or store the result." -msgstr "" - -msgid "Destroy the dialog window, clearing the reference to the widget that had the initial focus." -msgstr "" - -msgid "A simple modal dialog that displays the message *text* above a row of push buttons whose labels are given by *buttons*, and returns the index of the button the user presses. *default* is the index of the button activated by the Return key, *cancel* the index returned when the window is closed through the window manager, *title* the window title, and *class_* the Tk class name of the window." -msgstr "" - -msgid "Display the dialog, wait until the user presses a button or closes the window, and return the index of the chosen button." -msgstr "" - msgid ":mod:`!tkinter.filedialog` --- File selection dialogs" msgstr "" @@ -75,7 +54,7 @@ msgstr "" msgid "The :mod:`!tkinter.filedialog` module provides classes and factory functions for creating file/directory selection windows." msgstr "" -msgid "Native load/save dialogs" +msgid "Native Load/Save Dialogs" msgstr "" msgid "The following classes and functions provide file dialog windows that combine a native look-and-feel with configuration options to customize behaviour. The following keyword arguments are applicable to the classes and functions listed below:" @@ -105,25 +84,31 @@ msgstr "" msgid "**Static factory functions**" msgstr "" -msgid "The below functions when called create a modal, native look-and-feel dialog, wait for the user's selection, and return it. The exact return value depends on the function (see below); when the dialog is cancelled it is an empty string, an empty tuple or ``None``. The precise type of this empty value may vary between platforms and Tk versions, so test the result for truth rather than comparing it with a specific value." +msgid "The below functions when called create a modal, native look-and-feel dialog, wait for the user's selection, then return the selected value(s) or ``None`` to the caller." +msgstr "" + +msgid "The above two functions create an :class:`Open` dialog and return the opened file object(s) in read-only mode." +msgstr "" + +msgid "Create a :class:`SaveAs` dialog and return a file object opened in write-only mode." msgstr "" -msgid "Create an :class:`Open` dialog. :func:`askopenfile` returns the opened file object, or ``None`` if the dialog is cancelled. :func:`askopenfiles` returns a list of the opened file objects, or an empty tuple if cancelled. The files are opened in mode *mode* (read-only ``'r'`` by default)." +msgid "The above two functions create an :class:`Open` dialog and return the selected filename(s) that correspond to existing file(s)." msgstr "" -msgid "Create a :class:`SaveAs` dialog and return the opened file object, or ``None`` if the dialog is cancelled. The file is opened in mode *mode* (``'w'`` by default)." +msgid "Create a :class:`SaveAs` dialog and return the selected filename." msgstr "" -msgid "Create an :class:`Open` dialog. :func:`askopenfilename` returns the selected filename as a string, or an empty string if the dialog is cancelled. :func:`askopenfilenames` returns a tuple of the selected filenames, or an empty tuple if cancelled." +msgid "Prompt user to select a directory." msgstr "" -msgid "Create a :class:`SaveAs` dialog and return the selected filename as a string, or an empty string if the dialog is cancelled." +msgid "Additional keyword option:" msgstr "" -msgid "Prompt the user to select a directory, and return its path as a string, or an empty string if the dialog is cancelled. Additional keyword option: *mustexist* - if true, the user may only select an existing directory (false by default)." +msgid "*mustexist* - determines if selection must be an existing directory." msgstr "" -msgid "The above three classes provide native dialog windows for loading and saving files and for selecting a directory." +msgid "The above two classes provide native dialog windows for saving and loading files." msgstr "" msgid "**Convenience classes**" @@ -132,6 +117,9 @@ msgstr "" msgid "The below classes are used for creating file/directory windows from scratch. These do not emulate the native look-and-feel of the platform." msgstr "" +msgid "Create a dialog prompting the user to select a directory." +msgstr "" + msgid "The *FileDialog* class should be subclassed for custom event handling and behaviour." msgstr "" @@ -168,9 +156,6 @@ msgstr "" msgid "Exit dialog returning current selection." msgstr "" -msgid "Called when the user confirms the current selection. The base implementation accepts the selection and closes the dialog; :class:`LoadFileDialog` and :class:`SaveFileDialog` override it to check the selection first." -msgstr "" - msgid "Exit dialog returning filename, if any." msgstr "" @@ -204,23 +189,5 @@ msgstr "" msgid "Render the Dialog window." msgstr "" -msgid ":mod:`!tkinter.dialog` --- Classic Tk dialog boxes" -msgstr "" - -msgid "**Source code:** :source:`Lib/tkinter/dialog.py`" -msgstr "" - -msgid "The :mod:`!tkinter.dialog` module provides a simple modal dialog box built on the classic (non-themed) Tk widgets." -msgstr "" - -msgid "The name of a bitmap (``'questhead'``) suitable for use as the *bitmap* of a :class:`Dialog`." -msgstr "" - -msgid "Display a modal dialog box built from the classic (non-themed) Tk widgets and wait for the user to press one of its buttons. The options, given through *cnf* or as keyword arguments, are all required: *title* (the window title), *text* (the message), *bitmap* (the name of a bitmap icon, such as :data:`DIALOG_ICON`), *default* (the index of the default button) and *strings* (the sequence of button labels). After construction, the :attr:`!num` attribute holds the index of the button the user pressed." -msgstr "" - -msgid "Do nothing. The dialog window is destroyed automatically before the constructor returns, so there is nothing left for this method to do." -msgstr "" - msgid "Modules :mod:`tkinter.messagebox`, :ref:`tut-files`" msgstr "" diff --git a/library/difflib.po b/library/difflib.po index 5b1e6fe80..148da3965 100644 --- a/library/difflib.po +++ b/library/difflib.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:04+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,55 +29,19 @@ msgstr "" msgid "**Source code:** :source:`Lib/difflib.py`" msgstr "" -msgid "This module provides classes and functions for comparing sequences. Most of them compare sequences of text lines (for example lists of strings, or :term:`file objects `) and produce :dfn:`diffs` -- reports on the differences. Diffs can be produced in in various formats, including HTML and context and unified diffs -- formats produced by tools like :manpage:`diff ` and :manpage:`git diff `." +msgid "This module provides classes and functions for comparing sequences. It can be used for example, for comparing files, and can produce information about file differences in various formats, including HTML and context and unified diffs. For comparing directories and files, see also, the :mod:`filecmp` module." msgstr "" -msgid "Comparisons are done using a matching algorithm implemented in :class:`SequenceMatcher` -- a flexible class for comparing pairs of sequences of any type, not just text, so long as the sequence elements are :term:`hashable`." +msgid "This is a flexible class for comparing pairs of sequences of any type, so long as the sequence elements are :term:`hashable`. The basic algorithm predates, and is a little fancier than, an algorithm published in the late 1980's by Ratcliff and Obershelp under the hyperbolic name \"gestalt pattern matching.\" The idea is to find the longest contiguous matching subsequence that contains no \"junk\" elements; these \"junk\" elements are ones that are uninteresting in some sense, such as blank lines or whitespace. (Handling junk is an extension to the Ratcliff and Obershelp algorithm.) The same idea is then applied recursively to the pieces of the sequences to the left and to the right of the matching subsequence. This does not yield minimal edit sequences, but does tend to yield matches that \"look right\" to people." msgstr "" -msgid "Junk heuristic" +msgid "**Timing:** The basic Ratcliff-Obershelp algorithm is cubic time in the worst case and quadratic time in the expected case. :class:`SequenceMatcher` is quadratic time for the worst case and has expected-case behavior dependent in a complicated way on how many elements the sequences have in common; best case time is linear." msgstr "" -msgid ":mod:`!difflib` uses a :dfn:`junk` heuristic: some items are deemed to be :dfn:`junk`, and ignored when searching for similarities. Ideally, these are uninteresting or common items, such as blank lines or whitespace." +msgid "**Automatic junk heuristic:** :class:`SequenceMatcher` supports a heuristic that automatically treats certain sequence items as junk. The heuristic counts how many times each individual item appears in the sequence. If an item's duplicates (after the first one) account for more than 1% of the sequence and the sequence is at least 200 items long, this item is marked as \"popular\" and is treated as junk for the purpose of sequence matching. This heuristic can be turned off by setting the ``autojunk`` argument to ``False`` when creating the :class:`SequenceMatcher`." msgstr "" -msgid "This heuristic can speed the algorithm up (because it reduces the number of possible combinations) and it can produce results that are more understandable for humans (typically breaking on whitespace). But it can also cause pathological cases:" -msgstr "" - -msgid "Inappropriately chosen junk items can cause an unexpectedly **large** (but still correct) result." -msgstr "" - -msgid "The default heuristic is **asymmetric**: only the second sequence is inspected when determining what is considered junk, so comparing A to B can give different results than comparing B to A and reversing the result." -msgstr "" - -msgid "By default, if the second input sequence is at least 200 items long, items that account for more than 1% it are considered *junk*." -msgstr "" - -msgid "Depending on your data, you should consider turning this heuristic off (setting :class:`~difflib.SequenceMatcher`'s *autojunk* argument to to ``False``) or tuning it (using the *isjunk* argument, perhaps to one of the :ref:`predefined functions `)." -msgstr "" - -msgid "The :mod:`!difflib` algorithm" -msgstr "" - -msgid "The algorithm used in :class:`SequenceMatcher` predates, and is a little fancier than, an algorithm published in the late 1980s by Ratcliff and Obershelp under the hyperbolic name \"gestalt pattern matching.\" The idea is to find the longest contiguous subsequence common to both inputs, then recursively handle the pieces of the sequences to the left and to the right of the matching subsequence." -msgstr "" - -msgid "`Pattern Matching: The Gestalt Approach `_" -msgstr "" - -msgid "Discussion of a similar algorithm by John W. Ratcliff and D. E. Metzener. This was published in Dr. Dobb's Journal in July, 1988." -msgstr "" - -msgid "As an extension to the Ratcliff and Obershelp algorithm, :mod:`!difflib` searches for the longest *junk-free* contiguous subsequence. See the :ref:`difflib-junk` section for details." -msgstr "" - -msgid "Timing" -msgstr "" - -msgid "The basic Ratcliff-Obershelp algorithm is cubic time in the worst case and quadratic time in the expected case. :mod:`difflib`'s algorithm is quadratic time for the worst case and has expected-case behavior dependent in a complicated way on how many elements the sequences have in common; best case time is linear." -msgstr "" - -msgid "Diff generation" +msgid "Added the *autojunk* parameter." msgstr "" msgid "This is a class for comparing sequences of lines of text, and producing human-readable differences or deltas. Differ uses :class:`SequenceMatcher` both to compare sequences of lines, and to compare sequences of characters within similar (near-matching) lines." @@ -119,39 +83,9 @@ msgstr "" msgid "Lines beginning with '``?``' attempt to guide the eye to intraline differences, and were not present in either input sequence. These lines can be confusing if the sequences contain whitespace characters, such as spaces, tabs or line breaks." msgstr "" -msgid "Note that :class:`Differ`\\ -generated deltas make no claim to be **minimal** diffs. To the contrary, minimal diffs are often counter-intuitive for humans, because they synch up anywhere possible, sometimes at accidental matches 100 pages apart. Restricting synch points to contiguous matches preserves some notion of locality, at the occasional cost of producing a longer diff." -msgstr "" - -msgid "The :class:`Differ` class has this constructor:" -msgstr "" - -msgid "Optional keyword parameters *linejunk* and *charjunk* are for filter functions (or ``None``):" -msgstr "" - -msgid "*linejunk*: A function that accepts a single string argument, and returns true if the string is junk. The default is ``None``, meaning that no line is considered junk." -msgstr "" - -msgid "*charjunk*: A function that accepts a single character argument (a string of length 1), and returns true if the character is junk. The default is ``None``, meaning that no character is considered junk." -msgstr "" - -msgid "These junk-filtering functions speed up matching to find differences and do not cause any differing lines or characters to be ignored. Read the description of the :meth:`~SequenceMatcher.find_longest_match` method's *isjunk* parameter for an explanation." -msgstr "" - -msgid ":class:`Differ` objects are used (deltas generated) via a single method:" -msgstr "" - -msgid "Compare two sequences of lines, and generate the delta (a sequence of lines)." -msgstr "" - -msgid "Each sequence must contain individual single-line strings ending with newlines. Such sequences can be obtained from the :meth:`~io.IOBase.readlines` method of file-like objects. The generated delta also consists of newline-terminated strings, ready to be printed as-is via the :meth:`~io.IOBase.writelines` method of a file-like object." -msgstr "" - msgid "This class can be used to create an HTML table (or a complete HTML file containing the table) showing a side by side, line by line comparison of text with inter-line and intra-line change highlights. The table can be generated in either full or contextual difference mode." msgstr "" -msgid "The trailing newlines get stripped before the diff, so the result can be incomplete. See :gh:`71896` for details." -msgstr "" - msgid "The constructor for this class is:" msgstr "" @@ -260,18 +194,24 @@ msgstr "" msgid "Allows you to compare data with unknown or inconsistent encoding. All inputs except *n* must be bytes objects, not str. Works by losslessly converting all inputs (except *n*) to str, and calling ``dfunc(a, b, fromfile, tofile, fromfiledate, tofiledate, n, lineterm)``. The output of *dfunc* is then converted back to bytes, so the delta lines that you receive have the same unknown/inconsistent encodings as *a* and *b*." msgstr "" -msgid "Junk definition functions" -msgstr "" - msgid "Return ``True`` for ignorable lines. The line *line* is ignorable if *line* is blank or contains a single ``'#'``, otherwise it is not ignorable. Used as a default for parameter *linejunk* in :func:`ndiff` in older versions." msgstr "" msgid "Return ``True`` for ignorable characters. The character *ch* is ignorable if *ch* is a space or tab, otherwise it is not ignorable. Used as a default for parameter *charjunk* in :func:`ndiff`." msgstr "" +msgid "`Pattern Matching: The Gestalt Approach `_" +msgstr "" + +msgid "Discussion of a similar algorithm by John W. Ratcliff and D. E. Metzener. This was published in Dr. Dobb's Journal in July, 1988." +msgstr "" + msgid "SequenceMatcher objects" msgstr "" +msgid "The :class:`SequenceMatcher` class has this constructor:" +msgstr "" + msgid "Optional argument *isjunk* must be ``None`` (the default) or a one-argument function that takes a sequence element and returns true if and only if the element is \"junk\" and should be ignored. Passing ``None`` for *isjunk* is equivalent to passing ``lambda x: False``; in other words, no elements are ignored. For example, pass::" msgstr "" @@ -287,9 +227,6 @@ msgstr "" msgid "The optional argument *autojunk* can be used to disable the automatic junk heuristic." msgstr "" -msgid "Added the *autojunk* parameter." -msgstr "" - msgid "SequenceMatcher objects get three data attributes: *bjunk* is the set of elements of *b* for which *isjunk* is ``True``; *bpopular* is the set of non-junk elements considered popular by the heuristic (if it is not disabled); *b2j* is a dict mapping the remaining elements of *b* to a list of positions where they occur. All three are reset whenever *b* is reset with :meth:`set_seqs` or :meth:`set_seq2`." msgstr "" @@ -412,6 +349,16 @@ msgstr "" msgid "This is expensive to compute if :meth:`get_matching_blocks` or :meth:`get_opcodes` hasn't already been called, in which case you may want to try :meth:`quick_ratio` or :meth:`real_quick_ratio` first to get an upper bound." msgstr "" +msgid "Caution: The result of a :meth:`ratio` call may depend on the order of the arguments. For instance::" +msgstr "" + +msgid "" +">>> SequenceMatcher(None, 'tide', 'diet').ratio()\n" +"0.25\n" +">>> SequenceMatcher(None, 'diet', 'tide').ratio()\n" +"0.5" +msgstr "" + msgid "Return an upper bound on :meth:`ratio` relatively quickly." msgstr "" @@ -421,9 +368,6 @@ msgstr "" msgid "The three methods that return the ratio of matching to total characters can give different results due to differing levels of approximation, although :meth:`~SequenceMatcher.quick_ratio` and :meth:`~SequenceMatcher.real_quick_ratio` are always at least as large as :meth:`~SequenceMatcher.ratio`:" msgstr "" -msgid "Examples" -msgstr "" - msgid "SequenceMatcher examples" msgstr "" @@ -448,6 +392,36 @@ msgstr "" msgid "`Simple version control recipe `_ for a small application built with :class:`SequenceMatcher`." msgstr "" +msgid "Differ objects" +msgstr "" + +msgid "Note that :class:`Differ`\\ -generated deltas make no claim to be **minimal** diffs. To the contrary, minimal diffs are often counter-intuitive, because they synch up anywhere possible, sometimes accidental matches 100 pages apart. Restricting synch points to contiguous matches preserves some notion of locality, at the occasional cost of producing a longer diff." +msgstr "" + +msgid "The :class:`Differ` class has this constructor:" +msgstr "" + +msgid "Optional keyword parameters *linejunk* and *charjunk* are for filter functions (or ``None``):" +msgstr "" + +msgid "*linejunk*: A function that accepts a single string argument, and returns true if the string is junk. The default is ``None``, meaning that no line is considered junk." +msgstr "" + +msgid "*charjunk*: A function that accepts a single character argument (a string of length 1), and returns true if the character is junk. The default is ``None``, meaning that no character is considered junk." +msgstr "" + +msgid "These junk-filtering functions speed up matching to find differences and do not cause any differing lines or characters to be ignored. Read the description of the :meth:`~SequenceMatcher.find_longest_match` method's *isjunk* parameter for an explanation." +msgstr "" + +msgid ":class:`Differ` objects are used (deltas generated) via a single method:" +msgstr "" + +msgid "Compare two sequences of lines, and generate the delta (a sequence of lines)." +msgstr "" + +msgid "Each sequence must contain individual single-line strings ending with newlines. Such sequences can be obtained from the :meth:`~io.IOBase.readlines` method of file-like objects. The delta generated also consists of newline-terminated strings, ready to be printed as-is via the :meth:`~io.IOBase.writelines` method of a file-like object." +msgstr "" + msgid "Differ example" msgstr "" diff --git a/library/dis.po b/library/dis.po index 6b67719f9..bfc453c95 100644 --- a/library/dis.po +++ b/library/dis.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:04+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/distribution.po b/library/distribution.po index 47bcd2873..624a584a7 100644 --- a/library/distribution.po +++ b/library/distribution.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/distutils.po b/library/distutils.po index c64489bdf..df7878305 100644 --- a/library/distutils.po +++ b/library/distutils.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:02+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/doctest.po b/library/doctest.po index dab17bbc9..f4cff6d69 100644 --- a/library/doctest.po +++ b/library/doctest.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:04+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/email.charset.po b/library/email.charset.po index 8158c99ac..e6979a4fc 100644 --- a/library/email.charset.po +++ b/library/email.charset.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:04+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/email.compat32-message.po b/library/email.compat32-message.po index cb869e9a8..c322fd0e3 100644 --- a/library/email.compat32-message.po +++ b/library/email.compat32-message.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/email.contentmanager.po b/library/email.contentmanager.po index fd82902e2..72b339cc6 100644 --- a/library/email.contentmanager.po +++ b/library/email.contentmanager.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:04+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/email.encoders.po b/library/email.encoders.po index 8dfdd5f2f..8d2dd2513 100644 --- a/library/email.encoders.po +++ b/library/email.encoders.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:04+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/email.errors.po b/library/email.errors.po index fd9f81647..8c2efafc3 100644 --- a/library/email.errors.po +++ b/library/email.errors.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/email.examples.po b/library/email.examples.po index 44197932c..e77ea65f2 100644 --- a/library/email.examples.po +++ b/library/email.examples.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:05+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/email.generator.po b/library/email.generator.po index 17f1c5cdc..5a50ecd2b 100644 --- a/library/email.generator.po +++ b/library/email.generator.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:05+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/email.header.po b/library/email.header.po index 6a5574c6d..b2ccbc1d0 100644 --- a/library/email.header.po +++ b/library/email.header.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:05+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/email.headerregistry.po b/library/email.headerregistry.po index f27d4d198..85b47b6a2 100644 --- a/library/email.headerregistry.po +++ b/library/email.headerregistry.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:05+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/email.iterators.po b/library/email.iterators.po index ab251ef0f..cad3e825b 100644 --- a/library/email.iterators.po +++ b/library/email.iterators.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/email.message.po b/library/email.message.po index e87498cd7..cedff1a53 100644 --- a/library/email.message.po +++ b/library/email.message.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:05+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/email.mime.po b/library/email.mime.po index be03bc78e..815fe7f90 100644 --- a/library/email.mime.po +++ b/library/email.mime.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/email.parser.po b/library/email.parser.po index 9c9dd91c5..c777267fe 100644 --- a/library/email.parser.po +++ b/library/email.parser.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:05+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/email.po b/library/email.po index 20ecb7984..895ab9333 100644 --- a/library/email.po +++ b/library/email.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/email.policy.po b/library/email.policy.po index 4dc22f58a..fae0645c9 100644 --- a/library/email.policy.po +++ b/library/email.policy.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:05+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/email.utils.po b/library/email.utils.po index 78b475fa0..1b6d45a3e 100644 --- a/library/email.utils.po +++ b/library/email.utils.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:05+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/ensurepip.po b/library/ensurepip.po index d787ccbb0..c94bfe0ca 100644 --- a/library/ensurepip.po +++ b/library/ensurepip.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:05+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/enum.po b/library/enum.po index dc0988ff3..81922027c 100644 --- a/library/enum.po +++ b/library/enum.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:05+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -157,37 +157,37 @@ msgstr "" msgid "Instances are replaced with an appropriate value for Enum members. :class:`StrEnum` defaults to the lower-cased version of the member name, while other Enums default to 1 and increase from there." msgstr "" -msgid ":deco:`~enum.property`" +msgid ":func:`~enum.property`" msgstr "" msgid "Allows :class:`Enum` members to have attributes without conflicting with member names. The ``value`` and ``name`` attributes are implemented this way." msgstr "" -msgid ":deco:`unique`" +msgid ":func:`unique`" msgstr "" msgid "Enum class decorator that ensures only one name is bound to any one value." msgstr "" -msgid ":deco:`verify`" +msgid ":func:`verify`" msgstr "" msgid "Enum class decorator that checks user-selectable constraints on an enumeration." msgstr "" -msgid ":deco:`member`" +msgid ":func:`member`" msgstr "" msgid "Make ``obj`` a member. Can be used as a decorator." msgstr "" -msgid ":deco:`nonmember`" +msgid ":func:`nonmember`" msgstr "" msgid "Do not make ``obj`` a member. Can be used as a decorator." msgstr "" -msgid ":deco:`global_enum`" +msgid ":func:`global_enum`" msgstr "" msgid "Modify the :class:`str() ` and :func:`repr` of an enum to show its members as belonging to the module instead of its class, and export the enum members to the global namespace." @@ -969,7 +969,7 @@ msgstr "" msgid "in 3.13 the default ``_generate_next_value_`` will always return the highest member value incremented by 1, and will fail if any member is an incompatible type." msgstr "" -msgid "A decorator similar to the built-in :deco:`property`, but specifically for enumerations. It allows member attributes to have the same names as members themselves." +msgid "A decorator similar to the built-in *property*, but specifically for enumerations. It allows member attributes to have the same names as members themselves." msgstr "" msgid "the *property* and the member must be defined in separate classes; for example, the *value* and *name* attributes are defined in the *Enum* class, and *Enum* subclasses can define members with the names ``value`` and ``name``." diff --git a/library/errno.po b/library/errno.po index 3ff7c71e1..7346accf9 100644 --- a/library/errno.po +++ b/library/errno.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/exceptions.po b/library/exceptions.po index f2840b404..fa2b80686 100644 --- a/library/exceptions.po +++ b/library/exceptions.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-27 06:04+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:05+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/faulthandler.po b/library/faulthandler.po index 1b3fcf196..68625edc7 100644 --- a/library/faulthandler.po +++ b/library/faulthandler.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:05+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/fcntl.po b/library/fcntl.po index 9d795bba5..a5e853fc0 100644 --- a/library/fcntl.po +++ b/library/fcntl.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:06+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/filecmp.po b/library/filecmp.po index c35123485..8a468a264 100644 --- a/library/filecmp.po +++ b/library/filecmp.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -48,7 +48,7 @@ msgstr "" msgid "This function uses a cache for past comparisons and the results, with cache entries invalidated if the :func:`os.stat` information for the file changes. The entire cache may be cleared using :func:`clear_cache`." msgstr "" -msgid "Compare the files in the two directories *a* and *b* whose names are given by *common*." +msgid "Compare the files in the two directories *dir1* and *dir2* whose names are given by *common*." msgstr "" msgid "Returns three lists of file names: *match*, *mismatch*, *errors*. *match* contains the list of files that match, *mismatch* contains the names of those that don't, and *errors* lists the names of files which could not be compared. Files are listed in *errors* if they don't exist in one of the directories, the user lacks permission to read them or if the comparison could not be done for some other reason." diff --git a/library/fileformats.po b/library/fileformats.po index a931f5a21..15d15c2f2 100644 --- a/library/fileformats.po +++ b/library/fileformats.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/fileinput.po b/library/fileinput.po index 1fd61d280..a4f443840 100644 --- a/library/fileinput.po +++ b/library/fileinput.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/filesys.po b/library/filesys.po index 136f703df..767263976 100644 --- a/library/filesys.po +++ b/library/filesys.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/fnmatch.po b/library/fnmatch.po index 8d96b43ec..a256f822f 100644 --- a/library/fnmatch.po +++ b/library/fnmatch.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:06+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -71,7 +71,7 @@ msgstr "" msgid "Unless stated otherwise, \"filename string\" and \"pattern string\" either refer to :class:`str` or ``ISO-8859-1`` encoded :class:`bytes` objects. Note that the functions documented below do not allow to mix a :class:`!bytes` pattern with a :class:`!str` filename, and vice-versa." msgstr "" -msgid "Finally, note that :deco:`functools.lru_cache` with a *maxsize* of 32768 is used to cache the (typed) compiled regex patterns in the following functions: :func:`fnmatch`, :func:`fnmatchcase`, :func:`.filter`, :func:`.filterfalse`." +msgid "Finally, note that :func:`functools.lru_cache` with a *maxsize* of 32768 is used to cache the (typed) compiled regex patterns in the following functions: :func:`fnmatch`, :func:`fnmatchcase`, :func:`.filter`, :func:`.filterfalse`." msgstr "" msgid "Test whether the filename string *name* matches the pattern string *pat*, returning ``True`` or ``False``. Both parameters are case-normalized using :func:`os.path.normcase`. :func:`fnmatchcase` can be used to perform a case-sensitive comparison, regardless of whether that's standard for the operating system." diff --git a/library/fractions.po b/library/fractions.po index c0d198fe0..f3c2ffd07 100644 --- a/library/fractions.po +++ b/library/fractions.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:06+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/frameworks.po b/library/frameworks.po index c62d6520e..72703c485 100644 --- a/library/frameworks.po +++ b/library/frameworks.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/ftplib.po b/library/ftplib.po index 67d700344..a546cd977 100644 --- a/library/ftplib.po +++ b/library/ftplib.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:06+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/functional.po b/library/functional.po index 5f085d1d1..f237490d1 100644 --- a/library/functional.po +++ b/library/functional.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/functions.po b/library/functions.po index f108687fc..526ddd918 100644 --- a/library/functions.po +++ b/library/functions.po @@ -17,10 +17,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" -"PO-Revision-Date: 2026-08-26 06:41+0330\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" +"PO-Revision-Date: 2026-08-16 12:46+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,7 +29,7 @@ msgstr "" "X-Generator: Poedit 3.6\n" msgid "Built-in Functions" -msgstr "توابع توکار" +msgstr "توابع پیش ساخته" msgid "The Python interpreter has a number of functions and types built into it that are always available. They are listed here in alphabetical order." msgstr "مفسر پایتون دارای تعدادی تابع و نوع داده (type) است که در آن بصورت توکار (built-in) همیشه در دسترس می‌باشند. آن‌ها در اینجا به ترتیب حروف الفبا فهرست شده‌اند." @@ -308,7 +308,7 @@ msgid ":func:`__import__`" msgstr ":func:`__import__`" msgid "Return the absolute value of a number. The argument may be an integer, a floating-point number, or an object implementing :meth:`~object.__abs__`. If the argument is a complex number, its magnitude is returned." -msgstr "مقدار قدر مطلق یک عدد را برمی‌گرداند. آرگومان می تواند یک عدد صحیح، یک عدد اعشاری، یا یک شیء که :meth:`~object.__abs__` را پیاده‌سازی می‌کند، باشد. اگر ارگومان یک عدد مختلط باشد، بزرگی آن بازگردانده می‌شود." +msgstr "مقدار قدر مطلق یک عدد را برمی‌گرداند. آرگومان می تواند یک عدد صحیح، یک عدد اعشاری، یا یک شیء که :meth:`~object.__abs__` را پیاده سازی می‌کند، باشد. اگر ارگومان یک عدد مختلط باشد، بزرگی آن بازگردانده می‌شود." msgid "Return an :term:`asynchronous iterator` for an :term:`asynchronous iterable`. Equivalent to calling ``x.__aiter__()``." msgstr "بازگرداندن یک :term:`asynchronous iterator` برای یک :term:`asynchronous iterable` معادل فراخوانی ``x.__aiter__()`` است." @@ -336,10 +336,10 @@ msgid "When awaited, return the next item from the given :term:`asynchronous ite msgstr "هنگام اِنتظار (await)، عنصر بعدی را از :term:`asynchronous iterator` داده شده برمی‌گرداند، یا اگر آرگومان *default* ارائه شده و تکرارکننده به پایان رسیده باشد، مقدار *default* را برمی‌گرداند." msgid "This is the async variant of the :func:`next` builtin, and behaves similarly." -msgstr "این، نسخه ناهمگامِ تابع توکار :func:`next` است و به طور مشابه عمل می‌کند." +msgstr "این، نسخه ناهمگامِ تابع داخلی :func:`next` است و به طور مشابه عمل می‌کند." msgid "This calls the :meth:`~object.__anext__` method of *async_iterator*, returning an :term:`awaitable`. Awaiting this returns the next value of the iterator. If *default* is given, it is returned if the iterator is exhausted, otherwise :exc:`StopAsyncIteration` is raised." -msgstr "این متد :meth:`~object.__anext__` از *async_iterator* را فراخوانی می کند و یک :term:`awaitable` را برمی گرداند. در انتظار این مقدار بعدی تکرارگر را برمی گرداند. اگر *default* داده شود، اگر تکرارگر تمام شده باشد، برگردانده می شود، در غیر این صورت :exc:`StopAsyncIteration` پرتاب میشود." +msgstr "این متد :meth:`~object.__anext__` از *async_iterator* را فراخوانی می کند و یک :term:`awaitable` را برمی گرداند. در انتظار این مقدار بعدی تکرار کننده را برمی گرداند. اگر *default* داده شود، اگر تکرار کننده تمام شده باشد، برگردانده می شود، در غیر این صورت :exc:`StopAsyncIteration` افزایش می یابد." msgid "Return ``True`` if any element of the *iterable* is true. If the iterable is empty, return ``False``. Equivalent to::" msgstr "اگر هر عنصری از *iterable* درست باشد، ``True`` را برگردانید. اگر iterable خالی باشد، ``False`` را برگردانید. معادل با::" @@ -388,7 +388,7 @@ msgid "Note that this is not guaranteed if :func:`sys.breakpointhook` has been r msgstr "توجه داشته باشید که این امر تضمین نمی‌شود اگر تابع :func:`sys.breakpointhook` جایگزین شده باشد." msgid "Raises an :ref:`auditing event ` ``builtins.breakpoint`` with argument ``breakpointhook``." -msgstr "یک :ref:`رویداد ممیزی ` ``builtins.breakpoint`` با آرگومان ``breakpointhook`` پرتاب می‌کند." +msgstr "یک :ref:`auditing event ` ``builtins.breakpoint`` با آرگومان ``breakpointhook`` پرتاب می‌کند." msgid "Return a new array of bytes. The :class:`bytearray` class is a mutable sequence of integers in the range 0 <= x < 256. It has most of the usual methods of mutable sequences, described in :ref:`typesseq-mutable`, as well as most methods that the :class:`bytes` type has, see :ref:`bytes-methods`." msgstr "یک آرایهٔ جدید از بایت‌ها را برمی‌گرداند. کلاس :class:`bytearray` دنباله‌ای قابل‌تغییر از اعداد صحیح در بازهٔ 0 <= x < 256 است. این کلاس بیشتر متدهای معمول دنباله‌های قابل‌تغییر را دارد که در :ref:`typesseq-mutable` شرح داده شده‌اند، و همچنین بیشتر متدهایی را دارد که نوع :class:`bytes` دارد؛ به :ref:`bytes-methods` مراجعه کنید." @@ -584,11 +584,11 @@ msgstr "ارسال یک عدد مختلط به‌عنوان آرگومان *real msgid "This is a relative of :func:`setattr`. The arguments are an object and a string. The string must be the name of one of the object's attributes. The function deletes the named attribute, provided the object allows it. For example, ``delattr(x, 'foobar')`` is equivalent to ``del x.foobar``. *name* need not be a Python identifier (see :func:`setattr`)." msgstr "این تابع همتای :func:`setattr` است. آرگومان‌های آن یک شیء و یک رشته هستند. رشته باید نام یکی از ویژگی‌های شیء باشد. در صورت مجاز بودن، این تابع ویژگی نام‌برده را حذف می‌کند. برای مثال، ``delattr(x, 'foobar')`` معادل ``del x.foobar`` است. *name* الزامی ندارد که یک شناسهٔ معتبر پایتون باشد (به :func:`setattr` مراجعه کنید)." -msgid "Create a new dictionary. The :class:`dict` object is the dictionary class. See also :ref:`typesmapping` for documentation about this class." -msgstr "ایجاد یک دیکشنری جدید. شیء :class:`dict` کلاس دیکشنری است. برای مستندات این کلاس، به :ref:`typesmapping` مراجعه کنید." +msgid "Create a new dictionary. The :class:`dict` object is the dictionary class. See :class:`dict` and :ref:`typesmapping` for documentation about this class." +msgstr "ایجاد یک دیکشنری جدید. شیء :class:`dict` کلاس دیکشنری است. برای مستندات این کلاس، به :class:`dict` و :ref:`typesmapping` مراجعه کنید." msgid "For other containers see the built-in :class:`list`, :class:`set`, and :class:`tuple` classes, as well as the :mod:`collections` module." -msgstr "برای سایر انواع محفظه‌ها، به کلاس‌های توکار :class:`list`، :class:`set` و :class:`tuple`، و همچنین ماژول :mod:`collections` مراجعه کنید." +msgstr "برای سایر انواع محفظه‌ها، به کلاس‌های داخلی :class:`list`، :class:`set` و :class:`tuple`، و همچنین ماژول :mod:`collections` مراجعه کنید." msgid "Without arguments, return the list of names in the current local scope. With an argument, attempt to return a list of valid attributes for that object." msgstr "بدون آرگومان، فهرست نام‌های موجود در دامنهٔ محلیِ فعلی را بازمی‌گرداند. با ارسال یک آرگومان، تلاش می‌کند فهرستی از ویژگی‌های معتبر آن شیء را بازگرداند." @@ -666,8 +666,8 @@ msgstr "خطاهای نحوی به‌صورت استثنا گزارش می‌ش msgid "This function executes arbitrary code. Calling it with untrusted user-supplied input will lead to security vulnerabilities." msgstr "این تابع کد دلخواه را اجرا می‌کند. فراخوانی آن با ورودیِ تأمین‌شده از سوی کاربر که قابل اعتماد نیست، منجر به آسیب‌پذیری‌های امنیتی خواهد شد." -msgid "The *source* argument is parsed and evaluated as a Python expression (technically speaking, an :ref:`expression list `) using the *globals* and *locals* mappings as global and local namespace. If the *globals* dictionary is present and does not contain a value for the key ``__builtins__``, a reference to the dictionary of the built-in module :mod:`builtins` is inserted under that key before *source* is parsed. Overriding ``__builtins__`` can be used to restrict or change the available names, but this is **not** a security mechanism: the executed code can still access all builtins. If the *locals* mapping is omitted it defaults to the *globals* dictionary. If both mappings are omitted, the source is executed with the *globals* and *locals* in the environment where :func:`eval` is called. Note, *eval()* will only have access to the :term:`nested scopes ` (non-locals) in the enclosing environment if they are already referenced in the scope that is calling :func:`eval` (e.g. via a :keyword:`nonlocal` statement)." -msgstr "آرگومان *source* به‌عنوان یک عبارت پایتون (از نظر فنی، یک :ref:`فهرست عبارات `) با استفاده از نگاشت‌های *globals* و *locals* به‌ترتیب به‌عنوان فضای نام سراسری و محلی، تجزیه و ارزیابی می‌شود. اگر دیکشنری *globals* وجود داشته باشد اما کلید ``__builtins__`` را نداشته باشد، پیش از تجزیهٔ *source*، ارجاعی به دیکشنری ماژول توکار :mod:`builtins` تحت این کلید درج می‌شود. بازنویسی ``__builtins__`` می‌تواند برای محدود کردن یا تغییر نام‌های در دسترس استفاده شود، اما این **یک سازوکار امنیتی نیست**؛ زیرا کد اجراشده همچنان می‌تواند به تمام توابع و اشیای توکار دسترسی داشته باشد. اگر نگاشت *locals* ارائه نشود، به‌طور پیش‌فرض از دیکشنری *globals* استفاده می‌شود. اگر هر دو نگاشت حذف شوند، *source* با استفاده از *globals* و *locals* محیطی که :func:`eval` در آن فراخوانی شده اجرا می‌شود. توجه داشته باشید که *eval()* تنها در صورتی به :term:`دامنه‌های تو‌در‌تو ` (متغیرهای nonlocal) محیط پیرامون دسترسی خواهد داشت که آن‌ها از قبل در دامنه‌ای که :func:`eval` را فراخوانی می‌کند ارجاع داده شده باشند (برای مثال، از طریق دستور :keyword:`nonlocal`)." +msgid "The *source* argument is parsed and evaluated as a Python expression (technically speaking, a condition list) using the *globals* and *locals* mappings as global and local namespace. If the *globals* dictionary is present and does not contain a value for the key ``__builtins__``, a reference to the dictionary of the built-in module :mod:`builtins` is inserted under that key before *source* is parsed. Overriding ``__builtins__`` can be used to restrict or change the available names, but this is **not** a security mechanism: the executed code can still access all builtins. If the *locals* mapping is omitted it defaults to the *globals* dictionary. If both mappings are omitted, the source is executed with the *globals* and *locals* in the environment where :func:`eval` is called. Note, *eval()* will only have access to the :term:`nested scopes ` (non-locals) in the enclosing environment if they are already referenced in the scope that is calling :func:`eval` (e.g. via a :keyword:`nonlocal` statement)." +msgstr "آرگومان *source* به‌عنوان یک عبارت پایتون (از نظر فنی، یک condition list) با استفاده از نگاشت‌های *globals* و *locals* به‌ترتیب به‌عنوان فضای نام سراسری و محلی، تجزیه و ارزیابی می‌شود. اگر دیکشنری *globals* وجود داشته باشد اما کلید ``__builtins__`` را نداشته باشد، پیش از تجزیهٔ *source*، ارجاعی به دیکشنری ماژول داخلی :mod:`builtins` تحت این کلید درج می‌شود. بازنویسی ``__builtins__`` می‌تواند برای محدود کردن یا تغییر نام‌های در دسترس استفاده شود، اما این **یک سازوکار امنیتی نیست**؛ زیرا کد اجراشده همچنان می‌تواند به تمام توابع و اشیای داخلی دسترسی داشته باشد. اگر نگاشت *locals* ارائه نشود، به‌طور پیش‌فرض از دیکشنری *globals* استفاده می‌شود. اگر هر دو نگاشت حذف شوند، *source* با استفاده از *globals* و *locals* محیطی که :func:`eval` در آن فراخوانی شده اجرا می‌شود. توجه داشته باشید که *eval()* تنها در صورتی به :term:`دامنه‌های تو‌در‌تو ` (متغیرهای nonlocal) محیط پیرامون دسترسی خواهد داشت که آن‌ها از قبل در دامنه‌ای که :func:`eval` را فراخوانی می‌کند ارجاع داده شده باشند (برای مثال، از طریق دستور :keyword:`nonlocal`)." msgid "Example:" msgstr "مثال:" @@ -691,7 +691,7 @@ msgid "The *globals* and *locals* arguments can now be passed as keywords." msgstr "آرگومان‌های *globals* و *locals* اکنون می‌توانند به‌صورت آرگومان کلیدواژه‌ای نیز ارسال شوند." msgid "The semantics of the default *locals* namespace have been adjusted as described for the :func:`locals` builtin." -msgstr "معنای فضای نام پیش‌فرض *locals* مطابق توضیحات ارائه‌شده برای تابع توکار :func:`locals` تنظیم شده است." +msgstr "معنای فضای نام پیش‌فرض *locals* مطابق توضیحات ارائه‌شده برای تابع داخلی :func:`locals` تنظیم شده است." msgid "This function supports dynamic execution of Python code. *source* must be either a string or a code object. If it is a string, the string is parsed as a suite of Python statements which is then executed (unless a syntax error occurs). [#]_ If it is a code object, it is simply executed. In all cases, the code that's executed is expected to be valid as file input (see the section :ref:`file-input` in the Reference Manual). Be aware that the :keyword:`nonlocal`, :keyword:`yield`, and :keyword:`return` statements may not be used outside of function definitions even within the context of code passed to the :func:`exec` function. The return value is ``None``." msgstr "این تابع از اجرای پویای کد پایتون پشتیبانی می‌کند. *source* باید یا یک رشته باشد یا یک شیء کد. اگر رشته باشد، به‌عنوان مجموعه‌ای از دستورهای پایتون تجزیه و سپس اجرا می‌شود (مگر اینکه خطای نحوی رخ دهد). [#]_ اگر یک شیء کد باشد، مستقیماً اجرا می‌شود. در همهٔ موارد، انتظار می‌رود کد اجراشده به‌عنوان ورودی فایل معتبر باشد (به بخش :ref:`file-input` در راهنمای مرجع مراجعه کنید). توجه داشته باشید که دستورهای :keyword:`nonlocal`، :keyword:`yield` و :keyword:`return` حتی در کدی که از طریق :func:`exec` اجرا می‌شود نیز خارج از تعریف تابع قابل استفاده نیستند. مقدار بازگشتی ``None`` است." @@ -703,13 +703,13 @@ msgid "When ``exec`` gets two separate objects as *globals* and *locals*, the co msgstr "وقتی ``exec`` دو شیء جداگانه را به‌عنوان *globals* و *locals* دریافت می‌کند، کد به‌گونه‌ای اجرا می‌شود که گویی درون یک تعریف کلاس قرار دارد. این بدان معناست که توابع و کلاس‌های تعریف‌شده در کد اجراشده نمی‌توانند به متغیرهای اختصاص‌یافته در سطح بالا دسترسی داشته باشند (زیرا متغیرهای «سطح بالا» در تعریف کلاس به‌عنوان متغیرهای کلاس در نظر گرفته می‌شوند)." msgid "If the *globals* dictionary does not contain a value for the key ``__builtins__``, a reference to the dictionary of the built-in module :mod:`builtins` is inserted under that key. Overriding ``__builtins__`` can be used to restrict or change the available names, but this is **not** a security mechanism: the executed code can still access all builtins." -msgstr "اگر دیکشنری *globals* مقداری برای کلید ``__builtins__`` نداشته باشد، ارجاعی به دیکشنری ماژول توکار :mod:`builtins` با همان کلید در آن درج می‌شود. بازنویسی ``__builtins__`` می‌تواند برای محدود کردن یا تغییر نام‌های در دسترس استفاده شود، اما این **یک سازوکار امنیتی نیست**؛ زیرا کدی که اجرا می‌شود همچنان می‌تواند به تمام اشیای توکار دسترسی داشته باشد." +msgstr "اگر دیکشنری *globals* مقداری برای کلید ``__builtins__`` نداشته باشد، ارجاعی به دیکشنری ماژول داخلی :mod:`builtins` با همان کلید در آن درج می‌شود. بازنویسی ``__builtins__`` می‌تواند برای محدود کردن یا تغییر نام‌های در دسترس استفاده شود، اما این **یک سازوکار امنیتی نیست**؛ زیرا کدی که اجرا می‌شود همچنان می‌تواند به تمام اشیای داخلی دسترسی داشته باشد." msgid "The *closure* argument specifies a closure--a tuple of cellvars. It's only valid when the *object* is a code object containing :term:`free (closure) variables `. The length of the tuple must exactly match the length of the code object's :attr:`~codeobject.co_freevars` attribute." msgstr "آرگومان *closure* یک closure را مشخص می‌کند؛ یعنی یک تاپل از cellvarها. این آرگومان تنها زمانی معتبر است که *object* یک شیء کد باشد که شامل :term:`متغیرهای آزاد (closure) ` باشد. طول این تاپل باید دقیقاً با طول ویژگی :attr:`~codeobject.co_freevars` شیء کد برابر باشد." msgid "The built-in functions :func:`globals` and :func:`locals` return the current global and local namespace, respectively, which may be useful to pass around for use as the second and third argument to :func:`exec`." -msgstr "توابع توکار :func:`globals` و :func:`locals` به‌ترتیب فضای نام سراسری و محلی فعلی را برمی‌گردانند که می‌توانند برای ارسال به‌عنوان آرگومان دوم و سوم تابع :func:`exec` مفید باشند." +msgstr "توابع داخلی :func:`globals` و :func:`locals` به‌ترتیب فضای نام سراسری و محلی فعلی را برمی‌گردانند که می‌توانند برای ارسال به‌عنوان آرگومان دوم و سوم تابع :func:`exec` مفید باشند." msgid "The default *locals* act as described for function :func:`locals` below. Pass an explicit *locals* dictionary if you need to see effects of the code on *locals* after function :func:`exec` returns." msgstr "*locals* پیش‌فرض همان‌گونه عمل می‌کند که در ادامه برای تابع :func:`locals` توضیح داده شده است. اگر لازم است پس از بازگشت تابع :func:`exec` تغییرات اعمال‌شده روی *locals* را مشاهده کنید، یک دیکشنری *locals* صریح ارسال کنید." @@ -777,7 +777,7 @@ msgid "Falls back to :meth:`~object.__index__` if :meth:`~object.__float__` is n msgstr "اگر :meth:`~object.__float__` تعریف نشده باشد، به :meth:`~object.__index__` بازمی‌گردد." msgid "Convert a *value* to a \"formatted\" representation, as controlled by *format_spec*. The interpretation of *format_spec* will depend on the type of the *value* argument; however, there is a standard formatting syntax that is used by most built-in types: :ref:`formatspec`." -msgstr "*value* را مطابق با *format_spec* به یک نمایش قالب‌بندی‌شده تبدیل می‌کند. نحوهٔ تفسیر *format_spec* به نوع آرگومان *value* بستگی دارد؛ با این حال، یک نحو استاندارد برای قالب‌بندی وجود دارد که بیشتر انواع توکار از آن استفاده می‌کنند: :ref:`formatspec`." +msgstr "*value* را مطابق با *format_spec* به یک نمایش قالب‌بندی‌شده تبدیل می‌کند. نحوهٔ تفسیر *format_spec* به نوع آرگومان *value* بستگی دارد؛ با این حال، یک نحو استاندارد برای قالب‌بندی وجود دارد که بیشتر انواع داخلی از آن استفاده می‌کنند: :ref:`formatspec`." msgid "The default *format_spec* is an empty string which usually gives the same effect as calling :func:`str(value) `." msgstr "مقدار پیش‌فرض *format_spec* یک رشتهٔ خالی است که معمولاً همان اثری را دارد که فراخوانی :func:`str(value) ` ایجاد می‌کند." @@ -788,11 +788,11 @@ msgstr "فراخوانی ``format(value, format_spec)`` به ``type(value).__for msgid "``object().__format__(format_spec)`` raises :exc:`TypeError` if *format_spec* is not an empty string." msgstr "اگر *format_spec* یک رشتهٔ خالی نباشد، ``object().__format__(format_spec)`` استثنای :exc:`TypeError` پرتاب می‌کند." -msgid "Return a new :class:`frozenset` object, optionally with elements taken from *iterable*. :class:`frozenset` is a built-in class. See also :ref:`types-set` for documentation about this class." -msgstr "یک شیء جدید از نوع :class:`frozenset` را برمی‌گرداند که در صورت ارائه، عناصر آن از *iterable* گرفته می‌شوند. :class:`frozenset` یک کلاس توکار است. برای مستندات این کلاس، به :ref:`types-set` مراجعه کنید." +msgid "Return a new :class:`frozenset` object, optionally with elements taken from *iterable*. ``frozenset`` is a built-in class. See :class:`frozenset` and :ref:`types-set` for documentation about this class." +msgstr "یک شیء جدید از نوع :class:`frozenset` را برمی‌گرداند که در صورت ارائه، عناصر آن از *iterable* گرفته می‌شوند. ``frozenset`` یک کلاس داخلی است. برای مستندات این کلاس، به :class:`frozenset` و :ref:`types-set` مراجعه کنید." msgid "For other containers see the built-in :class:`set`, :class:`list`, :class:`tuple`, and :class:`dict` classes, as well as the :mod:`collections` module." -msgstr "برای سایر انواع محفظه‌ها، به کلاس‌های توکار :class:`set`، :class:`list`، :class:`tuple` و :class:`dict`، و همچنین ماژول :mod:`collections` مراجعه کنید." +msgstr "برای سایر انواع محفظه‌ها، به کلاس‌های داخلی :class:`set`، :class:`list`، :class:`tuple` و :class:`dict`، و همچنین ماژول :mod:`collections` مراجعه کنید." msgid "Return the value of the named attribute of *object*. *name* must be a string. If the string is the name of one of the object's attributes, the result is the value of that attribute. For example, ``getattr(x, 'foobar')`` is equivalent to ``x.foobar``. If the named attribute does not exist, *default* is returned if provided, otherwise :exc:`AttributeError` is raised. *name* need not be a Python identifier (see :func:`setattr`)." msgstr "مقدار ویژگیِ نام‌گذاری‌شدهٔ *object* را برمی‌گرداند. *name* باید یک رشته باشد. اگر رشته، نام یکی از ویژگی‌های شیء باشد، نتیجه مقدار آن ویژگی خواهد بود. برای مثال، ``getattr(x, 'foobar')`` معادل ``x.foobar`` است. اگر ویژگیِ نام‌گذاری‌شده وجود نداشته باشد، در صورت ارائه، *default* برگردانده می‌شود؛ در غیر این صورت، استثنای :exc:`AttributeError` پرتاب می‌شود. لازم نیست *name* یک شناسهٔ معتبر پایتون باشد (به :func:`setattr` مراجعه کنید)." @@ -813,13 +813,13 @@ msgid "For objects with custom :meth:`~object.__hash__` methods, note that :func msgstr "برای اشیایی که متد :meth:`~object.__hash__` سفارشی دارند، توجه داشته باشید که :func:`hash` مقدار بازگشتی را بر اساس پهنای بیت ماشین میزبان کوتاه می‌کند." msgid "Invoke the built-in help system. (This function is intended for interactive use.) If no argument is given, the interactive help system starts on the interpreter console. If the argument is a string, then the string is looked up as the name of a module, function, class, method, keyword, or documentation topic, and a help page is printed on the console. If the argument is any other kind of object, a help page on the object is generated." -msgstr "سامانهٔ راهنمای توکار را فراخوانی می‌کند. (این تابع برای استفادهٔ تعاملی طراحی شده است.) اگر هیچ آرگومانی ارائه نشود، سامانهٔ راهنمای تعاملی در کنسول مفسر آغاز می‌شود. اگر آرگومان یک رشته باشد، آن رشته به‌عنوان نام یک ماژول، تابع، کلاس، متد، کلیدواژه یا موضوع مستندات جست‌وجو می‌شود و صفحهٔ راهنمای آن در کنسول نمایش داده می‌شود. اگر آرگومان هر نوع شیء دیگری باشد، صفحهٔ راهنمای مربوط به آن شیء تولید می‌شود." +msgstr "سامانهٔ راهنمای داخلی را فراخوانی می‌کند. (این تابع برای استفادهٔ تعاملی طراحی شده است.) اگر هیچ آرگومانی ارائه نشود، سامانهٔ راهنمای تعاملی در کنسول مفسر آغاز می‌شود. اگر آرگومان یک رشته باشد، آن رشته به‌عنوان نام یک ماژول، تابع، کلاس، متد، کلیدواژه یا موضوع مستندات جست‌وجو می‌شود و صفحهٔ راهنمای آن در کنسول نمایش داده می‌شود. اگر آرگومان هر نوع شیء دیگری باشد، صفحهٔ راهنمای مربوط به آن شیء تولید می‌شود." msgid "Note that if a slash(/) appears in the parameter list of a function when invoking :func:`help`, it means that the parameters prior to the slash are positional-only. For more info, see :ref:`the FAQ entry on positional-only parameters `." msgstr "توجه داشته باشید که اگر هنگام فراخوانی :func:`help` یک اسلش (/) در فهرست پارامترهای یک تابع ظاهر شود، به این معناست که پارامترهای قبل از اسلش فقط به‌صورت مکانی قابل ارسال هستند. برای اطلاعات بیشتر، به :ref:`پرسش متداول مربوط به پارامترهای فقط مکانی ` مراجعه کنید." msgid "This function is added to the built-in namespace by the :mod:`site` module." -msgstr "این تابع توسط ماژول :mod:`site` به فضای نام توکار (built-in namespace) اضافه می‌شود." +msgstr "این تابع توسط ماژول :mod:`site` به فضای نام داخلی (built-in namespace) اضافه می‌شود." msgid "Changes to :mod:`pydoc` and :mod:`inspect` mean that the reported signatures for callables are now more comprehensive and consistent." msgstr "تغییرات اعمال‌شده در :mod:`pydoc` و :mod:`inspect` باعث شده‌اند امضاهای گزارش‌شده برای اشیای فراخوانی‌پذیر اکنون کامل‌تر و سازگارتر باشند." @@ -1006,7 +1006,7 @@ msgid "If one positional argument is provided, it should be an :term:`iterable`. msgstr "اگر یک آرگومان مکانی ارائه شود، باید یک :term:`تکرارپذیر ` باشد. در این صورت، بزرگ‌ترین عنصر آن تکرارپذیر برگردانده می‌شود. اگر دو یا چند آرگومان مکانی ارائه شوند، بزرگ‌ترین آرگومان مکانی برگردانده می‌شود." msgid "There are two optional keyword-only arguments. The *key* argument specifies a one-argument ordering function like that used for :meth:`list.sort`. The *default* argument specifies an object to return if the provided iterable is empty. If the iterable is empty and *default* is not provided, a :exc:`ValueError` is raised." -msgstr "دو آرگومان اختیاریِ فقط-کلیدواژه‌ای (keyword-only) وجود دارد. آرگومان *key* یک تابع مرتب‌سازی تک‌آرگومانی، مشابه آنچه در :meth:`list.sort` استفاده می‌شود، مشخص می‌کند. آرگومان *default* شی‌ءای را مشخص می‌کند که در صورت خالی بودن تکرارپذیر بازگردانده شود. اگر تکرارپذیر خالی باشد و *default* ارائه نشده باشد، استثنای :exc:`ValueError` پرتاب می‌شود." +msgstr "دو آرگومان اختیاریِ فقط-کلیدواژه‌ای (keyword-only) وجود دارد. آرگومان *key* یک تابع مرتب‌سازی تک‌آرگومانی، مشابه آنچه در :meth:`list.sort` استفاده می‌شود، مشخص می‌کند. آرگومان *default* شیئی را مشخص می‌کند که در صورت خالی بودن تکرارپذیر بازگردانده شود. اگر تکرارپذیر خالی باشد و *default* ارائه نشده باشد، استثنای :exc:`ValueError` پرتاب می‌شود." msgid "If multiple items are maximal, the function returns the first one encountered. This is consistent with other sort-stability preserving tools such as ``sorted(iterable, key=keyfunc, reverse=True)[0]`` and ``heapq.nlargest(1, iterable, key=keyfunc)``." msgstr "اگر چندین عنصر دارای بیشترین مقدار باشند، تابع نخستین موردی را که با آن برخورد کند برمی‌گرداند. این رفتار با سایر ابزارهایی که پایداری مرتب‌سازی را حفظ می‌کنند، مانند ``sorted(iterable, key=keyfunc, reverse=True)[0]`` و ``heapq.nlargest(1, iterable, key=keyfunc)``، سازگار است." @@ -1039,7 +1039,7 @@ msgid ":class:`object` instances do *not* have :attr:`~object.__dict__` attribut msgstr "نمونه‌های :class:`object` دارای ویژگی :attr:`~object.__dict__` *نیستند*؛ بنابراین نمی‌توانید ویژگی‌های دلخواهی را به یک نمونه از :class:`object` اختصاص دهید." msgid "Convert an integer number to an octal string prefixed with \"0o\". The result is a valid Python expression. If *integer* is not a Python :class:`int` object, it has to define an :meth:`~object.__index__` method that returns an integer. For example:" -msgstr "یک عدد صحیح را به یک رشتهٔ هشت‌هشتی با پیشوند «0o» تبدیل کنید. نتیجه یک عبارت معتبر پایتون است. اگر *integer* یک شیء :class:`int` پایتون نباشد، باید متد :meth:`~object.__index__` را تعریف کند که یک عدد صحیح بازمی‌گرداند. برای مثال:" +msgstr "تبدیل یک عدد صحیح به یک رشته باینری که با \"0b\" پیشوند شده است. نتیجه یک عبارت معتبر پایتون خواهد بود. اگر *integer* یک شیء پایتون :class:`int` نباشد، لازم است یک متد :meth:`~object.__index__` تعریف کند که یک عدد صحیح برگرداند. برخی مثال ها:" msgid "If you want to convert an integer number to an octal string either with the prefix \"0o\" or not, you can use either of the following ways." msgstr "اگر می‌خواهید یک عدد صحیح را به یک رشتهٔ هشت‌هشتی، با پیشوند «0o» یا بدون آن، تبدیل کنید، می‌توانید از هر یک از روش‌های زیر استفاده کنید." @@ -1051,7 +1051,7 @@ msgid "*file* is a :term:`path-like object` giving the pathname (absolute or rel msgstr "*file* یک :term:`شیء مسیرمانند ` است که مسیر پرونده (مطلق یا نسبی نسبت به پوشهٔ کاری فعلی) را برای باز شدن مشخص می‌کند، یا یک توصیفگر عددی پرونده مربوط به پرونده‌ای است که باید در یک شیء ورودی/خروجی بسته‌بندی شود. (اگر یک توصیفگر پرونده ارائه شود، هنگام بسته شدن شیء ورودی/خروجیِ بازگشتی نیز بسته خواهد شد، مگر اینکه *closefd* برابر ``False`` تنظیم شده باشد.)" msgid "*mode* is an optional string that specifies the mode in which the file is opened. It defaults to ``'r'`` which means open for reading in text mode. Other common values are ``'w'`` for writing (truncating the file if it already exists), ``'x'`` for exclusive creation, and ``'a'`` for appending (which on *some* Unix systems, means that *all* writes append to the end of the file regardless of the current seek position). In text mode, if *encoding* is not specified the encoding used is platform-dependent: :func:`locale.getencoding` is called to get the current locale encoding. (For reading and writing raw bytes use binary mode and leave *encoding* unspecified.) The available modes are:" -msgstr "*mode* یک رشتهٔ اختیاری است که حالت باز شدن پرونده را مشخص می‌کند. مقدار پیش‌فرض آن ``'r'`` است که به معنای باز کردن پرونده برای خواندن در حالت متنی است. مقادیر رایج دیگر عبارت‌اند از ``'w'`` برای نوشتن (که اگر پرونده از قبل وجود داشته باشد، محتوای آن را حذف می‌کند)، ``'x'`` برای ایجاد انحصاری، و ``'a'`` برای افزودن به انتهای پرونده (که در *برخی* از سیستم‌های یونیکس به این معناست که *تمام* عملیات نوشتن، صرف‌نظر از موقعیت فعلی نشانگر، به انتهای پرونده افزوده می‌شوند). در حالت متنی، اگر *encoding* مشخص نشده باشد، کدگذاری مورد استفاده به سکو بستگی دارد؛ در این حالت، :func:`locale.getencoding` برای دریافت کدگذاری محلی (locale) فعلی فراخوانی می‌شود. (برای خواندن و نوشتن بایت‌های خام، از حالت دودویی استفاده کنید و *encoding* را مشخص نکنید.) حالت‌های موجود عبارت‌اند از:" +msgstr "*mode* یک رشتهٔ اختیاری است که حالت باز شدن پرونده را مشخص می‌کند. مقدار پیش‌فرض آن ``'r'`` است که به معنای باز کردن پرونده برای خواندن در حالت متنی است. مقادیر رایج دیگر عبارت‌اند از ``'w'`` برای نوشتن (که اگر پرونده از قبل وجود داشته باشد، محتوای آن را حذف می‌کند)، ``'x'`` برای ایجاد انحصاری، و ``'a'`` برای افزودن به انتهای پرونده (که در *برخی* از سیستم‌های یونیکس به این معناست که *تمام* عملیات نوشتن، صرف‌نظر از موقعیت فعلی نشانگر، به انتهای پرونده افزوده می‌شوند). در حالت متنی، اگر *encoding* مشخص نشده باشد، رمزگذاری مورد استفاده به سکو بستگی دارد؛ در این حالت، :func:`locale.getencoding` برای دریافت رمزگذاری محلی (locale) فعلی فراخوانی می‌شود. (برای خواندن و نوشتن بایت‌های خام، از حالت دودویی استفاده کنید و *encoding* را مشخص نکنید.) حالت‌های موجود عبارت‌اند از:" msgid "Character" msgstr "نویسه" @@ -1105,7 +1105,7 @@ msgid "The default mode is ``'r'`` (open for reading text, a synonym of ``'rt'`` msgstr "حالت پیش‌فرض ``'r'`` است (باز کردن پرونده برای خواندن متن، که معادل ``'rt'`` است). حالت‌های ``'w+'`` و ``'w+b'`` پرونده را باز کرده و محتوای آن را حذف می‌کنند. حالت‌های ``'r+'`` و ``'r+b'`` پرونده را بدون حذف محتوا باز می‌کنند." msgid "As mentioned in the :ref:`io-overview`, Python distinguishes between binary and text I/O. Files opened in binary mode (including ``'b'`` in the *mode* argument) return contents as :class:`bytes` objects without any decoding. In text mode (the default, or when ``'t'`` is included in the *mode* argument), the contents of the file are returned as :class:`str`, the bytes having been first decoded using a platform-dependent encoding or using the specified *encoding* if given." -msgstr "همان‌طور که در :ref:`io-overview` اشاره شد، پایتون بین ورودی/خروجی دودویی و متنی تفاوت قائل می‌شود. پرونده‌هایی که در حالت دودویی باز می‌شوند (یعنی *mode* شامل ``'b'`` باشد)، محتوا را بدون هیچ کدگشایی به‌صورت اشیای :class:`bytes` برمی‌گردانند. در حالت متنی (حالت پیش‌فرض، یا زمانی که *mode* شامل ``'t'`` باشد)، محتوای پرونده به‌صورت :class:`str` برگردانده می‌شود؛ در این حالت، بایت‌ها ابتدا با استفاده از کدگذاری وابسته به سکو یا، در صورت مشخص شدن، با استفاده از *encoding* داده‌شده کدگشایی می‌شوند." +msgstr "همان‌طور که در :ref:`io-overview` اشاره شد، پایتون بین ورودی/خروجی دودویی و متنی تفاوت قائل می‌شود. پرونده‌هایی که در حالت دودویی باز می‌شوند (یعنی *mode* شامل ``'b'`` باشد)، محتوا را بدون هیچ رمزگشایی به‌صورت اشیای :class:`bytes` برمی‌گردانند. در حالت متنی (حالت پیش‌فرض، یا زمانی که *mode* شامل ``'t'`` باشد)، محتوای پرونده به‌صورت :class:`str` برگردانده می‌شود؛ در این حالت، بایت‌ها ابتدا با استفاده از رمزگذاری وابسته به سکو یا، در صورت مشخص شدن، با استفاده از *encoding* داده‌شده رمزگشایی می‌شوند." msgid "Python doesn't depend on the underlying operating system's notion of text files; all the processing is done by Python itself, and is therefore platform-independent." msgstr "پایتون به مفهوم پروندهٔ متنی در سیستم‌عامل زیربنایی وابسته نیست؛ تمام پردازش‌ها توسط خود پایتون انجام می‌شوند و بنابراین مستقل از سکو هستند." @@ -1120,25 +1120,25 @@ msgid "\"Interactive\" text files (files for which :meth:`~io.IOBase.isatty` ret msgstr "پرونده‌های متنی «تعاملی» (پرونده‌هایی که :meth:`~io.IOBase.isatty` برای آن‌ها مقدار ``True`` برمی‌گرداند) از بافرگذاری خطی استفاده می‌کنند. سایر پرونده‌های متنی از سیاستی که در بالا برای پرونده‌های دودویی توضیح داده شده است، پیروی می‌کنند." msgid "*encoding* is the name of the encoding used to decode or encode the file. This should only be used in text mode. The default encoding is platform dependent (whatever :func:`locale.getencoding` returns), but any :term:`text encoding` supported by Python can be used. See the :mod:`codecs` module for the list of supported encodings." -msgstr "*encoding* نام کدگذاری مورد استفاده برای کدگشایی یا کدگذاری پرونده است. این گزینه فقط باید در حالت متنی استفاده شود. کدگذاری پیش‌فرض به سکو بستگی دارد (هر مقداری که :func:`locale.getencoding` برگرداند)، اما می‌توان از هر :term:`کدگذاری متنی ` که توسط پایتون پشتیبانی می‌شود استفاده کرد. برای مشاهدهٔ فهرست کدگذاری‌های پشتیبانی‌شده، به ماژول :mod:`codecs` مراجعه کنید." +msgstr "*encoding* نام رمزگذاری مورد استفاده برای رمزگشایی یا رمزگذاری پرونده است. این گزینه فقط باید در حالت متنی استفاده شود. رمزگذاری پیش‌فرض به سکو بستگی دارد (هر مقداری که :func:`locale.getencoding` برگرداند)، اما می‌توان از هر :term:`رمزگذاری متنی ` که توسط پایتون پشتیبانی می‌شود استفاده کرد. برای مشاهدهٔ فهرست رمزگذاری‌های پشتیبانی‌شده، به ماژول :mod:`codecs` مراجعه کنید." msgid "*errors* is an optional string that specifies how encoding and decoding errors are to be handled—this cannot be used in binary mode. A variety of standard error handlers are available (listed under :ref:`error-handlers`), though any error handling name that has been registered with :func:`codecs.register_error` is also valid. The standard names include:" -msgstr "*errors* یک رشتهٔ اختیاری است که مشخص می‌کند خطاهای کدگذاری و کدگشایی چگونه مدیریت شوند؛ این گزینه در حالت دودویی قابل استفاده نیست. مجموعه‌ای از مدیریت‌کننده‌های استاندارد خطا (که در :ref:`error-handlers` فهرست شده‌اند) در دسترس هستند، با این حال هر نام مدیریت خطایی که با :func:`codecs.register_error` ثبت شده باشد نیز معتبر است. نام‌های استاندارد شامل موارد زیر هستند:" +msgstr "*errors* یک رشتهٔ اختیاری است که مشخص می‌کند خطاهای رمزگذاری و رمزگشایی چگونه مدیریت شوند؛ این گزینه در حالت دودویی قابل استفاده نیست. مجموعه‌ای از مدیریت‌کننده‌های استاندارد خطا (که در :ref:`error-handlers` فهرست شده‌اند) در دسترس هستند، با این حال هر نام مدیریت خطایی که با :func:`codecs.register_error` ثبت شده باشد نیز معتبر است. نام‌های استاندارد شامل موارد زیر هستند:" msgid "``'strict'`` to raise a :exc:`ValueError` exception if there is an encoding error. The default value of ``None`` has the same effect." -msgstr "``'strict'`` در صورت بروز خطای کدگذاری، استثنای :exc:`ValueError` پرتاب می‌کند. مقدار پیش‌فرض ``None`` نیز همین رفتار را دارد." +msgstr "``'strict'`` در صورت بروز خطای رمزگذاری، استثنای :exc:`ValueError` پرتاب می‌کند. مقدار پیش‌فرض ``None`` نیز همین رفتار را دارد." msgid "``'ignore'`` ignores errors. Note that ignoring encoding errors can lead to data loss." -msgstr "``'ignore'`` خطاها را نادیده می‌گیرد. توجه داشته باشید که نادیده گرفتن خطاهای کدگذاری ممکن است به از دست رفتن داده‌ها منجر شود." +msgstr "``'ignore'`` خطاها را نادیده می‌گیرد. توجه داشته باشید که نادیده گرفتن خطاهای رمزگذاری ممکن است به از دست رفتن داده‌ها منجر شود." msgid "``'replace'`` causes a replacement marker (such as ``'?'``) to be inserted where there is malformed data." msgstr "``'replace'`` باعث می‌شود در محل داده‌های نادرست، یک نویسهٔ جایگزین (مانند ``'?'``) درج شود." msgid "``'surrogateescape'`` will represent any incorrect bytes as low surrogate code units ranging from U+DC80 to U+DCFF. These surrogate code units will then be turned back into the same bytes when the ``surrogateescape`` error handler is used when writing data. This is useful for processing files in an unknown encoding." -msgstr "``'surrogateescape'`` هر بایت نادرست را به‌صورت واحدهای کد جانشین پایینی در بازهٔ U+DC80 تا U+DCFF نمایش می‌دهد. سپس، هنگام نوشتن داده‌ها و استفاده از مدیریت‌کنندهٔ خطای ``surrogateescape``، این واحدهای کد جانشین دوباره به همان بایت‌ها تبدیل می‌شوند. این قابلیت برای پردازش پرونده‌هایی با کدگذاری نامشخص مفید است." +msgstr "``'surrogateescape'`` هر بایت نادرست را به‌صورت واحدهای کد جانشین پایینی در بازهٔ U+DC80 تا U+DCFF نمایش می‌دهد. سپس، هنگام نوشتن داده‌ها و استفاده از مدیریت‌کنندهٔ خطای ``surrogateescape``، این واحدهای کد جانشین دوباره به همان بایت‌ها تبدیل می‌شوند. این قابلیت برای پردازش پرونده‌هایی با رمزگذاری نامشخص مفید است." msgid "``'xmlcharrefreplace'`` is only supported when writing to a file. Characters not supported by the encoding are replaced with the appropriate XML character reference :samp:`&#{nnn};`." -msgstr "``'xmlcharrefreplace'`` فقط هنگام نوشتن در یک پرونده پشتیبانی می‌شود. نویسه‌هایی که توسط کدگذاری پشتیبانی نمی‌شوند، با ارجاع نویسهٔ XML متناظر آن‌ها به صورت :samp:`&#{nnn};` جایگزین می‌شوند." +msgstr "``'xmlcharrefreplace'`` فقط هنگام نوشتن در یک پرونده پشتیبانی می‌شود. نویسه‌هایی که توسط رمزگذاری پشتیبانی نمی‌شوند، با ارجاع نویسهٔ XML متناظر آن‌ها به صورت :samp:`&#{nnn};` جایگزین می‌شوند." msgid "``'backslashreplace'`` replaces malformed data by Python's backslashed escape sequences." msgstr "``'backslashreplace'`` داده‌های نادرست را با توالی‌های گریز دارای بک‌اسلش در پایتون جایگزین می‌کند." @@ -1243,7 +1243,7 @@ msgid "Return *base* to the power *exp*; if *mod* is present, return *base* to t msgstr "*base* را به توان *exp* می‌رساند؛ اگر *mod* مشخص شده باشد، مقدار *base* به توان *exp* را به پیمانهٔ *mod* برمی‌گرداند (که کارآمدتر از ``pow(base, exp) % mod`` محاسبه می‌شود). شکل دوآرگومانی ``pow(base, exp)`` معادل استفاده از عملگر توان، یعنی ``base**exp``، است." msgid "When arguments are builtin numeric types with mixed operand types, the coercion rules for binary arithmetic operators apply. For :class:`int` operands, the result has the same type as the operands (after coercion) unless the second argument is negative; in that case, all arguments are converted to float and a float result is delivered. For example, ``pow(10, 2)`` returns ``100``, but ``pow(10, -2)`` returns ``0.01``. For a negative base of type :class:`int` or :class:`float` and a non-integral exponent, a complex result is delivered. For example, ``pow(-9, 0.5)`` returns a value close to ``3j``. Whereas, for a negative base of type :class:`int` or :class:`float` with an integral exponent, a float result is delivered. For example, ``pow(-9, 2.0)`` returns ``81.0``." -msgstr "وقتی آرگومان‌ها از انواع عددی توکار با انواع عملوند متفاوت باشند، قواعد تبدیل (coercion) عملگرهای حسابی دودویی اعمال می‌شود. برای عملوندهای :class:`int`، نتیجه پس از اعمال تبدیل، همان نوع عملوندها را خواهد داشت؛ مگر اینکه آرگومان دوم منفی باشد که در این صورت همهٔ آرگومان‌ها به float تبدیل شده و نتیجه نیز از نوع float خواهد بود. برای مثال، ``pow(10, 2)`` مقدار ``100`` را برمی‌گرداند، اما ``pow(10, -2)`` مقدار ``0.01`` را بازمی‌گرداند. اگر پایهٔ منفی از نوع :class:`int` یا :class:`float` باشد و توان عددی غیرصحیح باشد، نتیجه از نوع مختلط خواهد بود. برای مثال، ``pow(-9, 0.5)`` مقداری نزدیک به ``3j`` را برمی‌گرداند. در مقابل، اگر پایهٔ منفی از نوع :class:`int` یا :class:`float` باشد و توان عددی صحیح باشد، نتیجه از نوع float خواهد بود. برای مثال، ``pow(-9, 2.0)`` مقدار ``81.0`` را برمی‌گرداند." +msgstr "وقتی آرگومان‌ها از انواع عددی داخلی با انواع عملوند متفاوت باشند، قواعد تبدیل (coercion) عملگرهای حسابی دودویی اعمال می‌شود. برای عملوندهای :class:`int`، نتیجه پس از اعمال تبدیل، همان نوع عملوندها را خواهد داشت؛ مگر اینکه آرگومان دوم منفی باشد که در این صورت همهٔ آرگومان‌ها به float تبدیل شده و نتیجه نیز از نوع float خواهد بود. برای مثال، ``pow(10, 2)`` مقدار ``100`` را برمی‌گرداند، اما ``pow(10, -2)`` مقدار ``0.01`` را بازمی‌گرداند. اگر پایهٔ منفی از نوع :class:`int` یا :class:`float` باشد و توان عددی غیرصحیح باشد، نتیجه از نوع مختلط خواهد بود. برای مثال، ``pow(-9, 0.5)`` مقداری نزدیک به ``3j`` را برمی‌گرداند. در مقابل، اگر پایهٔ منفی از نوع :class:`int` یا :class:`float` باشد و توان عددی صحیح باشد، نتیجه از نوع float خواهد بود. برای مثال، ``pow(-9, 2.0)`` مقدار ``81.0`` را برمی‌گرداند." msgid "For :class:`int` operands *base* and *exp*, if *mod* is present, *mod* must also be of integer type and *mod* must be nonzero. If *mod* is present and *exp* is negative, *base* must be relatively prime to *mod*. In that case, ``pow(inv_base, -exp, mod)`` is returned, where *inv_base* is an inverse to *base* modulo *mod*." msgstr "برای عملوندهای :class:`int` یعنی *base* و *exp*، اگر *mod* ارائه شود، باید از نوع عدد صحیح باشد و مقدار آن نیز نباید صفر باشد. اگر *mod* ارائه شده باشد و *exp* منفی باشد، *base* و *mod* باید نسبت به هم اول باشند. در این حالت، ``pow(inv_base, -exp, mod)`` برگردانده می‌شود که در آن *inv_base* وارونِ *base* به پیمانهٔ *mod* است." @@ -1275,7 +1275,7 @@ msgid "All non-keyword arguments are converted to strings like :func:`str` does msgstr "همهٔ آرگومان‌های غیرکلیدواژه‌ای، همانند :func:`str`، به رشته تبدیل شده و با جداکنندهٔ *sep* از یکدیگر جدا شده و سپس همراه با *end* در جریان (stream) نوشته می‌شوند. هر دو مقدار *sep* و *end* باید رشته باشند؛ همچنین می‌توانند ``None`` باشند که در این صورت از مقادیر پیش‌فرض استفاده می‌شود. اگر هیچ *objects*\\ ی ارائه نشود، :func:`print` فقط مقدار *end* را خواهد نوشت." msgid "The *file* argument must be an object with a ``write(string)`` method; if it is not present or ``None``, :data:`sys.stdout` will be used. Since printed arguments are converted to text strings, :func:`print` cannot be used with binary mode file objects. For these, use ``file.write(...)`` instead." -msgstr "آرگومان *file* باید شی‌ءای باشد که متد ``write(string)`` را داشته باشد؛ اگر این آرگومان ارائه نشود یا ``None`` باشد، از :data:`sys.stdout` استفاده خواهد شد. از آنجا که آرگومان‌های چاپ‌شده به رشتهٔ متنی تبدیل می‌شوند، :func:`print` را نمی‌توان با اشیای فایل در حالت دودویی استفاده کرد. برای چنین مواردی، به‌جای آن از ``file.write(...)`` استفاده کنید." +msgstr "آرگومان *file* باید شیئی باشد که متد ``write(string)`` را داشته باشد؛ اگر این آرگومان ارائه نشود یا ``None`` باشد، از :data:`sys.stdout` استفاده خواهد شد. از آنجا که آرگومان‌های چاپ‌شده به رشتهٔ متنی تبدیل می‌شوند، :func:`print` را نمی‌توان با اشیای فایل در حالت دودویی استفاده کرد. برای چنین مواردی، به‌جای آن از ``file.write(...)`` استفاده کنید." msgid "Output buffering is usually determined by *file*. However, if *flush* is true, the stream is forcibly flushed." msgstr "بافرگذاری خروجی معمولاً توسط *file* تعیین می‌شود. با این حال، اگر *flush* برابر True باشد، جریان داده به‌اجبار تخلیه می‌شود." @@ -1326,8 +1326,8 @@ msgstr "" msgid "If *c* is an instance of *C*, ``c.x`` will invoke the getter, ``c.x = value`` will invoke the setter, and ``del c.x`` the deleter." msgstr "اگر *c* نمونه‌ای از *C* باشد، عبارت ``c.x`` فراخوانی‌کنندهٔ getter، عبارت ``c.x = value`` فراخوانی‌کنندهٔ setter، و عبارت ``del c.x`` فراخوانی‌کنندهٔ deleter خواهد بود." -msgid "If given, *doc* will be the docstring of the property attribute. Otherwise, the property will copy *fget*'s docstring (if it exists). This makes it possible to create read-only properties easily using :deco:`property` as a :term:`decorator`::" -msgstr "اگر *doc* مشخص شده باشد، به‌عنوان docstring ویژگی property استفاده خواهد شد. در غیر این صورت، property، docstring مربوط به *fget* را (در صورت وجود) کپی می‌کند. این امکان را فراهم می‌کند که با استفاده از :deco:`property` به‌عنوان یک :term:`دکوراتور `، به‌سادگی ویژگی‌های فقط‌خواندنی ایجاد شوند::" +msgid "If given, *doc* will be the docstring of the property attribute. Otherwise, the property will copy *fget*'s docstring (if it exists). This makes it possible to create read-only properties easily using :func:`property` as a :term:`decorator`::" +msgstr "اگر *doc* مشخص شده باشد، به‌عنوان docstring ویژگی property استفاده خواهد شد. در غیر این صورت، property، docstring مربوط به *fget* را (در صورت وجود) کپی می‌کند. این امکان را فراهم می‌کند که با استفاده از :func:`property` به‌عنوان یک :term:`دکوراتور `، به‌سادگی ویژگی‌های فقط‌خواندنی ایجاد شوند::" msgid "" "class Parrot:\n" @@ -1405,7 +1405,7 @@ msgid "Rather than being a function, :class:`range` is actually an immutable seq msgstr ":class:`range` در واقع یک نوع دنبالهٔ تغییرناپذیر است، نه یک تابع؛ همان‌گونه که در :ref:`typesseq-range` و :ref:`typesseq` مستند شده است." msgid "Return a string containing a printable representation of an object. For many types, this function makes an attempt to return a string that would yield an object with the same value when passed to :func:`eval`; otherwise, the representation is a string enclosed in angle brackets that contains the name of the type of the object together with additional information often including the name and address of the object. A class can control what this function returns for its instances by defining a :meth:`~object.__repr__` method. If :func:`sys.displayhook` is not accessible, this function will raise :exc:`RuntimeError`." -msgstr "رشته‌ای را برمی‌گرداند که نمایش قابل چاپی از یک شیء را در بر دارد. برای بسیاری از نوع‌ها، این تابع تلاش می‌کند رشته‌ای برگرداند که اگر به :func:`eval` داده شود، شی‌ءای با همان مقدار تولید کند؛ در غیر این صورت، نمایش به‌صورت رشته‌ای درون کروشه‌های زاویه‌دار خواهد بود که نام نوع شیء و اطلاعات اضافی، که معمولاً شامل نام و نشانی شیء است، در آن قرار دارد. یک کلاس می‌تواند با تعریف متد :meth:`~object.__repr__` مشخص کند که این تابع برای نمونه‌های آن چه مقداری برگرداند. اگر :func:`sys.displayhook` در دسترس نباشد، این تابع استثنای :exc:`RuntimeError` پرتاب می‌کند." +msgstr "رشته‌ای را برمی‌گرداند که نمایش قابل چاپی از یک شیء را در بر دارد. برای بسیاری از نوع‌ها، این تابع تلاش می‌کند رشته‌ای برگرداند که اگر به :func:`eval` داده شود، شیئی با همان مقدار تولید کند؛ در غیر این صورت، نمایش به‌صورت رشته‌ای درون کروشه‌های زاویه‌دار خواهد بود که نام نوع شیء و اطلاعات اضافی، که معمولاً شامل نام و نشانی شیء است، در آن قرار دارد. یک کلاس می‌تواند با تعریف متد :meth:`~object.__repr__` مشخص کند که این تابع برای نمونه‌های آن چه مقداری برگرداند. اگر :func:`sys.displayhook` در دسترس نباشد، این تابع استثنای :exc:`RuntimeError` پرتاب می‌کند." msgid "This class has a custom representation that can be evaluated::" msgstr "این کلاس یک نمایش (representation) سفارشی دارد که قابل ارزیابی است::" @@ -1428,13 +1428,13 @@ msgstr "" " return f\"Person('{self.name}', {self.age})\"" msgid "Return a reverse :term:`iterator`. The argument must be an object which has a :meth:`~object.__reversed__` method or supports the sequence protocol (the :meth:`~object.__len__` method and the :meth:`~object.__getitem__` method with integer arguments starting at ``0``)." -msgstr "یک :term:`تکرارگر ` معکوس را برمی‌گرداند. آرگومان باید شی‌ءای باشد که متد :meth:`~object.__reversed__` را داشته باشد یا از پروتکل دنباله (متد :meth:`~object.__len__` و متد :meth:`~object.__getitem__` با آرگومان‌های صحیح که از ``0`` شروع می‌شوند) پشتیبانی کند." +msgstr "یک :term:`تکرارگر ` معکوس را برمی‌گرداند. آرگومان باید شیئی باشد که متد :meth:`~object.__reversed__` را داشته باشد یا از پروتکل دنباله (متد :meth:`~object.__len__` و متد :meth:`~object.__getitem__` با آرگومان‌های صحیح که از ``0`` شروع می‌شوند) پشتیبانی کند." msgid "Return *number* rounded to *ndigits* precision after the decimal point. If *ndigits* is omitted or is ``None``, it returns the nearest integer to its input." msgstr "*number* را با دقت *ndigits* رقم پس از ممیز گرد می‌کند. اگر *ndigits* حذف شده باشد یا برابر ``None`` باشد، نزدیک‌ترین عدد صحیح به ورودی را برمی‌گرداند." msgid "For the built-in types supporting :func:`round`, values are rounded to the closest multiple of 10 to the power minus *ndigits*; if two multiples are equally close, rounding is done toward the even choice (so, for example, both ``round(0.5)`` and ``round(-0.5)`` are ``0``, and ``round(1.5)`` is ``2``). Any integer value is valid for *ndigits* (positive, zero, or negative). The return value is an integer if *ndigits* is omitted or ``None``. Otherwise, the return value has the same type as *number*." -msgstr "برای انواع توکاری که از :func:`round` پشتیبانی می‌کنند، مقادیر به نزدیک‌ترین مضرب 10 به توان منفی *ndigits* گرد می‌شوند. اگر دو مضرب به یک اندازه نزدیک باشند، گرد کردن به سمت مقدار زوج انجام می‌شود (برای مثال، هر دو عبارت ``round(0.5)`` و ``round(-0.5)`` برابر ``0`` هستند و ``round(1.5)`` برابر ``2`` است). هر مقدار صحیحی (مثبت، صفر یا منفی) برای *ndigits* معتبر است. اگر *ndigits* حذف شود یا ``None`` باشد، مقدار بازگشتی یک عدد صحیح خواهد بود. در غیر این صورت، مقدار بازگشتی همان نوع *number* را خواهد داشت." +msgstr "برای انواع داخلی‌ای که از :func:`round` پشتیبانی می‌کنند، مقادیر به نزدیک‌ترین مضرب 10 به توان منفی *ndigits* گرد می‌شوند. اگر دو مضرب به یک اندازه نزدیک باشند، گرد کردن به سمت مقدار زوج انجام می‌شود (برای مثال، هر دو عبارت ``round(0.5)`` و ``round(-0.5)`` برابر ``0`` هستند و ``round(1.5)`` برابر ``2`` است). هر مقدار صحیحی (مثبت، صفر یا منفی) برای *ndigits* معتبر است. اگر *ndigits* حذف شود یا ``None`` باشد، مقدار بازگشتی یک عدد صحیح خواهد بود. در غیر این صورت، مقدار بازگشتی همان نوع *number* را خواهد داشت." msgid "For a general Python object ``number``, ``round`` delegates to ``number.__round__``." msgstr "برای یک شیء عمومی پایتون به نام ``number``، تابع ``round`` فراخوانی را به ``number.__round__`` واگذار می‌کند." @@ -1442,11 +1442,11 @@ msgstr "برای یک شیء عمومی پایتون به نام ``number``، ت msgid "The behavior of :func:`round` for floats can be surprising: for example, ``round(2.675, 2)`` gives ``2.67`` instead of the expected ``2.68``. This is not a bug: it's a result of the fact that most decimal fractions can't be represented exactly as a float. See :ref:`tut-fp-issues` for more information." msgstr "رفتار :func:`round` برای اعداد ممیز شناور ممکن است غافلگیرکننده باشد؛ برای مثال، ``round(2.675, 2)`` به‌جای ``2.68`` مقدار ``2.67`` را برمی‌گرداند. این یک باگ نیست؛ بلکه نتیجهٔ این واقعیت است که بیشتر کسرهای ده‌دهی را نمی‌توان به‌طور دقیق به‌صورت عدد ممیز شناور نمایش داد. برای اطلاعات بیشتر به :ref:`tut-fp-issues` مراجعه کنید." -msgid "Return a new :class:`set` object, optionally with elements taken from *iterable*. :class:`set` is a built-in class. See also :ref:`types-set` for documentation about this class." -msgstr "یک شیء جدید از نوع :class:`set` را برمی‌گرداند و به صورت اختیاری، عناصر آن از *iterable* گرفته می‌شوند. :class:`set` یک کلاس توکار است. برای مستندات این کلاس، به :ref:`types-set` مراجعه کنید." +msgid "Return a new :class:`set` object, optionally with elements taken from *iterable*. ``set`` is a built-in class. See :class:`set` and :ref:`types-set` for documentation about this class." +msgstr "یک شیء جدید از نوع :class:`set` را برمی‌گرداند که در صورت ارائه، عناصر آن از *iterable* گرفته می‌شوند. ``set`` یک کلاس داخلی است. برای مستندات این کلاس، به :class:`set` و :ref:`types-set` مراجعه کنید." msgid "For other containers see the built-in :class:`frozenset`, :class:`list`, :class:`tuple`, and :class:`dict` classes, as well as the :mod:`collections` module." -msgstr "برای سایر انواع محفظه‌ها، به کلاس‌های توکار :class:`frozenset`، :class:`list`، :class:`tuple` و :class:`dict`، و همچنین ماژول :mod:`collections` مراجعه کنید." +msgstr "برای سایر انواع محفظه‌ها، به کلاس‌های داخلی :class:`frozenset`، :class:`list`، :class:`tuple` و :class:`dict`، و همچنین ماژول :mod:`collections` مراجعه کنید." msgid "This is the counterpart of :func:`getattr`. The arguments are an object, a string, and an arbitrary value. The string may name an existing attribute or a new attribute. The function assigns the value to the attribute, provided the object allows it. For example, ``setattr(x, 'foobar', 123)`` is equivalent to ``x.foobar = 123``." msgstr "این تابع همتای :func:`getattr` است. آرگومان‌های آن یک شیء، یک رشته و یک مقدار دلخواه هستند. رشته می‌تواند نام یک ویژگی موجود یا یک ویژگی جدید باشد. در صورت مجاز بودن، تابع مقدار را به آن ویژگی اختصاص می‌دهد. برای مثال، ``setattr(x, 'foobar', 123)`` معادل ``x.foobar = 123`` است." @@ -1488,7 +1488,7 @@ msgid "Use :func:`functools.cmp_to_key` to convert an old-style *cmp* function t msgstr "برای تبدیل یک تابع *cmp* به سبک قدیمی به یک تابع *key*، از :func:`functools.cmp_to_key` استفاده کنید." msgid "The built-in :func:`sorted` function is guaranteed to be stable. A sort is stable if it guarantees not to change the relative order of elements that compare equal --- this is helpful for sorting in multiple passes (for example, sort by department, then by salary grade)." -msgstr "تابع توکار :func:`sorted` تضمین می‌کند که مرتب‌سازی پایدار باشد. مرتب‌سازی پایدار به این معناست که ترتیب نسبی عناصری که با هم برابر مقایسه می‌شوند تغییر نمی‌کند؛ این ویژگی برای مرتب‌سازی چندمرحله‌ای (برای مثال، ابتدا بر اساس دپارتمان و سپس بر اساس ردهٔ حقوق) مفید است." +msgstr "تابع داخلی :func:`sorted` تضمین می‌کند که مرتب‌سازی پایدار باشد. مرتب‌سازی پایدار به این معناست که ترتیب نسبی عناصری که با هم برابر مقایسه می‌شوند تغییر نمی‌کند؛ این ویژگی برای مرتب‌سازی چندمرحله‌ای (برای مثال، ابتدا بر اساس دپارتمان و سپس بر اساس ردهٔ حقوق) مفید است." msgid "The sort algorithm uses only ``<`` comparisons between items. While defining an :meth:`~object.__lt__` method will suffice for sorting, :PEP:`8` recommends that all six :ref:`rich comparisons ` be implemented. This will help avoid bugs when using the same data with other ordering tools such as :func:`max` that rely on a different underlying method. Implementing all six comparisons also helps avoid confusion for mixed type comparisons which can call the reflected :meth:`~object.__gt__` method." msgstr "الگوریتم مرتب‌سازی تنها از مقایسه‌های ``<`` بین عناصر استفاده می‌کند. هرچند تعریف متد :meth:`~object.__lt__` برای مرتب‌سازی کافی است، :PEP:`8` توصیه می‌کند که هر شش عملگر :ref:`مقایسهٔ غنی ` پیاده‌سازی شوند. این کار به جلوگیری از بروز خطا هنگام استفاده از همان داده‌ها با ابزارهای مرتب‌سازی دیگری مانند :func:`max` که به متد زیربنایی متفاوتی متکی هستند کمک می‌کند. همچنین، پیاده‌سازی هر شش مقایسه از سردرگمی در مقایسهٔ انواع مختلف که ممکن است متد بازتابی :meth:`~object.__gt__` را فراخوانی کنند جلوگیری می‌کند." @@ -1517,8 +1517,8 @@ msgstr "شکل ``@staticmethod`` یک :term:`تزئین‌کننده msgid "A static method can be called either on the class (such as ``C.f()``) or on an instance (such as ``C().f()``). Moreover, the static method :term:`descriptor` is also callable, so it can be used in the class definition (such as ``f()``)." msgstr "یک متد ایستا را می‌توان هم روی خود کلاس (مانند ``C.f()``) و هم روی یک نمونه (مانند ``C().f()``) فراخوانی کرد. علاوه بر این، :term:`توصیفگر ` متد ایستا نیز فراخوانی‌پذیر است؛ بنابراین می‌توان از آن در تعریف کلاس (مانند ``f()``) استفاده کرد." -msgid "Static methods in Python are similar to those found in Java or C++. Also, see :deco:`classmethod` for a variant that is useful for creating alternate class constructors." -msgstr "متدهای ایستا در پایتون مشابه متدهای ایستای موجود در جاوا یا ++C هستند. همچنین، برای گونه‌ای که در ایجاد سازنده‌های جایگزین برای کلاس مفید است، به :deco:`classmethod` مراجعه کنید." +msgid "Static methods in Python are similar to those found in Java or C++. Also, see :func:`classmethod` for a variant that is useful for creating alternate class constructors." +msgstr "متدهای ایستا در پایتون مشابه متدهای ایستای موجود در جاوا یا ++C هستند. همچنین، برای گونه‌ای که در ایجاد سازنده‌های جایگزین برای کلاس مفید است، به :func:`classmethod` مراجعه کنید." msgid "Like all decorators, it is also possible to call ``staticmethod`` as a regular function and do something with its result. This is needed in some cases where you need a reference to a function from a class body and you want to avoid the automatic transformation to instance method. For these cases, use this idiom::" msgstr "مانند همهٔ دکوراتورها، می‌توان ``staticmethod`` را نیز به‌صورت یک تابع معمولی فراخوانی کرد و از نتیجهٔ آن استفاده نمود. این کار در برخی موارد که به ارجاعی به یک تابع از درون بدنهٔ کلاس نیاز دارید و می‌خواهید از تبدیل خودکار آن به متد نمونه جلوگیری کنید، ضروری است. در چنین مواردی، از الگوی زیر استفاده کنید::" @@ -1546,7 +1546,7 @@ msgid "Return a :class:`str` version of *object*. See :func:`str` for details." msgstr "نسخه‌ای از *object* از نوع :class:`str` را برمی‌گرداند. برای جزئیات بیشتر، به :func:`str` مراجعه کنید." msgid "``str`` is the built-in string :term:`class`. For general information about strings, see :ref:`textseq`." -msgstr "``str`` :term:`کلاس ` رشتهٔ توکار پایتون است. برای اطلاعات کلی دربارهٔ رشته‌ها، :ref:`textseq` را ببینید." +msgstr "``str`` :term:`کلاس ` رشتهٔ داخلی پایتون است. برای اطلاعات کلی دربارهٔ رشته‌ها، :ref:`textseq` را ببینید." msgid "Sums *start* and the items of an *iterable* from left to right and returns the total. The *iterable*'s items are normally numbers, and the start value is not allowed to be a string." msgstr "*start* و عناصر *iterable* را از چپ به راست با هم جمع می‌کند و مجموع را برمی‌گرداند. عناصر *iterable* معمولاً عدد هستند و مقدار *start* مجاز نیست رشته باشد." @@ -1620,10 +1620,10 @@ msgid "Rather than being a function, :class:`tuple` is actually an immutable seq msgstr ":class:`tuple` در واقع یک نوع دنبالهٔ تغییرناپذیر است، نه یک تابع؛ همان‌گونه که در :ref:`typesseq-tuple` و :ref:`typesseq` مستند شده است." msgid "With one argument, return the type of an *object*. The return value is a type object and generally the same object as returned by :attr:`object.__class__`." -msgstr "در صورت ارسال یک آرگومان، نوعِ یک *object* را بازمی‌گرداند. مقدار بازگشتی یک شیء از نوع type است و معمولاً همان شی‌ءای است که توسط :attr:`object.__class__` بازگردانده می‌شود." +msgstr "در صورت ارسال یک آرگومان، نوعِ یک *object* را بازمی‌گرداند. مقدار بازگشتی یک شیء از نوع type است و معمولاً همان شیئی است که توسط :attr:`object.__class__` بازگردانده می‌شود." msgid "The :func:`isinstance` built-in function is recommended for testing the type of an object, because it takes subclasses into account." -msgstr "برای بررسی نوع یک شیء، استفاده از تابع توکار :func:`isinstance` توصیه می‌شود، زیرا زیرکلاس‌ها را نیز در نظر می‌گیرد." +msgstr "برای بررسی نوع یک شیء، استفاده از تابع داخلی :func:`isinstance` توصیه می‌شود، زیرا زیرکلاس‌ها را نیز در نظر می‌گیرد." msgid "With three arguments, return a new type object. This is essentially a dynamic form of the :keyword:`class` statement. The *name* string is the class name and becomes the :attr:`~type.__name__` attribute. The *bases* tuple contains the base classes and becomes the :attr:`~type.__bases__` attribute; if empty, :class:`object`, the ultimate base of all classes, is added. The *dict* dictionary contains attribute and method definitions for the class body; it may be copied or wrapped before becoming the :attr:`~type.__dict__` attribute. The following two statements create identical :class:`!type` objects:" msgstr "در صورت ارسال سه آرگومان، یک شیء type جدید بازمی‌گرداند. این در واقع شکل پویای دستور :keyword:`class` است. رشتهٔ *name* نام کلاس را مشخص می‌کند و به ویژگی :attr:`~type.__name__` تبدیل می‌شود. تاپل *bases* کلاس‌های پایه را در خود نگه می‌دارد و به ویژگی :attr:`~type.__bases__` تبدیل می‌شود؛ اگر خالی باشد، :class:`object`، که کلاس پایهٔ نهایی همهٔ کلاس‌ها است، به آن افزوده می‌شود. دیکشنری *dict* شامل تعریف ویژگی‌ها و متدهای بدنهٔ کلاس است؛ این دیکشنری ممکن است پیش از تبدیل شدن به ویژگی :attr:`~type.__dict__` کپی یا در یک wrapper قرار داده شود. دو دستور زیر اشیای :class:`!type` یکسانی ایجاد می‌کنند:" @@ -1638,10 +1638,7 @@ msgid ":ref:`bltin-type-objects`" msgstr ":ref:`bltin-type-objects`" msgid "Keyword arguments provided to the three argument form are passed to the appropriate metaclass machinery (usually :meth:`~object.__init_subclass__`) in the same way that keywords in a class definition (besides *metaclass*) would." -msgstr "آرگومان‌های کلیدواژه‌ای که به شکل سه‌آرگومانی ارسال می‌شوند، همانند کلیدواژه‌های موجود در تعریف یک کلاس (به‌جز *فراکلاس*) به سازوکار مناسب فراداده (معمولاً :meth:`~object.__init_subclass__`) ارسال می‌شوند." - -msgid "Unlike a :keyword:`class` statement, the three argument form does not call the metaclass ``__prepare__`` method (see :ref:`prepare`). Use :func:`types.new_class` to dynamically create a class using the appropriate metaclass." -msgstr "برخلاف دستور :keyword:`class`، فرم سه‌آرگومانی متد ``__prepare__`` فراکلاس را فراخوانی نمی‌کند (به :ref:`prepare` مراجعه کنید). برای ایجاد پویای یک کلاس با استفاده از فراکلاس مناسب، از :func:`types.new_class` استفاده کنید." +msgstr "آرگومان‌های کلیدواژه‌ای که به شکل سه‌آرگومانی ارسال می‌شوند، همانند کلیدواژه‌های موجود در تعریف یک کلاس (به‌جز *فرا‌داده*) به سازوکار مناسب فراداده (معمولاً :meth:`~object.__init_subclass__`) ارسال می‌شوند." msgid "See also :ref:`class-customization`." msgstr "همچنین به :ref:`class-customization` مراجعه کنید." @@ -1659,10 +1656,10 @@ msgid "Without an argument, :func:`vars` acts like :func:`locals`." msgstr "در صورت نداشتن آرگومان، :func:`vars` همانند :func:`locals` عمل می‌کند." msgid "A :exc:`TypeError` exception is raised if an object is specified but it doesn't have a :attr:`~object.__dict__` attribute (for example, if its class defines the :attr:`~object.__slots__` attribute)." -msgstr "اگر شی‌ءای مشخص شود اما دارای ویژگی :attr:`~object.__dict__` نباشد (برای مثال، اگر کلاس آن ویژگی :attr:`~object.__slots__` را تعریف کرده باشد)، استثنای :exc:`TypeError` پرتاب می‌شود." +msgstr "اگر شیئی مشخص شود اما دارای ویژگی :attr:`~object.__dict__` نباشد (برای مثال، اگر کلاس آن ویژگی :attr:`~object.__slots__` را تعریف کرده باشد)، استثنای :exc:`TypeError` پرتاب می‌شود." msgid "The result of calling this function without an argument has been updated as described for the :func:`locals` builtin." -msgstr "نتیجهٔ فراخوانی این تابع بدون آرگومان، مطابق توضیحات ارائه‌شده برای تابع توکار :func:`locals` به‌روزرسانی شده است." +msgstr "نتیجهٔ فراخوانی این تابع بدون آرگومان، مطابق توضیحات ارائه‌شده برای تابع داخلی :func:`locals` به‌روزرسانی شده است." msgid "Iterate over several iterables in parallel, producing tuples with an item from each one." msgstr "روی چندین تکرارپذیر به‌طور هم‌زمان پیمایش می‌کند و تاپل‌هایی تولید می‌کند که هر یک شامل یک عنصر از هر تکرارپذیر هستند." @@ -1786,7 +1783,7 @@ msgid "spam = __import__('spam.ham', globals(), locals(), [], 0)" msgstr "spam = __import__('spam.ham', globals(), locals(), [], 0)" msgid "Note how :func:`__import__` returns the toplevel module here because this is the object that is bound to a name by the :keyword:`import` statement." -msgstr "توجه داشته باشید که :func:`__import__` در اینجا ماژول سطح بالا را برمی‌گرداند، زیرا این همان شی‌ءای است که توسط دستور :keyword:`import` به یک نام منتسب می‌شود." +msgstr "توجه داشته باشید که :func:`__import__` در اینجا ماژول سطح بالا را برمی‌گرداند، زیرا این همان شیئی است که توسط دستور :keyword:`import` به یک نام منتسب می‌شود." msgid "On the other hand, the statement ``from spam.ham import eggs, sausage as saus`` results in ::" msgstr "از سوی دیگر، دستور ``from spam.ham import eggs, sausage as saus`` به نتیجهٔ زیر منجر می‌شود::" @@ -1825,7 +1822,7 @@ msgid "type" msgstr "نوع" msgid "built-in function" -msgstr "تابع توکار" +msgstr "تابع پیش ساخته" msgid "exec" msgstr "exec" @@ -1843,13 +1840,13 @@ msgid "string" msgstr "رشته" msgid "format() (built-in function)" -msgstr "format() (تابع توکار)" +msgstr "format() (تابع پیش ساخته)" msgid "file object" msgstr "شیء پرونده" msgid "open() built-in function" -msgstr "تابع توکار open()" +msgstr "تابع داخلی open()" msgid "file" msgstr "پرونده" @@ -1885,7 +1882,7 @@ msgid "sys" msgstr "sys" msgid "str() (built-in function)" -msgstr "str() (تابع توکار)" +msgstr "str() (تابع داخلی)" msgid "object" msgstr "شیء" @@ -1897,4 +1894,4 @@ msgid "import" msgstr "ایمپورت" msgid "builtins" -msgstr "توکار‌ها" +msgstr "پیش ساخته‌ها" diff --git a/library/functools.po b/library/functools.po index 9bb54a607..fa599fe56 100644 --- a/library/functools.po +++ b/library/functools.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:06+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -38,7 +38,7 @@ msgstr "" msgid "Simple lightweight unbounded function cache. Sometimes called `\"memoize\" `_." msgstr "" -msgid "Returns the same as ``lru_cache(maxsize=None)``, creating a thin wrapper around a dictionary lookup for the function arguments. Because it never needs to evict old values, this is smaller and faster than :deco:`lru_cache` with a size limit." +msgid "Returns the same as ``lru_cache(maxsize=None)``, creating a thin wrapper around a dictionary lookup for the function arguments. Because it never needs to evict old values, this is smaller and faster than :func:`lru_cache` with a size limit." msgstr "" msgid "For example::" @@ -63,7 +63,7 @@ msgstr "" msgid "It is possible for the wrapped function to be called more than once if another thread makes an additional call before the initial call has been completed and cached." msgstr "" -msgid "Transform a method of a class into a property whose value is computed once and then cached as a normal attribute for the life of the instance. Similar to :deco:`property`, with the addition of caching. Useful for expensive computed properties of instances that are otherwise effectively immutable." +msgid "Transform a method of a class into a property whose value is computed once and then cached as a normal attribute for the life of the instance. Similar to :func:`property`, with the addition of caching. Useful for expensive computed properties of instances that are otherwise effectively immutable." msgstr "" msgid "Example::" @@ -80,7 +80,7 @@ msgid "" " return statistics.stdev(self._data)" msgstr "" -msgid "The mechanics of :deco:`cached_property` are somewhat different from :deco:`property`. A regular property blocks attribute writes unless a setter is defined. In contrast, a *cached_property* allows writes." +msgid "The mechanics of :func:`cached_property` are somewhat different from :func:`property`. A regular property blocks attribute writes unless a setter is defined. In contrast, a *cached_property* allows writes." msgstr "" msgid "The *cached_property* decorator only runs on lookups and only when an attribute of the same name doesn't exist. When it does run, the *cached_property* writes to the attribute with the same name. Subsequent attribute reads and writes take precedence over the *cached_property* method and it works like a normal attribute." @@ -98,10 +98,10 @@ msgstr "" msgid "Also, this decorator requires that the ``__dict__`` attribute on each instance be a mutable mapping. This means it will not work with some types, such as metaclasses (since the ``__dict__`` attributes on type instances are read-only proxies for the class namespace), and those that specify ``__slots__`` without including ``__dict__`` as one of the defined slots (as such classes don't provide a ``__dict__`` attribute at all)." msgstr "" -msgid "If a mutable mapping is not available or if space-efficient key sharing is desired, an effect similar to :deco:`cached_property` can also be achieved by stacking :deco:`property` on top of :deco:`lru_cache`. See :ref:`faq-cache-method-calls` for more details on how this differs from :deco:`cached_property`." +msgid "If a mutable mapping is not available or if space-efficient key sharing is desired, an effect similar to :func:`cached_property` can also be achieved by stacking :func:`property` on top of :func:`lru_cache`. See :ref:`faq-cache-method-calls` for more details on how this differs from :func:`cached_property`." msgstr "" -msgid "Prior to Python 3.12, :deco:`!cached_property` included an undocumented lock to ensure that in multi-threaded usage the getter function was guaranteed to run only once per instance. However, the lock was per-property, not per-instance, which could result in unacceptably high lock contention. In Python 3.12+ this locking is removed." +msgid "Prior to Python 3.12, ``cached_property`` included an undocumented lock to ensure that in multi-threaded usage the getter function was guaranteed to run only once per instance. However, the lock was per-property, not per-instance, which could result in unacceptably high lock contention. In Python 3.12+ this locking is removed." msgstr "" msgid "Transform an old-style comparison function to a :term:`key function`. Used with tools that accept key functions (such as :func:`sorted`, :func:`min`, :func:`max`, :func:`heapq.nlargest`, :func:`heapq.nsmallest`, :func:`itertools.groupby`). This function is primarily used as a transition tool for programs being converted from Python 2 which supported the use of comparison functions." @@ -289,7 +289,7 @@ msgstr "" msgid "Calling ``say_to_world('Hello')`` raises a :exc:`TypeError`, because only one positional argument is provided, but there are two placeholders that must be filled in." msgstr "" -msgid "If :func:`!partial` is applied to an existing :ref:`partial object `, :data:`!Placeholder` sentinels of the input object are filled in with new positional arguments. A placeholder can be retained by inserting a new :data:`!Placeholder` sentinel to the place held by a previous :data:`!Placeholder`:" +msgid "If :func:`!partial` is applied to an existing :func:`!partial` object, :data:`!Placeholder` sentinels of the input object are filled in with new positional arguments. A placeholder can be retained by inserting a new :data:`!Placeholder` sentinel to the place held by a previous :data:`!Placeholder`:" msgstr "" msgid "" @@ -594,7 +594,7 @@ msgstr "" msgid "Update a *wrapper* function to look like the *wrapped* function. The optional arguments are tuples to specify which attributes of the original function are assigned directly to the matching attributes on the wrapper function and which attributes of the wrapper function are updated with the corresponding attributes from the original function. The default values for these arguments are the module level constants ``WRAPPER_ASSIGNMENTS`` (which assigns to the wrapper function's :attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__annotations__`, :attr:`~function.__type_params__`, and :attr:`~function.__doc__`, the documentation string) and ``WRAPPER_UPDATES`` (which updates the wrapper function's :attr:`~function.__dict__`, i.e. the instance dictionary)." msgstr "" -msgid "To allow access to the original function for introspection and other purposes (e.g. bypassing a caching decorator such as :deco:`lru_cache`), this function automatically adds a ``__wrapped__`` attribute to the wrapper that refers to the function being wrapped." +msgid "To allow access to the original function for introspection and other purposes (e.g. bypassing a caching decorator such as :func:`lru_cache`), this function automatically adds a ``__wrapped__`` attribute to the wrapper that refers to the function being wrapped." msgstr "" msgid "The main intended use for this function is in :term:`decorator` functions which wrap the decorated function and return the wrapper. If the wrapper function is not updated, the metadata of the returned function will reflect the wrapper definition rather than the original function definition, which is typically less than helpful." diff --git a/library/gc.po b/library/gc.po index 6c9eb47d1..688293fff 100644 --- a/library/gc.po +++ b/library/gc.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/getopt.po b/library/getopt.po index fd9279349..a2e44afab 100644 --- a/library/getopt.po +++ b/library/getopt.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -48,9 +48,6 @@ msgstr "" msgid "*longopts*, if specified, must be a list of strings with the names of the long options which should be supported. The leading ``'--'`` characters should not be included in the option name. Long options which require an argument should be followed by an equal sign (``'='``). Long options which accept an optional argument should be followed by an equal sign and question mark (``'=?'``). To accept only long options, *shortopts* should be an empty string. Long options on the command line can be recognized so long as they provide a prefix of the option name that matches exactly one of the accepted options. For example, if *longopts* is ``['foo', 'frob']``, the option ``--fo`` will match as ``--foo``, but ``--f`` will not match uniquely, so :exc:`GetoptError` will be raised." msgstr "" -msgid "If *longopts* is a string it gets treated as a list of a single element." -msgstr "" - msgid "The return value consists of two elements: the first is a list of ``(option, value)`` pairs; the second is the list of program arguments left after the option list was stripped (this is a trailing slice of *args*). Each option-and-value pair returned has the option as its first element, prefixed with a hyphen for short options (e.g., ``'-x'``) or two hyphens for long options (e.g., ``'--long-option'``), and the option argument as its second element, or an empty string if the option has no argument. The options occur in the list in the same order in which they were found, thus allowing multiple occurrences. Long and short options may be mixed." msgstr "" diff --git a/library/getpass.po b/library/getpass.po index b4c94effd..35c99c4f0 100644 --- a/library/getpass.po +++ b/library/getpass.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/gettext.po b/library/gettext.po index 4a9e77c1a..08935f313 100644 --- a/library/gettext.po +++ b/library/gettext.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:06+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/glob.po b/library/glob.po index 21cae6702..7438b069d 100644 --- a/library/glob.po +++ b/library/glob.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:06+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -36,7 +36,7 @@ msgstr "" msgid "The pathnames are returned in no particular order. If you need a specific order, sort the results." msgstr "" -msgid "By default, files beginning with a dot (``.``) can only be matched by patterns that also start with a dot, unlike :func:`fnmatch.fnmatch` or :func:`pathlib.Path.glob`. For tilde and shell variable expansion, use :func:`os.path.expanduser` and :func:`os.path.expandvars`." +msgid "Files beginning with a dot (``.``) can only be matched by patterns that also start with a dot, unlike :func:`fnmatch.fnmatch` or :func:`pathlib.Path.glob`. For tilde and shell variable expansion, use :func:`os.path.expanduser` and :func:`os.path.expandvars`." msgstr "" msgid "For a literal match, wrap the meta-characters in brackets. For example, ``'[?]'`` matches the character ``'?'``." @@ -57,7 +57,7 @@ msgstr "" msgid "If *recursive* is true, the pattern \"``**``\" will match any files and zero or more directories, subdirectories and symbolic links to directories. If the pattern is followed by an :data:`os.sep` or :data:`os.altsep` then files will not match." msgstr "" -msgid "If *include_hidden* is true, wildcards can match path segments that begin with a dot (``.``)." +msgid "If *include_hidden* is true, \"``**``\" pattern will match hidden directories." msgstr "" msgid "Raises an :ref:`auditing event ` ``glob.glob`` with arguments ``pathname``, ``recursive``." @@ -87,7 +87,7 @@ msgstr "" msgid "Return an :term:`iterator` which yields the same values as :func:`glob` without actually storing them all simultaneously." msgstr "" -msgid "Escape all special characters (``'?'``, ``'*'`` and ``'['``). This is useful if you want to match an arbitrary literal string that may have special characters in it. Special characters in drive/UNC sharepoints are not escaped, for example on Windows ``escape('//?/c:/Quo vadis?.txt')`` returns ``'//?/c:/Quo vadis[?].txt'``." +msgid "Escape all special characters (``'?'``, ``'*'`` and ``'['``). This is useful if you want to match an arbitrary literal string that may have special characters in it. Special characters in drive/UNC sharepoints are not escaped, e.g. on Windows ``escape('//?/c:/Quo vadis?.txt')`` returns ``'//?/c:/Quo vadis[?].txt'``." msgstr "" msgid "Convert the given path specification to a regular expression for use with :func:`re.match`. The path specification can contain shell-style wildcards." diff --git a/library/graphlib.po b/library/graphlib.po index 1c72571f6..93929cc3b 100644 --- a/library/graphlib.po +++ b/library/graphlib.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:06+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/grp.po b/library/grp.po index f8f37161a..e9877e110 100644 --- a/library/grp.po +++ b/library/grp.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:07+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/gzip.po b/library/gzip.po index 42cfb0369..e7b65db06 100644 --- a/library/gzip.po +++ b/library/gzip.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:07+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/hashlib.po b/library/hashlib.po index 9b0ac8c1d..0ace06831 100644 --- a/library/hashlib.po +++ b/library/hashlib.po @@ -16,10 +16,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:07+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/heapq.po b/library/heapq.po index eaadbeb8d..4b0fc2117 100644 --- a/library/heapq.po +++ b/library/heapq.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:07+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/hmac.po b/library/hmac.po index 3c3fbe15c..253109dfb 100644 --- a/library/hmac.po +++ b/library/hmac.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:07+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/html.entities.po b/library/html.entities.po index cf12e5c5b..4e7de802c 100644 --- a/library/html.entities.po +++ b/library/html.entities.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:07+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/html.parser.po b/library/html.parser.po index 694d17d8e..6e69b424e 100644 --- a/library/html.parser.po +++ b/library/html.parser.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:07+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/html.po b/library/html.po index 8fdbe9b7a..089045284 100644 --- a/library/html.po +++ b/library/html.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/http.client.po b/library/http.client.po index 43742dabb..c27a9b00b 100644 --- a/library/http.client.po +++ b/library/http.client.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:07+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/http.cookiejar.po b/library/http.cookiejar.po index 6a5724935..114b7a8be 100644 --- a/library/http.cookiejar.po +++ b/library/http.cookiejar.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:07+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -36,7 +36,7 @@ msgstr "" msgid "Both the regular Netscape cookie protocol and the protocol defined by :rfc:`2965` are handled. RFC 2965 handling is switched off by default. :rfc:`2109` cookies are parsed as Netscape cookies and subsequently treated either as Netscape or RFC 2965 cookies according to the 'policy' in effect. Note that the great majority of cookies on the internet are Netscape cookies. :mod:`!http.cookiejar` attempts to follow the de-facto Netscape cookie protocol (which differs substantially from that set out in the original Netscape specification), including taking note of the ``max-age`` and ``port`` cookie-attributes introduced with RFC 2965." msgstr "" -msgid "The various named parameters found in :mailheader:`Set-Cookie` and :mailheader:`Set-Cookie2` headers (for example, ``domain`` and ``expires``) are conventionally referred to as :dfn:`attributes`. To distinguish them from Python attributes, the documentation for this module uses the term :dfn:`cookie-attribute` instead." +msgid "The various named parameters found in :mailheader:`Set-Cookie` and :mailheader:`Set-Cookie2` headers (eg. ``domain`` and ``expires``) are conventionally referred to as :dfn:`attributes`. To distinguish them from Python attributes, the documentation for this module uses the term :dfn:`cookie-attribute` instead." msgstr "" msgid "The module defines the following exception:" @@ -72,13 +72,13 @@ msgstr "" msgid "This class is responsible for deciding whether each cookie should be accepted from / returned to the server." msgstr "" -msgid "Constructor arguments should be passed as keyword arguments only. *blocked_domains* is a sequence of domain names that we never accept cookies from, nor return cookies to. *allowed_domains* if not ``None``, this is a sequence of the only domains for which we accept and return cookies. *secure_protocols* is a sequence of protocols for which secure cookies can be added to. By default *https* and *wss* (secure websocket) are considered secure protocols. For all other arguments, see the documentation for :class:`CookiePolicy` and :class:`DefaultCookiePolicy` objects." +msgid "Constructor arguments should be passed as keyword arguments only. *blocked_domains* is a sequence of domain names that we never accept cookies from, nor return cookies to. *allowed_domains* if not :const:`None`, this is a sequence of the only domains for which we accept and return cookies. *secure_protocols* is a sequence of protocols for which secure cookies can be added to. By default *https* and *wss* (secure websocket) are considered secure protocols. For all other arguments, see the documentation for :class:`CookiePolicy` and :class:`DefaultCookiePolicy` objects." msgstr "" -msgid ":class:`DefaultCookiePolicy` implements the standard accept / reject rules for Netscape and :rfc:`2965` cookies. By default, :rfc:`2109` cookies (that is, cookies received in a :mailheader:`Set-Cookie` header with a version cookie-attribute of 1) are treated according to the RFC 2965 rules. However, if RFC 2965 handling is turned off or :attr:`rfc2109_as_netscape` is ``True``, RFC 2109 cookies are 'downgraded' by the :class:`CookieJar` instance to Netscape cookies, by setting the :attr:`~Cookie.version` attribute of the :class:`Cookie` instance to 0. :class:`DefaultCookiePolicy` also provides some parameters to allow some fine-tuning of policy." +msgid ":class:`DefaultCookiePolicy` implements the standard accept / reject rules for Netscape and :rfc:`2965` cookies. By default, :rfc:`2109` cookies (ie. cookies received in a :mailheader:`Set-Cookie` header with a version cookie-attribute of 1) are treated according to the RFC 2965 rules. However, if RFC 2965 handling is turned off or :attr:`rfc2109_as_netscape` is ``True``, RFC 2109 cookies are 'downgraded' by the :class:`CookieJar` instance to Netscape cookies, by setting the :attr:`version` attribute of the :class:`Cookie` instance to 0. :class:`DefaultCookiePolicy` also provides some parameters to allow some fine-tuning of policy." msgstr "" -msgid "This class represents Netscape, :rfc:`2109` and :rfc:`2965` cookies. It is not expected that users of :mod:`!http.cookiejar` construct their own :class:`Cookie` instances. Instead, if necessary, call :meth:`~CookieJar.make_cookies` on a :class:`CookieJar` instance." +msgid "This class represents Netscape, :rfc:`2109` and :rfc:`2965` cookies. It is not expected that users of :mod:`!http.cookiejar` construct their own :class:`Cookie` instances. Instead, if necessary, call :meth:`make_cookies` on a :class:`CookieJar` instance." msgstr "" msgid "Module :mod:`urllib.request`" @@ -120,7 +120,7 @@ msgstr "" msgid ":rfc:`2964` - Use of HTTP State Management" msgstr "" -msgid "CookieJar and FileCookieJar objects" +msgid "CookieJar and FileCookieJar Objects" msgstr "" msgid ":class:`CookieJar` objects support the :term:`iterator` protocol for iterating over contained :class:`Cookie` objects." @@ -132,13 +132,13 @@ msgstr "" msgid "Add correct :mailheader:`Cookie` header to *request*." msgstr "" -msgid "If policy allows (that is, the :attr:`~CookiePolicy.rfc2965` and :attr:`~CookiePolicy.hide_cookie2` attributes of the :class:`CookieJar`'s :class:`CookiePolicy` instance are true and false respectively), the :mailheader:`Cookie2` header is also added when appropriate." +msgid "If policy allows (ie. the :attr:`rfc2965` and :attr:`hide_cookie2` attributes of the :class:`CookieJar`'s :class:`CookiePolicy` instance are true and false respectively), the :mailheader:`Cookie2` header is also added when appropriate." msgstr "" -msgid "The *request* object (usually a :class:`urllib.request.Request` instance) must support the methods :meth:`~urllib.request.Request.get_full_url`, :meth:`~urllib.request.Request.has_header`, :meth:`~urllib.request.Request.get_header`, :meth:`~urllib.request.Request.header_items`, :meth:`~urllib.request.Request.add_unredirected_header` and the attributes :attr:`~urllib.request.Request.host`, :attr:`~urllib.request.Request.type`, :attr:`~urllib.request.Request.unverifiable` and :attr:`~urllib.request.Request.origin_req_host` as documented by :mod:`urllib.request`." +msgid "The *request* object (usually a :class:`urllib.request.Request` instance) must support the methods :meth:`get_full_url`, :meth:`has_header`, :meth:`get_header`, :meth:`header_items`, :meth:`add_unredirected_header` and the attributes :attr:`host`, :attr:`!type`, :attr:`unverifiable` and :attr:`origin_req_host` as documented by :mod:`urllib.request`." msgstr "" -msgid "*request* object needs :attr:`~urllib.request.Request.origin_req_host` attribute. Dependency on a deprecated method :meth:`!get_origin_req_host` has been removed." +msgid "*request* object needs :attr:`origin_req_host` attribute. Dependency on a deprecated method :meth:`get_origin_req_host` has been removed." msgstr "" msgid "Extract cookies from HTTP *response* and store them in the :class:`CookieJar`, where allowed by policy." @@ -147,10 +147,10 @@ msgstr "" msgid "The :class:`CookieJar` will look for allowable :mailheader:`Set-Cookie` and :mailheader:`Set-Cookie2` headers in the *response* argument, and store cookies as appropriate (subject to the :meth:`CookiePolicy.set_ok` method's approval)." msgstr "" -msgid "The *response* object (usually the result of a call to :meth:`urllib.request.urlopen`, or similar) should support an :meth:`~http.client.HTTPResponse.info` method, which returns an :class:`email.message.Message` instance." +msgid "The *response* object (usually the result of a call to :meth:`urllib.request.urlopen`, or similar) should support an :meth:`info` method, which returns an :class:`email.message.Message` instance." msgstr "" -msgid "The *request* object (usually a :class:`urllib.request.Request` instance) must support the method :meth:`~urllib.request.Request.get_full_url` and the attributes :attr:`~urllib.request.Request.host`, :attr:`~urllib.request.Request.unverifiable` and :attr:`~urllib.request.Request.origin_req_host`, as documented by :mod:`urllib.request`. The request is used to set default values for cookie-attributes as well as for checking that the cookie is allowed to be set." +msgid "The *request* object (usually a :class:`urllib.request.Request` instance) must support the method :meth:`get_full_url` and the attributes :attr:`host`, :attr:`unverifiable` and :attr:`origin_req_host`, as documented by :mod:`urllib.request`. The request is used to set default values for cookie-attributes as well as for checking that the cookie is allowed to be set." msgstr "" msgid "Set the :class:`CookiePolicy` instance to be used." @@ -180,10 +180,10 @@ msgstr "" msgid "Discard all session cookies." msgstr "" -msgid "Discards all contained cookies that have a true :attr:`~Cookie.discard` attribute (usually because they had either no ``max-age`` or ``expires`` cookie-attribute, or an explicit ``discard`` cookie-attribute). For interactive browsers, the end of a session usually corresponds to closing the browser window." +msgid "Discards all contained cookies that have a true :attr:`discard` attribute (usually because they had either no ``max-age`` or ``expires`` cookie-attribute, or an explicit ``discard`` cookie-attribute). For interactive browsers, the end of a session usually corresponds to closing the browser window." msgstr "" -msgid "Note that the :meth:`~FileCookieJar.save` method won't save session cookies anyway, unless you ask otherwise by passing a true *ignore_discard* argument." +msgid "Note that the :meth:`save` method won't save session cookies anyway, unless you ask otherwise by passing a true *ignore_discard* argument." msgstr "" msgid ":class:`FileCookieJar` implements the following additional methods:" @@ -195,7 +195,7 @@ msgstr "" msgid "This base class raises :exc:`NotImplementedError`. Subclasses may leave this method unimplemented." msgstr "" -msgid "*filename* is the name of file in which to save cookies. If *filename* is not specified, :attr:`self.filename ` is used (whose default is the value passed to the constructor, if any); if :attr:`self.filename ` is ``None``, :exc:`ValueError` is raised." +msgid "*filename* is the name of file in which to save cookies. If *filename* is not specified, :attr:`self.filename` is used (whose default is the value passed to the constructor, if any); if :attr:`self.filename` is :const:`None`, :exc:`ValueError` is raised." msgstr "" msgid "*ignore_discard*: save even cookies set to be discarded. *ignore_expires*: save even cookies that have expired" @@ -255,7 +255,7 @@ msgstr "" msgid "A :class:`FileCookieJar` that can load from and save cookies to disk in format compatible with the libwww-perl library's ``Set-Cookie3`` file format. This is convenient if you want to store cookies in a human-readable file." msgstr "" -msgid "CookiePolicy objects" +msgid "CookiePolicy Objects" msgstr "" msgid "Objects implementing the :class:`CookiePolicy` interface have the following methods:" @@ -309,7 +309,7 @@ msgstr "" msgid "The most useful way to define a :class:`CookiePolicy` class is by subclassing from :class:`DefaultCookiePolicy` and overriding some or all of the methods above. :class:`CookiePolicy` itself may be used as a 'null policy' to allow setting and receiving any and all cookies (this is unlikely to be useful)." msgstr "" -msgid "DefaultCookiePolicy objects" +msgid "DefaultCookiePolicy Objects" msgstr "" msgid "Implements the standard rules for accepting and returning cookies." @@ -335,7 +335,7 @@ msgstr "" msgid "In addition to the features required to implement the :class:`CookiePolicy` interface, this class allows you to block and allow domains from setting and receiving cookies. There are also some strictness switches that allow you to tighten up the rather loose Netscape protocol rules a little bit (at the cost of blocking some benign cookies)." msgstr "" -msgid "A domain blocklist and allowlist is provided (both off by default). Only domains not in the blocklist and present in the allowlist (if the allowlist is active) participate in cookie setting and returning. Use the *blocked_domains* constructor argument, and :meth:`~DefaultCookiePolicy.blocked_domains` and :meth:`~DefaultCookiePolicy.set_blocked_domains` methods (and the corresponding argument and methods for *allowed_domains*). If you set an allowlist, you can turn it off again by setting it to ``None``." +msgid "A domain blocklist and allowlist is provided (both off by default). Only domains not in the blocklist and present in the allowlist (if the allowlist is active) participate in cookie setting and returning. Use the *blocked_domains* constructor argument, and :meth:`blocked_domains` and :meth:`set_blocked_domains` methods (and the corresponding argument and methods for *allowed_domains*). If you set an allowlist, you can turn it off again by setting it to :const:`None`." msgstr "" msgid "Domains in block or allow lists that do not start with a dot must equal the cookie domain to be matched. For example, ``\"example.com\"`` matches a blocklist entry of ``\"example.com\"``, but ``\"www.example.com\"`` does not. Domains that do start with a dot are matched by more specific domains too. For example, both ``\"www.example.com\"`` and ``\"www.coyote.example.com\"`` match ``\".example.com\"`` (but ``\"example.com\"`` itself does not). IP addresses are an exception, and must match exactly. For example, if blocked_domains contains ``\"192.168.1.2\"`` and ``\".168.1.2\"``, 192.168.1.2 is blocked, but 193.168.1.2 is not." @@ -353,10 +353,10 @@ msgstr "" msgid "Return ``True`` if *domain* is on the blocklist for setting or receiving cookies." msgstr "" -msgid "Return ``None``, or the sequence of allowed domains (as a tuple)." +msgid "Return :const:`None`, or the sequence of allowed domains (as a tuple)." msgstr "" -msgid "Set the sequence of allowed domains, or ``None``." +msgid "Set the sequence of allowed domains, or :const:`None`." msgstr "" msgid "Return ``True`` if *domain* is not on the allowlist for setting or receiving cookies." @@ -365,7 +365,7 @@ msgstr "" msgid ":class:`DefaultCookiePolicy` instances have the following attributes, which are all initialised from the constructor arguments of the same name, and which may all be assigned to." msgstr "" -msgid "If true, request that the :class:`CookieJar` instance downgrade :rfc:`2109` cookies (that is, cookies received in a :mailheader:`Set-Cookie` header with a version cookie-attribute of 1) to Netscape cookies by setting the version attribute of the :class:`Cookie` instance to 0. The default value is ``None``, in which case RFC 2109 cookies are downgraded if and only if :rfc:`2965` handling is turned off. Therefore, RFC 2109 cookies are downgraded by default." +msgid "If true, request that the :class:`CookieJar` instance downgrade :rfc:`2109` cookies (ie. cookies received in a :mailheader:`Set-Cookie` header with a version cookie-attribute of 1) to Netscape cookies by setting the version attribute of the :class:`Cookie` instance to 0. The default value is :const:`None`, in which case RFC 2109 cookies are downgraded if and only if :rfc:`2965` handling is turned off. Therefore, RFC 2109 cookies are downgraded by default." msgstr "" msgid "General strictness switches:" @@ -398,10 +398,10 @@ msgstr "" msgid ":attr:`~DefaultCookiePolicy.strict_ns_domain` is a collection of flags. Its value is constructed by or-ing together (for example, ``DomainStrictNoDots|DomainStrictNonDomain`` means both flags are set)." msgstr "" -msgid "When setting cookies, the 'host prefix' must not contain a dot (for example, ``www.foo.bar.com`` can't set a cookie for ``.bar.com``, because ``www.foo`` contains a dot)." +msgid "When setting cookies, the 'host prefix' must not contain a dot (eg. ``www.foo.bar.com`` can't set a cookie for ``.bar.com``, because ``www.foo`` contains a dot)." msgstr "" -msgid "Cookies that did not explicitly specify a ``domain`` cookie-attribute can only be returned to a domain equal to the domain that set the cookie (for example, ``spam.example.com`` won't be returned cookies from ``example.com`` that had no ``domain`` cookie-attribute)." +msgid "Cookies that did not explicitly specify a ``domain`` cookie-attribute can only be returned to a domain equal to the domain that set the cookie (eg. ``spam.example.com`` won't be returned cookies from ``example.com`` that had no ``domain`` cookie-attribute)." msgstr "" msgid "When setting cookies, require a full :rfc:`2965` domain-match." @@ -410,13 +410,13 @@ msgstr "" msgid "The following attributes are provided for convenience, and are the most useful combinations of the above flags:" msgstr "" -msgid "Equivalent to 0 (that is, all of the above Netscape domain strictness flags switched off)." +msgid "Equivalent to 0 (ie. all of the above Netscape domain strictness flags switched off)." msgstr "" msgid "Equivalent to ``DomainStrictNoDots|DomainStrictNonDomain``." msgstr "" -msgid "Cookie objects" +msgid "Cookie Objects" msgstr "" msgid ":class:`Cookie` instances have Python attributes roughly corresponding to the standard cookie-attributes specified in the various cookie standards. The correspondence is not one-to-one, because there are complicated rules for assigning default values, because the ``max-age`` and ``expires`` cookie-attributes contain equivalent information, and because :rfc:`2109` cookies may be 'downgraded' by :mod:`!http.cookiejar` from version 1 to version 0 (Netscape) cookies." @@ -425,40 +425,40 @@ msgstr "" msgid "Assignment to these attributes should not be necessary other than in rare circumstances in a :class:`CookiePolicy` method. The class does not enforce internal consistency, so you should know what you're doing if you do that." msgstr "" -msgid "Integer or ``None``. Netscape cookies have :attr:`version` 0. :rfc:`2965` and :rfc:`2109` cookies have a ``version`` cookie-attribute of 1. However, note that :mod:`!http.cookiejar` may 'downgrade' RFC 2109 cookies to Netscape cookies, in which case :attr:`version` is 0." +msgid "Integer or :const:`None`. Netscape cookies have :attr:`version` 0. :rfc:`2965` and :rfc:`2109` cookies have a ``version`` cookie-attribute of 1. However, note that :mod:`!http.cookiejar` may 'downgrade' RFC 2109 cookies to Netscape cookies, in which case :attr:`version` is 0." msgstr "" msgid "Cookie name (a string)." msgstr "" -msgid "Cookie value (a string), or ``None``." +msgid "Cookie value (a string), or :const:`None`." msgstr "" -msgid "String representing a port or a set of ports (for example, '80', or '80,8080'), or ``None``." +msgid "String representing a port or a set of ports (eg. '80', or '80,8080'), or :const:`None`." msgstr "" msgid "Cookie domain (a string)." msgstr "" -msgid "Cookie path (a string, for example, ``'/acme/rocket_launchers'``)." +msgid "Cookie path (a string, eg. ``'/acme/rocket_launchers'``)." msgstr "" msgid "``True`` if cookie should only be returned over a secure connection." msgstr "" -msgid "Integer expiry date in seconds since epoch, or ``None``. See also the :meth:`is_expired` method." +msgid "Integer expiry date in seconds since epoch, or :const:`None`. See also the :meth:`is_expired` method." msgstr "" msgid "``True`` if this is a session cookie." msgstr "" -msgid "String comment from the server explaining the function of this cookie, or ``None``." +msgid "String comment from the server explaining the function of this cookie, or :const:`None`." msgstr "" -msgid "URL linking to a comment from the server explaining the function of this cookie, or ``None``." +msgid "URL linking to a comment from the server explaining the function of this cookie, or :const:`None`." msgstr "" -msgid "``True`` if this cookie was received as an :rfc:`2109` cookie (that is, the cookie arrived in a :mailheader:`Set-Cookie` header, and the value of the Version cookie-attribute in that header was 1). This attribute is provided because :mod:`!http.cookiejar` may 'downgrade' RFC 2109 cookies to Netscape cookies, in which case :attr:`version` is 0." +msgid "``True`` if this cookie was received as an :rfc:`2109` cookie (ie. the cookie arrived in a :mailheader:`Set-Cookie` header, and the value of the Version cookie-attribute in that header was 1). This attribute is provided because :mod:`!http.cookiejar` may 'downgrade' RFC 2109 cookies to Netscape cookies, in which case :attr:`version` is 0." msgstr "" msgid "``True`` if a port or set of ports was explicitly specified by the server (in the :mailheader:`Set-Cookie` / :mailheader:`Set-Cookie2` header)." diff --git a/library/http.cookies.po b/library/http.cookies.po index 55663c582..52ee2ee44 100644 --- a/library/http.cookies.po +++ b/library/http.cookies.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:07+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/http.po b/library/http.po index 5a2cfa5be..00cd4c33e 100644 --- a/library/http.po +++ b/library/http.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:07+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/http.server.po b/library/http.server.po index 306e871fe..e91b69207 100644 --- a/library/http.server.po +++ b/library/http.server.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:07+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -51,13 +51,7 @@ msgid "" " httpd.serve_forever()" msgstr "" -msgid "This class builds on the :class:`~socketserver.TCPServer` class by storing the server address as instance variables named :attr:`server_name` and :attr:`server_port`. The server is accessible by the handler, typically through the handler's :attr:`~socketserver.BaseRequestHandler.server` instance variable." -msgstr "" - -msgid "The HTTP server's fully qualified domain name." -msgstr "" - -msgid "The HTTP server's port number obtained from *server_address*." +msgid "This class builds on the :class:`~socketserver.TCPServer` class by storing the server address as instance variables named :attr:`server_name` and :attr:`server_port`. The server is accessible by the handler, typically through the handler's :attr:`server` instance variable." msgstr "" msgid "This class is identical to HTTPServer but uses threads to handle requests by using the :class:`~socketserver.ThreadingMixIn`. This is useful to handle web browsers pre-opening sockets, on which :class:`HTTPServer` would wait indefinitely." @@ -66,7 +60,7 @@ msgstr "" msgid "Subclass of :class:`HTTPServer` with a wrapped socket using the :mod:`ssl` module. If the :mod:`ssl` module is not available, instantiating a :class:`!HTTPSServer` object fails with a :exc:`RuntimeError`." msgstr "" -msgid "The *certfile* argument is the path to the SSL certificate chain file, and the *keyfile* is the path to the file containing the private key." +msgid "The *certfile* argument is the path to the SSL certificate chain file, and the *keyfile* is the path to file containing the private key." msgstr "" msgid "A *password* can be specified for files protected and wrapped with PKCS#8, but beware that this could possibly expose hardcoded passwords in clear." @@ -111,7 +105,7 @@ msgstr "" msgid "Contains the command (request type). For example, ``'GET'``." msgstr "" -msgid "Contains the request path. If the query component of the URL is present, then ``path`` includes the query. Using the terminology of :rfc:`3986`, ``path`` here includes ``hier-part`` and the ``query``." +msgid "Contains the request path. If query component of the URL is present, then ``path`` includes the query. Using the terminology of :rfc:`3986`, ``path`` here includes ``hier-part`` and the ``query``." msgstr "" msgid "Contains the version string from the request. For example, ``'HTTP/1.0'``." @@ -138,7 +132,7 @@ msgstr "" msgid "Contains the Python system version, in a form usable by the :attr:`version_string` method and the :attr:`server_version` class variable. For example, ``'Python/1.4'``." msgstr "" -msgid "Specifies a format string that should be used by :meth:`send_error` method for building an error response to the client. The string is filled by default with variables from :attr:`responses` based on the status code passed to :meth:`send_error`." +msgid "Specifies a format string that should be used by :meth:`send_error` method for building an error response to the client. The string is filled by default with variables from :attr:`responses` based on the status code that passed to :meth:`send_error`." msgstr "" msgid "Specifies the Content-Type HTTP header of error responses sent to the client. The default value is ``'text/html'``." @@ -162,7 +156,7 @@ msgstr "" msgid "This method will parse and dispatch the request to the appropriate :meth:`!do_\\*` method. You should never need to override it." msgstr "" -msgid "When an HTTP/1.1 conformant server receives an ``Expect: 100-continue`` request header it responds with a ``100 Continue`` followed by ``200 OK`` headers. This method can be overridden to raise an error if the server does not want the client to continue. For example, the server can choose to send ``417 Expectation Failed`` as a response header and ``return False``." +msgid "When an HTTP/1.1 conformant server receives an ``Expect: 100-continue`` request header it responds back with a ``100 Continue`` followed by ``200 OK`` headers. This method can be overridden to raise an error if the server does not want the client to continue. For example, the server can choose to send ``417 Expectation Failed`` as a response header and ``return False``." msgstr "" msgid "Sends and logs a complete error reply to the client. The numeric *code* specifies the HTTP error code, with *message* as an optional, short, human readable description of the error. The *explain* argument can be used to provide more detailed information about the error; it will be formatted using the :attr:`error_message_format` attribute and emitted, after a complete set of headers, as the response body. The :attr:`responses` attribute holds the default values for *message* and *explain* that will be used if no value is provided; for unknown codes the default value for both is the string ``???``. The body will be empty if the method is HEAD or the response code is one of the following: :samp:`1{xx}`, ``204 No Content``, ``205 Reset Content``, ``304 Not Modified``." @@ -186,7 +180,7 @@ msgstr "" msgid "Headers are stored in an internal buffer." msgstr "" -msgid "Sends the response header only, used for the purposes when ``100 Continue`` response is sent by the server to the client. The headers are not buffered and sent directly the output stream. If the *message* is not specified, the HTTP message corresponding the response *code* is sent." +msgid "Sends the response header only, used for the purposes when ``100 Continue`` response is sent by the server to the client. The headers not buffered and sent directly the output stream.If the *message* is not specified, the HTTP message corresponding the response *code* is sent." msgstr "" msgid "This method does not reject *message* containing CRLF sequences." @@ -207,7 +201,7 @@ msgstr "" msgid "Logs an error when a request cannot be fulfilled. By default, it passes the message to :meth:`log_message`, so it takes the same arguments (*format* and additional values)." msgstr "" -msgid "Logs an arbitrary message to ``sys.stderr``. This is typically overridden to create custom error logging mechanisms. The *format* argument is a standard printf-style format string, where the additional arguments to :meth:`log_message` are applied as inputs to the formatting. The client IP address and current date and time are prefixed to every message logged." +msgid "Logs an arbitrary message to ``sys.stderr``. This is typically overridden to create custom error logging mechanisms. The *format* argument is a standard printf-style format string, where the additional arguments to :meth:`log_message` are applied as inputs to the formatting. The client ip address and current date and time are prefixed to every message logged." msgstr "" msgid "Returns the server software's version string. This is a combination of the :attr:`server_version` and :attr:`sys_version` attributes." @@ -246,12 +240,6 @@ msgstr "" msgid "This will be ``\"SimpleHTTP/\" + __version__``, where ``__version__`` is defined at the module level." msgstr "" -msgid "Specifies the filenames that are treated as directory index pages." -msgstr "" - -msgid "Defaults to ``(\"index.html\", \"index.htm\")``." -msgstr "" - msgid "A dictionary mapping suffixes into MIME types, contains custom overrides for the default system mappings. The mapping is used case-insensitively, and so should contain only lower-cased keys." msgstr "" @@ -267,7 +255,7 @@ msgstr "" msgid "The request is mapped to a local file by interpreting the request as a path relative to the current working directory." msgstr "" -msgid "If the request was mapped to a directory, the directory is checked for an index page as specified by :attr:`index_pages`. If found, the file's contents are returned; otherwise a directory listing is generated by calling the :meth:`list_directory` method. This method uses :func:`os.listdir` to scan the directory, and returns a ``404`` error response if the :func:`~os.listdir` fails." +msgid "If the request was mapped to a directory, the directory is checked for a file named ``index.html`` or ``index.htm`` (in that order). If found, the file's contents are returned; otherwise a directory listing is generated by calling the :meth:`list_directory` method. This method uses :func:`os.listdir` to scan the directory, and returns a ``404`` error response if the :func:`~os.listdir` fails." msgstr "" msgid "If the request was mapped to a file, it is opened. Any :exc:`OSError` exception in opening the requested file is mapped to a ``404``, ``'File not found'`` error. If there was an ``'If-Modified-Since'`` header in the request, and the file was not modified after this time, a ``304``, ``'Not Modified'`` response is sent. Otherwise, the content type is guessed by calling the :meth:`guess_type` method, which in turn uses the *extensions_map* variable, and the file contents are returned." @@ -285,25 +273,7 @@ msgstr "" msgid "Support of the ``'If-Modified-Since'`` header." msgstr "" -msgid "Helper to list the contents of *path* when no index page is present." -msgstr "" - -msgid "This returns either a :term:`file-like object` (which must be closed by the caller) or ``None`` to indicate an error, in which case the caller has nothing further to do. In either case, the headers are sent." -msgstr "" - -msgid "Guess the type of the file at the given *path*." -msgstr "" - -msgid "This returns a string of the form ``type/subtype``, usable for a MIME Content-type header." -msgstr "" - -msgid "The default implementation looks the file's extension up in :attr:`extensions_map`, falling back to :func:`mimetypes.guess_file_type` and then to ``'application/octet-stream'``." -msgstr "" - -msgid "Add :func:`mimetypes.guess_file_type` as a fallback." -msgstr "" - -msgid "The :class:`SimpleHTTPRequestHandler` class can be used to create a very basic webserver serving files relative to the current directory as follows::" +msgid "The :class:`SimpleHTTPRequestHandler` class can be used in the following manner in order to create a very basic webserver serving files relative to the current directory::" msgstr "" msgid "" @@ -319,7 +289,7 @@ msgid "" " httpd.serve_forever()" msgstr "" -msgid ":class:`SimpleHTTPRequestHandler` can also be subclassed to enhance behavior, such as using different index file names by overriding the class attribute :attr:`~SimpleHTTPRequestHandler.index_pages`." +msgid ":class:`SimpleHTTPRequestHandler` can also be subclassed to enhance behavior, such as using different index file names by overriding the class attribute :attr:`index_pages`." msgstr "" msgid "This class is used to serve either files or output of CGI scripts from the current directory and below. Note that mapping HTTP hierarchic structure to local directory structure is exactly as in :class:`SimpleHTTPRequestHandler`." @@ -331,7 +301,7 @@ msgstr "" msgid "The class will however, run the CGI script, instead of serving it as a file, if it guesses it to be a CGI script. Only directory-based CGI are used --- the other common server configuration is to treat special extensions as denoting CGI scripts." msgstr "" -msgid "The :func:`~SimpleHTTPRequestHandler.do_GET` and :func:`~SimpleHTTPRequestHandler.do_HEAD` functions are modified to run CGI scripts and serve the output, instead of serving files, if the request leads to somewhere below the ``cgi_directories`` path." +msgid "The :func:`do_GET` and :func:`do_HEAD` functions are modified to run CGI scripts and serve the output, instead of serving files, if the request leads to somewhere below the ``cgi_directories`` path." msgstr "" msgid "The :class:`CGIHTTPRequestHandler` defines the following data member:" @@ -428,10 +398,10 @@ msgstr "" msgid "Security considerations" msgstr "" -msgid ":class:`SimpleHTTPRequestHandler` will follow symbolic links when handling requests which makes it possible for files outside of the specified directory to be served." +msgid ":class:`SimpleHTTPRequestHandler` will follow symbolic links when handling requests, this makes it possible for files outside of the specified directory to be served." msgstr "" -msgid "Methods :meth:`BaseHTTPRequestHandler.send_header` and :meth:`BaseHTTPRequestHandler.send_response_only` assume sanitized input and do not perform input validation such as checking for the presence of CRLF sequences. Untrusted input may result in HTTP header injection attacks." +msgid "Methods :meth:`BaseHTTPRequestHandler.send_header` and :meth:`BaseHTTPRequestHandler.send_response_only` assume sanitized input and do not perform input validation such as checking for the presence of CRLF sequences. Untrusted input may result in HTTP Header injection attacks." msgstr "" msgid "Earlier versions of Python did not scrub control characters from the log messages emitted to stderr from ``python -m http.server`` or the default :class:`BaseHTTPRequestHandler` ``.log_message`` implementation. This could allow remote clients connecting to your server to send nefarious control codes to your terminal." diff --git a/library/i18n.po b/library/i18n.po index aec48832c..7012c9440 100644 --- a/library/i18n.po +++ b/library/i18n.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/idle.po b/library/idle.po index a1fd1db83..e15525dce 100644 --- a/library/idle.po +++ b/library/idle.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:07+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/imaplib.po b/library/imaplib.po index fe2d86e68..f3f0fc0e8 100644 --- a/library/imaplib.po +++ b/library/imaplib.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:07+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,7 +29,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/imaplib.py`" msgstr "" -msgid "This module defines three classes, :class:`IMAP4`, :class:`IMAP4_SSL` and :class:`IMAP4_stream`, which encapsulate a connection to an IMAP4 server and implement a large subset of the IMAP4rev1 client protocol as defined in :rfc:`3501`. It is backward compatible with IMAP4 (:rfc:`1730`) servers, but note that the ``STATUS`` command is not supported in IMAP4." +msgid "This module defines three classes, :class:`IMAP4`, :class:`IMAP4_SSL` and :class:`IMAP4_stream`, which encapsulate a connection to an IMAP4 server and implement a large subset of the IMAP4rev1 client protocol as defined in :rfc:`2060`. It is backward compatible with IMAP4 (:rfc:`1730`) servers, but note that the ``STATUS`` command is not supported in IMAP4." msgstr "" msgid "Availability" @@ -79,9 +79,6 @@ msgstr "" msgid "This is a subclass derived from :class:`IMAP4` that connects over an SSL encrypted socket (to use this class you need a socket module that was compiled with SSL support). If *host* is not specified, ``''`` (the local host) is used. If *port* is omitted, the standard IMAP4-over-SSL port (993) is used. *ssl_context* is a :class:`ssl.SSLContext` object which allows bundling SSL configuration options, certificates and private keys into a single (potentially long-lived) structure. Please read :ref:`ssl-security` for best practices." msgstr "" -msgid "With the default *ssl_context*, the connection is encrypted but the server certificate and hostname are not verified. To verify them, pass a context created by :func:`ssl.create_default_context`." -msgstr "" - msgid "The optional *timeout* parameter specifies a timeout in seconds for the connection attempt. If timeout is not given or is ``None``, the global default socket timeout is used." msgstr "" @@ -103,13 +100,13 @@ msgstr "" msgid "The following utility functions are defined:" msgstr "" -msgid "Parse a :term:`bytes-like object` containing an IMAP4 ``INTERNALDATE`` response and return the corresponding local time. The return value is a :class:`time.struct_time` tuple or ``None`` if the input has wrong format." +msgid "Parse an IMAP4 ``INTERNALDATE`` string and return corresponding local time. The return value is a :class:`time.struct_time` tuple or ``None`` if the string has wrong format." msgstr "" msgid "Converts an integer into a bytes representation using characters from the set [``A`` .. ``P``]." msgstr "" -msgid "Converts a :term:`bytes-like object` containing an IMAP4 ``FLAGS`` response to a tuple of individual flags as :class:`bytes`. The return value is an empty tuple if the input has wrong format." +msgid "Converts an IMAP4 ``FLAGS`` response to a tuple of individual flags." msgstr "" msgid "Convert *date_time* to an IMAP4 ``INTERNALDATE`` representation. The return value is a string in the form: ``\"DD-Mmm-YYYY HH:MM:SS +HHMM\"`` (including double-quotes). The *date_time* argument can be a number (int or float) representing seconds since epoch (as returned by :func:`time.time`), a 9-tuple representing local time an instance of :class:`time.struct_time` (as returned by :func:`time.localtime`), an aware instance of :class:`datetime.datetime`, or a double-quoted string. In the last case, it is assumed to already be in the correct format." @@ -130,7 +127,7 @@ msgstr "" msgid "All IMAP4rev1 commands are represented by methods of the same name, either uppercase or lowercase." msgstr "" -msgid "All arguments to commands are converted to strings, except for ``AUTHENTICATE``, and the last argument to ``APPEND`` which is passed as an IMAP4 literal. If necessary (the string contains IMAP4 protocol-sensitive characters and isn't enclosed with either parentheses or double quotes) each string is quoted. However, the *password* argument to the ``LOGIN`` command is always quoted. If you want to avoid having an argument string quoted (eg: the *flags* argument to ``STORE``) then enclose the string in parentheses (eg: ``r'(\\Deleted)'``). In general, pass arguments unquoted and let the module quote them as needed. An argument that is already enclosed in double quotes is left unchanged, so that code which quotes arguments itself keeps working." +msgid "All arguments to commands are converted to strings, except for ``AUTHENTICATE``, and the last argument to ``APPEND`` which is passed as an IMAP4 literal. If necessary (the string contains IMAP4 protocol-sensitive characters and isn't enclosed with either parentheses or double quotes) each string is quoted. However, the *password* argument to the ``LOGIN`` command is always quoted. If you want to avoid having an argument string quoted (eg: the *flags* argument to ``STORE``) then enclose the string in parentheses (eg: ``r'(\\Deleted)'``)." msgstr "" msgid "Most commands return a tuple: ``(type, [data, ...])`` where *type* is usually ``'OK'`` or ``'NO'``, and *data* is either the text from the command response, or mandated results from the command. Each *data* is either a ``bytes``, or a tuple. If a tuple, then the first part is the header of the response, and the second part contains the data (ie: 'literal' value)." @@ -145,9 +142,6 @@ msgstr "" msgid "Append *message* to named mailbox." msgstr "" -msgid "*flags* may be ``None`` or a string of IMAP flag tokens. Multiple flags are separated by spaces, for example ``r'\\Seen \\Answered'``. If *flags* is not already enclosed in parentheses, parentheses are added automatically." -msgstr "" - msgid "Authenticate command --- requires response processing." msgstr "" @@ -377,7 +371,7 @@ msgstr "" msgid "Request named status conditions for *mailbox*." msgstr "" -msgid "Alters flag dispositions for messages in mailbox. *command* is specified by section 6.4.6 of :rfc:`3501` as being one of \"FLAGS\", \"+FLAGS\", or \"-FLAGS\", optionally with a suffix of \".SILENT\"." +msgid "Alters flag dispositions for messages in mailbox. *command* is specified by section 6.4.6 of :rfc:`2060` as being one of \"FLAGS\", \"+FLAGS\", or \"-FLAGS\", optionally with a suffix of \".SILENT\"." msgstr "" msgid "For example, to set the delete flag on all messages::" @@ -390,7 +384,7 @@ msgid "" "M.expunge()" msgstr "" -msgid "Creating flags containing ']' (for example: \"[test]\") violates :rfc:`3501` (the IMAP protocol). However, imaplib has historically allowed creation of such flags, and popular IMAP servers, such as Gmail, accept and produce such flags. There are non-Python programs which also create such flags. Although it is an RFC violation and IMAP clients and servers are supposed to be strict, imaplib still continues to allow such flags to be created for backward compatibility reasons, and as of Python 3.6, handles them if they are sent from the server, since this improves real-world compatibility." +msgid "Creating flags containing ']' (for example: \"[test]\") violates :rfc:`3501` (the IMAP protocol). However, imaplib has historically allowed creation of such tags, and popular IMAP servers, such as Gmail, accept and produce such flags. There are non-Python programs which also create such tags. Although it is an RFC violation and IMAP clients and servers are supposed to be strict, imaplib still continues to allow such tags to be created for backward compatibility reasons, and as of Python 3.6, handles them if they are sent from the server, since this improves real-world compatibility." msgstr "" msgid "Subscribe to new mailbox." @@ -449,9 +443,6 @@ msgid "" "M.logout()" msgstr "" -msgid "A ``FETCH`` response may contain additional or unsolicited data (see :rfc:`3501`, section 7.4.2), so production code should inspect the whole response rather than rely on ``data[0][1]``." -msgstr "" - msgid "IMAP4" msgstr "" diff --git a/library/imghdr.po b/library/imghdr.po index 25348dea9..2eca42307 100644 --- a/library/imghdr.po +++ b/library/imghdr.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:02+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/imp.po b/library/imp.po index 981644dfa..52708395e 100644 --- a/library/imp.po +++ b/library/imp.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:02+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/importlib.metadata.po b/library/importlib.metadata.po index de6ca8f50..9a22d4a7b 100644 --- a/library/importlib.metadata.po +++ b/library/importlib.metadata.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:08+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/importlib.po b/library/importlib.po index 2d992757b..9cf868ae4 100644 --- a/library/importlib.po +++ b/library/importlib.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:08+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/importlib.resources.abc.po b/library/importlib.resources.abc.po index 25f377e8f..7ccfacef5 100644 --- a/library/importlib.resources.abc.po +++ b/library/importlib.resources.abc.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2022-11-05 19:49+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/importlib.resources.po b/library/importlib.resources.po index 31a1cf169..b8bf47362 100644 --- a/library/importlib.resources.po +++ b/library/importlib.resources.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2022-11-05 19:49+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/index.po b/library/index.po index 59036b9c7..c1b14fa97 100644 --- a/library/index.po +++ b/library/index.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/inspect.po b/library/inspect.po index b01c697e5..bedb75ded 100644 --- a/library/inspect.po +++ b/library/inspect.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:08+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -668,31 +668,22 @@ msgstr "" msgid "Return ``True`` if the object is an abstract base class." msgstr "" -msgid "Return ``True`` if the object is a method descriptor, but not if :func:`isclass`, :func:`ismethod` or :func:`isfunction` is true." +msgid "Return ``True`` if the object is a method descriptor, but not if :func:`ismethod`, :func:`isclass`, :func:`isfunction` or :func:`isbuiltin` are true." msgstr "" msgid "This, for example, is true of ``int.__add__``. An object passing this test has a :meth:`~object.__get__` method, but not a :meth:`~object.__set__` method or a :meth:`~object.__delete__` method. Beyond that, the set of attributes varies. A :attr:`~definition.__name__` attribute is usually sensible, and :attr:`~definition.__doc__` often is." msgstr "" -msgid "Method descriptors that also pass any of the other tests (:func:`!isclass`, :func:`!ismethod` or :func:`!isfunction`) make this function return ``False``, simply because those other tests promise more -- you can, for example, count on having the :attr:`~method.__func__` attribute when an object passes :func:`ismethod`." +msgid "Methods implemented via descriptors that also pass one of the other tests return ``False`` from the :func:`ismethoddescriptor` test, simply because the other tests promise more -- you can, e.g., count on having the :attr:`~method.__func__` attribute (etc) when an object passes :func:`ismethod`." msgstr "" msgid "This function no longer incorrectly reports objects with :meth:`~object.__get__` and :meth:`~object.__delete__`, but not :meth:`~object.__set__`, as being method descriptors (such objects are data descriptors, not method descriptors)." msgstr "" -msgid "Return ``True`` if the object is a data descriptor, but not if :func:`isclass`, :func:`ismethod` or :func:`isfunction` is true." +msgid "Return ``True`` if the object is a data descriptor." msgstr "" -msgid "Data descriptors always have a :meth:`~object.__set__` method and/or a :meth:`~object.__delete__` method. Optionally, they may also have a :meth:`~object.__get__` method." -msgstr "" - -msgid "Examples of data descriptors are :func:`properties `, getsets and member descriptors. Note that for the latter two (defined only in C extension modules), more specific tests are available: :func:`isgetsetdescriptor` and :func:`ismemberdescriptor`, respectively." -msgstr "" - -msgid "While data descriptors may also have :attr:`~definition.__name__` and :attr:`!__doc__` attributes (as properties, getsets and member descriptors do), this is not necessarily the case in general." -msgstr "" - -msgid "This function now reports objects with only a :meth:`~object.__set__` method as being data descriptors (the presence of :meth:`~object.__get__` is no longer required for that). Moreover, objects with :meth:`~object.__delete__`, but not :meth:`~object.__set__`, are now properly recognized as data descriptors as well, which was not the case previously." +msgid "Data descriptors have a :attr:`~object.__set__` or a :attr:`~object.__delete__` method. Examples are properties (defined in Python), getsets, and members. The latter two are defined in C and there are more specific tests available for those types, which is robust across Python implementations. Typically, data descriptors will also have :attr:`~definition.__name__` and :attr:`!__doc__` attributes (properties, getsets, and members have both of these attributes), but this is not guaranteed." msgstr "" msgid "Return ``True`` if the object is a getset descriptor." diff --git a/library/internet.po b/library/internet.po index cb7f9386a..dfef6c402 100644 --- a/library/internet.po +++ b/library/internet.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:08+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/intro.po b/library/intro.po index b619fcec1..aa835c2a8 100644 --- a/library/intro.po +++ b/library/intro.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:08+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/io.po b/library/io.po index bf34e5c37..c9f7ab4eb 100644 --- a/library/io.po +++ b/library/io.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:08+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/ipaddress.po b/library/ipaddress.po index a5d5d0cf0..f55704da6 100644 --- a/library/ipaddress.po +++ b/library/ipaddress.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:08+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/ipc.po b/library/ipc.po index 7edb5ca46..158acb00f 100644 --- a/library/ipc.po +++ b/library/ipc.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/itertools.po b/library/itertools.po index 0ef6d3308..2ae5337c8 100644 --- a/library/itertools.po +++ b/library/itertools.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:08+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/json.po b/library/json.po index 688380fd1..e175ae2dc 100644 --- a/library/json.po +++ b/library/json.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:08+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/keyword.po b/library/keyword.po index fe3f00e69..8b68dde7f 100644 --- a/library/keyword.po +++ b/library/keyword.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/language.po b/library/language.po index 2ac7e254b..505c0a7a3 100644 --- a/library/language.po +++ b/library/language.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/linecache.po b/library/linecache.po index 6ed8c3538..e7476f278 100644 --- a/library/linecache.po +++ b/library/linecache.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:08+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/locale.po b/library/locale.po index 7f41be9f5..1e539edec 100644 --- a/library/locale.po +++ b/library/locale.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:08+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/logging.config.po b/library/logging.config.po index f467e7aa7..157f79888 100644 --- a/library/logging.config.po +++ b/library/logging.config.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:09+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/logging.handlers.po b/library/logging.handlers.po index 47cba146f..991d79412 100644 --- a/library/logging.handlers.po +++ b/library/logging.handlers.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:09+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/logging.po b/library/logging.po index bbbd56f26..7a186422a 100644 --- a/library/logging.po +++ b/library/logging.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:09+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/lzma.po b/library/lzma.po index 5900d0f69..007324a44 100644 --- a/library/lzma.po +++ b/library/lzma.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:09+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -120,10 +120,40 @@ msgstr "" msgid "For a more convenient way of compressing a single chunk of data, see :func:`compress`." msgstr "" -msgid "The *format* argument specifies what container format should be used. Possible values are :const:`FORMAT_XZ` (the default), :const:`FORMAT_ALONE` and :const:`FORMAT_RAW`." +msgid "The *format* argument specifies what container format should be used. Possible values are:" msgstr "" -msgid "The *check* argument specifies the type of integrity check to include in the compressed data. This check is used when decompressing, to ensure that the data has not been corrupted. Possible values are :const:`CHECK_NONE`, :const:`CHECK_CRC32`, :const:`CHECK_CRC64` (the default for :const:`FORMAT_XZ`) and :const:`CHECK_SHA256`." +msgid ":const:`FORMAT_XZ`: The ``.xz`` container format." +msgstr "" + +msgid "This is the default format." +msgstr "" + +msgid ":const:`FORMAT_ALONE`: The legacy ``.lzma`` container format." +msgstr "" + +msgid "This format is more limited than ``.xz`` -- it does not support integrity checks or multiple filters." +msgstr "" + +msgid ":const:`FORMAT_RAW`: A raw data stream, not using any container format." +msgstr "" + +msgid "This format specifier does not support integrity checks, and requires that you always specify a custom filter chain (for both compression and decompression). Additionally, data compressed in this manner cannot be decompressed using :const:`FORMAT_AUTO` (see :class:`LZMADecompressor`)." +msgstr "" + +msgid "The *check* argument specifies the type of integrity check to include in the compressed data. This check is used when decompressing, to ensure that the data has not been corrupted. Possible values are:" +msgstr "" + +msgid ":const:`CHECK_NONE`: No integrity check. This is the default (and the only acceptable value) for :const:`FORMAT_ALONE` and :const:`FORMAT_RAW`." +msgstr "" + +msgid ":const:`CHECK_CRC32`: 32-bit Cyclic Redundancy Check." +msgstr "" + +msgid ":const:`CHECK_CRC64`: 64-bit Cyclic Redundancy Check. This is the default for :const:`FORMAT_XZ`." +msgstr "" + +msgid ":const:`CHECK_SHA256`: 256-bit Secure Hash Algorithm." msgstr "" msgid "If the specified check is not supported, an :class:`LZMAError` is raised." @@ -246,22 +276,22 @@ msgstr "" msgid "Branch-Call-Jump (BCJ) filters:" msgstr "" -msgid ":const:`!FILTER_X86`" +msgid ":const:`FILTER_X86`" msgstr "" -msgid ":const:`!FILTER_IA64`" +msgid ":const:`FILTER_IA64`" msgstr "" -msgid ":const:`!FILTER_ARM`" +msgid ":const:`FILTER_ARM`" msgstr "" -msgid ":const:`!FILTER_ARMTHUMB`" +msgid ":const:`FILTER_ARMTHUMB`" msgstr "" -msgid ":const:`!FILTER_POWERPC`" +msgid ":const:`FILTER_POWERPC`" msgstr "" -msgid ":const:`!FILTER_SPARC`" +msgid ":const:`FILTER_SPARC`" msgstr "" msgid "A filter chain can consist of up to 4 filters, and cannot be empty. The last filter in the chain must be a compression filter, and any other filters must be delta or BCJ filters." @@ -303,72 +333,6 @@ msgstr "" msgid "The BCJ filters are intended to be applied to machine code. They convert relative branches, calls and jumps in the code to use absolute addressing, with the aim of increasing the redundancy that can be exploited by the compressor. These filters support one option, ``start_offset``. This specifies the address that should be mapped to the beginning of the input data. The default is 0." msgstr "" -msgid "Constants" -msgstr "" - -msgid "The following module-level constants are provided for use as the *format*, *check*, *preset* and *filters* arguments of the classes and functions above." -msgstr "" - -msgid "Container formats:" -msgstr "" - -msgid "The ``.xz`` container format." -msgstr "" - -msgid "The legacy ``.lzma`` container format. This format is more limited than ``.xz`` -- it does not support integrity checks or multiple filters." -msgstr "" - -msgid "A raw data stream, not using any container format. This format specifier does not support integrity checks, and requires that you always specify a custom filter chain (for both compression and decompression). Additionally, data compressed in this manner cannot be decompressed using :const:`FORMAT_AUTO`." -msgstr "" - -msgid "Used for decompression only. The container format is detected automatically, so that both ``.xz`` and ``.lzma`` files can be decompressed." -msgstr "" - -msgid "Integrity checks:" -msgstr "" - -msgid "No integrity check. This is the default (and the only acceptable value) for :const:`FORMAT_ALONE` and :const:`FORMAT_RAW`." -msgstr "" - -msgid "A 32-bit Cyclic Redundancy Check." -msgstr "" - -msgid "A 64-bit Cyclic Redundancy Check. This is the default for :const:`FORMAT_XZ`." -msgstr "" - -msgid "A 256-bit Secure Hash Algorithm." -msgstr "" - -msgid "The integrity check used by a stream could not yet be determined. This may be the value of the :attr:`LZMADecompressor.check` attribute until enough of the input has been decoded." -msgstr "" - -msgid "The largest supported integrity-check ID." -msgstr "" - -msgid "Compression presets:" -msgstr "" - -msgid "The default compression preset, equivalent to preset level ``6``." -msgstr "" - -msgid "A flag that may be bitwise OR-ed with a preset level (``0`` to ``9``) to select a slower but more thorough variant of that preset." -msgstr "" - -msgid "Filter IDs and options:" -msgstr "" - -msgid "The LZMA1 and LZMA2 compression filters. :const:`FILTER_LZMA1` is for use with :const:`FORMAT_ALONE`, while :const:`FILTER_LZMA2` is for use with :const:`FORMAT_XZ` and :const:`FORMAT_RAW`." -msgstr "" - -msgid "The delta filter." -msgstr "" - -msgid "Compression modes that may be used as the ``mode`` option of a filter specifier (see :ref:`filter-chain-specs`)." -msgstr "" - -msgid "Match finders that may be used as the ``mf`` option of a filter specifier (see :ref:`filter-chain-specs`)." -msgstr "" - msgid "Examples" msgstr "" diff --git a/library/mailbox.po b/library/mailbox.po index 8dbf7c589..f4fb50393 100644 --- a/library/mailbox.po +++ b/library/mailbox.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:09+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/mailcap.po b/library/mailcap.po index 36e19f3be..55affc634 100644 --- a/library/mailcap.po +++ b/library/mailcap.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:03+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/markup.po b/library/markup.po index 33c352d17..e1d41b1c9 100644 --- a/library/markup.po +++ b/library/markup.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/marshal.po b/library/marshal.po index 273446849..167bdc122 100644 --- a/library/marshal.po +++ b/library/marshal.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:09+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/math.po b/library/math.po index 741cc215c..1e884dbe2 100644 --- a/library/math.po +++ b/library/math.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:09+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/mimetypes.po b/library/mimetypes.po index e6dbaf591..3eefd6621 100644 --- a/library/mimetypes.po +++ b/library/mimetypes.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:09+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -53,7 +53,7 @@ msgstr "" msgid "Added support for *url* being a :term:`path-like object`." msgstr "" -msgid "Passing a file path instead of URL. Use :func:`guess_file_type` for this." +msgid "Passing a file path instead of URL is :term:`soft deprecated`. Use :func:`guess_file_type` for this." msgstr "" msgid "Guess the type of a file based on its path, given by *path*. Similar to the :func:`guess_type` function, but accepts a path instead of URL. Path can be a string, a bytes object or a :term:`path-like object`." @@ -83,7 +83,7 @@ msgstr "" msgid "Previously, Windows registry settings were ignored." msgstr "" -msgid "Load the type map given in the file named by *file*, if it exists. *file* must be a string specifying the name of the file to read. The type map is returned as a dictionary mapping file extensions, including the leading dot (``'.'``), to strings of the form ``'type/subtype'``. If the file does not exist or cannot be read, ``None`` is returned." +msgid "Load the type map given in the file *filename*, if it exists. The type map is returned as a dictionary mapping filename extensions, including the leading dot (``'.'``), to strings of the form ``'type/subtype'``. If the file *filename* does not exist or cannot be read, ``None`` is returned." msgstr "" msgid "Add a mapping from the MIME type *type* to the extension *ext*. When the extension is already known, the new type will replace the old one. When the type is already known the extension will be added to the list of known extensions." diff --git a/library/mm.po b/library/mm.po index 319f8eda6..168282775 100644 --- a/library/mm.po +++ b/library/mm.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/mmap.po b/library/mmap.po index f9dbc9c1c..1dae9ffe3 100644 --- a/library/mmap.po +++ b/library/mmap.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:09+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/modulefinder.po b/library/modulefinder.po index 19cb56273..f3ed73937 100644 --- a/library/modulefinder.po +++ b/library/modulefinder.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/modules.po b/library/modules.po index c0b84ab0a..3ff6a5fe4 100644 --- a/library/modules.po +++ b/library/modules.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/msilib.po b/library/msilib.po index 37bcec591..0f1ce380f 100644 --- a/library/msilib.po +++ b/library/msilib.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:03+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/msvcrt.po b/library/msvcrt.po index a4c4bd3b5..05a226e8b 100644 --- a/library/msvcrt.po +++ b/library/msvcrt.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:09+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/multiprocessing.po b/library/multiprocessing.po index 2a493fd2e..acb5179df 100644 --- a/library/multiprocessing.po +++ b/library/multiprocessing.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:10+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/multiprocessing.shared_memory.po b/library/multiprocessing.shared_memory.po index 22b6564e4..4a46dc404 100644 --- a/library/multiprocessing.shared_memory.po +++ b/library/multiprocessing.shared_memory.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:10+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/netdata.po b/library/netdata.po index d146bcc94..df1ad8e84 100644 --- a/library/netdata.po +++ b/library/netdata.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:10+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/netrc.po b/library/netrc.po index 8036f3702..f0aba7f67 100644 --- a/library/netrc.po +++ b/library/netrc.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:10+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/nis.po b/library/nis.po index d374e1799..f0bc75642 100644 --- a/library/nis.po +++ b/library/nis.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:03+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/nntplib.po b/library/nntplib.po index 5368a7658..0cb96b9c5 100644 --- a/library/nntplib.po +++ b/library/nntplib.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:03+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/numbers.po b/library/numbers.po index 8985d51c8..cbdb74b99 100644 --- a/library/numbers.po +++ b/library/numbers.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:10+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -75,7 +75,21 @@ msgstr "" msgid "Notes for type implementers" msgstr "" -msgid "Implementers should be careful to make equal numbers equal and hash them to the same values. This may be subtle if there are two different extensions of the real numbers. See also :ref:`numeric-hash`." +msgid "Implementers should be careful to make equal numbers equal and hash them to the same values. This may be subtle if there are two different extensions of the real numbers. For example, :class:`fractions.Fraction` implements :func:`hash` as follows::" +msgstr "" + +msgid "" +"def __hash__(self):\n" +" if self.denominator == 1:\n" +" # Get integers right.\n" +" return hash(self.numerator)\n" +" # Expensive check, but definitely correct.\n" +" if self == float(self):\n" +" return hash(float(self))\n" +" else:\n" +" # Use tuple's hash to avoid a high collision rate on\n" +" # simple fractions.\n" +" return hash((self.numerator, self.denominator))" msgstr "" msgid "Adding More Numeric ABCs" diff --git a/library/numeric.po b/library/numeric.po index 2d3bf5d20..698bdfc16 100644 --- a/library/numeric.po +++ b/library/numeric.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:10+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/operator.po b/library/operator.po index 91d916c59..908756ff3 100644 --- a/library/operator.po +++ b/library/operator.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:10+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/optparse.po b/library/optparse.po index 5fa4bb87a..f827bc237 100644 --- a/library/optparse.po +++ b/library/optparse.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:10+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/os.path.po b/library/os.path.po index 568eaf38c..36237854a 100644 --- a/library/os.path.po +++ b/library/os.path.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:10+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/os.po b/library/os.po index 18f3f99a5..532e2cc30 100644 --- a/library/os.po +++ b/library/os.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:10+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -398,37 +398,34 @@ msgstr "" msgid "Set the current numeric umask and return the previous umask." msgstr "" -msgid "Returns information identifying the current operating system. The return value is a :class:`uname_result`." +msgid "Returns information identifying the current operating system. The return value is an object with five attributes:" msgstr "" -msgid "On macOS, iOS and Android, this returns the *kernel* name and release (i.e., ``'Darwin'`` on macOS and iOS; ``'Linux'`` on Android). :func:`platform.uname` can be used to get the user-facing operating system name and release on iOS and Android." +msgid ":attr:`sysname` - operating system name" msgstr "" -msgid ":data:`sys.platform` which has finer granularity." +msgid ":attr:`nodename` - name of machine on network (implementation-defined)" msgstr "" -msgid "Return type changed from a tuple to a tuple-like object with named attributes." -msgstr "" - -msgid "Name and information about the system returned by :func:`os.uname`. These attributes correspond to the members described in :manpage:`uname(2)`." +msgid ":attr:`release` - operating system release" msgstr "" -msgid "For backwards compatibility, this object is also iterable, behaving like a five-tuple containing :attr:`~uname_result.sysname`, :attr:`~uname_result.nodename`, :attr:`~uname_result.release`, :attr:`~uname_result.version`, and :attr:`~uname_result.machine` in that order." +msgid ":attr:`version` - operating system version" msgstr "" -msgid "Operating system name." +msgid ":attr:`machine` - hardware identifier" msgstr "" -msgid "Name of machine on network. Some systems truncate :attr:`~uname_result.nodename` to 8 characters or to the leading component; a better way to get the hostname is :func:`socket.gethostname` or even ``socket.gethostbyaddr(socket.gethostname())``." +msgid "For backwards compatibility, this object is also iterable, behaving like a five-tuple containing :attr:`sysname`, :attr:`nodename`, :attr:`release`, :attr:`version`, and :attr:`machine` in that order." msgstr "" -msgid "Operating system release." +msgid "Some systems truncate :attr:`nodename` to 8 characters or to the leading component; a better way to get the hostname is :func:`socket.gethostname` or even ``socket.gethostbyaddr(socket.gethostname())``." msgstr "" -msgid "Operating system version." +msgid "On macOS, iOS and Android, this returns the *kernel* name and version (i.e., ``'Darwin'`` on macOS and iOS; ``'Linux'`` on Android). :func:`platform.uname` can be used to get the user-facing operating system name and version on iOS and Android." msgstr "" -msgid "Hardware identifier." +msgid "Return type changed from a tuple to a tuple-like object with named attributes." msgstr "" msgid "Unset (delete) the environment variable named *key*. Such changes to the environment affect subprocesses started with :func:`os.system`, :func:`popen` or :func:`fork` and :func:`execv`." @@ -556,6 +553,9 @@ msgstr "" msgid "Force write of file with filedescriptor *fd* to disk. Does not force update of metadata." msgstr "" +msgid "This function is not available on MacOS." +msgstr "" + msgid "Return system configuration information relevant to an open file. *name* specifies the configuration value to retrieve; it may be a string which is the name of a defined system value; these names are specified in a number of standards (POSIX.1, Unix 95, Unix 98, and others). Some platforms define additional names as well. The names known to the host operating system are given in the ``pathconf_names`` dictionary. For configuration variables not included in that mapping, passing an integer for *name* is also accepted." msgstr "" @@ -574,7 +574,7 @@ msgstr "" msgid "The :func:`.stat` function." msgstr "" -msgid "Return information about the filesystem containing the file associated with file descriptor *fd* in a :class:`statvfs_result`, like :func:`statvfs`. As of Python 3.3, this is equivalent to ``os.statvfs(fd)``." +msgid "Return information about the filesystem containing the file associated with file descriptor *fd*, like :func:`statvfs`. As of Python 3.3, this is equivalent to ``os.statvfs(fd)``." msgstr "" msgid "Force write of file with filedescriptor *fd* to disk. On Unix, this calls the native :c:func:`!fsync` function; on Windows, the MS :c:func:`!_commit` function." @@ -1095,9 +1095,6 @@ msgstr "" msgid "Raises an :ref:`auditing event ` ``os.chdir`` with argument ``path``." msgstr "" -msgid "The :func:`contextlib.chdir` context manager, which changes the current working directory on entering and restores the previous one on exit." -msgstr "" - msgid "Added support for specifying *path* as a file descriptor on some platforms." msgstr "" @@ -1573,7 +1570,7 @@ msgstr "" msgid "The :attr:`name` attribute will be ``bytes`` if the :func:`scandir` *path* argument is of type ``bytes`` and ``str`` otherwise. Use :func:`~os.fsdecode` to decode byte filenames." msgstr "" -msgid "The entry's path name: equivalent to ``os.path.join(scandir_path, entry.name)`` where *scandir_path* is the original :func:`scandir` *path* argument. Apart from the filename, the path preserves the original :func:`scandir` argument. If the :func:`scandir` *path* argument was relative, the :attr:`path` attribute is also relative. Changing the current working directory after creating the :func:`scandir` iterator may cause later uses of :attr:`path` to resolve differently. On some platforms, the constructed path may not be valid if the original :func:`scandir` argument was usable for enumeration but not for joining with the entry name. If the :func:`scandir` *path* argument was a :ref:`file descriptor `, the :attr:`path` attribute is the same as the :attr:`name` attribute." +msgid "The entry's full path name: equivalent to ``os.path.join(scandir_path, entry.name)`` where *scandir_path* is the :func:`scandir` *path* argument. The path is only absolute if the :func:`scandir` *path* argument was absolute. If the :func:`scandir` *path* argument was a :ref:`file descriptor `, the :attr:`path` attribute is the same as the :attr:`name` attribute." msgstr "" msgid "The :attr:`path` attribute will be ``bytes`` if the :func:`scandir` *path* argument is of type ``bytes`` and ``str`` otherwise. Use :func:`~os.fsdecode` to decode byte filenames." @@ -1836,82 +1833,22 @@ msgstr "" msgid "Added the :attr:`st_birthtime` member on Windows." msgstr "" -msgid "Perform a :manpage:`statvfs(3)` system call on the given path. The return value is a :class:`statvfs_result` whose attributes describe the filesystem on the given path and correspond to the members of the :c:struct:`statvfs` structure." -msgstr "" - -msgid "Filesystem statistics returned by :func:`os.statvfs` and :func:`os.fstatvfs`. See :manpage:`statvfs(3)` for more details." -msgstr "" - -msgid "Block size." -msgstr "" - -msgid "Fragment size." -msgstr "" - -msgid "Number of :attr:`~statvfs_result.f_frsize` sized blocks the filesystem can contain." -msgstr "" - -msgid "Number of free blocks." -msgstr "" - -msgid "Number of free blocks for unprivileged users." -msgstr "" - -msgid "Number of file entries, inodes, the filesystem can contain." -msgstr "" - -msgid "Number of free files entries." -msgstr "" - -msgid "Number of free file entries for unprivileged users." -msgstr "" - -msgid "Bit-mask of mount flags. The following flags are defined: :data:`ST_RDONLY`, :data:`ST_NOSUID`, :data:`ST_NODEV`, :data:`ST_NOEXEC`, :data:`ST_SYNCHRONOUS`, :data:`ST_MANDLOCK`, :data:`ST_WRITE`, :data:`ST_APPEND`, :data:`ST_IMMUTABLE`, :data:`ST_NOATIME`, :data:`ST_NODIRATIME`, and :data:`ST_RELATIME`." -msgstr "" - -msgid "Filesystem max filename length. OS specific limitations such as :ref:`Windows MAX_PATH ` and those described in Linux :manpage:`pathname(7)` may exist." -msgstr "" - -msgid "Filesystem ID." -msgstr "" - -msgid "The following flags are used in :attr:`statvfs_result.f_flag`." -msgstr "" - -msgid "Read-only filesystem." -msgstr "" - -msgid "Setuid/setgid bits are disabled or not supported." -msgstr "" - -msgid "Disallow access to device special files." -msgstr "" - -msgid "Disallow program execution." -msgstr "" - -msgid "Writes are synced at once." -msgstr "" - -msgid "Allow mandatory locks on an FS." -msgstr "" - -msgid "Write on file/directory/symlink." +msgid "Perform a :c:func:`!statvfs` system call on the given path. The return value is an object whose attributes describe the filesystem on the given path, and correspond to the members of the :c:struct:`statvfs` structure, namely: :attr:`f_bsize`, :attr:`f_frsize`, :attr:`f_blocks`, :attr:`f_bfree`, :attr:`f_bavail`, :attr:`f_files`, :attr:`f_ffree`, :attr:`f_favail`, :attr:`f_flag`, :attr:`f_namemax`, :attr:`f_fsid`." msgstr "" -msgid "Append-only file." +msgid "Two module-level constants are defined for the :attr:`f_flag` attribute's bit-flags: if :const:`ST_RDONLY` is set, the filesystem is mounted read-only, and if :const:`ST_NOSUID` is set, the semantics of setuid/setgid bits are disabled or not supported." msgstr "" -msgid "Immutable file." +msgid "Additional module-level constants are defined for GNU/glibc based systems. These are :const:`ST_NODEV` (disallow access to device special files), :const:`ST_NOEXEC` (disallow program execution), :const:`ST_SYNCHRONOUS` (writes are synced at once), :const:`ST_MANDLOCK` (allow mandatory locks on an FS), :const:`ST_WRITE` (write on file/directory/symlink), :const:`ST_APPEND` (append-only file), :const:`ST_IMMUTABLE` (immutable file), :const:`ST_NOATIME` (do not update access times), :const:`ST_NODIRATIME` (do not update directory access times), :const:`ST_RELATIME` (update atime relative to mtime/ctime)." msgstr "" -msgid "Do not update access times." +msgid "The :const:`ST_RDONLY` and :const:`ST_NOSUID` constants were added." msgstr "" -msgid "Do not update directory access times." +msgid "The :const:`ST_NODEV`, :const:`ST_NOEXEC`, :const:`ST_SYNCHRONOUS`, :const:`ST_MANDLOCK`, :const:`ST_WRITE`, :const:`ST_APPEND`, :const:`ST_IMMUTABLE`, :const:`ST_NOATIME`, :const:`ST_NODIRATIME`, and :const:`ST_RELATIME` constants were added." msgstr "" -msgid "Update atime relative to mtime/ctime." +msgid "Added the :attr:`f_fsid` attribute." msgstr "" msgid "A :class:`set` object indicating which functions in the :mod:`!os` module accept an open file descriptor for their *dir_fd* parameter. Different platforms provide different features, and the underlying functionality Python uses to implement the *dir_fd* parameter is not available on all platforms Python supports. For consistency's sake, functions that may support *dir_fd* always allow specifying the parameter, but will throw an exception if the functionality is used when it's not locally available. (Specifying ``None`` for *dir_fd* is always supported on all platforms.)" diff --git a/library/ossaudiodev.po b/library/ossaudiodev.po index 919d7d0f2..57eec5ee2 100644 --- a/library/ossaudiodev.po +++ b/library/ossaudiodev.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:03+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/pathlib.po b/library/pathlib.po index 983abfd09..eaa03eb1b 100644 --- a/library/pathlib.po +++ b/library/pathlib.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:11+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/pdb.po b/library/pdb.po index abd517f90..673725676 100644 --- a/library/pdb.po +++ b/library/pdb.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:11+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/persistence.po b/library/persistence.po index c46dc12f7..9f81d8db7 100644 --- a/library/persistence.po +++ b/library/persistence.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/pickle.po b/library/pickle.po index 3a0800d37..7ad553714 100644 --- a/library/pickle.po +++ b/library/pickle.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:11+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/pickletools.po b/library/pickletools.po index 9cd669828..ba5b36293 100644 --- a/library/pickletools.po +++ b/library/pickletools.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:11+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/pipes.po b/library/pipes.po index e3e1f4775..8d82065c6 100644 --- a/library/pipes.po +++ b/library/pipes.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:03+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/pkgutil.po b/library/pkgutil.po index 77aad3880..6d044e36d 100644 --- a/library/pkgutil.po +++ b/library/pkgutil.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:11+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/platform.po b/library/platform.po index 32106052d..5bbfb46bf 100644 --- a/library/platform.po +++ b/library/platform.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:11+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -116,9 +116,6 @@ msgstr "" msgid "Returns the system's release, e.g. ``'2.2.0'`` or ``'NT'``. An empty string is returned if the value cannot be determined." msgstr "" -msgid "On iOS and Android, this is the user-facing OS release. To obtain the Darwin or Linux kernel release, use :func:`os.uname`." -msgstr "" - msgid "Returns the system/OS name, such as ``'Linux'``, ``'Darwin'``, ``'Java'``, ``'Windows'``. An empty string is returned if the value cannot be determined." msgstr "" @@ -131,6 +128,9 @@ msgstr "" msgid "Returns the system's release version, e.g. ``'#3 on degas'``. An empty string is returned if the value cannot be determined." msgstr "" +msgid "On iOS and Android, this is the user-facing OS version. To obtain the Darwin or Linux kernel version, use :func:`os.uname`." +msgstr "" + msgid "Fairly portable uname interface. Returns a :func:`~collections.namedtuple` containing six attributes: :attr:`system`, :attr:`node`, :attr:`release`, :attr:`version`, :attr:`machine`, and :attr:`processor`." msgstr "" diff --git a/library/plistlib.po b/library/plistlib.po index 26395911e..0c255fc9d 100644 --- a/library/plistlib.po +++ b/library/plistlib.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:11+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/poplib.po b/library/poplib.po index b948ff0a6..8da25ce5f 100644 --- a/library/poplib.po +++ b/library/poplib.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:11+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/posix.po b/library/posix.po index 85ba7e92b..3bd1f0479 100644 --- a/library/posix.po +++ b/library/posix.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:11+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/pprint.po b/library/pprint.po index 69e7bd2ca..0092689ec 100644 --- a/library/pprint.po +++ b/library/pprint.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:11+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/profile.po b/library/profile.po index 698b56f4e..3829fca4a 100644 --- a/library/profile.po +++ b/library/profile.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:11+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/pty.po b/library/pty.po index 1d147b7a5..844d91151 100644 --- a/library/pty.po +++ b/library/pty.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:11+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/pwd.po b/library/pwd.po index e7ae4444c..2368479da 100644 --- a/library/pwd.po +++ b/library/pwd.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:11+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/py_compile.po b/library/py_compile.po index d4ef4dfd6..48bff3bbb 100644 --- a/library/py_compile.po +++ b/library/py_compile.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:11+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/pyclbr.po b/library/pyclbr.po index 535234be6..1eb89b060 100644 --- a/library/pyclbr.po +++ b/library/pyclbr.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:11+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/pydoc.po b/library/pydoc.po index d09c90974..69ffd0946 100644 --- a/library/pydoc.po +++ b/library/pydoc.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:12+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/pyexpat.po b/library/pyexpat.po index 7aa2334cf..897dc2395 100644 --- a/library/pyexpat.po +++ b/library/pyexpat.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:12+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/python.po b/library/python.po index 445c6f9c1..aa536ba82 100644 --- a/library/python.po +++ b/library/python.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/queue.po b/library/queue.po index 77818ec84..3f24339d4 100644 --- a/library/queue.po +++ b/library/queue.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/quopri.po b/library/quopri.po index 693d12c3c..e4eec361f 100644 --- a/library/quopri.po +++ b/library/quopri.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:12+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/random.po b/library/random.po index f62984a8f..84a30fd5d 100644 --- a/library/random.po +++ b/library/random.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:12+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/re.po b/library/re.po index c87aef03f..7c9e603c7 100644 --- a/library/re.po +++ b/library/re.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:12+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -351,7 +351,7 @@ msgstr "" msgid "``(?(id/name)yes-pattern|no-pattern)``" msgstr "" -msgid "Will try to match with ``yes-pattern`` if the group with given *id* or *name* exists, and with ``no-pattern`` if it doesn't. ``no-pattern`` is optional and can be omitted. For example, ``(<)?(\\w+@\\w+(?:\\.\\w+)+)(?(1)>|$)`` is a poor email matching pattern, which matches ``''`` as well as ``'user@host.com'``, but does not match ``''`` in their entirety (:func:`re.search` finds only ``'user@host.com'`` in the former)." +msgid "Will try to match with ``yes-pattern`` if the group with given *id* or *name* exists, and with ``no-pattern`` if it doesn't. ``no-pattern`` is optional and can be omitted. For example, ``(<)?(\\w+@\\w+(?:\\.\\w+)+)(?(1)>|$)`` is a poor email matching pattern, which will match with ``''`` as well as ``'user@host.com'``, but not with ``''``." msgstr "" msgid "Group *id* can only contain ASCII digits. In :class:`bytes` patterns, group *name* can only contain bytes in the ASCII range (``b'\\x00'``-``b'\\x7f'``)." diff --git a/library/readline.po b/library/readline.po index e8a45d4b1..2705c2c06 100644 --- a/library/readline.po +++ b/library/readline.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:12+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/removed.po b/library/removed.po index 0be13142d..579e43cd0 100644 --- a/library/removed.po +++ b/library/removed.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:03+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/reprlib.po b/library/reprlib.po index 3c5e9eb68..7894676f3 100644 --- a/library/reprlib.po +++ b/library/reprlib.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:12+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/resource.po b/library/resource.po index 2577a87a7..d0ca5e0dc 100644 --- a/library/resource.po +++ b/library/resource.po @@ -15,10 +15,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:12+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/rlcompleter.po b/library/rlcompleter.po index 31be62e14..f2fcbe428 100644 --- a/library/rlcompleter.po +++ b/library/rlcompleter.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:12+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/runpy.po b/library/runpy.po index 002755d8a..dec3c938d 100644 --- a/library/runpy.po +++ b/library/runpy.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:12+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/sched.po b/library/sched.po index 79254d0c7..40c3ba674 100644 --- a/library/sched.po +++ b/library/sched.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:12+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/secrets.po b/library/secrets.po index 5e9f40d44..db407b929 100644 --- a/library/secrets.po +++ b/library/secrets.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:12+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -110,7 +110,7 @@ msgstr "" msgid "Other functions" msgstr "" -msgid "Return ``True`` if strings or :term:`bytes-like objects ` *a* and *b* are equal, otherwise ``False``, using a \"constant-time compare\" to reduce the risk of `timing attacks `__. See :func:`hmac.compare_digest` for additional details." +msgid "Return ``True`` if strings or :term:`bytes-like objects ` *a* and *b* are equal, otherwise ``False``, using a \"constant-time compare\" to reduce the risk of `timing attacks `_. See :func:`hmac.compare_digest` for additional details." msgstr "" msgid "Recipes and best practices" diff --git a/library/security_warnings.po b/library/security_warnings.po index 51116ab40..73d788780 100644 --- a/library/security_warnings.po +++ b/library/security_warnings.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-08-10 13:22+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/select.po b/library/select.po index 8c2752bf3..83c81324d 100644 --- a/library/select.po +++ b/library/select.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:12+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/selectors.po b/library/selectors.po index 9f631df2f..781c33d0e 100644 --- a/library/selectors.po +++ b/library/selectors.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:12+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/shelve.po b/library/shelve.po index 2a5cee937..24ed4dcdc 100644 --- a/library/shelve.po +++ b/library/shelve.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:12+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/shlex.po b/library/shlex.po index 912114390..733eab990 100644 --- a/library/shlex.po +++ b/library/shlex.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/shutil.po b/library/shutil.po index 7112314f9..dd889eff5 100644 --- a/library/shutil.po +++ b/library/shutil.po @@ -12,10 +12,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:13+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/signal.po b/library/signal.po index 339477b9b..f950a6d3e 100644 --- a/library/signal.po +++ b/library/signal.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:13+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/site.po b/library/site.po index 90b72acbd..902d4ba76 100644 --- a/library/site.po +++ b/library/site.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:13+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/smtpd.po b/library/smtpd.po index 2d1ac727b..c529b9a60 100644 --- a/library/smtpd.po +++ b/library/smtpd.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:03+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/smtplib.po b/library/smtplib.po index 06a2ac1cf..868866c7e 100644 --- a/library/smtplib.po +++ b/library/smtplib.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:13+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/sndhdr.po b/library/sndhdr.po index e9ec9333d..8bb799e0e 100644 --- a/library/sndhdr.po +++ b/library/sndhdr.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:03+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/socket.po b/library/socket.po index 54150107c..d350a1c3c 100644 --- a/library/socket.po +++ b/library/socket.po @@ -15,10 +15,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:13+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -472,7 +472,46 @@ msgstr "" msgid "The following functions all create :ref:`socket objects `." msgstr "" -msgid "The :class:`socket ` class constructor creates a new socket directly; see :ref:`socket-objects` for its parameters and full description." +msgid "Create a new socket using the given address family, socket type and protocol number. The address family should be :const:`AF_INET` (the default), :const:`AF_INET6`, :const:`AF_UNIX`, :const:`AF_CAN`, :const:`AF_PACKET`, or :const:`AF_RDS`. The socket type should be :const:`SOCK_STREAM` (the default), :const:`SOCK_DGRAM`, :const:`SOCK_RAW` or perhaps one of the other ``SOCK_`` constants. The protocol number is usually zero and may be omitted or in the case where the address family is :const:`AF_CAN` the protocol should be one of :const:`CAN_RAW`, :const:`CAN_BCM`, :const:`CAN_ISOTP` or :const:`CAN_J1939`." +msgstr "" + +msgid "If *fileno* is specified, the values for *family*, *type*, and *proto* are auto-detected from the specified file descriptor. Auto-detection can be overruled by calling the function with explicit *family*, *type*, or *proto* arguments. This only affects how Python represents e.g. the return value of :meth:`socket.getpeername` but not the actual OS resource. Unlike :func:`socket.fromfd`, *fileno* will return the same socket and not a duplicate. This may help close a detached socket using :meth:`socket.close`." +msgstr "" + +msgid "The newly created socket is :ref:`non-inheritable `." +msgstr "" + +msgid "Raises an :ref:`auditing event ` ``socket.__new__`` with arguments ``self``, ``family``, ``type``, ``protocol``." +msgstr "" + +msgid "The AF_CAN family was added. The AF_RDS family was added." +msgstr "" + +msgid "The CAN_BCM protocol was added." +msgstr "" + +msgid "The returned socket is now non-inheritable." +msgstr "" + +msgid "The CAN_ISOTP protocol was added." +msgstr "" + +msgid "When :const:`SOCK_NONBLOCK` or :const:`SOCK_CLOEXEC` bit flags are applied to *type* they are cleared, and :attr:`socket.type` will not reflect them. They are still passed to the underlying system ``socket()`` call. Therefore," +msgstr "" + +msgid "" +"sock = socket.socket(\n" +" socket.AF_INET,\n" +" socket.SOCK_STREAM | socket.SOCK_NONBLOCK)" +msgstr "" + +msgid "will still create a non-blocking socket on OSes that support ``SOCK_NONBLOCK``, but ``sock.type`` will be set to ``socket.SOCK_STREAM``." +msgstr "" + +msgid "The CAN_J1939 protocol was added." +msgstr "" + +msgid "The IPPROTO_MPTCP protocol was added." msgstr "" msgid "Build a pair of connected socket objects using the given address family, socket type, and protocol number. Address family, socket type, and protocol number are as for the :func:`~socket.socket` function. The default family is :const:`AF_UNIX` if defined on the platform; otherwise, the default is :const:`AF_INET`." @@ -536,13 +575,10 @@ msgstr "" msgid "Duplicate the file descriptor *fd* (an integer as returned by a file object's :meth:`~io.IOBase.fileno` method) and build a socket object from the result. Address family, socket type and protocol number are as for the :func:`~socket.socket` function. The file descriptor should refer to a socket, but this is not checked --- subsequent operations on the object may fail if the file descriptor is invalid. This function is rarely needed, but can be used to get or set socket options on a socket passed to a program as standard input or output (such as a server started by the Unix inet daemon). The socket is assumed to be in blocking mode." msgstr "" -msgid "The newly created socket is :ref:`non-inheritable `." -msgstr "" - -msgid "The returned socket is now non-inheritable." +msgid "Instantiate a socket from data obtained from the :meth:`socket.share` method. The socket is assumed to be in blocking mode." msgstr "" -msgid "Instantiate a socket from data obtained from the :meth:`socket.share` method. The socket is assumed to be in blocking mode." +msgid "This is a Python type object that represents the socket object type. It is the same as ``type(socket(...))``." msgstr "" msgid "Other functions" @@ -787,42 +823,6 @@ msgstr "" msgid "Socket Objects" msgstr "" -msgid "Create a new socket using the given address family, socket type and protocol number. The address family should be :const:`AF_INET` (the default), :const:`AF_INET6`, :const:`AF_UNIX`, :const:`AF_CAN`, :const:`AF_PACKET`, or :const:`AF_RDS`. The socket type should be :const:`SOCK_STREAM` (the default), :const:`SOCK_DGRAM`, :const:`SOCK_RAW` or perhaps one of the other ``SOCK_`` constants. The protocol number is usually zero and may be omitted or in the case where the address family is :const:`AF_CAN` the protocol should be one of :const:`CAN_RAW`, :const:`CAN_BCM`, :const:`CAN_ISOTP` or :const:`CAN_J1939`." -msgstr "" - -msgid "If *fileno* is specified, the values for *family*, *type*, and *proto* are auto-detected from the specified file descriptor. Auto-detection can be overruled by calling the function with explicit *family*, *type*, or *proto* arguments. This only affects how Python represents e.g. the return value of :meth:`socket.getpeername` but not the actual OS resource. Unlike :func:`socket.fromfd`, *fileno* will return the same socket and not a duplicate. This may help close a detached socket using :meth:`socket.close`." -msgstr "" - -msgid "Raises an :ref:`auditing event ` ``socket.__new__`` with arguments ``self``, ``family``, ``type``, ``protocol``." -msgstr "" - -msgid "The AF_CAN family was added. The AF_RDS family was added." -msgstr "" - -msgid "The CAN_BCM protocol was added." -msgstr "" - -msgid "The CAN_ISOTP protocol was added." -msgstr "" - -msgid "When :const:`SOCK_NONBLOCK` or :const:`SOCK_CLOEXEC` bit flags are applied to *type* they are cleared, and :attr:`socket.type` will not reflect them. They are still passed to the underlying system ``socket()`` call. Therefore," -msgstr "" - -msgid "" -"sock = socket.socket(\n" -" socket.AF_INET,\n" -" socket.SOCK_STREAM | socket.SOCK_NONBLOCK)" -msgstr "" - -msgid "will still create a non-blocking socket on OSes that support ``SOCK_NONBLOCK``, but ``sock.type`` will be set to ``socket.SOCK_STREAM``." -msgstr "" - -msgid "The CAN_J1939 protocol was added." -msgstr "" - -msgid "The IPPROTO_MPTCP protocol was added." -msgstr "" - msgid "Socket objects have the following methods. Except for :meth:`~socket.makefile`, these correspond to Unix system calls applicable to sockets." msgstr "" @@ -850,7 +850,7 @@ msgstr "" msgid "Sockets are automatically closed when they are garbage-collected, but it is recommended to :meth:`close` them explicitly, or to use a :keyword:`with` statement around them." msgstr "" -msgid ":exc:`OSError` is now raised if an error occurs when the underlying :c:func:`!close` call is made." +msgid ":exc:`OSError` is now raised if an error occurs when the underlying :c:func:`close` call is made." msgstr "" msgid ":meth:`close` releases the resource associated with a connection but does not necessarily close the connection immediately. If you want to close the connection in a timely fashion, call :meth:`shutdown` before :meth:`close`." @@ -868,7 +868,7 @@ msgstr "" msgid "The method now waits until the connection completes instead of raising an :exc:`InterruptedError` exception if the connection is interrupted by a signal, the signal handler doesn't raise an exception and the socket is blocking or has a timeout (see the :pep:`475` for the rationale)." msgstr "" -msgid "Like ``connect(address)``, but return an error indicator instead of raising an exception for errors returned by the C-level :c:func:`!connect` call (other problems, such as \"host not found,\" can still raise exceptions). The error indicator is ``0`` if the operation succeeded, otherwise the value of the :c:data:`errno` variable. This is useful to support, for example, asynchronous connects." +msgid "Like ``connect(address)``, but return an error indicator instead of raising an exception for errors returned by the C-level :c:func:`connect` call (other problems, such as \"host not found,\" can still raise exceptions). The error indicator is ``0`` if the operation succeeded, otherwise the value of the :c:data:`errno` variable. This is useful to support, for example, asynchronous connects." msgstr "" msgid "Put the socket object into closed state without actually closing the underlying file descriptor. The file descriptor is returned, and can be reused for other purposes." @@ -952,7 +952,7 @@ msgstr "" msgid "Some systems do not indicate the truncated length of ancillary data items which have been only partially received. If an item appears to extend beyond the end of the buffer, :meth:`recvmsg` will issue a :exc:`RuntimeWarning`, and will return the part of it which is inside the buffer provided it has not been truncated before the start of its associated data." msgstr "" -msgid "On systems which support the :const:`!SCM_RIGHTS` mechanism, the following function will receive up to *maxfds* file descriptors, returning the message data and a list containing the descriptors (while ignoring unexpected conditions such as unrelated control messages being received). See also :meth:`sendmsg`. ::" +msgid "On systems which support the :const:`SCM_RIGHTS` mechanism, the following function will receive up to *maxfds* file descriptors, returning the message data and a list containing the descriptors (while ignoring unexpected conditions such as unrelated control messages being received). See also :meth:`sendmsg`. ::" msgstr "" msgid "" @@ -1015,7 +1015,7 @@ msgstr "" msgid "Send normal and ancillary data to the socket, gathering the non-ancillary data from a series of buffers and concatenating it into a single message. The *buffers* argument specifies the non-ancillary data as an iterable of :term:`bytes-like objects ` (e.g. :class:`bytes` objects); the operating system may set a limit (:func:`~os.sysconf` value ``SC_IOV_MAX``) on the number of buffers that can be used. The *ancdata* argument specifies the ancillary data (control messages) as an iterable of zero or more tuples ``(cmsg_level, cmsg_type, cmsg_data)``, where *cmsg_level* and *cmsg_type* are integers specifying the protocol level and protocol-specific type respectively, and *cmsg_data* is a bytes-like object holding the associated data. Note that some systems (in particular, systems without :func:`CMSG_SPACE`) might support sending only one control message per call. The *flags* argument defaults to 0 and has the same meaning as for :meth:`send`. If *address* is supplied and not ``None``, it sets a destination address for the message. The return value is the number of bytes of non-ancillary data sent." msgstr "" -msgid "The following function sends the list of file descriptors *fds* over an :const:`AF_UNIX` socket, on systems which support the :const:`!SCM_RIGHTS` mechanism. See also :meth:`recvmsg`. ::" +msgid "The following function sends the list of file descriptors *fds* over an :const:`AF_UNIX` socket, on systems which support the :const:`SCM_RIGHTS` mechanism. See also :meth:`recvmsg`. ::" msgstr "" msgid "" @@ -1052,7 +1052,7 @@ msgstr "" msgid "The method no longer applies :const:`SOCK_NONBLOCK` flag on :attr:`socket.type`." msgstr "" -msgid "Set a timeout on blocking socket operations. The *value* argument can be a nonnegative real number expressing seconds, or ``None``. If a non-zero value is given, subsequent socket operations will raise a :exc:`timeout` exception if the timeout period *value* has elapsed before the operation has completed. If zero is given, the socket is put in non-blocking mode. If ``None`` is given, the socket is put in blocking mode." +msgid "Set a timeout on blocking socket operations. The *value* argument can be a nonnegative floating-point number expressing seconds, or ``None``. If a non-zero value is given, subsequent socket operations will raise a :exc:`timeout` exception if the timeout period *value* has elapsed before the operation has completed. If zero is given, the socket is put in non-blocking mode. If ``None`` is given, the socket is put in blocking mode." msgstr "" msgid "For further information, please consult the :ref:`notes on socket timeouts `." @@ -1061,7 +1061,7 @@ msgstr "" msgid "The method no longer toggles :const:`SOCK_NONBLOCK` flag on :attr:`socket.type`." msgstr "" -msgid "Set the value of the given socket option (see the Unix manual page :manpage:`setsockopt(2)`). The needed symbolic constants are defined in this module (:ref:`!SO_\\* etc. `). The value can be an integer, ``None`` or a :term:`bytes-like object` representing a buffer. In the latter case it is up to the caller to ensure that the bytestring contains the proper bits (see the optional built-in module :mod:`struct` for a way to encode C structures as bytestrings). When *value* is set to ``None``, *optlen* argument is required. It's equivalent to calling :c:func:`!setsockopt` C function with ``optval=NULL`` and ``optlen=optlen``." +msgid "Set the value of the given socket option (see the Unix manual page :manpage:`setsockopt(2)`). The needed symbolic constants are defined in this module (:ref:`!SO_\\* etc. `). The value can be an integer, ``None`` or a :term:`bytes-like object` representing a buffer. In the latter case it is up to the caller to ensure that the bytestring contains the proper bits (see the optional built-in module :mod:`struct` for a way to encode C structures as bytestrings). When *value* is set to ``None``, *optlen* argument is required. It's equivalent to calling :c:func:`setsockopt` C function with ``optval=NULL`` and ``optlen=optlen``." msgstr "" msgid "setsockopt(level, optname, None, optlen: int) form added." @@ -1073,7 +1073,7 @@ msgstr "" msgid "Duplicate a socket and prepare it for sharing with a target process. The target process must be provided with *process_id*. The resulting bytes object can then be passed to the target process using some form of interprocess communication and the socket can be recreated there using :func:`fromshare`. Once this method has been called, it is safe to close the socket since the operating system has already duplicated it for the target process." msgstr "" -msgid "Note that there are no methods :meth:`!read` or :meth:`!write`; use :meth:`~socket.recv` and :meth:`~socket.send` without *flags* argument instead." +msgid "Note that there are no methods :meth:`read` or :meth:`write`; use :meth:`~socket.recv` and :meth:`~socket.send` without *flags* argument instead." msgstr "" msgid "Socket objects also have these (read-only) attributes that correspond to the values given to the :class:`~socket.socket` constructor." @@ -1088,9 +1088,6 @@ msgstr "" msgid "The socket protocol." msgstr "" -msgid "The base class of the :class:`~socket.socket` type, re-exported from :mod:`!_socket`. An instance check such as ``isinstance(socket(...), SocketType)`` is true, but ``SocketType`` is not the same as ``type(socket(...))``, which is :class:`~socket.socket` itself." -msgstr "" - msgid "Notes on socket timeouts" msgstr "" diff --git a/library/socketserver.po b/library/socketserver.po index 1714ed9dd..d2df37ede 100644 --- a/library/socketserver.po +++ b/library/socketserver.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:13+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/spwd.po b/library/spwd.po index 004392c7c..a54606e88 100644 --- a/library/spwd.po +++ b/library/spwd.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:03+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/sqlite3.po b/library/sqlite3.po index 9e84d977a..0e799d4a2 100644 --- a/library/sqlite3.po +++ b/library/sqlite3.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:13+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/ssl.po b/library/ssl.po index d393fdb6a..17ecf4820 100644 --- a/library/ssl.po +++ b/library/ssl.po @@ -15,10 +15,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:13+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/stat.po b/library/stat.po index d3bac9e2b..7063b25e5 100644 --- a/library/stat.po +++ b/library/stat.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:13+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/statistics.po b/library/statistics.po index 8b850b450..7dba7b821 100644 --- a/library/statistics.po +++ b/library/statistics.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:13+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/stdtypes.po b/library/stdtypes.po index 1ef7c0494..cbfb7e142 100644 --- a/library/stdtypes.po +++ b/library/stdtypes.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:13+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -1547,18 +1547,6 @@ msgstr "" msgid ":meth:`bytes.rstrip`" msgstr "" -msgid ":meth:`str.removeprefix`" -msgstr "" - -msgid ":meth:`bytes.removeprefix`" -msgstr "" - -msgid ":meth:`str.removesuffix`" -msgstr "" - -msgid ":meth:`bytes.removesuffix`" -msgstr "" - msgid "Translation and Encoding" msgstr "" @@ -4443,18 +4431,6 @@ msgid "" "" msgstr "" -msgid "Instances of ``GenericAlias`` are not classes at runtime, even though they behave like classes (they can be instantiated and subclassed)::" -msgstr "" - -msgid "" -">>> import inspect\n" -">>> inspect.isclass(list[int])\n" -"False" -msgstr "" - -msgid "This is true for :ref:`user-defined generics ` also." -msgstr "" - msgid "Calling :func:`repr` or :func:`str` on a generic shows the parameterized type::" msgstr "" diff --git a/library/string.po b/library/string.po index ac7142cf5..b883d0b90 100644 --- a/library/string.po +++ b/library/string.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:14+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -742,7 +742,7 @@ msgstr "" msgid "*flags* -- The regular expression flags that will be applied when compiling the regular expression used for recognizing substitutions. The default value is ``re.IGNORECASE``. Note that ``re.VERBOSE`` will always be added to the flags, so custom *idpattern*\\ s must follow conventions for verbose regular expressions." msgstr "" -msgid "Alternatively, you can provide the entire regular expression pattern by overriding the class attribute *pattern*. If you do this, the value must be a regular expression pattern string, or a compiled regular expression object, with four named capturing groups. The capturing groups correspond to the rules given above, along with the invalid placeholder rule:" +msgid "Alternatively, you can provide the entire regular expression pattern by overriding the class attribute *pattern*. If you do this, the value must be a regular expression object with four named capturing groups. The capturing groups correspond to the rules given above, along with the invalid placeholder rule:" msgstr "" msgid "*escaped* -- This group matches the escape sequence, e.g. ``$$``, in the default pattern." diff --git a/library/string.templatelib.po b/library/string.templatelib.po index 0eb507394..c39b233b8 100644 --- a/library/string.templatelib.po +++ b/library/string.templatelib.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/library/stringprep.po b/library/stringprep.po index 398e2a95a..f5a993df9 100644 --- a/library/stringprep.po +++ b/library/stringprep.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/struct.po b/library/struct.po index 62c998aea..38f7458a9 100644 --- a/library/struct.po +++ b/library/struct.po @@ -15,10 +15,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:14+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -52,13 +52,13 @@ msgstr "" msgid "Return a bytes object containing the values *v1*, *v2*, ... packed according to the format string *format*. The arguments must match the values required by the format exactly." msgstr "" -msgid "Pack the values *v1*, *v2*, ... according to the format string *format* and write the packed bytes into the writable buffer *buffer* starting at position *offset*. Note that *offset* is a required argument. A negative *offset* counts from the end of *buffer*." +msgid "Pack the values *v1*, *v2*, ... according to the format string *format* and write the packed bytes into the writable buffer *buffer* starting at position *offset*. Note that *offset* is a required argument." msgstr "" msgid "Unpack from the buffer *buffer* (presumably packed by ``pack(format, ...)``) according to the format string *format*. The result is a tuple even if it contains exactly one item. The buffer's size in bytes must match the size required by the format, as reflected by :func:`calcsize`." msgstr "" -msgid "Unpack from *buffer* starting at position *offset*, according to the format string *format*. The result is a tuple even if it contains exactly one item. The buffer's size in bytes, starting at position *offset*, must be at least the size required by the format, as reflected by :func:`calcsize`. A negative *offset* counts from the end of *buffer*." +msgid "Unpack from *buffer* starting at position *offset*, according to the format string *format*. The result is a tuple even if it contains exactly one item. The buffer's size in bytes, starting at position *offset*, must be at least the size required by the format, as reflected by :func:`calcsize`." msgstr "" msgid "Iteratively unpack from the buffer *buffer* according to the format string *format*. This function returns an iterator which will read equally sized chunks from the buffer until all its contents have been consumed. The buffer's size in bytes must be a multiple of the size required by the format, as reflected by :func:`calcsize`." diff --git a/library/subprocess.po b/library/subprocess.po index c18476367..976983786 100644 --- a/library/subprocess.po +++ b/library/subprocess.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:14+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/sunau.po b/library/sunau.po index c857affe3..36aa39c89 100644 --- a/library/sunau.po +++ b/library/sunau.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:03+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/superseded.po b/library/superseded.po index 49b505707..679a4e83c 100644 --- a/library/superseded.po +++ b/library/superseded.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/symtable.po b/library/symtable.po index 9bd18ce4e..03b264fa0 100644 --- a/library/symtable.po +++ b/library/symtable.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:14+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/sys.monitoring.po b/library/sys.monitoring.po index 5555feccf..66c315c37 100644 --- a/library/sys.monitoring.po +++ b/library/sys.monitoring.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2023-09-08 14:16+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/sys.po b/library/sys.po index 97a6097d5..930385594 100644 --- a/library/sys.po +++ b/library/sys.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:14+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -1296,7 +1296,7 @@ msgstr "" msgid "These streams are regular :term:`text files ` like those returned by the :func:`open` function. Their parameters are chosen as follows:" msgstr "" -msgid "The encoding and error handling are initialized from :c:member:`PyConfig.stdio_encoding` and :c:member:`PyConfig.stdio_errors`." +msgid "The encoding and error handling are is initialized from :c:member:`PyConfig.stdio_encoding` and :c:member:`PyConfig.stdio_errors`." msgstr "" msgid "On Windows, UTF-8 is used for the console device. Non-character devices such as disk files and pipes use the system locale encoding (i.e. the ANSI codepage). Non-console character devices such as NUL (i.e. where ``isatty()`` returns ``True``) use the value of the console input and output codepages at startup, respectively for stdin and stdout/stderr. This defaults to the system :term:`locale encoding` if the process is not initially attached to a console." diff --git a/library/sys_path_init.po b/library/sys_path_init.po index 7b34d7113..a6993ee70 100644 --- a/library/sys_path_init.po +++ b/library/sys_path_init.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2022-11-05 19:49+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/sysconfig.po b/library/sysconfig.po index 2b9263680..cd0d7c6e5 100644 --- a/library/sysconfig.po +++ b/library/sysconfig.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:14+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/syslog.po b/library/syslog.po index c4a0ce5ea..00e47b669 100644 --- a/library/syslog.po +++ b/library/syslog.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:14+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/tabnanny.po b/library/tabnanny.po index cf8716085..f6be33e3f 100644 --- a/library/tabnanny.po +++ b/library/tabnanny.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/tarfile.po b/library/tarfile.po index 00d01dd62..5c176979b 100644 --- a/library/tarfile.po +++ b/library/tarfile.po @@ -15,10 +15,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:14+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -568,7 +568,7 @@ msgstr "" msgid "If ``extraction_filter`` is ``None`` (the default), extraction methods will use the :func:`data ` filter by default." msgstr "" -msgid "The attribute may be set on instances or overridden in subclasses. It also is possible to set it on the ``TarFile`` class itself to set a global default, although, since it affects all uses of *tarfile*, it is best practice to only do so in top-level applications or :mod:`site configuration `. To set a global default this way, a filter function needs to be wrapped in :deco:`staticmethod` to prevent injection of a ``self`` argument." +msgid "The attribute may be set on instances or overridden in subclasses. It also is possible to set it on the ``TarFile`` class itself to set a global default, although, since it affects all uses of *tarfile*, it is best practice to only do so in top-level applications or :mod:`site configuration `. To set a global default this way, a filter function needs to be wrapped in :func:`staticmethod` to prevent injection of a ``self`` argument." msgstr "" msgid "The default filter is set to :func:`data `, which disallows some dangerous features such as links to absolute paths or paths outside of the destination. Previously, the default was equivalent to :func:`fully_trusted `." diff --git a/library/telnetlib.po b/library/telnetlib.po index 8a5d4ad1e..2347c6fb7 100644 --- a/library/telnetlib.po +++ b/library/telnetlib.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2024-11-19 01:03+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/tempfile.po b/library/tempfile.po index 40d7f7360..f235a1868 100644 --- a/library/tempfile.po +++ b/library/tempfile.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:14+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -156,7 +156,7 @@ msgstr "" msgid "The file descriptor is :ref:`not inherited by child processes `." msgstr "" -msgid "Unlike :func:`TemporaryFile`, the user of :func:`mkstemp` is responsible for closing the file descriptor (for example, using :func:`os.close`) and deleting the temporary file (for example, using :func:`os.remove`)." +msgid "Unlike :func:`TemporaryFile`, the user of :func:`mkstemp` is responsible for deleting the temporary file when done with it." msgstr "" msgid "If *suffix* is not ``None``, the file name will end with that suffix, otherwise there will be no suffix. :func:`mkstemp` does not put a dot between the file name and the suffix; if you need one, put it at the beginning of *suffix*." diff --git a/library/termios.po b/library/termios.po index 84c0d3cdd..7c2a4341c 100644 --- a/library/termios.po +++ b/library/termios.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:14+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/test.po b/library/test.po index 5f294c153..b7d31e78d 100644 --- a/library/test.po +++ b/library/test.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:14+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -516,7 +516,7 @@ msgstr "" msgid "For testcase *test*, assert that the ``sys.getsizeof`` for *o* plus the GC header size equals *size*." msgstr "" -msgid "A decorator to conditionally mark tests with :deco:`unittest.expectedFailure`. Any use of this decorator should have an associated comment identifying the relevant tracker issue." +msgid "A decorator to conditionally mark tests with :func:`unittest.expectedFailure`. Any use of this decorator should have an associated comment identifying the relevant tracker issue." msgstr "" msgid "A decorator that skips the decorated test on TLS certification validation failures." @@ -650,24 +650,6 @@ msgstr "" msgid "Run *code* in subinterpreter. Raise :exc:`unittest.SkipTest` if :mod:`tracemalloc` is enabled." msgstr "" -msgid "Decorator that runs the decorated test in a fresh interpreter subprocess, in isolation, so that it does not share global or interpreter state with the rest of the test run. It can decorate a test method or a whole :class:`~unittest.TestCase` subclass. Decorated methods must take no extra arguments. A failure, error or skip in the subprocess is reported for the corresponding test, and individual :meth:`subtests ` that fail or are skipped are reported individually. A reported failure or error shows the original subprocess traceback as the cause of the exception." -msgstr "" - -msgid "When a **method** is decorated, only that method runs in a subprocess; all fixtures (:meth:`~unittest.TestCase.setUp` / :meth:`~unittest.TestCase.tearDown`, :meth:`~unittest.TestCase.setUpClass` / :meth:`~unittest.TestCase.tearDownClass` and ``setUpModule()`` / ``tearDownModule()``) run both in the parent process (as usual) and in the subprocess around the method." -msgstr "" - -msgid "When a **class** is decorated, the whole class runs in a single subprocess, and :meth:`~unittest.TestCase.setUpClass`, :meth:`~unittest.TestCase.tearDownClass`, :meth:`~unittest.TestCase.setUp` and :meth:`~unittest.TestCase.tearDown` run once each in the subprocess and are skipped in the parent process. A failure or skip of :meth:`~unittest.TestCase.setUpClass` in the subprocess is reported for the whole class. ``setUpModule()`` cannot be controlled by a class decorator, so it still runs in the parent process too; test it with :data:`runningInSubprocess` if needed." -msgstr "" - -msgid "The subprocess inherits the enabled resources (``-u``), memory limit (``-M``) and verbosity (``-v``) of the parent test run, so that :func:`~test.support.requires_resource`, :func:`~test.support.requires`, :func:`~test.support.bigmemtest` and the like behave consistently in both processes." -msgstr "" - -msgid "The test is skipped on platforms without subprocess support." -msgstr "" - -msgid "``True`` while the code runs in the isolated subprocess spawned by :func:`runInSubprocess`, and ``False`` otherwise (including in the parent process and in a normal, non-isolated test run). Fixtures such as :meth:`~unittest.TestCase.setUp`, :meth:`~unittest.TestCase.tearDown`, :meth:`~unittest.TestCase.setUpClass`, :meth:`~unittest.TestCase.tearDownClass`, ``setUpModule()`` and ``tearDownModule()`` can test it to choose which code to run in the subprocess." -msgstr "" - msgid "Assert instances of *cls* are deallocated after iterating." msgstr "" diff --git a/library/text.po b/library/text.po index 184d8d79b..42faeb65d 100644 --- a/library/text.po +++ b/library/text.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/textwrap.po b/library/textwrap.po index 2d63b1dd3..560669bee 100644 --- a/library/textwrap.po +++ b/library/textwrap.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:15+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/threading.po b/library/threading.po index 43ffbfbc9..ce323f120 100644 --- a/library/threading.po +++ b/library/threading.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:15+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/threadsafety.po b/library/threadsafety.po index 2845cca95..500e09454 100644 --- a/library/threadsafety.po +++ b/library/threadsafety.po @@ -10,7 +10,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2026-07-25 12:59+0330\n" "Last-Translator: Sepehr Rasouli , 2026\n" "Language-Team: none\n" diff --git a/library/time.po b/library/time.po index f28886b9b..bc530dda0 100644 --- a/library/time.po +++ b/library/time.po @@ -15,10 +15,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:15+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/timeit.po b/library/timeit.po index c4a23dcbd..6a8178aa1 100644 --- a/library/timeit.po +++ b/library/timeit.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:15+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/tk.po b/library/tk.po index d01183bc9..092e387ae 100644 --- a/library/tk.po +++ b/library/tk.po @@ -13,10 +13,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:15+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" diff --git a/library/tkinter.colorchooser.po b/library/tkinter.colorchooser.po index a172ef6e5..bae59381d 100644 --- a/library/tkinter.colorchooser.po +++ b/library/tkinter.colorchooser.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,13 +30,7 @@ msgstr "" msgid "The :mod:`!tkinter.colorchooser` module provides the :class:`Chooser` class as an interface to the native color picker dialog. ``Chooser`` implements a modal color choosing dialog window. The ``Chooser`` class inherits from the :class:`~tkinter.commondialog.Dialog` class." msgstr "" -msgid "The class implementing the modal color-choosing dialog. Most applications use the :func:`askcolor` convenience function rather than instantiating this class directly." -msgstr "" - -msgid "Show a modal color-choosing dialog and return the chosen color. *color* is the color selected when the dialog opens. The return value is a tuple ``((r, g, b), hexstr)``, where ``r``, ``g`` and ``b`` are the red, green and blue components as integers in the range 0–255 and *hexstr* is the equivalent Tk color string, such as ``'#ff8000'``. If the user cancels the dialog, ``(None, None)`` is returned." -msgstr "" - -msgid "The RGB values in the returned color are now integers in the range 0–255 instead of floats." +msgid "Create a color choosing dialog. A call to this method will show the window, wait for the user to make a selection, and return the selected color (or ``None``) to the caller." msgstr "" msgid "Module :mod:`tkinter.commondialog`" diff --git a/library/tkinter.dnd.po b/library/tkinter.dnd.po index 1b71b331e..276c98f39 100644 --- a/library/tkinter.dnd.po +++ b/library/tkinter.dnd.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,34 +30,34 @@ msgstr "" msgid "This is experimental and due to be deprecated when it is replaced with the Tk DND." msgstr "" -msgid "The :mod:`!tkinter.dnd` module provides drag-and-drop support for objects within a single application, within the same window or between windows. To enable an object to be dragged, you must create an event binding for it that starts the drag-and-drop process. Typically, you bind a ButtonPress event to a callback function that you write (see :ref:`Bindings-and-Events`). The function should call :func:`dnd_start`, where *source* is the object to be dragged, and *event* is the event that invoked the call (the argument to your callback function)." +msgid "The :mod:`!tkinter.dnd` module provides drag-and-drop support for objects within a single application, within the same window or between windows. To enable an object to be dragged, you must create an event binding for it that starts the drag-and-drop process. Typically, you bind a ButtonPress event to a callback function that you write (see :ref:`Bindings-and-Events`). The function should call :func:`dnd_start`, where 'source' is the object to be dragged, and 'event' is the event that invoked the call (the argument to your callback function)." msgstr "" msgid "Selection of a target object occurs as follows:" msgstr "" -msgid "Top-down search of the area under the mouse for a target widget:" +msgid "Top-down search of area under mouse for target widget" msgstr "" -msgid "the target widget should have a callable *dnd_accept* attribute;" +msgid "Target widget should have a callable *dnd_accept* attribute" msgstr "" -msgid "if *dnd_accept* is not present or returns ``None``, the search moves to the parent widget;" +msgid "If *dnd_accept* is not present or returns ``None``, search moves to parent widget" msgstr "" -msgid "if no target widget is found, the target object is ``None``." +msgid "If no target widget is found, then the target object is ``None``" msgstr "" -msgid "Call to ``.dnd_leave(source, event)``." +msgid "Call to *.dnd_leave(source, event)*" msgstr "" -msgid "Call to ``.dnd_enter(source, event)``." +msgid "Call to *.dnd_enter(source, event)*" msgstr "" -msgid "Call to ``.dnd_commit(source, event)`` to notify of the drop." +msgid "Call to *.dnd_commit(source, event)* to notify of drop" msgstr "" -msgid "Call to ``.dnd_end(target, event)`` to signal the end of drag-and-drop." +msgid "Call to *.dnd_end(target, event)* to signal end of drag-and-drop" msgstr "" msgid "The *DndHandler* class handles drag-and-drop events tracking Motion and ButtonRelease events on the root of the event widget." @@ -69,13 +69,13 @@ msgstr "" msgid "Execute end of drag-and-drop functions." msgstr "" -msgid "Inspect area below mouse for target objects while a drag is performed." +msgid "Inspect area below mouse for target objects while drag is performed." msgstr "" msgid "Signal end of drag when the release pattern is triggered." msgstr "" -msgid "Factory function for the drag-and-drop process. Return the :class:`DndHandler` instance managing the drag, or ``None`` if a drag could not be started." +msgid "Factory function for drag-and-drop process." msgstr "" msgid ":ref:`Bindings-and-Events`" diff --git a/library/tkinter.font.po b/library/tkinter.font.po index 700c070b7..082147132 100644 --- a/library/tkinter.font.po +++ b/library/tkinter.font.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -36,9 +36,6 @@ msgstr "" msgid "The :class:`Font` class represents a named font. *Font* instances are given unique names and can be specified by their family, size, and style configuration. Named fonts are Tk's method of creating and identifying fonts as a single object, rather than specifying a font by its attributes with each occurrence." msgstr "" -msgid "Two fonts now compare equal (``==``) only when both are :class:`Font` instances with the same name belonging to the same Tcl interpreter." -msgstr "" - msgid "arguments:" msgstr "" @@ -54,7 +51,7 @@ msgstr "" msgid "additional keyword options (ignored if *font* is specified):" msgstr "" -msgid "*family* - font family, for example, Courier, Times" +msgid "*family* - font family i.e. Courier, Times" msgstr "" msgid "*size* - font size" @@ -81,25 +78,22 @@ msgstr "" msgid "*overstrike* - font strikeout (0 - none, 1 - strikeout)" msgstr "" -msgid "Return the actual attributes of the font, which may differ from the requested ones because of platform limitations. With no *option*, return a dictionary of all the attributes; if *option* is given, return the value of that single attribute. The attributes are resolved on the display of the *displayof* widget, or the main application window if it is not specified." +msgid "Return the attributes of the font." msgstr "" msgid "Retrieve an attribute of the font." msgstr "" -msgid "Modify one or more attributes of the font. With no arguments, return a dictionary of the current attributes." -msgstr "" - -msgid ":meth:`config` is an alias of :meth:`!configure`." +msgid "Modify attributes of the font." msgstr "" -msgid "Return a distinct copy of the current font: a new named font with the same attributes but a different name, which can be reconfigured independently of the original. If the current font wraps a font description, the copy is instead a named font with its resolved attributes." +msgid "Return new instance of the current font." msgstr "" -msgid "Return amount of space the text would occupy on the specified display when formatted in the current font, as an integer number of pixels. If no display is specified then the main application window is assumed." +msgid "Return amount of space the text would occupy on the specified display when formatted in the current font. If no display is specified then the main application window is assumed." msgstr "" -msgid "Return font-specific data. With no options, return a dictionary mapping each metric name to its integer value; if one option name is given, return that metric's value as an integer. Options include:" +msgid "Return font-specific data. Options include:" msgstr "" msgid "*ascent* - distance between baseline and highest point that a" @@ -120,13 +114,13 @@ msgstr "" msgid "*fixed* - 1 if font is fixed-width else 0" msgstr "" -msgid "Return a tuple of the names of the available font families." +msgid "Return the different font families." msgstr "" -msgid "Return a tuple of the names of all the defined fonts." +msgid "Return the names of defined fonts." msgstr "" -msgid "Return a :class:`Font` representation of the existing named font *name*. *root* is the widget whose Tcl interpreter owns the font; if omitted, the default root window is used." +msgid "Return a :class:`Font` representation of a tk named font." msgstr "" msgid "The *root* parameter was added." diff --git a/library/tkinter.messagebox.po b/library/tkinter.messagebox.po index 9aed0be72..569622b2d 100644 --- a/library/tkinter.messagebox.po +++ b/library/tkinter.messagebox.po @@ -12,9 +12,9 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -27,7 +27,7 @@ msgstr "" msgid "**Source code:** :source:`Lib/tkinter/messagebox.py`" msgstr "" -msgid "The :mod:`!tkinter.messagebox` module provides a template base class as well as a variety of convenience methods for commonly used configurations. The message boxes are modal: each blocks until the user responds, then returns a value that depends on the function. The ``show*`` functions and :meth:`Message.show` return the symbolic name of the button the user pressed, as a string (such as :data:`OK` or :data:`YES`). Common message box styles and layouts include but are not limited to:" +msgid "The :mod:`!tkinter.messagebox` module provides a template base class as well as a variety of convenience methods for commonly used configurations. The message boxes are modal and will return a subset of (``True``, ``False``, ``None``, :data:`OK`, :data:`CANCEL`, :data:`YES`, :data:`NO`) based on the user's selection. Common message box styles and layouts include but are not limited to:" msgstr "" msgid "Create a message window with an application-specified message, an icon and a set of buttons. Each of the buttons in the message window is identified by a unique symbolic name (see the *type* options)." @@ -84,9 +84,6 @@ msgstr "" msgid "Arranges for a :ref:`predefined set of buttons ` to be displayed." msgstr "" -msgid "Tk 8.6 added the *command* option." -msgstr "" - msgid "Display a message window and wait for the user to select one of the buttons. Then return the symbolic name of the selected button. Keyword arguments can override options specified in the constructor." msgstr "" @@ -114,7 +111,7 @@ msgstr "" msgid "Ask if operation should proceed. Shows buttons :data:`OK` and :data:`CANCEL`. Returns ``True`` if the answer is ok and ``False`` otherwise." msgstr "" -msgid "Ask if operation should be retried. Shows buttons :data:`RETRY` and :data:`CANCEL`. Return ``True`` if the answer is retry and ``False`` otherwise." +msgid "Ask if operation should be retried. Shows buttons :data:`RETRY` and :data:`CANCEL`. Return ``True`` if the answer is yes and ``False`` otherwise." msgstr "" msgid "Ask a question. Shows buttons :data:`YES` and :data:`NO`. Returns ``True`` if the answer is yes and ``False`` otherwise." diff --git a/library/tkinter.po b/library/tkinter.po index 70b41a61b..04ee920c9 100644 --- a/library/tkinter.po +++ b/library/tkinter.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:15+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -36,16 +36,13 @@ msgstr "" msgid "Running ``python -m tkinter`` from the command line should open a window demonstrating a simple Tk interface, letting you know that :mod:`!tkinter` is properly installed on your system, and also showing what version of Tcl/Tk is installed, so you can read the Tcl/Tk documentation specific to that version." msgstr "" -msgid "Tkinter supports a range of Tcl/Tk versions, built either with or without thread support. Tcl/Tk 8.5.12 is the minimum supported version; the official Python binary release bundles Tcl/Tk 8.6. See the source code for the :mod:`_tkinter` module for more information about supported versions." -msgstr "" - -msgid "Support for Tcl/Tk versions older than 8.5.12 was removed." +msgid "Tkinter supports a range of Tcl/Tk versions, built either with or without thread support. The official Python binary release bundles Tcl/Tk 8.6 threaded. See the source code for the :mod:`_tkinter` module for more information about supported versions." msgstr "" msgid "Tkinter is not a thin wrapper, but adds a fair amount of its own logic to make the experience more pythonic. This documentation will concentrate on these additions and changes, and refer to the official Tcl/Tk documentation for details that are unchanged." msgstr "" -msgid "Tcl/Tk 8.5 (2007) introduced a modern set of themed user interface components along with a new API to use them (see :mod:`tkinter.ttk`). Both old and new APIs are still available. Most documentation you will find online still uses the old API and can be woefully outdated." +msgid "Tcl/Tk 8.5 (2007) introduced a modern set of themed user interface components along with a new API to use them. Both old and new APIs are still available. Most documentation you will find online still uses the old API and can be woefully outdated." msgstr "" msgid "This is an :term:`optional module`. If it is missing from your copy of CPython, look for documentation from your distributor (that is, whoever provided Python to you). If you are the distributor, see :ref:`optional-module-requirements`." @@ -66,7 +63,7 @@ msgstr "" msgid "Tcl/Tk Resources:" msgstr "" -msgid "`Tk commands `_" +msgid "`Tk commands `_" msgstr "" msgid "Comprehensive reference to each of the underlying Tcl/Tk commands used by Tkinter." @@ -129,13 +126,13 @@ msgstr "" msgid "Themed Tk (Ttk) is a newer family of Tk widgets that provide a much better appearance on different platforms than many of the classic Tk widgets. Ttk is distributed as part of Tk, starting with Tk version 8.5. Python bindings are provided in a separate module, :mod:`tkinter.ttk`." msgstr "" -msgid "Internally, Tk and Ttk use facilities of the underlying operating system, that is, Xlib on Unix/X11, Cocoa on macOS, GDI on Windows." +msgid "Internally, Tk and Ttk use facilities of the underlying operating system, i.e., Xlib on Unix/X11, Cocoa on macOS, GDI on Windows." msgstr "" -msgid "When your Python application uses a class in Tkinter, for example, to create a widget, the :mod:`!tkinter` module first assembles a Tcl/Tk command string. It passes that Tcl command string to an internal :mod:`_tkinter` binary module, which then calls the Tcl interpreter to evaluate it. The Tcl interpreter will then call into the Tk and/or Ttk packages, which will in turn make calls to Xlib, Cocoa, or GDI." +msgid "When your Python application uses a class in Tkinter, e.g., to create a widget, the :mod:`!tkinter` module first assembles a Tcl/Tk command string. It passes that Tcl command string to an internal :mod:`_tkinter` binary module, which then calls the Tcl interpreter to evaluate it. The Tcl interpreter will then call into the Tk and/or Ttk packages, which will in turn make calls to Xlib, Cocoa, or GDI." msgstr "" -msgid "Tkinter modules" +msgid "Tkinter Modules" msgstr "" msgid "Support for Tkinter is spread across several modules. Most applications will need the main :mod:`!tkinter` module, as well as the :mod:`tkinter.ttk` module, which provides the modern themed widget set and API::" @@ -146,6 +143,66 @@ msgid "" "from tkinter import ttk" msgstr "" +msgid "Construct a toplevel Tk widget, which is usually the main window of an application, and initialize a Tcl interpreter for this widget. Each instance has its own associated Tcl interpreter." +msgstr "" + +msgid "The :class:`Tk` class is typically instantiated using all default values. However, the following keyword arguments are currently recognized:" +msgstr "" + +msgid "*screenName*" +msgstr "" + +msgid "When given (as a string), sets the :envvar:`DISPLAY` environment variable. (X11 only)" +msgstr "" + +msgid "*baseName*" +msgstr "" + +msgid "Name of the profile file. By default, *baseName* is derived from the program name (``sys.argv[0]``)." +msgstr "" + +msgid "*className*" +msgstr "" + +msgid "Name of the widget class. Used as a profile file and also as the name with which Tcl is invoked (*argv0* in *interp*)." +msgstr "" + +msgid "*useTk*" +msgstr "" + +msgid "If ``True``, initialize the Tk subsystem. The :func:`tkinter.Tcl() ` function sets this to ``False``." +msgstr "" + +msgid "*sync*" +msgstr "" + +msgid "If ``True``, execute all X server commands synchronously, so that errors are reported immediately. Can be used for debugging. (X11 only)" +msgstr "" + +msgid "*use*" +msgstr "" + +msgid "Specifies the *id* of the window in which to embed the application, instead of it being created as an independent toplevel window. *id* must be specified in the same way as the value for the -use option for toplevel widgets (that is, it has a form like that returned by :meth:`winfo_id`)." +msgstr "" + +msgid "Note that on some platforms this will only work correctly if *id* refers to a Tk frame or toplevel that has its -container option enabled." +msgstr "" + +msgid ":class:`Tk` reads and interprets profile files, named :file:`.{className}.tcl` and :file:`.{baseName}.tcl`, into the Tcl interpreter and calls :func:`exec` on the contents of :file:`.{className}.py` and :file:`.{baseName}.py`. The path for the profile files is the :envvar:`HOME` environment variable or, if that isn't defined, then :data:`os.curdir`." +msgstr "" + +msgid "The Tk application object created by instantiating :class:`Tk`. This provides access to the Tcl interpreter. Each widget that is attached the same instance of :class:`Tk` has the same value for its :attr:`tk` attribute." +msgstr "" + +msgid "The widget object that contains this widget. For :class:`Tk`, the :attr:`!master` is :const:`None` because it is the main window. The terms *master* and *parent* are similar and sometimes used interchangeably as argument names; however, calling :meth:`winfo_parent` returns a string of the widget name whereas :attr:`!master` returns the object. *parent*/*child* reflects the tree-like relationship while *master* (or *container*)/*content* reflects the container structure." +msgstr "" + +msgid "The immediate descendants of this widget as a :class:`dict` with the child widget names as the keys and the child instance objects as the values." +msgstr "" + +msgid "The :func:`Tcl` function is a factory function which creates an object much like that created by the :class:`Tk` class, except that it does not initialize the Tk subsystem. This is most often useful when driving the Tcl interpreter in an environment where one doesn't want to create extraneous toplevel windows, or where one cannot (such as Unix/Linux systems without an X server). An object created by the :func:`Tcl` object can have a Toplevel window created (and the Tk subsystem initialized) by calling its :meth:`loadtk` method." +msgstr "" + msgid "The modules that provide Tk support include:" msgstr "" @@ -218,7 +275,7 @@ msgstr "" msgid "Python's Integrated Development and Learning Environment (IDLE). Based on :mod:`!tkinter`." msgstr "" -msgid ":mod:`!tkinter.constants`" +msgid ":mod:`tkinter.constants`" msgstr "" msgid "Symbolic constants that can be used in place of strings when passing various parameters to Tkinter calls. Automatically imported by the main :mod:`!tkinter` module." @@ -236,7 +293,7 @@ msgstr "" msgid "Turtle graphics in a Tk window." msgstr "" -msgid "Tkinter life preserver" +msgid "Tkinter Life Preserver" msgstr "" msgid "This section is not designed to be an exhaustive tutorial on either Tk or Tkinter. For that, refer to one of the external resources noted earlier. Instead, this section provides a very quick orientation to what a Tkinter application looks like, identifies foundational Tk concepts, and explains how the Tkinter wrapper is structured." @@ -245,7 +302,7 @@ msgstr "" msgid "The remainder of this section will help you to identify the classes, methods, and options you'll need in your Tkinter application, and where to find more detailed documentation on them, including in the official Tcl/Tk reference manual." msgstr "" -msgid "A Hello World program" +msgid "A Hello World Program" msgstr "" msgid "We'll start by walking through a \"Hello World\" application in Tkinter. This isn't the smallest one we could write, but has enough to illustrate some key concepts you'll need to know." @@ -268,16 +325,16 @@ msgstr "" msgid "The following line creates a frame widget, which in this case will contain a label and a button we'll create next. The frame is fit inside the root window." msgstr "" -msgid "The next line creates a label widget holding a static text string. The :meth:`~Grid.grid` method is used to specify the relative layout (position) of the label within its containing frame widget, similar to how tables in HTML work." +msgid "The next line creates a label widget holding a static text string. The :meth:`grid` method is used to specify the relative layout (position) of the label within its containing frame widget, similar to how tables in HTML work." msgstr "" -msgid "A button widget is then created, and placed to the right of the label. When pressed, it will call the :meth:`~Misc.destroy` method of the root window." +msgid "A button widget is then created, and placed to the right of the label. When pressed, it will call the :meth:`destroy` method of the root window." msgstr "" msgid "Finally, the :meth:`mainloop` method puts everything on the display, and responds to user input until the program terminates." msgstr "" -msgid "Important Tk concepts" +msgid "Important Tk Concepts" msgstr "" msgid "Even this simple program illustrates the following key Tk concepts:" @@ -313,7 +370,7 @@ msgstr "" msgid "Tkinter reacts to user input, changes from your program, and even refreshes the display only when actively running an *event loop*. If your program isn't running the event loop, your user interface won't update." msgstr "" -msgid "Understanding how Tkinter wraps Tcl/Tk" +msgid "Understanding How Tkinter Wraps Tcl/Tk" msgstr "" msgid "When your application uses Tkinter's classes and methods, internally Tkinter is assembling strings representing Tcl/Tk commands, and executing those commands in the Tcl interpreter attached to your application's :class:`Tk` instance." @@ -362,7 +419,7 @@ msgstr "" msgid "When searching for how to use an API, it helps to know the exact name of the class, option, or method that you're using. Introspection, either in an interactive Python shell or with :func:`print`, can help you identify what you need." msgstr "" -msgid "To find out what configuration options are available on any widget, call its :meth:`~Misc.configure` method, which returns a dictionary containing a variety of information about each object, including its default and current values. Use :meth:`~Misc.keys` to get just the names of each option." +msgid "To find out what configuration options are available on any widget, call its :meth:`configure` method, which returns a dictionary containing a variety of information about each object, including its default and current values. Use :meth:`keys` to get just the names of each option." msgstr "" msgid "" @@ -384,13 +441,13 @@ msgid "" "print(set(dir(btn)) - set(dir(frm)))" msgstr "" -msgid "Navigating the Tcl/Tk reference manual" +msgid "Navigating the Tcl/Tk Reference Manual" msgstr "" -msgid "As noted, the official `Tk commands `_ reference manual (man pages) is often the most accurate description of what specific operations on widgets do. Even when you know the name of the option or method that you need, you may still have a few places to look." +msgid "As noted, the official `Tk commands `_ reference manual (man pages) is often the most accurate description of what specific operations on widgets do. Even when you know the name of the option or method that you need, you may still have a few places to look." msgstr "" -msgid "While all operations in Tkinter are implemented as method calls on widget objects, you've seen that many Tcl/Tk operations appear as commands that take a widget pathname as its first parameter, followed by optional parameters, for example" +msgid "While all operations in Tkinter are implemented as method calls on widget objects, you've seen that many Tcl/Tk operations appear as commands that take a widget pathname as its first parameter, followed by optional parameters, e.g." msgstr "" msgid "" @@ -406,13 +463,13 @@ msgid "" ".frm.lbl configure -text \"Goodbye\"" msgstr "" -msgid "In the official Tcl/Tk reference documentation, you'll find most operations that look like method calls on the man page for a specific widget (for example, you'll find the :meth:`~tkinter.ttk.Button.invoke` method on the `ttk::button `_ man page), while functions that take a widget as a parameter often have their own man page (for example, `grid `_)." +msgid "In the official Tcl/Tk reference documentation, you'll find most operations that look like method calls on the man page for a specific widget (e.g., you'll find the :meth:`invoke` method on the `ttk::button `_ man page), while functions that take a widget as a parameter often have their own man page (e.g., `grid `_)." msgstr "" -msgid "You'll find many common options and methods in the `options `_ or `ttk::widget `_ man pages, while others are found in the man page for a specific widget class." +msgid "You'll find many common options and methods in the `options `_ or `ttk::widget `_ man pages, while others are found in the man page for a specific widget class." msgstr "" -msgid "You'll also find that many Tkinter methods have compound names, for example, :meth:`~Misc.winfo_x`, :meth:`~Misc.winfo_height`, :meth:`~Misc.winfo_viewable`. You'd find documentation for all of these in the `winfo `_ man page." +msgid "You'll also find that many Tkinter methods have compound names, e.g., :func:`winfo_x`, :func:`winfo_height`, :func:`winfo_viewable`. You'd find documentation for all of these in the `winfo `_ man page." msgstr "" msgid "Somewhat confusingly, there are also methods on all Tkinter widgets that don't actually operate on the widget, but operate at a global scope, independent of any widget. Examples are methods for accessing the clipboard or the system bell. (They happen to be implemented as methods in the base :class:`Widget` class that all Tkinter widgets inherit from)." @@ -430,7 +487,7 @@ msgstr "" msgid "Each :class:`Tk` object created by :mod:`!tkinter` contains a Tcl interpreter. It also keeps track of which thread created that interpreter. Calls to :mod:`!tkinter` can be made from any Python thread. Internally, if a call comes from a thread other than the one that created the :class:`Tk` object, an event is posted to the interpreter's event queue, and when executed, the result is returned to the calling Python thread." msgstr "" -msgid "Tcl/Tk applications are normally event-driven, meaning that after initialization, the interpreter runs an event loop (that is, :meth:`Tk.mainloop `) and responds to events. Because it is single-threaded, event handlers must respond quickly, otherwise they will block other events from being processed. To avoid this, any long-running computations should not run in an event handler, but are either broken into smaller pieces using timers, or run in another thread. This is different from many GUI toolkits where the GUI runs in a completely separate thread from all application code including event handlers." +msgid "Tcl/Tk applications are normally event-driven, meaning that after initialization, the interpreter runs an event loop (i.e. :func:`Tk.mainloop`) and responds to events. Because it is single-threaded, event handlers must respond quickly, otherwise they will block other events from being processed. To avoid this, any long-running computations should not run in an event handler, but are either broken into smaller pieces using timers, or run in another thread. This is different from many GUI toolkits where the GUI runs in a completely separate thread from all application code including event handlers." msgstr "" msgid "If the Tcl interpreter is not running the event loop and processing events, any :mod:`!tkinter` calls made from threads other than the one running the Tcl interpreter will fail." @@ -439,7 +496,7 @@ msgstr "" msgid "A number of special cases exist:" msgstr "" -msgid "Tcl/Tk libraries built without thread support are now rare: the bundled Tcl/Tk 8.6 is built with thread support, so this case only arises with some older non-threaded builds. When the library is not thread-aware, :mod:`!tkinter` calls the library from the originating Python thread, even if this is different than the thread that created the Tcl interpreter. A global lock ensures only one call occurs at a time." +msgid "Tcl/Tk libraries can be built so they are not thread-aware. In this case, :mod:`!tkinter` calls the library from the originating Python thread, even if this is different than the thread that created the Tcl interpreter. A global lock ensures only one call occurs at a time." msgstr "" msgid "While :mod:`!tkinter` allows you to create more than one instance of a :class:`Tk` object (with its own interpreter), all interpreters that are part of the same thread share a common event queue, which gets ugly fast. In practice, don't create more than one instance of :class:`Tk` at a time. Otherwise, it's best to create them in separate threads and ensure you're running a thread-aware Tcl/Tk build." @@ -451,10 +508,10 @@ msgstr "" msgid "There are a few select :mod:`!tkinter` functions that presently work only when called from the thread that created the Tcl interpreter." msgstr "" -msgid "Handy reference" +msgid "Handy Reference" msgstr "" -msgid "Setting options" +msgid "Setting Options" msgstr "" msgid "Options control things like the color and border width of a widget. Options can be set in three ways:" @@ -480,9 +537,6 @@ msgstr "" msgid "fred.config(fg=\"red\", bg=\"blue\")" msgstr "" -msgid "The ``fg`` and ``bg`` options used here, and other options that control a widget's appearance, belong to the classic :mod:`!tkinter` widgets. The themed :mod:`tkinter.ttk` widgets recommended in the introduction do not accept them; style a themed widget through the :class:`ttk.Style ` class instead. The three ways of setting an option shown above apply to both widget sets." -msgstr "" - msgid "For a complete explanation of a given option and its behavior, see the Tk man pages for the widget in question." msgstr "" @@ -492,10 +546,10 @@ msgstr "" msgid "No distinction between standard and widget-specific options is made in this document. Some options don't apply to some kinds of widgets. Whether a given widget responds to a particular option depends on the class of the widget; buttons have a ``command`` option, labels do not." msgstr "" -msgid "The options supported by a given widget are listed in that widget's man page, or can be queried at runtime by calling the :meth:`~Misc.config` method without arguments, or by calling the :meth:`~Misc.keys` method on that widget. The return value of these calls is a dictionary whose key is the name of the option as a string (for example, ``'relief'``) and whose values are 5-tuples." +msgid "The options supported by a given widget are listed in that widget's man page, or can be queried at runtime by calling the :meth:`config` method without arguments, or by calling the :meth:`keys` method on that widget. The return value of these calls is a dictionary whose key is the name of the option as a string (for example, ``'relief'``) and whose values are 5-tuples." msgstr "" -msgid "Some options, like ``bg``, are synonyms for common options with long names (``bg`` is shorthand for \"background\")." +msgid "Some options, like ``bg`` are synonyms for common options with long names (``bg`` is shorthand for \"background\"). Passing the ``config()`` method the name of a shorthand option will return a 2-tuple, not 5-tuple. The 2-tuple passed back will contain the name of the synonym and the \"real\" option (such as ``('bg', 'background')``)." msgstr "" msgid "Index" @@ -560,72 +614,79 @@ msgstr "" msgid "Of course, the dictionary printed will include all the options available and their values. This is meant only as an example." msgstr "" -msgid "Geometry management" +msgid "The Packer" msgstr "" -msgid "Creating a widget does not display it. A widget appears only after it has been handed to a *geometry manager*, which works out its size and position inside its container and keeps the layout up to date as the container is resized or its content changes. Forgetting to call a geometry manager is a common early mistake: the widget is created, but nothing shows up." +msgid "The packer is one of Tk's geometry-management mechanisms. Geometry managers are used to specify the relative positioning of widgets within their container. In contrast to the more cumbersome *placer* (which is used less commonly, and we do not cover here), the packer takes qualitative relationship specification - *above*, *to the left of*, *filling*, etc - and works everything out to determine the exact placement coordinates for you." msgstr "" -msgid "Tk provides three geometry managers. Each is inherited by every widget, so any widget can be managed by any of them (but see the warning below about the incompatibility of grid and pack). The choice depends on the kind of layout you want." +msgid "The size of any container widget is determined by the size of the \"content widgets\" inside. The packer is used to control where content widgets appear inside the container into which they are packed. You can pack widgets into frames, and frames into other frames, in order to achieve the kind of layout you desire. Additionally, the arrangement is dynamically adjusted to accommodate incremental changes to the configuration, once it is packed." msgstr "" -msgid ":meth:`grid `" +msgid "Note that widgets do not appear until they have had their geometry specified with a geometry manager. It's a common early mistake to leave out the geometry specification, and then be surprised when the widget is created but nothing appears. A widget will appear only after it has had, for example, the packer's :meth:`pack` method applied to it." msgstr "" -msgid "Arranges widgets in a two-dimensional table of rows and columns. It is the most flexible manager and the one to reach for by default: layouts that would otherwise need several nested frames can often be expressed as a single grid, and rows and columns can be told how to absorb extra space." +msgid "The pack() method can be called with keyword-option/value pairs that control where the widget is to appear within its container, and how it is to behave when the main application window is resized. Here are some examples::" msgstr "" msgid "" -"ttk.Label(frm, text=\"Name:\").grid(column=0, row=0, sticky=\"w\")\n" -"ttk.Entry(frm).grid(column=1, row=0)\n" -"ttk.Button(frm, text=\"OK\").grid(column=1, row=1, sticky=\"e\")" +"fred.pack() # defaults to side = \"top\"\n" +"fred.pack(side=\"left\")\n" +"fred.pack(expand=1)" msgstr "" -msgid ":meth:`pack `" +msgid "Packer Options" msgstr "" -msgid "Stacks widgets against one side of their container -- ``\"top\"`` (the default), ``\"bottom\"``, ``\"left\"`` or ``\"right\"`` -- and can make them fill or expand into the space that is left. It is convenient for simple arrangements, such as a single row or column of widgets or a content area framed by a toolbar and a status bar." +msgid "For more extensive information on the packer and the options that it can take, see the man pages and page 183 of John Ousterhout's book." msgstr "" -msgid "" -"toolbar.pack(side=\"top\", fill=\"x\")\n" -"status.pack(side=\"bottom\", fill=\"x\")\n" -"body.pack(side=\"left\", expand=True, fill=\"both\")" +msgid "anchor" msgstr "" -msgid ":meth:`place `" +msgid "Anchor type. Denotes where the packer is to place each content in its parcel." msgstr "" -msgid "Positions each widget at an explicit spot, given either as absolute screen distances or as a fraction of the container's size. It offers the most control but the least automatic behavior, and is used the least; it suits special cases such as overlapping widgets or precise custom layouts." +msgid "expand" msgstr "" -msgid "" -"background.place(x=0, y=0, relwidth=1.0, relheight=1.0)\n" -"badge.place(relx=1.0, rely=0.0, anchor=\"ne\")" +msgid "Boolean, ``0`` or ``1``." +msgstr "" + +msgid "fill" +msgstr "" + +msgid "Legal values: ``'x'``, ``'y'``, ``'both'``, ``'none'``." +msgstr "" + +msgid "ipadx and ipady" +msgstr "" + +msgid "A distance - designating internal padding on each side of the content." msgstr "" -msgid "Layouts are built up by nesting: grid or pack widgets, including frames, inside a frame or toplevel. Toplevels are managed by the OS window manager. Classic and themed :mod:`tkinter.ttk` widgets can be managed interchangeably." +msgid "padx and pady" msgstr "" -msgid "Do not apply :meth:`!pack` and :meth:`!grid` to two widgets that share the same container. The two managers negotiate sizes in incompatible ways, and the application can hang as they repeatedly resize the container against each other. To combine them, keep each manager's widgets in a separate frame." +msgid "A distance - designating external padding on each side of the content." msgstr "" -msgid "The full set of options accepted by each manager, with their values and defaults, is documented under :meth:`Grid.grid_configure`, :meth:`Pack.pack_configure` and :meth:`Place.place_configure`; see also the :manpage:`grid(3tk)`, :manpage:`pack(3tk)` and :manpage:`place(3tk)` man pages." +msgid "side" msgstr "" -msgid "Coupling widget variables" +msgid "Legal values are: ``'left'``, ``'right'``, ``'top'``, ``'bottom'``." msgstr "" -msgid "Some widgets can tie their current value directly to a program variable, so that the two stay in sync. Options such as ``variable``, ``textvariable``, ``value``, ``onvalue`` and ``offvalue`` set up this connection: when the user changes the widget the variable is updated, and when the variable is set the widget redraws to match." +msgid "Coupling Widget Variables" msgstr "" -msgid "A widget can be linked only to a :class:`Variable` object, not to an ordinary Python variable. This is not a limitation of :mod:`!tkinter` but a consequence of how the two languages differ: the link relies on Tcl being notified every time the value changes, and Python offers no way to react when a plain variable is reassigned. A :class:`Variable` sidesteps this by keeping its value inside the Tcl interpreter and exposing it through explicit :meth:`~Variable.get` and :meth:`~Variable.set` methods." +msgid "The current-value setting of some widgets (like text entry widgets) can be connected directly to application variables by using special options. These options are ``variable``, ``textvariable``, ``onvalue``, ``offvalue``, and ``value``. This connection works both ways: if the variable changes for any reason, the widget it's connected to will be updated to reflect the new value." msgstr "" -msgid "Ready-made subclasses cover the common types: :class:`StringVar`, :class:`IntVar`, :class:`DoubleVar` and :class:`BooleanVar`. Pass one as a widget's ``textvariable`` (or ``variable``) option, then read and update it with :meth:`~Variable.get` and :meth:`~Variable.set`; the widget tracks it with no further work on your part." +msgid "Unfortunately, in the current implementation of :mod:`!tkinter` it is not possible to hand over an arbitrary Python variable to a widget through a ``variable`` or ``textvariable`` option. The only kinds of variables for which this works are variables that are subclassed from a class called Variable, defined in :mod:`!tkinter`." msgstr "" -msgid "Keep a reference to the variable for as long as the widget uses it -- for example by storing it as an attribute. A :class:`Variable` that is garbage collected removes its underlying Tcl variable, breaking the connection to the widget (see :class:`Variable`)." +msgid "There are many useful subclasses of Variable already defined: :class:`StringVar`, :class:`IntVar`, :class:`DoubleVar`, and :class:`BooleanVar`. To read the current value of such a variable, call the :meth:`get` method on it, and to change its value you call the :meth:`!set` method. If you follow this protocol, the widget will always track the value of the variable, with no further intervention on your part." msgstr "" msgid "For example::" @@ -633,66 +694,70 @@ msgstr "" msgid "" "import tkinter as tk\n" -"from tkinter import ttk\n" "\n" -"root = tk.Tk()\n" -"\n" -"# Create the application variable and give it an initial value.\n" -"contents = tk.StringVar(value=\"this is a variable\")\n" +"class App(tk.Frame):\n" +" def __init__(self, master):\n" +" super().__init__(master)\n" +" self.pack()\n" "\n" -"# Tell the entry widget to track the variable.\n" -"entry = ttk.Entry(root, textvariable=contents)\n" -"entry.pack()\n" +" self.entrythingy = tk.Entry()\n" +" self.entrythingy.pack()\n" "\n" -"# Print the current value whenever the user presses Return.\n" -"def print_contents(event):\n" -" print(\"The current entry content is:\", contents.get())\n" +" # Create the application variable.\n" +" self.contents = tk.StringVar()\n" +" # Set it to some value.\n" +" self.contents.set(\"this is a variable\")\n" +" # Tell the entry widget to watch this variable.\n" +" self.entrythingy[\"textvariable\"] = self.contents\n" "\n" -"entry.bind(\"\", print_contents)\n" +" # Define a callback for when the user hits return.\n" +" # It prints the current value of the variable.\n" +" self.entrythingy.bind('',\n" +" self.print_contents)\n" "\n" -"# Setting the variable from the program updates the entry through the\n" -"# same link.\n" -"def clear():\n" -" contents.set(\"\")\n" +" def print_contents(self, event):\n" +" print(\"Hi. The current entry content is:\",\n" +" self.contents.get())\n" "\n" -"ttk.Button(root, text=\"Clear\", command=clear).pack()\n" -"\n" -"root.mainloop()" +"root = tk.Tk()\n" +"myapp = App(root)\n" +"myapp.mainloop()" +msgstr "" + +msgid "The Window Manager" msgstr "" -msgid "The window manager" +msgid "In Tk, there is a utility command, ``wm``, for interacting with the window manager. Options to the ``wm`` command allow you to control things like titles, placement, icon bitmaps, and the like. In :mod:`!tkinter`, these commands have been implemented as methods on the :class:`Wm` class. Toplevel widgets are subclassed from the :class:`Wm` class, and so can call the :class:`Wm` methods directly." msgstr "" -msgid "The *window manager* is the part of the desktop responsible for the title bar, border and controls drawn around each top-level window, and for such things as its title, position, size and icon. Tk gives access to these through the :class:`Wm` mixin, which is inherited by the :class:`Tk` root window and by every :class:`Toplevel`. You therefore call the window-manager methods directly on a top-level window. Each has a short name and an equivalent ``wm_``-prefixed name, for example :meth:`~Wm.title` and :meth:`~Wm.wm_title`." +msgid "To get at the toplevel window that contains a given widget, you can often just refer to the widget's :attr:`master`. Of course if the widget has been packed inside of a frame, the :attr:`!master` won't represent a toplevel window. To get at the toplevel window that contains an arbitrary widget, you can call the :meth:`_root` method. This method begins with an underscore to denote the fact that this function is part of the implementation, and not an interface to Tk functionality." msgstr "" -msgid "These methods act on the top-level window whether its content is built from the classic widgets or the themed :mod:`tkinter.ttk` widgets. To reach the top-level window containing an arbitrary widget, call its :meth:`~Misc.winfo_toplevel` method." +msgid "Here are some examples of typical usage::" msgstr "" msgid "" "import tkinter as tk\n" -"from tkinter import ttk\n" "\n" -"root = tk.Tk()\n" -"root.title(\"My Application\")\n" -"root.geometry(\"640x480\")\n" -"root.minsize(320, 240)\n" +"class App(tk.Frame):\n" +" def __init__(self, master=None):\n" +" super().__init__(master)\n" +" self.pack()\n" "\n" -"ttk.Label(root, text=\"Hello\").pack(padx=20, pady=20)\n" +"# create the application\n" +"myapp = App()\n" "\n" -"root.mainloop()" -msgstr "" - -msgid "See :class:`Wm` for the full set of window-manager methods." -msgstr "" - -msgid "Tk option data types" -msgstr "" - -msgid "Many widget options documented in the reference accept values of a small number of common types, described here." +"#\n" +"# here are method calls to the window manager class\n" +"#\n" +"myapp.master.title(\"My Do-Nothing Application\")\n" +"myapp.master.maxsize(1000, 400)\n" +"\n" +"# start the program\n" +"myapp.mainloop()" msgstr "" -msgid "anchor" +msgid "Tk Option Data Types" msgstr "" msgid "Legal values are points of the compass: ``\"n\"``, ``\"ne\"``, ``\"e\"``, ``\"se\"``, ``\"s\"``, ``\"sw\"``, ``\"w\"``, ``\"nw\"``, and also ``\"center\"``." @@ -701,7 +766,7 @@ msgstr "" msgid "bitmap" msgstr "" -msgid "There are ten built-in, named bitmaps: ``'error'``, ``'gray12'``, ``'gray25'``, ``'gray50'``, ``'gray75'``, ``'hourglass'``, ``'info'``, ``'questhead'``, ``'question'``, ``'warning'``. To specify an X bitmap filename, give the full path to the file, preceded with an ``@``, as in ``\"@/usr/contrib/bitmap/gumby.bit\"``." +msgid "There are eight built-in, named bitmaps: ``'error'``, ``'gray25'``, ``'gray50'``, ``'hourglass'``, ``'info'``, ``'questhead'``, ``'question'``, ``'warning'``. To specify an X bitmap filename, give the full path to the file, preceded with an ``@``, as in ``\"@/usr/contrib/bitmap/gumby.bit\"``." msgstr "" msgid "boolean" @@ -725,13 +790,13 @@ msgstr "" msgid "color" msgstr "" -msgid "Colors can be given as the names of X colors in the rgb.txt file, or as strings representing RGB values in 4 bit: ``\"#RGB\"``, 8 bit: ``\"#RRGGBB\"``, 12 bit: ``\"#RRRGGGBBB\"``, or 16 bit: ``\"#RRRRGGGGBBBB\"`` ranges, where R,G,B here represent any legal hex digit. See the :manpage:`colors(3tk)` man page for the list of named colors." +msgid "Colors can be given as the names of X colors in the rgb.txt file, or as strings representing RGB values in 4 bit: ``\"#RGB\"``, 8 bit: ``\"#RRGGBB\"``, 12 bit: ``\"#RRRGGGBBB\"``, or 16 bit: ``\"#RRRRGGGGBBBB\"`` ranges, where R,G,B here represent any legal hex digit. See page 160 of Ousterhout's book for details." msgstr "" msgid "cursor" msgstr "" -msgid "The name of the mouse cursor to display while the pointer is over the widget. Tk provides a portable set of cursor names available on all platforms (for example ``\"arrow\"``, ``\"watch\"``, ``\"cross\"``, or ``\"hand2\"``); the standard X cursor names from :file:`cursorfont.h` may also be used, without the ``XC_`` prefix (so ``XC_hand2`` becomes ``\"hand2\"``). The full list of names, including the platform-specific ones, is given in the :manpage:`cursors(3tk)` manual page. You can also specify a bitmap and mask file of your own. On Windows a cursor file (:file:`.cur` or :file:`.ani`) may be used directly, giving its path preceded with an ``@``, as in ``\"@C:/cursors/bart.ani\"``." +msgid "The standard X cursor names from :file:`cursorfont.h` can be used, without the ``XC_`` prefix. For example to get a hand cursor (:const:`XC_hand2`), use the string ``\"hand2\"``. You can also specify a bitmap and mask file of your own. See page 179 of Ousterhout's book." msgstr "" msgid "distance" @@ -743,7 +808,7 @@ msgstr "" msgid "font" msgstr "" -msgid "Tk uses a font description such as ``{courier 10 bold}``; in :mod:`!tkinter` this is most naturally passed as a tuple of ``(family, size, *styles)`` (or as the equivalent string ``\"Courier 10 bold\"``). Font sizes with positive numbers are measured in points; sizes with negative numbers are measured in pixels." +msgid "Tk uses a list font name format, such as ``{courier 10 bold}``. Font sizes with positive numbers are measured in points; sizes with negative numbers are measured in pixels." msgstr "" msgid "geometry" @@ -767,7 +832,7 @@ msgstr "" msgid "relief" msgstr "" -msgid "Determines what the border style of a widget will be. Legal values are: ``\"raised\"``, ``\"sunken\"``, ``\"flat\"``, ``\"groove\"``, ``\"ridge\"``, and ``\"solid\"``." +msgid "Determines what the border style of a widget will be. Legal values are: ``\"raised\"``, ``\"sunken\"``, ``\"flat\"``, ``\"groove\"``, and ``\"ridge\"``." msgstr "" msgid "scrollcommand" @@ -782,7 +847,7 @@ msgstr "" msgid "Must be one of: ``\"none\"``, ``\"char\"``, or ``\"word\"``." msgstr "" -msgid "Bindings and events" +msgid "Bindings and Events" msgstr "" msgid "The bind method from the widget command allows you to watch for certain events and to have a callback function trigger when that event type occurs. The form of the bind method is::" @@ -797,7 +862,7 @@ msgstr "" msgid "sequence" msgstr "" -msgid "is a string that denotes the target kind of event. Physical events use the ```` form (for example ``\"\"`` or ``\"\"``); application-defined virtual events use double angle brackets, as in ``\"<>\"``. (See the :manpage:`bind(3tk)` man page for details.)" +msgid "is a string that denotes the target kind of event. (See the :manpage:`bind(3tk)` man page, and page 201 of John Ousterhout's book, :title-reference:`Tcl and the Tk Toolkit (2nd edition)`, for details)." msgstr "" msgid "func" @@ -921,37 +986,7 @@ msgstr "" msgid "y_root" msgstr "" -msgid "%#" -msgstr "" - -msgid "serial" -msgstr "" - -msgid "%b" -msgstr "" - -msgid "num" -msgstr "" - -msgid "%d" -msgstr "" - -msgid "detail" -msgstr "" - -msgid "%D" -msgstr "" - -msgid "delta" -msgstr "" - -msgid "The ``add`` parameter above only affects the bindings you make yourself. Every widget also inherits *class bindings* that implement its standard behavior -- for example a :class:`Text` widget binds :kbd:`Control-t` to transpose two characters. These are described in the bindings section of the widget's Tk man page (such as :manpage:`text(3tk)` or :manpage:`entry(3tk)`)." -msgstr "" - -msgid "Class bindings are processed separately from your own, so binding an event yourself does not replace the default; both run. To suppress an unwanted default binding, bind the event on the widget and return the string ``\"break\"`` from your callback." -msgstr "" - -msgid "The index parameter" +msgid "The index Parameter" msgstr "" msgid "A number of widgets require \"index\" parameters to be passed. These are used to point at a specific place in a Text widget, or to particular characters in an Entry widget, or to particular menu items in a Menu widget." @@ -960,25 +995,7 @@ msgstr "" msgid "Entry widget indexes (index, view index, etc.)" msgstr "" -msgid "Entry widgets have methods and options that refer to character positions in the text being displayed. Anytime an index is needed, you may pass in:" -msgstr "" - -msgid "an integer which refers to the numeric position of a character, counted from the beginning of the text, starting with 0;" -msgstr "" - -msgid "the string ``\"anchor\"``, which refers to the anchor point of the selection, set with the widget's selection methods;" -msgstr "" - -msgid "the string ``\"end\"``, which refers to the position just after the last character;" -msgstr "" - -msgid "the string ``\"insert\"``, which refers to the character just after the insertion cursor;" -msgstr "" - -msgid "the strings ``\"sel.first\"`` and ``\"sel.last\"``, which refer to the first character in the selection and the position just after the last (it is an error to use these if there is no selection);" -msgstr "" - -msgid "a string consisting of ``@`` followed by an integer, as in ``\"@6\"``, where the integer is interpreted as an x pixel coordinate in the entry's coordinate system, selecting the character spanning that point." +msgid "Entry widgets have options that refer to character positions in the text being displayed. You can use these :mod:`!tkinter` functions to access these special points in text widgets:" msgstr "" msgid "Text widget indexes" @@ -1002,7 +1019,7 @@ msgstr "" msgid "the string ``\"last\"`` which refers to the last menu item;" msgstr "" -msgid "a string consisting of ``@`` followed by an integer, as in ``\"@6\"``, where the integer is interpreted as a y pixel coordinate in the menu's coordinate system;" +msgid "An integer preceded by ``@``, as in ``@6``, where the integer is interpreted as a y pixel coordinate in the menu's coordinate system;" msgstr "" msgid "the string ``\"none\"``, which indicates no menu entry at all, most often used with menu.activate() to deactivate all entries, and finally," @@ -1029,2789 +1046,51 @@ msgstr "" msgid "Added the :class:`!PhotoImage` method :meth:`!copy_replace` to copy a region from one image to other image, possibly with pixel zooming and/or subsampling. Add *from_coords* parameter to :class:`!PhotoImage` methods :meth:`!copy`, :meth:`!zoom` and :meth:`!subsample`. Add *zoom* and *subsample* parameters to :class:`!PhotoImage` method :meth:`!copy`." msgstr "" -msgid "The image object can then be used wherever an ``image`` option is supported by some widget (for example, labels, buttons, menus). In these cases, Tk will not keep a reference to the image. When the last Python reference to the image object is deleted, the image data is deleted as well, and Tk will display an empty box wherever the image was used." +msgid "The image object can then be used wherever an ``image`` option is supported by some widget (e.g. labels, buttons, menus). In these cases, Tk will not keep a reference to the image. When the last Python reference to the image object is deleted, the image data is deleted as well, and Tk will display an empty box wherever the image was used." msgstr "" msgid "The `Pillow `_ package adds support for formats such as BMP, JPEG, TIFF, and WebP, among others." msgstr "" -msgid "Reference" -msgstr "" - -msgid "This section documents the classes, methods, functions and constants of the :mod:`!tkinter` module. Most of them wrap Tcl/Tk commands; consult the official Tcl/Tk manual pages for the full list of widget options and further details." -msgstr "" - -msgid "The exception raised when a call into the Tcl interpreter fails, for example when a widget is given an unknown option or an invalid value." -msgstr "" - -msgid "Base and mixin classes" -msgstr "" - -msgid "The :class:`!Misc` class is a mix-in inherited by :class:`Tk` and, through :class:`BaseWidget`, by every widget. It provides the large set of methods common to all Tk objects: querying window information, managing event bindings and the event loop, controlling the keyboard focus and pointer grabs, accessing the selection, clipboard and option database, and assorted utility and introspection services. Because they are inherited, these methods are available on every widget and on the :class:`Tk` application object, and are documented here once rather than repeated for each widget." -msgstr "" - -msgid "Return the current value of the configuration option named *key* for this widget, as a string. The expression ``widget[key]`` is equivalent and may be used instead." -msgstr "" - -msgid "Query or modify the configuration options of the widget. With no arguments, return a dictionary mapping every available option name to a tuple describing it (its name, X resource name, X resource class, default value and current value). If a single option name is given as a string, return the tuple for just that option. If one or more keyword arguments are given, or a dictionary is passed as *cnf*, set each named option to the corresponding value; the expression ``widget[key] = value`` sets a single option in the same way." -msgstr "" - -msgid ":meth:`config` is an alias of :meth:`!configure`." -msgstr "" - -msgid "Return a list of the names of all configuration options of this widget." -msgstr "" - -msgid "Interpret the string *s* as a Tcl boolean and return the corresponding :class:`bool`. Tcl accepts values such as ``'1'``, ``'0'``, ``'yes'``, ``'no'``, ``'true'`` and ``'false'``. Raise :exc:`ValueError` if *s* is not a valid boolean." -msgstr "" - -msgid "Interpret the string *s* as a Tcl floating-point number and return it as a :class:`float`. Raise :exc:`ValueError` if *s* is not a valid number." -msgstr "" - -msgid "Interpret the string *s* as a Tcl integer and return it as an :class:`int`. Raise :exc:`ValueError` if *s* is not a valid integer." -msgstr "" - -msgid "Return the value of the Tcl global variable named *name*." -msgstr "" - -msgid "Set the Tcl global variable named *name* to *value*." -msgstr "" - -msgid "The :meth:`!getvar` and :meth:`!setvar` methods give direct access to Tcl variables. In most code you will instead use a :class:`Variable` subclass such as :class:`StringVar` or :class:`IntVar`, which wraps a Tcl variable and converts its value to and from a Python type." -msgstr "" - -msgid "Register the Python callable *func* as a Tcl command and return the name of the new command as a string. Whenever Tcl invokes that command, *func* is called; if *subst* is given, it is applied to the command's arguments first. This is the mechanism used internally to turn Python callbacks into the command names passed to Tk options such as *command*. Unless *needcleanup* is false, the command is deleted automatically when the widget is destroyed." -msgstr "" - -msgid "The arguments passed to *func* are no longer converted to strings." -msgstr "" - -msgid "Delete the Tcl command named *name*, such as one previously returned by :meth:`register`." -msgstr "" - -msgid "Return the widget instance corresponding to the Tk pathname *name*." -msgstr "" - -msgid "Send the Tcl command *cmd*, with the given *args*, to the Tcl interpreter registered under the name *interp*, and return its result. This is not available on all platforms." -msgstr "" - -msgid "Destroy this widget and all of its descendant widgets, and delete the Tcl commands associated with them." -msgstr "" - -msgid "Raise this widget in the stacking order so that it is drawn on top of its siblings. If *aboveThis* is given, the widget is moved to be just above it in the stacking order instead." -msgstr "" - -msgid ":meth:`lift` is an alias of :meth:`!tkraise`." -msgstr "" - -msgid "Lower this widget in the stacking order so that it is drawn beneath its siblings. If *belowThis* is given, the widget is moved to be just below it in the stacking order instead." -msgstr "" - -msgid ":meth:`tkraise`/:meth:`lift` and :meth:`lower` are overridden by the :class:`Canvas` widget, where they restack canvas items instead." -msgstr "" - -msgid "Return the names of all images that currently exist in the Tcl interpreter." -msgstr "" - -msgid "This is overridden by the :class:`Text` widget, where :meth:`!image_names` returns the names of its embedded images instead." -msgstr "" - -msgid "Return the available image types, such as ``'photo'`` and ``'bitmap'``." -msgstr "" - -msgid "Set the anchor that controls where the grid is placed inside this container when the container is larger than the grid and no row or column has a non-zero weight. *anchor* is one of the usual anchor strings, such as ``'nw'`` (the default) or ``'center'``. Called with no argument, this method has no effect." -msgstr "" - -msgid ":meth:`anchor` is an alias of :meth:`!grid_anchor`." -msgstr "" - -msgid "Return the bounding box, in pixels, of a region of the grid laid out in this container, as a 4-tuple ``(xoffset, yoffset, width, height)``. With no arguments the bounding box of the whole grid is returned. If *column* and *row* are given, the box spans from the cell at row and column 0 to that cell; if *col2* and *row2* are also given, it spans from the cell (*column*, *row*) to the cell (*col2*, *row2*)." -msgstr "" - -msgid ":meth:`bbox` is an alias of :meth:`!grid_bbox`, except on :class:`Canvas`, :class:`Listbox`, :class:`Spinbox`, :class:`Text`, :class:`ttk.Entry ` and :class:`ttk.Treeview `, which provide their own :meth:`!bbox` method." -msgstr "" - -msgid "Query or set the properties of the column (or columns) *index* of the grid managed by this container. *index* may be a column number; when setting options it may also be a list of column numbers, the string ``'all'`` to affect every column, or a child widget whose occupied columns are affected. The supported options are:" -msgstr "" - -msgid "*minsize*" -msgstr "" - -msgid "The column's minimum size, in pixels." -msgstr "" - -msgid "*weight*" -msgstr "" - -msgid "An integer setting how much of any extra space is apportioned to the column. A weight of ``0`` keeps the column at its requested size, and a column of weight two grows twice as fast as a column of weight one." -msgstr "" - -msgid "*uniform*" -msgstr "" - -msgid "The name of a uniform group. Columns sharing a non-empty group name are kept in sizes that are strictly proportional to their weights." -msgstr "" - -msgid "*pad*" -msgstr "" - -msgid "Extra space, in pixels, added to the largest widget in the column when computing the column's size." -msgstr "" - -msgid "With a single option name, return that option's value; with no options, return a dictionary of all of them." -msgstr "" - -msgid ":meth:`columnconfigure` is an alias of :meth:`!grid_columnconfigure`." -msgstr "" - -msgid "Query or set the properties of the row (or rows) *index* of the grid managed by this container. *index* is interpreted as for :meth:`grid_columnconfigure`, and the supported options (*minsize*, *weight*, *uniform* and *pad*) are the same, applied to a row instead of a column." -msgstr "" - -msgid ":meth:`rowconfigure` is an alias of :meth:`!grid_rowconfigure`." -msgstr "" - -msgid "Return the ``(column, row)`` of the grid cell that contains the pixel at position (*x*, *y*), given in pixels relative to this container. For locations above or to the left of the grid, ``-1`` is returned for the corresponding coordinate." -msgstr "" - -msgid "Enable or disable geometry propagation for this container when it manages its children with the grid geometry manager. When *flag* is true, the container resizes itself to fit the requested sizes of its children; when it is false, its size is left under your control. Called with no argument, return the current setting as a boolean." -msgstr "" - -msgid "Return the size of the grid managed by this container as a ``(columns, rows)`` tuple." -msgstr "" - -msgid ":meth:`size` is an alias of :meth:`!grid_size`, except on the :class:`Listbox` widget, which provides its own :meth:`!size` method." -msgstr "" - -msgid "Return a list of the child widgets managed in this container's grid, most recently managed first. If *row* or *column* is given, only the children in that row or column are returned." -msgstr "" - -msgid "Enable or disable geometry propagation for this container when it manages its children with the pack geometry manager. When *flag* is true, the container resizes itself to fit the requested sizes of its children; when it is false, its size is left under your control. Called with no argument, return the current setting as a boolean." -msgstr "" - -msgid ":meth:`propagate` is an alias of :meth:`!pack_propagate`." -msgstr "" - -msgid "Return a list of the child widgets managed by this container with the pack geometry manager, in packing order." -msgstr "" - -msgid ":meth:`slaves` is an alias of :meth:`!pack_slaves`." -msgstr "" - -msgid "Return a list of the child widgets managed by this container with the place geometry manager." -msgstr "" - -msgid "Bind the event pattern *sequence* on this widget to the callable *func*." -msgstr "" - -msgid "*sequence* is an event pattern, such as ``''`` (a mouse click) or ``''``, optionally a concatenation of several such patterns that must occur shortly after one another. When the event occurs, *func* is called with an :class:`Event` instance describing it as its only argument; if *func* returns the string ``'break'``, no further bindings for the event are invoked." -msgstr "" - -msgid "If *add* is true, *func* is added to any functions already bound to *sequence*; otherwise it replaces them. The binding applies only to this widget." -msgstr "" - -msgid ":meth:`!bind` returns a string identifier (a *funcid*) that can later be passed to :meth:`unbind` to remove the binding without leaking the associated Tcl command." -msgstr "" - -msgid "If *func* is omitted, return the binding currently associated with *sequence*; if *sequence* is also omitted, return a list of all the sequences for which bindings exist on this widget." +msgid "File Handlers" msgstr "" -msgid "Like :meth:`bind`, but bind *func* to the binding tag *className* rather than to a single widget, so that the binding applies to every widget having that tag. *className* is usually the name of a widget class, such as ``'Button'``, in which case the binding affects all widgets of that class. The set of binding tags for a widget can be inspected and changed with :meth:`bindtags`." +msgid "Tk allows you to register and unregister a callback function which will be called from the Tk mainloop when I/O is possible on a file descriptor. Only one handler may be registered per file descriptor. Example code::" msgstr "" -msgid "The remaining arguments and the return value are as for :meth:`bind`." +msgid "" +"import tkinter\n" +"widget = tkinter.Tk()\n" +"mask = tkinter.READABLE | tkinter.WRITABLE\n" +"widget.tk.createfilehandler(file, mask, callback)\n" +"...\n" +"widget.tk.deletefilehandler(file)" msgstr "" -msgid "Like :meth:`bind`, but bind *func* to the special binding tag ``'all'``, so that the binding applies to every widget in the application." +msgid "This feature is not available on Windows." msgstr "" -msgid "Remove bindings for the event pattern *sequence* on this widget." +msgid "Since you don't know how many bytes are available for reading, you may not want to use the :class:`~io.BufferedIOBase` or :class:`~io.TextIOBase` :meth:`~io.BufferedIOBase.read` or :meth:`~io.IOBase.readline` methods, since these will insist on reading a predefined number of bytes. For sockets, the :meth:`~socket.socket.recv` or :meth:`~socket.socket.recvfrom` methods will work fine; for other files, use raw reads or ``os.read(file.fileno(), maxbytecount)``." msgstr "" -msgid "If *funcid* is given, only the function identified by it (a value returned from a previous call to :meth:`bind`) is removed, and its associated Tcl command is deleted. Otherwise all bindings for *sequence* are destroyed, leaving it unbound." +msgid "Registers the file handler callback function *func*. The *file* argument may either be an object with a :meth:`~io.IOBase.fileno` method (such as a file or socket object), or an integer file descriptor. The *mask* argument is an ORed combination of any of the three constants below. The callback is called as follows::" msgstr "" -msgid "If *funcid* is given, only that callback is unbound; other callbacks bound to *sequence* are kept." +msgid "callback(file, mask)" msgstr "" -msgid "Remove all bindings for the event pattern *sequence* from the binding tag *className*. See :meth:`bind_class`." +msgid "Unregisters a file handler." msgstr "" -msgid "Remove all bindings for the event pattern *sequence* from the special binding tag ``'all'``. See :meth:`bind_all`." +msgid "Constants used in the *mask* arguments." msgstr "" -msgid "If *tagList* is omitted, return a tuple of the binding tags associated with this widget. When an event occurs in a widget, it is applied to each of the widget's binding tags in order, and for each tag the most specific matching binding is executed. By default a widget has four binding tags: its own pathname, its widget class, the pathname of its nearest toplevel ancestor, and ``'all'``, in that order." -msgstr "" - -msgid "If *tagList* is given, it must be a sequence of strings; the widget's binding tags are set to its elements, which determines the order in which bindings are evaluated." -msgstr "" - -msgid "The methods with the ``event_`` prefix define virtual events and generate events programmatically." -msgstr "" - -msgid "Associate the virtual event *virtual*, whose name has the form ``'<>'``, with each of the physical event patterns given by *sequences*, so that the virtual event triggers whenever any of them occurs. If *virtual* is already defined, the new sequences are added to its existing ones." -msgstr "" - -msgid "Remove each of *sequences* from those associated with the virtual event *virtual*. Sequences that are not currently associated with *virtual* are ignored. If no *sequences* are given, all physical event sequences are removed, so that *virtual* no longer triggers." -msgstr "" - -msgid "Generate the event *sequence* on this widget and arrange for it to be processed just as if it had come from the window system. *sequence* must be a single event pattern, such as ``''`` or ``'<>'``, not a concatenation of several. Keyword arguments specify additional fields of the event, for example *x* and *y* for the pointer position, or *when* to control when the event is processed; refer to the Tk ``event`` manual page for the full list." -msgstr "" - -msgid "If *virtual* is omitted, return a tuple of all the virtual events that are currently defined. If *virtual* is given, return a tuple of the physical event sequences currently associated with it, or an empty tuple if it is not defined." -msgstr "" - -msgid "The methods with the ``after`` prefix schedule callbacks to run after a delay or when the application is idle." -msgstr "" - -msgid "Schedule the callable *func* to be called after *ms* milliseconds, with *args* and *kw* passed to it as positional and keyword arguments. Return an identifier that can be passed to :meth:`after_cancel` to cancel the call." -msgstr "" - -msgid "If *func* is omitted, sleep for *ms* milliseconds instead, processing no events during that time, and return ``None``." -msgstr "" - -msgid "*func* can now be any callable object, not only a function." -msgstr "" - -msgid "Keyword arguments are now passed to *func*." -msgstr "" - -msgid "Cancel a callback previously scheduled with :meth:`after` or :meth:`after_idle`. *id* must be an identifier returned by one of those methods; passing a value that is not such an identifier raises :exc:`ValueError`. If the callback has already run or been cancelled, this has no effect." -msgstr "" - -msgid "Passing ``None`` (or any false value) as *id* now raises :exc:`ValueError`." -msgstr "" - -msgid "Schedule the callable *func* to be called, with *args* and *kw* passed to it, when the Tk main loop next becomes idle, that is, when it has no other events to process. Return an identifier that can be passed to :meth:`after_cancel` to cancel the call." -msgstr "" - -msgid "If *id* is omitted, return a tuple of the identifiers of all callbacks currently scheduled with :meth:`after` and :meth:`after_idle` for this interpreter." -msgstr "" - -msgid "If *id* is given, it must identify a callback that has not yet run or been cancelled, and the return value is a tuple ``(script, type)``, where *script* refers to the function to be called and *type* is either ``'idle'`` or ``'timer'``. A :exc:`TclError` is raised if *id* does not exist." -msgstr "" - -msgid "Enter the Tk event loop, which processes events until all windows are destroyed. This is normally called once, on the root window, to run the application." -msgstr "" - -msgid "Quit the Tcl interpreter, causing :meth:`mainloop` to return." -msgstr "" - -msgid "Enter the event loop until all pending events, including idle callbacks, have been processed. This brings the display up to date and handles any events that are already queued, then returns." -msgstr "" - -msgid "Enter the event loop until all pending idle callbacks have been called. This updates the display of windows, for example after geometry changes, but does not process events caused by the user." -msgstr "" - -msgid "Wait until the Tcl variable *name* is modified, continuing to process events in the meantime so that the application stays responsive. *name* is usually a :class:`Variable` instance, such as an :class:`IntVar` or :class:`StringVar`." -msgstr "" - -msgid ":meth:`waitvar` is an alias of :meth:`!wait_variable`." -msgstr "" - -msgid "Wait until *window* is destroyed, continuing to process events in the meantime. If *window* is omitted, this widget is used. This is typically used to wait for the user to finish interacting with a dialog box." -msgstr "" - -msgid "Wait until the visibility state of *window* changes, for example when it first appears on the screen, continuing to process events in the meantime. If *window* is omitted, this widget is used. This is typically used to wait for a newly created window to become visible before acting on it." -msgstr "" - -msgid "The methods with the ``focus_`` prefix manage the keyboard focus." -msgstr "" - -msgid "Direct the keyboard input focus for this widget's display to this widget. If the application does not currently have the input focus on this widget's display, the widget is remembered as the focus window for its top level, and the focus will be redirected to it the next time the window manager gives the focus to the top level. :meth:`focus` is an alias of :meth:`!focus_set`, except on the :class:`Canvas` and :class:`ttk.Treeview ` widgets, which provide their own :meth:`!focus` method." -msgstr "" - -msgid "Direct the keyboard input focus to this widget even if the application does not currently have the input focus for the widget's display. This method should be used sparingly, if at all; normally an application should wait for the window manager to give it the focus rather than claiming it." -msgstr "" - -msgid "Return the widget that currently has the keyboard focus in the application, or ``None`` if no widget in the application has the focus. Use :meth:`focus_displayof` to work correctly with several displays." -msgstr "" - -msgid "Return the widget that currently has the keyboard focus on the display where this widget is located, or ``None`` if no widget in the application has the focus on that display." -msgstr "" - -msgid "Return the most recent widget to have had the keyboard focus among all the widgets in the same top level as this widget; this is the widget that will receive the focus the next time the window manager gives the focus to the top level. If no widget in that top level has ever had the focus, or if the most recent focus widget has been deleted, the top level itself is returned." -msgstr "" - -msgid "Reconfigure Tk to use an implicit focus model in which the focus is set to a widget whenever the mouse pointer enters it. This cannot easily be disabled once enabled." -msgstr "" - -msgid "Return the next widget after this one in the keyboard traversal order, or ``None`` if there is none. The traversal order goes first to the next child, then recursively to the children of that child, and then to the next sibling higher in the stacking order. A widget is skipped if its ``takefocus`` option is set to ``0``. This method is used in the default bindings for the :kbd:`Tab` key." -msgstr "" - -msgid "Return the previous widget before this one in the keyboard traversal order, or ``None`` if there is none. See :meth:`tk_focusNext` for how the order is defined. This method is used in the default bindings for the :kbd:`Shift-Tab` key." -msgstr "" - -msgid "The methods with the ``grab_`` prefix set and query the input grab, which directs all input events to a single widget." -msgstr "" - -msgid "Set a local grab on this widget. A grab confines pointer events to this widget and its descendants: while the pointer is outside the widget's subtree, button presses and releases and pointer motion are reported to the grab widget, and windows outside the subtree become insensitive until the grab is released. A local grab affects only the grabbing application. Any grab previously set by this application on the widget's display is automatically released. Setting a grab is the usual way to make a dialog modal: while the grab is in effect the user cannot interact with the other windows of the application." -msgstr "" - -msgid "Set a global grab on this widget. A global grab is like the local grab set by :meth:`grab_set`, but it locks out all other applications on the screen, so that only this widget's subtree is sensitive to pointer events, and it also grabs the keyboard. Use with caution: it is easy to render a display unusable with a global grab, since other applications stop receiving events until it is released." -msgstr "" - -msgid "Release the grab on this widget if there is one; otherwise do nothing." -msgstr "" - -msgid "Return the widget that currently holds the grab in this application for this widget's display, or ``None`` if there is no such widget." -msgstr "" - -msgid "Return ``None`` if no grab is currently set on this widget, ``\"local\"`` if a local grab is set, or ``\"global\"`` if a global grab is set." -msgstr "" - -msgid "The methods with the ``selection_`` prefix retrieve and manage the X selection." -msgstr "" - -msgid "Clear the X selection, so that no window owns it anymore. The selection to clear is given by the keyword argument *selection*, an atom name such as ``'PRIMARY'`` or ``'CLIPBOARD'``; it defaults to ``PRIMARY``. The *displayof* keyword argument names a widget that determines the display on which to operate, and defaults to this widget." -msgstr "" - -msgid "This is overridden by the :class:`Entry`, :class:`Listbox` and :class:`Spinbox` widgets, where :meth:`!selection_clear` clears the widget's own selection instead." -msgstr "" - -msgid "Return the contents of the current X selection. The keyword argument *selection* names the selection and defaults to ``PRIMARY``. The keyword argument *type* specifies the form in which the data is to be returned (the desired conversion target), an atom name such as ``'STRING'`` or ``'FILE_NAME'``; it defaults to ``STRING``, except on X11, where ``UTF8_STRING`` is tried first and ``STRING`` is used as a fallback. The *displayof* keyword argument names a widget that determines the display from which to retrieve the selection, and defaults to this widget." -msgstr "" - -msgid "Register *command* as a handler to supply the X selection owned by this widget when another application requests it. When the selection is retrieved, *command* is called with two arguments, the starting character offset and the maximum number of characters to return, and must return at most that many characters of the selection starting at that offset; for very long selections it is called repeatedly with increasing offsets. The keyword argument *selection* names the selection (default ``PRIMARY``) and the keyword argument *type* gives the form of the selection that the handler supplies (such as ``'STRING'`` or ``'FILE_NAME'``, default ``STRING``)." -msgstr "" - -msgid "Make this widget the owner of the X selection on its display. The previous owner, if any, is notified that it has lost the selection. The keyword argument *selection* names the selection and defaults to ``PRIMARY``." -msgstr "" - -msgid "Return the widget in this application that owns the X selection on the display containing this widget, or ``None`` if no widget in this application owns the selection. The keyword argument *selection* names the selection and defaults to ``PRIMARY``. The *displayof* keyword argument names a widget that determines the display to query, and defaults to this widget." -msgstr "" - -msgid "The methods with the ``clipboard_`` prefix manage the clipboard." -msgstr "" - -msgid "Append *string* to the Tk clipboard and claim ownership of the clipboard on this widget's display. Before appending, the clipboard should be emptied with :meth:`clipboard_clear`; all appends should be completed before returning to the event loop so that the clipboard is updated atomically. The keyword argument *type* specifies the form of the data, an atom name such as ``'STRING'`` or ``'FILE_NAME'`` (default ``STRING``), and the keyword argument *format* specifies the representation used to transmit it (default ``STRING``). The *displayof* keyword argument names a widget that determines the target display, and defaults to this widget. The contents can be retrieved with :meth:`clipboard_get` or :meth:`selection_get`." -msgstr "" - -msgid "Claim ownership of the clipboard on this widget's display and remove any previous contents. The *displayof* keyword argument names a widget that determines the target display, and defaults to this widget." -msgstr "" - -msgid "Retrieve data from the clipboard on this widget's display. The keyword argument *type* specifies the form in which the data is to be returned, an atom name such as ``'STRING'`` or ``'FILE_NAME'``; it defaults to ``STRING``, except on X11, where ``UTF8_STRING`` is tried first and ``STRING`` is used as a fallback. The *displayof* keyword argument names a widget that determines the display, and defaults to the root window of the application. This is equivalent to ``selection_get(selection='CLIPBOARD')``." -msgstr "" - -msgid "The methods with the ``option_`` prefix query and modify the Tk option database." -msgstr "" - -msgid "Add an option to the Tk option database that associates *value* with *pattern*. *pattern* consists of names and/or classes separated by asterisks or dots, in the usual X format. *priority* is an integer between 0 and 100, or one of the symbolic names ``'widgetDefault'`` (20), ``'startupFile'`` (40), ``'userDefault'`` (60), or ``'interactive'`` (80); it defaults to ``interactive``." -msgstr "" - -msgid "Clear the Tk option database. Default options from the :envvar:`!RESOURCE_MANAGER` property or the :file:`.Xdefaults` file are reloaded automatically the next time an option is added to or removed from the database." -msgstr "" - -msgid "Return the value of the option matching this widget under *name* and *className* from the Tk option database, or an empty string if there is no matching entry. When several entries match, the one with the highest priority is returned, and among entries of equal priority the most recently added one." -msgstr "" - -msgid "Read the file named *fileName*, which should have the standard format for an X resource database such as :file:`.Xdefaults`, and add all the options it specifies to the Tk option database. *priority* is interpreted as for :meth:`option_add` and defaults to ``interactive``." -msgstr "" - -msgid "Ring the bell on the display for this widget, using the display's current bell-related settings, and reset the screen saver for the screen. If *displayof* is given as a widget, the bell is rung on that widget's display instead." -msgstr "" - -msgid "Set a new color scheme for all Tk widget elements. Existing widgets are updated and the option database is changed so that future widgets use the new colors. A single color argument is taken as the normal background color, from which a complete palette is computed. Alternatively, the arguments may be given as keyword *name*/*value* pairs naming individual options in the option database. The recognized option names are ``activeBackground``, ``activeForeground``, ``background``, ``disabledForeground``, ``foreground``, ``highlightBackground``, ``highlightColor``, ``insertBackground``, ``selectColor``, ``selectBackground``, ``selectForeground``, and ``troughColor``; reasonable defaults are computed for any that are not specified." -msgstr "" - -msgid "Restore the application's colors to the light brown (bisque) color scheme used in Tk 3.6 and earlier versions. Provided for backward compatibility." -msgstr "" - -msgid "Query or set whether Tk's look and feel should strictly adhere to Motif. A true *boolean* value enables strict Motif compliance (for example, no color change when the mouse passes over a slider). Return the resulting setting." -msgstr "" - -msgid "The methods with the ``busy_`` prefix manage the busy state of a window, which shows a busy cursor and ignores user input." -msgstr "" - -msgid "Make this widget appear busy. A transparent window is placed in front of the widget, so that it and all of its descendants in the widget hierarchy are blocked from pointer events and display a busy cursor. Normally :meth:`update` should be called immediately afterwards to ensure that the hold operation is in effect before the application starts its processing." -msgstr "" - -msgid "The only supported configuration option is *cursor*, the cursor to be displayed while the widget is busy; it may have any of the values accepted by :meth:`!configure`." -msgstr "" - -msgid ":meth:`busy_hold`, :meth:`busy` and :meth:`tk_busy` are aliases of :meth:`!tk_busy_hold`." -msgstr "" - -msgid "Query or modify the configuration options of the busy window. The widget must have been previously made busy by :meth:`tk_busy_hold`. With no arguments, return a dictionary describing all of the available options; if *cnf* is the name of an option, return a tuple describing that one option. Otherwise set the given options to the given values. Options may have any of the values accepted by :meth:`tk_busy_hold`." -msgstr "" - -msgid "The option database is referenced through the widget name or class. For example, if a :class:`Frame` widget named ``frame`` is to be made busy, the busy cursor can be specified for it by either of the calls::" -msgstr "" - -msgid "" -"w.option_add('*frame.busyCursor', 'gumby')\n" -"w.option_add('*Frame.BusyCursor', 'gumby')" -msgstr "" - -msgid ":meth:`busy_configure`, :meth:`busy_config` and :meth:`tk_busy_config` are aliases of :meth:`!tk_busy_configure`." -msgstr "" - -msgid "Return the current value of the busy configuration *option*. The widget must have been previously made busy by :meth:`tk_busy_hold`, and *option* may have any of the values accepted by that method." -msgstr "" - -msgid ":meth:`busy_cget` is an alias of :meth:`!tk_busy_cget`." -msgstr "" - -msgid "Make this widget no longer busy, releasing the resources (including the transparent window) allocated when it was made busy. User events will again be received by the widget. These resources are also released when the widget is destroyed." -msgstr "" - -msgid ":meth:`busy_forget` is an alias of :meth:`!tk_busy_forget`." -msgstr "" - -msgid "Return ``True`` if the widget is currently busy, ``False`` otherwise." -msgstr "" - -msgid ":meth:`busy_status` is an alias of :meth:`!tk_busy_status`." -msgstr "" - -msgid "Return a list of widgets that are currently busy. If *pattern* is given, only busy widgets whose path names match the pattern are returned." -msgstr "" - -msgid ":meth:`busy_current` is an alias of :meth:`!tk_busy_current`." -msgstr "" - -msgid "The methods with the ``winfo_`` prefix retrieve information about windows managed by Tk." -msgstr "" - -msgid "Return the integer identifier for the atom whose name is *name*, creating a new atom if none exists. If *displayof* is given, the atom is looked up on the display of that window; otherwise it is looked up on the display of the application's main window." -msgstr "" - -msgid "Return the textual name for the atom whose integer identifier is *id*. This is the inverse of :meth:`winfo_atom`. If *displayof* is given, the identifier is looked up on the display of that window; otherwise it is looked up on the display of the application's main window." -msgstr "" - -msgid "Return the number of cells in the colormap for the widget." -msgstr "" - -msgid "Return a list containing the widgets that are children of the widget, in stacking order from lowest to highest. Toplevel windows are returned as children of their logical parents." -msgstr "" - -msgid "Return the class name of the widget." -msgstr "" - -msgid "Return ``True`` if the colormap for the widget is known to be full, ``False`` otherwise." -msgstr "" - -msgid "Return the widget containing the point given by *rootX* and *rootY*, or ``None`` if no window in this application contains the point. The coordinates are in screen units in the coordinate system of the root window. If *displayof* is given, the coordinates refer to the screen containing that window; otherwise they refer to the screen of the application's main window." -msgstr "" - -msgid "Return the depth of the widget, that is, the number of bits per pixel." -msgstr "" - -msgid "Return true if the widget exists, false otherwise." -msgstr "" - -msgid "Return a floating-point value giving the number of pixels in the widget corresponding to the screen distance *number* (for example, ``\"2.0c\"`` or ``\"1i\"``). The result may be fractional; for a rounded integer value use :meth:`winfo_pixels`." -msgstr "" - -msgid "Return the geometry of the widget, in the form ``widthxheight+x+y``. All dimensions are in pixels. An offset can be negative; see :meth:`~Wm.geometry`." -msgstr "" - -msgid "Return the height of the widget in pixels. When a window is first created its height is 1 pixel; it is eventually changed by a geometry manager. See also :meth:`winfo_reqheight`." -msgstr "" - -msgid "Return a low-level platform-specific identifier for the widget. On Unix this is the X window identifier, and on Windows it is the window handle." -msgstr "" - -msgid "Return a tuple of the names of all Tcl interpreters currently registered for a particular display. If *displayof* is given, the return value refers to the display of that window; otherwise it refers to the display of the application's main window." -msgstr "" - -msgid "Return true if the widget is currently mapped, false otherwise." -msgstr "" - -msgid "Return the name of the geometry manager currently responsible for the widget, or an empty string if it is not managed by any geometry manager." -msgstr "" - -msgid "Return the widget's name within its parent, as opposed to its full path name." -msgstr "" - -msgid "Return the path name of the widget's parent, or an empty string if the widget is the main window of the application." -msgstr "" - -msgid "Return the path name of the window whose identifier is *id*. If *displayof* is given, the identifier is looked up on the display of that window; otherwise it is looked up on the display of the application's main window." -msgstr "" - -msgid "Return the number of pixels in the widget corresponding to the screen distance *number* (for example, ``\"2.0c\"`` or ``\"1i\"``). The result is rounded to the nearest integer; for a fractional result use :meth:`winfo_fpixels`." -msgstr "" - -msgid "Return the pointer's *x* coordinate, in pixels, relative to the screen's root window (or virtual root, if one is in use). Return ``-1`` if the pointer is not on the same screen as the widget." -msgstr "" - -msgid "Return the pointer's coordinates as an ``(x, y)`` tuple, in pixels, relative to the screen's root window (or virtual root, if one is in use). Both coordinates are ``-1`` if the pointer is not on the same screen as the widget." -msgstr "" - -msgid "Return the pointer's *y* coordinate, in pixels, relative to the screen's root window (or virtual root, if one is in use). Return ``-1`` if the pointer is not on the same screen as the widget." -msgstr "" - -msgid "Return the widget's requested height in pixels. This is the value used by the widget's geometry manager to compute its geometry." -msgstr "" - -msgid "Return the widget's requested width in pixels. This is the value used by the widget's geometry manager to compute its geometry." -msgstr "" - -msgid "Return an ``(r, g, b)`` tuple of the red, green, and blue intensities, in the range 0 to 65535, that correspond to *color* in the widget. *color* may be specified in any of the forms acceptable for a color option." -msgstr "" - -msgid "Return the *x* coordinate, in the root window of the screen, of the upper-left corner of the widget's border (or of the widget itself if it has no border)." -msgstr "" - -msgid "Return the *y* coordinate, in the root window of the screen, of the upper-left corner of the widget's border (or of the widget itself if it has no border)." -msgstr "" - -msgid "Return the name of the screen associated with the widget, in the form ``displayName.screenIndex``." -msgstr "" - -msgid "Return the number of cells in the default colormap for the widget's screen." -msgstr "" - -msgid "Return the depth of the root window of the widget's screen, that is, the number of bits per pixel." -msgstr "" - -msgid "Return the height of the widget's screen in pixels." -msgstr "" - -msgid "Return the height of the widget's screen in millimeters." -msgstr "" - -msgid "Return the width of the widget's screen in millimeters." -msgstr "" - -msgid "Return the default visual class for the widget's screen, one of ``\"directcolor\"``, ``\"grayscale\"``, ``\"pseudocolor\"``, ``\"staticcolor\"``, ``\"staticgray\"``, or ``\"truecolor\"``." -msgstr "" - -msgid "Return the width of the widget's screen in pixels." -msgstr "" - -msgid "Return a string containing information about the server for the widget's display. The exact format of this string may vary from platform to platform." -msgstr "" - -msgid "Return the top-of-hierarchy window containing the widget. In standard Tk this is always a :class:`Toplevel` widget." -msgstr "" - -msgid "Return true if the widget and all of its ancestors up through the nearest toplevel window are mapped, false otherwise." -msgstr "" - -msgid "Return the visual class for the widget, one of ``\"directcolor\"``, ``\"grayscale\"``, ``\"pseudocolor\"``, ``\"staticcolor\"``, ``\"staticgray\"``, or ``\"truecolor\"``." -msgstr "" - -msgid "Return the X identifier for the visual for the widget." -msgstr "" - -msgid "Return a list describing the visuals available for the widget's screen. Each item consists of a visual class (see :meth:`winfo_visual`) followed by an integer depth. If *includeids* is true, the X identifier for the visual is also included." -msgstr "" - -msgid "Return the height of the virtual root window associated with the widget if there is one; otherwise return the height of the widget's screen." -msgstr "" - -msgid "Return the width of the virtual root window associated with the widget if there is one; otherwise return the width of the widget's screen." -msgstr "" - -msgid "Return the *x* offset of the virtual root window associated with the widget, relative to the root window of its screen. This is normally zero or negative, and is ``0`` if there is no virtual root window." -msgstr "" - -msgid "Return the *y* offset of the virtual root window associated with the widget, relative to the root window of its screen. This is normally zero or negative, and is ``0`` if there is no virtual root window." -msgstr "" - -msgid "Return the width of the widget in pixels. When a window is first created its width is 1 pixel; it is eventually changed by a geometry manager. See also :meth:`winfo_reqwidth`." -msgstr "" - -msgid "Return the *x* coordinate, in the widget's parent, of the upper-left corner of the widget's border (or of the widget itself if it has no border)." -msgstr "" - -msgid "Return the *y* coordinate, in the widget's parent, of the upper-left corner of the widget's border (or of the widget itself if it has no border)." -msgstr "" - -msgid "Return the Tcl/Tk patch level as a named tuple with the same five fields as :data:`sys.version_info`: *major*, *minor*, *micro*, *releaselevel* and *serial*. *releaselevel* is ``'alpha'``, ``'beta'`` or ``'final'``. Converting it to a string gives the version in the usual Tcl/Tk notation, for example ``'9.0.3'`` for a final release or ``'9.1b2'`` for a pre-release." -msgstr "" - -msgid "The :class:`!Wm` mixin provides access to the window manager, allowing an application to control such things as the title, geometry and icon of a top-level window, the way it is resized, and how it responds to window manager protocols. It is mixed into :class:`Tk` and :class:`Toplevel`, so its methods are available on every top-level window. Each method has two equivalent spellings: a short name and a ``wm_``-prefixed name (for example, :meth:`title` and :meth:`wm_title`). See also :ref:`tkinter-window-manager`." -msgstr "" - -msgid "Constrain the aspect ratio (the ratio of width to height) of the window. If all four arguments are given, the window manager keeps the ratio between ``minNumer/minDenom`` and ``maxNumer/maxDenom``; passing empty strings removes any existing restriction. With no arguments, return a tuple of the four current values, or ``None`` if no aspect restriction is in effect. :meth:`wm_aspect` is an alias of :meth:`!aspect`." -msgstr "" - -msgid "Query or set platform-specific attributes of the window. With no arguments, return the platform-specific flags and their values; pass *return_python_dict* as true to get them as a dictionary. A single option name such as ``'alpha'`` returns the value of that option, and options are set using keyword arguments (``alpha=0.5``)." -msgstr "" - -msgid "The available attributes differ by platform. All platforms support:" -msgstr "" - -msgid "*alpha*" -msgstr "" - -msgid "The window's opacity, from ``0.0`` (fully transparent) to ``1.0`` (opaque). Where transparency is unsupported the value stays at ``1.0``." -msgstr "" - -msgid "*appearance*" -msgstr "" - -msgid "Whether the window is rendered in dark mode on Windows and macOS: ``'auto'``, ``'light'`` or ``'dark'`` (this has no effect on X11)." -msgstr "" - -msgid "*fullscreen*" -msgstr "" - -msgid "Whether the window takes up the entire screen and has no borders." -msgstr "" - -msgid "*topmost*" -msgstr "" - -msgid "Whether the window is displayed above all other windows." -msgstr "" - -msgid "Windows additionally supports:" -msgstr "" - -msgid "*disabled*" -msgstr "" - -msgid "Whether the window is in a disabled state." -msgstr "" - -msgid "*toolwindow*" -msgstr "" - -msgid "Whether the window uses the tool window style." -msgstr "" - -msgid "*transparentcolor*" -msgstr "" - -msgid "The color that is made fully transparent, or an empty string for none." -msgstr "" - -msgid "macOS additionally supports:" -msgstr "" - -msgid "*class*" -msgstr "" - -msgid "Whether the underlying Aqua window is an ``nswindow`` or an ``nspanel``; this can only be set before the window is created." -msgstr "" - -msgid "*modified*" -msgstr "" - -msgid "The modification state shown by the window's close button and proxy icon." -msgstr "" - -msgid "*notify*" -msgstr "" - -msgid "Whether the application's dock icon bounces to request attention." -msgstr "" - -msgid "*stylemask*" -msgstr "" - -msgid "The style mask of the underlying Aqua window, given as a list of bit names such as ``titled`` or ``resizable``." -msgstr "" - -msgid "*tabbingid*" -msgstr "" - -msgid "The identifier of the tab group that the window belongs to." -msgstr "" - -msgid "*tabbingmode*" -msgstr "" - -msgid "Whether the window may be opened as a tab: ``'auto'``, ``'preferred'`` or ``'disallowed'``." -msgstr "" - -msgid "*titlepath*" -msgstr "" - -msgid "The path of the file represented by the window's proxy icon." -msgstr "" - -msgid "*transparent*" -msgstr "" - -msgid "Whether the content area is transparent and the window shadow is turned off." -msgstr "" - -msgid "X11 additionally supports:" -msgstr "" - -msgid "*type*" -msgstr "" - -msgid "The window type, or a list of types in order of preference, that the window manager should use to interpret the window, such as ``'dialog'`` or ``'splash'``." -msgstr "" - -msgid "*zoomed*" -msgstr "" - -msgid "Whether the window is maximized." -msgstr "" - -msgid "Tk 8.6 added the *type* attribute, and Tk 9.0 added the *appearance*, *class*, *stylemask*, *tabbingid* and *tabbingmode* attributes." -msgstr "" - -msgid "On X11 changes are applied asynchronously, so a queried value may not yet reflect the most recent request. :meth:`wm_attributes` is an alias of :meth:`!attributes`." -msgstr "" - -msgid "A single attribute may now be queried by name without the leading ``-``, and attributes may be set using keyword arguments. The *return_python_dict* parameter was added." -msgstr "" - -msgid "Setting an attribute by passing the option name (with a leading ``-``) and its value as two positional arguments, as in ``w.attributes('-alpha', 0.5)``, is deprecated; use keyword arguments instead." -msgstr "" - -msgid "Store *name*, which should be the name of the host on which the application is running, in the window's ``WM_CLIENT_MACHINE`` property for use by the window or session manager. An empty string deletes the property. With no argument, return the last name set, or an empty string. :meth:`wm_client` is an alias of :meth:`!client`." -msgstr "" - -msgid "Manipulate the ``WM_COLORMAP_WINDOWS`` property, which tells the window manager about windows that have private colormaps. If *wlist* is given, overwrite the property with those windows (their order is a priority order for installing colormaps). With no arguments, return the list of windows currently named in the property. :meth:`wm_colormapwindows` is an alias of :meth:`!colormapwindows`." -msgstr "" - -msgid "Store *value* in the window's ``WM_COMMAND`` property for use by the window or session manager; it should be a list giving the words of the command used to invoke the application. An empty string deletes the property. With no argument, return the last value set, or an empty string. :meth:`wm_command` is an alias of :meth:`!command`." -msgstr "" - -msgid "Display the window in normal (non-iconified) form by mapping it. If the window has never been mapped, this ensures it appears de-iconified when it is first mapped. On Windows the window is also raised and given the focus. :meth:`wm_deiconify` is an alias of :meth:`!deiconify`." -msgstr "" - -msgid "Set or query the focus model for the window. *model* is either ``'active'`` (the window claims the input focus for itself or its descendants, even when the focus is in another application) or ``'passive'`` (the window relies on the window manager to give it the focus). With no argument, return the current model. The default is ``'passive'``, which is what the :meth:`!focus` command assumes. :meth:`wm_focusmodel` is an alias of :meth:`!focusmodel`." -msgstr "" - -msgid "Unmap *window* from the screen so that it is no longer managed by the window manager. A :class:`Toplevel` is then treated like a :class:`Frame`, although its ``-menu`` configuration is remembered and the menu reappears if the widget is managed again. :meth:`wm_forget` is an alias of :meth:`!forget`." -msgstr "" - -msgid "Not to be confused with :meth:`Pack.forget`." -msgstr "" - -msgid "Return the platform-specific window identifier for the outermost decorative frame containing the window, if the window manager has reparented it into such a frame; otherwise return the identifier of the window itself. :meth:`wm_frame` is an alias of :meth:`!frame`." -msgstr "" - -msgid "Set or query the geometry of the window. *newGeometry* has the form ``=widthxheight+x+y``, where any of ``=``, ``widthxheight`` and the ``+x+y`` position may be omitted. *width* and *height* are in pixels (or grid units for a gridded window); a position preceded by ``+`` is measured from the left or top edge of the screen and one preceded by ``-`` from the right or bottom edge. An offset can be negative, as in ``'200x100+-9+-8'``, when the window edge is positioned beyond the corresponding screen edge. An empty string cancels any user-specified geometry, letting the window revert to its natural size. With no argument, return the current geometry as a string of the form ``'200x200+10+10'``. :meth:`wm_geometry` is an alias of :meth:`!geometry`." -msgstr "" - -msgid "Manage the window as a gridded window and define the relationship between grid units and pixels. *baseWidth* and *baseHeight* are the numbers of grid units for the window's internally requested size, and *widthInc* and *heightInc* are the pixel sizes of a horizontal and vertical grid unit. Empty strings turn off gridded management. With no arguments, return a tuple of the four current values, or ``None`` if the window is not gridded. :meth:`wm_grid` is an alias of :meth:`!grid`." -msgstr "" - -msgid "Not to be confused with the grid geometry manager :meth:`Grid.grid`." -msgstr "" - -msgid "Set or query the leader of a group of related windows. *pathName* gives the path name of the group leader; the window manager may, for example, unmap all windows in the group when the leader is iconified. An empty string removes the window from any group. With no argument, return the path name of the current group leader, or an empty string. :meth:`wm_group` is an alias of :meth:`!group`." -msgstr "" - -msgid "Set or query the bitmap used by the window manager for the window's icon. *bitmap* names a bitmap in one of the standard forms accepted by Tk; an empty string cancels the current icon bitmap. With no argument, return the name of the current icon bitmap, or an empty string. On Windows the *default* argument names an icon (for example an ``.ico`` file) applied to all top-level windows that have no icon of their own. :meth:`wm_iconbitmap` is an alias of :meth:`!iconbitmap`." -msgstr "" - -msgid "Iconify the window. If the window has not yet been mapped for the first time, arrange for it to appear in the iconified state when it is eventually mapped. :meth:`wm_iconify` is an alias of :meth:`!iconify`." -msgstr "" - -msgid "Set or query the bitmap used as a mask for the icon (see :meth:`iconbitmap`). Where the mask is zero no icon is displayed; where it is one, the corresponding bits of the icon bitmap are shown. An empty string cancels the current mask. With no argument, return the name of the current icon mask, or an empty string. :meth:`wm_iconmask` is an alias of :meth:`!iconmask`." -msgstr "" - -msgid "Set or query the name displayed by the window manager inside the window's icon. With no argument, return the current icon name, or an empty string if none has been set (in which case the window manager normally displays the window's title). :meth:`wm_iconname` is an alias of :meth:`!iconname`." -msgstr "" - -msgid "Set the titlebar icon for the window from one or more :class:`PhotoImage` objects given in *images*. Several images of different sizes (for example 16x16 and 32x32) may be supplied so that the window manager can choose an appropriate one. The image data is taken as a snapshot at the time of the call; later changes to the images are not reflected. If *default* is true, the icon is also applied to all top-level windows created in the future. On macOS only the first image is used. :meth:`wm_iconphoto` is an alias of :meth:`!iconphoto`." -msgstr "" - -msgid "Set or query a hint to the window manager about where the window's icon should be positioned. Empty strings cancel an existing hint. With no arguments, return a tuple of the two current values, or ``None`` if no hint is in effect. :meth:`wm_iconposition` is an alias of :meth:`!iconposition`." -msgstr "" - -msgid "Set or query the window used as the icon for the window. When the window is iconified, *pathName* is mapped to serve as its icon and unmapped again when it is de-iconified. An empty string cancels the association. With no argument, return the path name of the current icon window, or an empty string. Not all window managers support icon windows, and the concept is meaningless on non-X11 platforms. :meth:`wm_iconwindow` is an alias of :meth:`!iconwindow`." -msgstr "" - -msgid "Make *widget* a stand-alone top-level window, decorated by the window manager with a title bar and so on. Only :class:`Frame`, :class:`LabelFrame` and :class:`Toplevel` widgets may be used (the :mod:`tkinter.ttk` versions are **not** accepted); passing any other widget type raises an error. :meth:`wm_manage` is an alias of :meth:`!manage`." -msgstr "" - -msgid "Set or query the maximum permissible dimensions of the window, in pixels (or grid units for a gridded window). The window manager restricts the window to be no larger than *width* and *height*. With no arguments, return a tuple of the current maximum width and height. The maximum size defaults to the size of the screen. :meth:`wm_maxsize` is an alias of :meth:`!maxsize`." -msgstr "" - -msgid "Set or query the minimum permissible dimensions of the window, in pixels (or grid units for a gridded window). The window manager restricts the window to be no smaller than *width* and *height*. With no arguments, return a tuple of the current minimum width and height. The minimum size defaults to one pixel in each dimension. :meth:`wm_minsize` is an alias of :meth:`!minsize`." -msgstr "" - -msgid "Set or query the override-redirect flag for the window. When this flag is set, the window is ignored by the window manager: it is not reparented into a decorative frame and the user cannot manipulate it through the usual window manager controls. With no argument, return a boolean indicating whether the flag is set, or ``None`` if it has not been set. The flag is reliably honored only when the window is first mapped or remapped from the withdrawn state. :meth:`wm_overrideredirect` is an alias of :meth:`!overrideredirect`." -msgstr "" - -msgid "Set or query the source of the window's current position. *who* is either ``'program'`` or ``'user'`` and indicates whether the position was requested by the program or by the user; an empty string cancels the current source. With no argument, return the current source, or an empty string if none has been set. Tk automatically sets the source to ``'user'`` when :meth:`geometry` is called, unless it has been set explicitly to ``'program'``. :meth:`wm_positionfrom` is an alias of :meth:`!positionfrom`." -msgstr "" - -msgid "Register *func* as the handler for the window manager protocol *name*, an atom such as ``'WM_DELETE_WINDOW'``, ``'WM_SAVE_YOURSELF'`` or ``'WM_TAKE_FOCUS'``; *func* is then called whenever the window manager sends a message of that protocol. Tk installs a default ``WM_DELETE_WINDOW`` handler that destroys the window, which this method can replace. If *func* is an empty string, the handler is removed. With only *name*, return the name of its registered handler command, or an empty string if none is set (the default ``WM_DELETE_WINDOW`` handler is not reported); with no arguments, return a tuple of the protocols that currently have handlers. :meth:`wm_protocol` is an alias of :meth:`!protocol`." -msgstr "" - -msgid "Control whether the user may interactively resize the window. *width* and *height* are boolean values that determine whether the window's width and height may be changed. With no arguments, return a tuple of two ``0``/``1`` values indicating whether each dimension is currently resizable. By default a window is resizable in both dimensions. :meth:`wm_resizable` is an alias of :meth:`!resizable`." -msgstr "" - -msgid "Set or query the source of the window's current size. *who* is either ``'program'`` or ``'user'`` and indicates whether the size was requested by the program or by the user; an empty string cancels the current source. With no argument, return the current source, or an empty string if none has been set. :meth:`wm_sizefrom` is an alias of :meth:`!sizefrom`." -msgstr "" - -msgid "Set or query the state of the window. With no argument, return the current state: one of ``'normal'``, ``'iconic'``, ``'withdrawn'``, ``'icon'`` or, on Windows and macOS only, ``'zoomed'``. ``'iconic'`` refers to a window that has been iconified, while ``'icon'`` refers to a window serving as the icon for another window (see :meth:`iconwindow`); the ``'icon'`` state cannot be set. :meth:`wm_state` is an alias of :meth:`!state`." -msgstr "" - -msgid "Not to be confused with :meth:`ttk.Widget.state `." -msgstr "" - -msgid "Set or query the title for the window, which the window manager should display in the window's title bar. With no argument, return the current title. The title defaults to the window's name. :meth:`wm_title` is an alias of :meth:`!title`." -msgstr "" - -msgid "Mark the window as a transient window (such as a pull-down menu or dialog) working on behalf of *master*, the path name of another top-level window. An empty string clears the transient status. With no argument, return the path name of the current master, or an empty string. A transient window mirrors state changes in its master and may be decorated differently by the window manager; it is an error to make a window a transient of itself. :meth:`wm_transient` is an alias of :meth:`!transient`." -msgstr "" - -msgid "Withdraw the window from the screen, unmapping it and causing the window manager to forget about it. If the window has never been mapped, it is instead mapped in the withdrawn state. It is sometimes necessary to withdraw a window and then re-map it (for example with :meth:`deiconify`) to make some window managers notice changes to window attributes. :meth:`wm_withdraw` is an alias of :meth:`!withdraw`." -msgstr "" - -msgid "Geometry manager that arranges widgets by packing them against the sides of their container. The :class:`!Pack` mix-in is inherited by all widgets (through :class:`Widget`) and provides the methods for managing a widget with the *pack* geometry manager. See also :ref:`tkinter-geometry-management`." -msgstr "" - -msgid ":class:`Pack`, :class:`Place` and :class:`Grid` all define the short method names :meth:`!forget`, :meth:`!info`, :meth:`!slaves`, :meth:`!content` and :meth:`!propagate`. On a widget the bare names resolve to the *pack* manager's versions, since :class:`Pack` and :class:`Misc` precede :class:`Place` and :class:`Grid` in the method resolution order, whatever manager actually manages the widget; and :meth:`!configure`/:meth:`!config` configure the widget's options, not its geometry. Use the explicit ``pack_*``, ``grid_*`` and ``place_*`` methods (and ``pack``, ``grid``, ``place`` for geometry configuration) to act on a specific geometry manager." -msgstr "" - -msgid "Pack the widget inside its container, positioning it relative to the siblings already packed there. The supported options are:" -msgstr "" - -msgid "*side*" -msgstr "" - -msgid "Which side of the container to pack the widget against: ``'top'`` (the default), ``'bottom'``, ``'left'`` or ``'right'``." -msgstr "" - -msgid "*fill*" -msgstr "" - -msgid "Whether to stretch the widget to fill its parcel: ``'none'`` (the default), ``'x'``, ``'y'`` or ``'both'``." -msgstr "" - -msgid "*expand*" -msgstr "" - -msgid "Whether the widget should expand to consume any extra space in its container (a boolean, default false)." -msgstr "" - -msgid "*anchor*" -msgstr "" - -msgid "Where to position the widget in its parcel when the parcel is larger than the widget: an anchor such as ``'n'`` or ``'sw'`` (default ``'center'``)." -msgstr "" - -msgid "*ipadx*, *ipady*" -msgstr "" - -msgid "Internal padding added on the left and right (*ipadx*) or top and bottom (*ipady*) of the widget, as a screen distance (default ``0``)." -msgstr "" - -msgid "*padx*, *pady*" -msgstr "" - -msgid "External padding left on the left and right (*padx*) or top and bottom (*pady*) of the widget, as a screen distance or a pair of two distances for the two sides (default ``0``)." -msgstr "" - -msgid "*after*" -msgstr "" - -msgid "Pack the widget after the given widget in the packing order, using the same container." -msgstr "" - -msgid "*before*" -msgstr "" - -msgid "Pack the widget before the given widget in the packing order, using the same container." -msgstr "" - -msgid "*in_*" -msgstr "" - -msgid "The container in which to pack the widget; it defaults to the parent widget." -msgstr "" - -msgid ":meth:`pack`, :meth:`configure` and :meth:`config` are aliases of :meth:`!pack_configure`." -msgstr "" - -msgid "Unmap the widget and remove it from the packing order, forgetting its packing options. It can be packed again later with :meth:`pack_configure`. :meth:`forget` is an alias of :meth:`!pack_forget`, except on :class:`PanedWindow`, :class:`ttk.Notebook ` and :class:`ttk.PanedWindow `, which provide their own :meth:`!forget` method." -msgstr "" - -msgid "Not to be confused with :meth:`Wm.forget`." -msgstr "" - -msgid "Return a dictionary of the widget's current packing options. :meth:`info` is an alias of :meth:`!pack_info`." -msgstr "" - -msgid "Same as :meth:`Misc.pack_propagate`, treating this widget as a container: enable or disable geometry propagation. :meth:`propagate` is an alias of :meth:`!pack_propagate`." -msgstr "" - -msgid "Same as :meth:`Misc.pack_slaves`: return the list of widgets packed in this widget. :meth:`slaves` is an alias of :meth:`!pack_slaves`." -msgstr "" - -msgid "Geometry manager that places widgets at explicit positions and sizes within their container. The :class:`!Place` mix-in is inherited by all widgets (through :class:`Widget`). See also :ref:`tkinter-geometry-management`." -msgstr "" - -msgid "Place the widget inside its container at an absolute or relative position. The supported options are:" -msgstr "" - -msgid "*x*, *y*" -msgstr "" - -msgid "The absolute horizontal and vertical position of the widget's anchor point, as a screen distance (default ``0``)." -msgstr "" - -msgid "*relx*, *rely*" -msgstr "" - -msgid "The horizontal and vertical position of the widget's anchor point as a fraction of the container's width and height, where ``0.0`` is the left or top edge and ``1.0`` is the right or bottom edge. If both the absolute and the relative option are given, their values are summed." -msgstr "" - -msgid "Which point of the widget is placed at the given position: an anchor such as ``'n'`` or ``'se'`` (default ``'nw'``)." -msgstr "" - -msgid "*width*, *height*" -msgstr "" - -msgid "The absolute width and height of the widget, as a screen distance. By default the widget's requested size is used." -msgstr "" - -msgid "*relwidth*, *relheight*" -msgstr "" - -msgid "The width and height of the widget as a fraction of the container's width and height. If both the absolute and the relative option are given, their values are summed." -msgstr "" - -msgid "*bordermode*" -msgstr "" - -msgid "How the container's border affects placement: ``'inside'`` (the default) measures the area inside the border, ``'outside'`` measures the area including the border, and ``'ignore'`` uses the official X area." -msgstr "" - -msgid "The container relative to which the widget is placed; it must be the widget's parent or a descendant of the parent, and defaults to the parent." -msgstr "" - -msgid ":meth:`place`, :meth:`configure` and :meth:`config` are aliases of :meth:`!place_configure`." -msgstr "" - -msgid "Unmap the widget and remove it from the placement, forgetting its place options." -msgstr "" - -msgid "Return a dictionary of the widget's current place options." -msgstr "" - -msgid "Same as :meth:`Misc.place_slaves`: return the list of widgets placed in this widget." -msgstr "" - -msgid "Geometry manager that arranges widgets in a two-dimensional grid of rows and columns within their container. The :class:`!Grid` mix-in is inherited by all widgets (through :class:`Widget`). See also :ref:`tkinter-geometry-management`." -msgstr "" - -msgid "Position the widget in a cell of its container's grid." -msgstr "" - -msgid "Not to be confused with :meth:`Wm.grid`." -msgstr "" - -msgid "The supported options are:" -msgstr "" - -msgid "*row*, *column*" -msgstr "" - -msgid "The row and column of the cell to place the widget in, counting from ``0``. *column* defaults to the column after the previous widget placed in the same :meth:`!grid_configure` call (or ``0``), and *row* defaults to the next empty row." -msgstr "" - -msgid "*rowspan*, *columnspan*" -msgstr "" - -msgid "The number of rows and columns the widget should span (default ``1``)." -msgstr "" - -msgid "*sticky*" -msgstr "" - -msgid "How to position or stretch the widget when its cell is larger than the widget: a string containing zero or more of the characters ``'n'``, ``'s'``, ``'e'`` and ``'w'``, naming the cell sides the widget sticks to. Specifying both ``'n'`` and ``'s'`` (or ``'e'`` and ``'w'``) stretches the widget to fill the height (or width) of the cell. The default is ``''``, which centers the widget at its requested size." -msgstr "" - -msgid "The container in whose grid to place the widget; it defaults to the parent widget." -msgstr "" - -msgid ":meth:`grid`, :meth:`configure` and :meth:`config` are aliases of :meth:`!grid_configure`." -msgstr "" - -msgid "Unmap the widget and remove it from the grid, forgetting its grid options." -msgstr "" - -msgid "Unmap the widget and remove it from the grid, but remember its grid options so that it is restored to the same cell if it is gridded again." -msgstr "" - -msgid "Return a dictionary of the widget's current grid options." -msgstr "" - -msgid "Same as :meth:`Misc.grid_bbox`. :meth:`bbox` is an alias of :meth:`!grid_bbox`, except on :class:`Canvas`, :class:`Listbox`, :class:`Spinbox`, :class:`Text`, :class:`ttk.Entry ` and :class:`ttk.Treeview `, which provide their own :meth:`!bbox` method." -msgstr "" - -msgid "Same as :meth:`Misc.grid_columnconfigure`: query or set the options (such as *weight*, *minsize*, *pad* and *uniform*) of a grid column. :meth:`columnconfigure` is an alias of :meth:`!grid_columnconfigure`." -msgstr "" - -msgid "Same as :meth:`Misc.grid_rowconfigure`: query or set the options of a grid row. :meth:`rowconfigure` is an alias of :meth:`!grid_rowconfigure`." -msgstr "" - -msgid "Same as :meth:`Misc.grid_location`: return the ``(column, row)`` of the cell that covers the pixel at *x*, *y*. :meth:`location` is an alias of :meth:`!grid_location`." -msgstr "" - -msgid "Same as :meth:`Misc.grid_size`: return a ``(columns, rows)`` tuple giving the size of the grid. :meth:`size` is an alias of :meth:`!grid_size`, except on the :class:`Listbox` widget, which provides its own :meth:`!size` method." -msgstr "" - -msgid "Same as :meth:`Misc.grid_propagate`." -msgstr "" - -msgid "Same as :meth:`Misc.grid_slaves`: return the widgets managed in the grid, optionally restricted to a *row* and/or *column*." -msgstr "" - -msgid "Mix-in providing the horizontal-scrolling interface shared by widgets such as :class:`Entry`, :class:`Canvas`, :class:`Listbox`, :class:`Text` and :class:`Spinbox`. A widget's :meth:`xview` method is registered as the *command* of a horizontal :class:`Scrollbar`." -msgstr "" - -msgid "Query or change the horizontal position of the view. With no arguments, return a tuple ``(first, last)`` of two fractions between 0 and 1 giving the portion of the document that is currently visible. Otherwise the arguments are passed to the Tk ``xview`` widget command and are usually generated by a scrollbar; :meth:`xview_moveto` and :meth:`xview_scroll` provide a more convenient interface." -msgstr "" - -msgid "Adjust the view so that *fraction* of the total width of the document is off-screen to the left. *fraction* is a number between 0 and 1." -msgstr "" - -msgid "Shift the view left or right by *number* units. *what* is either ``'units'`` or ``'pages'``; a negative *number* scrolls left and a positive one scrolls right." -msgstr "" - -msgid "Mix-in providing the vertical-scrolling interface shared by widgets such as :class:`Canvas`, :class:`Listbox` and :class:`Text`. A widget's :meth:`yview` method is registered as the *command* of a vertical :class:`Scrollbar`." -msgstr "" - -msgid "Query or change the vertical position of the view. With no arguments, return a tuple ``(first, last)`` of two fractions between 0 and 1 giving the portion of the document that is currently visible. Otherwise the arguments are passed to the Tk ``yview`` widget command, usually generated by a scrollbar; :meth:`yview_moveto` and :meth:`yview_scroll` provide a more convenient interface." -msgstr "" - -msgid "Adjust the view so that *fraction* of the total height of the document is off-screen above the top. *fraction* is a number between 0 and 1." -msgstr "" - -msgid "Shift the view up or down by *number* units. *what* is either ``'units'`` or ``'pages'``; a negative *number* scrolls up and a positive one scrolls down." -msgstr "" - -msgid "Internal base class for all widgets. It inherits from :class:`Misc` and adds the machinery that creates the underlying Tk widget; application code normally uses :class:`Widget` or a concrete widget class rather than instantiating :class:`!BaseWidget` directly." -msgstr "" - -msgid "Destroy this widget and all of its children, removing the corresponding Tk widgets and deleting the associated Tcl commands." -msgstr "" - -msgid "Internal base class for the standard widgets. It combines :class:`BaseWidget` with the geometry-manager mix-ins :class:`Pack`, :class:`Place` and :class:`Grid`, so that every widget can be managed by any of the three geometry managers. The concrete widget classes (:class:`Button`, :class:`Label`, and so on) derive from :class:`!Widget`." -msgstr "" - -msgid "Toplevel widgets" -msgstr "" - -msgid "Construct a toplevel Tk widget, which is usually the main window of an application, and initialize a Tcl interpreter for this widget. Each instance has its own associated Tcl interpreter. Inherits from :class:`Misc` and :class:`Wm`." -msgstr "" - -msgid "To create a Tcl interpreter without initializing the Tk subsystem, use the :func:`Tcl` factory function instead." -msgstr "" - -msgid "The :class:`Tk` class is typically instantiated using all default values. However, the following keyword arguments are currently recognized:" -msgstr "" - -msgid "*screenName*" -msgstr "" - -msgid "When given (as a string), sets the :envvar:`DISPLAY` environment variable. (X11 only)" -msgstr "" - -msgid "*baseName*" -msgstr "" - -msgid "Name of the profile file. By default, *baseName* is derived from the program name (``sys.argv[0]``)." -msgstr "" - -msgid "*className*" -msgstr "" - -msgid "Name of the widget class. Used as a profile file and also as the name with which Tcl is invoked (*argv0* in *interp*)." -msgstr "" - -msgid "*useTk*" -msgstr "" - -msgid "If ``True``, initialize the Tk subsystem. The :func:`tkinter.Tcl() ` function sets this to ``False``." -msgstr "" - -msgid "*sync*" -msgstr "" - -msgid "If ``True``, execute all X server commands synchronously, so that errors are reported immediately. Can be used for debugging. (X11 only)" -msgstr "" - -msgid "*use*" -msgstr "" - -msgid "Specifies the *id* of the window in which to embed the application, instead of it being created as an independent toplevel window. *id* must be specified in the same way as the value for the -use option for toplevel widgets (that is, it has a form like that returned by :meth:`~Misc.winfo_id`)." -msgstr "" - -msgid "Note that on some platforms this will only work correctly if *id* refers to a Tk frame or toplevel that has its -container option enabled." -msgstr "" - -msgid ":class:`Tk` reads and interprets profile files, named :file:`.{className}.tcl` and :file:`.{baseName}.tcl`, into the Tcl interpreter and calls :func:`exec` on the contents of :file:`.{className}.py` and :file:`.{baseName}.py`. The path for the profile files is the :envvar:`HOME` environment variable or, if that isn't defined, then :data:`os.curdir`." -msgstr "" - -msgid "On Windows, creating a Tcl interpreter (by instantiating :class:`Tk` or calling :func:`Tcl`) sets the :envvar:`HOME` environment variable for the process, if it is not already set, to ``%HOMEDRIVE%%HOMEPATH%`` (or :envvar:`USERPROFILE`, or ``c:\\``). This is done by Tcl and can affect other code that reads :envvar:`HOME`." -msgstr "" - -msgid "The Tk application object created by instantiating :class:`Tk`. This provides access to the Tcl interpreter. Each widget that is attached the same instance of :class:`Tk` has the same value for its :attr:`tk` attribute." -msgstr "" - -msgid "The widget object that contains this widget. For :class:`Tk`, the :attr:`!master` is :const:`None` because it is the main window. The terms *master* and *parent* are similar and sometimes used interchangeably as argument names; however, calling :meth:`~Misc.winfo_parent` returns a string of the widget name whereas :attr:`!master` returns the object. *parent*/*child* reflects the tree-like relationship while *master* (or *container*)/*content* reflects the container structure." -msgstr "" - -msgid "The immediate descendants of this widget as a :class:`dict` with the child widget names as the keys and the child instance objects as the values." -msgstr "" - -msgid "Destroy this and all descendant widgets and, for the main window, end the connection to the underlying Tcl interpreter." -msgstr "" - -msgid "Finish loading and initializing the Tk subsystem. This is needed only when the interpreter was created without Tk (for example through :func:`Tcl`); it is called automatically when *useTk* is true." -msgstr "" - -msgid "Read and source the user's profile files :file:`.{className}.tcl` and :file:`.{baseName}.tcl` into the Tcl interpreter, and execute the corresponding :file:`.{className}.py` and :file:`.{baseName}.py` files. This is called during initialization; see the description of the constructor above." -msgstr "" - -msgid "Report a callback exception. This is called when an exception propagates out of a Tkinter callback; *exc*, *val* and *tb* are the exception type, value and traceback as returned by :func:`sys.exc_info`. The default implementation prints a traceback to :data:`sys.stderr`. It can be overridden to customize error handling, for example to display the traceback in a dialog." -msgstr "" - -msgid "A :class:`!Toplevel` widget is a top-level window, similar to a :class:`Frame` except that its X parent is the root window of a screen rather than its logical parent. Its primary purpose is to serve as a container for dialog boxes and other collections of widgets; its only visible features are its background and an optional 3-D border. Notable options include *menu*, which installs a :class:`Menu` as the window's menubar. Inherits from :class:`BaseWidget` and :class:`Wm`, so a toplevel is managed by the window manager. Refer to the Tk ``toplevel`` manual page for the full list of options." -msgstr "" - -msgid "Widget classes" -msgstr "" - -msgid "A :class:`!Button` widget displays a textual string, bitmap or image and invokes a command when the user presses it (by clicking mouse button 1 over the button or, when the button has focus, by pressing the space key). Inherits from :class:`Widget`. In addition to the standard widget options, a button accepts the options documented in the Tk ``button`` manual page, such as *command* (the callback invoked when the button is pressed), *textvariable*, *state* and *default*." -msgstr "" - -msgid "Invoke the command associated with the button, if there is one, and return its result, or an empty string if no command is associated with the button. This is ignored if the button's state is ``disabled``." -msgstr "" - -msgid "Flash the button by redisplaying it several times, alternating between the active and normal colors. At the end of the flash the button is left in the same normal or active state as when the method was called. This is ignored if the button's state is ``disabled``." -msgstr "" - -msgid "A :class:`!Canvas` widget implements structured graphics. It displays any number of *items*, such as arcs, lines, ovals, polygons, rectangles, text, bitmaps, images and embedded windows, which may be drawn, moved, re-colored and bound to events. Inherits from :class:`Widget`, :class:`XView` and :class:`YView`, so the view can be scrolled horizontally and vertically with :meth:`~XView.xview` and :meth:`~YView.yview`. Refer to the Tk ``canvas`` manual page for the full list of widget and item options." -msgstr "" - -msgid "Each item has a unique integer *id*, assigned when it is created, and zero or more string *tags*. A tag is an arbitrary string that does not have the form of an integer; the same tag may be shared by many items, which makes tags convenient for grouping items. The special tag ``'all'`` matches every item in the canvas, and ``'current'`` matches the topmost item under the mouse pointer. Most methods take a *tagOrId* argument that may be an integer id naming a single item, or a tag naming zero or more items; as described in the Tk ``canvas`` manual page, a tag may also be a logical expression of tags combined with the operators ``&&``, ``||``, ``^``, ``!`` and parentheses. When a method that operates on a single item is given a *tagOrId* matching several items, it normally uses the lowest matching item in the display list." -msgstr "" - -msgid "The items are kept in a *display list* that determines drawing order: items later in the list are drawn on top of earlier ones. A newly created item is placed at the top of the list; the order can be changed with :meth:`tag_raise` and :meth:`tag_lower`." -msgstr "" - -msgid "Create a new item of the corresponding type and return its integer id. Each method is called as ``create_TYPE(coord..., **options)``: the leading positional arguments give the coordinates that define the item (as separate numbers, as a single sequence of numbers, or as coordinate pairs), and the keyword arguments set item-specific options. Coordinates and screen distances may be given as numbers (interpreted as pixels) or as strings with a unit suffix (``'m'``, ``'c'``, ``'i'`` or ``'p'`` for millimetres, centimetres, inches or printer's points), but are always stored and returned in pixels." -msgstr "" - -msgid "The item types are: ``arc`` (an arc-shaped region that is a section of an oval, defined by two diagonally opposite corners ``x1, y1, x2, y2`` of the enclosing rectangle); ``bitmap`` (a two-color bitmap positioned at a point ``x, y``); ``image`` (a Tk image positioned at a point ``x, y``); ``line`` (a line or curve through the points ``x1, y1, ..., xn, yn``); ``oval`` (a circle or ellipse inscribed in the rectangle ``x1, y1, x2, y2``); ``polygon`` (a closed polygon through the points ``x1, y1, ..., xn, yn``); ``rectangle`` (a rectangle with corners ``x1, y1, x2, y2``); ``text`` (a string of text positioned at a point ``x, y``); and ``window`` (a child widget embedded in the canvas at a point ``x, y``, specified with the *window* option)." -msgstr "" - -msgid "Most item types accept a common set of *standard item options*, plus a few options specific to each type. Option names are passed as keyword arguments, without the leading hyphen." -msgstr "" - -msgid "The standard item options are:" -msgstr "" - -msgid "The color used to fill the item's interior, or to draw a *line* item or the characters of a *text* item. An empty string (the default for all types except *line* and *text*) leaves the item unfilled." -msgstr "" - -msgid "*outline*" -msgstr "" - -msgid "The color used to draw the item's outline. An empty string draws no outline." -msgstr "" - -msgid "*width*" -msgstr "" - -msgid "The width of the outline, defaulting to ``1.0``. Has no effect if *outline* is empty." -msgstr "" - -msgid "*dash*" -msgstr "" - -msgid "A dash pattern for the outline, given either as a sequence of segment lengths in pixels or as a string of the characters ``'.'``, ``','``, ``'-'``, ``'_'`` and space. An empty pattern (the default) draws a solid outline." -msgstr "" - -msgid "*dashoffset*" -msgstr "" - -msgid "The starting offset in pixels into the *dash* pattern. Ignored if there is no *dash* pattern." -msgstr "" - -msgid "*stipple*" -msgstr "" - -msgid "A bitmap used as a stipple pattern when filling the item. Only well supported on X11." -msgstr "" - -msgid "*outlinestipple*" -msgstr "" - -msgid "A bitmap used as a stipple pattern when drawing the outline. Has no effect if *outline* is empty." -msgstr "" - -msgid "*offset*, *outlineoffset*" -msgstr "" - -msgid "The offset of the fill and outline stipple patterns, given as ``'x,y'`` or as a side such as ``'n'``, ``'se'`` or ``'center'``. Stipple offsets are only supported on X11." -msgstr "" - -msgid "*state*" -msgstr "" - -msgid "Overrides the canvas state for this item; one of ``'normal'``, ``'disabled'`` or ``'hidden'``." -msgstr "" - -msgid "*tags*" -msgstr "" - -msgid "A single tag or a sequence of tags to associate with the item, replacing any existing tags." -msgstr "" - -msgid "Many of these options have *active...* and *disabled...* variants (such as *activefill*, *disabledfill*, *activewidth*, *disableddash*, *activeoutline*, *disabledstipple*) that override the base option when the item is the active item (under the mouse pointer) or is in the disabled state." -msgstr "" - -msgid "The following item types support additional options." -msgstr "" - -msgid "For ``arc`` items:" -msgstr "" - -msgid "*start*" -msgstr "" - -msgid "The start of the arc's angular range, in degrees measured counter-clockwise from the 3-o'clock position." -msgstr "" - -msgid "*extent*" -msgstr "" - -msgid "The size of the angular range, in degrees counter-clockwise from *start*." -msgstr "" - -msgid "*style*" -msgstr "" - -msgid "How the arc is drawn: ``'pieslice'`` (the default), ``'chord'`` or ``'arc'``." -msgstr "" - -msgid "For ``line`` items:" -msgstr "" - -msgid "*arrow*" -msgstr "" - -msgid "Where to draw arrowheads: ``'none'`` (the default), ``'first'``, ``'last'`` or ``'both'``." -msgstr "" - -msgid "*arrowshape*" -msgstr "" - -msgid "A sequence of three distances describing the shape of the arrowheads." -msgstr "" - -msgid "*capstyle*" -msgstr "" - -msgid "How line ends are drawn: ``'butt'`` (the default), ``'projecting'`` or ``'round'``." -msgstr "" - -msgid "*joinstyle*" -msgstr "" - -msgid "How line vertices are drawn: ``'round'`` (the default), ``'bevel'`` or ``'miter'``." -msgstr "" - -msgid "*smooth*" -msgstr "" - -msgid "The smoothing method: a false value (the default) for no smoothing, or ``'true'``/``'bezier'`` or ``'raw'`` to draw the line as a curve." -msgstr "" - -msgid "*splinesteps*" -msgstr "" - -msgid "The number of line segments approximating each spline when *smooth* is enabled." -msgstr "" - -msgid "For ``polygon`` items:" -msgstr "" - -msgid "*joinstyle*, *smooth*, *splinesteps*" -msgstr "" - -msgid "As for ``line`` items, applied to the polygon's outline." -msgstr "" - -msgid "For ``text`` items:" -msgstr "" - -msgid "*text*" -msgstr "" - -msgid "The string to display; newline characters start new lines." -msgstr "" - -msgid "*font*" -msgstr "" - -msgid "The font used for the text." -msgstr "" - -msgid "*justify*" -msgstr "" - -msgid "How lines are justified: ``'left'`` (the default), ``'right'`` or ``'center'``." -msgstr "" - -msgid "How the text is positioned relative to its point, defaulting to ``'center'``." -msgstr "" - -msgid "The maximum line length; if non-zero, lines are wrapped at spaces." -msgstr "" - -msgid "*angle*" -msgstr "" - -msgid "How many degrees to rotate the text counter-clockwise about its positioning point, from ``0.0`` to ``360.0`` (default ``0.0``)." -msgstr "" - -msgid "*underline*" -msgstr "" - -msgid "The index of a character to underline, or ``-1`` for none." -msgstr "" - -msgid "For ``bitmap`` items:" -msgstr "" - -msgid "*bitmap*" -msgstr "" - -msgid "The bitmap to display." -msgstr "" - -msgid "How the bitmap is positioned relative to its point." -msgstr "" - -msgid "*background*, *foreground*" -msgstr "" - -msgid "The colors used for the bitmap's ``0`` and ``1`` pixels; an empty *background* makes the ``0`` pixels transparent. Both have *active...* and *disabled...* variants, and *bitmap* has *activebitmap* and *disabledbitmap* variants." -msgstr "" - -msgid "For ``image`` items:" -msgstr "" - -msgid "*image*" -msgstr "" - -msgid "The Tk image to display, previously created with the image protocols." -msgstr "" - -msgid "How the image is positioned relative to its point." -msgstr "" - -msgid "Both options have *active...* and *disabled...* variants (*activeimage*, *disabledimage*) used in the active and disabled states." -msgstr "" - -msgid "For ``window`` items:" -msgstr "" - -msgid "*window*" -msgstr "" - -msgid "The widget to embed; it must be a child of the canvas or of one of its ancestors, and may not be a top-level window." -msgstr "" - -msgid "How the window is positioned relative to its point." -msgstr "" - -msgid "The size to assign to the window; if zero (the default), the window is given its requested size." -msgstr "" - -msgid "``oval`` and ``rectangle`` items have no type-specific options; they use only the standard item options." -msgstr "" - -msgid "Tk 8.6 added the *angle* option and Tk 9.0 added the *underline* option for ``text`` items." -msgstr "" - -msgid "Query or modify the coordinates of an item. With only *tagOrId*, return a list of the floating-point coordinates of the item given by *tagOrId* (the first matching item if it matches several). Given new coordinates, replace the coordinates of that item with them; like the ``create_*`` methods, the coordinates may be given as separate numbers, as a single sequence, or as coordinate pairs. The returned coordinates are always in pixels, regardless of the units used to specify them; for rectangles, ovals and arcs they are ordered left, top, right, bottom." -msgstr "" - -msgid "The arguments are now flattened: the coordinates may be given as separate arguments, as a single sequence, or grouped in pairs, like the ``create_*`` methods." -msgstr "" - -msgid "Move each of the items given by *tagOrId* in the canvas coordinate space by adding *xAmount* to every x-coordinate and *yAmount* to every y-coordinate of the item." -msgstr "" - -msgid "Move the items given by *tagOrId* so that the first coordinate pair (the upper-left corner of the bounding box) of the lowest matching item is at position (*x*, *y*). *x* or *y* may be an empty string, in which case the corresponding coordinate is unchanged. All matching items keep their positions relative to each other." -msgstr "" - -msgid "Rescale the coordinates of all items given by *tagOrId* in canvas coordinate space. Each x-coordinate is adjusted so that its distance from *xOrigin* changes by a factor of *xScale*, and each y-coordinate so that its distance from *yOrigin* changes by a factor of *yScale* (a factor of ``1.0`` leaves the coordinate unchanged)." -msgstr "" - -msgid "Delete each of the items given by the *tagOrIds* arguments." -msgstr "" - -msgid "Delete from each of the items given by *tagOrId* the characters (for text items) or coordinates (for line and polygon items) in the range from *first* to *last* inclusive; *last* defaults to *first*. Items that do not support indexing ignore this operation." -msgstr "" - -msgid "Insert *string* into each of the items given by *tagOrId* just before the character or coordinate whose index is *beforeThis*. For line and polygon items *string* must be a valid sequence of coordinates." -msgstr "" - -msgid "Return the current value of the configuration option *option* for the item given by *tagOrId* (the lowest matching item if it matches several). This is like :meth:`~Misc.cget` but applies to an individual item." -msgstr "" - -msgid "Query or modify the configuration options of the items given by *tagOrId*. This mirrors :meth:`~Misc.configure`, except that it applies to individual items rather than to the canvas as a whole. With no options, it returns a dictionary describing the current options of the first matching item; otherwise it sets the given options on every matching item. The legal options are those accepted by the corresponding ``create_*`` method. :meth:`itemconfig` is an alias of :meth:`!itemconfigure`." -msgstr "" - -msgid "Return the type of the item given by *tagOrId* (the first matching item if it matches several), such as ``'rectangle'`` or ``'text'``, or ``None`` if *tagOrId* does not match any item." -msgstr "" - -msgid "Return a tuple of the tags associated with the item given by *tagOrId* (the first matching item in display-list order if it matches several). Return an empty tuple if no item matches or the item has no tags." -msgstr "" - -msgid "Remove the tag *tagToDelete* (which defaults to *tagOrId*) from each of the items given by *tagOrId*. Items that do not have that tag are unaffected." -msgstr "" - -msgid "Add the tag *newtag* to each item selected by the search specification *searchSpec* (and any further *args*). *searchSpec* is one of ``'above'``, ``'all'``, ``'below'``, ``'closest'``, ``'enclosed'``, ``'overlapping'`` or ``'withtag'``; the ``addtag_*`` methods below are convenient wrappers that supply each of these forms." -msgstr "" - -msgid "Add the tag *newtag* to the item just above (after) *tagOrId* in the display list." -msgstr "" - -msgid "Add the tag *newtag* to all items in the canvas." -msgstr "" - -msgid "Add the tag *newtag* to the item just below (before) *tagOrId* in the display list." -msgstr "" - -msgid "Add the tag *newtag* to the item closest to the point (*x*, *y*). If *halo* is given, any item within that distance of the point is treated as overlapping it. If *start* is given (a tag or id), select the topmost closest item that lies below *start* in the display list, which can be used to step through all the closest items." -msgstr "" - -msgid "Add the tag *newtag* to every item completely enclosed within the rectangle (*x1*, *y1*, *x2*, *y2*), where *x1* <= *x2* and *y1* <= *y2*." -msgstr "" - -msgid "Add the tag *newtag* to every item that overlaps or is enclosed within the rectangle (*x1*, *y1*, *x2*, *y2*), where *x1* <= *x2* and *y1* <= *y2*." -msgstr "" - -msgid "Add the tag *newtag* to every item given by *tagOrId*." -msgstr "" - -msgid "Return a tuple of the ids of all items selected by the search specification *searchSpec* (and any further *args*), in stacking order with the lowest item first. The search specification has any of the forms accepted by :meth:`addtag`. The ``find_*`` methods below are more convenient wrappers around it." -msgstr "" - -msgid "Return a tuple containing the id of the item just above *tagOrId* in the display list." -msgstr "" - -msgid "Return a tuple of the ids of all items in the canvas, in stacking order." -msgstr "" - -msgid "Return a tuple containing the id of the item just below *tagOrId* in the display list." -msgstr "" - -msgid "Return a tuple containing the id of the item closest to the point (*x*, *y*). *halo* and *start* are interpreted as for :meth:`addtag_closest`." -msgstr "" - -msgid "Return a tuple of the ids of all items completely enclosed within the rectangle (*x1*, *y1*, *x2*, *y2*)." -msgstr "" - -msgid "Return a tuple of the ids of all items that overlap or are enclosed within the rectangle (*x1*, *y1*, *x2*, *y2*)." -msgstr "" - -msgid "Return a tuple of the ids of all items given by *tagOrId*." -msgstr "" - -msgid "Move all items given by *tagOrId* to a new position in the display list just above the item given by *aboveThis*, or to the top of the display list if *aboveThis* is omitted. When several items are moved their relative order is preserved. This has no effect on embedded window items, whose stacking order is controlled by :meth:`Misc.tkraise` and :meth:`Misc.lower` instead. :meth:`lift` and :meth:`tkraise` are aliases of :meth:`!tag_raise`." -msgstr "" - -msgid "Move all items given by *tagOrId* to a new position in the display list just below the item given by *belowThis*, or to the bottom of the display list if *belowThis* is omitted. When several items are moved their relative order is preserved. This has no effect on embedded window items. :meth:`lower` is an alias of :meth:`!tag_lower`." -msgstr "" - -msgid "On a :class:`Canvas`, :meth:`tkraise`/:meth:`lift` and :meth:`lower` restack canvas items, shadowing the inherited :meth:`Misc.tkraise`/:meth:`Misc.lift` and :meth:`Misc.lower` methods that restack the widget itself, which are therefore not available." -msgstr "" - -msgid "Bind the callback *func* to the event *sequence* for all items given by *tagOrId*, so that *func* is invoked whenever that event occurs for one of the items. This is like :meth:`Widget.bind ` but operates on canvas items rather than on whole widgets; only mouse, keyboard and virtual events may be bound. Mouse events are directed to the current item and keyboard events to the focus item (see :meth:`focus`). If *add* is true the new binding is added to any existing bindings for the same sequence, rather than replacing them. Return the identifier of the bound function, which can be passed to :meth:`tag_unbind`." -msgstr "" - -msgid "Remove for all items given by *tagOrId* the binding for the event *sequence*. If *funcid* is given, only that callback (as returned by :meth:`tag_bind`) is unbound and deregistered." -msgstr "" - -msgid "If *funcid* is given, only that callback is unbound." -msgstr "" - -msgid "Return a 4-tuple ``(x1, y1, x2, y2)`` giving an approximate bounding box, in pixels, that encloses all the items given by *tagOrId* and any further *tagOrIds*. The result may overestimate the true bounding box by a few pixels. Return ``None`` if no item matches or the matching items have nothing to display." -msgstr "" - -msgid "This shadows the inherited :meth:`!Misc.bbox`; use :meth:`~Misc.grid_bbox` for the grid bounding box." -msgstr "" - -msgid "Given a window x-coordinate *screenx*, return the canvas x-coordinate displayed at that location. If *gridspacing* is given, the result is rounded to the nearest multiple of *gridspacing* units." -msgstr "" - -msgid "Given a window y-coordinate *screeny*, return the canvas y-coordinate displayed at that location. If *gridspacing* is given, the result is rounded to the nearest multiple of *gridspacing* units." -msgstr "" - -msgid "With *tagOrId*, set the keyboard focus for the canvas to the first item given by *tagOrId* that supports the insertion cursor; the focus is left unchanged if no such item exists. If *tagOrId* is an empty string, reset the focus so that no item has it. With no argument, return the id of the item that currently has the focus, or an empty string if none does. An item only displays the insertion cursor when both it is the focus item and its canvas has the input focus." -msgstr "" - -msgid "This shadows the inherited :meth:`!Misc.focus`; use :meth:`~Misc.focus_set` to focus the widget itself." -msgstr "" - -msgid "Set the insertion cursor of the items given by *tagOrId* to just before the character given by *index*. Items that do not support an insertion cursor are unaffected. The cursor is only displayed when the item has the focus, but its position may be set at any time." -msgstr "" - -msgid "Return as an integer the numerical index within *tagOrId* corresponding to *index*, which is a textual description of a position (for text items an index into the characters, for line and polygon items an index into the coordinates). If *tagOrId* matches several items, the first one that supports indexing is used." -msgstr "" - -msgid "Adjust the end of the selection in *tagOrId* nearest to *index* so that it is at *index*, and make the other end the anchor point for future :meth:`select_to` calls. If the selection is not currently in *tagOrId*, this behaves like :meth:`select_to`." -msgstr "" - -msgid "Clear the selection if it is in this canvas; otherwise do nothing." -msgstr "" - -msgid "Set the selection anchor point to just before the character given by *index* in the item given by *tagOrId*. This does not change the selection itself; it sets the fixed end for future :meth:`select_to` calls." -msgstr "" - -msgid "Return the id of the item that holds the selection, or ``None`` if the selection is not in this canvas. Unlike :meth:`find` and the ``find_*`` methods, this returns the id as a string rather than an integer." -msgstr "" - -msgid "Set the selection to the characters of *tagOrId* between the selection anchor point and *index*, inclusive of *index*. The anchor point is the one set by the most recent :meth:`select_adjust` or :meth:`select_from` call." -msgstr "" - -msgid "Record *x*, *y* and the current view, for use with later :meth:`scan_dragto` calls. This is typically bound to a mouse button press in the widget." -msgstr "" - -msgid "Scroll the canvas by *gain* times the difference between *x*, *y* and the coordinates passed to the last :meth:`scan_mark` call. This is typically bound to mouse motion events in the widget, producing the effect of dragging the canvas at high speed through its window." -msgstr "" - -msgid "Generate a PostScript (Encapsulated PostScript, version 3.0) representation of part or all of the canvas. If the *file* or *channel* option is given, the PostScript is written there and an empty string is returned; otherwise it is returned as a string. By default only the area currently visible in the window is generated, so it is usually necessary either to call :meth:`~Misc.update` first or to use the *width* and *height* options. Supported options include *colormap*, *colormode*, *file*, *fontmap*, *height*, *pageanchor*, *pageheight*, *pagewidth*, *pagex*, *pagey*, *rotate*, *width*, *x* and *y*." -msgstr "" - -msgid "A :class:`!Checkbutton` widget displays a textual string, bitmap or image together with a square indicator, and toggles a boolean selection when pressed. It has all the behavior of a simple button and, in addition, can be selected: when selected the indicator is drawn with a check mark and the associated variable is set to the ``onvalue``, and when deselected the indicator is drawn empty and the variable is set to the ``offvalue``. Inherits from :class:`Widget`. In addition to the standard widget options, a checkbutton accepts the options documented in the Tk ``checkbutton`` manual page, such as *variable*, *onvalue*, *offvalue* and *command*." -msgstr "" - -msgid "Do just what would happen if the user pressed the checkbutton with the mouse: toggle the selection state of the button and invoke the associated command, if there is one. Return the result of the command, or an empty string if no command is associated with the checkbutton. This is ignored if the checkbutton's state is ``disabled``." -msgstr "" - -msgid "Select the checkbutton and set the associated variable to its ``onvalue``." -msgstr "" - -msgid "Deselect the checkbutton and set the associated variable to its ``offvalue``." -msgstr "" - -msgid "Toggle the selection state of the button, redisplaying it and modifying its associated variable to reflect the new state." -msgstr "" - -msgid "Flash the checkbutton by redisplaying it several times, alternating between the active and normal colors. At the end of the flash the checkbutton is left in the same normal or active state as when the method was called. This is ignored if the checkbutton's state is ``disabled``." -msgstr "" - -msgid "An :class:`!Entry` widget displays a single line of text and lets the user edit it. Inherits from :class:`Widget` and :class:`XView`; since entries can hold strings too long to fit in the window, they support horizontal scrolling through :meth:`~XView.xview`." -msgstr "" - -msgid "In addition to the standard widget options, an entry accepts the options documented in the Tk ``entry`` manual page. Notable ones are *textvariable* (the name of a variable kept in sync with the entry's contents), *show* (if set, each character is displayed as the given character rather than its true value, useful for password entry), *validate* and *validatecommand* (which together let a callback accept or reject edits), and *state* (one of ``'normal'``, ``'disabled'`` or ``'readonly'``)." -msgstr "" - -msgid "Many of the methods below take an *index* argument that selects a character in the entry's string. As described in the Tk ``entry`` manual page, *index* may be a number (counting from 0), ``'insert'`` (the character just after the insertion cursor), ``'end'`` (just after the last character), ``'anchor'`` (the selection anchor point), ``'sel.first'`` and ``'sel.last'`` (the ends of the selection), or ``@x`` (the character covering pixel x-coordinate *x* in the window). Out-of-range indices are rounded to the nearest legal value." -msgstr "" - -msgid "Delete the characters from index *first* up to but not including index *last*. If *last* is omitted, only the single character at *first* is deleted." -msgstr "" - -msgid "Return the entry's current string." -msgstr "" - -msgid "Insert *string* just before the character given by *index*." -msgstr "" - -msgid "Arrange for the insertion cursor to be displayed just before the character given by *index*." -msgstr "" - -msgid "Return the numerical index corresponding to *index*." -msgstr "" - -msgid "Locate the end of the selection nearest to the character given by *index*, and adjust that end to be at *index* (including but not going beyond it); the other end becomes the anchor point for future :meth:`selection_to` calls. If there is no selection in the entry, a new one is created between *index* and the most recent anchor point, inclusive. :meth:`select_adjust` is an alias of :meth:`!selection_adjust`." -msgstr "" - -msgid "Clear the selection if it is currently in this widget. If the selection is not in this widget the method has no effect. :meth:`select_clear` is an alias of :meth:`!selection_clear`." -msgstr "" - -msgid "This shadows the inherited :meth:`Misc.selection_clear`, which clears the X selection; that method is not available on an :class:`Entry`." -msgstr "" - -msgid "Set the selection anchor point to just before the character given by *index*, without changing the selection. :meth:`select_from` is an alias of :meth:`!selection_from`." -msgstr "" - -msgid "Return ``True`` if there are characters selected in the entry, ``False`` otherwise. :meth:`select_present` is an alias of :meth:`!selection_present`." -msgstr "" - -msgid "Set the selection to include the characters starting with the one indexed by *start* and ending with the one just before *end*. If *end* refers to the same character as *start* or an earlier one, the selection is cleared. :meth:`select_range` is an alias of :meth:`!selection_range`." -msgstr "" - -msgid "Set the selection between the anchor point and *index*: if *index* is before the anchor point, the selection runs from *index* up to but not including the anchor; if *index* is after it, from the anchor up to but not including *index*; if they coincide, nothing happens. The anchor point is the one set by the most recent :meth:`selection_from` or :meth:`selection_adjust` call. If there is no selection in the entry, a new one is created using the most recent anchor point. :meth:`select_to` is an alias of :meth:`!selection_to`." -msgstr "" - -msgid "Record *x* and the current view in the entry window, for use with later :meth:`scan_dragto` calls. Typically associated with a mouse button press in the widget." -msgstr "" - -msgid "Compute the difference between *x* and the *x* given to the last :meth:`scan_mark` call, and adjust the view left or right by 10 times that difference. Typically associated with mouse motion events, to produce the effect of dragging the entry at high speed through the window." -msgstr "" - -msgid "A :class:`!Frame` widget is a simple container. Its primary purpose is to act as a spacer or container for complex window layouts; its only features are its background and an optional 3-D border to make the frame appear raised or sunken. Inherits from :class:`Widget`. Refer to the Tk ``frame`` manual page for the full list of options." -msgstr "" - -msgid "A :class:`!Label` widget displays a non-interactive textual string, bitmap or image. The displayed text is set with the *text* option or linked to a variable through *textvariable*, and an image can be shown using the *image* option. Text must all be in a single font but may occupy multiple lines, and one character may be underlined with the *underline* option. Inherits from :class:`Widget`. Refer to the Tk ``label`` manual page for the full list of options." -msgstr "" - -msgid "A :class:`!LabelFrame` widget is a container that has the features of a :class:`Frame` plus the ability to display a label. The label text is set with the *text* option and positioned with *labelanchor*, or an arbitrary widget may be used as the label by giving it as the *labelwidget* option. Inherits from :class:`Widget`. Refer to the Tk ``labelframe`` manual page for the full list of options." -msgstr "" - -msgid "A :class:`!Listbox` widget displays a list of single-line text items, one per line, of which the user can select one or more. The way the selection behaves is governed by the *selectmode* option, which is one of ``browse`` (the default; at most one item, which may be dragged with the mouse), ``single`` (at most one item), ``multiple`` (any number of items, toggled individually), or ``extended`` (any number of items, including discontiguous ranges, selected by clicking and dragging). Inherits from :class:`Widget`, :class:`XView` and :class:`YView`, so the view can be scrolled horizontally and vertically with :meth:`~XView.xview` and :meth:`~YView.yview`. Refer to the Tk ``listbox`` manual page for the full list of options." -msgstr "" - -msgid "Many of the methods take an *index* argument identifying a particular item. As described in the Tk ``listbox`` manual page, *index* may be a numeric index (counting from 0 at the top), ``'active'`` (the item with the location cursor, set with :meth:`activate`), ``'anchor'`` (the selection anchor, set with :meth:`selection_anchor`), ``'end'`` (the last item, or for :meth:`index` and :meth:`insert` the position just after it), or ``@x,y`` (the item covering pixel coordinates *x*, *y* in the listbox window). Arguments named *first* and *last* are indices of the same forms." -msgstr "" - -msgid "Insert the given *elements* as new items just before the item given by *index*. If *index* is ``'end'``, the new items are appended to the end of the list." -msgstr "" - -msgid "Delete the items in the range from *first* to *last* inclusive. If *last* is omitted, it defaults to *first*, so that a single item is deleted." -msgstr "" - -msgid "If *last* is omitted, return the contents of the item given by *first*, or an empty string if *first* refers to a non-existent item. If *last* is given, return a tuple of all the items in the range from *first* to *last* inclusive." -msgstr "" - -msgid "Return the total number of items in the listbox." -msgstr "" - -msgid "This shadows the inherited :meth:`!Misc.size`; use :meth:`~Misc.grid_size` for the grid size." -msgstr "" - -msgid "Return the integer index value corresponding to *index*, or ``None`` if *index* is out of range. If *index* is ``'end'``, the result is a count of the number of items in the listbox (not the index of the last item)." -msgstr "" - -msgid "Return a tuple ``(x, y, width, height)`` describing the bounding box, in pixels relative to the widget, of the text of the item given by *index*. Return ``None`` if no part of that item is visible on the screen, or if *index* refers to a non-existent item; if the item is only partly visible, the result still gives the full area of the item, including the parts that are not visible." -msgstr "" - -msgid "Given a y-coordinate within the listbox window, return the index of the visible item nearest to that y-coordinate." -msgstr "" - -msgid "Adjust the view so that the item given by *index* is visible. If the item is already visible the method has no effect; if it is near an edge of the window the listbox scrolls just enough to bring it into view at that edge, otherwise the listbox scrolls to center the item." -msgstr "" - -msgid "Set the active item to the one given by *index*. If *index* is outside the range of items, the closest item is activated instead. The active item is drawn as specified by the *activestyle* option when the widget has the input focus, and its index may be retrieved with the ``'active'`` index." -msgstr "" - -msgid "Return a tuple containing the numerical indices of all of the items that are currently selected, or an empty tuple if no items are selected." -msgstr "" - -msgid "Set the selection anchor to the item given by *index*. If *index* refers to a non-existent item, the closest item is used. The selection anchor is the end of the selection that is fixed while dragging out a selection with the mouse, and may afterwards be referred to with the ``'anchor'`` index. :meth:`select_anchor` is an alias of :meth:`!selection_anchor`." -msgstr "" - -msgid "Deselect any of the items in the range from *first* to *last* inclusive that are selected. The selection state of items outside this range is not changed. :meth:`select_clear` is an alias of :meth:`!selection_clear`." -msgstr "" - -msgid "This shadows the inherited :meth:`Misc.selection_clear`, which clears the X selection; that method is not available on a :class:`Listbox`." -msgstr "" - -msgid "Return ``True`` if the item given by *index* is currently selected, ``False`` otherwise. :meth:`select_includes` is an alias of :meth:`!selection_includes`." -msgstr "" - -msgid "Select all of the items in the range from *first* to *last* inclusive, without affecting the selection state of items outside that range. :meth:`select_set` is an alias of :meth:`!selection_set`." -msgstr "" - -msgid "Return the current value of the configuration option *option* for the item given by *index*." -msgstr "" - -msgid "Query or modify the configuration options of the item given by *index*. This mirrors :meth:`~Misc.configure`, except that it applies to an individual item rather than to the listbox as a whole. With no options, it returns a dictionary describing the current options of the item; otherwise it sets the given options. The supported item options are *background*, *foreground*, *selectbackground* and *selectforeground*. :meth:`itemconfig` is an alias of :meth:`!itemconfigure`." -msgstr "" - -msgid "Scroll the listbox by 10 times the difference between *x*, *y* and the coordinates passed to the last :meth:`scan_mark` call. This is typically bound to mouse motion events in the widget, producing the effect of dragging the list at high speed through the window." -msgstr "" - -msgid "A :class:`!Menu` widget displays a column of entries, each of which may be a command, a checkbutton, a radiobutton, a cascade (which posts an associated submenu) or a separator. Menus are used as the menubar of a toplevel window, as pulldown menus posted from a cascade entry or menubutton, and as popup menus. Inherits from :class:`Widget`." -msgstr "" - -msgid "Many of the entry methods take an *index* argument that selects which entry to operate on. As described in the Tk ``menu`` manual page, *index* may be a numeric index (counting from 0 at the top), ``'active'`` (the currently active entry), ``'end'`` or ``'last'`` (the bottommost entry), ``'none'`` (no entry at all, written ``{}`` in Tcl), ``@y`` (the entry covering pixel y-coordinate *y* in the menu window), or a pattern matched against the labels of the entries from the top down." -msgstr "" - -msgid "Add a new entry to the bottom of the menu. *itemType* is one of ``'command'``, ``'cascade'``, ``'checkbutton'``, ``'radiobutton'`` or ``'separator'`` and determines the type of the new entry; the remaining options configure it. The :meth:`!add_command`, :meth:`!add_cascade`, :meth:`!add_checkbutton`, :meth:`!add_radiobutton` and :meth:`!add_separator` convenience methods call this method with the corresponding *itemType*." -msgstr "" - -msgid "The entry is configured by the following options, although not every option applies to every entry type (a separator accepts none of them):" -msgstr "" - -msgid "*label*" -msgstr "" - -msgid "The text to display in the entry." -msgstr "" - -msgid "*command*" -msgstr "" - -msgid "The function to call when the entry is invoked (command, checkbutton and radiobutton entries)." -msgstr "" - -msgid "*accelerator*" -msgstr "" - -msgid "A string displayed at the right of the entry to advertise an accelerator keystroke; it does not itself create the binding." -msgstr "" - -msgid "The index of a character in the label to underline for keyboard traversal." -msgstr "" - -msgid "One of ``'normal'``, ``'active'`` or ``'disabled'``." -msgstr "" - -msgid "An image to display instead of, or together with, the text label." -msgstr "" - -msgid "*compound*" -msgstr "" - -msgid "Where to show the image relative to the text: ``'none'`` (the default), ``'text'``, ``'image'``, ``'top'``, ``'bottom'``, ``'left'`` or ``'right'``." -msgstr "" - -msgid "A bitmap to display instead of the text label." -msgstr "" - -msgid "The font to use for the text." -msgstr "" - -msgid "The entry's background and foreground colors in its normal state (ignored on macOS)." -msgstr "" - -msgid "*activebackground*, *activeforeground*" -msgstr "" - -msgid "The background and foreground colors used when the entry is active (ignored on macOS)." -msgstr "" - -msgid "*columnbreak*" -msgstr "" - -msgid "If true, the entry starts a new column instead of being placed below the previous entry." -msgstr "" - -msgid "*hidemargin*" -msgstr "" - -msgid "If true, the standard margin around the entry is omitted, which is useful when a menu is used as a palette." -msgstr "" - -msgid "*menu*" -msgstr "" - -msgid "The submenu posted by a cascade entry; it must be a child of this menu." -msgstr "" - -msgid "*variable*" -msgstr "" - -msgid "The variable associated with a checkbutton or radiobutton entry." -msgstr "" - -msgid "*onvalue*, *offvalue*" -msgstr "" - -msgid "The values stored in *variable* when a checkbutton entry is selected or cleared." -msgstr "" - -msgid "*value*" -msgstr "" - -msgid "The value stored in *variable* when a radiobutton entry is selected." -msgstr "" - -msgid "*indicatoron*" -msgstr "" - -msgid "Whether to display the indicator of a checkbutton or radiobutton entry." -msgstr "" - -msgid "*selectcolor*" -msgstr "" - -msgid "The color of the indicator of a checkbutton or radiobutton entry when it is selected." -msgstr "" - -msgid "*selectimage*" -msgstr "" - -msgid "The image displayed when a checkbutton or radiobutton entry is selected and *image* is also given." -msgstr "" - -msgid "Add a new cascade entry to the bottom of the menu. A cascade entry has an associated submenu, given by its *menu* option, which must be a child of this menu; posting the entry posts the submenu next to it." -msgstr "" - -msgid "Add a new checkbutton entry to the bottom of the menu. When invoked, a checkbutton entry toggles between its *onvalue* and *offvalue*, storing the result in its associated *variable*, and displays an indicator showing whether it is selected." -msgstr "" - -msgid "Add a new command entry to the bottom of the menu. A command entry behaves much like a button: when it is invoked, the callback given by its *command* option is called." -msgstr "" - -msgid "Add a new radiobutton entry to the bottom of the menu. Radiobutton entries sharing the same *variable* form a group of which only one may be selected at a time; selecting an entry stores its *value* in the variable." -msgstr "" - -msgid "Add a separator to the bottom of the menu. A separator is displayed as a horizontal dividing line and cannot be activated or invoked." -msgstr "" - -msgid "Same as :meth:`add`, except that the new entry is inserted just before the entry given by *index* instead of being appended to the end of the menu. *itemType* is one of ``'command'``, ``'cascade'``, ``'checkbutton'``, ``'radiobutton'`` or ``'separator'``. The :meth:`!insert_command`, :meth:`!insert_cascade`, :meth:`!insert_checkbutton`, :meth:`!insert_radiobutton` and :meth:`!insert_separator` convenience methods call this method with the corresponding *itemType*." -msgstr "" - -msgid "Insert a new cascade entry before the entry given by *index* (see :meth:`add_cascade`)." -msgstr "" - -msgid "Insert a new checkbutton entry before the entry given by *index* (see :meth:`add_checkbutton`)." -msgstr "" - -msgid "Insert a new command entry before the entry given by *index* (see :meth:`add_command`)." -msgstr "" - -msgid "Insert a new radiobutton entry before the entry given by *index* (see :meth:`add_radiobutton`)." -msgstr "" - -msgid "Insert a separator before the entry given by *index* (see :meth:`add_separator`)." -msgstr "" - -msgid "Delete all of the menu entries between *index1* and *index2* inclusive. If *index2* is omitted, it defaults to *index1*, so that a single entry is deleted. Attempts to delete a tear-off entry are ignored; remove it by changing the *tearoff* option instead." -msgstr "" - -msgid "Return the current value of the configuration option *option* for the entry given by *index*." -msgstr "" - -msgid "Query or modify the configuration options of the entry given by *index*. This mirrors :meth:`~Misc.configure`, except that it applies to an individual entry rather than to the menu as a whole. With no options, it returns a dictionary describing the current options of the entry; otherwise it sets the given options. The supported options are those accepted by :meth:`add` for the entry's type. :meth:`entryconfig` is an alias of :meth:`!entryconfigure`." -msgstr "" - -msgid "Return the numerical index corresponding to *index*, or ``None`` if *index* selects no entry." -msgstr "" - -msgid "Return the type of the entry given by *index*: one of ``'command'``, ``'cascade'``, ``'checkbutton'``, ``'radiobutton'``, ``'separator'`` or ``'tearoff'`` (for the tear-off entry)." -msgstr "" - -msgid "Make the entry given by *index* the active entry, redisplaying it with its active colors, and deactivate any previously active entry. If *index* selects no entry, or the selected entry is disabled, the menu ends up with no active entry." -msgstr "" - -msgid "Invoke the action of the entry given by *index*, as if it had been clicked. Nothing happens if the entry is disabled. If the entry has a *command* associated with it, the result of that command is returned; otherwise the result is an empty string." -msgstr "" - -msgid "Display the menu on the screen at the root-window coordinates *x* and *y*, adjusting them if necessary so that the whole menu is visible. If the *postcommand* option has been specified, it is evaluated before the menu is posted." -msgstr "" - -msgid "Post the menu as a popup at the root-window coordinates *x* and *y*. If *entry* is given, the menu is positioned so that this entry is displayed under the pointer." -msgstr "" - -msgid "Unmap the menu so that it is no longer displayed, also unposting any posted lower-level cascaded submenu. This has no effect on Windows and macOS, which manage the unposting of menus themselves." -msgstr "" - -msgid "Return the x-coordinate, within the menu window, of the leftmost pixel of the entry given by *index*." -msgstr "" - -msgid "Return the y-coordinate, within the menu window, of the topmost pixel of the entry given by *index*." -msgstr "" - -msgid "A :class:`!Menubutton` widget displays a textual string, bitmap or image and posts an associated :class:`Menu`, given by its *menu* option, when the user presses it. Like a :class:`Label` it can show *text*, a *textvariable*, or an *image*, and the *direction* option controls where the menu appears relative to the button. Inherits from :class:`Widget`. Refer to the Tk ``menubutton`` manual page for the full list of options." -msgstr "" - -msgid "A :class:`!Message` widget displays a non-interactive textual string, given by the *text* option or linked to a variable through *textvariable*. Unlike a :class:`Label`, it breaks the string into multiple lines in order to produce a given aspect ratio, choosing line breaks at word boundaries, and it can justify the text left, centered or right. Inherits from :class:`Widget`. Refer to the Tk ``message`` manual page for the full list of options." -msgstr "" - -msgid "A helper subclass of :class:`Menubutton` that displays a pop-up menu of mutually exclusive choices. *variable* is a :class:`Variable` kept in sync with the selection, *value* is the initial choice, and *values* are the remaining menu entries. The keyword argument *command* may be given a callback that is invoked with the selected value, and the keyword argument *name* sets the Tk widget name." -msgstr "" - -msgid "Destroy the widget, also cleaning up the associated pop-up menu." -msgstr "" - -msgid "Added support for the *name* keyword argument." -msgstr "" - -msgid "A :class:`!PanedWindow` is a geometry-manager widget that arranges any number of child *panes* in a row (when *orient* is ``'horizontal'``) or a column (when *orient* is ``'vertical'``). Each pane holds one widget, and each pair of adjacent panes is separated by a movable *sash* that the user can drag with the mouse to resize the widgets on either side of it. Inherits from :class:`Widget`." -msgstr "" - -msgid "The *orient* option selects the layout direction, *sashwidth* sets the width of each sash and *sashrelief* its relief. When *showhandle* is true a small handle is drawn on each sash that the user can grab to drag it. Refer to the Tk ``panedwindow`` manual page for the full list of options." -msgstr "" - -msgid "Add *child* to the panedwindow as a new pane, placed after any existing panes. The keyword arguments specify per-pane management options for *child*; they may be any of the options accepted by :meth:`paneconfigure`." -msgstr "" - -msgid "Remove the pane containing *child* from the panedwindow. All geometry management options for *child* are forgotten. :meth:`forget` is an alias of :meth:`!remove`. This shadows the inherited geometry-manager :meth:`!forget`; use :meth:`~Pack.pack_forget`, :meth:`~Grid.grid_forget` or :meth:`~Place.place_forget` to remove the widget itself from its manager." -msgstr "" - -msgid "Return a tuple of the widgets managed by the panedwindow, one per pane, in order." -msgstr "" - -msgid "Return the current value of the management option *option* for the pane containing *child*. *option* may be any value allowed by :meth:`paneconfigure`." -msgstr "" - -msgid "Query or modify the management options of the pane containing the widget *tagOrId*. With no options, it returns a dictionary describing all of the available options for the pane; given a single option name as a string, it returns a description of that one option; otherwise it sets the given options. The supported options include *after* and *before* (insert the pane after or before another managed window), *height* and *width* (the outer dimensions of the window, including any border), *minsize* (the minimum size in the paned dimension), *padx* and *pady* (extra space to leave on each side of the window), *sticky* (position or stretch the window within an oversized pane, using a string of the characters ``n``, ``s``, ``e`` and ``w``), *hide* (hide the pane while keeping it in the list of panes) and *stretch* (how extra space is allocated to the pane: one of ``'always'``, ``'first'``, ``'last'``, ``'middle'`` or ``'never'``). :meth:`paneconfig` is an alias of :meth:`!paneconfigure`." -msgstr "" - -msgid "Identify the panedwindow component underneath the point given by *x* and *y*, in window coordinates. If the point is over a sash or a sash handle, the result is a two-element tuple containing the index of the sash or handle and a word indicating whether it is over a sash or a handle, such as ``(0, 'sash')`` or ``(2, 'handle')``. If the point is over any other part of the panedwindow, the result is an empty string." -msgstr "" - -msgid "Query or change the position of the sashes in the panedwindow. This is a thin wrapper around the Tk ``sash`` subcommand; the convenience methods :meth:`sash_coord`, :meth:`sash_mark` and :meth:`sash_place` should normally be used instead." -msgstr "" - -msgid "Return the current x and y coordinate pair for the sash given by *index*, which must be an integer between 0 and one less than the number of panes in the panedwindow. The coordinates returned are those of the top left corner of the region containing the sash." -msgstr "" - -msgid "Record the current mouse position for the sash given by *index*, for use together with later sash-drag operations to move the sash." -msgstr "" - -msgid "Place the sash given by *index* at the coordinates *x* and *y*." -msgstr "" - -msgid "Query or change the position of the sash proxy, the \"ghost\" sash shown while a sash is being dragged with non-opaque resizing. This is a thin wrapper around the Tk ``proxy`` subcommand; the convenience methods :meth:`proxy_coord`, :meth:`proxy_forget` and :meth:`proxy_place` should normally be used instead." -msgstr "" - -msgid "Return a tuple containing the x and y coordinates of the most recent proxy location." -msgstr "" - -msgid "Remove the proxy from the display." -msgstr "" - -msgid "Place the proxy at the coordinates *x* and *y*." -msgstr "" - -msgid "A :class:`!Radiobutton` widget displays a textual string, bitmap or image together with a diamond or circular indicator, and selects one choice out of several. It has all the behavior of a simple button and, in addition, can be selected: typically several radiobuttons share a single *variable*, and selecting one sets that variable to the radiobutton's *value*; each radiobutton also monitors the variable and automatically selects or deselects itself when the variable changes. Inherits from :class:`Widget`. In addition to the standard widget options, a radiobutton accepts the options documented in the Tk ``radiobutton`` manual page, such as *variable*, *value* and *command*." -msgstr "" - -msgid "Do just what would happen if the user pressed the radiobutton with the mouse: select the button and invoke the associated command, if there is one. Return the result of the command, or an empty string if no command is associated with the radiobutton. This is ignored if the radiobutton's state is ``disabled``." -msgstr "" - -msgid "Select the radiobutton and set the associated variable to the value corresponding to this widget." -msgstr "" - -msgid "Deselect the radiobutton and set the associated variable to an empty string. If this radiobutton was not currently selected, this has no effect." -msgstr "" - -msgid "Flash the radiobutton by redisplaying it several times, alternating between the active and normal colors. At the end of the flash the radiobutton is left in the same normal or active state as when the method was called. This is ignored if the radiobutton's state is ``disabled``." -msgstr "" - -msgid "A :class:`!Scale` widget lets the user select a numerical value by moving a slider along a trough. It can be oriented vertically or horizontally and can optionally display a label and the current value. Inherits from :class:`Widget`." -msgstr "" - -msgid "In addition to the standard widget options, a scale accepts the options documented in the Tk ``scale`` manual page, such as *from_*, *to*, *resolution*, *orient*, *tickinterval*, *variable* and *command*. As elsewhere in :mod:`!tkinter`, the leading ``-`` of the Tk option name is dropped; *from* is spelled ``from_`` because :keyword:`from` is a Python keyword." -msgstr "" - -msgid "With a non-integer *resolution*, see :ref:`numeric values and the locale `." -msgstr "" - -msgid "Return the current value of the scale. The result is an integer if the scale's *resolution* yields whole numbers, and a float otherwise." -msgstr "" - -msgid "Set the scale to *value*, moving the slider accordingly. This has no effect if the scale is disabled." -msgstr "" - -msgid "Return a tuple ``(x, y)`` giving the pixel coordinates, relative to the widget, of the point on the centerline of the trough that corresponds to *value*. If *value* is omitted, the scale's current value is used." -msgstr "" - -msgid "Return a string describing the part of the scale at the pixel coordinates *x*, *y*: ``'slider'``, ``'trough1'`` (the part of the trough above or to the left of the slider), ``'trough2'`` (below or to the right of the slider), or an empty string if the point is not over any of these elements." -msgstr "" - -msgid "A :class:`!Scrollbar` widget displays a slider and two arrows that let the user scroll an associated widget, such as a :class:`Listbox`, :class:`Text`, :class:`Canvas` or :class:`Entry`. It is connected to the scrolled widget by setting that widget's *xscrollcommand* or *yscrollcommand* option to the scrollbar's :meth:`set` method, and the scrollbar's *command* option to the scrolled widget's :meth:`~XView.xview` or :meth:`~YView.yview` method. Inherits from :class:`Widget`." -msgstr "" - -msgid "Return the current scrollbar settings as a tuple ``(first, last)`` of two fractions between 0 and 1, describing the portion of the document that is currently visible, as last passed to :meth:`set`." -msgstr "" - -msgid "Set the scrollbar. *first* and *last* are fractions between 0 and 1 giving the positions of the start and end of the visible portion of the associated document. This method is normally registered as the scrolled widget's *xscrollcommand* or *yscrollcommand* and called by that widget." -msgstr "" - -msgid "Mark the element *index* (one of ``'arrow1'``, ``'slider'`` or ``'arrow2'``) as active, displaying it according to the *activebackground* and *activerelief* options. If *index* is omitted, return the name of the currently active element, or ``None`` if no element is active." -msgstr "" - -msgid "The *index* argument is now optional." -msgstr "" - -msgid "Return a float indicating the fractional change in the scrollbar setting that corresponds to moving the slider by *deltax* pixels horizontally (for horizontal scrollbars) or *deltay* pixels vertically (for vertical scrollbars)." -msgstr "" - -msgid "Return a float between 0 and 1 indicating where the point at pixel coordinates *x*, *y* lies in the trough: 0 corresponds to the top or left of the trough and 1 to the bottom or right." -msgstr "" - -msgid "Return the name of the element under the pixel coordinates *x*, *y* (such as ``'arrow1'``), or an empty string if the point does not lie in any element of the scrollbar." -msgstr "" - -msgid "A :class:`!Spinbox` widget is an :class:`Entry`-like widget with a pair of up/down arrow buttons that let the user step through a range of values in addition to editing the value directly. The set of values may be a numeric range given by the *from_*, *to* and *increment* options, or an explicit list of strings given by the *values* option (which takes precedence over the range). Each time an arrow is invoked the *command* callback, if any, is called; the *wrap* option controls whether stepping past either end of the range wraps around to the other end; the *format* option specifies how numeric values are formatted; and the *validate* option enables validation of the entered text. Inherits from :class:`Widget` and :class:`XView`." -msgstr "" - -msgid "With a non-integer *increment*, see :ref:`numeric values and the locale `." -msgstr "" - -msgid "Many of the methods take an *index* argument identifying a character in the spinbox's string. As described in the Tk ``spinbox`` manual page, *index* may be a numeric index (counting from 0), ``'anchor'`` (the selection anchor point), ``'end'`` (just after the last character), ``'insert'`` (the character just after the insertion cursor), ``'sel.first'`` or ``'sel.last'`` (the ends of the selection), or ``@x`` (the character covering pixel x-coordinate *x* in the window)." -msgstr "" - -msgid "Return the spinbox's string." -msgstr "" - -msgid "Insert the characters of the string *s* just before the character given by *index*." -msgstr "" - -msgid "Delete one or more characters of the spinbox. *first* is the index of the first character to delete, and *last* is the index of the character just after the last one to delete. If *last* is omitted, a single character at *first* is deleted." -msgstr "" - -msgid "Return the numerical index corresponding to *index*, as a string." -msgstr "" - -msgid "Return a tuple of four integers ``(x, y, width, height)`` describing the bounding box of the character given by *index*. *x* and *y* are the pixel coordinates of the upper-left corner of the character relative to the widget, and *width* and *height* are its size in pixels. The bounding box may refer to a region outside the visible area of the window." -msgstr "" - -msgid "Return the name of the window element at the pixel coordinates *x*, *y*: one of ``'buttondown'``, ``'buttonup'``, ``'entry'`` or ``'none'``." -msgstr "" - -msgid "Invoke the spin button given by *element*, either ``'buttonup'`` or ``'buttondown'``, triggering the action associated with it." -msgstr "" - -msgid "A thin wrapper around the Tk ``scan`` widget subcommand, used to implement fast dragging of the view: ``scan('mark', x)`` records *x* and the current view, and ``scan('dragto', x)`` adjusts the view relative to that mark. The :meth:`scan_mark` and :meth:`scan_dragto` methods wrap the two forms." -msgstr "" - -msgid "Record *x* and the current view in the spinbox window, for use with a later :meth:`scan_dragto` call. This is typically associated with a mouse button press in the widget." -msgstr "" - -msgid "Adjust the view by 10 times the difference between *x* and the *x* passed to the last :meth:`scan_mark` call. This is typically associated with mouse motion events, producing the effect of dragging the spinbox at high speed through the window." -msgstr "" - -msgid "A thin wrapper around the Tk ``selection`` widget subcommand, used to adjust the selection within the spinbox. It has several forms depending on the first argument, such as ``selection('adjust', index)``, ``selection('clear')``, ``selection('element', ?elem?)``, ``selection('from', index)``, ``selection('present')``, ``selection('range', start, end)`` and ``selection('to', index)``. The :meth:`selection_adjust`, :meth:`selection_clear`, :meth:`selection_element`, :meth:`selection_from`, :meth:`selection_present`, :meth:`selection_range` and :meth:`selection_to` methods wrap these forms." -msgstr "" - -msgid "Locate the end of the selection nearest to the character given by *index* and adjust that end of the selection to be at *index* (including but not going beyond *index*). The other end becomes the anchor point for future :meth:`selection_to` calls. If the selection is not currently in the spinbox, a new selection is created to include the characters between *index* and the most recent anchor point, inclusive." -msgstr "" - -msgid "Clear the selection if it is currently in this widget. If the selection is not in this widget, the method has no effect." -msgstr "" - -msgid "This shadows the inherited :meth:`Misc.selection_clear`, which clears the X selection; that method is not available on a :class:`Spinbox`." -msgstr "" - -msgid "Set or get the currently selected element. If *element* (one of ``'buttonup'``, ``'buttondown'`` or ``'none'``) is given, that spin button is selected and displayed depressed; otherwise the name of the currently selected element is returned." -msgstr "" - -msgid "Set the selection anchor point to just before the character given by *index*, without changing the selection itself." -msgstr "" - -msgid "Return ``True`` if there are characters selected in the spinbox, ``False`` otherwise." -msgstr "" - -msgid "Set the selection to include the characters starting with the one indexed by *start* and ending with the one just before *end*. If *end* refers to the same character as *start* or an earlier one, the selection is cleared." -msgstr "" - -msgid "Set the selection between *index* and the anchor point. If *index* is before the anchor point, the selection runs from *index* up to but not including the anchor point; if it is after, the selection runs from the anchor point up to but not including *index*; if it is the same, nothing happens. The anchor point is the one set by the most recent :meth:`selection_from` or :meth:`selection_adjust` call. If the selection is not in this widget, a new selection is created using the most recent anchor point." -msgstr "" - -msgid "A :class:`!Text` widget displays and edits multi-line text. Portions of the text may be styled with **tags**, particular positions may be annotated with floating **marks**, and arbitrary images and other widgets may be embedded in the text. The widget also provides an unlimited undo/redo mechanism and supports peer widgets that share the same underlying data. Inherits from :class:`Widget`, :class:`XView` and :class:`YView`, so the view can be scrolled horizontally and vertically with :meth:`~XView.xview` and :meth:`~YView.yview`. Refer to the Tk ``text`` manual page for the full list of options." -msgstr "" - -msgid "Most of the methods take one or more *index* arguments that identify a position within the text. As described in the Tk ``text`` manual page, an index is a string consisting of a base, optionally followed by one or more modifiers. The base may be ``'line.char'`` (line *line*, character *char*, where lines are counted from 1 and characters within a line from 0; ``'line.end'`` refers to the newline ending the line), ``'end'`` (the position just after the last newline), the name of a mark, ``'tag.first'`` or ``'tag.last'`` (the first character tagged with *tag*, or the position just after the last such character), the name of an embedded image or window, or ``@x,y`` (the character covering pixel coordinates *x*, *y* in the widget). A modifier such as ``'+5 chars'``, ``'-3 lines'``, ``'linestart'``, ``'lineend'``, ``'wordstart'`` or ``'wordend'`` adjusts the index relative to its base; several modifiers may be combined and are applied from left to right, for example ``'insert wordstart - 1 c'``." -msgstr "" - -msgid "Insert the string *chars* just before the character at *index* (if *index* is ``'end'``, just before the final newline). By default the new text inherits any tags present on both sides of the insertion point. If *args* is given, it consists of alternating *tagList*, *chars* values: the preceding *chars* receives exactly the tags listed (a tag list may be a single tag name or a sequence of names), overriding the surrounding tags." -msgstr "" - -msgid "Delete the range of characters from *index1* up to but not including *index2*. If *index2* is omitted, the single character at *index1* is deleted. The widget always keeps a newline as its last character, so a deletion that would remove it is adjusted accordingly." -msgstr "" - -msgid "Replace the range of characters from *index1* up to but not including *index2* with *chars*. This is equivalent to a :meth:`delete` followed by an :meth:`insert` at *index1*; *args* is interpreted as for :meth:`insert`." -msgstr "" - -msgid "Return the text from *index1* up to but not including *index2* as a string. If *index2* is omitted, return the single character at *index1*. Embedded images and windows are omitted from the result." -msgstr "" - -msgid "Return the position corresponding to *index* in the canonical ``'line.char'`` form." -msgstr "" - -msgid "Compare the positions of *index1* and *index2* using the relational operator *op*, which must be one of ``'<'``, ``'<='``, ``'=='``, ``'>='``, ``'>'`` or ``'!='``, and return the boolean result." -msgstr "" - -msgid "Count the number of items of the requested kinds between *index1* and *index2*; the count is negative if *index1* is after *index2*. Each of *options* names a kind of item to count: ``'chars'``, ``'displaychars'``, ``'displayindices'``, ``'displaylines'``, ``'indices'``, ``'lines'``, ``'xpixels'`` or ``'ypixels'`` (the default, used when no option is given, is ``'indices'``). The pseudo-option ``'update'`` forces any out-of-date layout information to be recalculated before the following options are evaluated. When *return_ints* is true and a single counting option is given, return a plain integer; otherwise return a tuple with one integer per counting option (or ``None`` if the result is empty)." -msgstr "" - -msgid "Added the *return_ints* parameter." -msgstr "" - -msgid "Adjust the view so that the character given by *index* is visible. If it is already visible the method has no effect; if it is a short distance out of view the widget scrolls just enough to bring it to the nearest edge, otherwise it scrolls to center *index* in the window." -msgstr "" - -msgid "Return a tuple ``(x, y, width, height)`` giving the bounding box, in pixels, of the visible part of the character at *index*, or ``None`` if that character is not visible on the screen." -msgstr "" - -msgid "Return a tuple ``(x, y, width, height, baseline)`` describing the display line that contains *index*: the first four values give the bounding box of the line in pixels and *baseline* gives the offset of the baseline measured down from the top of the area. Return ``None`` if that display line is not visible on the screen." -msgstr "" - -msgid "Set the mark named *markName* to the position just before the character at *index*, creating the mark if it does not already exist. A mark created this way has right gravity by default." -msgstr "" - -msgid "Remove each of the marks named in *markNames*. The special ``insert`` and ``current`` marks may not be removed." -msgstr "" - -msgid "Return a tuple of the names of all marks currently set in the widget." -msgstr "" - -msgid "If *direction* is omitted, return the gravity of mark *markName*, either ``'left'`` or ``'right'``. Otherwise set its gravity to *direction*. The gravity determines on which side of the mark text inserted at the mark's position appears: a mark with right gravity (the default) stays to the right of such text." -msgstr "" - -msgid "Return the name of the first mark at or after *index*, or ``None`` if there is none. When *index* is the name of a mark, the search starts just after that mark." -msgstr "" - -msgid "Return the name of the last mark at or before *index*, or ``None`` if there is none. When *index* is the name of a mark, the search starts just before that mark." -msgstr "" - -msgid "Add the tag *tagName* to the range of characters from *index1* up to but not including the next index in *args*. Further pairs of indices may follow in *args* to tag additional ranges; a trailing single index tags just the character at that index." -msgstr "" - -msgid "Remove the tag *tagName* from the characters from *index1* up to but not including *index2* (or from the single character at *index1* if *index2* is omitted). The tag itself continues to exist even if no characters carry it." -msgstr "" - -msgid "Delete each of the tags named in *tagNames*, removing them from all characters and discarding their options and bindings." -msgstr "" - -msgid "Query or modify the configuration options of the tag *tagName*. This mirrors :meth:`~Misc.configure`, except that it applies to a tag rather than to the widget as a whole: with no options it returns a dictionary describing the current options, otherwise it sets the given options. Defining a tag this way also gives it a priority higher than any existing tag." -msgstr "" - -msgid "The supported tag options, all controlling the appearance of the tagged text, are:" -msgstr "" - -msgid "*foreground*" -msgstr "" - -msgid "The color to use for the text." -msgstr "" - -msgid "*background*" -msgstr "" - -msgid "The color to use for the area behind the text." -msgstr "" - -msgid "*fgstipple*, *bgstipple*" -msgstr "" - -msgid "Bitmaps used to stipple the foreground (text) and the background; only well supported on X11." -msgstr "" - -msgid "*borderwidth*" -msgstr "" - -msgid "The width of the border drawn around the text according to *relief* (default ``0``)." -msgstr "" - -msgid "*relief*" -msgstr "" - -msgid "The 3-D appearance of the text's border: ``'flat'`` (the default), ``'raised'``, ``'sunken'``, ``'ridge'``, ``'groove'`` or ``'solid'``." -msgstr "" - -msgid "*offset*" -msgstr "" - -msgid "How far the text is raised above (or, if negative, lowered below) the baseline, for superscripts and subscripts." -msgstr "" - -msgid "Whether to underline the text." -msgstr "" - -msgid "*underlinefg*" -msgstr "" - -msgid "The color of the underline; it defaults to the text color." -msgstr "" - -msgid "*overstrike*" -msgstr "" - -msgid "Whether to draw a line through the middle of the text." -msgstr "" - -msgid "*overstrikefg*" -msgstr "" - -msgid "The color of the overstrike line; it defaults to the text color." -msgstr "" - -msgid "*elide*" -msgstr "" - -msgid "Whether the text is elided (hidden)." -msgstr "" - -msgid "How to justify the first character of a display line: ``'left'`` (the default), ``'right'`` or ``'center'``." -msgstr "" - -msgid "*wrap*" -msgstr "" - -msgid "How to wrap lines that are too long: ``'char'``, ``'word'`` or ``'none'``." -msgstr "" - -msgid "*lmargin1*, *lmargin2*" -msgstr "" - -msgid "The indentation, in pixels, of the first display line of a logical line and of the remaining display lines." -msgstr "" - -msgid "*lmargincolor*" -msgstr "" - -msgid "The color of the left margin area." -msgstr "" - -msgid "*rmargin*" -msgstr "" - -msgid "The right-hand margin, in pixels." -msgstr "" - -msgid "*rmargincolor*" -msgstr "" - -msgid "The color of the right margin area." -msgstr "" - -msgid "*spacing1*, *spacing2*, *spacing3*" -msgstr "" - -msgid "Extra space, in pixels, above the first display line of a logical line, between its display lines, and below its last display line." -msgstr "" - -msgid "*tabs*" -msgstr "" - -msgid "The set of tab stops, in the same form as the widget's *tabs* option." -msgstr "" - -msgid "*tabstyle*" -msgstr "" - -msgid "How tab stops are interpreted: ``'tabular'`` or ``'wordprocessor'``." -msgstr "" - -msgid "*selectbackground*, *selectforeground*" -msgstr "" - -msgid "The background and foreground colors used for the text while it is selected." -msgstr "" - -msgid "Tk 8.6 added the *lmargincolor*, *overstrikefg*, *rmargincolor*, *selectbackground*, *selectforeground* and *underlinefg* options." -msgstr "" - -msgid ":meth:`tag_config` is an alias of :meth:`!tag_configure`." -msgstr "" - -msgid "Return the current value of the configuration option *option* for the tag *tagName*." -msgstr "" - -msgid "If *index* is omitted, return a tuple of the names of all tags defined in the widget; otherwise return only the names of the tags applied to the character at *index*. The names are ordered from lowest to highest priority." -msgstr "" - -msgid "Return a tuple of indices describing all ranges of text tagged with *tagName*. The result alternates start and end indices, so that elements ``2*i`` and ``2*i+1`` bound the *i*-th range." -msgstr "" - -msgid "Search forward from *index1* (up to *index2* if given) for the first range of characters tagged with *tagName*, and return a two-element tuple of its start and end indices, or an empty tuple if there is no such range." -msgstr "" - -msgid "Search backward from *index1* (down to *index2* if given) for the nearest preceding range of characters tagged with *tagName*, and return a two-element tuple of its start and end indices, or an empty tuple if there is no such range." -msgstr "" - -msgid "Raise the priority of tag *tagName* so that it is just above the priority of *aboveThis*, or to the highest priority of all tags if *aboveThis* is omitted. When the display options of overlapping tags conflict, the higher-priority tag wins." -msgstr "" - -msgid "Lower the priority of tag *tagName* so that it is just below the priority of *belowThis*, or to the lowest priority of all tags if *belowThis* is omitted." -msgstr "" - -msgid "Bind the event *sequence* on characters tagged with *tagName* to the callback *func*, so that *func* is invoked when that event occurs over such a character. If *add* is true the binding is added alongside any existing bindings for *sequence*, otherwise it replaces them. Works like :meth:`~Misc.bind` and returns the identifier of the new binding." -msgstr "" - -msgid "Remove the bindings of the event *sequence* on characters tagged with *tagName*. If *funcid* is given, only that binding (as returned by :meth:`tag_bind`) is removed and its callback is unregistered." -msgstr "" - -msgid "Embed an image at *index* and return the name assigned to this image instance, which may then be used as an index or passed to the other ``image_*`` methods. The options, given in *cnf* and *kw*, include *image* (the Tk image to display), *name* (a base name for the instance), *align*, *padx* and *pady*." -msgstr "" - -msgid "Return the current value of the configuration option *option* for the embedded image at *index*." -msgstr "" - -msgid "Query or modify the configuration options of the embedded image at *index*, like :meth:`~Misc.configure` but applied to that image." -msgstr "" - -msgid "Return a tuple of the names of all images embedded in the widget." -msgstr "" - -msgid "This shadows the inherited :meth:`Misc.image_names`, which returns the names of all images in the Tcl interpreter; that method is not available on a :class:`Text`." -msgstr "" - -msgid "Embed a window (any widget) at *index*. The options, given in *cnf* and *kw*, include *window* (the widget to embed), *create* (a callback that creates the widget on demand), *align*, *stretch*, *padx* and *pady*. The embedded widget must be a descendant of the text widget's parent." -msgstr "" - -msgid "Return the current value of the configuration option *option* for the embedded window at *index*." -msgstr "" - -msgid "Query or modify the configuration options of the embedded window at *index*, like :meth:`~Misc.configure` but applied to that window." -msgstr "" - -msgid ":meth:`window_config` is an alias of :meth:`!window_configure`." -msgstr "" - -msgid "Return a tuple of the names of all windows embedded in the widget." -msgstr "" - -msgid "Low-level wrapper around the Tk ``edit`` widget command that controls the undo/redo mechanism and the modified flag; *args* is the ``edit`` subcommand and its arguments. The :meth:`!edit_\\*` methods below are thin wrappers around it and are usually more convenient." -msgstr "" - -msgid "If *arg* is omitted, return the current state of the modified flag as true or false; the flag is set automatically whenever the text is inserted or deleted. Otherwise set the flag to the boolean *arg*." -msgstr "" - -msgid "Undo the most recent edit action, that is, all the inserts and deletes recorded on the undo stack since the previous separator, and move it to the redo stack. Raises :exc:`TclError` if the undo stack is empty. Has no effect unless the *undo* option is true. Since Tk 9.0, returns a tuple of indices delimiting the ranges of text that were changed." -msgstr "" - -msgid "Reapply the most recently undone edit action, provided no further edits have been made since, and move it back to the undo stack. Raises :exc:`TclError` if the redo stack is empty. Has no effect unless the *undo* option is true. Since Tk 9.0, returns a tuple of indices delimiting the ranges of text that were changed." -msgstr "" - -msgid "Clear the undo and redo stacks." -msgstr "" - -msgid "Push a separator onto the undo stack, marking a boundary between edit actions for undo and redo. Has no effect unless the *undo* option is true. Separators are inserted automatically when the *autoseparators* option is true." -msgstr "" - -msgid "Search for *pattern* starting at *index* and return the index of the first character of the first match, or an empty string if there is no match. Searching stops at *stopindex* if given; otherwise it wraps around the ends of the text until the starting position is reached again. The following boolean keyword flags control the search: *forwards* or *backwards* select the direction (forward is the default); *exact* (the default) or *regexp* select literal or regular-expression matching; *nocase* makes the match case-insensitive; and *elide* causes hidden text to be searched as well. If *count* is a :class:`Variable`, the number of index positions in the match is stored in it." -msgstr "" - -msgid "Scroll the widget by 10 times the difference between *x*, *y* and the coordinates passed to the last :meth:`scan_mark` call. This is typically bound to mouse motion events, producing the effect of dragging the text at high speed through the window." -msgstr "" - -msgid "If *boolean* is omitted, return whether internal consistency checks of the B-tree data structure are enabled. Otherwise enable or disable them. The setting is shared by all text widgets and may noticeably slow down widgets holding large amounts of text." -msgstr "" - -msgid "Return the contents of the widget from *index1* up to but not including *index2* (or just the segment at *index1* if *index2* is omitted), including text and information about marks, tags, images and windows. The result is a list of ``(key, value, index)`` triples, where *key* is one of ``'text'``, ``'mark'``, ``'tagon'``, ``'tagoff'``, ``'image'`` or ``'window'``. By default all kinds are reported; passing any of the keyword arguments *all*, *text*, *mark*, *tag*, *image* or *window* as true restricts the dump to the selected kinds. If *command* is given, it is called once per triple with the three values as arguments and nothing is returned." -msgstr "" - -msgid "Create a peer text widget with the path name *newPathName* that shares this widget's underlying data (text, marks, tags, images and the undo stack). Changes made through any peer are reflected in all of them. By default the peer covers the same lines as this widget; standard text options, including *startline* and *endline*, may be given to override this." -msgstr "" - -msgid "Return a tuple of the path names of this widget's peers, not including the widget itself." -msgstr "" - -msgid "Adjust the view so that the location given by *what* is visible. This is an obsolete equivalent of :meth:`see`, which should be used instead." -msgstr "" - -msgid "Variable classes" -msgstr "" - -msgid "The base class for the Tk variable wrappers. A Tk variable is a value stored in the Tcl interpreter that can be linked to widgets through their *variable* or *textvariable* options (see :ref:`coupling-widget-variables`), so that changes propagate both ways: updating the variable updates every widget bound to it, and a user editing such a widget updates the variable." -msgstr "" - -msgid "*master* is the widget whose Tcl interpreter owns the variable; if omitted, the default root window is used. *value* is the initial value; if omitted, a type-specific default is used. *name* is the name of the variable in the Tcl interpreter; if omitted, a unique name of the form ``'PY_VARnum'`` is generated. If *name* matches an existing variable and *value* is omitted, the existing value is retained." -msgstr "" - -msgid "In most cases you should use one of the typed subclasses below -- :class:`StringVar`, :class:`IntVar`, :class:`DoubleVar` or :class:`BooleanVar` -- rather than :class:`!Variable` directly." -msgstr "" - -msgid "When a :class:`!Variable` is garbage collected, its Tcl variable is unset. Keep a reference to it for as long as a widget is linked to it, for example by storing it as an attribute rather than in a local variable. Otherwise Tk recreates the Tcl variable to keep the widget working, but it is never unset again, leaking one Tcl variable per dropped wrapper." -msgstr "" - -msgid "Two variables now compare equal (``==``) only when they have the same name, are of the same class, and belong to the same Tcl interpreter." -msgstr "" - -msgid "Return the current value of the variable. For the base class the value is returned as a string; the typed subclasses convert it to the appropriate Python type." -msgstr "" - -msgid "Set the variable to *value*. :meth:`initialize` is an alias of :meth:`!set`." -msgstr "" - -msgid "The *initialize* spelling." -msgstr "" - -msgid "Register *callback* to be called when the variable is accessed according to *mode*. *mode* is one of the strings ``'array'``, ``'read'``, ``'write'`` or ``'unset'``, or a list or tuple of such strings." -msgstr "" - -msgid "When triggered, *callback* is called with three arguments: the name of the Tcl variable, an index (or an empty string if the variable is not an element of an array), and the *mode* that triggered the call." -msgstr "" - -msgid "Return the internal name of the registered callback, which can be passed to :meth:`trace_remove`." -msgstr "" - -msgid "Remove a trace callback from the variable. *mode* must match the *mode* that was passed to :meth:`trace_add`, and *cbname* is the callback name returned by :meth:`trace_add`." -msgstr "" - -msgid "Return a list of ``(modes, cbname)`` pairs describing all traces currently set on the variable, where *modes* is a tuple of mode strings and *cbname* is the internal callback name." -msgstr "" - -msgid "Register *callback* to be called when the variable is accessed according to *mode*. *mode* is one of the strings ``'r'``, ``'w'`` or ``'u'``, for read, write or unset. Return the internal name of the registered callback. :meth:`trace` is an alias of :meth:`!trace_variable`." -msgstr "" - -msgid "Use :meth:`trace_add` instead. This method wraps a Tcl feature that was removed in Tcl 9.0." -msgstr "" - -msgid "Remove the trace callback named *cbname* registered for *mode* with :meth:`trace_variable`." -msgstr "" - -msgid "Use :meth:`trace_remove` instead. This method wraps a Tcl feature that was removed in Tcl 9.0." -msgstr "" - -msgid "Return a list of ``(mode, cbname)`` pairs for all traces set on the variable with :meth:`trace_variable`." -msgstr "" - -msgid "Use :meth:`trace_info` instead. This method wraps a Tcl feature that was removed in Tcl 9.0." -msgstr "" - -msgid "A :class:`Variable` subclass that holds a string. The default value is ``''``." -msgstr "" - -msgid "Return the value of the variable as a :class:`str`." -msgstr "" - -msgid "A :class:`Variable` subclass that holds an integer. The default value is ``0``." -msgstr "" - -msgid "Return the value of the variable as an :class:`int`." -msgstr "" - -msgid "A :class:`Variable` subclass that holds a float. The default value is ``0.0``." -msgstr "" - -msgid "Return the value of the variable as a :class:`float`." -msgstr "" - -msgid "A floating-point value is always parsed with a period (``.``) as the decimal separator, but :class:`Spinbox`, :class:`Scale` and :class:`ttk.Spinbox ` format it according to the ``LC_NUMERIC`` locale. Under a locale that uses a comma they produce a value that :meth:`get` cannot read, raising :exc:`TclError`. Set ``LC_NUMERIC`` to a locale that uses a period (such as ``'C'``) to avoid this." -msgstr "" - -msgid "A :class:`Variable` subclass that holds a boolean. The default value is ``False``." -msgstr "" - -msgid "Return the value of the variable as a :class:`bool`. Raise a :exc:`ValueError` if the value cannot be interpreted as a boolean." -msgstr "" - -msgid "Set the variable to *value*, converting it to a boolean. :meth:`initialize` is an alias of :meth:`!set`." -msgstr "" - -msgid "Image classes" -msgstr "" - -msgid "Base class for Tk images. *imgtype* is the Tk image type, one of ``'photo'`` or ``'bitmap'``. An image is a named object that can be displayed by widgets through their *image* option; deleting all references to the :class:`!Image` object deletes the underlying Tk image. Usually you create a :class:`PhotoImage` or :class:`BitmapImage` rather than an :class:`!Image` directly." -msgstr "" - -msgid "The image's configuration options are given by *cnf* and *kw* and may be queried and changed later with the mapping protocol (using ``image[key]``) or with the :meth:`configure` method." -msgstr "" - -msgid "Modify one or more configuration options of the image. The valid options depend on the image type; see :class:`PhotoImage` and :class:`BitmapImage`. :meth:`config` is an alias of :meth:`!configure`." -msgstr "" - -msgid "Return the height of the image, in pixels." -msgstr "" - -msgid "Return the width of the image, in pixels." -msgstr "" - -msgid "Return the type of the image, that is the value of *imgtype* with which it was created (for example ``'photo'`` or ``'bitmap'``)." -msgstr "" - -msgid "A full-color image (the Tk ``photo`` image type), stored internally with a varying degree of transparency per pixel. It can read and write GIF, PPM/PGM and (in Tk 8.6 and later) PNG files, read SVG files (in Tk 9.0 and later), and be drawn in widgets. Inherits from :class:`Image`." -msgstr "" - -msgid "The configuration options include *data* (the image contents as a string), *file* (the name of a file to read the contents from), *format* (the name of the file format handler), *width* and *height* (the size of the image, used when building it up piece by piece), *gamma* and *palette*." -msgstr "" - -msgid "Blank the image; that is, set the entire image to have no data, so that it is displayed as transparent and the background of whatever window it is displayed in shows through." -msgstr "" - -msgid "Return the current value of the configuration option *option*." -msgstr "" - -msgid "Return a new :class:`PhotoImage` with a copy of this image." -msgstr "" - -msgid "*from_coords* specifies a rectangular sub-region of the source image to be copied. It must be a tuple or a list of 1 to 4 integers ``(x1, y1, x2, y2)``. ``(x1, y1)`` and ``(x2, y2)`` specify diagonally opposite corners of the rectangle. If *x2* and *y2* are not specified, they default to the bottom-right corner of the source image. The pixels copied include the left and top edges of the rectangle but not the bottom or right edges. If *from_coords* is not given, the whole source image is copied." -msgstr "" - -msgid "If *zoom* or *subsample* are specified, the image is transformed as in the :meth:`zoom` or :meth:`subsample` methods. The value must be a single integer or a pair of integers." -msgstr "" - -msgid "Added the *from_coords*, *zoom* and *subsample* parameters." -msgstr "" - -msgid "Copy a region from *sourceImage* (which must be a :class:`PhotoImage`) into this image, possibly with pixel zooming and/or subsampling. If no options are specified, the whole of *sourceImage* is copied into this image, starting at coordinates ``(0, 0)``." -msgstr "" - -msgid "*from_coords* specifies a rectangular sub-region of the source image to be copied, as in the :meth:`copy` method." -msgstr "" - -msgid "*to* specifies a rectangular sub-region of the destination image to be affected. It must be a tuple or a list of 1 to 4 integers ``(x1, y1, x2, y2)``. If *x2* and *y2* are not specified, they default to ``(x1, y1)`` plus the size of the source region (after subsampling and zooming, if specified). If *x2* and *y2* are specified, the source region is replicated if necessary to fill the destination region in a tiled fashion." -msgstr "" - -msgid "If *shrink* is true, the size of the destination image is reduced, if necessary, so that the region being copied into is at the bottom-right corner of the image." -msgstr "" - -msgid "*compositingrule* specifies how transparent pixels in the source image are combined with the destination image. With ``'overlay'`` (the default), the old contents of the destination image remain visible, as if the source image were printed on a piece of transparent film and placed over the top of the destination. With ``'set'``, the old contents of the destination image are discarded and the source image is used as-is." -msgstr "" - -msgid "Return the image data." -msgstr "" - -msgid "*format* specifies the name of the image file format handler to use. If it is not given, the data is returned as a tuple (one element per row) of strings containing space-separated (one element per pixel/column) colors in ``#RRGGBB`` format." -msgstr "" - -msgid "*from_coords* specifies a rectangular region of the image to be returned. It must be a tuple or a list of 1 to 4 integers ``(x1, y1, x2, y2)``. If only *x1* and *y1* are specified, the region extends from ``(x1, y1)`` to the bottom-right corner of the image. If all four coordinates are given, they specify diagonally opposite corners of the region, including ``(x1, y1)`` and excluding ``(x2, y2)``. If *from_coords* is not given, the whole image is returned." -msgstr "" - -msgid "If *background* is specified, the data does not contain any transparency information; in all transparent pixels the color is replaced by the specified color." -msgstr "" - -msgid "If *grayscale* is true, the data does not contain color information; all pixel data is transformed into grayscale." -msgstr "" - -msgid "Return the color of the pixel at coordinates (*x*, *y*) as an ``(r, g, b)`` tuple of three integers between 0 and 255, representing the red, green and blue components respectively." -msgstr "" - -msgid "Set pixels of the image to the colors given in *data*, which must be a string or a nested sequence of horizontal rows of pixel colors (for example ``\"{red green} {blue yellow}\"``)." -msgstr "" - -msgid "*to* specifies the coordinates of the region of the image into which the data are copied. It must be a tuple or a list of 2 or 4 integers ``(x1, y1)`` or ``(x1, y1, x2, y2)`` giving the top-left corner, and optionally the bottom-right corner, of the region. The default position is ``(0, 0)``." -msgstr "" - -msgid "Read image data from the file named *filename* into the image." -msgstr "" - -msgid "*format* specifies the format of the image data in the file." -msgstr "" - -msgid "*from_coords* specifies a rectangular sub-region of the image file data to be copied to the destination image. It must be a tuple or a list of 1 to 4 integers ``(x1, y1, x2, y2)``. If only *x1* and *y1* are specified, the region extends from ``(x1, y1)`` to the bottom-right corner of the image in the file. If all four coordinates are given, they specify diagonally opposite corners of the region. If *from_coords* is not given, the whole of the image in the file is read." -msgstr "" - -msgid "*to* specifies the coordinates of the top-left corner of the region of the image into which the data are read. The default is ``(0, 0)``." -msgstr "" - -msgid "If *shrink* is true, the size of the image is reduced, if necessary, so that the region into which the file data are read is at the bottom-right corner of the image." -msgstr "" - -msgid "Return a new :class:`PhotoImage` based on this image but using only every *x*-th pixel in the X direction and every *y*-th pixel in the Y direction. If *y* is not given, it defaults to the same value as *x*." -msgstr "" - -msgid "Added the *from_coords* parameter." -msgstr "" - -msgid "Return ``True`` if the pixel at coordinates (*x*, *y*) is fully transparent, ``False`` otherwise." -msgstr "" - -msgid "Make the pixel at coordinates (*x*, *y*) fully transparent if *boolean* is true, fully opaque otherwise." -msgstr "" - -msgid "Write image data from the image to the file named *filename*." -msgstr "" - -msgid "*format* specifies the name of the image file format handler to use. If it is not given, the format is guessed from the file extension." -msgstr "" - -msgid "*from_coords* specifies a rectangular region of the image to be written. It must be a tuple or a list of 1 to 4 integers ``(x1, y1, x2, y2)``. If only *x1* and *y1* are specified, the region extends from ``(x1, y1)`` to the bottom-right corner of the image. If all four coordinates are given, they specify diagonally opposite corners of the region. If *from_coords* is not given, the whole image is written." -msgstr "" - -msgid "Added the *background* and *grayscale* parameters." -msgstr "" - -msgid "Return a new :class:`PhotoImage` with this image magnified by a factor of *x* in the X direction and *y* in the Y direction. If *y* is not given, it defaults to the same value as *x*." -msgstr "" - -msgid "A two-color image (the Tk ``bitmap`` image type) created from an X11 bitmap. Each pixel displays a foreground color, a background color, or nothing (producing a transparent effect). Inherits from :class:`Image`." -msgstr "" - -msgid "The configuration options are *data* or *file* (the source bitmap, given as a string in X11 bitmap format or as the name of a file in that format), *maskdata* or *maskfile* (the mask bitmap, in the same forms), and *foreground* and *background* (the two colors). For pixels where the mask is zero the image displays nothing; for other pixels it displays the foreground color where the source is one and the background color where the source is zero. If *background* is set to an empty string, the background pixels are transparent." -msgstr "" - -msgid ":class:`!BitmapImage` has no methods of its own beyond those inherited from :class:`Image`." -msgstr "" - -msgid "Other classes" -msgstr "" - -msgid "A container for the attributes of an event passed to a callback bound with :meth:`Misc.bind`. An :class:`!Event` instance has the following attributes, each corresponding to a field of the underlying Tk event; depending on the event type, some attributes may be set to the string ``'??'`` to indicate that they are not meaningful. See :ref:`bindings-and-events`." -msgstr "" - -msgid "The serial number of the event." -msgstr "" - -msgid "The mouse button that was pressed or released (for button events)." -msgstr "" - -msgid "Whether the window has the focus (for ``Enter`` and ``Leave`` events)." -msgstr "" - -msgid "The new height and width of the window (for ``Configure`` and ``Expose`` events)." -msgstr "" - -msgid "The keycode of the key that was pressed or released." -msgstr "" - -msgid "The state of the event, as a number (for most events) or a string (for ``Visibility`` events)." -msgstr "" - -msgid "The timestamp of the event, in milliseconds." -msgstr "" - -msgid "The pointer position relative to the widget, in pixels." -msgstr "" - -msgid "The pointer position relative to the top-left corner of the screen, in pixels." -msgstr "" - -msgid "The character typed, as a string (for key events)." -msgstr "" - -msgid "``True`` if the event was sent by another application." -msgstr "" - -msgid "The symbolic name of the key that was pressed or released." -msgstr "" - -msgid "The numeric value of :attr:`keysym`." -msgstr "" - -msgid "The :class:`EventType` of the event." -msgstr "" - -msgid "The widget on which the event occurred." -msgstr "" - -msgid "The amount the mouse wheel was rotated (for ``MouseWheel`` events)." -msgstr "" - -msgid "An :class:`enum.StrEnum` enumerating the Tk event types, used as the value of :attr:`Event.type`. Its members include, among others, ``KeyPress``, ``KeyRelease``, ``ButtonPress``, ``ButtonRelease``, ``Motion``, ``Enter``, ``Leave``, ``FocusIn``, ``FocusOut``, ``Configure``, ``Map``, ``Unmap``, ``Expose``, ``Destroy`` and ``MouseWheel``." -msgstr "" - -msgid "Internal helper that wraps a Python callback so that it can be invoked from Tcl. *func* is the Python function, *subst* is an optional function that pre-processes the Tcl arguments, and *widget* is the widget used for error reporting. Instances are created automatically by :meth:`Misc.register`; this class is not normally used directly." -msgstr "" - -msgid "Module-level functions" -msgstr "" - -msgid "The :func:`Tcl` function is a factory function which creates an object much like that created by the :class:`Tk` class, except that it does not initialize the Tk subsystem. This is most often useful when driving the Tcl interpreter in an environment where one doesn't want to create extraneous toplevel windows, or where one cannot (such as Unix/Linux systems without an X server). An object created by the :func:`Tcl` object can have a Toplevel window created (and the Tk subsystem initialized) by calling its :meth:`~Tk.loadtk` method." -msgstr "" - -msgid "Inhibit the creation of an implicit default root window. Afterwards :mod:`!tkinter` no longer creates a shared default root automatically, and operations that rely on one --- such as constructing a widget without an explicit *master* --- raise a :exc:`RuntimeError`. Call this early in larger applications to make the root window explicit." -msgstr "" - -msgid "Run the Tk main event loop on the default root window until all windows are destroyed. Equivalent to calling :meth:`Misc.mainloop` on the default root." -msgstr "" - -msgid "Convert the Tcl boolean string *s* (one of ``'1'``, ``'true'``, ``'yes'``, ``'on'`` and similar, or their false counterparts) to a Python :class:`bool`. Raise :exc:`TclError` for an invalid value." -msgstr "" - -msgid "Convert *s* to a floating-point number. This is the built-in :class:`float`." -msgstr "" - -msgid "Convert *s* to an integer. This is the built-in :class:`int`." -msgstr "" - -msgid "Return the names of all existing images in the default root's interpreter." -msgstr "" - -msgid "Return the available image types (such as ``'photo'`` and ``'bitmap'``) in the default root's interpreter." -msgstr "" - -msgid "File handlers" -msgstr "" - -msgid "Tk allows you to register and unregister a callback function which will be called from the Tk mainloop when I/O is possible on a file descriptor. Only one handler may be registered per file descriptor. Example code::" -msgstr "" - -msgid "" -"import tkinter\n" -"widget = tkinter.Tk()\n" -"mask = tkinter.READABLE | tkinter.WRITABLE\n" -"widget.tk.createfilehandler(file, mask, callback)\n" -"...\n" -"widget.tk.deletefilehandler(file)" -msgstr "" - -msgid "This feature is not available on Windows." -msgstr "" - -msgid "Since you don't know how many bytes are available for reading, you may not want to use the :class:`~io.BufferedIOBase` or :class:`~io.TextIOBase` :meth:`~io.BufferedIOBase.read` or :meth:`~io.IOBase.readline` methods, since these will insist on reading a predefined number of bytes. For sockets, the :meth:`~socket.socket.recv` or :meth:`~socket.socket.recvfrom` methods will work fine; for other files, use raw reads or ``os.read(file.fileno(), maxbytecount)``." -msgstr "" - -msgid "Registers the file handler callback function *func*. The *file* argument may either be an object with a :meth:`~io.IOBase.fileno` method (such as a file or socket object), or an integer file descriptor. The *mask* argument is an ORed combination of any of the three constants below. The callback is called as follows::" -msgstr "" - -msgid "callback(file, mask)" -msgstr "" - -msgid "Unregisters a file handler." -msgstr "" - -msgid "Constants used in the *mask* arguments." -msgstr "" - -msgid "Constants" -msgstr "" - -msgid "The following symbolic constants are available in both the :mod:`!tkinter` and :mod:`!tkinter.constants` namespaces." -msgstr "" - -msgid "Truthy values, all equal to the integer ``1``." -msgstr "" - -msgid "Falsy values, all equal to the integer ``0``." -msgstr "" - -msgid "Compass directions (``'n'``, ``'s'``, ``'e'``, ``'w'`` and the diagonals and edges) plus ``CENTER`` (``'center'``), used as values for the *anchor* and *sticky* options and by methods such as :meth:`Misc.grid_anchor`." -msgstr "" - -msgid "Sides for the *side* option of the packer (see :meth:`Pack.pack_configure`)." -msgstr "" - -msgid "Values for the *fill* option of the packer: ``'x'``, ``'y'``, ``'both'`` or ``'none'``." -msgstr "" - -msgid "Values for the *relief* option, which controls a widget's 3-D border." -msgstr "" - -msgid "Values for the *orient* option of widgets such as :class:`Scale`, :class:`Scrollbar` and :class:`PanedWindow`." -msgstr "" - -msgid "Values for the *wrap* option of the :class:`Text` widget, selecting line wrapping on character or word boundaries." -msgstr "" - -msgid "The text-alignment value ``'baseline'``." -msgstr "" - -msgid "Values for the *bordermode* option of the placer (see :meth:`Place.place_configure`)." -msgstr "" - -msgid "Symbolic indices used by the :class:`Text`, :class:`Entry`, :class:`Listbox` and :class:`Canvas` widgets, such as ``'insert'`` (the insertion cursor), ``'current'``, ``'end'``, ``'anchor'`` and the bounds of the selection (``'sel.first'`` and ``'sel.last'``)." -msgstr "" - -msgid "The special tag ``'all'``, which matches every item of a :class:`Canvas` or every character of a :class:`Text` (for example ``canvas.delete(ALL)``)." -msgstr "" - -msgid "Values for the *state* option of various widgets and items." -msgstr "" - -msgid "Menu entry types, used as the *itemType* argument of :meth:`Menu.add` and :meth:`Menu.insert`." -msgstr "" - -msgid "Values for the *selectmode* option of the :class:`Listbox` widget." -msgstr "" - -msgid "Values for the *style* option of :class:`Canvas` arc items." -msgstr "" - -msgid "Values for the *capstyle* (``'butt'``, ``'projecting'``, ``'round'``) and *joinstyle* (``'round'``, ``'bevel'``, ``'miter'``) options of :class:`Canvas` line items." -msgstr "" - -msgid "Values for the *arrow* option of :class:`Canvas` line items, indicating which ends have arrowheads." -msgstr "" - -msgid "The first argument passed by a :class:`Scrollbar` to the :meth:`XView.xview` or :meth:`YView.yview` method of the scrolled widget." -msgstr "" - -msgid "Values for the *what* argument of :meth:`XView.xview_scroll` and :meth:`YView.yview_scroll`." -msgstr "" - -msgid "Other option values: ``'underline'``, ``'numeric'`` and ``'dotbox'``." -msgstr "" - -msgid "geometry management (widgets)" -msgstr "" - -msgid "packing (widgets)" +msgid "packing (widgets)" msgstr "" msgid "window manager (widgets)" msgstr "" -msgid "Tk Option Data Types" -msgstr "" - msgid "bind (widgets)" msgstr "" diff --git a/library/tkinter.scrolledtext.po b/library/tkinter.scrolledtext.po index 0e63983b6..2479b5212 100644 --- a/library/tkinter.scrolledtext.po +++ b/library/tkinter.scrolledtext.po @@ -12,16 +12,16 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=(n > 1);\n" -msgid ":mod:`!tkinter.scrolledtext` --- Scrolled text widget" +msgid ":mod:`!tkinter.scrolledtext` --- Scrolled Text Widget" msgstr "" msgid "**Source code:** :source:`Lib/tkinter/scrolledtext.py`" @@ -30,7 +30,7 @@ msgstr "" msgid "The :mod:`!tkinter.scrolledtext` module provides a class of the same name which implements a basic text widget which has a vertical scroll bar configured to do the \"right thing.\" Using the :class:`ScrolledText` class is a lot easier than setting up a text widget and scroll bar directly." msgstr "" -msgid "The text widget and scrollbar are packed together in a :class:`~tkinter.Frame`, and the methods of the :class:`~tkinter.Pack`, :class:`~tkinter.Grid` and :class:`~tkinter.Place` geometry managers are acquired from the :class:`~tkinter.Frame` object. This allows the :class:`ScrolledText` widget to be used directly to achieve most normal geometry management behavior." +msgid "The text widget and scrollbar are packed together in a :class:`Frame`, and the methods of the :class:`Grid` and :class:`Pack` geometry managers are acquired from the :class:`Frame` object. This allows the :class:`ScrolledText` widget to be used directly to achieve most normal geometry management behavior." msgstr "" msgid "Should more specific control be necessary, the following attributes are available:" diff --git a/library/tkinter.ttk.po b/library/tkinter.ttk.po index 1956dbbfc..7f1d406c4 100644 --- a/library/tkinter.ttk.po +++ b/library/tkinter.ttk.po @@ -14,10 +14,10 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.14\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2026-08-26 03:59+0000\n" +"POT-Creation-Date: 2026-08-18 04:30+0000\n" "PO-Revision-Date: 2021-06-28 01:15+0000\n" "Last-Translator: Sepehr Rasouli , 2026\n" -"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n" +"Language-Team: Persian (https://github.com/revisto/python-docs-fa/fa/)\n" "Language: fa\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,19 +30,16 @@ msgstr "" msgid "**Source code:** :source:`Lib/tkinter/ttk.py`" msgstr "" -msgid "The :mod:`!tkinter.ttk` module provides access to the Tk themed widget set, introduced in Tk 8.5. Its widgets adapt their appearance to the platform's native theme, giving an application a better and more consistent look and feel than the classic :mod:`tkinter` widgets, whose appearance is fixed." +msgid "The :mod:`!tkinter.ttk` module provides access to the Tk themed widget set, introduced in Tk 8.5. It provides additional benefits including anti-aliased font rendering under X11 and window transparency (requiring a composition window manager on X11)." msgstr "" msgid "The basic idea for :mod:`!tkinter.ttk` is to separate, to the extent possible, the code implementing a widget's behavior from the code implementing its appearance." msgstr "" -msgid "Ttk widgets are used just like the classic :mod:`tkinter` widgets and share the same machinery: the widget hierarchy, the geometry managers, variable coupling and event binding. Those foundational concepts are covered in the :mod:`tkinter` documentation and are not repeated here." +msgid "`Tk Widget Styling Support `_" msgstr "" -msgid "`Tk Widget Styling Support (TIP #48) `_" -msgstr "" - -msgid "The Tcl Improvement Proposal that introduced the themed widget styling engine." +msgid "A document introducing theming support for Tk" msgstr "" msgid "Using Ttk" @@ -62,19 +59,22 @@ msgid "" "from tkinter.ttk import *" msgstr "" -msgid "That code causes several :mod:`!tkinter.ttk` widgets (:class:`Button`, :class:`Checkbutton`, :class:`Entry`, :class:`Frame`, :class:`Label`, :class:`LabelFrame`, :class:`Menubutton`, :class:`OptionMenu`, :class:`PanedWindow`, :class:`Radiobutton`, :class:`Scale`, :class:`Scrollbar` and :class:`Spinbox`) to automatically replace the Tk widgets." +msgid "That code causes several :mod:`!tkinter.ttk` widgets (:class:`Button`, :class:`Checkbutton`, :class:`Entry`, :class:`Frame`, :class:`Label`, :class:`LabelFrame`, :class:`Menubutton`, :class:`PanedWindow`, :class:`Radiobutton`, :class:`Scale` and :class:`Scrollbar`) to automatically replace the Tk widgets." +msgstr "" + +msgid "This has the direct benefit of using the new widgets which gives a better look and feel across platforms; however, the replacement widgets are not completely compatible. The main difference is that widget options such as \"fg\", \"bg\" and others related to widget styling are no longer present in Ttk widgets. Instead, use the :class:`ttk.Style` class for improved styling effects." msgstr "" -msgid "Overriding the classic widgets with ``from tkinter.ttk import *`` is convenient for adapting existing code, but new code is usually clearer if it imports the module as ``from tkinter import ttk`` and refers to the themed widgets explicitly, such as ``ttk.Button``." +msgid "`Converting existing applications to use Tile widgets `_" msgstr "" -msgid "This has the direct benefit of using the new widgets which gives a better look and feel across platforms; however, the replacement widgets are not completely compatible. The main difference is that widget options such as ``fg``, ``bg`` and others related to widget styling are no longer present in Ttk widgets. Instead, use the :class:`ttk.Style