GoProd

Sample application written with Golang using web frameworks that would replace the ones I'm used to and love from the JVM world.

Personally I love the following:

• Dropwizard.io
  • It's a really simple framework that does very few things but tries to guide you building a minimal but clean microservice.
• Guice
  • Google says that it's a lightweight dependency injection framework, and that's true. It's very simple and enables you to do almost everything you would ever want, including things you should not do.
• Hibernate/Gorm
  • Both are ORM's. Gorm is a lightweight ORM that is very easy to use and has a very small footprint. Hibernate is a full-featured ORM that is very powerful and has a large footprint.
  • They are both excellent ORMs, and they don't tend to get in the way.
• SLF4J (Simple Log Facade For Java)
  • Clean API than enables many libraries to log messages without any issues.
  • Go does not provide an interface for logs, instead it just provides classes. This means that you would implement whatever you need. I don't really like that as moving from one library to another might become a pain as you need to glue them together.
• testcontainers
  • Framework for running your dependencies. This framework is great it can ran almost anything without any complications.
  • I worked with the creator @rnorth while I was at skyscanner and it made our services very resilient and reliable.

Goals

With this app I want to build something using all the standards I've learned to like in my career. This includes not only the above but building in a clean way.

This app should be observable at all times and be able to scale up in terms of features and teams working on this.

Additionally, everything should be tested with different layers of tests from unit to e2e and contract tests so that others can rely on our API to be dependable.

Development

Install Go, you can do this with Brew or your favourite way of installing dependencies.

  brew install go

Run Tests:

  make test

Spin up database and other dependencies:

  docker-compose up -d

Once you don't need them anymore you can run the following command to stop the containers:

  docker-compose down -v

Build and run:

  make clean build
  bin/app web

Check lint and dependencies:

  make check
  make lint