Skip to content

kosatnkn/cauldron

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cauldron

CI CodeQL Coverage Status Open Issues GitHub release (latest by date) Go Reference Go Report Card

Project generator using Catalyst as a template.

Cauldron will generate a fully configured project along with a sample set so you can check whether everything is working fine.

The sample set covers request response lifecycle handling of basic CRUD operations. So you can use them as an example to create your REST API.

The project that will be created uses go.mod for dependency management. This will enable you to create and run projects outside of the GOPATH.

Visit the Catalyst base project for more information.

Version 1 vs Version 2

Version 1 of Cauldron supports creating projects using Catalyst versions v1.0.0 to v2.3.x.

Version 2 of Cauldron supports creating projects using Catalyst version v2.4.0 and upwards.

Installation

go get github.com/kosatnkn/cauldron

Usage

Command

cauldron -n Sample -s github.com/username [-t v1.0.0]
cauldron --name Sample --namespace github.com/username [--tag v1.0.0]

Input Parameters

  • -n --name Project name (ex: ProjectOne). The name will be converted to lowercase to be used in module path.
  • -s --namespace Namespace for the project (ex: github.com/example)
  • -t --tag Release version of Catalyst to be used. The latest version will be used if -t is not provided
  • -h --help Show help message

This will create a new project with go.mod module path of github.com/username/sample

Cauldron will do a git init on the newly created project but you will have to stage all the files in the project and do the first commit yourself.

git add .

git commit -m "first commit"