Документация Python неофициальный перевод

ГлоссарийGlossary

>>>
Приглашение по умолчанию в интерактивной оболочке Python. Часто встречается в примерах кода, которые можно выполнять в интерпретаторе в интерактивном режиме.
...
Стандартное приглашение Python интерактивной оболочки при вводе кода для блока с отступом или внутри пары соответствующих открывающих и закрывающих разделителей (круглых скобок, квадратных скобок или фигурных скобок).
2to3

Инструмент, который пытается преобразовать код Python 2.x в код Python 3.x, обрабатывая большинство несовместимостей, которые можно обнаружить при разборе исходного кода и обходе дерева разбора.

2to3 доступен в стандартной библиотеке как lib2to3; отдельная точка входа предоставляется как Tools/scripts/2to3. См. 2to3 – автоматическое преобразование кода Python 2 в 3.

абстрактный базовый класс
Абстрактные базовые классы (сокращённо ABC) дополняют утиную типизацию, предоставляя способ определения интерфейсов, когда другие методы, такие как hasattr(), были бы неудобны. Python поставляется со многими встроенными ABC для структур данных (в модуле collections), чисел (в модуле numbers) и потоков (в модуле io). Вы можете создать свой собственный ABC с помощью модуля abc.
аргумент

Значение, передаваемое функции или методу, присваиваемое именованной локальной переменной в теле функции. Функция или метод могут иметь как позиционные аргументы, так и именованные аргументы в своём определении. Позиционные и именованные аргументы могут быть переменной длины: * принимает или передаёт (в определении или вызове функции) несколько позиционных аргументов в виде списка, а ** делает то же самое для именованных аргументов в виде словаря.

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

атрибут
Значение, связанное с объектом, на которое ссылаются по имени с помощью выражений с точкой. Например, если объект o имеет атрибут a, на него можно сослаться как o.a.
BDFL
Доброжелательный диктатор на всю жизнь, также известный как Гвидо ван Россум, создатель Python.
байткод
Исходный код Python компилируется в байткод – внутреннее представление программы Python в интерпретаторе. Байткод также кэшируется в файлах .pyc и .pyo, чтобы при повторном выполнении того же файла это было быстрее (можно избежать перекомпиляции из исходного кода в байткод). Этот «промежуточный язык» выполняется на виртуальной машине, которая исполняет машинный код, соответствующий каждому байткоду.
класс
Шаблон для создания пользовательских объектов. Определения классов обычно содержат определения методов, которые работают с экземплярами класса.
приведение типов
Неявное преобразование экземпляра одного типа в другой во время операции, включающей два аргумента одного типа. Например, int(3.15) преобразует число с плавающей запятой в целое число 3, но в 3+4.5 каждый аргумент имеет разный тип (один int, другой float), и оба должны быть преобразованы в один и тот же тип, прежде чем их можно будет сложить, иначе будет возбуждено TypeError. Без приведения типов программисту пришлось бы нормализовать все аргументы, даже совместимых типов, до одного значения, например float(3)+4.5, а не просто 3+4.5.
комплексное число
Расширение привычной системы действительных чисел, в котором все числа выражаются как сумма действительной и мнимой частей. Мнимые числа – это действительные кратные мнимой единицы (квадратный корень из -1), часто записываемые как i в математике или j в технике. Python имеет встроенную поддержку комплексных чисел, которые записываются в последней нотации; мнимая часть записывается с суффиксом j, например, 3+1j. Чтобы получить доступ к комплексным аналогам модуля math, используйте cmath. Использование комплексных чисел – довольно продвинутая математическая возможность. Если вы не знаете, зачем они вам нужны, почти наверняка их можно безопасно игнорировать.
контекстный менеджер
Объект, который управляет окружением, видимым в операторе with, определяя методы __enter__() и __exit__(). См. PEP 343.
CPython
Каноническая реализация языка программирования Python. Термин «CPython» используется в контекстах, где необходимо отличать эту реализацию от других, таких как Jython или IronPython.
декоратор

Функция, возвращающая другую функцию, обычно применяемая как преобразование функции с использованием синтаксиса @wrapper. Распространённые примеры декораторов: classmethod() и staticmethod().

Синтаксис декоратора – всего лишь синтаксический сахар, следующие два определения функций семантически эквивалентны:

def f(...):
    ...
f = staticmethod(f)

@staticmethod
def f(...):
    ...

