Краткий обзор стандартной библиотеки

10.1. Интерфейс операционной системы

Модуль os предоставляет десятки функций для взаимодействия с операционной системой:

>>> import os
>>> os.getcwd()      # Return the current working directory
'C:\\Python314'
>>> os.chdir('/server/accesslogs')   # Change current working directory
>>> os.system('mkdir today')   # Run the command mkdir in the system shell
0

Обязательно используйте стиль import os вместо from os import *. Это позволит избежать ситуации, когда os.open() затеняет встроенную функцию open(), которая работает совершенно иначе.

Встроенные функции dir() и help() полезны как интерактивные помощники при работе с большими модулями, такими как os:

>>> import os
>>> dir(os)
<returns a list of all module functions>
>>> help(os)
<returns an extensive manual page created from the module's docstrings>

Для повседневных задач по управлению файлами и каталогами модуль shutil предоставляет более высокоуровневый и удобный интерфейс:

>>> import shutil
>>> shutil.copyfile('data.db', 'archive.db')
'archive.db'
>>> shutil.move('/build/executables', 'installdir')
'installdir'

10.2. Шаблоны подстановки для файлов

Модуль glob предоставляет функцию для составления списков файлов по шаблонам подстановки в каталогах:

>>> import glob
>>> glob.glob('*.py')
['primes.py', 'random.py', 'quote.py']

10.3. Аргументы командной строки

Для обработки аргументов командной строки часто нужны обычные служебные скрипты. Эти аргументы хранятся в атрибуте argv модуля sys в виде списка. Например, возьмём следующий файл demo.py:

# File demo.py
import sys
print(sys.argv)

Вот результат запуска python demo.py one two three из командной строки:

['demo.py', 'one', 'two', 'three']

Модуль argparse предоставляет более совершенный механизм обработки аргументов командной строки. Следующий скрипт извлекает одно или несколько имён файлов и необязательное количество строк для отображения:

import argparse

parser = argparse.ArgumentParser(
    prog='top',
    description='Show top lines from each file')
parser.add_argument('filenames', nargs='+')
parser.add_argument('-l', '--lines', type=int, default=10)
args = parser.parse_args()
print(args)

При запуске из командной строки с python top.py --lines=5 alpha.txt beta.txt скрипт присваивает args.lines значение 5, а args.filenames — значение ['alpha.txt', 'beta.txt'].

10.4. Перенаправление вывода ошибок и завершение программы

В модуле sys также есть атрибуты stdin, stdout и stderr. Последний полезен для вывода предупреждений и сообщений об ошибках, чтобы они оставались видимыми даже при перенаправлении stdout:

>>> sys.stderr.write('Warning, log file not found starting a new one\n')
Warning, log file not found starting a new one

Самый простой способ завершить скрипт — использовать sys.exit().

10.5. Поиск по шаблону в строках

Модуль re предоставляет инструменты для работы с регулярными выражениями, предназначенные для расширенной обработки строк. Для сложного поиска и преобразования регулярные выражения позволяют создавать лаконичные и оптимизированные решения:

>>> import re
>>> re.findall(r'\bf[a-z]*', 'which foot or hand fell fastest')
['foot', 'fell', 'fastest']
>>> re.sub(r'(\b[a-z]+) \1', r'\1', 'cat in the the hat')
'cat in the hat'

Если нужны только простые возможности, предпочтительнее использовать строковые методы: их проще читать и отлаживать:

>>> 'tea for too'.replace('too', 'two')
'tea for two'

10.6. Математика

Модуль math предоставляет доступ к функциям нижележащей библиотеки C для вычислений с числами с плавающей точкой:

>>> import math
>>> math.cos(math.pi / 4)
0.70710678118654757
>>> math.log(1024, 2)
10.0

Модуль random предоставляет инструменты для случайного выбора:

>>> import random
>>> random.choice(['apple', 'pear', 'banana'])
'apple'
>>> random.sample(range(100), 10)   # sampling without replacement
[30, 83, 16, 4, 8, 81, 41, 50, 18, 33]
>>> random.random()    # random float from the interval [0.0, 1.0)
0.17970987693706186
>>> random.randrange(6)    # random integer chosen from range(6)
4

Модуль statistics вычисляет основные статистические характеристики числовых данных (среднее значение, медиану, дисперсию и т. д.):

>>> import statistics
>>> data = [2.75, 1.75, 1.25, 0.25, 0.5, 1.25, 3.5]
>>> statistics.mean(data)
1.6071428571428572
>>> statistics.median(data)
1.25
>>> statistics.variance(data)
1.3720238095238095

В проекте SciPy <https://scipy.org> есть множество других модулей для численных вычислений.

10.7. Доступ к Интернету

Существует ряд модулей для доступа к Интернету и работы с интернет-протоколами. Два самых простых из них — urllib.request для получения данных по URL-адресам и smtplib для отправки почты:

