-
Notifications
You must be signed in to change notification settings - Fork 14
Expand file tree
/
Copy pathabc.po
More file actions
416 lines (356 loc) · 29 KB
/
Copy pathabc.po
File metadata and controls
416 lines (356 loc) · 29 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-09-16 12:56+0000\n"
"PO-Revision-Date: 2026-09-15 13:14+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"
"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 ":mod:`!abc` --- Abstract Base Classes"
msgstr ":mod:`!abc` --- کلاس‌های پایه انتزاعی"
msgid "**Source code:** :source:`Lib/abc.py`"
msgstr "**کد منبع:** :source:`Lib/abc.py`"
msgid "This module provides the infrastructure for defining :term:`abstract base classes <abstract base class>` (ABCs) in Python, as outlined in :pep:`3119`; see the PEP for why this was added to Python. (See also :pep:`3141` and the :mod:`numbers` module regarding a type hierarchy for numbers based on ABCs.)"
msgstr "این ماژول زیرساخت لازم برای تعریف :term:`کلاس‌های پایه انتزاعی <abstract base class>` (ABCها) در پایتون را فراهم می‌کند، همان‌طور که در :pep:`3119` شرح داده شده است؛ برای آگاهی از دلیل افزودن این قابلیت به پایتون، این PEP را ببینید. (همچنین :pep:`3141` و ماژول :mod:`numbers` را در مورد سلسله‌مراتب نوع برای اعداد بر پایه ABCها ببینید.)"
msgid "The :mod:`collections` module has some concrete classes that derive from ABCs; these can, of course, be further derived. In addition, the :mod:`collections.abc` submodule has some ABCs that can be used to test whether a class or instance provides a particular interface, for example, if it is :term:`hashable` or if it is a :term:`mapping`."
msgstr "ماژول :mod:`collections` تعدادی کلاس ملموس دارد که از ABCها مشتق شده‌اند؛ البته می‌توان این‌ها را نیز بیشتر مشتق کرد. علاوه بر این، زیرماژول :mod:`collections.abc` تعدادی ABC دارد که می‌توان از آن‌ها برای بررسی اینکه آیا یک کلاس یا نمونه، رابط خاصی را فراهم می‌کند، استفاده کرد؛ برای مثال، اگر :term:`hashable` باشد یا یک :term:`mapping` باشد."
msgid "This module provides the metaclass :class:`ABCMeta` for defining ABCs and a helper class :class:`ABC` to alternatively define ABCs through inheritance:"
msgstr "این ماژول، فراکلاس :class:`ABCMeta` را برای تعریف ABCها و کلاس کمکی :class:`ABC` را فراهم می‌کند تا به‌عنوان جایگزین، بتوانید ABCها را از طریق ارث‌بری تعریف کنید:"
msgid "A helper class that has :class:`ABCMeta` as its metaclass. With this class, an abstract base class can be created by simply deriving from :class:`!ABC` avoiding sometimes confusing metaclass usage, for example::"
msgstr "یک کلاس کمکی که :class:`ABCMeta` را به‌عنوان فراکلاس خود دارد. با این کلاس، می‌توان یک کلاس پایه انتزاعی را صرفاً با مشتق شدن از :class:`!ABC` ایجاد کرد و از کاربرد گاه گیج‌کننده‌ی فراکلاس اجتناب نمود، برای مثال::"
msgid ""
"from abc import ABC\n"
"\n"
"class MyABC(ABC):\n"
" pass"
msgstr ""
"from abc import ABC\n"
"\n"
"class MyABC(ABC):\n"
" pass"
msgid "Note that the type of :class:`!ABC` is still :class:`ABCMeta`, therefore inheriting from :class:`!ABC` requires the usual precautions regarding metaclass usage, as multiple inheritance may lead to metaclass conflicts. One may also define an abstract base class by passing the metaclass keyword and using :class:`!ABCMeta` directly, for example::"
msgstr "توجه داشته باشید که نوع :class:`!ABC` همچنان :class:`ABCMeta` است؛ بنابراین ارث‌بری از :class:`!ABC` نیازمند رعایت نکات احتیاطی معمول در مورد استفاده از فراکلاس است، زیرا ارث‌بری چندگانه ممکن است به تعارض‌های فراکلاس منجر شود. همچنین می‌توان یک کلاس پایه انتزاعی را با ارسال کلیدواژه metaclass و استفاده مستقیم از :class:`!ABCMeta` تعریف کرد، برای مثال::"
msgid ""
"from abc import ABCMeta\n"
"\n"
"class MyABC(metaclass=ABCMeta):\n"
" pass"
msgstr ""
"from abc import ABCMeta\n"
"\n"
"class MyABC(metaclass=ABCMeta):\n"
" pass"
msgid "Metaclass for defining Abstract Base Classes (ABCs)."
msgstr "فراکلاس برای تعریف کلاس‌های پایه انتزاعی (ABCها)."
msgid "Use this metaclass to create an ABC. An ABC can be subclassed directly, and then acts as a mix-in class. You can also register unrelated concrete classes (even built-in classes) and unrelated ABCs as \"virtual subclasses\" -- these and their descendants will be considered subclasses of the registering ABC by the built-in :func:`issubclass` function, but the registering ABC won't show up in their MRO (Method Resolution Order) nor will method implementations defined by the registering ABC be callable (not even via :func:`super`). [#]_"
msgstr "از این فراکلاس برای ایجاد یک ABC استفاده کنید. یک ABC به‌طور مستقیم قابل زیرکلاس‌بندی است و سپس به‌عنوان یک کلاس میکس‌این عمل می‌کند. همچنین می‌توانید کلاس‌های عینی غیرمرتبط (حتی کلاس‌های توکار) و ABCهای غیرمرتبط را به‌عنوان «زیرکلاس‌های مجازی» ثبت کنید — این کلاس‌ها و زیرکلاس‌های مشتق‌شده از آن‌ها از دید تابع توکار :func:`issubclass` زیرکلاس‌های ABC ثبت‌کننده محسوب خواهند شد، اما ABC ثبت‌کننده در MRO (ترتیب حل متد) آن‌ها ظاهر نخواهد شد و پیاده‌سازی‌های متد تعریف‌شده توسط ABC ثبت‌کننده فراخوانی‌پذیر نخواهند بود (حتی از طریق :func:`super` نیز). [#]_"
msgid "Classes created with a metaclass of :class:`!ABCMeta` have the following method:"
msgstr "کلاس‌هایی که با فراکلاس :class:`!ABCMeta` ایجاد شده‌اند، متد زیر را دارند:"
msgid "Register *subclass* as a \"virtual subclass\" of this ABC. For example::"
msgstr "*subclass* را به‌عنوان یک «زیرکلاس مجازی» از این ABC ثبت کنید. برای مثال::"
msgid ""
"from abc import ABC\n"
"\n"
"class MyABC(ABC):\n"
" pass\n"
"\n"
"MyABC.register(tuple)\n"
"\n"
"assert issubclass(tuple, MyABC)\n"
"assert isinstance((), MyABC)"
msgstr ""
"from abc import ABC\n"
"\n"
"class MyABC(ABC):\n"
" pass\n"
"\n"
"MyABC.register(tuple)\n"
"\n"
"assert issubclass(tuple, MyABC)\n"
"assert isinstance((), MyABC)"
msgid "Returns the registered subclass, to allow usage as a class decorator."
msgstr "زیرکلاس ثبت‌شده را برمی‌گرداند تا امکان استفاده به‌عنوان دکوراتور کلاس فراهم شود."
msgid "To detect calls to :meth:`!register`, you can use the :func:`get_cache_token` function."
msgstr "برای تشخیص فراخوانی‌های :meth:`!register`، می‌توانید از تابع :func:`get_cache_token` استفاده کنید."
msgid "You can also override this method in an abstract base class:"
msgstr "همچنین می‌توانید این متد را در یک کلاس پایه انتزاعی بازنویسی کنید:"
msgid "(Must be defined as a class method.)"
msgstr "(باید به‌عنوان متد کلاس تعریف شود.)"
msgid "Check whether *subclass* is considered a subclass of this ABC. This means that you can customize the behavior of :func:`issubclass` further without the need to call :meth:`register` on every class you want to consider a subclass of the ABC. (This class method is called from the :meth:`~type.__subclasscheck__` method of the ABC.)"
msgstr "بررسی می‌کند که آیا *subclass* زیرکلاسی از این ABC در نظر گرفته می‌شود یا خیر. این بدان معناست که شما می‌توانید رفتار :func:`issubclass` را بیشتر سفارشی‌سازی کنید، بدون نیاز به فراخوانی :meth:`register` برای هر کلاسی که می‌خواهید آن را زیرکلاسی از ABC در نظر بگیرید. (این متد کلاس از متد :meth:`~type.__subclasscheck__` در ABC فراخوانی می‌شود.)"
msgid "This method should return ``True``, ``False`` or :data:`NotImplemented`. If it returns ``True``, the *subclass* is considered a subclass of this ABC. If it returns ``False``, the *subclass* is not considered a subclass of this ABC, even if it would normally be one. If it returns :data:`!NotImplemented`, the subclass check is continued with the usual mechanism."
msgstr "این متد باید ``True``، ``False`` یا :data:`NotImplemented` را برگرداند. اگر ``True`` را برگرداند، *زیرکلاس* به‌عنوان زیرکلاسی از این ABC در نظر گرفته می‌شود. اگر ``False`` را برگرداند، *زیرکلاس* به‌عنوان زیرکلاسی از این ABC در نظر گرفته نمی‌شود، حتی اگر در حالت عادی یک زیرکلاس باشد. اگر :data:`!NotImplemented` را برگرداند، بررسی زیرکلاس با سازوکار معمول ادامه می‌یابد."
msgid "For a demonstration of these concepts, look at this example ABC definition::"
msgstr "برای نمایش این مفاهیم، این نمونه تعریف ABC را ببینید::"
msgid ""
"class Foo:\n"
" def __getitem__(self, index):\n"
" ...\n"
" def __len__(self):\n"
" ...\n"
" def get_iterator(self):\n"
" return iter(self)\n"
"\n"
"class MyIterable(ABC):\n"
"\n"
" @abstractmethod\n"
" def __iter__(self):\n"
" while False:\n"
" yield None\n"
"\n"
" def get_iterator(self):\n"
" return self.__iter__()\n"
"\n"
" @classmethod\n"
" def __subclasshook__(cls, C):\n"
" if cls is MyIterable:\n"
" if any(\"__iter__\" in B.__dict__ for B in C.__mro__):\n"
" return True\n"
" return NotImplemented\n"
"\n"
"MyIterable.register(Foo)"
msgstr ""
"class Foo:\n"
" def __getitem__(self, index):\n"
" ...\n"
" def __len__(self):\n"
" ...\n"
" def get_iterator(self):\n"
" return iter(self)\n"
"\n"
"class MyIterable(ABC):\n"
"\n"
" @abstractmethod\n"
" def __iter__(self):\n"
" while False:\n"
" yield None\n"
"\n"
" def get_iterator(self):\n"
" return self.__iter__()\n"
"\n"
" @classmethod\n"
" def __subclasshook__(cls, C):\n"
" if cls is MyIterable:\n"
" if any(\"__iter__\" in B.__dict__ for B in C.__mro__):\n"
" return True\n"
" return NotImplemented\n"
"\n"
"MyIterable.register(Foo)"
msgid "The ABC ``MyIterable`` defines the standard iterable method, :meth:`~object.__iter__`, as an abstract method. The implementation given here can still be called from subclasses. The :meth:`!get_iterator` method is also part of the ``MyIterable`` abstract base class, but it does not have to be overridden in non-abstract derived classes."
msgstr "کلاس پایه انتزاعی (ABC) ``MyIterable`` متد استاندارد پیمایش‌پذیر، :meth:`~object.__iter__`، را به‌عنوان یک متد انتزاعی تعریف می‌کند. پیاده‌سازی ارائه‌شده در اینجا همچنان می‌تواند از زیرکلاس‌ها فراخوانی شود. متد :meth:`!get_iterator` نیز بخشی از کلاس پایه انتزاعی ``MyIterable`` است، اما نیازی به بازنویسی آن در کلاس‌های مشتق‌شده غیرانتزاعی نیست."
msgid "The :meth:`__subclasshook__` class method defined here says that any class that has an :meth:`~object.__iter__` method in its :attr:`~object.__dict__` (or in that of one of its base classes, accessed via the :attr:`~type.__mro__` list) is considered a ``MyIterable`` too."
msgstr "متد کلاسی :meth:`__subclasshook__` تعریف‌شده در اینجا بیان می‌کند که هر کلاسی که یک متد :meth:`~object.__iter__` در :attr:`~object.__dict__` خود (یا در دیکشنری یکی از کلاس‌های پایه‌ی خود، که از طریق فهرست :attr:`~type.__mro__` به آن‌ها دسترسی پیدا می‌شود) داشته باشد، به‌عنوان یک ``MyIterable`` نیز در نظر گرفته می‌شود."
msgid "Finally, the last line makes ``Foo`` a virtual subclass of ``MyIterable``, even though it does not define an :meth:`~object.__iter__` method (it uses the old-style iterable protocol, defined in terms of :meth:`~object.__len__` and :meth:`~object.__getitem__`). Note that this will not make ``get_iterator`` available as a method of ``Foo``, so it is provided separately."
msgstr "سرانجام، آخرین خط ``Foo`` را به یک زیرکلاس مجازی از ``MyIterable`` تبدیل می‌کند، اگرچه متد :meth:`~object.__iter__` را تعریف نمی‌کند (از پروتکل پیمایش‌پذیر به‌سبک قدیمی استفاده می‌کند که بر حسب :meth:`~object.__len__` و :meth:`~object.__getitem__` تعریف شده است). توجه داشته باشید که این کار ``get_iterator`` را به‌عنوان متدی از ``Foo`` در دسترس قرار نمی‌دهد، بنابراین به‌صورت جداگانه ارائه شده است."
msgid "The :mod:`!abc` module also provides the following decorator:"
msgstr "ماژول :mod:`!abc` همچنین دکوراتور زیر را نیز فراهم می‌کند:"
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."
msgstr "استفاده از این دکوراتور مستلزم آن است که فراکلاسِ کلاس :class:`ABCMeta` باشد یا از آن مشتق شده باشد. کلاسی که فراکلاس آن از :class:`!ABCMeta` مشتق شده باشد، نمی‌تواند نمونه‌سازی شود، مگر آنکه تمام متدها و ویژگی‌های انتزاعی آن بازنویسی شده باشند. می‌توان متدهای انتزاعی را با استفاده از هر یک از سازوکارهای معمول فراخوانی 'super' فراخوانی کرد. می‌توان از :deco:`!abstractmethod` برای اعلام متدهای انتزاعی برای ویژگی‌ها و توصیف‌گرها استفاده کرد."
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."
msgstr "افزودن متدهای انتزاعی به‌صورت پویا به یک کلاس، یا تلاش برای تغییر وضعیت انتزاعی یک متد یا کلاس پس از ایجاد آن، تنها با استفاده از تابع :func:`update_abstractmethods` پشتیبانی می‌شود. :deco:`!abstractmethod` تنها بر زیرکلاس‌های مشتق‌شده با وراثت معمولی تأثیر می‌گذارد؛ «زیرکلاس‌های مجازی» ثبت‌شده با متد :meth:`~ABCMeta.register` مربوط به ABC تحت تأثیر قرار نمی‌گیرند."
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::"
msgstr "هنگامی که :deco:`!abstractmethod` در ترکیب با سایر توصیف‌گرهای متد اعمال می‌شود، باید به‌عنوان درونی‌ترین دکوراتور اعمال شود، همان‌طور که در مثال‌های استفاده زیر نشان داده شده است::"
msgid ""
"class C(ABC):\n"
" @abstractmethod\n"
" def my_abstract_method(self, arg1):\n"
" ...\n"
" @classmethod\n"
" @abstractmethod\n"
" def my_abstract_classmethod(cls, arg2):\n"
" ...\n"
" @staticmethod\n"
" @abstractmethod\n"
" def my_abstract_staticmethod(arg3):\n"
" ...\n"
"\n"
" @property\n"
" @abstractmethod\n"
" def my_abstract_property(self):\n"
" ...\n"
" @my_abstract_property.setter\n"
" @abstractmethod\n"
" def my_abstract_property(self, val):\n"
" ...\n"
"\n"
" @abstractmethod\n"
" def _get_x(self):\n"
" ...\n"
" @abstractmethod\n"
" def _set_x(self, val):\n"
" ...\n"
" x = property(_get_x, _set_x)"
msgstr ""
"class C(ABC):\n"
" @abstractmethod\n"
" def my_abstract_method(self, arg1):\n"
" ...\n"
" @classmethod\n"
" @abstractmethod\n"
" def my_abstract_classmethod(cls, arg2):\n"
" ...\n"
" @staticmethod\n"
" @abstractmethod\n"
" def my_abstract_staticmethod(arg3):\n"
" ...\n"
"\n"
" @property\n"
" @abstractmethod\n"
" def my_abstract_property(self):\n"
" ...\n"
" @my_abstract_property.setter\n"
" @abstractmethod\n"
" def my_abstract_property(self, val):\n"
" ...\n"
"\n"
" @abstractmethod\n"
" def _get_x(self):\n"
" ...\n"
" @abstractmethod\n"
" def _set_x(self, val):\n"
" ...\n"
" x = property(_get_x, _set_x)"
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::"
msgstr "برای تعامل صحیح با سازوکار کلاس پایه انتزاعی، توصیف‌گر باید خود را با استفاده از :attr:`!__isabstractmethod__` به‌عنوان انتزاعی معرفی کند. به‌طور کلی، اگر هر یک از متدهای استفاده‌شده برای تشکیل توصیف‌گر انتزاعی باشند، این ویژگی باید ``True`` باشد. برای مثال، :deco:`property` توکار پایتون معادل زیر را انجام می‌دهد::"
msgid ""
"class Descriptor:\n"
" ...\n"
" @property\n"
" def __isabstractmethod__(self):\n"
" return any(getattr(f, '__isabstractmethod__', False) for\n"
" f in (self._fget, self._fset, self._fdel))"
msgstr ""
"class Descriptor:\n"
" ...\n"
" @property\n"
" def __isabstractmethod__(self):\n"
" return any(getattr(f, '__isabstractmethod__', False) for\n"
" f in (self._fget, self._fset, self._fdel))"
msgid "Unlike Java abstract methods, these abstract methods may have an implementation. This implementation can be called via the :func:`super` mechanism from the class that overrides it. This could be useful as an end-point for a super-call in a framework that uses cooperative multiple-inheritance."
msgstr "برخلاف متدهای انتزاعی جاوا، این متدهای انتزاعی ممکن است پیاده‌سازی داشته باشند. این پیاده‌سازی را می‌توان از طریق سازوکار :func:`super` از کلاسی که آن را بازنویسی می‌کند فراخوانی کرد. این می‌تواند به‌عنوان پایانه‌ای برای فراخوانی super در چارچوبی که از وراثت چندگانه‌ی مشارکتی استفاده می‌کند، مفید باشد."
msgid "The :mod:`!abc` module also supports the following legacy decorators:"
msgstr "ماژول :mod:`!abc` همچنین از دکوراتورهای قدیمی زیر پشتیبانی می‌کند:"
msgid "It is now possible to use :deco:`classmethod` with :deco:`abstractmethod`, making this decorator redundant."
msgstr "اکنون می‌توان از :deco:`classmethod` همراه با :deco:`abstractmethod` استفاده کرد، که این دکوراتور را زائد می‌سازد."
msgid "A subclass of the built-in :class:`classmethod`, indicating an abstract classmethod. Otherwise it is similar to :deco:`abstractmethod`."
msgstr "زیرکلاسی از :class:`classmethod` توکار، که نشان‌دهنده‌ی یک classmethod انتزاعی است. در سایر موارد، مشابه :deco:`abstractmethod` است."
msgid "This special case is deprecated, as the :deco:`classmethod` decorator is now correctly identified as abstract when applied to an abstract method::"
msgstr "این حالت خاص منسوخ شده است، زیرا دکوراتور :deco:`classmethod` اکنون هنگامی که به یک متد انتزاعی اعمال شود، به‌درستی به‌عنوان انتزاعی شناسایی می‌شود::"
msgid ""
"class C(ABC):\n"
" @classmethod\n"
" @abstractmethod\n"
" def my_abstract_classmethod(cls, arg):\n"
" ..."
msgstr ""
"class C(ABC):\n"
" @classmethod\n"
" @abstractmethod\n"
" def my_abstract_classmethod(cls, arg):\n"
" ..."
msgid "It is now possible to use :deco:`staticmethod` with :deco:`abstractmethod`, making this decorator redundant."
msgstr "اکنون می‌توانید از :deco:`staticmethod` همراه با :deco:`abstractmethod` استفاده کنید، که این دکوراتور را زائد می‌کند."
msgid "A subclass of the built-in :class:`staticmethod`, indicating an abstract staticmethod. Otherwise it is similar to :deco:`abstractmethod`."
msgstr "زیرکلاسی از :class:`staticmethod` توکار که نشان‌دهنده یک staticmethod انتزاعی است. در غیر این صورت، مشابه :deco:`abstractmethod` است."
msgid "This special case is deprecated, as the :deco:`staticmethod` decorator is now correctly identified as abstract when applied to an abstract method::"
msgstr "این حالت خاص منسوخ شده است، زیرا دکوراتور :deco:`staticmethod` اکنون هنگامی که به یک متد انتزاعی اعمال شود، به‌درستی به‌عنوان انتزاعی شناسایی می‌شود::"
msgid ""
"class C(ABC):\n"
" @staticmethod\n"
" @abstractmethod\n"
" def my_abstract_staticmethod(arg):\n"
" ..."
msgstr ""
"class C(ABC):\n"
" @staticmethod\n"
" @abstractmethod\n"
" def my_abstract_staticmethod(arg):\n"
" ..."
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."
msgstr "اکنون می‌توان از :deco:`property`، :deco:`property.getter`، :deco:`property.setter` و :deco:`property.deleter` به‌همراه :deco:`abstractmethod` استفاده کرد، که این دکوراتور را زائد می‌کند."
msgid "A subclass of the built-in :class:`property`, indicating an abstract property."
msgstr "زیرکلاسی از :class:`property` توکار، که نشان‌دهنده‌ی یک ویژگی انتزاعی است."
msgid "This special case is deprecated, as the :deco:`property` decorator is now correctly identified as abstract when applied to an abstract method::"
msgstr "این حالت خاص منسوخ شده است، زیرا دکوراتور :deco:`property` اکنون هنگام اعمال بر یک متد انتزاعی به‌درستی به‌عنوان انتزاعی شناسایی می‌شود::"
msgid ""
"class C(ABC):\n"
" @property\n"
" @abstractmethod\n"
" def my_abstract_property(self):\n"
" ..."
msgstr ""
"class C(ABC):\n"
" @property\n"
" @abstractmethod\n"
" def my_abstract_property(self):\n"
" ..."
msgid "The above example defines a read-only property; you can also define a read-write abstract property by appropriately marking one or more of the underlying methods as abstract::"
msgstr "مثال بالا یک ویژگی فقط‌خواندنی تعریف می‌کند؛ شما همچنین می‌توانید با علامت‌گذاری مناسب یک یا چند مورد از متدهای زیربنایی به‌عنوان انتزاعی، یک ویژگی انتزاعی با قابلیت خواندن و نوشتن تعریف کنید::"
msgid ""
"class C(ABC):\n"
" @property\n"
" def x(self):\n"
" ...\n"
"\n"
" @x.setter\n"
" @abstractmethod\n"
" def x(self, val):\n"
" ..."
msgstr ""
"class C(ABC):\n"
" @property\n"
" def x(self):\n"
" ...\n"
"\n"
" @x.setter\n"
" @abstractmethod\n"
" def x(self, val):\n"
" ..."
msgid "If only some components are abstract, only those components need to be updated to create a concrete property in a subclass::"
msgstr "اگر تنها برخی از کامپوننت‌ها انتزاعی باشند، تنها همان کامپوننت‌ها باید به‌روزرسانی شوند تا یک پراپرتی عینی در یک زیرکلاس ایجاد شود::"
msgid ""
"class D(C):\n"
" @C.x.setter\n"
" def x(self, val):\n"
" ..."
msgstr ""
"class D(C):\n"
" @C.x.setter\n"
" def x(self, val):\n"
" ..."
msgid "The :mod:`!abc` module also provides the following functions:"
msgstr "ماژول :mod:`!abc` همچنین توابع زیر را فراهم می‌کند:"
msgid "Returns the current abstract base class cache token."
msgstr "توکن فعلی نهانگاه کلاس پایه انتزاعی را بازمی‌گرداند."
msgid "The token is an opaque object (that supports equality testing) identifying the current version of the abstract base class cache for virtual subclasses. The token changes with every call to :meth:`ABCMeta.register` on any ABC."
msgstr "توکن یک شیء غیرشفاف است (که از آزمون برابری پشتیبانی می‌کند) و نسخه کنونی نهانگاه کلاس پایه انتزاعی برای زیرکلاس‌های مجازی را شناسایی می‌کند. توکن با هر فراخوانی :meth:`ABCMeta.register` روی هر ABC تغییر می‌کند."
msgid "A function to recalculate an abstract class's abstraction status. This function should be called if a class's abstract methods have been implemented or changed after it was created. Usually, this function should be called from within a class decorator."
msgstr "تابعی برای محاسبه‌ی مجدد وضعیت انتزاعی بودن یک کلاس انتزاعی. اگر متدهای انتزاعی یک کلاس پس از ایجاد آن پیاده‌سازی یا تغییر کرده باشند، باید این تابع فراخوانی شود. معمولاً این تابع باید از درون یک دکوراتور کلاس فراخوانی شود."
msgid "Returns *cls*, to allow usage as a class decorator."
msgstr "*cls* را برمی‌گرداند تا امکان استفاده به‌عنوان دکوراتور کلاس فراهم شود."
msgid "If *cls* is not an instance of :class:`ABCMeta`, does nothing."
msgstr "اگر *cls* نمونه‌ای از :class:`ABCMeta` نباشد، هیچ کاری انجام نمی‌دهد."
msgid "This function assumes that *cls*'s superclasses are already updated. It does not update any subclasses."
msgstr "این تابع فرض می‌کند که ابرکلاس‌های *cls* از قبل به‌روزرسانی شده‌اند. این تابع هیچ زیرکلاسی را به‌روزرسانی نمی‌کند."
msgid "Footnotes"
msgstr "پانویس‌ها"
msgid "C++ programmers should note that Python's virtual base class concept is not the same as C++'s."
msgstr "برنامه‌نویسان C++ باید توجه داشته باشند که مفهوم کلاس پایه مجازی در پایتون، با مفهوم آن در C++ یکسان نیست."