Python

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

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

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

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

• 1. Введение
• 2. Встроенные функции
• 3. Встроенные константы
  • 3.1. Константы, добавленные модулем site
• 4. Встроенные типы
  • 4.1. Проверка истинности
  • 4.2. Булевы операции — and, or, not
  • 4.3. Сравнения
  • 4.4. Числовые типы — int, float, complex
  • 4.5. Типы итераторов
  • 4.6. Последовательные типы — list, tuple, range
  • 4.7. Последовательный тип текста — str
  • 4.8. Последовательные типы бинарных данных — bytes, bytearray, memoryview
  • 4.9. Типы множеств — set, frozenset
  • 4.10. Типы словарей — dict
  • 4.11. Типы менеджеров контекста
  • 4.12. Другие встроенные типы
  • 4.13. Специальные атрибуты
• 5. Встроенные исключения
  • 5.1. Базовые классы
  • 5.2. Конкретные исключения
  • 5.3. Предупреждения
  • 5.4. Иерархия исключений
• 6. Службы обработки текста
  • 6.1. string — Общие операции со строками
  • 6.2. re — Операции с регулярными выражениями
  • 6.3. difflib — Сравнение различий
  • 6.4. textwrap — Обёртывание и заполнение текста
  • 6.5. unicodedata — База данных Юникода
  • 6.6. stringprep — Подготовка строк для интернета
  • 6.7. readline — Интерфейс GNU readline
  • 6.8. rlcompleter — Функция дополнения для GNU readline
• 7. Службы работы с бинарными данными
  • 7.1. struct — Интерпретация байтов как упакованных бинарных данных
  • 7.2. codecs — Реестр кодеков и базовые классы
• 8. Типы данных
  • 8.1. datetime — Основные типы дат и времени
  • 8.2. calendar — Общие функции, связанные с календарём
  • 8.3. collections — Контейнерные типы данных
  • 8.4. collections.abc — Абстрактные базовые классы для контейнеров
  • 8.5. heapq — Алгоритм очереди с приоритетами
  • 8.6. bisect — Алгоритм бисекции массивов
  • 8.7. array — Эффективные массивы числовых значений
  • 8.8. weakref — Слабые ссылки
  • 8.9. types — Динамическое создание типов и имена встроенных типов
  • 8.10. copy — Поверхностное и глубокое копирование
  • 8.11. pprint — Красивый вывод данных
  • 8.12. reprlib — Альтернативная реализация repr()
  • 8.13. enum — Поддержка перечислений
• 9. Модули числовой и математической обработки
  • 9.1. numbers — Числовые абстрактные базовые классы
  • 9.2. math — Математические функции
  • 9.3. cmath — Математические функции для комплексных чисел
  • 9.4. decimal — Десятичная фиксированная и плавающая точка арифметика
  • 9.5. fractions — Рациональные числа
  • 9.6. random — Генерация псевдослучайных чисел
  • 9.7. statistics — Функции математической статистики
• 10. Модули функционального программирования
  • 10.1. itertools — Функции создания итераторов для эффективного циклического прохода
  • 10.2. functools — Функции высшего порядка и операции над вызываемыми объектами
  • 10.3. operator — Стандартные операторы как функции
• 11. Доступ к файлам и каталогам
  • 11.1. pathlib — Объектно-ориентированные пути к файлам и каталогам
  • 11.2. os.path — Общие манипуляции с именами путей
  • 11.3. fileinput — Итерация по строкам из нескольких входных потоков
  • 11.4. stat — Интерпретация результатов stat()
  • 11.5. filecmp — Сравнение файлов и каталогов
  • 11.6. tempfile — Генерация временных файлов и каталогов
  • 11.7. glob — Расширение шаблонов имён путей в стиле Unix
  • 11.8. fnmatch — Сопоставление имён файлов по шаблонам Unix
  • 11.9. linecache — Случайный доступ к строкам текста
  • 11.10. shutil — Операции с файлами высокого уровня
  • 11.11. macpath — Функции манипуляции путями для Mac OS 9
• 12. Сохранение данных
  • 12.1. pickle — Сериализация объектов Python
  • 12.2. copyreg — Регистрация функций поддержки pickle
  • 12.3. shelve — Сохранение объектов Python
  • 12.4. marshal — Внутренняя сериализация объектов Python
  • 12.5. dbm — Интерфейсы к базам данных Unix
  • 12.6. sqlite3 — Интерфейс DB-API 2.0 для баз данных SQLite

