ЧЗВ по программированию¶Programming FAQ

Существует ли отладчик на уровне исходного кода с точками останова, пошаговым выполнением и т. д.?¶Is there a source code level debugger with breakpoints, single-stepping, etc.?

Да.

Модуль pdb – это простой, но достаточный консольный отладчик для Python. Он является частью стандартной библиотеки Python и documented in the Library Reference Manual. Вы также можете написать собственный отладчик, используя код pdb в качестве примера.

Интерактивная среда разработки IDLE, которая входит в стандартную установку Python (обычно доступна как Tools/scripts/idle), включает графический отладчик.

PythonWin – это IDE для Python, включающая графический отладчик на основе pdb. Отладчик Pythonwin подсвечивает точки останова и обладает рядом полезных возможностей, таких как отладка программ, не относящихся к Pythonwin. PythonWin доступен как часть проекта Python for Windows Extensions и как часть дистрибутива ActivePython (см. https://www.activestate.com/activepython).

Boa Constructor – это среда разработки и конструктор графического интерфейса на основе wxWidgets. Он предоставляет визуальное создание и редактирование фреймов, инспектор объектов, различные представления исходного кода, включая обозреватели объектов, иерархии наследования, HTML-документацию, сгенерированную из строк документации, расширенный отладчик, встроенную справку и поддержку Zope.

Eric – это IDE, построенная на PyQt и компоненте редактирования Scintilla.

Pydb – это версия стандартного отладчика Python pdb, модифицированная для использования с DDD (Data Display Debugger), популярным графическим интерфейсом отладчика. Pydb можно найти по адресу http://bashdb.sourceforge.net/pydb/, а DDD – по адресу https://www.gnu.org/software/ddd.

Существует ряд коммерческих IDE для Python, включающих графические отладчики. Среди них:

• Wing IDE (https://wingware.com/)

• Komodo IDE (https://komodoide.com/)

• PyCharm (https://www.jetbrains.com/pycharm/)

Существует ли инструмент для поиска ошибок или выполнения статического анализа?¶Is there a tool to help find bugs or perform static analysis?

Да.

PyChecker – это инструмент статического анализа, который находит ошибки в исходном коде Python и предупреждает о сложности и стиле кода. PyChecker можно получить по адресу http://pychecker.sourceforge.net/.

Pylint – это ещё один инструмент, который проверяет, соответствует ли модуль стандарту кодирования, а также позволяет писать плагины для добавления собственных возможностей. В дополнение к проверке ошибок, выполняемой PyChecker, Pylint предлагает некоторые дополнительные функции, такие как проверка длины строк, соответствие имён переменных вашему стандарту кодирования, полная реализация объявленных интерфейсов и многое другое. На https://docs.pylint.org/ представлен полный список возможностей Pylint.

Как создать автономный исполняемый файл из скрипта Python?¶How can I create a stand-alone binary from a Python script?

Вам не нужно уметь компилировать Python в C, если ваша цель – создать автономную программу, которую пользователи могут скачать и запустить без предварительной установки дистрибутива Python. Существует ряд инструментов, которые определяют набор модулей, необходимых программе, и связывают эти модули вместе с бинарным файлом Python, создавая единый исполняемый файл.

Один из способов – использовать инструмент freeze, который включён в дерево исходных текстов Python как Tools/freeze. Он преобразует байт-код Python в C-массивы; с помощью C-компилятора можно встроить все свои модули в новую программу, которая затем компонуется со стандартными модулями Python.

Он работает, рекурсивно сканируя ваш исходный код на наличие операторов import (в обеих формах) и ищет модули в стандартном пути Python, а также в каталоге исходного кода (для встроенных модулей). Затем он превращает байт-код модулей, написанных на Python, в код C (инициализаторы массивов, которые можно превратить в объекты кода с помощью модуля marshal) и создает специальный конфигурационный файл, содержащий только те встроенные модули, которые действительно используются в программе. После этого он компилирует сгенерированный код C и компонует его с остальной частью интерпретатора Python, формируя самодостаточный бинарный файл, который ведет себя точно так же, как ваш скрипт.

Очевидно, freeze требует компилятор C. Существует несколько других утилит, которые не требуют. Одна из них – py2exe Томаса Хеллера (только для Windows) по адресу

http://www.py2exe.org/

Другой инструмент – cx_Freeze Энтони Туйнинги.

Существуют ли стандарты кодирования или руководство по стилю для программ на Python?¶Are there coding standards or a style guide for Python programs?

Да. Требуемый стиль оформления кода для модулей стандартной библиотеки описан в документе PEP 8.

Почему возникает UnboundLocalError, если переменная содержит значение?¶Why am I getting an UnboundLocalError when the variable has a value?

Может быть неожиданным получить ошибку UnboundLocalError в ранее работавшем коде после добавления оператора присваивания где-то в теле функции.

Этот код:

>>> x = 10
>>> def bar():
...     print(x)
>>> bar()
10

работает, но этот код:

>>> x = 10
>>> def foo():
...     print(x)
...     x += 1

приводит к ошибке UnboundLocalError:

>>> foo()
Traceback (most recent call last):
  ...
UnboundLocalError: local variable 'x' referenced before assignment

Это происходит потому, что при присваивании значения переменной в некоторой области видимости эта переменная становится локальной для данной области и затеняет любую одноимённую переменную из внешней области. Поскольку последний оператор в foo присваивает новое значение x, компилятор считает её локальной переменной. Следовательно, когда предыдущий print(x) пытается вывести на печать неинициализированную локальную переменную, возникает ошибка.

В приведённом выше примере можно получить доступ к переменной внешней области, объявив её глобальной:

>>> x = 10
>>> def foobar():
...     global x
...     print(x)
...     x += 1
>>> foobar()
10

Такое явное объявление необходимо, чтобы напомнить: в отличие от внешне похожей ситуации с переменными класса и экземпляра, здесь фактически изменяется значение переменной во внешней области видимости:

>>> print(x)
11

Аналогичное действие можно выполнить во вложенной области видимости с помощью ключевого слова nonlocal:

>>> def foo():
...    x = 10
...    def bar():
...        nonlocal x
...        print(x)
...        x += 1
...    bar()
...    print(x)
>>> foo()
10
11

Каковы правила использования локальных и глобальных переменных в Python?¶What are the rules for local and global variables in Python?

В Python переменные, на которые только ссылаются внутри функции, неявно считаются глобальными. Если переменной присваивается значение где-либо в теле функции, она считается локальной, если явно не объявлена как global.

Хотя поначалу это может показаться удивительным, небольшое размышление объясняет такое поведение. С одной стороны, требование global для присваиваемых переменных служит барьером против непреднамеренных побочных эффектов. С другой стороны, если бы global требовалось для всех глобальных ссылок, пришлось бы постоянно использовать global. Пришлось бы объявлять как global каждую ссылку на встроенную функцию или компонент импортированного модуля. Такая избыточность свела бы на нет пользу объявления global для выявления побочных эффектов.

Почему лямбды, определённые в цикле с разными значениями, все возвращают один и тот же результат?¶Why do lambdas defined in a loop with different values all return the same result?

Предположим, что с помощью цикла for определяется несколько разных лямбд (или даже обычных функций), например:

>>> squares = []
>>> for x in range(5):
...     squares.append(lambda: x**2)

Это даёт список, содержащий 5 лямбд, вычисляющих x**2. Можно ожидать, что при вызове они вернут соответственно 0, 1, 4, 9 и 16. Однако при попытке вызова обнаружится, что все они возвращают 16:

>>> squares[2]()
16
>>> squares[4]()
16

Это происходит потому, что x не является локальной для лямбд, а определена во внешней области видимости, и обращение к ней происходит при вызове лямбды, а не при её определении. В конце цикла значение x равно 4, поэтому все функции теперь возвращают 4**2, то есть 16. Это можно также проверить, изменив значение x и посмотрев, как изменятся результаты лямбд:

>>> x = 8
>>> squares[2]()
64

Чтобы избежать этого, необходимо сохранить значения в переменных, локальных для лямбд, чтобы они не зависели от значения глобальной x:

>>> squares = []
>>> for x in range(5):
...     squares.append(lambda n=x: n**2)

Здесь n=x создаёт новую переменную n, локальную для лямбды и вычисляемую при её определении, так что она имеет то же значение, которое x имела в этот момент в цикле. Это означает, что значение n будет равно 0 в первой лямбде, 1 – во второй, 2 – в третьей и так далее. Следовательно, теперь каждая лямбда будет возвращать правильный результат:

>>> squares[2]()
4
>>> squares[4]()
16

Обратите внимание: такое поведение присуще не только лямбдам, но и обычным функциям.

Как разделять глобальные переменные между модулями?¶How do I share global variables across modules?

Общепринятый способ обмена информацией между модулями в рамках одной программы – создать специальный модуль (часто называемый config или cfg). Достаточно импортировать модуль config во все модули приложения, и он станет доступен как глобальное имя. Поскольку у каждого модуля существует только один экземпляр, любые изменения объекта модуля отражаются везде. Например:

config.py:

x = 0   # Значение по умолчанию для параметра конфигурации 'x'

mod.py:

import config
config.x = 1

main.py:

import config
import mod
print(config.x)

Обратите внимание: использование модуля также является основой для реализации паттерна Singleton по той же причине.

Каковы «лучшие практики» использования import в модуле?¶What are the “best practices” for using import in a module?

В целом не стоит использовать from modulename import *. Это захламляет пространство имён импортёра и сильно усложняет линтерам обнаружение неопределённых имён.

Импортируйте модули в начале файла. Так сразу становится ясно, какие ещё модули требуются вашему коду, и не возникает вопросов, находится ли имя модуля в области видимости. Использование одного импорта на строку упрощает добавление и удаление импортов, а использование нескольких импортов в одной строке экономит место на экране.

Рекомендуется импортировать модули в следующем порядке:

1. модули стандартной библиотеки – например sys, os, getopt, re

2. модули сторонних библиотек (всё, установленное в каталог site-packages Python), например mx.DateTime, ZODB, PIL.Image и т.д.

3. модули локальной разработки

Иногда импорты приходится переносить внутрь функции или класса, чтобы избежать проблем с циклическими импортами. Gordon McMillan говорит:

Циклические импорты нормально работают, когда оба модуля используют форму импорта “import <module>”. Они перестают работать, когда второй модуль пытается получить имя из первого (“from module import name”), и импорт находится на верхнем уровне. Это происходит потому, что имена в первом модуле ещё недоступны, так как первый модуль занят импортом второго.

В этом случае, если второй модуль используется только в одной функции, импорт можно легко перенести в эту функцию. К моменту вызова импорта первый модуль уже завершит инициализацию, и второй модуль сможет выполнить свой импорт.

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

Переносите импорты в локальную область видимости, например в определение функции, только если это необходимо для решения проблемы – избежания циклического импорта или сокращения времени инициализации модуля. Этот приём особенно полезен, когда многие импорты не нужны в зависимости от того, как выполняется программа. Также можно перенести импорты в функцию, если модули используются только в ней. Обратите внимание: первая загрузка модуля может быть дорогой из-за однократной инициализации, но повторные загрузки практически бесплатны и требуют лишь пары словарных поисков. Даже если имя модуля вышло из области видимости, сам модуль, скорее всего, доступен в sys.modules.

Почему значения по умолчанию являются общими для объектов?¶Why are default values shared between objects?

Подобная ошибка часто подстерегает начинающих программистов. Рассмотрим следующую функцию:

def foo(mydict={}):  # Опасность: общая ссылка на один словарь для всех вызовов
    ... compute something ...
    mydict[key] = value
    return mydict

При первом вызове этой функции mydict содержит один элемент. При втором вызове mydict содержит уже два элемента, потому что когда foo() начинает выполняться, mydict уже содержит один элемент.

Часто ожидается, что при вызове функции для значений по умолчанию создаются новые объекты. Но это не так. Значения по умолчанию создаются ровно один раз, при определении функции. Если этот объект изменяется (как словарь в данном примере), то последующие вызовы функции будут обращаться к этому изменённому объекту.

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

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

def foo(mydict={}):
    ...

а:

def foo(mydict=None):
    if mydict is None:
        mydict = {}  # создать новый словарь для локального пространства имён

Эта возможность может быть полезной. Если есть функция, вычисление которой требует много времени, распространённый приём – кэшировать параметры и результат каждого вызова функции, а при повторном запросе тех же значений возвращать сохранённый результат. Это называется «мемоизация» и может быть реализовано так:

# Вызывающие могут передавать только два параметра и опционально _cache по ключевому слову
def expensive(arg1, arg2, *, _cache={}):
    if (arg1, arg2) in _cache:
        return _cache[(arg1, arg2)]

    # Вычислить значение
    result = ... expensive computation ...
    _cache[(arg1, arg2)] = result           # Сохранить результат в кеше
    return result

Вместо значения по умолчанию можно использовать глобальную переменную со словарём; это дело вкуса.

Как передать необязательные или именованные параметры из одной функции в другую?¶How can I pass optional or keyword parameters from one function to another?

Соберите аргументы с помощью спецификаторов * и ** в списке параметров функции; это даст позиционные аргументы в виде кортежа, а именованные – в виде словаря. Затем вы можете передать эти аргументы при вызове другой функции, используя * и **:

def f(x, *args, **kwargs):
    ...
    kwargs['width'] = '14.3c'
    ...
    g(x, *args, **kwargs)

В чём разница между аргументами и параметрами?¶What is the difference between arguments and parameters?

Параметры определяются именами, которые указаны в определении функции, тогда как аргументы – это значения, которые передаются функции при её вызове. Параметры определяют, какие типы аргументов может принимать функция. Например, для такого определения функции:

def func(foo, bar=None, **kwargs):
    pass

foo, bar и kwargs являются параметрами функции func. Однако при вызове func, например:

func(42, bar=314, extra=somevar)

значения 42, 314 и somevar являются аргументами.

Почему изменение списка ‘y’ также изменило список ‘x’?¶Why did changing list ‘y’ also change list ‘x’?

Если вы написали такой код:

>>> x = []
>>> y = x
>>> y.append(10)
>>> y
[10]
>>> x
[10]

вас может интересовать, почему добавление элемента к y изменило и x.

К этому результату приводят два фактора:

1. Переменные – это просто имена, ссылающиеся на объекты. Операция y = x не создаёт копию списка – она создаёт новую переменную y, которая ссылается на тот же объект, что и x. Это означает, что существует только один объект (список), и обе переменные x и y ссылаются на него.

2. Списки являются изменяемыми, то есть их содержимое можно изменять.

После вызова append() содержимое изменяемого объекта\nизменилось с [] на [10]. Поскольку обе переменные ссылаются на один и тот же объект, использование любого имени даёт доступ к изменённому значению [10].

Если же присвоить неизменяемый объект x:

>>> x = 5  # int – неизменяемый тип
>>> y = x
>>> x = x + 1  # 5 нельзя изменить, здесь создаётся новый объект
>>> x
6
>>> y
5

в этом случае x и y уже не равны. Это\nпотому, что целые числа неизменяемы, и когда мы делаем x = x + 1, мы не\nизменяем int 5, увеличивая его значение; вместо этого мы создаём\nновый объект (int 6) и присваиваем его x (то есть изменяем, на какой объект ссылается x). После этого присваивания у нас есть два объекта (int 6 и 5) и две переменные, ссылающиеся на них (x теперь ссылается на 6, а y всё ещё ссылается на 5).

Некоторые операции (например y.append(10) и y.sort()) изменяют\nобъект, тогда как внешне похожие операции (например y = y + [10]\nи sorted(y)) создают новый объект. В общем случае в Python (и во всех случаях\nв стандартной библиотеке) метод, изменяющий объект, возвращает None,\nчтобы избежать путаницы между двумя типами операций. Так что если вы\nошибочно напишете y.sort(), думая, что получите отсортированную копию y,\nто вместо этого получите None, что, скорее всего, приведёт к легко диагностируемой ошибке в вашей программе.

Однако есть один класс операций, где одна и та же операция иногда\nведёт себя по-разному с разными типами: составные операторы присваивания.\nНапример, += изменяет списки, но не кортежи или целые числа (a_list += [1, 2, 3] эквивалентно a_list.extend([1, 2, 3]) и изменяет\na_list, тогда как some_tuple += (1, 2, 3) и some_int += 1 создают\nновые объекты).

Иными словами:

• Если у нас есть изменяемый объект (list, dict, set, и т. д.), можно использовать некоторые специфические операции для его изменения, и все переменные, которые на него ссылаются, увидят это изменение.

• Если у нас есть неизменяемый объект (str, int, tuple, и т. д.), все переменные, которые на него ссылаются, всегда будут видеть одно и то же значение, но операции, преобразующие это значение в новое, всегда возвращают новый объект.

Чтобы узнать, ссылаются ли две переменные на один и тот же объект, можно\nиспользовать оператор is или встроенную функцию id().

Как написать функцию с выходными параметрами (передача по ссылке)?¶How do I write a function with output parameters (call by reference)?

Помните, что в Python аргументы передаются по присваиванию. Поскольку присваивание лишь создает ссылки на объекты, между именем аргумента в вызывающей и вызываемой функции нет псевдонима, а значит, нет и передачи по ссылке как таковой. Желаемого эффекта можно достичь несколькими способами.

1. Возвращая кортеж результатов:

   def func2(a, b):
       a = 'new-value'        # a и b – локальные имена
       b = b + 1              # присвоены новым объектам
       return a, b            # вернуть новые значения
   
   x, y = 'old-value', 99
   x, y = func2(x, y)
   print(x, y)                # вывод: new-value 100
   

   Это почти всегда самое понятное решение.

2. С помощью глобальных переменных. Это не потокобезопасно и не рекомендуется.

3. Передавая изменяемый (изменяемый на месте) объект:

   def func1(a):
       a[0] = 'new-value'     # 'a' ссылается на изменяемый список
       a[1] = a[1] + 1        # изменяет общий объект
   
   args = ['old-value', 99]
   func1(args)
   print(args[0], args[1])    # вывод: new-value 100
   

4. Передавая словарь, который будет изменён:

   def func3(args):
       args['a'] = 'new-value'     # args – изменяемый словарь
       args['b'] = args['b'] + 1   # изменить его на месте
   
   args = {'a': 'old-value', 'b': 99}
   func3(args)
   print(args['a'], args['b'])
   

5. Или объединив значения в экземпляре класса:

   class callByRef:
       def __init__(self, **args):
           for (key, value) in args.items():
               setattr(self, key, value)
   
   def func4(args):
       args.a = 'new-value'        # args – изменяемый callByRef
       args.b = args.b + 1         # изменить объект на месте
   
   args = callByRef(a='old-value', b=99)
   func4(args)
   print(args.a, args.b)
   

   Почти никогда нет веской причины усложнять до такой степени.

Лучший выбор – вернуть кортеж, содержащий несколько результатов.

Как сделать функцию высшего порядка в Python?¶How do you make a higher order function in Python?

У вас есть два варианта: использовать вложенные области видимости или вызываемые объекты.\nНапример, предположим, вы хотите определить linear(a,b), которая возвращает\nфункцию f(x), вычисляющую значение a*x+b. Используя вложенные области видимости:

def linear(a, b):
    def result(x):
        return a * x + b
    return result

Или используя вызываемый объект:

class linear:

    def __init__(self, a, b):
        self.a, self.b = a, b

    def __call__(self, x):
        return self.a * x + self.b

В обоих случаях

taxes = linear(0.3, 2)

даёт вызываемый объект, где taxes(10e6) == 0.3 * 10e6 + 2.

Подход с вызываемым объектом имеет недостаток: он немного медленнее и\nприводит к чуть более длинному коду. Однако обратите внимание, что набор вызываемых объектов\nможет разделять свою сигнатуру через наследование:

class exponential(linear):
    # __init__ унаследован
    def __call__(self, x):
        return self.a * (x ** self.b)

Объект может инкапсулировать состояние для нескольких методов:

class counter:

    value = 0

    def set(self, x):
        self.value = x

    def up(self):
        self.value = self.value + 1

    def down(self):
        self.value = self.value - 1

count = counter()
inc, dec, reset = count.up, count.down, count.set

Здесь inc(), dec() и reset() ведут себя как функции, которые разделяют одну\nи ту же переменную счётчика.

Как скопировать объект в Python?¶How do I copy an object in Python?

В общем случае для копирования попробуйте copy.copy() или copy.deepcopy().\nНе все объекты можно копировать, но большинство можно.

Некоторые объекты можно скопировать проще. У словарей есть метод copy():

newdict = olddict.copy()

Последовательности можно скопировать срезом:

new_l = l[:]

Как найти методы или атрибуты объекта?¶How can I find the methods or attributes of an object?

Для экземпляра x пользовательского класса dir(x) возвращает отсортированный по алфавиту список имён, содержащий атрибуты экземпляра, методы и атрибуты, определённые в его классе.

Как код может узнать имя объекта?¶How can my code discover the name of an object?

Вообще говоря, нет, потому что у объектов на самом деле нет имён. По сути, присваивание всегда связывает имя со значением; то же верно для операторов def и class, но в этом случае значением является вызываемый объект. Рассмотрим следующий код:

>>> class A:
...     pass
...
>>> B = A
>>> a = B()
>>> b = a
>>> print(b)
<__main__.A object at 0x16D07CC>
>>> print(a)
<__main__.A object at 0x16D07CC>

Можно утверждать, что у класса есть имя: даже если он привязан к двум именам и вызывается через имя B, созданный экземпляр всё равно будет определён как экземпляр класса A. Однако невозможно сказать, какое имя у экземпляра – a или b, поскольку оба имени привязаны к одному и тому же значению.

Вообще говоря, коду не требуется «знать имена» конкретных значений. Если вы не пишете намеренно интроспективные программы, это обычно указывает на то, что стоит изменить подход.

В comp.lang.python Фредрик Лунд однажды привёл отличную аналогию в ответ на этот вопрос:

Так же, как вы узнаёте имя кота, которого нашли на крыльце: сам кот (объект) не может сказать вам своё имя, да ему всё равно – поэтому единственный способ выяснить, как его зовут, – спросить всех соседей (пространства имён), не их ли это кот (объект)…

…и не удивляйтесь, если окажется, что он известен под многими именами или вообще без имени!

Что не так с приоритетом оператора-запятой?¶What’s up with the comma operator’s precedence?

Запятая в Python – не оператор. Рассмотрим такой сеанс:

>>> "a" in "b", "a"
(False, 'a')

Поскольку запятая – не оператор, а разделитель между выражениями, приведённый выше код выполняется так, как если бы вы ввели:

("a" in "b"), "a"

а не:

"a" in ("b", "a")

То же самое верно для различных операторов присваивания (=, += и т. д.). Они не являются операторами в полном смысле, а представляют собой синтаксические разделители в операторах присваивания.

Существует ли аналог тернарного оператора «?:» из C?¶Is there an equivalent of C’s “?:” ternary operator?

Да, существует. Синтаксис следующий:

[on_true] if [expression] else [on_false]

x, y = 50, 25
small = x if x < y else y

До введения этого синтаксиса в Python 2.5 распространённым приёмом было использование логических операторов:

[expression] and [on_true] or [on_false]

Однако этот приём небезопасен, поскольку может давать неверные результаты, если on_true имеет ложное булево значение. Поэтому всегда лучше использовать форму ... if ... else ....

Можно ли писать запутанные однострочники на Python?¶Is it possible to write obfuscated one-liners in Python?

Да. Обычно это делается вложением lambda внутрь lambda. См. следующие три примера, предоставленные Ульфом Бартельтом:

from functools import reduce

# Простые числа < 1000
print(list(filter(None,map(lambda y:y*reduce(lambda x,y:x*y!=0,
map(lambda x,y=y:y%x,range(2,int(pow(y,0.5)+1))),1),range(2,1000)))))

# Первые 10 чисел Фибоначчи
print(list(map(lambda x,f=lambda x,f:(f(x-1,f)+f(x-2,f)) if x>1 else 1:
f(x,f), range(10))))

# Множество Мандельброта
print((lambda Ru,Ro,Iu,Io,IM,Sx,Sy:reduce(lambda x,y:x+y,map(lambda y,
Iu=Iu,Io=Io,Ru=Ru,Ro=Ro,Sy=Sy,L=lambda yc,Iu=Iu,Io=Io,Ru=Ru,Ro=Ro,i=IM,
Sx=Sx,Sy=Sy:reduce(lambda x,y:x+y,map(lambda x,xc=Ru,yc=yc,Ru=Ru,Ro=Ro,
i=i,Sx=Sx,F=lambda xc,yc,x,y,k,f=lambda xc,yc,x,y,k,f:(k<=0)or (x*x+y*y
>=4.0) or 1+f(xc,yc,x*x-y*y+xc,2.0*x*y+yc,k-1,f):f(xc,yc,x,y,k,f):chr(
64+F(Ru+x*(Ro-Ru)/Sx,yc,0,0,i)),range(Sx))):L(Iu+y*(Io-Iu)/Sy),range(Sy
))))(-2.1, 0.7, -1.2, 1.2, 30, 80, 24))
#    \___ ___/  \___ ___/  |   |   |__ линии на экране
#        V          V      |   |______ столбцы на экране
#        |          |      |__________ максимум "iterations"
#        |          |_________________ диапазон по оси Y
#        |____________________________ диапазон по оси X

Не пытайтесь повторить это дома, дети!

Как задать шестнадцатеричные и восьмеричные целые числа?¶How do I specify hexadecimal and octal integers?

Чтобы задать восьмеричное число, поставьте перед восьмеричным значением ноль, а затем строчную или прописную букву «o». Например, чтобы присвоить переменной «a» восьмеричное значение «10» (8 в десятичной системе), введите:

>>> a = 0o10
>>> a
8

Шестнадцатеричные числа задаются так же просто. Просто поставьте перед шестнадцатеричным числом ноль, а затем строчную или прописную «x». Шестнадцатеричные цифры можно указывать в нижнем или верхнем регистре. Например, в интерпретаторе Python:

>>> a = 0xa5
>>> a
165
>>> b = 0XB2
>>> b
178

Почему -22 // 10 возвращает -3?¶Why does -22 // 10 return -3?

В первую очередь это вызвано желанием, чтобы i % j имел тот же знак, что и j. Если вы хотите этого, а также хотите:

i == (i // j) * j + (i % j)

тогда целочисленное деление должно возвращать пол (округление вниз). Язык C также требует выполнения этого тождества, и тогда компиляторы, усекающие i // j, должны делать так, чтобы i % j имел тот же знак, что и i.

Существует мало реальных применений i % j, когда j отрицательно. Когда j положительно, применений много, и практически во всех из них полезнее, чтобы i % j было >= 0. Если часы показывают 10 сейчас, что они показывали 200 часов назад? -190 % 12 == 2 полезно; -190 % 12 == -10 – это ошибка, которая только и ждёт, чтобы её допустили.

Как преобразовать строку в число?¶How do I convert a string to a number?

Для целых чисел используйте встроенный конструктор типа int(), например int('144') == 144. Аналогично, float() преобразует в число с плавающей запятой, например float('144') == 144.0.

По умолчанию они интерпретируют число как десятичное, так что int('0144') == 144 и int('0x144') вызывает ValueError. int(string, base) принимает основание системы счисления в качестве второго необязательного аргумента, поэтому int('0x144', 16) == 324. Если основание задано как 0, число интерпретируется по правилам Python: префикс '0o' означает восьмеричную, а '0x' – шестнадцатеричную систему.

Не используйте встроенную функцию eval(), если нужно просто преобразовать строку в число. eval() будет работать значительно медленнее и создаёт угрозу безопасности: кто-то может передать Python-выражение с нежелательными побочными эффектами. Например, можно передать __import__('os').system("rm -rf $HOME"), что приведёт к удалению вашего домашнего каталога.

eval() также интерпретирует числа как выражения Python, поэтому, например, eval('09') вызывает синтаксическую ошибку, поскольку Python не допускает ведущий ‘0’ в десятичном числе (кроме ‘0’).

Как преобразовать число в строку?¶How do I convert a number to a string?

Чтобы преобразовать, например, число 144 в строку '144', используйте встроенный конструктор типа str(). Если нужно шестнадцатеричное или восьмеричное представление, используйте встроенные функции hex() или oct(). Для расширенного форматирования см. разделы Форматированные строковые литералы и Синтаксис форматных строк, например "{:04d}".format(144) даёт '0144', а "{:.3f}".format(1.0/3.0) даёт '0.333'.

Как изменить строку на месте?¶How do I modify a string in place?

Нельзя, потому что строки неизменяемы. В большинстве случаев следует просто создавать новую строку из тех частей, из которых вы хотите её собрать. Однако, если нужен объект с возможностью изменять данные Unicode на месте, попробуйте использовать объект io.StringIO или модуль array :

>>> import io
>>> s = "Hello, world"
>>> sio = io.StringIO(s)
>>> sio.getvalue()
'Hello, world'
>>> sio.seek(7)
7
>>> sio.write("there!")
6
>>> sio.getvalue()
'Hello, there!'

>>> import array
>>> a = array.array('u', s)
>>> print(a)
array('u', 'Hello, world')
>>> a[0] = 'y'
>>> print(a)
array('u', 'yello, world')
>>> a.tounicode()
'yello, world'

Как использовать строки для вызова функций/методов?¶How do I use strings to call functions/methods?

Существует несколько приёмов.

• Лучший из них – использовать словарь, сопоставляющий строки с функциями. Главное преимущество этого подхода в том, что строки не обязаны совпадать с именами функций. Это также основной способ эмуляции конструкции case:

  def a():
      pass
  
  def b():
      pass
  
  dispatch = {'go': a, 'stop': b}  # Обратите внимание на отсутствие скобок для функций
  
  dispatch[get_input()]()  # Обратите внимание на завершающие скобки для вызова функции
  

• Используйте встроенную функцию getattr():

  import foo
  getattr(foo, 'bar')()
  

  Обратите внимание: getattr() работает с любыми объектами, включая классы, экземпляры классов, модули и т.д.

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

  class Foo:
      def do_foo(self):
          ...
  
      def do_bar(self):
          ...
  
  f = getattr(foo_instance, 'do_' + opname)
  f()
  

• Используйте locals() или eval() для разрешения имени функции:

  def myFunc():
      print("hello")
  
  fname = "myFunc"
  
  f = locals()[fname]
  f()
  
  f = eval(fname)
  f()
  

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

Существует ли аналог функции chomp() из Perl для удаления завершающих символов новой строки из строк?¶Is there an equivalent to Perl’s chomp() for removing trailing newlines from strings?

Можно использовать S.rstrip("\r\n") для удаления всех символов конца строки в конце строки S, не затрагивая остальные пробельные символы. Если строка S содержит несколько строк с пустыми строками в конце, будут удалены завершающие символы для всех пустых строк:

>>> lines = ("line 1 \r\n"
...          "\r\n"
...          "\r\n")
>>> lines.rstrip("\n\r")
'line 1 '

Поскольку такой подход обычно нужен только при чтении текста построчно, S.rstrip() в таком виде отлично подходит.

Существует ли аналог функций scanf() или sscanf()?¶Is there a scanf() or sscanf() equivalent?

Прямого аналога нет.

Для простого разбора ввода проще всего разбить строку на слова, разделённые пробельными символами, с помощью метода split() строковых объектов, а затем преобразовать десятичные строки в числа через int() или float(). Функция split() поддерживает необязательный параметр «sep», который удобен, если разделителем выступает не пробел.

Для более сложного разбора ввода регулярные выражения мощнее, чем C-функция sscanf(), и лучше подходят для этой задачи.

Что означает ошибка UnicodeDecodeError или UnicodeEncodeError?¶What does ‘UnicodeDecodeError’ or ‘UnicodeEncodeError’ error mean?

Смотрите Unicode HOWTO.

Моя программа слишком медленная. Как её ускорить?¶My program is too slow. How do I speed it up?

В целом это непростой вопрос. Во-первых, вот список того, что стоит помнить, прежде чем углубляться:

• Характеристики производительности различаются в разных реализациях Python. В этом FAQ основное внимание уделяется CPython.

• Поведение может различаться в разных операционных системах, особенно когда речь идёт о вводе-выводе или многопоточности.

• всегда следует находить горячие точки в своей программе перед попыткой оптимизировать какой-либо код (см. модуль profile).

• Написание эталонных скриптов позволит быстро выполнять итерации при поиске улучшений (см. модуль timeit).

• Настоятельно рекомендуется иметь хорошее покрытие кода (с помощью модульного тестирования или любой другой методики) перед возможным внесением регрессий, скрытых в сложных оптимизациях.

Тем не менее, есть много приёмов для ускорения кода на Python. Вот некоторые общие принципы, которые сильно помогают достичь приемлемого уровня производительности:

• Ускорение алгоритмов (или замена на более быстрые) может принести гораздо большую выгоду, чем попытки рассыпать микрооптимизации по всему коду.

• Используйте правильные структуры данных. Изучите документацию по Встроенным типам и модулю collections.

• Когда стандартная библиотека предоставляет примитив для выполнения какой-либо операции, он, скорее всего (хотя и не гарантированно), будет быстрее любого альтернативного решения, которое вы можете придумать. Это вдвойне верно для примитивов, написанных на C, таких как встроенные функции и некоторые типы расширений. Например, обязательно используйте либо встроенный метод list.sort(), либо соответствующую функцию sorted() для сортировки (и обратитесь к Руководству по сортировке для примеров умеренно продвинутого использования).

• Абстракции обычно создают косвенность и заставляют интерпретатор работать больше. Если уровни косвенности перевешивают объём полезной работы, программа будет медленнее. Следует избегать чрезмерной абстракции, особенно в виде крошечных функций или методов (которые также часто вредят читаемости).

Если вы достигли предела возможностей чистого Python, существуют инструменты, которые помогут пойти дальше. Например, Cython может скомпилировать слегка изменённую версию кода Python в расширение C и может использоваться на многих разных платформах. Cython может использовать компиляцию (и необязательные аннотации типов), чтобы сделать ваш код значительно быстрее, чем при интерпретации. Если вы уверены в своих навыках программирования на C, вы также можете самостоятельно написать модуль расширения на C.

Как наиболее эффективно объединить много строк?¶What is the most efficient way to concatenate many strings together?

Объекты str и bytes неизменяемы, поэтому объединение множества строк неэффективно, поскольку каждое объединение создаёт новый объект. В общем случае общая стоимость выполнения квадратично зависит от общей длины строк.

Для накопления множества объектов str рекомендуется помещать их в список и в конце вызвать str.join():

chunks = []
for s in my_strings:
    chunks.append(s)
result = ''.join(chunks)

(ещё один достаточно эффективный приём – использовать io.StringIO)

Для накопления множества объектов bytes рекомендуется расширять объект bytearray с помощью конкатенации на месте (оператор +=):

result = bytearray()
for b in my_bytes_objects:
    result += b

Как преобразовывать кортежи и списки друг в друга?¶How do I convert between tuples and lists?

Конструктор типа tuple(seq) преобразует любую последовательность (на самом деле любой итерируемый объект) в кортеж с теми же элементами в том же порядке.

Например, tuple([1, 2, 3]) даёт (1, 2, 3), а tuple('abc') даёт ('a', 'b', 'c'). Если аргумент уже является кортежем, копия не создаётся – возвращается тот же объект, поэтому вызов tuple() обходится дёшево, когда нет уверенности, что объект уже является кортежем.

Конструктор типа list(seq) преобразует любую последовательность или итерируемый объект в список с теми же элементами в том же порядке. Например, list((1, 2, 3)) даёт [1, 2, 3], а list('abc') даёт ['a', 'b', 'c']. Если аргумент является списком, создаётся копия, как и в случае seq[:].

Что такое отрицательный индекс?¶What’s a negative index?

Последовательности Python индексируются положительными и отрицательными числами. Для положительных чисел 0 – это первый индекс, 1 – второй и так далее. Для отрицательных индексов -1 – последний индекс, -2 – предпоследний (перед последним) и так далее. Считайте seq[-n] тем же, что и seq[len(seq)-n].

Использование отрицательных индексов может быть очень удобным. Например, S[:-1] – это вся строка, кроме последнего символа, что полезно для удаления завершающего перевода строки.

Как перебрать последовательность в обратном порядке?¶How do I iterate over a sequence in reverse order?

Используйте встроенную функцию reversed(), которая появилась в Python 2.4:

for x in reversed(sequence):
    ...  # сделать что-то с x ...

Это не затронет исходную последовательность, а создаст новую копию с обратным порядком для итерации.

В Python 2.3 можно использовать расширенный синтаксис срезов:

for x in sequence[::-1]:
    ...  # сделать что-то с x ...

Как удалить дубликаты из списка?¶How do you remove duplicates from a list?

См. Python Cookbook, где подробно рассматриваются многие способы сделать это:

https://code.activestate.com/recipes/52560/

Если перестановка элементов списка не страшна, отсортируйте его, а затем просмотрите с конца, удаляя дубликаты по ходу:

if mylist:
    mylist.sort()
    last = mylist[-1]
    for i in range(len(mylist)-2, -1, -1):
        if last == mylist[i]:
            del mylist[i]
        else:
            last = mylist[i]

Если все элементы списка могут использоваться как ключи множества (т.е. все они хешируемы), это часто быстрее

mylist = list(set(mylist))

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

Как создать массив в Python?¶How do you make an array in Python?

Используйте список:

["this", 1, "is", "an", "array"]

По временно́й сложности списки эквивалентны массивам C или Pascal; основное отличие в том, что список Python может содержать объекты разных типов.

Модуль array также предоставляет методы для создания массивов фиксированных типов с компактным представлением, но они медленнее при индексации, чем списки. Также обратите внимание, что расширения Numeric и другие определяют структуры, подобные массивам, с различными характеристиками.

Чтобы получить связные списки в стиле Lisp, можно эмулировать ячейки cons с помощью кортежей:

lisp_list = ("like",  ("this",  ("example", None) ) )

Если нужна изменяемость, можно использовать списки вместо кортежей. Здесь аналог lisp car – это lisp_list[0], а аналог cdr – lisp_list[1]. Делайте так, только если уверены, что это действительно необходимо, потому что обычно это намного медленнее, чем использование списков Python.

Как создать многомерный список?¶How do I create a multidimensional list?

Вероятно, вы пытались создать многомерный массив так:

>>> A = [[None] * 2] * 3

Если вывести его, выглядит правильно:

>>> A
[[None, None], [None, None], [None, None]]

Но когда вы присваиваете значение, оно появляется в нескольких местах:

>>> A[0][0] = 5
>>> A
[[5, None], [5, None], [5, None]]

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

Рекомендуемый подход – сначала создать список нужной длины, а затем заполнить каждый элемент заново созданным списком:

A = [None] * 3
for i in range(3):
    A[i] = [None] * 2

Это порождает список, содержащий 3 разных списка длины два. Также можно использовать списковое включение:

w, h = 2, 3
A = [[None] * w for i in range(h)]

Или можно воспользоваться расширением, предоставляющим тип данных «матрица»; наиболее известен NumPy.

Как применить метод к последовательности объектов?¶How do I apply a method to a sequence of objects?

Используйте списковое включение:

result = [obj.method() for obj in mylist]

Почему a_tuple[i] += ['item'] вызывает исключение, хотя сложение работает?¶Why does a_tuple[i] += [‘item’] raise an exception when the addition works?

Это связано с тем, что операторы расширенного присваивания являются операторами присваивания, а также с различием между изменяемыми и неизменяемыми объектами в Python.

Это обсуждение в целом применимо, когда операторы расширенного присваивания применяются к элементам кортежа, указывающим на изменяемые объекты, но в качестве примера мы используем list и +=.

Если написать:

>>> a_tuple = (1, 2)
>>> a_tuple[0] += 1
Traceback (most recent call last):
   ...
TypeError: 'tuple' object does not support item assignment

Причина исключения сразу становится ясна: 1 добавляется к объекту, на который указывает a_tuple[0] (1), в результате получается объект 2, но когда мы пытаемся присвоить результат вычисления 2 элементу 0 кортежа, возникает ошибка, потому что нельзя изменить, на что указывает элемент кортежа.

На самом деле то, что делает этот расширенный оператор присваивания, примерно таково:

>>> result = a_tuple[0] + 1
>>> a_tuple[0] = result
Traceback (most recent call last):
  ...
TypeError: 'tuple' object does not support item assignment

Ошибку вызывает именно часть присваивания операции, поскольку кортеж неизменяем.

Если написать что-то вроде:

>>> a_tuple = (['foo'], 'bar')
>>> a_tuple[0] += ['item']
Traceback (most recent call last):
  ...
TypeError: 'tuple' object does not support item assignment

Исключение несколько более неожиданно, и еще более удивительно то, что, несмотря на ошибку, append сработал:

>>> a_tuple[0]
['foo', 'item']

Чтобы понять, почему это происходит, нужно знать: (а) если объект реализует магический метод __iadd__, он вызывается, когда выполняется расширенное присваивание +=, и его возвращаемое значение используется в операторе присваивания; и (б) для списков __iadd__ эквивалентно вызову extend для списка и возврату этого списка. Поэтому мы говорим, что для списков += – это «сокращение» для list.extend:

>>> a_list = []
>>> a_list += [1]
>>> a_list
[1]

Это эквивалентно:

>>> result = a_list.__iadd__([1])
>>> a_list = result

Объект, на который указывает a_list, был изменён, и указатель на изменённый объект присваивается обратно a_list. Конечный результат присваивания – холостая операция (no-op), поскольку это указатель на тот же объект, на который a_list указывал ранее, но само присваивание всё равно происходит.

Таким образом, в нашем примере с кортежем происходит то же самое, что и в:

>>> result = a_tuple[0].__iadd__(['item'])
>>> a_tuple[0] = result
Traceback (most recent call last):
  ...
TypeError: 'tuple' object does not support item assignment

__iadd__ выполняется успешно, и список расширяется, но, хотя result указывает на тот же объект, на который уже указывает a_tuple[0], финальное присваивание всё равно вызывает ошибку, поскольку кортежи неизменяемы.

Как сделать, чтобы словарь хранил и выводил ключи в фиксированном порядке?¶How can I get a dictionary to store and display its keys in a consistent order?

Используйте collections.OrderedDict.

Я хочу выполнить сложную сортировку: можно ли сделать преобразование Шварца в Python?¶I want to do a complicated sort: can you do a Schwartzian Transform in Python?

Этот метод, приписываемый Рэндалу Шварцу из сообщества Perl, сортирует элементы списка по метрике, которая сопоставляет каждому элементу его «сортировочное значение». В Python используйте аргумент key для метода list.sort():

Isorted = L[:]
Isorted.sort(key=lambda s: int(s[10:15]))

Как отсортировать один список по значениям из другого списка?¶How can I sort one list by values from another list?

Объедините их в итератор кортежей, отсортируйте полученный список, а затем извлеките нужный элемент.

>>> list1 = ["what", "I'm", "sorting", "by"]
>>> list2 = ["something", "else", "to", "sort"]
>>> pairs = zip(list1, list2)
>>> pairs = sorted(pairs)
>>> pairs
[("I'm", 'else'), ('by', 'sort'), ('sorting', 'to'), ('what', 'something')]
>>> result = [x[1] for x in pairs]
>>> result
['else', 'sort', 'to', 'something']

Альтернатива для последнего шага:

>>> result = []
>>> for p in pairs: result.append(p[1])

Если вам это кажется более читаемым, вы можете предпочесть использовать это вместо конечного спискового включения. Однако для длинных списков это почти в два раза медленнее. Почему? Во-первых, операция append() должна перераспределять память, и хотя она использует некоторые трюки, чтобы избегать этого каждый раз, иногда ей всё же приходится это делать, что стоит довольно дорого. Во-вторых, выражение «result.append» требует дополнительного поиска атрибута, и в-третьих, скорость снижается из-за необходимости совершать все эти вызовы функций.

Что такое класс?¶What is a class?

Класс – это конкретный тип объекта, создаваемый при выполнении инструкции class. Объекты классов используются как шаблоны для создания объектов-экземпляров, которые содержат как данные (атрибуты), так и код (методы), характерные для данного типа данных.

Класс может быть основан на одном или нескольких других классах, называемых его базовыми классами. Он наследует атрибуты и методы своих базовых классов. Это позволяет последовательно уточнять объектную модель с помощью наследования. Например, можно иметь общий класс Mailbox, предоставляющий базовые методы доступа к почтовому ящику, и подклассы MboxMailbox, MaildirMailbox, OutlookMailbox, обрабатывающие различные форматы почтовых ящиков.

Что такое метод?¶What is a method?

Метод – это функция некоторого объекта x, которая обычно вызывается как x.name(arguments...). Методы определяются как функции внутри определения класса:

class C:
    def meth(self, arg):
        return arg * 2 + self.attribute

Что такое self?¶What is self?

Self – это просто условное имя для первого аргумента метода. Метод, определённый как meth(self, a, b, c), должен вызываться как x.meth(a, b, c) для некоторого экземпляра x класса, в котором находится определение; вызванный метод будет считать, что его вызвали как meth(x, a, b, c).

См. также Почему self должно явно использоваться в определениях и вызовах методов?.

Как проверить, является ли объект экземпляром данного класса или его подкласса?¶How do I check if an object is an instance of a given class or of a subclass of it?

Используйте встроенную функцию isinstance(obj, cls). Можно проверить, является ли объект экземпляром любого из нескольких классов, передав кортеж вместо одного класса, например isinstance(obj, (class1, class2, ...)), а также проверить, является ли объект одним из встроенных типов Python, например isinstance(obj, str) или isinstance(obj, (int, float, complex)).

Обратите внимание, что большинство программ не используют isinstance() для пользовательских классов очень часто. Если вы разрабатываете классы сами, более правильным объектно-ориентированным стилем будет определение методов в классах, инкапсулирующих определённое поведение, вместо проверки класса объекта и выполнения разных действий в зависимости от того, какой это класс. Например, если есть функция, которая делает что-то:

def search(obj):
    if isinstance(obj, Mailbox):
        ...  # код для поиска почтового ящика
    elif isinstance(obj, Document):
        ...  # код для поиска документа
    elif ...

Лучше определить метод search() во всех классах и просто вызывать его:

class Mailbox:
    def search(self):
        ...  # код для поиска почтового ящика

class Document:
    def search(self):
        ...  # код для поиска документа

obj.search()

Что такое делегирование?¶What is delegation?

Делегирование – это объектно-ориентированная техника (также называемая шаблоном проектирования). Допустим, у вас есть объект x и нужно изменить поведение только одного из его методов. Можно создать новый класс, который предоставляет новую реализацию интересующего метода и делегирует все остальные методы соответствующему методу объекта x.

Программисты на Python могут легко реализовать делегирование. Например, следующий класс реализует класс, который ведёт себя как файл, но преобразует все записываемые данные в верхний регистр:

class UpperOut:

    def __init__(self, outfile):
        self._outfile = outfile

    def write(self, s):
        self._outfile.write(s.upper())

    def __getattr__(self, name):
        return getattr(self._outfile, name)

Here the UpperOut class redefines the write() method to convert the argument string to uppercase before calling the underlying self.__outfile.write() method. All other methods are delegated to the underlying self.__outfile object. The delegation is accomplished via the __getattr__ method; consult the language reference for more information about controlling attribute access.

Обратите внимание, что в более общих случаях делегирование может усложниться. Если атрибуты нужно не только получать, но и устанавливать, класс должен также определить метод __setattr__(), и делать это нужно аккуратно. Базовая реализация __setattr__() примерно эквивалентна следующему:

class X:
    ...
    def __setattr__(self, name, value):
        self.__dict__[name] = value
    ...

Большинство реализаций __setattr__() должны изменять self.__dict__ для хранения локального состояния для self, чтобы избежать бесконечной рекурсии.

Как вызвать метод, определённый в базовом классе, из производного класса, который его переопределяет?¶How do I call a method defined in a base class from a derived class that overrides it?

Используйте встроенную функцию super():

class Derived(Base):
    def meth(self):
        super(Derived, self).meth()

Для версий до 3.0 могут использоваться классические классы: для определения класса, например class Derived(Base): ..., можно вызвать метод meth(), определённый в Base (или в одном из базовых классов Base), как Base.meth(self, arguments...). Здесь Base.meth – это непривязанный метод, поэтому нужно передать аргумент self.

Как организовать код, чтобы было проще изменить базовый класс?¶How can I organize my code to make it easier to change the base class?

Можно определить псевдоним для базового класса, присвоить ему реальный базовый класс до определения вашего класса и использовать псевдоним во всём классе. Тогда всё, что нужно изменить – это значение, присвоенное псевдониму. Кстати, этот трюк также удобен, если вы хотите динамически (например, в зависимости от доступности ресурсов) выбирать, какой базовый класс использовать. Пример:

BaseAlias = <real base class>

class Derived(BaseAlias):
    def meth(self):
        BaseAlias.meth(self)
        ...

Как создать статические данные класса и статические методы класса?¶How do I create static class data and static class methods?

В Python поддерживаются как статические данные, так и статические методы (в смысле C++ или Java).

Для статических данных просто определите атрибут класса. Чтобы присвоить атрибуту новое значение, необходимо явно указать имя класса в присваивании:

class C:
    count = 0   # количество вызовов C.__init__

    def __init__(self):
        C.count = C.count + 1

    def getcount(self):
        return C.count  # или вернуть self.count

c.count также ссылается на C.count для любого c, для которого isinstance(c, C) истинно, если только оно не переопределено самим c или каким-либо классом на пути поиска базового класса от c.__class__ до C.

Внимание: внутри метода C присваивание вида self.count = 42 создаёт новый и не связанный экземпляр с именем «count» в собственном словаре self. Повторное связывание имени статических данных класса всегда должно указывать класс, как внутри метода, так и вне его:

C.count = 314

Статические методы возможны:

class C:
    @staticmethod
    def static(arg1, arg2, arg3):
        # Нет параметра 'self'!
        ...

Однако гораздо более прямолинейный способ получить эффект статического метода – это простая функция уровня модуля:

def getcount():
    return C.count

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

Как перегрузить конструкторы (или методы) в Python?¶How can I overload constructors (or methods) in Python?

Этот ответ на самом деле применим ко всем методам, но вопрос обычно возникает в первую очередь в контексте конструкторов.

В C++ вы бы написали

class C {
    C() { cout << "No arguments\n"; }
    C(int i) { cout << "Argument is " << i << "\n"; }
}

В Python нужно написать один конструктор, который обрабатывает все случаи с помощью аргументов по умолчанию. Например:

class C:
    def __init__(self, i=None):
        if i is None:
            print("No arguments")
        else:
            print("Argument is", i)

Это не полностью эквивалентно, но на практике достаточно близко.

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

def __init__(self, *args):
    ...

Тот же подход работает для всех определений методов.

Я пытаюсь использовать __spam и получаю ошибку про _SomeClassName__spam.¶I try to use __spam and I get an error about _SomeClassName__spam.

Имена переменных с двойным подчёркиванием в начале «искажаются» – это простой, но эффективный способ определения приватных переменных класса. Любой идентификатор вида __spam (не менее двух начальных подчёркиваний и не более одного конечного) текстуально заменяется на _classname__spam, где classname – это имя текущего класса без начальных подчёркиваний.

Это не гарантирует приватности: внешний пользователь все еще может намеренно получить доступ к атрибуту «_classname__spam», а приватные значения видны в __dict__ объекта. Многие программисты на Python вообще не утруждают себя использованием имен приватных переменных.

Мой класс определяет __del__, но он не вызывается, когда я удаляю объект.¶My class defines __del__ but it is not called when I delete the object.

Для этого есть несколько возможных причин.

Оператор del не обязательно вызывает __del__() – он просто уменьшает счётчик ссылок объекта, и если он достигает нуля, вызывается __del__().

Если ваши структуры данных содержат циклические ссылки (например, дерево, где каждый потомок имеет ссылку на родителя, а каждый родитель – список потомков), счётчики ссылок никогда не обнулятся. Время от времени Python запускает алгоритм для обнаружения таких циклов, но сборщик мусора может запуститься спустя некоторое время после того, как последняя ссылка на вашу структуру данных исчезнет, так что метод __del__() может быть вызван в неудобный и случайный момент. Это неудобно, если вы пытаетесь воспроизвести проблему. Хуже того, порядок вызова методов __del__() объектов произволен. Можно запустить gc.collect() для принудительной сборки, но существуют патологические случаи, когда объекты никогда не будут собраны.

Несмотря на сборщик циклов, всё равно рекомендуется определить явный метод close() для объектов, который будет вызываться, когда они больше не нужны. Метод close() может затем удалить атрибуты, ссылающиеся на подобъекты. Не вызывайте __del__() напрямую – __del__() должен вызывать close(), а close() должен гарантировать, что его можно вызвать более одного раза для одного и того же объекта.

Другой способ избежать циклических ссылок – использовать модуль weakref, который позволяет указывать на объекты без увеличения их счётчика ссылок. Например, структуры данных деревьев должны использовать слабые ссылки для ссылок на родительские и дочерние элементы (если они нужны!).

Наконец, если метод __del__() вызывает исключение, предупреждение выводится в sys.stderr.

Как получить список всех экземпляров данного класса?¶How do I get a list of all instances of a given class?

Python не отслеживает все экземпляры класса (или встроенного типа). Можно запрограммировать конструктор класса так, чтобы он отслеживал все экземпляры, сохраняя список слабых ссылок на каждый экземпляр.

Почему результат id() кажется неуникальным?¶Why does the result of id() appear to be not unique?

Встроенная функция id() возвращает целое число, которое гарантированно уникально в течение времени жизни объекта. Поскольку в CPython это адрес памяти объекта, часто бывает, что после удаления объекта из памяти следующий свежесозданный объект выделяется по тому же адресу. Это показано на следующем примере:

>>> id(1000) 
13901272
>>> id(2000) 
13901272

Два идентификатора принадлежат разным целочисленным объектам, которые создаются до и сразу же удаляются после выполнения вызова id(). Чтобы убедиться, что объекты, чей id нужно проверить, всё ещё живы, создайте ещё одну ссылку на объект:

>>> a = 1000; b = 2000
>>> id(a) 
13901272
>>> id(b) 
13891296

Как создать .pyc-файл?¶How do I create a .pyc file?

Когда модуль импортируется впервые (или когда исходный файл изменился после создания текущего скомпилированного файла), в подкаталоге __pycache__ каталога, содержащего файл .py, должен быть создан файл .pyc со скомпилированным кодом. Файл .pyc будет иметь имя, начинающееся с того же имени, что и файл .py, и заканчивающееся на .pyc, со средней частью, зависящей от конкретной двоичной сборки python, которая его создала. (Подробнее см. PEP 3147.)

Одна из причин, по которой файл .pyc может не создаваться, – проблема с правами доступа к каталогу, содержащему исходный файл: подкаталог __pycache__ не может быть создан. Это может произойти, например, если вы разрабатываете от одного пользователя, а запускаете от другого, например, при тестировании с помощью веб-сервера.

Если не установлена переменная окружения PYTHONDONTWRITEBYTECODE, создание файла .pyc происходит автоматически при импорте модуля, если Python имеет возможность (права, свободное место и т.д.) создать подкаталог __pycache__ и записать в него скомпилированный модуль.

Запуск Python на скрипте верхнего уровня не считается импортом, и .pyc не будет создан. Например, если есть модуль верхнего уровня foo.py, который импортирует другой модуль xyz.py, при запуске foo (путём ввода python foo.py как команды оболочки) будет создан .pyc для xyz, потому что xyz импортируется, но файл .pyc не будет создан для foo, поскольку foo.py не импортируется.

Если нужно создать файл .pyc для foo, то есть создать файл .pyc для модуля, который не импортируется, это можно сделать с помощью модулей py_compile и compileall.

Модуль py_compile может вручную скомпилировать любой модуль. Один из способов – интерактивно использовать функцию compile() в этом модуле:

>>> import py_compile
>>> py_compile.compile('foo.py')                 

Это запишет .pyc в подкаталог __pycache__ в том же месте, что и foo.py (или это можно переопределить необязательным параметром cfile).

Также можно автоматически скомпилировать все файлы в каталоге или каталогах с помощью модуля compileall. Для этого из командной оболочки выполните compileall.py и укажите путь к каталогу, содержащему файлы Python для компиляции:

python -m compileall .

Как узнать имя текущего модуля?¶How do I find the current module name?

Модуль может узнать своё собственное имя, обратившись к предопределённой глобальной переменной __name__. Если она равна '__main__', программа выполняется как скрипт. Многие модули, которые обычно используются через импорт, также предоставляют интерфейс командной строки или самопроверку и выполняют этот код только после проверки __name__:

def main():
    print('Running test...')
    ...

if __name__ == '__main__':
    main()

Как сделать модули, которые импортируют друг друга?¶How can I have modules that mutually import each other?

Предположим, у вас есть следующие модули:

foo.py:

from bar import bar_var
foo_var = 1

bar.py:

from foo import foo_var
bar_var = 2

Проблема в том, что интерпретатор выполнит следующие шаги:

• main импортирует foo

• Создаются пустые глобальные переменные для foo

• foo компилируется и начинает выполняться

• foo импортирует bar

• Создаются пустые глобальные переменные для bar

• bar компилируется и начинает выполняться

• bar импортирует foo (это пустая операция, так как модуль с именем foo уже существует)

• bar.foo_var = foo.foo_var

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

То же самое происходит при использовании import foo и последующей попытке обратиться к foo.foo_var в глобальном коде.

Существует (как минимум) три возможных обходных решения этой проблемы.

Гвидо ван Россум рекомендует избегать любых использований from <module> import ... и размещать весь код внутри функций. Инициализация глобальных переменных и переменных класса должна использовать только константы или встроенные функции. Это означает, что всё из импортированного модуля должно ссылаться как <module>.<name>.

Джим Роскинд предлагает выполнять шаги в следующем порядке в каждом модуле:

• экспорт (глобальные переменные, функции и классы, которым не нужны импортированные базовые классы)

• инструкции import

• активный код (включая глобальные переменные, инициализируемые из импортированных значений).

ван Россуму такой подход не очень нравится, потому что импорты оказываются в странном месте, но это работает.

Маттиас Урлихс рекомендует перестроить код так, чтобы рекурсивный импорт вообще не требовался.

Эти решения не являются взаимоисключающими.

__import__(‘x.y.z’) возвращает <module ‘x’>; как получить z?¶__import__(‘x.y.z’) returns <module ‘x’>; how do I get z?

Рассмотрите возможность использования удобной функции import_module() из importlib вместо этого.

z = importlib.import_module('x.y.z')

Когда я редактирую импортированный модуль и повторно импортирую его, изменения не отображаются. Почему это происходит?¶When I edit an imported module and reimport it, the changes don’t show up. Why does this happen?

Из соображений эффективности и согласованности Python читает файл модуля только при первом импорте модуля. Если бы это было не так, в программе, состоящей из многих модулей, каждый из которых импортирует один и тот же базовый модуль, этот базовый модуль разбирался бы и переразбирался много раз. Чтобы принудительно перечитать изменённый модуль, сделайте следующее:

import importlib
import modname
importlib.reload(modname)

Предупреждение: этот метод не является абсолютно надёжным. В частности, модули, содержащие операторы типа

from modname import some_objects

будут продолжать работать со старой версией импортированных объектов. Если модуль содержит определения классов, существующие экземпляры классов не будут обновлены для использования нового определения класса. Это может привести к следующему парадоксальному поведению:

>>> import importlib
>>> import cls
>>> c = cls.C()                # Создать экземпляр C
>>> importlib.reload(cls)
<module 'cls' from 'cls.py'>
>>> isinstance(c, cls.C)       # isinstance ложно?!?
False

Суть проблемы становится ясна, если вывести «идентичность» объектов классов:

>>> hex(id(c.__class__))
'0x7352a0'
>>> hex(id(cls.C))
'0x4198d0'