gen

Gen

Flexible code generation tool which perfectly integrates with your project.

Main Features

• Extensible, versioned and widely customizable code generators
• Verbose code generation config
• Convenient API for fastest creation of new code generators

Limitations

• It's hard to make a custom AST walker. You work with already parsed go code which is most convenient for almost all cases.
• Working only with go modules system (GO111MODULE=on).

Project status

Beta-version. Not recommended to use it in production.

Goals

The main goal of gen is to make code generation more flexible and easy to maintain.

How To Use

Using gen you need only gen cli utility and gen.yml file (see its description), where you could describe code generation details.

1. Install gen by running $ go get github.com/cv21/gen/cmd/gen
2. Add gen.yml to your project root (see examples directory in this project)
3. Run $ gen inside your project root

Generators

* You can use other or make your own generator for gen
* Feel free to contibute your generators to this page

Description of gen.yml

Typical gen.yml consists of files config array.

Each of files consists of:

• path - Path to source file which will be passed to specified generator.
• repository - Link to generator repository. It supports standard Golang module queries for versioning.
• params - Custom params for generator.

gen.yml example:

files:
  - path: ./path_to_some_source_file.go
    repository: github.com/some/[email protected]
    params:
      some_generator_custom_param: some_value
  - path: ./path_to_some_another_file.go
    repository: github.com/another/name-of-generator@master
    params:
      another_generator_custom_param: other_value

Future Enhancements

• Ability to use go:generate instead of gen.yml for short plugin configurations as a lightweight but yet powerful, versioned and flexible code generation system.