Невидимый тип: три побега size_t с Linux CI

 · 3 min read

В отличие от int или float, в C++ тип size_t не является встроенным ключевым словом языка. Это обычный typedef, который живет в системных заголовочных файлах (например, <cstddef>). Однако в реальных проектах разработчики часто используют size_t “голым”, без явного #include, полагаясь на транзитивное включение из других файлов.

Invisible Type Size T Linux Ci

Старому парсеру Doxygen, на котором мы сидели раньше, было на это плевать — он работал как регулярное выражение и просто читал текст. Но когда мы перешли на настоящий AST-парсер (через libclang), компилятор потребовал строгости. И начался один из самых нелепых квестов в истории нашего CI.

Побег первый: Тихая аннигиляция

Мы написали тесты для нового парсера, запустили их локально на Windows — всё зелено. Более 1200 тестов прошли успешно, метод operator size_t() распарсился идеально. Мы отправили код в GitHub Actions.

Сборка на Linux-раннере упала.

Оказалось, что на Windows библиотека libclang использует “магию” auto-discovery от встроенного тулчейна MSVC — неявно подтягивает определения среды, поэтому size_t существует там всегда, даже в абсолютно пустом файле.

А вот на Linux libclang предельно честный: не нашел #include — значит, типа не существует. Встретив неизвестный тип size_t, парсер запаниковал, ушел в режим восстановления после ошибок (error-recovery) и просто молча удалил весь метод из итогового синтаксического дерева (AST). Целый кусок API буквально растворился в воздухе.

Побег второй: Ловушка пустого контейнера

Invisible Type Size T Linux Ci Part 3

Invisible Type Size T Linux Ci Part 2

Решение казалось очевидным: нужно заставить парсер насильно подключать заголовочный файл! Мы добавили флаг компилятора -include stddef.h ко всем файлам, которые мы парсим.

Локальные тесты прошли. Джоба генерации документации в CI тоже загорелась зеленым. Но базовая CI-джоба с юнит-тестами взорвалась с фатальной ошибкой: 'stddef.h' file not found.

Разгадка крылась в инфраструктуре. Юнит-тесты крутились в легковесном, минималистичном Docker-образе. Там был Python, там был старый Doxygen, но не было компилятора GCC и пакета build-essential. На диске физически не существовало файла stddef.h.

Наш “фикс” сломал парсинг вообще всех файлов в проекте, даже тех, где типа size_t отродясь не было.

Побег третий: Удар в спину от Mypy

Нам нужно было решение, которое вообще не требует установленного компилятора в операционной системе. И мы нашли элегантный хак.

Мы заставили Python на лету создавать во временной директории (/tmp) фейковый заголовочный файл со следующим кодом:

typedef __SIZE_TYPE__ size_t;

Секрет в том, что __SIZE_TYPE__ — это внутренний встроенный макрос Clang/GCC, который существует в памяти компилятора абсолютно всегда, независимо от заголовков. Мы скармливали этот временный файл libclang через тот же флаг -include.

Отправляем коммит в CI. И он… снова падает!

На этот раз сломался не C++, а статический анализатор Python — mypy. На локальной машине разработчика стоял свежий Python, который корректно вывел типы. А в CI стояла чуть более строгая версия, которая споткнулась о банальность: мы объявили переменную для пути к временному файлу как None, а потом попытались положить туда строку. Анализатор выбросил ошибку Incompatible types in assignment.

Поймали

Пришлось сделать третий коммит: успокоить mypy, явно прописав в Python-коде аннотацию Optional[str] = None.

И только тогда, с третьей попытки, пайплайн окончательно позеленел.

Мы потратили целый день на то, чтобы научить C++ AST-парсер понимать самый базовый тип данных на операционной системе, в которой нет компилятора. Разработка кроссплатформенных тулчейнов — это когда Windows прячет от тебя твои же баги, Linux бьет по рукам за системные зависимости, а добивает тебя вообще строгий линтер совершенно другого языка.

Впрочем, конфликты с C++ на этом не закончились. Когда настоящий компилятор сталкивается с легаси-тегами виртуальной группировки от Doxygen (вроде @addtogroup), начинается война между реальными C++ пространствами имен (namespaces) и виртуальной структурой документации. О том, как мы примирили эти два мира в AST — читайте в следующем эпизоде.