gostpadi

Рисовалка блок-схем. Скармливаешь main.c — получаешь готовую схему: все линии под 90° и одной толщины, if и switch расходятся ветками, return уводит стрелку в «End». Рисовать руками не приходится.

Работает и в обратную сторону: короткий текстовый файл .gvn — и та же схема без кода.

Пакет на PyPI: pypi.org/project/gostpadi

Установка

pip install gostpadi

Нужен только matplotlib, он поставится сам.

Вариант без установки — uv запускает утилиту прямо с GitHub:

uv run https://raw.githubusercontent.com/sehaxe/gostpadi/main/gostpadi.py main.c

Использование

gostpadi main.c                 # -> main.png, вписано в А4
gostpadi main.c --show          # показать схему в терминале
gostpadi main.c -o scheme.svg   # векторный SVG для Word/LaTeX
gostpadi main.c --auto          # размер по схеме, без ужимания
gostpadi main.c --gvn           # сохранить текст схемы (можно править)

Понимает: printf/scanf (сами параллелограммы), присваивания, if/else, switch/case/default (кейсы висят на линии из нижнего угла ромба, подписи s = 1 … default), return (ветка уходит в «End»). Объявления переменных выбрасываются. Циклов и else if пока нет — утилита скажет сама.

Свой формат .gvn

Если хочется управлять каждой строкой — пиши схему текстом: строка = блок, ветки — отступом в 4 пробела.

#gostpadi 1
input scanf("%d", &x)
y = x * 2
if y > 10
    yes: printf("big")
    no: printf("small")
output printf("done")

Примеры и заготовка — в examples/ и по команде --template.

Все опции

Из Python

import gostpadi

gostpadi.render(open("main.c").read(), "схема.png")          # из кода C
gostpadi.render(open("схема.gvn").read(), "результат.png")   # из .gvn
gostpadi.render(text, "x2.png", page="auto", scale=2.0)      # опции

Проверка

uv run --with matplotlib python selftest.py

Прогоняет все вариации и сверяет геометрию с эталоном (tests/baseline.json).

Лицензия

MIT — LICENSE.