Skip to content

goservegen - Go Backend Architecture Generator using goserve framework

License

Notifications You must be signed in to change notification settings

unusualcodeorg/goservegen

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

goservegen - Go Backend Architecture Generator using goserve framework

Download

Project generator for go backend architecture using goserve framework

Check out goserve framework github.com/unusualcodeorg/goserve

How To Use goservegen

  1. Download the goservegen binary for your operating system from the goservegen latest release: github.com/unusualcodeorg/goservegen/releases

  2. Expand the compressed file (Example: Apple Mac M2: goservegen_Darwin_arm64.tar.gz)

  3. Run the binary

cd ~/Downloads/goservegen_Darwin_arm64

# ./goservegen [project directory path] [project module]
./goservegen ~/Downloads/example github.com/yourusername/example

Note: ./goservegen ~/Downloads/example github.com/yourusername/example will generate project named example located at ~/Downloads and module github.com/yourusername/example

  1. Open the generated project in your IDE/editor of choice

  2. Have fun developing your REST API server!

Generated Project

.
├── .extra
│   └── setup
│       └── init-mongo.js
├── api
│   └── sample
│       ├── dto
│       │   └── create_sample.go
│       ├── model
│       │   └── sample.go
│       ├── controller.go
│       └── service.go
├── cmd
│   └── main.go
├── config
│   └── env.go
├── keys
│   ├── private.pem
│   └── public.pem
├── startup
│   ├── indexes.go
│   ├── module.go
│   ├── server.go
│   └── testserver.go
├── utils
│   └── convertor.go
├── .env
├── .test.env
├── .gitignore
├── .dockerignore
├── Dockerfile
├── docker-compose.yml
├── go.mod
└── go.sum

Run the project using Docker

docker-compose up --build

Check the API

curl --location 'http://localhost:8080/sample/ping'

Response

{
    "code": "10000",
    "status": 200,
    "message": "pong!"
}

Working on the project

You can read about using this framework here github.com/unusualcodeorg/goserve

Read the Article to understand this project

How to Architect Good Go Backend REST API Services

Troubleshoot

Sometimes your operating system will block the binary from execution, you will have to provide permission to run it.

In Mac you have to go System Settings > Privacy & Security > Allow goservegen