Add translations for changelog.po and other files

Author: Rmaawn

c-api/bytes.po

@@ -15,7 +15,7 @@ msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2026-10-11 04:18+0000\n"
-"PO-Revision-Date: 2026-09-15 13:25+0330\n"
+"PO-Revision-Date: 2026-10-11 17:41+0330\n"
 "Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
 "Language-Team: Persian (https://github.com/python/python-docs-fa/)\n"
 "Language: fa\n"
@@ -397,10 +397,10 @@ msgstr ""
 "return (char*)PyBytesWriter_GetData(writer) + pos;"
 
 msgid "Example creating the string ``b'abc'``"
-msgstr ""
+msgstr "نمونه‌ای برای ساخت رشته‌ی ``b'abc'``"
 
 msgid "Example creating the bytes string ``b\"abc\"``, with a fixed size of 3 bytes::"
-msgstr ""
+msgstr "نمونه‌ای برای ساخت رشته‌ی بایت ``b\"abc\"``، با اندازه‌ی ثابت ۳ بایت::"
 
 msgid ""
 "PyObject* create_abc(void)\n"
@@ -415,9 +415,20 @@ msgid ""
 "    return PyBytesWriter_Finish(writer);\n"
 "}"
 msgstr ""
+"PyObject* create_abc(void)\n"
+"{\n"
+"    PyBytesWriter *writer = PyBytesWriter_Create(3);\n"
+"    if (writer == NULL) {\n"
+"        return NULL;\n"
+"    }\n"
+"\n"
+"    char *str = PyBytesWriter_GetData(writer);\n"
+"    memcpy(str, \"abc\", 3);\n"
+"    return PyBytesWriter_Finish(writer);\n"
+"}"
 
 msgid "Variant using a pointer to compute the final size::"
-msgstr ""
+msgstr "گونه‌ای که از یک اشاره‌گر برای محاسبه‌ی اندازه‌ی نهایی استفاده می‌کند::"
 
 msgid ""
 "PyObject* create_abc_ptr(void)\n"
@@ -433,14 +444,24 @@ msgid ""
 "    return PyBytesWriter_FinishWithPointer(writer, str);\n"
 "}"
 msgstr ""
+"PyObject* create_abc_ptr(void)\n"
+"{\n"
+"    PyBytesWriter *writer = PyBytesWriter_Create(3);\n"
+"    if (writer == NULL) {\n"
+"        return NULL;\n"
+"    }\n"
+"\n"
+"    char *str = PyBytesWriter_GetData(writer);\n"
+"    memcpy(str, \"abc\", 3);\n"
+"    str += 1;\n"
+"    return PyBytesWriter_FinishWithPointer(writer, str);\n"
+"}"
 
 msgid "Update ``PyBytes_FromStringAndSize()`` code"
-msgstr ""
+msgstr "به‌روزرسانی کد ``PyBytes_FromStringAndSize()``"
 
-#, fuzzy
-#| msgid "Use the :c:type:`PyBytesWriter` API instead of ``PyBytes_FromStringAndSize(NULL, len)``."
 msgid "Example of code using the soft deprecated ``PyBytes_FromStringAndSize(NULL, size)`` API::"
-msgstr "به جای ``PyBytes_FromStringAndSize(NULL, len)`` از API مربوط به :c:type:`PyBytesWriter` استفاده کنید."
+msgstr "نمونه‌ای از کد که از API منسوخ‌شده‌ی نرم ``PyBytes_FromStringAndSize(NULL, size)`` استفاده می‌کند::"
 
 msgid ""
 "int copy_bytes(char *dest, const char *src, Py_ssize_t num_bytes)\n"
@@ -460,9 +481,25 @@ msgid ""
 "    return result;\n"
 "}"
 msgstr ""
+"int copy_bytes(char *dest, const char *src, Py_ssize_t num_bytes)\n"
+"{\n"
+"    ...\n"
+"}\n"
+"\n"
+"PyObject* create_string(const char *start, Py_ssize_t num_bytes)\n"
+"{\n"
+"    PyObject *result = PyBytes_FromStringAndSize(NULL, num_bytes);\n"
+"    if (result == NULL) {\n"
+"        return NULL;\n"
+"    }\n"
+"    if (copy_bytes(PyBytes_AS_STRING(result), start, num_bytes) < 0) {\n"
+"        Py_CLEAR(result);\n"
+"    }\n"
+"    return result;\n"
+"}"
 
 msgid "It can now be updated to::"
