Skip to content

Latest commit

 

History

History
113 lines (87 loc) · 3.45 KB

template-cmd.md

File metadata and controls

113 lines (87 loc) · 3.45 KB
Raw

Template Operation

Template is the basis of data-driven generation, all code (rest api, rpc, model, docker, kube) generation will rely on template. By default, the template generator selects the in-memory template for generation, while for developers who need to modify the template, they need to drop the template and make template changes in the next code generation. For developers who need to modify the templates, they need to modify the templates, and then the next time the code is generated, it will load the templates under the specified path to generate.

Help

NAME:
   goctl template - template operation

USAGE:
   goctl template command [command options] [arguments...]

COMMANDS:
   init    initialize the all templates(force update)
   clean   clean the all cache templates
   update  update template of the target category to the latest
   revert  revert the target template to the latest

OPTIONS:
   --help, -h  show help

Init

NAME:
   goctl template init - initialize the all templates(force update)

USAGE:
   goctl template init [command options] [arguments...]

OPTIONS:
   --home value  the goctl home path of the template

Clean

NAME:
   goctl template clean - clean the all cache templates

USAGE:
   goctl template clean [command options] [arguments...]

OPTIONS:
   --home value  the goctl home path of the template

Update

NAME:
   goctl template update - update template of the target category to the latest

USAGE:
   goctl template update [command options] [arguments...]

OPTIONS:
   --category value, -c value  the category of template, enum [api,rpc,model,docker,kube]
   --home value                the goctl home path of the template

Revert

NAME:
   goctl template revert - revert the target template to the latest

USAGE:
   goctl template revert [command options] [arguments...]

OPTIONS:
   --category value, -c value  the category of template, enum [api,rpc,model,docker,kube]
   --name value, -n value      the target file name of template
   --home value                the goctl home path of the template

Tip

--home Specify the template storage path

Template loading

You can specify the folder where the template is located by --home during code generation, and the commands that have been supported to specify the template directory are

  • goctl api go Details can be found in goctl api go --help for help
  • goctl docker Details can be viewed with goctl docker --help
  • goctl kube Details can be viewed with goctl kube --help
  • goctl rpc new Details can be viewed with goctl rpc new --help
  • goctl rpc proto Details can be viewed with goctl rpc proto --help
  • goctl model mysql ddl Details can be viewed with goctl model mysql ddl --help
  • goctl model mysql datasource Details can be viewed with goctl model mysql datasource --help
  • goctl model postgresql datasource Details can be viewed with goctl model mysql datasource --help
  • goctl model mongo Details can be viewed with goctl model mongo --help

The default (when --home is not specified) is to read from the $HOME/.goctl directory.

Example

  • Initialize the template to the specified $HOME/template directory
$ goctl template init --home $HOME/template 

Templates are generated in /Users/anqiansong/template, edit on your risk!
  • Greet rpc generation using $HOME/template template
$ goctl rpc new greet --home $HOME/template

Done