pygal — библиотека на языке Python для создания интерактивных векторных графиков и диаграмм в формате SVG. Она предназначена для генерации визуализаций данных с минимальным объёмом кода и предлагает декларативный API, позволяющий быстро описывать типы диаграмм, серии данных и оформление. Результатом работы библиотеки являются масштабируемые векторные изображения, которые удобны для встраивания в веб-страницы и дальнейшей стилизации через CSS или атрибуты SVG.
Проект возник как инструмент для простого и наглядного представления числовых рядов и категориальных данных в приложениях и отчётах. pygal поддерживает различные типы диаграмм, включая линейные и столбчатые графики, круговые диаграммы, гистограммы, диаграммы с областями, точечные и комбинированные визуализации. Библиотека уделяет внимание удобству настройки легенд, tooltip'ов и форматов подписей осей, обеспечивая при этом небольшой набор зависимостей и совместимость с распространёнными версиями Python.
- Формат вывода: генерация SVG-файлов, пригодных для встраивания в HTML и последующей стилизации.
- Типы диаграмм: линейные, столбчатые, круговые, секторные, гистограммы, точечные, диаграммы с областями и комбинированные варианты.
- Интерактивность: встроенные подсказки (tooltips) и подсветка при наведении обеспечивают базовую интерактивность в браузере без дополнительных библиотек.
- Декларативный API: компактный и читаемый синтаксис для создания и конфигурации диаграмм, добавления серий данных и настроек оформления.
- Кастомизация: настройка цветов, стилей линий, заполнений, подписей осей, легенд и форматов чисел.
- Масштабируемость: благодаря SVG-формату диаграммы остаются чёткими при изменении размера и подходят для печати и адаптивного веб-дизайна.
- Экспорт и интеграция: простая запись в файл или получение SVG в виде строки для последующей вставки в шаблоны или веб-ответы.
- Независимость от браузерных фреймворков: отсутствие жёсткой привязки к конкретным фронтенд-библиотекам, что облегчает использование в разных стековых решениях.
- Поддержка локализации чисел и форматов: возможность настройки отображения чисел, дат и других подписей в соответствии с требованиями проекта.
- Документация и примеры: наличие примеров использования и справочных материалов, которые помогают быстро освоить основные возможности (при этом объём и актуальность материалов могут меняться со временем).