-msgstr ""
+msgstr "اکنون می‌توان آن را به شکل زیر به‌روزرسانی کرد::"
 
 msgid ""
 "PyObject* create_string(const char *start, Py_ssize_t num_bytes)\n"
@@ -478,12 +515,24 @@ msgid ""
 "    return PyBytesWriter_Finish(writer);\n"
 "}"
 msgstr ""
+"PyObject* create_string(const char *start, Py_ssize_t num_bytes)\n"
+"{\n"
+"    PyBytesWriter *writer = PyBytesWriter_Create(num_bytes);\n"
+"    if (writer == NULL) {\n"
+"        return NULL;\n"
+"    }\n"
+"    if (copy_bytes(PyBytesWriter_GetData(writer), start, num_bytes) < 0) {\n"
+"        PyBytesWriter_Discard(writer);\n"
+"        return NULL;\n"
+"    }\n"
+"    return PyBytesWriter_Finish(writer);\n"
+"}"
 
 msgid "Update ``_PyBytes_Resize()`` code"
-msgstr ""
+msgstr "به‌روزرسانی کد ``_PyBytes_Resize()``"
 
 msgid "Example of code using the soft deprecated ``_PyBytes_Resize()`` API::"
-msgstr ""
+msgstr "نمونه‌ای از کد که از API منسوخ‌شده‌ی نرم ``_PyBytes_Resize()`` استفاده می‌کند::"
 
 msgid ""
 "void create_string(Py_ssize_t size)\n"
@@ -502,6 +551,21 @@ msgid ""
 "    return bytes;\n"
 "}"
 msgstr ""
+"void create_string(Py_ssize_t size)\n"
+"{\n"
+"    PyObject *bytes = PyBytes_FromStringAndSize(NULL, size);\n"
+"    if (bytes == NULL) {\n"
+"        return NULL;\n"
+"    }\n"
+"    char *str = PyBytes_AS_STRING(bytes);\n"
+"\n"
+"    // ... write data into str ...\n"
+"\n"
+"    if (_PyBytes_Resize(&bytes, (str - PyBytes_AS_STRING(bytes)))) {\n"
+"        return NULL;\n"
+"    }\n"
+"    return bytes;\n"
+"}"
 
 msgid ""
 "void create_string(Py_ssize_t size)\n"
@@ -517,6 +581,18 @@ msgid ""
 "    return PyBytesWriter_FinishWithPointer(writer, str);\n"
 "}"
 msgstr ""
+"void create_string(Py_ssize_t size)\n"
+"{\n"
+"    PyBytesWriter *writer = PyBytesWriter_Create(size);\n"
+"    if (writer == NULL) {\n"
+"        return NULL;\n"
+"    }\n"
+"    char *str = PyBytesWriter_GetData(writer);\n"
+"\n"
+"    // ... write data into str ...\n"
+"\n"
+"    return PyBytesWriter_FinishWithPointer(writer, str;\n"
+"}"
 
 msgid "object"
 msgstr "شیء"

c-api/slice.po

@@ -50,10 +50,8 @@ msgstr "احتمالاً نمی‌خواهید از این تابع استفاد
 msgid "The parameter type for the *slice* parameter was ``PySliceObject*`` before."
 msgstr "نوع پارامتر *slice* قبلاً ``PySliceObject*`` بود."
 
-#, fuzzy
-#| msgid "Usable replacement for :c:func:`PySlice_GetIndices`.  Retrieve the start, stop, and step indices from the slice object *slice* assuming a sequence of length *length*, and store the length of the slice in *slicelength*.  Out of bounds indices are clipped in a manner consistent with the handling of normal slices."
 msgid "Usable replacement for :c:func:`PySlice_GetIndices`.  Retrieve the start, stop, and step indices from the slice object *slice* assuming a sequence of length *length*, and store the length of the slice in *slicelength*.  Out of bounds indices are clipped in a manner consistent with the handling of normal slices. *length* must not be negative."