• 13. Сжатие данных и архивирование
  • 13.1. zlib — Сжатие, совместимое с gzip
  • 13.2. gzip — Поддержка файлов gzip
  • 13.3. bz2 — Поддержка сжатия bzip2
  • 13.4. lzma — Сжатие с помощью алгоритма LZMA
  • 13.5. zipfile — Работа с архивами ZIP
  • 13.6. tarfile — Чтение и запись файлов архивов tar
• 14. Форматы файлов
  • 14.1. csv — Чтение и запись CSV-файлов
  • 14.2. configparser — Парсер конфигурационных файлов
  • 14.3. netrc — Обработка файлов netrc
  • 14.4. xdrlib — Кодирование и декодирование данных XDR
  • 14.5. plistlib — Генерация и парсинг файлов Mac OS X .plist
• 15. Криптографические сервисы
  • 15.1. hashlib — Безопасные хеши и дайджесты сообщений
  • 15.2. hmac — Ключевое хеширование для аутентификации сообщений
• 16. Общие сервисы операционной системы
  • 16.1. os — Разнообразные интерфейсы операционной системы
  • 16.2. io — Основные инструменты для работы со потоками
  • 16.3. time — Доступ к времени и преобразования
  • 16.4. argparse — Парсер для командно-строчных опций, аргументов и подкоманд
  • 16.5. getopt — Парсер командной строки в стиле C
  • 16.6. logging — Модуль ведения журналов Python
  • 16.7. logging.config — Настройка ведения журнала
  • 16.8. logging.handlers — Обработчики логов
  • 16.9. getpass — Переносимый ввод паролей
  • 16.10. curses — Обработка терминала для символьных дисплеев
  • 16.11. curses.textpad — Виджет ввода текста для программ curses
  • 16.12. curses.ascii — Инструменты для ASCII-символов
  • 16.13. curses.panel — Расширение панели для curses
  • 16.14. platform — Доступ к идентификационным данным платформы
  • 16.15. errno — Стандартные символы errno системы
  • 16.16. ctypes — Библиотека внешних функций для Python
• 17. Конкурентное выполнение
  • 17.1. threading — Параллелизм на основе потоков
  • 17.2. multiprocessing — Параллелизм на основе процессов
  • 17.3. Пакет concurrent
  • 17.4. concurrent.futures — Запуск параллельных задач
  • 17.5. subprocess — Управление дочерними процессами
  • 17.6. sched — Планировщик событий
  • 17.7. queue — Синхронизированный класс очереди
  • 17.8. dummy_threading — Замена модуля threading
  • 17.9. _thread — Низкоуровневый API потоков
  • 17.10. _dummy_thread — Замена модуля _thread
• 18. Взаимодействие между процессами и сети
  • 18.1. socket — Низкоуровневый сетевой интерфейс
  • 18.2. ssl — Обёртка TLS/SSL для объектов сокета
  • 18.3. select — Ожидание завершения ввода/вывода
  • 18.4. selectors — Высокоуровневое управление вводом/выводом
  • 18.5. asyncio — Асинхронный ввод/вывод, цикл событий, корутины и задачи
  • 18.6. asyncore — Асинхронный обработчик сокетов
  • 18.7. asynchat — Асинхронный обработчик команд/ответов сокета
  • 18.8. signal — Установка обработчиков асинхронных событий
  • 18.9. mmap — Поддержка файлов с отображением в памяти
• 19. Обработка данных интернета
  • 19.1. email — Пакет для обработки почты и MIME
  • 19.2. json — Кодировщик и декодировщик JSON
  • 19.3. mailcap — Обработка файлов mailcap
  • 19.4. mailbox — Работа с почтовыми ящиками в различных форматах
  • 19.5. mimetypes — Сопоставление имён файлов с типами MIME
  • 19.6. base64 — Кодировки данных Base16, Base32, Base64, Base85
  • 19.7. binhex — Кодирование и декодирование файлов binhex4
  • 19.8. binascii — Преобразование между двоичным и ASCII
  • 19.9. quopri — Кодирование и декодирование MIME данных с использованием quoted-printable
  • 19.10. uu — Кодирование и декодирование файлов uuencode
