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

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

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

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

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

• Введение
  • Примечания о доступности
• Встроенные функции
• Встроенные константы
  • Константы, добавленные модулем site
• Встроенные типы
  • Проверка истинности
  • Логические операции — and, or, not
  • Сравнения
  • Числовые типы — int, float, complex
  • Булевый тип - bool
  • Типы итераторов
  • Последовательные типы — list, tuple, range
  • Последовательность текстовых типов — str
  • Последовательности бинарных типов — bytes, bytearray, memoryview
  • Типы множеств — set, frozenset
  • Типы отображений — dict
  • Типы менеджеров контекста
  • Типы аннотаций типов — Generic Alias, Union
  • Другие встроенные типы
  • Специальные атрибуты
  • Предельные длины преобразования целых чисел в строку
• Встроенные исключения
  • Контекст исключения
  • Наследование от встроенных исключений
  • Базовые классы
  • Конкретные исключения
  • Предупреждения
  • Группы исключений
  • Иерархия исключений
• Сервисы обработки текста
  • string — Общие операции со строками
  • re — Операции с регулярными выражениями
  • difflib — Помощники для вычисления различий
  • textwrap — Обёртывание и заполнение текста
  • unicodedata — База данных Юникода
  • 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 — Библиотека имитационных объектов
  • 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 — Отслеживание выделения памяти
• Упаковщик и распространение программного обеспечения
  • ensurepip — Запуск установщика pip
  • venv — Создание виртуальных сред
  • zipapp — Управление исполняемыми zip-архивами Python

• Службы выполнения Python
  • sys — Параметры и функции, специфичные для системы
  • sys.monitoring — Мониторинг событий выполнения
  • 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
  • audioop — Обработка необработанных аудиоданных
  • cgi — Поддержка Common Gateway Interface
  • cgitb — Менеджер трассировки для скриптов CGI
  • chunk — Чтение данных IFF с фрагментами
  • crypt — Функция проверки паролей Unix
  • imghdr — Определение типа изображения
  • mailcap — Обработка файлов mailcap
  • msilib — Чтение и запись файлов Microsoft Installer
  • nis — Интерфейс к NIS (Yellow Pages) Sun
  • nntplib — Клиент протокола NNTP
  • optparse — Парсер командной строки
  • ossaudiodev — Доступ к аудиоустройствам, совместимым с OSS
  • pipes — Интерфейс к конвейрам оболочки
  • sndhdr — Определение типа файла звука
  • spwd — База данных паролей shadow
  • sunau — Чтение и запись файлов Sun AU
  • telnetlib — Клиент Telnet
  • uu — Кодирование и декодирование файлов uuencode
  • xdrlib — Кодирование и декодирование данных XDR
• Рекомендации по безопасности