dataclass-to-diagram 0.0.3

Создание диаграмм из датаклассов python

dataclass_to_diagram

Создание диаграмм из датаклассов python

Типы диаграмм

С4

Описание - https://c4model.com/

Реализация на PlantUML - https://github.com/plantuml-stdlib/C4-PlantUML

Состоит из пакетов:

• main - основной пакет для запуска
• models - модели на основе dataclass для различных диаграмм
• exporters - экспорт моделей в текстовый формат
• converters - конвертирование текстового формата в изображение (svg, png, pdf, ...)

exporters

dbml

Экспорт моделей БД (ERD) в формат dbml

converters

dbml-renderer

Конвертирует файл с разметкой dbml в svg-изображение.

Установка:

npm install -g @softwaretechnik/dbml-renderer

Библиотека для генерации диаграмм из текстового описания.

Диаграммы описываются объектами python. Далее геренируются изображения с помощью https://kroki.io.

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

1. Создать две папки:

   • dia_src - папка с исходным описанием
   • dia_dist - папка со сгенерированными изображениями

2. В папке dia_src создаются py-файлы. Названия файлов - произвольные. Можно создавать подкаталоги - структура каталогов будет скопирована в целевую папку dia_dist. Примеры создания можно посмотреть в тестовых диаграммах пакета.

3. В одном файл должна быть только одна диаграмма. Название файла будет названием диаграммы.

4. Для генерации можно создать задачу poetepoet. Прописать в файле pyproject.toml:

   [tool.poetry.dependencies]
   konstantin_docs = "*"
   poethepoet = "*"
   
   [tool.poe.tasks]
   docs = {script = "konstantin_docs.main:generate_images('dia_src', 'dia_dist')"}
   

5. Запустить командой:

   poetry run poe docs
   

6. Дополнительно можно создать задачу в vscode. Для этого в файле .vscode/tasks.json:

   {
     "version": "2.0.0",
     "tasks": [
       {
         "label": "docs",
         "type": "shell",
         "command": "poetry run poe docs"
       }
     ]
   }
   

   Запускать командой F1 -> Task: Run task -> docs

ERD

npm install -g @softwaretechnik/dbml-renderer

Разработка

poetry build && poetry publish