Go application development tool applying modern practices.

The mga tool is an experimental collection of tools and practices related to developing Go applications. Its goal is to make the maintenance of applications, thus the life of developers easier.

⚠️ This tool is still under heavy development! Things may change. ⚠️

Currently it includes code generators and scaffolding tools:

• Go kit endpoint generator (based on a service interface)
• Testify mock generator (similar to mockery)
• Event dispatcher generator (based on event interface) (compatible with Watermill)
• Event handler generator (based on event structs) (compatible with Watermill)

Roadmap:

• Application scaffolding (based on Modern Go Application)
• Go kit service scaffolding
• Go kit transport scaffolding/code generator
• and more

See the Modern Go Application for a detailed usage example.

Download a prebuilt binary from the Releases page, or install the tool from source:

go get sagikazarmark.dev/mga

An endpoint can be generated based on a service interface:

package my
import (
    "context"
)
// +kit:endpoint
// Service is a business service.
type Service interface{
    // DoSomething is a service call.
    //
    // Named parameters and results are optional, but they make the generated code nicer.
    DoSomething(ctx context.Context, myparam string) (id string, err error)
}

Then run the generator:

mga generate kit endpoint ./...

See Modern Go Application for an example.

package my
// +testify:mock
// Service is a business service.
type Service interface{}
// +testify:mock:testOnly=true
// Service2 is a business service.
type Service2 interface{}

mga generate testify mock ./...

package my
import (
    "context"
)
// +mga:event:dispatcher
type Events interface{
    MyEvent(ctx context.Context, ev MyEvent) error
}
type MyEvent struct{}

mga generate event dispatcher ./...

See Modern Go Application for an example.

package my
// +mga:event:handler
type Event struct{
    ID string
    MyParam string
}

mga generate event handler ./...

See Modern Go Application for an example.

Contributions are welcome! :)

When all coding and testing is done, please run the test suite:

task check

For the best developer experience, install Nix and direnv.

Alternatively, install Go and Task manually or using a package manager.

The project is licensed under the MIT License.