# 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:

# python-doc bot, 2025

# Dmitry Luschan, 2026

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.15\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2026-10-17 16:44+0000\n"

"PO-Revision-Date: 2025-09-16 00:02+0000\n"

"Last-Translator: Dmitry Luschan, 2026\n"

"Language-Team: Russian (https://app.transifex.com/python-doc/teams/5390/"

"ru/)\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Language: ru\n"

"Plural-Forms: nplurals=4; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && "

"n%10<=4 && (n%100<12 || n%100>14) ? 1 : n%10==0 || (n%10>=5 && n%10<=9) || "

"(n%100>=11 && n%100<=14)? 2 : 3);\n"

msgid "Modules"

msgstr "Модули"

msgid ""

"If you quit from the Python interpreter and enter it again, the definitions "

"you have made (functions and variables) are lost. Therefore, if you want to "

"write a somewhat longer program, you are better off using a text editor to "

"prepare the input for the interpreter and running it with that file as input "

"instead. This is known as creating a *script*. As your program gets "

"longer, you may want to split it into several files for easier maintenance. "

"You may also want to use a handy function that you've written in several "

"programs without copying its definition into each program."

msgstr ""

"Если вы выйдете из интерпретатора Python и войдёте в него снова, сделанные "

"вами определения (функции и переменные) будут потеряны. Поэтому, если вы "

"хотите написать более длинную программу, вам лучше использовать текстовый "

"редактор, чтобы подготовить ввод для интерпретатора, и запустить его с этим "

"файлом в качестве входных данных. Это называется созданием *скрипта*. По "

"мере того, как ваша программа становится длиннее, вы можете разделить ее на "

"несколько файлов для упрощения обслуживания. Вы также можете использовать "

"удобную функцию, которую вы написали в нескольких программах, не копируя ее "

"определение в каждую программу."

msgid ""

"To support this, Python has a way to put definitions in a file and use them "

"in a script or in an interactive instance of the interpreter. Such a file is "

"called a *module*; definitions from a module can be *imported* into other "

"modules or into the *main* module (the collection of variables that you have "

"access to in a script executed at the top level and in calculator mode)."

msgstr ""

"Чтобы поддержать это, в Python есть способ поместить определения в файл и "

"использовать их в скрипте или в интерактивном экземпляре интерпретатора. "

"Такой файл называется *модулем*; определения из модуля могут быть "

"*импортированы* в другие модули или в *главный* модуль (набор переменных, к "

"которым у вас есть доступ в скрипте, выполняемом на верхнем уровне и в "

"режиме калькулятора)."

msgid ""

"A module is a file containing Python definitions and statements. The file "

"name is the module name with the suffix :file:`.py` appended. Within a "

"module, the module's name (as a string) is available as the value of the "

"global variable ``__name__``. For instance, use your favorite text editor "

"to create a file called :file:`fibo.py` in the current directory with the "

"following contents::"

msgstr ""

"Модуль — это файл, содержащий определения и инструкции Python. Имя файла — "

"это имя модуля с суффиксом :file:`.py`. Внутри модуля его имя (в виде "

"строки) доступно как значение глобальной переменной ``__name__``. Например, "

"используйте ваш любимый текстовый редактор, чтобы создать файл с "

"именем :file:`fibo.py` в текущем каталоге со следующим содержимым:"

msgid ""

"# Fibonacci numbers module\n"

"\n"

"def fib(n):\n"

" \"\"\"Write Fibonacci series up to n.\"\"\"\n"

" a, b = 0, 1\n"

" while a < n:\n"

" print(a, end=' ')\n"

" a, b = b, a+b\n"

" print()\n"

"\n"

"def fib2(n):\n"

" \"\"\"Return Fibonacci series up to n.\"\"\"\n"

" result = []\n"

" a, b = 0, 1\n"

" while a < n:\n"

" result.append(a)\n"

" a, b = b, a+b\n"

" return result"

msgstr ""

"# Модуль чисел Фибоначчи\n"

"\n"

"def fib(n):\n"

" \"\"\"Вывести ряд Фибоначчи до n.\"\"\"\n"

" a, b = 0, 1\n"

" while a < n:\n"

" print(a, end=' ')\n"

" a, b = b, a+b\n"

" print()\n"

"\n"

"def fib2(n):\n"

" \"\"\"Вернуть ряд Фибоначчи до n.\"\"\"\n"

" result = []\n"

" a, b = 0, 1\n"

" while a < n:\n"

" result.append(a)\n"

" a, b = b, a+b\n"

" return result"

msgid ""

"Now enter the Python interpreter and import this module with the following "

"command::"

msgstr ""

"Теперь запустите интерпретатор Python и импортируйте этот модуль с помощью "

"следующей команды:"

msgid ">>> import fibo"

msgstr ">>> import fibo"

msgid ""

"This does not add the names of the functions defined in ``fibo`` directly "

"to the current :term:`namespace` (see :ref:`tut-scopes` for more details); "

"it only adds the module name ``fibo`` there. Using the module name you can "

"access the functions::"

msgstr ""

"Эта команда не добавляет имена функций, определенных в ``fibo``, "

"непосредственно в текущее :term:`пространство имён <namespace>` (подробности "

"см. :ref:`tut-scopes`) — она лишь добавляет туда имя модуля ``fibo``. "

"Используя имя модуля, вы можете получить доступ к функциям::"

msgid ""

">>> fibo.fib(1000)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987\n"

">>> fibo.fib2(100)\n"

"[0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89]\n"

">>> fibo.__name__\n"

"'fibo'"

msgstr ""

">>> fibo.fib(1000)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987\n"

">>> fibo.fib2(100)\n"

"[0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89]\n"

">>> fibo.__name__\n"

"'fibo'"