Та же концепция существует и для классов, но там используется реже. См. документацию по определениям функций и определениям классов для получения дополнительной информации о декораторах.

дескриптор

Любой объект, который определяет методы __get__(), __set__() или __delete__(). Когда атрибут класса является дескриптором, его специальное поведение связывания срабатывает при поиске атрибута. Обычно использование a.b для получения, установки или удаления атрибута ищет объект с именем b в словаре класса для a, но если b является дескриптором, вызывается соответствующий метод дескриптора. Понимание дескрипторов – ключ к глубокому пониманию Python, потому что они являются основой многих возможностей, включая функции, методы, свойства, методы класса, статические методы и ссылки на суперклассы.

Подробнее о методах дескрипторов см. в Implementing Descriptors.

словарь
Ассоциативный массив, в котором произвольные ключи сопоставляются значениям. Использование dict очень похоже на использование list, но ключи могут быть любыми объектами с функцией __hash__(), а не только целыми числами. В Perl называется хешем.
докстринг
Строковый литерал, который появляется как первое выражение в классе, функции или модуле. Хотя он игнорируется при выполнении блока, он распознаётся компилятором и помещается в атрибут __doc__ окружающего класса, функции или модуля. Поскольку он доступен через интроспекцию, это каноническое место для документации объекта.
утиная типизация
Стиль программирования на Python, который определяет тип объекта по его сигнатуре методов или атрибутов, а не по явной принадлежности к какому-то типу («Если это выглядит как утка и крякает как утка, значит, это утка»). Акцентируя внимание на интерфейсах, а не на конкретных типах, хорошо спроектированный код повышает гибкость за счёт полиморфной подстановки. Утиная типизация избегает проверок с помощью type() или isinstance(). (Однако утиную типизацию можно дополнить абстрактными базовыми классами.) Вместо этого она обычно использует проверки hasattr() или стиль программирования EAFP (легче попросить прощения, чем разрешения).
EAFP
Проще попросить прощения, чем разрешения. Этот распространённый стиль программирования на Python предполагает существование правильных ключей или атрибутов и перехватывает исключения, если предположение оказывается неверным. Этот чистый и быстрый стиль характеризуется наличием множества операторов try и except. Этот подход контрастирует со стилем LBYL, распространённым во многих других языках, таких как C.
выражение
Синтаксическая конструкция, которая может быть вычислена в некоторое значение. Другими словами, выражение – это совокупность элементов выражения, таких как литералы, имена, доступ к атрибутам, операторы или вызовы функций, которые возвращают значение. В отличие от многих других языков, не все языковые конструкции являются выражениями. Существуют также инструкции, которые нельзя использовать как выражения, например if. Присваивания также являются инструкциями, а не выражениями.
модуль-расширение
Модуль, написанный на C или C++, использующий C API Python для взаимодействия с ядром и пользовательским кодом.
целочисленное деление
Математическое деление с отбрасыванием остатка. Оператор целочисленного деления – //. Например, выражение 11//4 вычисляется в 2 в отличие от 2.75, возвращаемого при истинном делении с плавающей запятой.
функция
Последовательность инструкций, возвращающая значение вызывающему коду. Ей также может быть передано ноль или более аргументов, которые могут использоваться при выполнении тела. См. также аргумент и метод.
future

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

Импортировав модуль __future__ и вычислив его переменные, можно увидеть, когда новая возможность была впервые добавлена в язык и когда она стала поведением по умолчанию:

>>> import __future__
>>> __future__.division
_Feature((2, 2, 0, 'alpha', 2), (3, 0, 0, 'alpha', 0), 8192)
сборка мусора
Процесс освобождения памяти, когда она больше не используется. Python выполняет сборку мусора с помощью подсчёта ссылок и циклического сборщика мусора, который способен обнаруживать и разрывать циклические ссылки.
генератор
Функция, которая возвращает итератор. Она выглядит как обычная функция, за исключением того, что значения возвращаются вызывающему коду с помощью оператора yield вместо оператора return. Функции-генераторы часто содержат один или несколько циклов for или while, которые yield (возвращают) элементы обратно вызывающему коду. Выполнение функции останавливается на ключевом слове yield (возвращая результат) и возобновляется оттуда, когда следующий элемент запрашивается вызовом метода __next__() возвращённого итератора.
генераторное выражение