-msgstr "جایگزین قابل استفاده برای :c:func:`PySlice_GetIndices`. شاخص‌های شروع، پایان و گام را از شیء اسلایس *slice* با فرض یک دنباله با طول *length* بازیابی کنید، و طول اسلایس را در *slicelength* ذخیره کنید. شاخص‌های خارج از کران به روشی سازگار با مدیریت اسلایس‌های عادی برش داده می‌شوند."
+msgstr "جایگزین قابل استفاده برای :c:func:`PySlice_GetIndices`.  شاخص‌های شروع، پایان و گام را از شیء اسلایس *slice* با فرض دنباله‌ای به طول *length* بازیابی کنید و طول اسلایس را در *slicelength* ذخیره کنید.  شاخص‌های خارج از کران به روشی سازگار با مدیریت اسلایس‌های عادی برش داده می‌شوند. *length* نباید منفی باشد."
 
 msgid "Return ``0`` on success and ``-1`` on error with an exception set."
 msgstr "در صورت موفقیت ``0`` و در صورت خطا ``-1`` به همراه استثنای تنظیم‌شده برمی‌گرداند."

howto/abi3t-migration.po

@@ -12,13 +12,14 @@ msgstr ""
 "Project-Id-Version: Python 3.15\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2026-10-08 09:24+0330\n"
-"PO-Revision-Date: 2026-10-01 14:41+0330\n"
+"PO-Revision-Date: 2026-10-10 20:55+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"
+"X-Generator: Poedit 3.6\n"
 
 msgid "Migrating to Stable ABI for free threading (``abi3t``)"
 msgstr "مهاجرت به ABI پایدار برای نخ‌بندی آزاد (``abi3t``)"
@@ -350,7 +351,6 @@ msgstr "همانند نمونه، تابع ``PyModExport_`` شما *فقط* با
 msgid "When building for Windows using the Setuptools_ build tool, removing the :samp:`PyInit_{<modname>}` function may result in the linker error :samp:`LINK : error LNK2001: unresolved external symbol PyInit_{<modname>}`. This is caused by Setuptools passing an ``/EXPORT`` linker flag, which is redundant since Python 3.15 (see :gh:`141671`). A workaround is to add a dummy :samp:`PyInit_{<modname>}` function to your code. Python 3.15+ will never call this function if :samp:`PyModExport_{<modname>}` is present, so it can always fail:"
 msgstr "هنگام ساخت برای ویندوز با استفاده از ابزار ساخت Setuptools_، حذف کردن تابع :samp:`PyInit_{<modname>}` ممکن است منجر به خطای پیونددهنده‌ی :samp:`LINK : error LNK2001: unresolved external symbol PyInit_{<modname>}` شود. این مشکل به این دلیل رخ می‌دهد که Setuptools یک پرچم پیونددهنده‌ی ``/EXPORT`` را ارسال می‌کند که از پایتون ۳.۱۵ به بعد اضافی است (نگاه کنید به :gh:`141671`). یک راه حل جایگزین این است که یک تابع :samp:`PyInit_{<modname>}` نمایشی (dummy) به کد خود اضافه کنید. پایتون ۳.۱۵ به بعد هرگز این تابع را در صورت وجود :samp:`PyModExport_{<modname>}` فراخوانی نخواهد کرد، بنابراین همیشه می‌تواند با خطا مواجه شود:"
 
-#, fuzzy
 msgid ""
 "// Workaround for https://github.com/pypa/distutils/issues/387\n"
 "PyMODINIT_FUNC\n"

library/ast.po

@@ -14,7 +14,7 @@ msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2026-10-08 09:24+0330\n"
-"PO-Revision-Date: 2026-10-06 20:40+0330\n"
+"PO-Revision-Date: 2026-10-10 20:54+0330\n"
 "Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
 "Language-Team: Persian (https://github.com/python/python-docs-fa/)\n"
 "Language: fa\n"
@@ -42,162 +42,6 @@ msgstr "دستور زبان انتزاعی"
 msgid "The abstract grammar is currently defined as follows:"
 msgstr "دستور زبان انتزاعی در حال حاضر به‌صورت زیر تعریف شده است:"
 