msgid ""

"If you intend to use a function often you can assign it to a local name::"

msgstr ""

"Если вы собираетесь часто использовать функцию, вы можете присвоить её "

"локальному имени:"

msgid ""

">>> fib = fibo.fib\n"

">>> fib(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

msgstr ""

">>> fib = fibo.fib\n"

">>> fib(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

msgid "More on Modules"

msgstr "Подробнее о модулях"

msgid ""

"A module can contain executable statements as well as function definitions. "

"These statements are intended to initialize the module. They are executed "

"only the *first* time the module name is encountered in an import statement. "

"[#]_ (They are also run if the file is executed as a script.)"

msgstr ""

"Модуль может содержать исполняемые инструкции, а также определения функций. "

"Эти инструкции предназначены для инициализации модуля. Они выполняются "

"только в *первый* раз, когда имя модуля встречается в инструкции импорта. "

"[#]_ (Они также выполняются, если файл выполняется как скрипт.)"

msgid ""

"Each module has its own private namespace, which is used as the global "

"namespace by all functions defined in the module. Thus, the author of a "

"module can use global variables in the module without worrying about "

"accidental clashes with a user's global variables. On the other hand, if you "

"know what you are doing you can touch a module's global variables with the "

"same notation used to refer to its functions, ``modname.itemname``."

msgstr ""

"Каждый модуль имеет своё собственное приватное пространство имён, которое "

"используется как глобальное пространство имён всеми функциями, определёнными "

"в модуле. Таким образом, автор модуля может использовать глобальные "

"переменные в модуле, не беспокоясь о случайных конфликтах с глобальными "

"переменными пользователя. С другой стороны, если вы знаете, что делаете, вы "

"можете обращаться к глобальным переменным модуля так же, как к его функциям: "

"``modname.itemname``."

msgid ""

"Modules can import other modules. It is customary but not required to place "

"all :keyword:`import` statements at the beginning of a module (or script, "

"for that matter). The imported module names, if placed at the top level of "

"a module (outside any functions or classes), are added to the module's "

"global namespace."

msgstr ""

"Модули могут импортировать другие модули. Обычно принято, но не обязательно, "

"размещать все инструкции :keyword:`import` в начале модуля (или скрипта, "

"если на то пошло). Имена модулей, которые были импортированы на верхнем "

"уровне модуля (вне каких-либо функций или классов), добавляются в его "

"глобальное пространство имён."

msgid ""

"There is a variant of the :keyword:`import` statement that imports names "

"from a module directly into the importing module's namespace. For example::"

msgstr ""

"Существует вариант инструкции :keyword:`import`, который импортирует имена "

"из модуля прямо в пространство имён импортирующего модуля. Например::"

msgid ""

">>> from fibo import fib, fib2\n"

">>> fib(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

msgstr ""

">>> from fibo import fib, fib2\n"

">>> fib(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

msgid ""

"This does not introduce the module name from which the imports are taken in "

"the local namespace (so in the example, ``fibo`` is not defined)."

msgstr ""

"Это не добавляет имя модуля, из которого осуществляется импорт, в локальном "

"пространстве имён (поэтому в примере ``fibo`` не определено)."

msgid "There is even a variant to import all names that a module defines::"

msgstr "Есть даже вариант импортировать все имена, определённые в модуле:"

msgid ""

">>> from fibo import *\n"

">>> fib(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

msgstr ""

">>> from fibo import *\n"

">>> fib(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

msgid ""

"This imports all names except those beginning with an underscore (``_``). In "

"most cases Python programmers do not use this facility since it introduces "

"an unknown set of names into the interpreter, possibly hiding some things "

"you have already defined."

msgstr ""

"При этом будут импортированы все имена, кроме тех, которые начинаются с "

"подчеркивания (``_``). В большинстве случаев Python-программисты не "

"используют эту возможность, поскольку она добавляет в интерпретатор "

"неизвестный набор имён и может скрыть те, что вы уже определили."

msgid ""

"Note that in general the practice of importing ``*`` from a module or "

"package is frowned upon, since it often causes poorly readable code. "

"However, it is okay to use it to save typing in interactive sessions."

msgstr ""

"Обратите внимание, что в целом практика импорта ``*`` из модуля или пакета "

"не одобряется, поскольку часто приводит к плохо читаемому коду. Однако в "

"интерактивных сеансах это допустимо, чтобы сократить объём ввода."

msgid ""

"If the module name is followed by :keyword:`!as`, then the name "

"following :keyword:`!as` is bound directly to the imported module."

msgstr ""

"Если после имени модуля указано :keyword:`!as`, то имя, следующее "

"за :keyword:`!as`, привязывается непосредственно к импортированному модулю."

msgid ""

">>> import fibo as fib\n"

">>> fib.fib(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

msgstr ""

">>> import fibo as fib\n"

">>> fib.fib(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

msgid ""

"This is effectively importing the module in the same way that ``import "

"fibo`` will do, with the only difference of it being available as ``fib``."

msgstr ""

"Это фактически импортирует модуль так же, как и ``import fibo``, с той лишь "

"разницей, что он доступен как ``fib``."

msgid ""

"It can also be used when utilising :keyword:`from` with similar effects::"

msgstr ""

"Это также можно использовать с :keyword:`from`, что даёт аналогичный эффект::"

msgid ""

">>> from fibo import fib as fibonacci\n"

">>> fibonacci(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

msgstr ""

">>> from fibo import fib as fibonacci\n"

">>> fibonacci(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

msgid ""

"For efficiency reasons, each module is only imported once per interpreter "

"session. Therefore, if you change your modules, you must restart the "

"interpreter -- or, if it's just one module you want to test interactively, "

"use :func:`importlib.reload`, e.g. ``import importlib; "