Выражение, возвращающее генератор. Оно выглядит как обычное выражение, за которым следует выражение for, определяющее переменную цикла, диапазон и необязательное выражение if. Совместное выражение генерирует значения для внешней функции:

>>> sum(i*i for i in range(10))         # сумма квадратов 0, 1, 4, ... 81
285
GIL
См. глобальная блокировка интерпретатора.
глобальная блокировка интерпретатора
Блокировка, используемая потоками Python для гарантии того, что только один поток выполняется в CPython виртуальной машине в каждый момент времени. Это упрощает реализацию CPython, гарантируя, что никакие два процесса не могут одновременно получить доступ к одной и той же памяти. Блокировка всего интерпретатора упрощает его многопоточность, но ценой потери значительной части параллелизма, обеспечиваемого многопроцессорными машинами. В прошлом предпринимались попытки создать «свободно-поточный» интерпретатор (такой, который блокирует разделяемые данные с гораздо более мелкой гранулярностью), но пока ни одна из них не увенчалась успехом, поскольку производительность страдала в обычном однопроцессорном случае.
хешируемый

Объект является хэшируемым, если у него есть хэш-значение, которое никогда не меняется в течение его жизни (нужен метод __hash__()), и его можно сравнивать с другими объектами (нужен метод __eq__()). Хэшируемые объекты, которые сравниваются как равные, должны иметь одинаковое хэш-значение.

Хешируемость позволяет использовать объект в качестве ключа словаря и элемента множества, поскольку эти структуры данных внутренне используют хеш-значение.

Все неизменяемые встроенные объекты Python являются хешируемыми, в то время как ни один изменяемый контейнер (например, списки или словари) не является хешируемым. Объекты, являющиеся экземплярами пользовательских классов, по умолчанию хешируемы; все они сравниваются как неравные, и их хеш-значение – это их id().

IDLE
Интегрированная среда разработки для Python. IDLE – это базовый редактор и среда интерпретатора, поставляемые со стандартным дистрибутивом Python. Подходит для начинающих, а также служит наглядным примером кода для тех, кто хочет реализовать умеренно сложное многоплатформенное GUI-приложение.
неизменяемый
Объект с фиксированным значением. К неизменяемым объектам относятся числа, строки и кортежи. Такой объект нельзя изменить. Если требуется сохранить другое значение, необходимо создать новый объект. Они играют важную роль там, где требуется постоянное хеш-значение, например в качестве ключа в словаре.
интерактивный
Python включает интерактивный интерпретатор: можно вводить инструкции и выражения в приглашении интерпретатора, сразу же выполнять их и видеть результат. Просто запустите python без аргументов (возможно, выбрав его из главного меню компьютера). Это очень удобный способ опробовать новые идеи или изучить модули и пакеты (вспомните help(x)).
интерпретируемый
Python является интерпретируемым языком, в отличие от компилируемых, хотя различие может быть размытым из-за наличия компилятора байткода. Это означает, что исходные файлы можно запускать напрямую, без явного создания исполняемого файла, который затем выполняется. Интерпретируемые языки обычно имеют более короткий цикл разработки/отладки, чем компилируемые, хотя их программы, как правило, выполняются медленнее. См. также интерактивный.
итерируемый объект
Объект-контейнер, способный возвращать свои элементы по одному. Примеры итерируемых объектов включают все типы последовательностей (такие как list, str и tuple), а также некоторые непоследовательные типы, например dict и file, и объекты любых классов, определённых с помощью метода __iter__() или __getitem__(). Итерируемые объекты можно использовать в цикле for и во многих других местах, где требуется последовательность (zip(), map(), ...). Когда итерируемый объект передаётся в качестве аргумента встроенной функции iter(), она возвращает итератор для этого объекта. Этот итератор годится для одного прохода по набору значений. При использовании итерируемых объектов обычно не требуется вызывать iter() или самостоятельно работать с объектами-итераторами. Оператор for делает это автоматически, создавая временную безымянную переменную для хранения итератора на время цикла. См. также итератор, последовательность и генератор.
итератор

