Fortran в Maguyva: графы кода для научных кодовых баз

Почему Fortran нужна структура, а не поиск по строкам

Кодовые базы на Fortran обычно старые, большие и написаны специалистами предметной области, а не командами разработчиков. Процедуры с именами SOLVE, Solve и solve — это одна и та же процедура. Модули используются сотнями файлов, а библиотека встроенных процедур настолько велика, что наивный список вызовов в основном состоит из SQRT, SUM и WRITE.

Агент, который умеет только grep, тонет в этом шуме. Maguyva сначала даёт ему структуру: какие программные единицы существуют, какие модули они используют и какие пользовательские процедуры вызывают друг друга.

Что Maguyva извлекает из Fortran

Maguyva охватывает исходный код в фиксированной и свободной форме (.f, .for, .ftn, .f90, .f95, .f03, .f08). Функции и подпрограммы извлекаются как вызываемые символы, а производные типы можно выбрать как определения типов в структурном поиске.

Сопоставление символов не учитывает регистр — как и сам Fortran. Связи импорта строятся из use и include; ключевое слово удаляется, и в графе сохраняется имя модуля. Вызовы, чтения, присваивания, ссылки на типы и наследование расширенных производных типов тоже входят в граф.

Фильтр связей отбрасывает около 165 встроенных процедур (операторы ввода-вывода, математические процедуры, процедуры для массивов, строк, преобразования типов и работы с битами), поэтому оставшиеся рёбра указывают на ваш собственный код.

Примеры промптов для агентов

• «Какие подпрограммы вызывают compute_flux и какие модули они используют?» (find_symbol, затем dependency_search incoming)
• «Проследи, как в цикле решателя применяются граничные условия.» (get_task_context)
• «Найди все программные единицы, которые используют модуль constants.» (text_pattern_search по use constants, затем find_symbol)

Известные ограничения

• В Fortran нет декораторов и обработки исключений, поэтому такие типы связей помечены как неприменимые.
• Процедуры, привязанные к типам, используют те же узлы, что и обычные функции и подпрограммы. В structural_search используйте пресет functions; пресет methods не выбирает узлы Fortran.
• Вызовы отфильтрованных встроенных процедур не появляются как рёбра графа. Если нужен каждый WRITE или OPEN, используйте text_pattern_search.

Следующие шаги

Подключите репозиторий по быстрому старту, затем изучите полную матрицу поддержки на странице совместимости. Если ваш Fortran соседствует со связующим кодом на C, прочитайте и руководство по C.