Стандартная библиотека Python

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

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

Инсталляторы Python для платформы Windows обычно включают всю стандартную библиотеку и часто также включают множество дополнительных компонентов. Для операционных систем семейства Unix Python обычно поставляется как набор пакетов, поэтому может потребоваться использовать инструменты пакетирования, предоставляемые операционной системой, для получения некоторых или всех дополнительных компонентов.

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

• Введение
  • Примечания об доступности
• Встроенные функции
• Встроенные константы
  • Константы, добавленные модулем site
• Встроенные типы
  • Проверка истинности
  • Булевы операции — and, or, not
  • Сравнения
  • Числовые типы — int, float, complex
  • Типы итераторов
  • Последовательные типы — list, tuple, range
  • Последовательность текстовых символов — str
  • Последовательности бинарных данных — bytes, bytearray, memoryview
  • Типы множеств — set, frozenset
  • Типы отображений — dict
  • Типы контекстных менеджеров
  • Типы аннотаций типов — Generic Alias, Union
  • Другие встроенные типы
  • Специальные атрибуты
  • Предельная длина целых чисел при преобразовании из строки
• Встроенные исключения
  • Контекст исключения
  • Наследование от встроенных исключений
  • Базовые классы
  • Конкретные исключения
  • Предупреждения
  • Группы исключений
  • Иерархия исключений
• Службы обработки текста
  • string — Общие операции со строками
  • re — Операции с регулярными выражениями
  • difflib — Помощники для вычисления различий
  • textwrap — Обёртывание и заполнение текста
  • unicodedata — База данных Unicode
  • stringprep — Подготовка строк для интернета
  • readline — GNU интерфейс readline
  • rlcompleter — Функция дополнения для GNU readline
• Службы обработки двоичных данных
  • struct — Интерпретация байтов как упакованных двоичных данных
  • codecs — Реестр кодировок и базовые классы
• Типы данных
  • datetime — Основные типы дат и времени
  • zoneinfo — Поддержка часовых поясов IANA
  • calendar — Общие функции, связанные с календарем
  • collections — Типы контейнеров данных
  • collections.abc — Абстрактные базовые классы для контейнеров
  • heapq — Алгоритм очереди с приоритетом
  • bisect — Алгоритм бисекции массивов
  • array — Эффективные массивы числовых значений
  • weakref — Слабые ссылки
  • types — Динамическое создание типов и имена встроенных типов
  • copy — Операции поверхностного и глубокого копирования
  • pprint — Красивый вывод данных
  • reprlib — Альтернативная реализация repr()
  • enum — Поддержка перечислений
  • graphlib — Функциональность для работы со структурами, похожими на графы
• Модули чисел и математики
  • numbers — Числовые абстрактные базовые классы
  • math — Математические функции
  • cmath — Математические функции для комплексных чисел
  • decimal — Десятичная фиксированная точка и плавающая точка арифметика
  • fractions — Рациональные числа
  • random — Генерация псевдослучайных чисел
  • statistics — Математические функции статистики
• Модули функционального программирования
  • itertools — Функции, создающие итераторы для эффективного циклирования
  • functools — Функции высшего порядка и операции над вызываемыми объектами
  • operator — Стандартные операторы как функции
• Доступ к файлам и каталогам
  • pathlib — Объектно-ориентированные пути к файлам и каталогам
  • os.path — Общие манипуляции с именами путей
  • fileinput — Итерация по строкам из нескольких входных потоков
  • stat — Интерпретация результатов stat()
  • filecmp — Сравнение файлов и каталогов
  • tempfile — Генерация временных файлов и каталогов
  • glob — Расширение шаблонов имен путей в стиле Unix
  • fnmatch — Сопоставление шаблонов имен файлов в стиле Unix
  • linecache — Случайный доступ к строкам текста
  • shutil — Операции с файлами высокого уровня
• Сохранение данных
  • pickle — Сериализация объектов Python
  • copyreg — Регистрация функций поддержки pickle
  • shelve — Сохранение объектов Python
  • marshal — Внутренняя сериализация объектов Python
  • dbm — Интерфейсы к Unix «базам данных»
  • sqlite3 — Интерфейс DB-API 2.0 для баз данных SQLite

