1
0
mirror of https://github.com/ManyakRus/crud_generator.git synced 2024-11-27 08:40:53 +02:00
crud_generator/readme.rus
2023-11-22 17:19:22 +03:00

68 lines
4.0 KiB
Plaintext

Приложение crud_generator предназначено для автоматической генерации файлов исходного кода
на языке golang для выполнения операций CRUD.
Создаётся полностью готовый микросервис, который можно сразу запустить.
Для каждой таблицы в базе данных Postgres SQL будут сделаны файлы для выполнения crud операций:
create, read, update, save, delete (или delete + restore)
генерируются файлы:
1. table - структура struct со всеми полями из БД, и аннотациями gorm + json
Таблицы с полями в базе данных должны быть созданы заранее вручную.
Кодогенератор найдёт в базе все таблицы и их поля, и использует их.
2. model - структура struct, включающая table, с функциями crud операций
2. crud - файлы выполнения crud операций, обмен с базой данных,
а также файлы с тестами
3. grpc server - файлы для выполнения crud операций по сети, по протоколу GRPC,
а также файлы с тестами
4. grpc client - файлы клиенты для использования GRPC сторонними сервисами,
а также файлы с тестами
5. nrpc server - файлы для выполнения crud операций по сети, по протоколу NRPC (через брокер сообщений NATS),
а также файлы с тестами
6. nrpc client - файлы клиенты для использования NRPC сторонними сервисами,
а также файлы с тестами
7. crud_starter - файл с функциями переключения на нужный протокол db или grpc или nrpc
8. main.go и другие .go файлы
9. Makefile - файл настройки запуска скриптов
10. .env - файл для зазполнения конфигурации микросервиса (параметры подключения к БД и др.)
Шаблоны кода хранятся в папке bin/templates.
Шаблон кода - это файл .go скопированный из реального проекта -
поэтому шаблон сделать (поменять на свой) легко - просто скопировать свой файл.
Кодогенератор выполняет замену части кода в шаблоне на другой код:
- название таблицы БД
- название модели
- добавление и убирание импортов
Порядок установки:
1. Скомпилировать этот репозиторий
make build
в папке bin появится файл crud_generator
2. Заполнить найстройки в файле bin/templates/configs_/settings.txt
- подключения к вашей базе данных
- имя вашего нового сервиса
- URL вашего нового сервиса
- и др.
3. Запустить crud_generator
В папке bin появится новая папка с именем вашего сервиса,
с подпапками и готовыми файлами внутри.
4. Заполнить параметры конфигурации в файле .env
Запустить микросервис:
make run
P.S.
Я сгенерировал себе 170000 строк кода, из 70 таблиц в базе данных, для своего сервиса.
Исходный код на языке Golang.
Тестировал на Linux Ubuntu
Реадми от 14.11.2023
Сделал Александр Никитин
https://github.com/ManyakRus/crud_generator