Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/lana/go-commandbus

Simple command bus for GO
https://github.com/lana/go-commandbus

Last synced: 24 days ago
JSON representation

Simple command bus for GO

Lists

README 

        
# GO CommandBus



[![Build Status](https://img.shields.io/travis/lana/go-commandbus/master.svg?style=flat-square)](https://travis-ci.org/lana/go-commandbus)

[![Codecov branch](https://img.shields.io/codecov/c/github/lana/go-commandbus/master.svg?style=flat-square)](https://codecov.io/gh/lana/go-commandbus)

[![GoDoc](https://img.shields.io/badge/godoc-reference-5272B4.svg?style=flat-square)](https://godoc.org/github.com/lana/go-commandbus)

[![Go Report Card](https://goreportcard.com/badge/github.com/lana/go-commandbus?style=flat-square)](https://goreportcard.com/report/github.com/lana/go-commandbus)

[![License](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](https://github.com/lana/go-commandbus/blob/master/LICENSE)



A slight and pluggable command-bus for Go.



## Install



Use go get.

```sh

$ go get github.com/lana/go-commandbus

```



Then import the package into your own code:

```

import "github.com/lana/go-commandbus"

```



## Usage

```go

package main



import (

	"context"

	"log"



	"github.com/lana/go-commandbus"

)



type CreateUser struct {

	Name string

}



func CreateHandler(ctx context.Context, cmd *CreateUser) error {

	log.Printf("user %s created", cmd.Name)



	return nil

}



func main() {

	bus := commandbus.New()



	err := bus.Register(&CreateUser{}, CreateHandler)



	if err != nil {

		log.Error(err)

		os.Exit(1)

	}



	err = bus.Execute(context.Background(), &CreateUser{"go-commandbus"})



	if err != nil {

		log.Error(err)

		os.Exit(1)

	}

}

```



## License



This project is released under the MIT licence. See [LICENSE](https://github.com/lana/go-commandbus/blob/master/LICENSE) for more details.