gostpadi 1.0.0__tar.gz

gostpadi-1.0.0/.gitignore

@@ -0,0 +1,4 @@
+__pycache__/
+*.pyc
+*.png
+!docs/*.png

gostpadi-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sehaxe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gostpadi-1.0.0/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.5
+Name: gostpadi
+Version: 1.0.0
+Summary: Flowchart generator: feed it C code, get a clean diagram
+Project-URL: Repository, https://github.com/sehaxe/gostpadi
+Project-URL: Issues, https://github.com/sehaxe/gostpadi/issues
+Author: sehaxe
+License: MIT License
+        
+        Copyright (c) 2026 sehaxe
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: c,code2chart,diagram,flowchart,svg,visualization
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.9
+Requires-Dist: matplotlib>=3.5
+Description-Content-Type: text/markdown
+
+# gostpadi
+
+Рисовалка блок-схем. Скармливаешь `main.c` — получаешь готовую схему:
+все линии под 90° и одной толщины, `if` и `switch` расходятся ветками,
+`return` уводит стрелку в «End». Рисовать руками не приходится.
+
+![схема из кода C](docs/scheme-from-c.png)
+
+Работает и в обратную сторону: короткий текстовый файл `.gvn` —
+и та же схема без кода.
+
+![switch](docs/scheme-switch.png)
+
+## Установка
+
+Достаточно [uv](https://docs.astral.sh/uv/), ничего ставить не нужно:
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh     # Linux / macOS
+```
+
+Схема из кода одной командой, без клонирования:
+
+```bash
+uv run https://raw.githubusercontent.com/sehaxe/gostpadi/main/gostpadi.py main.c
+```
+
+Классический вариант:
+
+```bash
+git clone https://github.com/sehaxe/gostpadi && cd gostpadi
+pip install matplotlib
+python gostpadi.py main.c
+```
+
+## Как пользоваться
+
+```bash
+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` (кейсы висят на линии из нижнего угла ромба),
+`return` (ветка уходит в «End»). Объявления переменных выбрасываются.
+Циклов и `else if` пока нет — утилита скажет сама.
+
+Хочешь управлять каждой строкой — пиши `.gvn` руками: строка = блок,
+ветки — отступ в 4 пробела. Примеры в `examples/`.
+
+## Опции
+
+| опция | что делает |
+|---|---|
+| `-o ФАЙЛ` | имя результата (`.png` или `.svg`) |
+| `--show` | нарисовать схему прямо в терминале |
+| `--auto` | канвас по размеру схемы, без ужимания |
+| `--gvn` | сохранить текст схемы |
+| `--scale=N` | масштаб |
+| `--font=N` | кегль (12) |
+| `--lw=N` | толщина всех линий (1.4) |
+| `--dpi=N` | плотность пикселей (200) |
+| `--template` | заготовка схемы |
+
+## Проверка
+
+```bash
+uv run --with matplotlib python selftest.py
+```
+
+Прогоняет все вариации и сверяет геометрию с эталоном
+(`tests/baseline.json`).
+
+## Лицензия
+
+MIT — [LICENSE](LICENSE).

gostpadi-1.0.0/README.md

@@ -0,0 +1,79 @@
+# gostpadi
+
+Рисовалка блок-схем. Скармливаешь `main.c` — получаешь готовую схему:
+все линии под 90° и одной толщины, `if` и `switch` расходятся ветками,
+`return` уводит стрелку в «End». Рисовать руками не приходится.
+
+![схема из кода C](docs/scheme-from-c.png)
+
+Работает и в обратную сторону: короткий текстовый файл `.gvn` —
+и та же схема без кода.
+
+![switch](docs/scheme-switch.png)
+
+## Установка
+
+Достаточно [uv](https://docs.astral.sh/uv/), ничего ставить не нужно:
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh     # Linux / macOS
+```
+
+Схема из кода одной командой, без клонирования:
+
+```bash
+uv run https://raw.githubusercontent.com/sehaxe/gostpadi/main/gostpadi.py main.c
+```
+
+Классический вариант:
+
+```bash
+git clone https://github.com/sehaxe/gostpadi && cd gostpadi
+pip install matplotlib
+python gostpadi.py main.c
+```
+
+## Как пользоваться
+
+```bash
+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` (кейсы висят на линии из нижнего угла ромба),
+`return` (ветка уходит в «End»). Объявления переменных выбрасываются.
+Циклов и `else if` пока нет — утилита скажет сама.
+
+Хочешь управлять каждой строкой — пиши `.gvn` руками: строка = блок,
+ветки — отступ в 4 пробела. Примеры в `examples/`.
+
+## Опции
+
+| опция | что делает |
+|---|---|
+| `-o ФАЙЛ` | имя результата (`.png` или `.svg`) |
+| `--show` | нарисовать схему прямо в терминале |
+| `--auto` | канвас по размеру схемы, без ужимания |
+| `--gvn` | сохранить текст схемы |
+| `--scale=N` | масштаб |
+| `--font=N` | кегль (12) |
+| `--lw=N` | толщина всех линий (1.4) |
+| `--dpi=N` | плотность пикселей (200) |
+| `--template` | заготовка схемы |
+
+## Проверка
+
+```bash
+uv run --with matplotlib python selftest.py
+```
+
+Прогоняет все вариации и сверяет геометрию с эталоном
+(`tests/baseline.json`).
+
+## Лицензия
+
+MIT — [LICENSE](LICENSE).

gostpadi-1.0.0/examples/board1_linear.gvn

@@ -0,0 +1,5 @@
+# Linear scheme: one block per line, arrows down
+action a = 5
+action b = 17
+action c = a + b
+output printf("c = %d", c)

gostpadi-1.0.0/examples/board2_if.gvn

@@ -0,0 +1,10 @@
+# Branch: yes goes left, no goes right, both merge below
+output printf(a)
+input scanf("%d", &a)
+output printf(b)
+input scanf("%d", &b)
+action c = a + b
+output printf(c)
+if c > 5
+    yes: printf(c)
+    no: c = 0

gostpadi-1.0.0/examples/board3_switch.gvn

@@ -0,0 +1,7 @@
+# Switch: one column per case, all cases hang
+# on the horizontal line from the bottom corner
+input scanf("%d", &a)
+if switch (a)
+    1: printf(y); break
+    2: printf(z); break
+    default: a = 10; break

gostpadi-1.0.0/examples/hello.gvn

@@ -0,0 +1,10 @@
+#gostpadi 1
+# Идеальный минимум: одна строка = один блок, отступ = ветка.
+input scanf("%d", &x)
+if scanf != 1
+    yes -> end: printf("bad input"); return 1
+y = x * 2
+if y > 10
+    yes: printf("big")
+    no: printf("small")
+output printf("done")

gostpadi-1.0.0/examples/main.c

@@ -0,0 +1,21 @@
+#include <stdio.h>
+
+// Определение времени года по номеру месяца
+int main(void) {
+    int month;
+
+    printf("Введите номер месяца (1-12): ");
+    if (scanf("%d", &month) != 1 || month < 1 || month > 12) {
+        printf("Ошибка ввода\n");
+        return 1;
+    }
+
+    switch (month / 3) {
+        case 1: printf("Весна\n"); break;
+        case 2: printf("Лето\n"); break;
+        case 3: printf("Осень\n"); break;
+        default: printf("Зима\n");
+    }
+
+    return 0;
+}

gostpadi-1.0.0/examples/task1.gvn

@@ -0,0 +1,7 @@
+output printf("Введите катеты...")
+input scanf("%f %f", &a, &b)
+if scanf != 2 || a <= 0 || b <= 0
+    yes -> end: printf("Ошибка..."); return 1
+    no:
+output printf("Гипотенуза...")
+output printf("Площадь...")

gostpadi-1.0.0/examples/task2.gvn

@@ -0,0 +1,9 @@
+input scanf("%d", &a)
+if a < 100000 || ...
+    yes -> end: printf("Ошибка..."); return 1
+    no:
+action b = a / 100000 + ...
+action c = a % 10 + ...
+if b == c
+    yes: printf("БИЛЕТ СЧАСТЛИВЫЙ...")
+    no: printf("Вам не повезло...")

gostpadi-1.0.0/examples/task3.gvn

@@ -0,0 +1,12 @@
+input scanf("%f %f %f", ...)
+if scanf(...) != 3
+    yes -> end: printf("Ошибка..."); return 1
+    no:
+if fmodf(a, 1) == 0
+    yes: printf("Число 1...")
+if fmodf(b, 1) == 0
+    yes: printf("Число 2...")
+if fmodf(c, 1) == 0
+    yes: printf("Число 3...")
+if fmodf(a, 1) != 0 && ...
+    yes: printf("Ни одно...")

gostpadi-1.0.0/examples/task4.gvn

@@ -0,0 +1,10 @@
+input scanf("%d", &status)
+if status <= 0 || ...
+    yes -> end: printf("ТЫ НЕ ПРОЙ..."); return 1
+    no:
+if switch (status)
+    1: printf("Декабрь...")
+    2: printf("Март...")
+    3: printf("Июнь...")
+    4: printf("Сентябрь...")
+    default: printf("Как ты...")