logging обеспечивает доступ к встроенной функциональности для логирования; • multiprocessing позволяет запускать несколько подпроцессов из программы, обеспечивая API, которое представляет их как потоки;
__init__(self, path):
self.path = path
рекомендую включать в документацию проекта следующую информацию: • проблему
Самый распространенный формат для документации Python — это reStructuredText, или, сокращенно, — reST. Это упрощенный язык разметки (как Markdown), который легко читается и пишется людьми и машинами. Sphinx —
Например, при существенных изменениях основной номер версии изменится с 1 на 2. При добавлении нескольких новых функций в API изменится второй порядковый номер, например, с 2.2 на 2.3. Если изменения касаются только устранения ошибок, то номер версии изменится с 2.2.0 на 2.2.1
пригодиться: • atexit регистрирует функцию, которая будет вызываться при завершении программы; • argparse обеспечивает функции для парсинга аргументов командной строки; • bisect предоставляет алгоритмы деления пополам для сортировки списков (глава 10); • calendar предоставляет функции для работы с датами
import warnings
class Car(object): def turn_left(self): """Поворот машины налево.
❶ .. deprecated:: 1.1 Используйте :func:`turn` вместо этого, с аргументом left (влево) """ ❷ warnings.warn("turn_left больше не используется; используйте вместо этого функцию turn с аргументом left (влево)", DeprecationWarning) self.turn(direction='left')
def turn(self, direction):
списки, с целью обработки их содержимого, объединяют разными способами, вместо того чтобы использовать itertools.chain().
Еще одна интересная структура данных — ChainMap, которая позволяет создать удобное расширяемое пространство имен
Есть полезные структуры данных в модуле collections, которые не используются так часто, как могли бы. Мне нравится использовать namedtuple6