Объект, представляющий поток данных. Повторные вызовы метода __next__() итератора (или передача его встроенной функции next()) возвращают последовательные элементы потока. Когда данные заканчиваются, вместо этого возбуждается исключение StopIteration. После этого объект итератора исчерпан, и любые дальнейшие вызовы его метода next() снова возбуждают StopIteration. Итераторы должны иметь метод __iter__(), который возвращает сам объект итератора, поэтому каждый итератор также является итерируемым и может использоваться в большинстве мест, где принимаются другие итерируемые объекты. Одним заметным исключением является код, который пытается выполнить несколько проходов итерации. Объект-контейнер (например, list) создаёт новый свежий итератор каждый раз, когда вы передаёте его функции iter() или используете в цикле for. Попытка сделать то же самое с итератором просто вернёт тот же исчерпанный объект итератора, который использовался в предыдущем проходе, что заставит его выглядеть как пустой контейнер.

Дополнительную информацию можно найти в Iterator Types.

именованный аргумент
Аргументы, перед которыми в вызове стоит variable_name=. Имя переменной обозначает локальное имя в функции, которому присваивается значение. ** используется для принятия или передачи словаря именованных аргументов. См. аргумент.
лямбда
Анонимная встроенная функция, состоящая из одного выражения, которое вычисляется при вызове функции. Синтаксис создания лямбда-функции: lambda [аргументы]: выражение
LBYL
Сначала подумай, потом делай (Look before you leap). Этот стиль кодирования явно проверяет предусловия перед выполнением вызовов или поиском. Этот стиль противопоставляется подходу EAFP и характеризуется наличием множества инструкций if.
список
Встроенная в Python последовательность. Несмотря на название, она больше похожа на массив в других языках, чем на связный список, поскольку доступ к элементам осуществляется за O(1).
генератор списка
Компактный способ обработки всех или части элементов последовательности и возврата списка результатов. result = ["0x%02x" % x for x in range(256) if x % 2 == 0] генерирует список строк, содержащих чётные шестнадцатеричные числа (0x..) в диапазоне от 0 до 255. Предложение if необязательно. Если оно опущено, обрабатываются все элементы в range(256).
отображение
Объект-контейнер (например, dict), поддерживающий поиск по произвольным ключам с помощью специального метода __getitem__().
метакласс

Класс класса. Определения классов создают имя класса, словарь класса и список базовых классов. Метакласс отвечает за приём этих трёх аргументов и создание класса. Большинство объектно-ориентированных языков программирования предоставляют реализацию по умолчанию. Особенность Python в том, что можно создавать пользовательские метаклассы. Большинству пользователей этот инструмент никогда не понадобится, но когда возникает необходимость, метаклассы могут предоставить мощные и элегантные решения. Они использовались для логирования доступа к атрибутам, добавления потокобезопасности, отслеживания создания объектов, реализации синглтонов и многих других задач.

Дополнительную информацию можно найти в Настройка создания классов.

метод
Функция, определённая внутри тела класса. Если она вызывается как атрибут экземпляра этого класса, метод получает объект экземпляра в качестве первого аргумента (который обычно называется self). См. также функция и вложенная область видимости.
изменяемый
Изменяемые объекты могут менять своё значение, сохраняя свой id(). См. также неизменяемый.
именованный кортеж

Любой класс, подобный кортежу, индексируемые элементы которого также доступны через именованные атрибуты (например, time.localtime() возвращает подобный кортежу объект, в котором year доступен либо по индексу, например t[0], либо через именованный атрибут, например t.tm_year).

Именованный кортеж может быть встроенным типом, например time.struct_time, или может быть создан с помощью обычного определения класса. Полнофункциональный именованный кортеж также можно создать с помощью фабричной функции collections.namedtuple(). Последний подход автоматически предоставляет дополнительные возможности, такие как самодокументируемое представление, например Employee(name='jones', title='programmer').

