pprint.md
1> **Источник:** https://python-all.ru/3.9/library/pprint.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# [`pprint`](https://python-all.ru/3.9/library/pprint.html#module-pprint) – форматированный вывод данных89**Исходный код:** [Lib/pprint.py](https://python-all.ru/src/3.9/Lib/pprint.py)1011---1213Модуль [`pprint`](https://python-all.ru/3.9/library/pprint.html#module-pprint) предоставляет возможность «форматированного вывода» произвольных структур данных Python в форме, которую можно использовать как входные данные для интерпретатора. Если отформатированные структуры содержат объекты, не являющиеся фундаментальными типами Python, представление может оказаться незагружаемым. Так бывает, если включены объекты вроде файлов, сокетов или классов, а также многие другие объекты, которые не представимы в виде литералов Python.1415Форматированное представление помещает объекты на одну строку, если возможно, и разбивает их на несколько строк, если они не помещаются в заданную ширину. Для изменения ограничения по ширине создавайте объекты [`PrettyPrinter`](https://python-all.ru/3.9/library/pprint.html#pprint.PrettyPrinter) явно.1617Перед выводом словари сортируются по ключам.1819Изменено в версии 3.9: Добавлена поддержка форматированного вывода [`types.SimpleNamespace`](https://python-all.ru/3.9/library/types.html#types.SimpleNamespace).2021Модуль [`pprint`](https://python-all.ru/3.9/library/pprint.html#module-pprint) определяет один класс:2223#### `class pprint.PrettyPrinter(indent=1, width=80, depth=None, stream=None, *, compact=False, sort_dicts=True)`2425Создаёт экземпляр [`PrettyPrinter`](https://python-all.ru/3.9/library/pprint.html#pprint.PrettyPrinter). Этот конструктор принимает несколько именованных параметров. Выходной поток можно задать с помощью ключевого слова *поток данных*; единственный метод, используемый для объекта потока – это метод `write()` протокола файлов. Если он не указан, [`PrettyPrinter`](https://python-all.ru/3.9/library/pprint.html#pprint.PrettyPrinter) использует `sys.stdout`. Величина отступа, добавляемого для каждого уровня рекурсии, задаётся параметром *indent*; по умолчанию он равен единице. Другие значения могут привести к тому, что вывод будет выглядеть немного странно, но могут сделать вложенность более заметной. Количество уровней, которые могут быть выведены, управляется параметром *depth*; если выводимая структура данных слишком глубока, следующий вложенный уровень заменяется на `...`. По умолчанию глубина форматируемых объектов не ограничена. Желаемая ширина вывода задаётся параметром *width*; по умолчанию 80 символов. Если структуру не удаётся отформатировать в заданную ширину, будет предпринята попытка сделать это наилучшим образом. Если *compact* равен false (по умолчанию), каждый элемент длинной последовательности будет выведен на отдельной строке. Если *compact* равен true, на каждой строке вывода будет помещено столько элементов, сколько помещается в *width*. Если *sort\_dicts* равен true (по умолчанию), словари будут форматироваться с сортировкой ключей, иначе они будут отображаться в порядке вставки.2627Изменено в версии 3.4: Добавлен параметр *compact*.2829Изменено в версии 3.8: добавлен параметр *sort\_dicts*.3031```python32>>> import pprint33>>> stuff = ['spam', 'eggs', 'lumberjack', 'knights', 'ni']34>>> stuff.insert(0, stuff[:])35>>> pp = pprint.PrettyPrinter(indent=4)36>>> pp.pprint(stuff)37[ ['spam', 'eggs', 'lumberjack', 'knights', 'ni'],38 'spam',39 'eggs',40 'lumberjack',41 'knights',42 'ni']43>>> pp = pprint.PrettyPrinter(width=41, compact=True)44>>> pp.pprint(stuff)45[['spam', 'eggs', 'lumberjack',46 'knights', 'ni'],47 'spam', 'eggs', 'lumberjack', 'knights',48 'ni']49>>> tup = ('spam', ('eggs', ('lumberjack', ('knights', ('ni', ('dead',50... ('parrot', ('fresh fruit',))))))))51>>> pp = pprint.PrettyPrinter(depth=6)52>>> pp.pprint(tup)53('spam', ('eggs', ('lumberjack', ('knights', ('ni', ('dead', (...)))))))54```5556Модуль [`pprint`](https://python-all.ru/3.9/library/pprint.html#module-pprint) также предоставляет несколько функций-сокращений:5758#### `pprint.pformat(object, indent=1, width=80, depth=None, *, compact=False, sort_dicts=True)`5960Возвращает отформатированное представление *object* в виде строки. Параметры *indent*, *width*, *depth*, *compact* и *sort\_dicts* будут переданы конструктору [`PrettyPrinter`](https://python-all.ru/3.9/library/pprint.html#pprint.PrettyPrinter) в качестве параметров форматирования.6162Изменено в версии 3.4: Добавлен параметр *compact*.6364Изменено в версии 3.8: добавлен параметр *sort\_dicts*.6566#### `pprint.pp(object, *args, sort_dicts=False, **kwargs)`6768Выводит форматированное представление объекта *object*, за которым следует новая строка. Если *sort\_dicts* равен False (по умолчанию), словари отображаются с ключами в порядке вставки, иначе ключи сортируются. *args* и *kwargs* передаются в [`pprint()`](https://python-all.ru/3.9/library/pprint.html#module-pprint) в качестве параметров форматирования.6970Новое в версии 3.8.7172#### `pprint.pprint(object, stream=None, indent=1, width=80, depth=None, *, compact=False, sort_dicts=True)`7374Выводит отформатированное представление *object* в поток *поток данных* с последующим символом новой строки. Если *поток данных* равен `None`, используется `sys.stdout`. Эту функцию можно использовать в интерактивном интерпретаторе вместо функции [`print()`](https://python-all.ru/3.9/library/functions.html#print) для просмотра значений (можно даже переназначить `print = pprint.pprint` для использования в области видимости). Параметры *indent*, *width*, *depth*, *compact* и *sort\_dicts* будут переданы конструктору [`PrettyPrinter`](https://python-all.ru/3.9/library/pprint.html#pprint.PrettyPrinter) в качестве параметров форматирования.7576Изменено в версии 3.4: Добавлен параметр *compact*.7778Изменено в версии 3.8: добавлен параметр *sort\_dicts*.7980```python81>>> import pprint82>>> stuff = ['spam', 'eggs', 'lumberjack', 'knights', 'ni']83>>> stuff.insert(0, stuff)84>>> pprint.pprint(stuff)85[<Recursion on list with id=...>,86 'spam',87 'eggs',88 'lumberjack',89 'knights',90 'ni']91```9293#### `pprint.isreadable(object)`9495Определяет, является ли форматированное представление *object* «читаемым» или может использоваться для восстановления значения с помощью [`eval()`](https://python-all.ru/3.9/library/functions.html#eval). Для рекурсивных объектов всегда возвращает `False`.9697```python98>>> pprint.isreadable(stuff)99False100```101102#### `pprint.isrecursive(object)`103104Определяет, требует ли объект *object* рекурсивного представления.105106Также определена ещё одна вспомогательная функция:107108#### `pprint.saferepr(object)`109110Возвращает строковое представление объекта *object*, защищённое от рекурсивных структур данных. Если представление *object* обнаруживает рекурсивную запись, рекурсивная ссылка будет представлена как `<Recursion on typename with id=number>`. В остальном представление не форматируется.111112```python113>>> pprint.saferepr(stuff)114"[<Recursion on list with id=...>, 'spam', 'eggs', 'lumberjack', 'knights', 'ni']"115```116117## Объекты PrettyPrinter118119Экземпляры [`PrettyPrinter`](https://python-all.ru/3.9/library/pprint.html#pprint.PrettyPrinter) имеют следующие методы:120121#### `PrettyPrinter.pformat(object)`122123Возвращает отформатированное представление *object*. Учитываются параметры, переданные конструктору [`PrettyPrinter`](https://python-all.ru/3.9/library/pprint.html#pprint.PrettyPrinter).124125#### `PrettyPrinter.pprint(object)`126127Выводит отформатированное представление *object* в настроенный поток, после чего добавляет новую строку.128129Следующие методы предоставляют реализации для соответствующих функций с теми же именами. Использование этих методов на экземпляре немного эффективнее, поскольку не нужно создавать новые объекты [`PrettyPrinter`](https://python-all.ru/3.9/library/pprint.html#pprint.PrettyPrinter).130131#### `PrettyPrinter.isreadable(object)`132133Определяет, является ли форматированное представление объекта «читаемым» или может быть использовано для восстановления значения с помощью [`eval()`](https://python-all.ru/3.9/library/functions.html#eval). Обратите внимание: для рекурсивных объектов возвращается `False`. Если установлен параметр *depth* в [`PrettyPrinter`](https://python-all.ru/3.9/library/pprint.html#pprint.PrettyPrinter) и объект глубже допустимого, возвращается `False`.134135#### `PrettyPrinter.isrecursive(object)`136137Определяет, требует ли объект рекурсивного представления.138139Этот метод предоставляется как хук, позволяющий подклассам изменять способ преобразования объектов в строки. Реализация по умолчанию использует внутренние механизмы реализации [`saferepr()`](https://python-all.ru/3.9/library/pprint.html#pprint.saferepr).140141#### `PrettyPrinter.format(object, context, maxlevels, level)`142143Возвращает три значения: форматированную версию *object* в виде строки, флаг, указывающий, является ли результат читаемым, и флаг, указывающий, была ли обнаружена рекурсия. Первый аргумент – отображаемый объект. Второй – словарь, содержащий [`id()`](https://python-all.ru/3.9/library/functions.html#id) объектов, которые являются частью текущего контекста представления (прямые и косвенные контейнеры для *object*, влияющие на представление) в качестве ключей; если необходимо отобразить объект, который уже представлен в *context*, третье возвращаемое значение должно быть `True`. Рекурсивные вызовы метода [`format()`](https://python-all.ru/3.9/library/pprint.html#pprint.PrettyPrinter.format) должны добавлять дополнительные записи для контейнеров в этот словарь. Третий аргумент, *maxlevels*, задаёт запрошенный лимит рекурсии; он будет равен `0`, если лимит не задан. Этот аргумент должен передаваться рекурсивным вызовам без изменений. Четвёртый аргумент, *level*, указывает текущий уровень; рекурсивные вызовы должны получать значение, меньшее текущего.144145## Пример146147Чтобы продемонстрировать несколько способов использования функции [`pprint()`](https://python-all.ru/3.9/library/pprint.html#module-pprint) и её параметров, получим информацию о проекте из [PyPI](https://python-all.ru/3.9/library/pprint.html):148149```python150>>> import json151>>> import pprint152>>> from urllib.request import urlopen153>>> with urlopen('https://pypi.org/pypi/sampleproject/json') as resp:154... project_info = json.load(resp)['info']155```156157В своей базовой форме [`pprint()`](https://python-all.ru/3.9/library/pprint.html#module-pprint) отображает весь объект:158159```python160>>> pprint.pprint(project_info)161{'author': 'The Python Packaging Authority',162 'author_email': 'pypa-dev@googlegroups.com',163 'bugtrack_url': None,164 'classifiers': ['Development Status :: 3 - Alpha',165 'Intended Audience :: Developers',166 'License :: OSI Approved :: MIT License',167 'Programming Language :: Python :: 2',168 'Programming Language :: Python :: 2.6',169 'Programming Language :: Python :: 2.7',170 'Programming Language :: Python :: 3',171 'Programming Language :: Python :: 3.2',172 'Programming Language :: Python :: 3.3',173 'Programming Language :: Python :: 3.4',174 'Topic :: Software Development :: Build Tools'],175 'description': 'A sample Python project\n'176 '=======================\n'177 '\n'178 'This is the description file for the project.\n'179 '\n'180 'The file should use UTF-8 encoding and be written using '181 'ReStructured Text. It\n'182 'will be used to generate the project webpage on PyPI, and '183 'should be written for\n'184 'that purpose.\n'185 '\n'186 'Typical contents for this file would include an overview of '187 'the project, basic\n'188 'usage examples, etc. Generally, including the project '189 'changelog in here is not\n'190 'a good idea, although a simple "What\'s New" section for the '191 'most recent version\n'192 'may be appropriate.',193 'description_content_type': None,194 'docs_url': None,195 'download_url': 'UNKNOWN',196 'downloads': {'last_day': -1, 'last_month': -1, 'last_week': -1},197 'home_page': 'https://github.com/pypa/sampleproject',198 'keywords': 'sample setuptools development',199 'license': 'MIT',200 'maintainer': None,201 'maintainer_email': None,202 'name': 'sampleproject',203 'package_url': 'https://pypi.org/project/sampleproject/',204 'platform': 'UNKNOWN',205 'project_url': 'https://pypi.org/project/sampleproject/',206 'project_urls': {'Download': 'UNKNOWN',207 'Homepage': 'https://github.com/pypa/sampleproject'},208 'release_url': 'https://pypi.org/project/sampleproject/1.2.0/',209 'requires_dist': None,210 'requires_python': None,211 'summary': 'A sample Python project',212 'version': '1.2.0'}213```214215Результат можно ограничить определённой *depth* (для более глубокого содержимого используется многоточие):216217```python218>>> pprint.pprint(project_info, depth=1)219{'author': 'The Python Packaging Authority',220 'author_email': 'pypa-dev@googlegroups.com',221 'bugtrack_url': None,222 'classifiers': [...],223 'description': 'A sample Python project\n'224 '=======================\n'225 '\n'226 'This is the description file for the project.\n'227 '\n'228 'The file should use UTF-8 encoding and be written using '229 'ReStructured Text. It\n'230 'will be used to generate the project webpage on PyPI, and '231 'should be written for\n'232 'that purpose.\n'233 '\n'234 'Typical contents for this file would include an overview of '235 'the project, basic\n'236 'usage examples, etc. Generally, including the project '237 'changelog in here is not\n'238 'a good idea, although a simple "What\'s New" section for the '239 'most recent version\n'240 'may be appropriate.',241 'description_content_type': None,242 'docs_url': None,243 'download_url': 'UNKNOWN',244 'downloads': {...},245 'home_page': 'https://github.com/pypa/sampleproject',246 'keywords': 'sample setuptools development',247 'license': 'MIT',248 'maintainer': None,249 'maintainer_email': None,250 'name': 'sampleproject',251 'package_url': 'https://pypi.org/project/sampleproject/',252 'platform': 'UNKNOWN',253 'project_url': 'https://pypi.org/project/sampleproject/',254 'project_urls': {...},255 'release_url': 'https://pypi.org/project/sampleproject/1.2.0/',256 'requires_dist': None,257 'requires_python': None,258 'summary': 'A sample Python project',259 'version': '1.2.0'}260```261262Кроме того, можно указать максимальную ширину *width*. Если длинный объект невозможно разбить, указанная ширина будет превышена:263264```python265>>> pprint.pprint(project_info, depth=1, width=60)266{'author': 'The Python Packaging Authority',267 'author_email': 'pypa-dev@googlegroups.com',268 'bugtrack_url': None,269 'classifiers': [...],270 'description': 'A sample Python project\n'271 '=======================\n'272 '\n'273 'This is the description file for the '274 'project.\n'275 '\n'276 'The file should use UTF-8 encoding and be '277 'written using ReStructured Text. It\n'278 'will be used to generate the project '279 'webpage on PyPI, and should be written '280 'for\n'281 'that purpose.\n'282 '\n'283 'Typical contents for this file would '284 'include an overview of the project, '285 'basic\n'286 'usage examples, etc. Generally, including '287 'the project changelog in here is not\n'288 'a good idea, although a simple "What\'s '289 'New" section for the most recent version\n'290 'may be appropriate.',291 'description_content_type': None,292 'docs_url': None,293 'download_url': 'UNKNOWN',294 'downloads': {...},295 'home_page': 'https://github.com/pypa/sampleproject',296 'keywords': 'sample setuptools development',297 'license': 'MIT',298 'maintainer': None,299 'maintainer_email': None,300 'name': 'sampleproject',301 'package_url': 'https://pypi.org/project/sampleproject/',302 'platform': 'UNKNOWN',303 'project_url': 'https://pypi.org/project/sampleproject/',304 'project_urls': {...},305 'release_url': 'https://pypi.org/project/sampleproject/1.2.0/',306 'requires_dist': None,307 'requires_python': None,308 'summary': 'A sample Python project',309 'version': '1.2.0'}310```311