Стандартная библиотека 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
  • Типы менеджеров контекста
  • Типы аннотаций типов — Обобщённый псевдоним, Объединение
  • Другие встроенные типы
  • Специальные атрибуты
  • Ограничение длины при преобразовании целого числа в строку
• Встроенные исключения
  • Контекст исключения
  • Наследование от встроенных исключений
  • Базовые классы
  • Конкретные исключения
  • Предупреждения
  • Группы исключений
  • Иерархия исключений
• Гарантии потокобезопасности
  • Уровни потокобезопасности
  • Потокобезопасность объектов list
  • Потокобезопасность объектов dict
  • Потокобезопасность объектов set
  • Потокобезопасность объектов bytearray
  • Потокобезопасность объектов memoryview
• Службы обработки текста
  • string — распространённые операции со строками
  • string.templatelib — поддержка строковых литералов-шаблонов
  • 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 — распространённые операции с путями
  • 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
• Сжатие и архивирование данных
  • Пакет compression
  • compression.zstd — сжатие, совместимое с форматом Zstandard
  • 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 — доступ к времени и его преобразование
  • logging — средство ведения журнала для Python
  • logging.config — настройка ведения журнала
  • logging.handlers — обработчики журнала
  • platform — доступ к идентификационным данным базовой платформы
  • errno — стандартные системные символы errno
  • ctypes — библиотека внешних функций для Python
• Библиотеки интерфейса командной строки
  • argparse — анализатор параметров, аргументов и подкоманд командной строки
  • optparse — анализатор параметров командной строки
  • getpass — переносимый ввод пароля
  • fileinput — перебор строк из нескольких входных потоков
  • curses — управление терминалом для символьных дисплеев
  • curses.textpad — виджет ввода текста для программ curses
  • curses.ascii — утилиты для символов ASCII
  • curses.panel — расширение со стеком панелей для curses
  • cmd — поддержка построчных интерпретаторов команд
• Параллельное выполнение
  • threading — параллелизм на основе потоков
  • multiprocessing — параллелизм на основе процессов
  • multiprocessing.shared_memory — общая память для прямого доступа из разных процессов
  • Пакет concurrent
  • concurrent.futures — запуск параллельных задач
  • concurrent.interpreters — несколько интерпретаторов в одном процессе
  • 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.parser — простой анализатор HTML и XHTML
  • html.entities — определения общих сущностей HTML
  • Модули обработки XML
  • xml.etree.ElementTree — API ElementTree для XML
  • xml.dom — API объектной модели документа
  • 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 9562
  • 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 — службы интернационализации
• Графические пользовательские интерфейсы с Tk
  • tkinter — интерфейс Python к Tcl/Tk
  • tkinter.colorchooser — диалог выбора цвета
  • tkinter.font — оболочка шрифтов Tkinter
  • Диалоговые окна Tkinter
  • tkinter.messagebox — диалоговые окна сообщений Tkinter
  • tkinter.scrolledtext — текстовый виджет с полосами прокрутки
  • tkinter.dnd — поддержка перетаскивания
  • tkinter.ttk — тематические виджеты Tk
  • IDLE — редактор и оболочка Python
  • turtle — черепашья графика

• Средства разработки
  • typing — Поддержка аннотаций типов
  • pydoc — Генератор документации и система интерактивной справки
  • Режим разработки Python
  • doctest — Тестирование интерактивных примеров Python
  • unittest — Инфраструктура модульного тестирования
  • unittest.mock — Библиотека имитационных объектов
  • unittest.mock — краткое руководство
  • 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 — Инспектирование действующих объектов
  • annotationlib — Функции для интроспекции аннотаций
  • 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
  • shlex — Простой лексический анализ
  • posix — Наиболее распространённые системные вызовы POSIX
  • pwd — База данных паролей
  • grp — База данных групп
  • termios — Управление tty в стиле POSIX
  • tty — Функции управления терминалом
  • pty — Утилиты псевдотерминала
  • fcntl — Системные вызовы fcntl и ioctl
  • resource — Сведения об использовании ресурсов
  • syslog — Процедуры библиотеки syslog в Unix
• Интерфейс командной строки (CLI) модулей
• Устаревшие модули
  • getopt — Парсер параметров командной строки в стиле C
• Удалённые модули
• Вопросы безопасности