• 20. Инструменты для обработки структурированных разметки
  • 20.1. html — Поддержка HyperText Markup Language
  • 20.2. html.parser — Простой парсер HTML и XHTML
  • 20.3. html.entities — Определения общих сущностей HTML
  • 20.4. Модули для обработки XML
  • 20.5. xml.etree.ElementTree — API ElementTree для XML
  • 20.6. xml.dom — API Document Object Model
  • 20.7. xml.dom.minidom — Минимальная реализация DOM
  • 20.8. xml.dom.pulldom — Поддержка создания частичных деревьев DOM
  • 20.9. xml.sax — Поддержка парсеров SAX2
  • 20.10. xml.sax.handler — Базовые классы для обработчиков SAX
  • 20.11. xml.sax.saxutils — Утилиты SAX
  • 20.12. xml.sax.xmlreader — Интерфейс для парсеров XML
  • 20.13. xml.parsers.expat — Быстрый парсинг XML с использованием Expat

• 21. Протоколы и поддержка интернета
  • 21.1. webbrowser — Удобный контроллер веб-браузера
  • 21.2. cgi — Поддержка общего шлюза
  • 21.3. cgitb — Менеджер отслеживания для скриптов CGI
  • 21.4. wsgiref — Утилиты WSGI и реализация эталона
  • 21.5. urllib — Модули обработки URL
  • 21.6. urllib.request — Расширяемая библиотека для открытия URL-адресов
  • 21.7. urllib.response — Классы ответов, используемые urllib
  • 21.8. urllib.parse — Разбор URL на компоненты
  • 21.9. urllib.error — Классы исключений, генерируемые urllib.request
  • 21.10. urllib.robotparser — Парсер для robots.txt
  • 21.11. http — Модули HTTP
  • 21.12. http.client — Клиент протокола HTTP
  • 21.13. ftplib — Клиент протокола FTP
  • 21.14. poplib — Клиент протокола POP3
  • 21.15. imaplib — Клиент протокола IMAP4
  • 21.16. nntplib — Клиент протокола NNTP
  • 21.17. smtplib — Клиент протокола SMTP
  • 21.18. smtpd — Сервер SMTP
  • 21.19. telnetlib — Клиент Telnet
  • 21.20. uuid — Объекты UUID согласно RFC 4122
  • 21.21. socketserver — Фреймворк для сетевых серверов
  • 21.22. http.server — Серверы HTTP
  • 21.23. http.cookies — Управление состоянием HTTP
  • 21.24. http.cookiejar — Обработка файлов cookie для клиентов HTTP
  • 21.25. xmlrpc — Модули сервера и клиента XMLRPC
  • 21.26. xmlrpc.client — Доступ к клиенту XML-RPC
  • 21.27. xmlrpc.server — Базовые серверы XML-RPC
  • 21.28. ipaddress — Библиотека работы с IPv4/IPv6
• 22. Мультимедийные службы
  • 22.1. audioop — Обработка сырых аудиоданных
  • 22.2. aifc — Чтение и запись файлов AIFF и AIFC
  • 22.3. sunau — Чтение и запись файлов Sun AU
  • 22.4. wave — Чтение и запись WAV-файлов
  • 22.5. chunk — Чтение данных блоков IFF
  • 22.6. colorsys — Преобразования между цветовыми системами
  • 22.7. imghdr — Определение типа изображения
  • 22.8. sndhdr — Определение типа звукового файла
  • 22.9. ossaudiodev — Доступ к аудиоустройствам, совместимым с OSS
• 23. Локализация
  • 23.1. gettext — Многоязычные службы локализации
  • 23.2. locale — Сервисы локализации
• 24. Фреймворки программ
  • 24.1. turtle — Графика черепашки
  • 24.2. cmd — Поддержка командных интерпретаторов, ориентированных на строки
  • 24.3. shlex — Простая лексическая обработка
• 25. Графические пользовательские интерфейсы с Tk
  • 25.1. tkinter — Интерфейс Python к Tcl/Tk
  • 25.2. tkinter.ttk — Виджеты с темой Tk
  • 25.3. tkinter.tix — Расширенные виджеты для Tk
  • 25.4. tkinter.scrolledtext — Виджет «Скроллируемый текст»
  • 25.5. IDLE
  • 25.6. Другие пакеты графических пользовательских интерфейсов
• 26. Инструменты разработки
  • 26.1. typing — Поддержка типов
  • 26.2. pydoc — Генератор документации и система онлайн-помощи
  • 26.3. doctest — Тестирование интерактивных примеров Python
  • 26.4. unittest — Фреймворк для модульных тестов
  • 26.5. unittest.mock — Библиотека объектов mock
  • 26.6. unittest.mock — Начало работы
  • 26.7. 2to3 — Автоматическое преобразование кода Python 2 в 3
  • 26.8. test — Пакет регрессионных тестов для Python
  • 26.9. test.support — Утилиты для набора тестов Python