-#, fuzzy
-#| msgid ""
-#| "-- ASDL's 4 builtin types are:\n"
-#| "-- identifier, int, string, constant\n"
-#| "\n"
-#| "module Python\n"
-#| "{\n"
-#| "    mod = Module(stmt* body, type_ignore* type_ignores)\n"
-#| "        | Interactive(stmt* body)\n"
-#| "        | Expression(expr body)\n"
-#| "        | FunctionType(expr* argtypes, expr returns)\n"
-#| "\n"
-#| "    stmt = FunctionDef(identifier name, arguments args,\n"
-#| "                       stmt* body, expr* decorator_list, expr? returns,\n"
-#| "                       string? type_comment, type_param* type_params)\n"
-#| "          | AsyncFunctionDef(identifier name, arguments args,\n"
-#| "                             stmt* body, expr* decorator_list, expr? returns,\n"
-#| "                             string? type_comment, type_param* type_params)\n"
-#| "\n"
-#| "          | ClassDef(identifier name,\n"
-#| "             expr* bases,\n"
-#| "             keyword* keywords,\n"
-#| "             stmt* body,\n"
-#| "             expr* decorator_list,\n"
-#| "             type_param* type_params)\n"
-#| "          | Return(expr? value)\n"
-#| "\n"
-#| "          | Delete(expr* targets)\n"
-#| "          | Assign(expr* targets, expr value, string? type_comment)\n"
-#| "          | TypeAlias(expr name, type_param* type_params, expr value)\n"
-#| "          | AugAssign(expr target, operator op, expr value)\n"
-#| "          -- 'simple' indicates that we annotate simple name without parens\n"
-#| "          | AnnAssign(expr target, expr annotation, expr? value, int simple)\n"
-#| "\n"
-#| "          -- use 'orelse' because else is a keyword in target languages\n"
-#| "          | For(expr target, expr iter, stmt* body, stmt* orelse, string? type_comment)\n"
-#| "          | AsyncFor(expr target, expr iter, stmt* body, stmt* orelse, string? type_comment)\n"
-#| "          | While(expr test, stmt* body, stmt* orelse)\n"
-#| "          | If(expr test, stmt* body, stmt* orelse)\n"
-#| "          | With(withitem* items, stmt* body, string? type_comment)\n"
-#| "          | AsyncWith(withitem* items, stmt* body, string? type_comment)\n"
-#| "\n"
-#| "          | Match(expr subject, match_case* cases)\n"
-#| "\n"
-#| "          | Raise(expr? exc, expr? cause)\n"
-#| "          | Try(stmt* body, excepthandler* handlers, stmt* orelse, stmt* finalbody)\n"
-#| "          | TryStar(stmt* body, excepthandler* handlers, stmt* orelse, stmt* finalbody)\n"
-#| "          | Assert(expr test, expr? msg)\n"
-#| "\n"
-#| "          | Import(alias* names)\n"
-#| "          | ImportFrom(identifier? module, alias* names, int? level)\n"
-#| "\n"
-#| "          | Global(identifier* names)\n"
-#| "          | Nonlocal(identifier* names)\n"
-#| "          | Expr(expr value)\n"
-#| "          | Pass | Break | Continue\n"
-#| "\n"
-#| "          -- col_offset is the byte offset in the utf8 string the parser uses\n"
-#| "          attributes (int lineno, int col_offset, int? end_lineno, int? end_col_offset)\n"
-#| "\n"
-#| "          -- BoolOp() can use left & right?\n"
-#| "    expr = BoolOp(boolop op, expr* values)\n"
-#| "         | NamedExpr(expr target, expr value)\n"
-#| "         | BinOp(expr left, operator op, expr right)\n"
-#| "         | UnaryOp(unaryop op, expr operand)\n"
-#| "         | Lambda(arguments args, expr body)\n"
-#| "         | IfExp(expr test, expr body, expr orelse)\n"
-#| "         | Dict(expr?* keys, expr* values)\n"
-#| "         | Set(expr* elts)\n"
-#| "         | ListComp(expr elt, comprehension* generators)\n"
-#| "         | SetComp(expr elt, comprehension* generators)\n"
-#| "         | DictComp(expr key, expr value, comprehension* generators)\n"
-#| "         | GeneratorExp(expr elt, comprehension* generators)\n"
-#| "         -- the grammar constrains where yield expressions can occur\n"
-#| "         | Await(expr value)\n"
-#| "         | Yield(expr? value)\n"
-#| "         | YieldFrom(expr value)\n"
-#| "         -- need sequences for compare to distinguish between\n"
-#| "         -- x < 4 < 3 and (x < 4) < 3\n"
-#| "         | Compare(expr left, cmpop* ops, expr* comparators)\n"
-#| "         | Call(expr func, expr* args, keyword* keywords)\n"
-#| "         | FormattedValue(expr value, int conversion, expr? format_spec)\n"
-#| "         | Interpolation(expr value, constant str, int conversion, expr? format_spec)\n"
-#| "         | JoinedStr(expr* values)\n"
-#| "         | TemplateStr(expr* values)\n"
-#| "         | Constant(constant value, string? kind)\n"
-#| "\n"
-#| "         -- the following expression can appear in assignment context\n"
-#| "         | Attribute(expr value, identifier attr, expr_context ctx)\n"
-#| "         | Subscript(expr value, expr slice, expr_context ctx)\n"
-#| "         | Starred(expr value, expr_context ctx)\n"
-#| "         | Name(identifier id, expr_context ctx)\n"
-#| "         | List(expr* elts, expr_context ctx)\n"
-#| "         | Tuple(expr* elts, expr_context ctx)\n"
-#| "\n"
-#| "         -- can appear only in Subscript\n"
-#| "         | Slice(expr? lower, expr? upper, expr? step)\n"
-#| "\n"
-#| "          -- col_offset is the byte offset in the utf8 string the parser uses\n"
-#| "          attributes (int lineno, int col_offset, int? end_lineno, int? end_col_offset)\n"
-#| "\n"
-#| "    expr_context = Load | Store | Del\n"
-#| "\n"
-#| "    boolop = And | Or\n"
-#| "\n"
-#| "    operator = Add | Sub | Mult | MatMult | Div | Mod | Pow | LShift\n"
-#| "                 | RShift | BitOr | BitXor | BitAnd | FloorDiv\n"
-#| "\n"
-#| "    unaryop = Invert | Not | UAdd | USub\n"
-#| "\n"
-#| "    cmpop = Eq | NotEq | Lt | LtE | Gt | GtE | Is | IsNot | In | NotIn\n"
-#| "\n"
-#| "    comprehension = (expr target, expr iter, expr* ifs, int is_async)\n"
-#| "\n"
-#| "    excepthandler = ExceptHandler(expr? type, identifier? name, stmt* body)\n"
-#| "                    attributes (int lineno, int col_offset, int? end_lineno, int? end_col_offset)\n"
-#| "\n"
-#| "    arguments = (arg* posonlyargs, arg* args, arg? vararg, arg* kwonlyargs,\n"
-#| "                 expr?* kw_defaults, arg? kwarg, expr* defaults)\n"
-#| "\n"
-#| "    arg = (identifier arg, expr? annotation, string? type_comment)\n"
-#| "           attributes (int lineno, int col_offset, int? end_lineno, int? end_col_offset)\n"
-#| "\n"
-#| "    -- keyword arguments supplied to call (NULL identifier for **kwargs)\n"
-#| "    keyword = (identifier? arg, expr value)\n"
-#| "               attributes (int lineno, int col_offset, int? end_lineno, int? end_col_offset)\n"
-#| "\n"
-#| "    -- import name with optional 'as' alias.\n"
-#| "    alias = (identifier name, identifier? asname)\n"
-#| "             attributes (int lineno, int col_offset, int? end_lineno, int? end_col_offset)\n"
-#| "\n"
-#| "    withitem = (expr context_expr, expr? optional_vars)\n"
-#| "\n"
-#| "    match_case = (pattern pattern, expr? guard, stmt* body)\n"
-#| "\n"
-#| "    pattern = MatchValue(expr value)\n"
-#| "            | MatchSingleton(constant value)\n"
-#| "            | MatchSequence(pattern* patterns)\n"
-#| "            | MatchMapping(expr* keys, pattern* patterns, identifier? rest)\n"
-#| "            | MatchClass(expr cls, pattern* patterns, identifier* kwd_attrs, pattern* kwd_patterns)\n"
-#| "\n"
-#| "            | MatchStar(identifier? name)\n"
-#| "            -- The optional \"rest\" MatchMapping parameter handles capturing extra mapping keys\n"
-#| "\n"
-#| "            | MatchAs(pattern? pattern, identifier? name)\n"
-#| "            | MatchOr(pattern* patterns)\n"
-#| "\n"
-#| "             attributes (int lineno, int col_offset, int end_lineno, int end_col_offset)\n"
-#| "\n"
-#| "    type_ignore = TypeIgnore(int lineno, string tag)\n"
-#| "\n"
-#| "    type_param = TypeVar(identifier name, expr? bound, expr? default_value)\n"
-#| "               | ParamSpec(identifier name, expr? default_value)\n"
-#| "               | TypeVarTuple(identifier name, expr? default_value)\n"
-#| "               attributes (int lineno, int col_offset, int end_lineno, int end_col_offset)\n"
-#| "}\n"
 msgid ""
 "-- ASDL's 4 builtin types are:\n"
 "-- identifier, int, string, constant\n"