Hexagonal Architecture Code Sample project with Golang + Sequelize

A project to learn how to apply Hexagonal Architecture concepts in a real case project.

Based on: here

How to run?

The application is based on Go and Sequelize. However, to facilitate development, a docker-compose.yml file was created that raises a container with the Sqlite3 database.

To run the application, just run the command below:

docker compose up -d

After that, for you to enter the container and be able to execute Sequelize commands, run the command below:

docker exec -it app-product bash

p.s: sometimes will be necessary to install some dependencies using the root user. To do that, just run the command below:

docker exec -it -u root app-product bash

If the message below appears:

> www-data@7cb0866f66c4:/go/src$

It means that you are inside the container and can execute Sequelize commands.

Now, to create a go.mod file, run the command below:

go mod init github.com/your-user-name/your-project-name

After that, to install the dependencies, run the command below:

go mod tidy

And finally, use the Visual Studio Code to update the dependencies in the go.mod file. How? Just open the go.mod file and click on the Go: Install/Update Tools option that will appear at the top of the file.

Working with gomock and mockgen

To work with mockgen in this project, open now the terminal, use the docker command below to enter the container:

docker exec -it app-product bash

After that, run the command below to install the mockgen tool:

mockgen -destination=application/mocks/application.go -source=application/product.go application

After that, if you open the application folder, you will see that the mocks folder has been created with the application.go file inside it.

And to install the dependencies, run the command below:

go mod tidy

Cobra Generator

To work with cobra in this project, open now the terminal, use the docker command below to enter the container:

docker exec -it -u root app-product bash

And then run the command below to install the cobra tool:

go get -u github.com/spf13/cobra/cobra

After that, run the command below to create a new command:

cobra-cli init

Now, if you want to add a new Product, use the command below:

go run main.go cli -a=create -n="Product CLI" -p=35.0

Now, if you want to list all Products, use the command below:

 go run main.go cli -a=get --id=<include-product-id>

Now to run the web server using the Cobra command, run the command below:

go run main.go http

And open the browser at the address: http://localhost:9000/198a2d0d-7ac7-48de-9f3a-d57e0809909f