"importlib.reload(modulename)``."

msgstr ""

"По соображениям эффективности каждый модуль импортируется только один раз за "

"сеанс интерпретатора. Поэтому, если вы меняете свои модули, вы должны "

"перезапустить интерпретатор — или, если вы хотите протестировать в "

"интерактивном режиме только один модуль, "

"использовать :func:`importlib.reload`, например ``import importlib; "

"importlib.reload(имя модуля)``."

msgid "Executing modules as scripts"

msgstr "Выполнение модулей как скриптов"

msgid "When you run a Python module with ::"

msgstr "Когда вы запускаете модуль Python с помощью ::"

msgid "python fibo.py <arguments>"

msgstr "python fibo.py <arguments>"

msgid ""

"the code in the module will be executed, just as if you imported it, but "

"with the ``__name__`` set to ``\"__main__\"``. That means that by adding "

"this code at the end of your module::"

msgstr ""

"код в модуле будет выполнен так же, как если бы вы его импортировали, но с "

"параметром ``__name__``, установленным в ``\"__main__\"``. Это означает, что "

"добавив этот код в конец вашего модуля:"

msgid ""

"if __name__ == \"__main__\":\n"

" import sys\n"

" fib(int(sys.argv[1]))"

msgstr ""

"if __name__ == \"__main__\":\n"

" import sys\n"

" fib(int(sys.argv[1]))"

msgid ""

"you can make the file usable as a script as well as an importable module, "

"because the code that parses the command line only runs if the module is "

"executed as the \"main\" file:"

msgstr ""

"вы можете сделать файл пригодным как в качестве скрипта, так и в качестве "

"импортируемого модуля, поскольку код, анализирующий аргументы командной "

"строки, запускается только если модуль выполняется как «основной» файл:"

msgid ""

"$ python fibo.py 50\n"

"0 1 1 2 3 5 8 13 21 34"

msgstr ""

"$ python fibo.py 50\n"

"0 1 1 2 3 5 8 13 21 34"

msgid "If the module is imported, the code is not run::"

msgstr "Если модуль импортирован, этот код не выполняется::"

msgid ""

">>> import fibo\n"

">>>"

msgstr ""

">>> import fibo\n"

">>>"

msgid ""

"This is often used either to provide a convenient user interface to a "

"module, or for testing purposes (running the module as a script executes a "

"test suite)."

msgstr ""

"Это часто используется либо для предоставления удобного пользовательского "

"интерфейса к модулю, либо для целей тестирования (запуск модуля как скрипта "

"запускает набор тестов)."

msgid "The Module Search Path"

msgstr "Путь поиска модулей"

msgid ""

"When a module named :mod:`!spam` is imported, the interpreter first searches "

"for a built-in module with that name. These module names are listed "

"in :data:`sys.builtin_module_names`. If not found, it then searches for a "

"file named :file:`spam.py` in a list of directories given by the "

"variable :data:`sys.path`. :data:`sys.path` is initialized from these "

"locations:"

msgstr ""

"Когда импортируется модуль с именем :mod:`!spam`, интерпретатор сначала ищет "

"встроенный модуль с таким именем. Имена этих модулей перечислены "

"в :data:`sys.builtin_module_names`. Если его там нет, интерпретатор ищет "

"файл с именем :file:`spam.py` в каталогах, список которых задаётся "

"переменной :data:`sys.path`. :data:`sys.path` инициализируется из следующих "

"источников:"

msgid ""

"The directory containing the input script (or the current directory when no "

"file is specified)."

msgstr ""

"Каталог, содержащий входной скрипт (или текущий каталог, если файл не "

"указан)."

msgid ""

":envvar:`PYTHONPATH` (a list of directory names, with the same syntax as the "

"shell variable :envvar:`PATH`)."

msgstr ""

":envvar:`PYTHONPATH` (список имён каталогов с тем же синтаксисом, что и "

"переменная окружения :envvar:`PATH`)."

msgid ""

"The installation-dependent default (by convention including a ``site-"

"packages`` directory, handled by the :mod:`site` module)."

msgstr ""

"Значение по умолчанию, определяемое способом установки Python (обычно "

"включает каталог ``site-packages``, который обрабатывается "

"модулем :mod:`site`)."

msgid "More details are at :ref:`sys-path-init`."

msgstr "Более подробная информация приведена в :ref:`sys-path-init`."

msgid ""

"On file systems which support symlinks, the directory containing the input "

"script is calculated after the symlink is followed. In other words the "

"directory containing the symlink is **not** added to the module search path."

msgstr ""

"В файловых системах, поддерживающих символические ссылки, каталог, "

"содержащий входной скрипт, определяется после перехода по символической "

"ссылке. Другими словами, каталог, содержащий символическую ссылку, **не** "

"добавляется в путь поиска модулей."

msgid ""

"After initialization, Python programs can modify :data:`sys.path`. The "

"directory containing the script being run is placed at the beginning of the "

"search path, ahead of the standard library path. This means that scripts in "

"that directory will be loaded instead of modules of the same name in the "

"library directory. This is an error unless the replacement is intended. See "

"section :ref:`tut-standardmodules` for more information."

msgstr ""

"После инициализации Python-программы могут изменять :data:`sys.path` "

"вручную. Кроме того, каталог, содержащий выполняемый скрипт, помещается в "

"начало пути поиска модулей — перед путями стандартной библиотеки. Из-за "

"этого файлы из этого каталога будут загружаться вместо библиотечных модулей "

"с тем же именем. Такая подмена считается ошибкой, если она не была "

"намеренной. Подробнее см. раздел :ref:`tut-standardmodules`."

msgid "\"Compiled\" Python files"

msgstr "«Скомпилированные» файлы Python"

msgid ""

