iframe-proxy | Sunbelt Computer Software

672 lines (565 loc) · 22.2 KB
# 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
# Danial Behzadi <dani.behzi@ubuntu.com>, 2025
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-07-11 14:21+0000\n"
"PO-Revision-Date: 2021-06-28 01:19+0000\n"
"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2025\n"
"Language-Team: Persian (https://app.transifex.com/python-doc/teams/5390/"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: fa\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
#: ../../reference/executionmodel.rst:6
msgid "Execution model"
#: ../../reference/executionmodel.rst:15
msgid "Structure of a program"
#: ../../reference/executionmodel.rst:19
"A Python program is constructed from code blocks. A :dfn:`block` is a piece "
"of Python program text that is executed as a unit. The following are blocks: "
"a module, a function body, and a class definition. Each command typed "
"interactively is a block.  A script file (a file given as standard input to "
"the interpreter or specified as a command line argument to the interpreter) "
"is a code block.  A script command (a command specified on the interpreter "
"command line with the :option:`-c` option) is a code block. A module run as "
"a top level script (as module ``__main__``) from the command line using a :"
"option:`-m` argument is also a code block. The string argument passed to the "
"built-in functions :func:`eval` and :func:`exec` is a code block."
#: ../../reference/executionmodel.rst:33
"A code block is executed in an :dfn:`execution frame`.  A frame contains "
"some administrative information (used for debugging) and determines where "
"and how execution continues after the code block's execution has completed."
#: ../../reference/executionmodel.rst:40
msgid "Naming and binding"
#: ../../reference/executionmodel.rst:49
msgid "Binding of names"
#: ../../reference/executionmodel.rst:55
":dfn:`Names` refer to objects.  Names are introduced by name binding "
"operations."
#: ../../reference/executionmodel.rst:59
msgid "The following constructs bind names:"
#: ../../reference/executionmodel.rst:61
msgid "formal parameters to functions,"
#: ../../reference/executionmodel.rst:62
msgid "class definitions,"
#: ../../reference/executionmodel.rst:63
msgid "function definitions,"
#: ../../reference/executionmodel.rst:64
msgid "assignment expressions,"
#: ../../reference/executionmodel.rst:65
":ref:`targets <assignment>` that are identifiers if occurring in an "
"assignment:"
#: ../../reference/executionmodel.rst:68
msgid ":keyword:`for` loop header,"
#: ../../reference/executionmodel.rst:69
"after :keyword:`!as` in a :keyword:`with` statement, :keyword:`except` "
"clause, :keyword:`except* <except_star>` clause, or in the as-pattern in "
"structural pattern matching,"
#: ../../reference/executionmodel.rst:71
msgid "in a capture pattern in structural pattern matching"
#: ../../reference/executionmodel.rst:73
msgid ":keyword:`import` statements."
#: ../../reference/executionmodel.rst:74
msgid ":keyword:`type` statements."
#: ../../reference/executionmodel.rst:75
msgid ":ref:`type parameter lists <type-params>`."
#: ../../reference/executionmodel.rst:77
"The :keyword:`!import` statement of the form ``from ... import *`` binds all "
"names defined in the imported module, except those beginning with an "
"underscore. This form may only be used at the module level."
#: ../../reference/executionmodel.rst:81
"A target occurring in a :keyword:`del` statement is also considered bound "
"for this purpose (though the actual semantics are to unbind the name)."
#: ../../reference/executionmodel.rst:84
"Each assignment or import statement occurs within a block defined by a class "
"or function definition or at the module level (the top-level code block)."
#: ../../reference/executionmodel.rst:89
"If a name is bound in a block, it is a local variable of that block, unless "
"declared as :keyword:`nonlocal` or :keyword:`global`.  If a name is bound at "
"the module level, it is a global variable.  (The variables of the module "
"code block are local and global.)  If a variable is used in a code block but "
"not defined there, it is a :term:`free variable`."
#: ../../reference/executionmodel.rst:95
"Each occurrence of a name in the program text refers to the :dfn:`binding` "
"of that name established by the following name resolution rules."
#: ../../reference/executionmodel.rst:101
msgid "Resolution of names"
#: ../../reference/executionmodel.rst:105
"A :dfn:`scope` defines the visibility of a name within a block.  If a local "
"variable is defined in a block, its scope includes that block.  If the "
"definition occurs in a function block, the scope extends to any blocks "
"contained within the defining one, unless a contained block introduces a "
"different binding for the name."
#: ../../reference/executionmodel.rst:113
"When a name is used in a code block, it is resolved using the nearest "
"enclosing scope.  The set of all such scopes visible to a code block is "
"called the block's :dfn:`environment`."
#: ../../reference/executionmodel.rst:121
"When a name is not found at all, a :exc:`NameError` exception is raised. If "
"the current scope is a function scope, and the name refers to a local "
"variable that has not yet been bound to a value at the point where the name "
"is used, an :exc:`UnboundLocalError` exception is raised. :exc:"
"`UnboundLocalError` is a subclass of :exc:`NameError`."
#: ../../reference/executionmodel.rst:127
"If a name binding operation occurs anywhere within a code block, all uses of "
"the name within the block are treated as references to the current block.  "
"This can lead to errors when a name is used within a block before it is "
"bound.  This rule is subtle.  Python lacks declarations and allows name "
"binding operations to occur anywhere within a code block.  The local "
"variables of a code block can be determined by scanning the entire text of "
"the block for name binding operations. See :ref:`the FAQ entry on "
"UnboundLocalError <faq-unboundlocalerror>` for examples."
#: ../../reference/executionmodel.rst:136
"If the :keyword:`global` statement occurs within a block, all uses of the "
"names specified in the statement refer to the bindings of those names in the "
"top-level namespace.  Names are resolved in the top-level namespace by "
"searching the global namespace, i.e. the namespace of the module containing "
"the code block, and the builtins namespace, the namespace of the module :mod:"
"`builtins`.  The global namespace is searched first.  If the names are not "
"found there, the builtins namespace is searched next. If the names are also "
"not found in the builtins namespace, new variables are created in the global "
"namespace. The global statement must precede all uses of the listed names."
#: ../../reference/executionmodel.rst:146
"The :keyword:`global` statement has the same scope as a name binding "
"operation in the same block.  If the nearest enclosing scope for a free "
"variable contains a global statement, the free variable is treated as a "
#: ../../reference/executionmodel.rst:152
"The :keyword:`nonlocal` statement causes corresponding names to refer to "
"previously bound variables in the nearest enclosing function scope. :exc:"
"`SyntaxError` is raised at compile time if the given name does not exist in "
"any enclosing function scope. :ref:`Type parameters <type-params>` cannot be "
"rebound with the :keyword:`!nonlocal` statement."
#: ../../reference/executionmodel.rst:160
"The namespace for a module is automatically created the first time a module "
"is imported.  The main module for a script is always called :mod:`__main__`."
#: ../../reference/executionmodel.rst:163
"Class definition blocks and arguments to :func:`exec` and :func:`eval` are "
"special in the context of name resolution. A class definition is an "
"executable statement that may use and define names. These references follow "
"the normal rules for name resolution with an exception that unbound local "
"variables are looked up in the global namespace. The namespace of the class "
"definition becomes the attribute dictionary of the class. The scope of names "
"defined in a class block is limited to the class block; it does not extend "
"to the code blocks of methods. This includes comprehensions and generator "
"expressions, but it does not include :ref:`annotation scopes <annotation-"
"scopes>`, which have access to their enclosing class scopes. This means that "
"the following will fail::"
#: ../../reference/executionmodel.rst:176
"class A:\n"
"    a = 42\n"
"    b = list(a + i for i in range(10))"
#: ../../reference/executionmodel.rst:180
msgid "However, the following will succeed::"
#: ../../reference/executionmodel.rst:182
"class A:\n"
"    type Alias = Nested\n"
"    class Nested: pass\n"
"print(A.Alias.__value__)  # <type 'A.Nested'>"
#: ../../reference/executionmodel.rst:191
msgid "Annotation scopes"
#: ../../reference/executionmodel.rst:193
":term:`Annotations <annotation>`, :ref:`type parameter lists <type-params>` "
"and :keyword:`type` statements introduce *annotation scopes*, which behave "
"mostly like function scopes, but with some exceptions discussed below."
#: ../../reference/executionmodel.rst:198
msgid "Annotation scopes are used in the following contexts:"
#: ../../reference/executionmodel.rst:200
msgid ":term:`Function annotations <function annotation>`."
#: ../../reference/executionmodel.rst:201
msgid ":term:`Variable annotations <variable annotation>`."
#: ../../reference/executionmodel.rst:202
"Type parameter lists for :ref:`generic type aliases <generic-type-aliases>`."
#: ../../reference/executionmodel.rst:203
"Type parameter lists for :ref:`generic functions <generic-functions>`. A "
"generic function's annotations are executed within the annotation scope, but "
"its defaults and decorators are not."
#: ../../reference/executionmodel.rst:206
"Type parameter lists for :ref:`generic classes <generic-classes>`. A generic "
"class's base classes and keyword arguments are executed within the "
"annotation scope, but its decorators are not."
#: ../../reference/executionmodel.rst:209
"The bounds, constraints, and default values for type parameters (:ref:"
"`lazily evaluated <lazy-evaluation>`)."
#: ../../reference/executionmodel.rst:211
msgid "The value of type aliases (:ref:`lazily evaluated <lazy-evaluation>`)."
#: ../../reference/executionmodel.rst:213
msgid "Annotation scopes differ from function scopes in the following ways:"
#: ../../reference/executionmodel.rst:215
"Annotation scopes have access to their enclosing class namespace. If an "
"annotation scope is immediately within a class scope, or within another "
"annotation scope that is immediately within a class scope, the code in the "
"annotation scope can use names defined in the class scope as if it were "
"executed directly within the class body. This contrasts with regular "
"functions defined within classes, which cannot access names defined in the "
"class scope."
#: ../../reference/executionmodel.rst:221
"Expressions in annotation scopes cannot contain :keyword:`yield`, ``yield "
"from``, :keyword:`await`, or :token:`:= <python-grammar:"
"assignment_expression>` expressions. (These expressions are allowed in other "
"scopes contained within the annotation scope.)"
#: ../../reference/executionmodel.rst:225
"Names defined in annotation scopes cannot be rebound with :keyword:"
"`nonlocal` statements in inner scopes. This includes only type parameters, "
"as no other syntactic elements that can appear within annotation scopes can "
"introduce new names."
#: ../../reference/executionmodel.rst:228
"While annotation scopes have an internal name, that name is not reflected in "
"the :term:`qualified name` of objects defined within the scope. Instead, "
"the :attr:`~definition.__qualname__` of such objects is as if the object "
"were defined in the enclosing scope."
#: ../../reference/executionmodel.rst:233
msgid "Annotation scopes were introduced in Python 3.12 as part of :pep:`695`."
#: ../../reference/executionmodel.rst:236
"Annotation scopes are also used for type parameter defaults, as introduced "
"by :pep:`696`."
#: ../../reference/executionmodel.rst:240
"Annotation scopes are now also used for annotations, as specified in :pep:"
"`649` and :pep:`749`."
#: ../../reference/executionmodel.rst:247
msgid "Lazy evaluation"
#: ../../reference/executionmodel.rst:249
"Most annotation scopes are *lazily evaluated*. This includes annotations, "
"the values of type aliases created through the :keyword:`type` statement, "
"and the bounds, constraints, and default values of type variables created "
"through the :ref:`type parameter syntax <type-params>`. This means that they "
"are not evaluated when the type alias or type variable is created, or when "
"the object carrying annotations is created. Instead, they are only evaluated "
"when necessary, for example when the ``__value__`` attribute on a type alias "
"is accessed."
#: ../../reference/executionmodel.rst:258
msgid "Example:"
#: ../../reference/executionmodel.rst:260
">>> type Alias = 1/0\n"
">>> Alias.__value__\n"
"Traceback (most recent call last):\n"
"ZeroDivisionError: division by zero\n"
">>> def func[T: 1/0](): pass\n"
">>> T = func.__type_params__[0]\n"
">>> T.__bound__\n"
"Traceback (most recent call last):\n"
"ZeroDivisionError: division by zero"
#: ../../reference/executionmodel.rst:274
"Here the exception is raised only when the ``__value__`` attribute of the "
"type alias or the ``__bound__`` attribute of the type variable is accessed."
#: ../../reference/executionmodel.rst:278
"This behavior is primarily useful for references to types that have not yet "
"been defined when the type alias or type variable is created. For example, "
"lazy evaluation enables creation of mutually recursive type aliases::"
#: ../../reference/executionmodel.rst:282
"from typing import Literal\n"
"type SimpleExpr = int | Parenthesized\n"
"type Parenthesized = tuple[Literal[\"(\"], Expr, Literal[\")\"]]\n"
"type Expr = SimpleExpr | tuple[SimpleExpr, Literal[\"+\", \"-\"], Expr]"
#: ../../reference/executionmodel.rst:288
"Lazily evaluated values are evaluated in :ref:`annotation scope <annotation-"
"scopes>`, which means that names that appear inside the lazily evaluated "
"value are looked up as if they were used in the immediately enclosing scope."
#: ../../reference/executionmodel.rst:297
msgid "Builtins and restricted execution"
#: ../../reference/executionmodel.rst:303
"Users should not touch ``__builtins__``; it is strictly an implementation "
"detail.  Users wanting to override values in the builtins namespace should :"
"keyword:`import` the :mod:`builtins` module and modify its attributes "
"appropriately."
#: ../../reference/executionmodel.rst:308
"The builtins namespace associated with the execution of a code block is "
"actually found by looking up the name ``__builtins__`` in its global "
"namespace; this should be a dictionary or a module (in the latter case the "
"module's dictionary is used).  By default, when in the :mod:`__main__` "
"module, ``__builtins__`` is the built-in module :mod:`builtins`; when in any "
"other module, ``__builtins__`` is an alias for the dictionary of the :mod:"
"`builtins` module itself."
#: ../../reference/executionmodel.rst:320
msgid "Interaction with dynamic features"
#: ../../reference/executionmodel.rst:322
"Name resolution of free variables occurs at runtime, not at compile time. "
"This means that the following code will print 42::"
#: ../../reference/executionmodel.rst:325
"def f():\n"
"    print(i)\n"
#: ../../reference/executionmodel.rst:333
"The :func:`eval` and :func:`exec` functions do not have access to the full "
"environment for resolving names.  Names may be resolved in the local and "
"global namespaces of the caller.  Free variables are not resolved in the "
"nearest enclosing namespace, but in the global namespace.  [#]_ The :func:"
"`exec` and :func:`eval` functions have optional arguments to override the "
"global and local namespace.  If only one namespace is specified, it is used "
"for both."
#: ../../reference/executionmodel.rst:347
msgid "Exceptions"
#: ../../reference/executionmodel.rst:358
"Exceptions are a means of breaking out of the normal flow of control of a "
"code block in order to handle errors or other exceptional conditions.  An "
"exception is *raised* at the point where the error is detected; it may be "
"*handled* by the surrounding code block or by any code block that directly "
"or indirectly invoked the code block where the error occurred."
#: ../../reference/executionmodel.rst:364
"The Python interpreter raises an exception when it detects a run-time error "
"(such as division by zero).  A Python program can also explicitly raise an "
"exception with the :keyword:`raise` statement. Exception handlers are "
"specified with the :keyword:`try` ... :keyword:`except` statement.  The :"
"keyword:`finally` clause of such a statement can be used to specify cleanup "
"code which does not handle the exception, but is executed whether an "
"exception occurred or not in the preceding code."
#: ../../reference/executionmodel.rst:374
"Python uses the \"termination\" model of error handling: an exception "
"handler can find out what happened and continue execution at an outer level, "
"but it cannot repair the cause of the error and retry the failing operation "
"(except by re-entering the offending piece of code from the top)."
#: ../../reference/executionmodel.rst:381
"When an exception is not handled at all, the interpreter terminates "
"execution of the program, or returns to its interactive main loop.  In "
"either case, it prints a stack traceback, except when the exception is :exc:"
"`SystemExit`."
#: ../../reference/executionmodel.rst:385
"Exceptions are identified by class instances.  The :keyword:`except` clause "
"is selected depending on the class of the instance: it must reference the "
"class of the instance or a :term:`non-virtual base class <abstract base "
"class>` thereof. The instance can be received by the handler and can carry "
"additional information about the exceptional condition."
#: ../../reference/executionmodel.rst:393
"Exception messages are not part of the Python API.  Their contents may "
"change from one version of Python to the next without warning and should not "
"be relied on by code which will run under multiple versions of the "
"interpreter."
#: ../../reference/executionmodel.rst:397
"See also the description of the :keyword:`try` statement in section :ref:"
"`try` and :keyword:`raise` statement in section :ref:`raise`."
#: ../../reference/executionmodel.rst:402
msgid "Footnotes"
#: ../../reference/executionmodel.rst:403
"This limitation occurs because the code that is executed by these operations "
"is not available at the time the module is compiled."
#: ../../reference/executionmodel.rst:8
msgid "execution model"
#: ../../reference/executionmodel.rst:8
msgid "code"
#: ../../reference/executionmodel.rst:8 ../../reference/executionmodel.rst:17
msgid "block"
#: ../../reference/executionmodel.rst:31 ../../reference/executionmodel.rst:299
msgid "execution"
#: ../../reference/executionmodel.rst:31
msgid "frame"
#: ../../reference/executionmodel.rst:42
msgid "namespace"
#: ../../reference/executionmodel.rst:42 ../../reference/executionmodel.rst:103
msgid "scope"
#: ../../reference/executionmodel.rst:51
msgid "name"
#: ../../reference/executionmodel.rst:51
msgid "binding"
#: ../../reference/executionmodel.rst:57
msgid "from"
#: ../../reference/executionmodel.rst:57
msgid "import statement"
#: ../../reference/executionmodel.rst:87
msgid "free"
#: ../../reference/executionmodel.rst:87
msgid "variable"
#: ../../reference/executionmodel.rst:111
msgid "environment"
#: ../../reference/executionmodel.rst:117
msgid "NameError (built-in exception)"
#: ../../reference/executionmodel.rst:117
msgid "UnboundLocalError"
#: ../../reference/executionmodel.rst:158
msgid "module"
#: ../../reference/executionmodel.rst:158
msgid "__main__"
#: ../../reference/executionmodel.rst:299
msgid "restricted"
#: ../../reference/executionmodel.rst:349
msgid "exception"
#: ../../reference/executionmodel.rst:351
msgid "raise an exception"
#: ../../reference/executionmodel.rst:351
msgid "handle an exception"
#: ../../reference/executionmodel.rst:351
msgid "exception handler"
#: ../../reference/executionmodel.rst:351
msgid "errors"
#: ../../reference/executionmodel.rst:351
msgid "error handling"
#: ../../reference/executionmodel.rst:372
msgid "termination model"
#: ../../reference/executionmodel.rst:379
msgid "SystemExit (built-in exception)"
Sunbelt Computer Software

PL/B Language Development and Support

Navigation Menu

Uh oh!

Sunbelt Computer Software

PL/B Language Development and Support

Uh oh!

FilesExpand file tree

executionmodel.po

Latest commit

History

executionmodel.po

File metadata and controls