>>> from urllib.request import urlopen
>>> with urlopen('https://docs.python.org/3/') as response:
...     for line in response:
...         line = line.decode()             # Convert bytes to a str
...         if 'updated' in line:
...             print(line.rstrip())         # Remove trailing newline
...
      Last updated on Nov 11, 2025 (20:11 UTC).

>>> import smtplib
>>> server = smtplib.SMTP('localhost')
>>> server.sendmail('soothsayer@example.org', 'jcaesar@example.org',
... """To: jcaesar@example.org
... From: soothsayer@example.org
...
... Beware the Ides of March.
... """)
>>> server.quit()

(Обратите внимание: для второго примера требуется запущенный почтовый сервер на localhost.)

10.8. Даты и время

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

>>> # dates are easily constructed and formatted
>>> import datetime as dt
>>> now = dt.date.today()
>>> now
datetime.date(2003, 12, 2)
>>> now.strftime("%m-%d-%y. %d %b %Y is a %A on the %d day of %B.")
'12-02-03. 02 Dec 2003 is a Tuesday on the 02 day of December.'

>>> # dates support calendar arithmetic
>>> birthday = dt.date(1964, 7, 31)
>>> age = now - birthday
>>> age.days
14368

10.9. Сжатие данных

Распространённые форматы архивирования и сжатия данных поддерживаются непосредственно такими модулями, как zlib, gzip, bz2, lzma, zipfile и tarfile.

>>> import zlib
>>> s = b'witch which has which witches wrist watch'
>>> len(s)
41
>>> t = zlib.compress(s)
>>> len(t)
37
>>> zlib.decompress(t)
b'witch which has which witches wrist watch'
>>> zlib.crc32(s)
226805979

10.10. Измерение производительности

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

Например, может возникнуть соблазн использовать упаковку и распаковку кортежей вместо традиционного способа обмена аргументами. Модуль timeit быстро демонстрирует небольшое преимущество в производительности:

>>> from timeit import Timer
>>> Timer('t=a; a=b; b=t', 'a=1; b=2').timeit()
0.57535828626024577
>>> Timer('a,b = b,a', 'a=1; b=2').timeit()
0.54962537085770791

В отличие от высокой точности модуля timeit, модули profile и pstats помогают выявлять критичные по времени участки в больших блоках кода.

10.11. Контроль качества

Один из способов разрабатывать высококачественное программное обеспечение — писать тесты для каждой функции по мере её создания и регулярно запускать их в ходе разработки.

Модуль doctest предоставляет инструмент для сканирования модуля и проверки тестов, встроенных в строки документации программы. Создать тест так же просто, как скопировать типичный вызов вместе с его результатом в строку документации. Это улучшает документацию, предоставляя пользователю пример, и позволяет модулю doctest проверять, что код по-прежнему соответствует документации:

def average(values):
    """Computes the arithmetic mean of a list of numbers.

    >>> print(average([20, 30, 70]))
    40.0
    """
    return sum(values) / len(values)

import doctest
doctest.testmod()   # automatically validate the embedded tests

Модуль unittest не так прост в использовании, как модуль doctest, зато он позволяет поддерживать более полный набор тестов в отдельном файле:

import unittest

class TestStatisticalFunctions(unittest.TestCase):

    def test_average(self):
        self.assertEqual(average([20, 30, 70]), 40.0)
        self.assertEqual(round(average([1, 5, 7]), 1), 4.3)
        with self.assertRaises(ZeroDivisionError):
            average([])
        with self.assertRaises(TypeError):
            average(20, 30, 70)

unittest.main()  # Calling from the command line invokes all tests

10.12. Всё необходимое уже включено

Python придерживается принципа «всё необходимое уже включено». Лучше всего это проявляется в широких возможностях и надёжности крупных пакетов. Например:

• Модули xmlrpc.client и xmlrpc.server делают реализацию удалённых вызовов процедур почти тривиальной задачей. Несмотря на названия модулей, для работы с ними не нужно напрямую знать XML или обрабатывать его.
• Пакет email предназначен для работы с сообщениями электронной почты, включая MIME и другие документы сообщений на основе RFC 5322. В отличие от smtplib и poplib, которые непосредственно отправляют и получают сообщения, пакет email предоставляет полный набор инструментов для создания и декодирования сложных структур сообщений (включая вложения), а также для реализации интернет-кодировок и протоколов заголовков.
• Пакет json обеспечивает надёжную поддержку разбора этого популярного формата обмена данными. Модуль csv поддерживает прямое чтение и запись файлов в формате CSV (значения, разделённые запятыми), который широко используется в базах данных и электронных таблицах. Обработка XML поддерживается пакетами xml.etree.ElementTree, xml.dom и xml.sax. Все эти модули и пакеты значительно упрощают обмен данными между приложениями Python и другими инструментами.
• Модуль sqlite3 — это обёртка для библиотеки баз данных SQLite, предоставляющая постоянную базу данных, которую можно обновлять и использовать с помощью немного нестандартного синтаксиса SQL.
• Интернационализация поддерживается рядом модулей, включая gettext, locale и пакет codecs.