• Сжатие данных и архивирование
  • zlib — Сжатие, совместимое с gzip
  • gzip — Поддержка файлов gzip
  • bz2 — Поддержка сжатия bzip2
  • lzma — Сжатие с использованием алгоритма LZMA
  • zipfile — Работа с архивами ZIP
  • tarfile — Чтение и запись файлов архивов tar
• Форматы файлов
  • csv — Чтение и запись CSV-файлов
  • configparser — Парсер конфигурационных файлов
  • tomllib — Парсинг файлов TOML
  • netrc — Обработка файлов netrc
  • plistlib — Генерация и парсинг файлов Apple .plist
• Криптографические службы
  • hashlib — Безопасные хэши и дайджесты сообщений
  • hmac — Ключевое хеширование для аутентификации сообщений
  • secrets — Генерация безопасных случайных чисел для управления секретами
• Общие службы операционной системы
  • os — Разнообразные интерфейсы операционной системы
  • io — Основные инструменты для работы с потоками
  • time — Доступ к времени и преобразования
  • argparse — Парсер для командно-строковых опций, аргументов и подкоманд
  • getopt — Парсер командных строк в стиле C
  • logging — Модуль ведения журналов для Python
  • logging.config — Настройка ведения журналов
  • logging.handlers — Обработчики журналов
  • getpass — Переносимый ввод пароля
  • curses — Обработка терминала для дисплеев с символами
  • curses.textpad — Виджет ввода текста для программ curses
  • curses.ascii — Утилиты для ASCII-символов
  • curses.panel — Расширение стека панелей для curses
  • platform — Доступ к идентификационным данным базовой платформы
  • errno — Стандартные символы системы errno
  • ctypes — Библиотека внешних функций для Python
• Конкурентное выполнение
  • threading — Параллелизм на основе потоков
  • multiprocessing — Параллелизм на основе процессов
  • multiprocessing.shared_memory — Общая память для прямого доступа через процессы
  • Пакет concurrent
  • concurrent.futures — Запуск параллельных задач
  • subprocess — Управление подпроцессами
  • sched — Планировщик событий
  • queue — Синхронизированный класс очереди
  • contextvars — Переменные контекста
  • _thread — Низкоуровневый API потоков
• Сети и межпроцессное взаимодействие
  • asyncio — Асинхронный ввод-вывод
  • socket — Низкоуровневый сетевой интерфейс
  • ssl — Обёртка TLS/SSL для объектов сокетов
  • select — Ожидание завершения ввода-вывода
  • selectors — Высокоуровневый множественный ввод-вывод
  • signal — Установка обработчиков асинхронных событий
  • mmap — Поддержка отображения файлов в памяти
• Обработка данных интернета
  • email — Пакет обработки электронной почты и MIME
  • json — Кодировщик и декодировщик JSON
  • mailbox — Работа с почтовыми ящиками в различных форматах
  • mimetypes — Сопоставление имён файлов с типами MIME
  • base64 — Кодировки данных Base16, Base32, Base64, Base85
  • binascii — Преобразование между двоичным и ASCII
  • quopri — Кодирование и декодирование MIME-данных с использованием quoted-printable
• Инструменты обработки структурированной разметки
  • html — Поддержка языка разметки гипертекста HTML
  • html.parser — Простой парсер HTML и XHTML
  • html.entities — Определения общих сущностей HTML
  • Модули обработки XML
  • xml.etree.ElementTree — API ElementTree для XML
  • xml.dom — API Document Object Model
  • xml.dom.minidom — Минимальная реализация DOM
  • xml.dom.pulldom — Поддержка построения частичных деревьев DOM
  • xml.sax — Поддержка парсеров SAX2
  • xml.sax.handler — Базовые классы для обработчиков SAX
  • xml.sax.saxutils — Утилиты SAX
  • xml.sax.xmlreader — Интерфейс для парсеров XML
  • xml.parsers.expat — Быстрый парсинг XML с использованием Expat