• 27. Отладка и профилирование
  • 27.1. bdb — Фреймворк отладчика
  • 27.2. faulthandler — Вывод трассировки Python
  • 27.3. pdb — Отладчик Python
  • 27.4. Профилировщики Python
  • 27.5. timeit — Измерение времени выполнения небольших фрагментов кода
  • 27.6. trace — Трассировка или отслеживание выполнения команд Python
  • 27.7. tracemalloc — Трассировка выделения памяти
• 28. Упаковка и распространение программного обеспечения
  • 28.1. distutils — Создание и установка модулей Python
  • 28.2. ensurepip — Настройка установщика pip
  • 28.3. venv — Создание виртуальных сред
  • 28.4. zipapp — Управление исполняемыми архивами zip для Python

• 29. Служебные программы среды выполнения Python
  • 29.1. sys — Параметры и функции, зависящие от системы
  • 29.2. sysconfig — Предоставление доступа к конфигурационной информации Python
  • 29.3. builtins — Встроенные объекты
  • 29.4. __main__ — Среда скрипта верхнего уровня
  • 29.5. warnings — Управление предупреждениями
  • 29.6. contextlib — Утилиты для контекстов операторов with
  • 29.7. abc — Абстрактные базовые классы
  • 29.8. atexit — Обработчики завершения работы
  • 29.9. traceback — Вывод или получение стека отладки
  • 29.10. __future__ — Определения операторов будущего
  • 29.11. gc — Интерфейс сборщика мусора
  • 29.12. inspect — Проверка живых объектов
  • 29.13. site — Обработчик конфигурации, специфичный для сайта
  • 29.14. fpectl — Управление исключениями при работе с плавающей точкой
• 30. Пользовательские интерпретаторы Python
  • 30.1. code — Базовые классы интерпретатора
  • 30.2. codeop — Компиляция кода Python
• 31. Импорт модулей
  • 31.1. zipimport — Импорт модулей из архивов Zip
  • 31.2. pkgutil — Утилита расширения пакетов
  • 31.3. modulefinder — Поиск модулей, используемых скриптом
  • 31.4. runpy — Поиск и выполнение модулей Python
  • 31.5. importlib — Реализация import
• 32. Служебные программы языка Python
  • 32.1. parser — Доступ к дереву разбора Python
  • 32.2. ast — Деревья абстрактного синтаксиса
  • 32.3. symtable — Доступ к таблицам символов компилятора
  • 32.4. symbol — Константы, используемые с деревьями разбора Python
  • 32.5. token — Константы, используемые с деревьями разбора Python
  • 32.6. keyword — Проверка на ключевые слова Python
  • 32.7. tokenize — Токенизатор исходного кода Python
  • 32.8. tabnanny — Обнаружение неоднозначного отступа
  • 32.9. pyclbr — Поддержка браузера классов Python
  • 32.10. py_compile — Компиляция исходных файлов Python
  • 32.11. compileall — Байткодовая компиляция библиотек Python
  • 32.12. dis — Дизassembler байткода Python
  • 32.13. pickletools — Инструменты для разработчиков pickle
• 33. Разные сервисы
  • 33.1. formatter — Универсальное форматирование вывода
• 34. Сервисы, специфичные для MS Windows
  • 34.1. msilib — Чтение и запись файлов установщиков Microsoft Installer
  • 34.2. msvcrt — Полезные функции из среды выполнения MS VC++
  • 34.3. winreg — Доступ к системному реестру Windows
  • 34.4. winsound — Интерфейс воспроизведения звука для Windows
• 35. Сервисы, специфичные для Unix
  • 35.1. posix — Наиболее распространённые вызовы POSIX системы
  • 35.2. pwd — База данных паролей
  • 35.3. spwd — База данных shadow-паролей
  • 35.4. grp — База данных групп
  • 35.5. crypt — Функция проверки паролей Unix
  • 35.6. termios — Управление терминалом в стиле POSIX
  • 35.7. tty — Функции управления терминалом
  • 35.8. pty — Утилиты для псевдотерминалов
  • 35.9. fcntl — Вызовы системы fcntl и ioctl
  • 35.10. pipes — Интерфейс к конвейерам оболочки
  • 35.11. resource — Информация об использовании ресурсов
  • 35.12. nis — Интерфейс к NIS (Yellow Pages) Sun
  • 35.13. syslog — Функции библиотеки syslog Unix
• 36. Модули, которые больше не поддерживаются
  • 36.1. optparse — Парсер командной строки
  • 36.2. imp — Доступ к внутренностям import
• 37. Недокументированные модули
  • 37.1. Модули, специфичные для платформы