"To speed up loading modules, Python caches the compiled version of each "

"module in the ``__pycache__`` directory under the name :file:`module."

"{version}.pyc`, where the version encodes the format of the compiled file; "

"it generally contains the Python version number. For example, in CPython "

"release 3.3 the compiled version of spam.py would be cached as ``__pycache__/"

"spam.cpython-33.pyc``. This naming convention allows compiled modules from "

"different releases and different versions of Python to coexist."

msgstr ""

"Чтобы ускорить загрузку модулей, Python кэширует скомпилированную версию "

"каждого модуля в каталоге ``__pycache__`` под именем :file:`module."

"{version}.pyc`, где версия кодирует формат скомпилированного файла. Обычно "

"она содержит номер версии Python. Например, в CPython 3.3 скомпилированная "

"версия spam.py будет закэширована как ``__pycache__/spam.cpython-33.pyc``. "

"Такое соглашение об именах позволяет скомпилированным модулям из разных "

"выпусков и разных версий Python существовать вместе."

msgid ""

"Python checks the modification date of the source against the compiled "

"version to see if it's out of date and needs to be recompiled. This is a "

"completely automatic process. Also, the compiled modules are platform-"

"independent, so the same library can be shared among systems with different "

"architectures."

msgstr ""

"Python сверяет даты изменения исходного файла и его скомпилированной версии, "

"чтобы понять, устарела ли она и нужно ли её перекомпилировать. Это полностью "

"автоматический процесс. Скомпилированные модули также не зависят от "

"платформы, поэтому одну и ту же библиотеку можно использовать на системах с "

"разной архитектурой."

msgid ""

"Python does not check the cache in two circumstances. First, it always "

"recompiles and does not store the result for the module that's loaded "

"directly from the command line. Second, it does not check the cache if "

"there is no source module. To support a non-source (compiled only) "

"distribution, the compiled module must be in the source directory, and there "

"must not be a source module."

msgstr ""

"Python не проверяет кэш в двух случаях. Во-первых, он всегда перекомпилирует "

"модуль, загруженный напрямую из командной строки, и не сохраняет результат. "

"Во-вторых, он не проверяет кэш, если отсутствует исходный файл. Чтобы "

"поддерживать распространение без исходников (только в виде скомпилированных "

"файлов), скомпилированный модуль должен находиться в каталоге исходников, и "

"при этом исходного файла быть не должно."

msgid "Some tips for experts:"

msgstr "Несколько советов для экспертов:"

msgid ""

"You can use the :option:`-O` or :option:`-OO` switches on the Python command "

"to reduce the size of a compiled module. The ``-O`` switch removes assert "

"statements, the ``-OO`` switch removes both assert statements and __doc__ "

"strings. Since some programs may rely on having these available, you should "

"only use this option if you know what you're doing. \"Optimized\" modules "

"have an ``opt-`` tag and are usually smaller. Future releases may change "

"the effects of optimization."

msgstr ""

"Вы можете использовать опции :option:`-O` или :option:`-OO` при запуске "

"Python, чтобы уменьшить размер скомпилированного модуля. Опция ``-O`` "

"удаляет инструкции assert, а ``-OO`` удаляет и assert, и строки __doc__. "

"Поскольку некоторые программы могут полагаться на их наличие, использовать "

"эти опции стоит только если вы точно понимаете последствия. "

"«Оптимизированные» модули имеют тег ``opt-`` и обычно меньше по размеру. В "

"будущих выпусках поведение оптимизации может измениться."

msgid ""

"A program doesn't run any faster when it is read from a ``.pyc`` file than "

"when it is read from a ``.py`` file; the only thing that's faster about "

"``.pyc`` files is the speed with which they are loaded."

msgstr ""

"Программа не работает быстрее при запуске из файла ``.pyc``, чем при запуске "

"из ``.py``. Отличие только в том, что файлы ``.pyc`` загружаются быстрее."

msgid ""

"The module :mod:`compileall` can create .pyc files for all modules in a "

"directory."

msgstr ""

"Модуль :mod:`compileall` может создать файлы .pyc для всех модулей в "

"каталоге."

msgid ""

"There is more detail on this process, including a flow chart of the "

"decisions, in :pep:`3147`."

msgstr ""

"Подробности этого процесса, включая блок-схему принятия решений, приведены "

"в :pep:`3147`."

msgid "Standard Modules"

msgstr "Стандартные модули"

msgid ""

"Python comes with a library of standard modules, described in a separate "

"document, the Python Library Reference (\"Library Reference\" hereafter). "

"Some modules are built into the interpreter; these provide access to "

"operations that are not part of the core of the language but are "

"nevertheless built in, either for efficiency or to provide access to "

"operating system primitives such as system calls. The set of such modules "

"is a configuration option which also depends on the underlying platform. "

"For example, the :mod:`winreg` module is only provided on Windows systems. "

"One particular module deserves some attention: :mod:`sys`, which is built "

"into every Python interpreter. The variables ``sys.ps1`` and ``sys.ps2`` "

"define the strings used as primary and secondary prompts::"

msgstr ""

"Python поставляется с библиотекой стандартных модулей, описанной в отдельном "

"документе «Справочник по библиотеке Python» («Справочник по библиотеке» "

"далее). Некоторые модули встроены в интерпретатор; они обеспечивают доступ к "

"операциям, которые не являются частью ядра языка, но тем не менее встроены — "

"либо для повышения эффективности, либо для обеспечения доступа к примитивам "

"операционной системы, таким как системные вызовы. Набор таких модулей "

"является опцией конфигурации, а также зависит от базовой платформы. "

"Например, модуль :mod:`winreg` предоставляется только в системах Windows. "

"Отдельного внимания заслуживает один модуль: :mod:`sys`, который встроен в "