• Протоколы интернета и поддержка
  • webbrowser — Удобный контроллер веб-браузера
  • wsgiref — WSGI-утилиты и реализация справочника
  • urllib — Модули обработки URL
  • urllib.request — Расширяемая библиотека для открытия URL
  • urllib.response — Классы ответов, используемые urllib
  • urllib.parse — Разбор URL на составляющие
  • urllib.error — Классы исключений, поднимаемые urllib.request
  • urllib.robotparser — Парсер для robots.txt
  • http — Модули HTTP
  • http.client — Клиент протокола HTTP
  • ftplib — Клиент протокола FTP
  • poplib — Клиент протокола POP3
  • imaplib — Клиент протокола IMAP4
  • smtplib — Клиент протокола SMTP
  • uuid — Объекты UUID в соответствии с RFC 4122
  • socketserver — Фреймворк для сетевых серверов
  • http.server — HTTP-серверы
  • http.cookies — Управление состоянием HTTP
  • http.cookiejar — Обработка файлов cookie для HTTP-клиентов
  • xmlrpc — Модули XMLRPC-сервера и -клиента
  • xmlrpc.client — Доступ к XML-RPC-клиенту
  • xmlrpc.server — Базовые XML-RPC-серверы
  • ipaddress — Библиотека для работы с IPv4/IPv6
• Мультимедийные сервисы
  • wave — Чтение и запись WAV-файлов
  • colorsys — Преобразования между цветовыми системами
• Локализация
  • gettext — Многоязычные сервисы локализации
  • locale — Сервисы локализации
• Фреймворки программ
  • turtle — Графика черепахи
  • cmd — Поддержка интерпретаторов командной строки
  • shlex — Простая лексическая обработка
• Графические пользовательские интерфейсы с Tk
  • tkinter — Интерфейс Python к Tcl/Tk
  • tkinter.colorchooser — Диалог выбора цвета
  • tkinter.font — Обёртка шрифтов Tkinter
  • Диалоги Tkinter
  • tkinter.messagebox — Диалоговые окна сообщений Tkinter
  • tkinter.scrolledtext — Виджет скроллируемого текста
  • tkinter.dnd — Поддержка перетаскивания
  • tkinter.ttk — Тематические виджеты Tk
  • tkinter.tix — Дополнительные виджеты для Tk
  • IDLE
• Средства разработки
  • typing — Поддержка подсказок типов
  • pydoc — Генератор документации и система справки в сети
  • Режим разработки Python
  • doctest — Тестирование интерактивных примеров Python
  • unittest — Фреймворк для модульного тестирования
  • unittest.mock — Библиотека объектов mock
  • unittest.mock — начало работы
  • 2to3 — Автоматическое преобразование кода Python 2 в 3
  • test — Пакет регрессионных тестов для Python
  • test.support — Утилиты для набора тестов Python
  • test.support.socket_helper — Утилиты для тестов сокетов
  • test.support.script_helper — Утилиты для тестов выполнения Python
  • test.support.bytecode_helper — Инструменты поддержки для тестирования корректного генерирования байт-кода
  • test.support.threading_helper — Утилиты для тестов потоков
  • test.support.os_helper — Утилиты для тестов os
  • test.support.import_helper — Утилиты для тестов импорта
  • test.support.warnings_helper — Утилиты для тестов предупреждений
• Отладка и профилирование
  • Таблица событий аудита
  • bdb — Фреймворк отладчика
  • faulthandler — Вывод трассировки Python
  • pdb — Отладчик Python
  • Профилировщики Python
  • timeit — Измерение времени выполнения небольших фрагментов кода
  • trace — Отслеживание выполнения инструкций Python
  • tracemalloc — Отслеживание выделения памяти
• Упаковки и распространение программного обеспечения
  • distutils — Построение и установка модулей Python
  • ensurepip — Настройка установщика pip
  • venv — Создание виртуальных сред
  • zipapp — Управление исполняемыми zip-архивами Python

