https://github.com/manicar2093/gomancer
Gomancer is a powerful code generator designed to make API development in Go BLAZINGLY fast!
https://github.com/manicar2093/gomancer
code full-stack fullstack generation go golang phoenix phoenix-framework ssr
Last synced: 14 days ago
JSON representation
Gomancer is a powerful code generator designed to make API development in Go BLAZINGLY fast!
- Host: GitHub
- URL: https://github.com/manicar2093/gomancer
- Owner: manicar2093
- License: mit
- Created: 2025-03-20T04:26:45.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-09-05T00:17:28.000Z (5 months ago)
- Last Synced: 2025-09-05T00:19:08.612Z (5 months ago)
- Topics: code, full-stack, fullstack, generation, go, golang, phoenix, phoenix-framework, ssr
- Language: Go
- Homepage:
- Size: 1.64 MB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Gomancer
⚠️ **Note:** Building in process. I hope to be able to create many things to deliver v1.0.0 ⚠️
## Overview
Gomancer is a powerful code generator designed to make API development in Go **BLAZINGLY** fast! It automates the creation of models, controllers, repositories, and database migrations, allowing you to focus on your business logic rather than boilerplate code.
Inspired by tools like Phoenix's generators in Elixir, Gomancer brings rapid API development to the Go ecosystem by leveraging existing powerful packages and organizing them in a cohesive way.
## Quick Start
Create a new project:
```bash
gomancer new github.com/user/great_api
cd great_api
go mod tidy
npm i # for Prisma dependencies
```
Generate a complete API resource:
```bash
gomancer gen User name:string age:int8 dob:time:optional --pk-uuid
```
And just like that, you're ready to go with a fully functional API!
## Installation
```bash
go install github.com/manicar2093/gomancer@latest
```
## Features
### Project Initialization
Gomancer creates a well-structured project with:
- Echo web framework configuration
- Prisma for database migrations
- GORM for database access
- Templ for SSR (Server Side Rendering)
- TemplUI for html components
- Environment configuration
- GitHub workflow (bump_version) for automatic semantic versioning and changelog generation
- Air for hot reloading
- And more!
### Code Generation
Generate complete API resources with a single command:
- Models with validation
- Controllers with CRUD endpoints
- Repositories with database operations
- Database migrations
### Supported Data Types
Gomancer supports a wide range of data types:
- Basic types: int, int8, int16, int32, int64, float32, float64, string, bool
- Complex types: time, decimal, uuid
- Enums (with custom values)
- Optional fields
### Primary Key Options
- Auto-increment integer (default)
- UUID (with `--pk-uuid` flag)
## Usage Examples
### Creating a New Project
```bash
gomancer new github.com/username/awesome-api
```
### Generating Resources
All resources will generate Web and Rest controllers
Basic resource with auto-increment ID:
```bash
gomancer gen Client name:string email:string age:int
```
Resource with UUID primary key:
```bash
gomancer gen Product name:string price:decimal stock:int --pk-uuid
```
Resource with optional fields:
```bash
gomancer gen User name:string bio:string:optional avatar:string:optional
```
Resource with enum field:
```bash
gomancer gen Order status:enum/pending/processing/shipped/delivered total:decimal
```
## Project Structure
When you create a new project with Gomancer, it generates the following structure:
```
/
├── .air.toml # Configuration for hot reloading
├── .cz.toml # Commitizen configuration
├── .env # Environment variables
├── .gitignore
├── go.mod # Go module definition
├── Makefile # Templ and Tailwind used commands
├── package.json # Node.js dependencies (for Prisma)
├── README.md # Project documentation
├── Taskfile.yml # Task runner configuration
├── .github
│ └── workflows
│ └── bump_version.yml # GitHub Actions workflow for automatic version bumping
├── cmd
│ └── service
│ ├── main.go # Application entry point
│ ├── assets
│ │ ├── css
│ │ │ └── styles.css
│ │ ├── img
│ │ │ ├── favicon.ico
│ │ │ └── gomancer.png
│ │ └── js
│ │ ├── htmx@2.0.4.min.js
│ │ ├── popover.min.js
│ │ ├── selectbox.min.js
│ │ ├── theme-setter.js
│ │ └── toggle-theme.js
│ ├── controllers
│ │ ├── init_rest.go # REST initial controller
│ │ ├── init_web.go # Web initial controller
│ │ └── initpages # Initial templ docs
│ │ └── home.templ
│ ├── sources
│ │ └── css
│ │ └── input.css
│ ├── translations
│ │ ├── translations.go
│ │ ├── en
│ │ │ └── translations.yaml
│ │ └── es
│ │ ├── translations.yaml
│ │ └── validator.go
│ └── ui
│ ├── components
│ │ ├── button
│ │ │ └── button.templ
│ │ ├── drawer
│ │ │ └── drawer.templ
│ │ ├── form
│ │ │ └── form.templ
│ │ ├── icon
│ │ │ ├── icon_data.go
│ │ │ ├── icon_defs.go
│ │ │ └── icon.go
│ │ ├── input
│ │ │ └── input.templ
│ │ ├── label
│ │ │ └── label.templ
│ │ ├── pagination
│ │ │ └── pagination.templ
│ │ ├── popover
│ │ │ └── popover.templ
│ │ ├── selectbox
│ │ │ └── selectbox.templ
│ │ ├── table
│ │ │ └── table.templ
│ │ └── toggle
│ │ └── toggle.templ
│ ├── layouts
│ │ ├── drawer.templ
│ │ ├── flash_messages.templ
│ │ ├── Initial.templ
│ │ └── sidemenu.templ
│ └── utils
│ └── templui.go
├── core
│ └── ...
├── internal
│ ├── domain
│ │ └── models # Here will be all your models
│ │ └── init.go
├── pkg
│ ├── config
│ │ └── config.go
│ ├── generators
│ │ ├── entities.go
│ │ └── generators.go
│ └── versioning
│ └── version.go
└── prisma
└── schema
└── schema.prisma
```
## Why Gomancer?
I started with the following question:
**Do we really need a fullstack framework for Golang?**
I think Go has many powerful packages to handle projects of all sizes, but there was no way to create APIs quickly and efficiently.
Once I tried to learn Elixir and Phoenix, I was shocked by the `phx.gen` tool. You can get a usable API in milliseconds, even create CRUDs with just a CLI command. **Why not bring this to Go?**
We have everything: ORMs, HTTP Servers, UI Libraries, Validation packages..._EVERYTHING!_ We just need to gather them all in one place, ready to be used.
That's why Gomancer was born.
## About types
Now the only thing to notice is all dates are handled as UTC and show as Local when data is shown in a HTML input :/. There is an issue [#27](https://github.com/manicar2093/gomancer/issues/27) to review this.
## Roadmap
- [X] Start a project
- [X] Create controller
- [ ] Create controller testing
- [X] Create models
- [X] Create migrations with Prisma
- [X] Create CRUD repository
- [X] Create CRUD testing
- [X] Create all at once: controller, model, migration and repository
- [ ] Create API documentation
- [ ] Create auth implementation
- [X] Add CRUD HTML templates
- [ ] Add CRUD HTML testing
- [ ] Add API testing
## Known Issues
- On PartialUpdateById test bool and enums (and it optional variations) has no random validations. This is due bool just has 2 possible values and enums can have from 1 to many. This makes it hard to randomize tests.
- On command when writing an attribute called data_32 snake case is not well converted. This can cause problems with Gorm ORM due gorm will transform it to data32 and model will be data_32. Horrible, but avoidable if not use _ in attributes declaration
## License
This project is licensed under the MIT License - see the LICENSE file for details.