"каждый интерпретатор Python. Переменные ``sys.ps1`` и ``sys.ps2`` определяют "

"строки, используемые в качестве основного и вторичного приглашений::"

msgid ""

">>> import sys\n"

">>> sys.ps1\n"

"'>>> '\n"

">>> sys.ps2\n"

"'... '\n"

">>> sys.ps1 = 'C> '\n"

"C> print('Yuck!')\n"

"Yuck!\n"

"C>"

msgstr ""

">>> import sys\n"

">>> sys.ps1\n"

"'>>> '\n"

">>> sys.ps2\n"

"'... '\n"

">>> sys.ps1 = 'C> '\n"

"C> print('Фу!')\n"

"Фу!\n"

"C>"

msgid ""

"These two variables are only defined if the interpreter is in interactive "

"mode."

msgstr ""

"Эти две переменные определяются только если интерпретатор работает в "

"интерактивном режиме."

msgid ""

"The variable ``sys.path`` is a list of strings that determines the "

"interpreter's search path for modules. It is initialized to a default path "

"taken from the environment variable :envvar:`PYTHONPATH`, or from a built-in "

"default if :envvar:`PYTHONPATH` is not set. You can modify it using "

"standard list operations::"

msgstr ""

"Переменная ``sys.path`` — это список строк, определяющий путь поиска модулей "

"интерпретатором. Значение по умолчанию для этого списка берётся из "

"переменной окружения :envvar:`PYTHONPATH`, либо из встроенного значения, "

"если :envvar:`PYTHONPATH` не установлена. Вы можете изменить его, используя "

"стандартные операции со списками::"

msgid ""

">>> import sys\n"

">>> sys.path.append('/ufs/guido/lib/python')"

msgstr ""

">>> import sys\n"

">>> sys.path.append('/ufs/guido/lib/python')"

msgid "The :func:`dir` Function"

msgstr "Функция :func:`dir`"

msgid ""

"The built-in function :func:`dir` is used to find out which names a module "

"defines. It returns a sorted list of strings::"

msgstr ""

"Встроенная функция :func:`dir` используется для того, чтобы узнать, какие "

"имена определяет модуль. Она возвращает отсортированный список строк::"

msgid ""

">>> import fibo, sys\n"

">>> dir(fibo)\n"

"['__name__', 'fib', 'fib2']\n"

">>> dir(sys)\n"

"['__breakpointhook__', '__displayhook__', '__doc__', '__excepthook__',\n"

" '__interactivehook__', '__loader__', '__name__', '__package__', "

"'__spec__',\n"

" '__stderr__', '__stdin__', '__stdout__', '__unraisablehook__',\n"

" '_clear_type_cache', '_current_frames', '_debugmallocstats', '_framework',\n"

" '_getframe', '_git', '_home', '_xoptions', 'abiflags', 'addaudithook',\n"

" 'api_version', 'argv', 'audit', 'base_exec_prefix', 'base_prefix',\n"

" 'breakpointhook', 'builtin_module_names', 'byteorder', 'call_tracing',\n"

" 'callstats', 'copyright', 'displayhook', 'dont_write_bytecode', "

"'exc_info',\n"

" 'excepthook', 'exec_prefix', 'executable', 'exit', 'flags', 'float_info',\n"

" 'float_repr_style', 'get_asyncgen_hooks', "

"'get_coroutine_origin_tracking_depth',\n"

" 'getallocatedblocks', 'getdefaultencoding', 'getdlopenflags',\n"

" 'getfilesystemencodeerrors', 'getfilesystemencoding', 'getprofile',\n"

" 'getrecursionlimit', 'getrefcount', 'getsizeof', 'getswitchinterval',\n"

" 'gettrace', 'hash_info', 'hexversion', 'implementation', 'int_info',\n"

" 'intern', 'is_finalizing', 'last_traceback', 'last_type', 'last_value',\n"

" 'maxsize', 'maxunicode', 'meta_path', 'modules', 'path', 'path_hooks',\n"

" 'path_importer_cache', 'platform', 'prefix', 'ps1', 'ps2', "

"'pycache_prefix',\n"

" 'set_asyncgen_hooks', 'set_coroutine_origin_tracking_depth', "

"'setdlopenflags',\n"

" 'setprofile', 'setrecursionlimit', 'setswitchinterval', 'settrace', "

"'stderr',\n"

" 'stdin', 'stdout', 'thread_info', 'unraisablehook', 'version', "

"'version_info',\n"

" 'warnoptions']"

msgstr ""

">>> import fibo, sys\n"

">>> dir(fibo)\n"

"['__name__', 'fib', 'fib2']\n"

">>> dir(sys)\n"

"['__breakpointhook__', '__displayhook__', '__doc__', '__excepthook__',\n"

" '__interactivehook__', '__loader__', '__name__', '__package__', "

"'__spec__',\n"

" '__stderr__', '__stdin__', '__stdout__', '__unraisablehook__',\n"

" '_clear_type_cache', '_current_frames', '_debugmallocstats', '_framework',\n"

" '_getframe', '_git', '_home', '_xoptions', 'abiflags', 'addaudithook',\n"

" 'api_version', 'argv', 'audit', 'base_exec_prefix', 'base_prefix',\n"

" 'breakpointhook', 'builtin_module_names', 'byteorder', 'call_tracing',\n"

" 'callstats', 'copyright', 'displayhook', 'dont_write_bytecode', "

"'exc_info',\n"

" 'excepthook', 'exec_prefix', 'executable', 'exit', 'flags', 'float_info',\n"

" 'float_repr_style', 'get_asyncgen_hooks', "

"'get_coroutine_origin_tracking_depth',\n"

" 'getallocatedblocks', 'getdefaultencoding', 'getdlopenflags',\n"