пространство имён
Место, где хранится переменная. Пространства имён реализуются как словари. Существуют локальное, глобальное и встроенное пространства имён, а также вложенные пространства имён в объектах (в методах). Пространства имён поддерживают модульность, предотвращая конфликты имён. Например, функции builtins.open() и os.open() различаются по своим пространствам имён. Пространства имён также улучшают читаемость и поддерживаемость, позволяя понять, какой модуль реализует функцию. Например, запись random.seed() или itertools.izip() даёт понять, что эти функции реализованы модулями random и itertools соответственно.
вложенная область видимости
Возможность ссылаться на переменную во внешнем определении. Например, функция, определённая внутри другой функции, может ссылаться на переменные внешней функции. Обратите внимание: вложенные области видимости работают только для чтения, а не для присваивания, которое всегда записывает в самую внутреннюю область. В отличие от этого, локальные переменные и читаются, и записываются в самой внутренней области. Аналогично, глобальные переменные читаются и записываются в глобальном пространстве имён.
класс нового стиля
Старое название разновидности классов, которая теперь используется для всех объектов классов. В более ранних версиях Python только классы нового стиля могли использовать новые и универсальные возможности Python, такие как __slots__, дескрипторы, свойства, __getattribute__(), методы класса и статические методы.
объект
Любые данные с состоянием (атрибуты или значение) и определённым поведением (методы). Также конечный базовый класс любого класса нового стиля.
позиционный аргумент
Аргументы, присвоенные локальным именам внутри функции или метода, определяемые порядком, в котором они были переданы в вызове. * используется либо для принятия нескольких позиционных аргументов (в определении), либо для передачи нескольких аргументов в виде списка функции. См. аргумент.
Python 3000
Прозвище для линейки релизов Python 3.x (придумано давно, когда выпуск версии 3 был чем-то из далёкого будущего). Также сокращённо называется «Py3k».
Питоничный

Идея или фрагмент кода, который тесно следует наиболее распространённым идиомам языка Python, а не использует концепции, общие для других языков. Например, распространённая идиома в Python – перебор всех элементов итерируемого объекта с помощью оператора for. Во многих других языках такой конструкции нет, поэтому люди, не знакомые с Python, иногда используют числовой счётчик:

for i in range(len(food)):
    print(food[i])

В отличие от более чистого, питоничного метода:

for piece in food:
    print(piece)
счётчик ссылок
Количество ссылок на объект. Когда счётчик ссылок объекта падает до нуля, он освобождается. Подсчёт ссылок обычно не виден в коде Python, но является ключевым элементом реализации CPython. Модуль sys определяет функцию getrefcount(), которую программисты могут вызывать для получения счётчика ссылок для конкретного объекта.
slots
Объявление внутри класса, которое экономит память, заранее выделяя место для атрибутов экземпляра и устраняя словари экземпляров. Хотя этот метод популярен, его правильное применение требует некоторой аккуратности, и его лучше использовать только в редких случаях, когда в приложении с критичной памятью создаётся большое количество экземпляров.
последовательность
Итерируемый объект, который поддерживает эффективный доступ к элементам по целочисленным индексам через специальный метод __getitem__() и определяет метод len(), возвращающий длину последовательности. Некоторые встроенные типы последовательностей: list, str, tuple и unicode. Обратите внимание: dict тоже поддерживает __getitem__() и __len__(), но считается отображением, а не последовательностью, поскольку поиск использует произвольные неизменяемые ключи, а не целые числа.
срез
Объект, обычно содержащий часть последовательности. Срез создаётся с помощью синтаксиса индексации, [] с двоеточиями между числами, если указано несколько, как в variable_name[1:3:5]. Синтаксис квадратных скобок (индексации) внутри использует объекты slice.
специальный метод
A method that is called implicitly by Python to execute a certain operation on a type, such as addition. Such methods have names starting and ending with double underscores. Special methods are documented in Special method names.
инструкция
Инструкция (statement) – это часть блока (блока кода). Инструкцией является либо выражение, либо одна из нескольких конструкций с ключевым словом, таких как if, while или for.
строка в тройных кавычках
Строка, ограниченная тремя экземплярами либо кавычек («), либо апострофов ('). Хотя они не предоставляют никаких возможностей, недоступных для строк в одинарных кавычках, они полезны по ряду причин. Они позволяют включать в строку неэкранированные одинарные и двойные кавычки и могут занимать несколько строк без использования символа продолжения, что делает их особенно полезными при написании докстрингов.
тип
Тип объекта Python определяет, что это за объект; каждый объект имеет тип. Тип объекта доступен как его атрибут __class__ или может быть получен с помощью type(obj).
представление
Объекты, возвращаемые из dict.keys(), dict.items() и dict.items(), называются представлениями словаря. Это ленивые последовательности, которые отслеживают изменения в базовом словаре. Чтобы превратить представление словаря в полноценный список, используйте list(dictview). См. Объекты представлений словаря.
виртуальная машина
Компьютер, полностью определённый в программном обеспечении. Виртуальная машина Python выполняет байт-код, генерируемый компилятором байт-кода.
Дзен Python
Перечень принципов и философии проектирования Python, полезных для понимания и использования языка. Этот перечень можно получить, введя в интерактивном режиме «import this».