• Сервисы выполнения Python
  • sys — Параметры и функции, специфичные для системы
  • sysconfig — Предоставление доступа к конфигурационной информации Python
  • builtins — Встроенные объекты
  • __main__ — Среда кода верхнего уровня
  • warnings — Управление предупреждениями
  • dataclasses — Классы данных
  • contextlib — Утилиты для контекстов с операторами with
  • abc — Абстрактные базовые классы
  • atexit — Обработчики завершения
  • traceback — Вывод или получение трассировки стека
  • __future__ — Определения операторов будущего
  • gc — Интерфейс сборщика мусора
  • inspect — Инспекция живых объектов
  • site — Специфичный для сайта крючок конфигурации
• Пользовательские интерпретаторы Python
  • code — Базовые классы интерпретатора
  • codeop — Компиляция кода Python
• Импорт модулей
  • zipimport — Импорт модулей из архивов Zip
  • pkgutil — Утилита расширения пакетов
  • modulefinder — Поиск модулей, используемых скриптом
  • runpy — Поиск и выполнение модулей Python
  • importlib — Реализация import
  • importlib.resources — Чтение, открытие и доступ к ресурсам пакетов
  • importlib.resources.abc — Абстрактные базовые классы для ресурсов
  • importlib.metadata — Доступ к метаданным пакетов
  • Инициализация пути поиска модуля sys.path
• Сервисы языка Python
  • ast — Абстрактные синтаксические деревья
  • symtable — Доступ к таблицам символов компилятора
  • token — Константы, используемые с деревьями разбора Python
  • keyword — Проверка на наличие ключевых слов Python
  • tokenize — Токенизатор для исходного кода Python
  • tabnanny — Обнаружение неоднозначного отступа
  • pyclbr — Поддержка браузера модулей Python
  • py_compile — Компиляция файлов исходного кода Python
  • compileall — Байткодовая компиляция библиотек Python
  • dis — Дизссемблер для байткода Python
  • pickletools — Инструменты для разработчиков pickle
• Сервисы, специфичные для MS Windows
  • msvcrt — Полезные процедуры из среды выполнения MS VC++
  • winreg — Доступ к реестру Windows
  • winsound — Интерфейс воспроизведения звука для Windows
• Сервисы, специфичные для Unix
  • posix — Наиболее распространённые системные вызовы POSIX
  • pwd — База данных паролей
  • grp — База данных групп
  • termios — Управление терминалом в стиле POSIX
  • tty — Функции управления терминалом
  • pty — Утилиты псевдотерминалов
  • fcntl — Системные вызовы fcntl и ioctl
  • resource — Информация об использовании ресурсов
  • syslog — Процедуры библиотеки syslog Unix
• Командная строка модулей (CLI)
• Устаревшие модули
  • aifc — Чтение и запись файлов AIFF и AIFC
  • asynchat — Обработчик команд/ответов асинхронных сокетов
  • asyncore — Обработчик асинхронных сокетов
  • audioop — Манипулирование сырыми аудиоданными
  • cgi — Поддержка Common Gateway Interface
  • cgitb — Управляющий трассировкой для скриптов CGI
  • chunk — Чтение данных IFF с фрагментами
  • crypt — Функция проверки паролей Unix
  • imghdr — Определение типа изображения
  • imp — Доступ к внутренностям импорта
  • mailcap — Обработка файлов mailcap
  • msilib — Чтение и запись файлов установщиков Microsoft
  • nis — Интерфейс к NIS (Yellow Pages) Sun
  • nntplib — Клиент протокола NNTP
  • optparse — Парсер для опций командной строки
  • ossaudiodev — Доступ к устройствам аудио, совместимым с OSS
  • pipes — Интерфейс к конвейям оболочки
  • smtpd — SMTP-сервер
  • sndhdr — Определение типа файла звука
  • spwd — База данных паролей shadow
  • sunau — Чтение и запись файлов Sun AU
  • telnetlib — Клиент Telnet
  • uu — Кодирование и декодирование файлов uuencode
  • xdrlib — Кодирование и декодирование данных XDR
• Рекомендации по безопасности