" 'getfilesystemencodeerrors', 'getfilesystemencoding', 'getprofile',\n"

" 'getrecursionlimit', 'getrefcount', 'getsizeof', 'getswitchinterval',\n"

" 'gettrace', 'hash_info', 'hexversion', 'implementation', 'int_info',\n"

" 'intern', 'is_finalizing', 'last_traceback', 'last_type', 'last_value',\n"

" 'maxsize', 'maxunicode', 'meta_path', 'modules', 'path', 'path_hooks',\n"

" 'path_importer_cache', 'platform', 'prefix', 'ps1', 'ps2', "

"'pycache_prefix',\n"

" 'set_asyncgen_hooks', 'set_coroutine_origin_tracking_depth', "

"'setdlopenflags',\n"

" 'setprofile', 'setrecursionlimit', 'setswitchinterval', 'settrace', "

"'stderr',\n"

" 'stdin', 'stdout', 'thread_info', 'unraisablehook', 'version', "

"'version_info',\n"

" 'warnoptions']"

msgid ""

"Without arguments, :func:`dir` lists the names you have defined currently::"

msgstr ""

"Без аргументов :func:`dir` перечисляет имена, которые вы определили на "

"данный момент::"

msgid ""

">>> a = [1, 2, 3, 4, 5]\n"

">>> import fibo\n"

">>> fib = fibo.fib\n"

">>> dir()\n"

"['__builtins__', '__name__', 'a', 'fib', 'fibo', 'sys']"

msgstr ""

">>> a = [1, 2, 3, 4, 5]\n"

">>> import fibo\n"

">>> fib = fibo.fib\n"

">>> dir()\n"

"['__builtins__', '__name__', 'a', 'fib', 'fibo', 'sys']"

msgid ""

"Note that it lists all types of names: variables, modules, functions, etc."

msgstr ""

"Обратите внимание, что здесь перечислены все типы имен: переменные, модули, "

"функции и т. д."

msgid ""

":func:`dir` does not list the names of built-in functions and variables. If "

"you want a list of those, they are defined in the standard "

"module :mod:`builtins`::"

msgstr ""

":func:`dir` не перечисляет имена встроенных функций и переменных. Если вам "

"нужен их список, они определены в стандартном модуле :mod:`builtins`::"

msgid ""

">>> import builtins\n"

">>> dir(builtins)\n"

"['ArithmeticError', 'AssertionError', 'AttributeError', 'BaseException',\n"

" 'BlockingIOError', 'BrokenPipeError', 'BufferError', 'BytesWarning',\n"

" 'ChildProcessError', 'ConnectionAbortedError', 'ConnectionError',\n"

" 'ConnectionRefusedError', 'ConnectionResetError', 'DeprecationWarning',\n"

" 'EOFError', 'Ellipsis', 'EnvironmentError', 'Exception', 'False',\n"

" 'FileExistsError', 'FileNotFoundError', 'FloatingPointError',\n"

" 'FutureWarning', 'GeneratorExit', 'IOError', 'ImportError',\n"

" 'ImportWarning', 'IndentationError', 'IndexError', 'InterruptedError',\n"

" 'IsADirectoryError', 'KeyError', 'KeyboardInterrupt', 'LookupError',\n"

" 'MemoryError', 'NameError', 'None', 'NotADirectoryError', "

"'NotImplemented',\n"

" 'NotImplementedError', 'OSError', 'OverflowError',\n"

" 'PendingDeprecationWarning', 'PermissionError', 'ProcessLookupError',\n"

" 'ReferenceError', 'ResourceWarning', 'RuntimeError', 'RuntimeWarning',\n"

" 'StopIteration', 'SyntaxError', 'SyntaxWarning', 'SystemError',\n"

" 'SystemExit', 'TabError', 'TimeoutError', 'True', 'TypeError',\n"

" 'UnboundLocalError', 'UnicodeDecodeError', 'UnicodeEncodeError',\n"

" 'UnicodeError', 'UnicodeTranslateError', 'UnicodeWarning', 'UserWarning',\n"

" 'ValueError', 'Warning', 'ZeroDivisionError', '_', '__build_class__',\n"

" '__debug__', '__doc__', '__import__', '__name__', '__package__', 'abs',\n"

" 'all', 'any', 'ascii', 'bin', 'bool', 'bytearray', 'bytes', 'callable',\n"

" 'chr', 'classmethod', 'compile', 'complex', 'copyright', 'credits',\n"

" 'delattr', 'dict', 'dir', 'divmod', 'enumerate', 'eval', 'exec', 'exit',\n"

" 'filter', 'float', 'format', 'frozenset', 'getattr', 'globals', 'hasattr',\n"

" 'hash', 'help', 'hex', 'id', 'input', 'int', 'isinstance', 'issubclass',\n"

" 'iter', 'len', 'license', 'list', 'locals', 'map', 'max', 'memoryview',\n"

" 'min', 'next', 'object', 'oct', 'open', 'ord', 'pow', 'print', 'property',\n"

" 'quit', 'range', 'repr', 'reversed', 'round', 'set', 'setattr', 'slice',\n"

" 'sorted', 'staticmethod', 'str', 'sum', 'super', 'tuple', 'type', 'vars',\n"

" 'zip']"

msgstr ""

">>> import builtins\n"

">>> dir(builtins)\n"

"['ArithmeticError', 'AssertionError', 'AttributeError', 'BaseException',\n"

" 'BlockingIOError', 'BrokenPipeError', 'BufferError', 'BytesWarning',\n"

" 'ChildProcessError', 'ConnectionAbortedError', 'ConnectionError',\n"

" 'ConnectionRefusedError', 'ConnectionResetError', 'DeprecationWarning',\n"

