Как перестать страдать при сборке Poppler под Windows

Знаете это специфическое чувство, когда для маленькой задачи по конвертации PDF в картинку вам нужно установить половину инструментов сборки C++, настроить CMake и еще пару часов гуглить, почему freetype не видит свои же заголовки? Если вы когда-нибудь пытались собрать библиотеку Poppler на Windows вручную, вы понимаете, о чем я. Это напоминает попытку собрать шкаф из IKEA, где половина болтов — левосторонняя резьба, а инструкция написана на эльфийском.

На днях я наткнулся на репозиторий poppler-windows от Оливера Шварца. И это именно та вещь, которая экономит кучу нервных клеток.

Что это за решение

Poppler — это стандарт де-факто для работы с PDF в мире Linux. На нем работают просмотрщики, конвертеры и куча серверных утилит. Но как только дело доходит до Windows, начинаются танцы с бубном.

Репозиторий poppler-windows не пытается переизобрести велосипед или переписать код библиотеки. Автор поступил умнее: он настроил автоматический процесс, который забирает уже скомпилированные бинарники из экосистемы conda-forge, аккуратно упаковывает их со всеми необходимыми зависимостями в один ZIP-архив и выкладывает в релизы.

По сути, это аккуратная «обертка», которая избавляет вас от необходимости ставить гигантские пакетные менеджеры ради одной библиотеки.

Почему это удобно

Когда вам нужно просто быстро запустить pdfimages или pdftocairo в скрипте на Python или Node.js, меньше всего хочется разворачивать среду Conda. Вот что дает этот проект:

Все включено. Бинарники идут сразу с зависимостями. Вам не придется искать libjpeg или zlib по всему интернету.
Свежие данные. В архив включен пакет poppler-data. Без него многие PDF с хитрыми кодировками (особенно азиатскими шрифтами) просто превращаются в «тыкву» при рендеринге.
Простая автоматизация. Если вышла новая версия Poppler, автор просто обновляет номер версии в конфиге, и GitHub Actions собирает новый архив.

Как это использовать в деле

Предположим, вы пишете на Python и используете популярную библиотеку pdf2image. Она — всего лишь обертка над консольной утилитой pdftoppm. Без установленного в системе Poppler она выдаст ошибку.

Раньше вы бы искали старые сборки на сомнительных сайтах. Теперь алгоритм действий выглядит так:

Идете в релизы проекта.
Скачиваете архив под вашу архитектуру.
Распаковываете в папку с проектом.
Добавляете путь к папке Library/bin в переменную окружения PATH или просто прописываете путь в коде библиотеки.

from pdf2image import convert_from_path

# Просто указываем путь к бинарникам из распакованного архива
images = convert_from_path('report.pdf', poppler_path=r'C:\path\to\poppler-windows\Library\bin')

Техническая сторона вопроса

Проект использует package.sh — небольшой скрипт, который скачивает пакеты poppler, poppler-data и зависимости напрямую из репозиториев Conda. Затем он пересобирает структуру папок так, чтобы она была логичной для обычного Windows-пользователя, и пакует все это дело.

Интересно, что автор не берет на себя ответственность за исправление багов в самом Poppler. Если что-то упало при рендеринге конкретного файла — это к разработчикам основной библиотеки. Задача этого репозитория — исключительно доставка и упаковка. Это честный и прозрачный подход.

Кому точно пригодится

Я бы посоветовал добавить этот репозиторий в закладки, если:

Вы занимаетесь автоматизацией обработки документов и PDF на Windows.
Вам нужно быстро развернуть окружение для тестов на CI/CD без установки тяжелого софта.
Вы пишете десктопное приложение, в котором нужно генерировать превью для PDF-файлов.

Проект живой, обновляется регулярно (судя по коммитам, автор следит за апдейтами в Conda) и уже собрал больше тысячи звезд. Для такой утилитарной вещи это отличный показатель того, что проблема «бинарников под винду» все еще актуальна.

Единственный минус — документация в самом репозитории очень лаконична. Там не объясняют, как прописывать пути или какие именно утилиты входят в состав. Но для тех, кто знает, зачем ему Poppler, это не станет преградой. Бинарники лежат в Library/bin, и это всё, что нужно знать разработчику.

Если вы устали от бесконечных попыток подружить Linux-инструменты с Windows-серверами, этот проект — именно то маленькое звено, которого не хватало для нормальной работы.