" 'EOFError', 'Ellipsis', 'EnvironmentError', 'Exception', 'False',\n"

" 'FileExistsError', 'FileNotFoundError', 'FloatingPointError',\n"

" 'FutureWarning', 'GeneratorExit', 'IOError', 'ImportError',\n"

" 'ImportWarning', 'IndentationError', 'IndexError', 'InterruptedError',\n"

" 'IsADirectoryError', 'KeyError', 'KeyboardInterrupt', 'LookupError',\n"

" 'MemoryError', 'NameError', 'None', 'NotADirectoryError', "

"'NotImplemented',\n"

" 'NotImplementedError', 'OSError', 'OverflowError',\n"

" 'PendingDeprecationWarning', 'PermissionError', 'ProcessLookupError',\n"

" 'ReferenceError', 'ResourceWarning', 'RuntimeError', 'RuntimeWarning',\n"

" 'StopIteration', 'SyntaxError', 'SyntaxWarning', 'SystemError',\n"

" 'SystemExit', 'TabError', 'TimeoutError', 'True', 'TypeError',\n"

" 'UnboundLocalError', 'UnicodeDecodeError', 'UnicodeEncodeError',\n"

" 'UnicodeError', 'UnicodeTranslateError', 'UnicodeWarning', 'UserWarning',\n"

" 'ValueError', 'Warning', 'ZeroDivisionError', '_', '__build_class__',\n"

" '__debug__', '__doc__', '__import__', '__name__', '__package__', 'abs',\n"

" 'all', 'any', 'ascii', 'bin', 'bool', 'bytearray', 'bytes', 'callable',\n"

" 'chr', 'classmethod', 'compile', 'complex', 'copyright', 'credits',\n"

" 'delattr', 'dict', 'dir', 'divmod', 'enumerate', 'eval', 'exec', 'exit',\n"

" 'filter', 'float', 'format', 'frozenset', 'getattr', 'globals', 'hasattr',\n"

" 'hash', 'help', 'hex', 'id', 'input', 'int', 'isinstance', 'issubclass',\n"

" 'iter', 'len', 'license', 'list', 'locals', 'map', 'max', 'memoryview',\n"

" 'min', 'next', 'object', 'oct', 'open', 'ord', 'pow', 'print', 'property',\n"

" 'quit', 'range', 'repr', 'reversed', 'round', 'set', 'setattr', 'slice',\n"

" 'sorted', 'staticmethod', 'str', 'sum', 'super', 'tuple', 'type', 'vars',\n"

" 'zip']"

msgid "Packages"

msgstr "Пакеты"

msgid ""

"Packages are a way of structuring Python's module namespace by using "

"\"dotted module names\". For example, the module name :mod:`!A.B` "

"designates a submodule named ``B`` in a package named ``A``. Just like the "

"use of modules saves the authors of different modules from having to worry "

"about each other's global variable names, the use of dotted module names "

"saves the authors of multi-module packages like NumPy or Pillow from having "

"to worry about each other's module names."

msgstr ""

"Пакеты — это способ структурирования пространства имён модулей Python с "

"помощью «имён модулей с точками». Например, имя модуля :mod:`!A.B` "

"обозначает подмодуль ``B`` в пакете ``A``. Точно так же, как использование "

"модулей избавляет авторов разных модулей от необходимости беспокоиться о "

"конфликте имён глобальных переменных, использование имён модулей с точками "

"избавляет авторов многомодульных пакетов, таких как NumPy или Pillow, от "

"необходимости беспокоиться о конфликте имён модулей друг с другом."

msgid ""

"Suppose you want to design a collection of modules (a \"package\") for the "

"uniform handling of sound files and sound data. There are many different "

"sound file formats (usually recognized by their extension, for "

"example: :file:`.wav`, :file:`.aiff`, :file:`.au`), so you may need to "

"create and maintain a growing collection of modules for the conversion "

"between the various file formats. There are also many different operations "

"you might want to perform on sound data (such as mixing, adding echo, "

"applying an equalizer function, creating an artificial stereo effect), so in "

"addition you will be writing a never-ending stream of modules to perform "

"these operations. Here's a possible structure for your package (expressed "

"in terms of a hierarchical filesystem):"

msgstr ""

"Предположим, вы хотите разработать набор модулей («пакет») для единообразной "

"обработки звуковых файлов и звуковых данных. Существует множество различных "

"форматов звуковых файлов (обычно различаемых по расширению, "

"например: :file:`.wav`, :file:`.aiff`, :file:`.au`), поэтому вам, возможно, "

"придётся создать и поддерживать растущую коллекцию модулей для "

"преобразования между различными форматами файлов. Также существует множество "

"различных операций, которые вы можете захотеть выполнять над звуковыми "

"данными (таких как микширование, добавление эха, применение функции "

"эквалайзера, создание искусственного стереоэффекта), поэтому, кроме того, "

"вам предстоит писать бесконечный поток модулей для выполнения этих операций. "

"Вот возможная структура вашего пакета (представленная в виде иерархической "

"файловой системы):"

msgid ""

"sound/ Top-level package\n"

" __init__.py Initialize the sound package\n"

" formats/ Subpackage for file format conversions\n"

" __init__.py\n"

" wavread.py\n"

" wavwrite.py\n"

" aiffread.py\n"

" aiffwrite.py\n"

" auread.py\n"

" auwrite.py\n"

" ...\n"

" effects/ Subpackage for sound effects\n"

" __init__.py\n"

" echo.py\n"

" surround.py\n"

" reverse.py\n"

" ...\n"

" filters/ Subpackage for filters\n"

" __init__.py\n"

" equalizer.py\n"

" vocoder.py\n"

" karaoke.py\n"

" ..."

msgstr ""

"sound/ Пакет верхнего уровня\n"

" __init__.py Инициализация пакета sound\n"

" formats/ Подпакет для преобразования форматов файлов\n"

" __init__.py\n"

" wavread.py\n"

" wavwrite.py\n"

" aiffread.py\n"

" aiffwrite.py\n"

" auread.py\n"

" auwrite.py\n"

" ...\n"

" effects/ Подпакет звуковых эффектов\n"

" __init__.py\n"

" echo.py\n"

" surround.py\n"

" reverse.py\n"

" ...\n"

" filters/ Подпакет фильтров\n"

" __init__.py\n"

" equalizer.py\n"

" vocoder.py\n"

" karaoke.py\n"

" ..."

msgid ""

"When importing the package, Python searches through the directories on "

"``sys.path`` looking for the package subdirectory."

msgstr ""

"При импорте пакета Python просматривает каталоги из ``sys.path`` в поисках "

"подкаталога пакета."

msgid ""

"The :file:`__init__.py` files are required to make Python treat directories "

"containing the file as packages (unless using a :term:`namespace package`, a "

"relatively advanced feature). This prevents directories with a common name, "

"such as ``string``, from unintentionally hiding valid modules that occur "

"later on the module search path. In the simplest case, :file:`__init__.py` "

"can just be an empty file, but it can also execute initialization code for "

"the package or set the ``__all__`` variable, described later."

msgstr ""

"Файлы :file:`__init__.py` нужны для того, чтобы Python рассматривал "

"каталоги, содержащие этот файл, как пакеты (если только не "

"используется :term:`пакет пространства имён <namespace package>`, что "

"является относительно продвинутой возможностью). Это предотвращает ситуацию, "

"когда каталог с обычным именем, например ``string``, случайно скрывает "

"настоящие модули, находящиеся дальше в пути поиска модулей. В простейшем "

"случае :file:`__init__.py` может быть просто пустым файлом, но он также "

"может выполнять код инициализации пакета или задавать переменную "

"``__all__``, которая будет описана позже."

msgid ""

"Users of the package can import individual modules from the package, for "

"example::"

msgstr ""

"Пользователи пакета могут импортировать отдельные модули из пакета, например:"

msgid "import sound.effects.echo"

msgstr "import sound.effects.echo"

msgid ""

"This loads the submodule :mod:`!sound.effects.echo`. It must be referenced "

"with its full name. ::"

msgstr ""

"Это загружает подмодуль :mod:`!sound.effects.echo`. Обращаться к нему нужно "

"по его полному имени. ::"

msgid "sound.effects.echo.echofilter(input, output, delay=0.7, atten=4)"

msgstr "sound.effects.echo.echofilter(input, output, delay=0.7, atten=4)"

msgid "An alternative way of importing the submodule is::"

msgstr "Альтернативный способ импорта подмодуля:"

msgid "from sound.effects import echo"

msgstr "from sound.effects import echo"

msgid ""

"This also loads the submodule :mod:`!echo`, and makes it available without "

"its package prefix, so it can be used as follows::"

msgstr ""

"Это также загружает подмодуль :mod:`!echo` и делает его доступным без "

"префикса пакета, поэтому его можно использовать следующим образом::"

msgid "echo.echofilter(input, output, delay=0.7, atten=4)"

msgstr "echo.echofilter(input, output, delay=0.7, atten=4)"

msgid ""

"Yet another variation is to import the desired function or variable "

"directly::"

msgstr ""

"Еще один вариант — импортировать нужную функцию или переменную напрямую::"

msgid "from sound.effects.echo import echofilter"

msgstr "from sound.effects.echo import echofilter"

msgid ""

"Again, this loads the submodule :mod:`!echo`, but this makes its "

"function :func:`!echofilter` directly available::"

msgstr ""

"Опять же, это загружает подмодуль :mod:`!echo`, но при этом делает его "

"функцию :func:`!echofilter` доступной напрямую::"

msgid "echofilter(input, output, delay=0.7, atten=4)"

msgstr "echofilter(input, output, delay=0.7, atten=4)"

msgid ""

"Note that when using ``from package import item``, the item can be either a "

"submodule (or subpackage) of the package, or some other name defined in the "

"package, like a function, class or variable. The ``import`` statement first "

"tests whether the item is defined in the package; if not, it assumes it is a "

"module and attempts to load it. If it fails to find it, "

"an :exc:`ImportError` exception is raised."

msgstr ""

"Обратите внимание, что при использовании ``from package import item`` этот "

"item может быть либо подмодулем (или подпакетом) пакета, либо каким-либо "

"другим именем, определённым в пакете, например, функцией, классом или "

"переменной. Инструкция ``import`` сначала проверяет, определено ли это имя в "

"пакете; в противном случае она предполагает, что это модуль, и пытается его "

"загрузить. Если это не удаётся, возникает исключение :exc:`ImportError`."

msgid ""

"Contrarily, when using syntax like ``import item.subitem.subsubitem``, each "

"item except for the last must be a package; the last item can be a module or "

"a package but can't be a class or function or variable defined in the "

"previous item."

msgstr ""

"Напротив, при использовании синтаксиса типа ``import "

"item.subitem.subsubitem``, каждый элемент, кроме последнего, должен быть "

"пакетом. Последний элемент может быть модулем или пакетом, но не может быть "

"классом, функцией или переменной, определённой в предыдущем элементе."

msgid "Importing \\* From a Package"

msgstr "Импорт \\* из пакета"

msgid ""

"Now what happens when the user writes ``from sound.effects import *``? "

"Ideally, one would hope that this somehow goes out to the filesystem, finds "

"which submodules are present in the package, and imports them all. This "

"could take a long time and importing sub-modules might have unwanted side-"

"effects that should only happen when the sub-module is explicitly imported."