swapi-golang-rest-api

Planets API

API para adicionar e listar planetas da franquia Star Wars.

Ao adicionar um novo planeta, a aplicação buscará na SWAPI quantas vezes o mesmo apareceu nos filmes.

O design se baseia em alguns conceitos do Domain-Driver Design, Eric Evans e da Hexagonal Architecture de Alistair Cockburn.

Componentes

Business Core

• Listing
• Adding

Adapters

• Storage
• HTTP
  • RESTful server
  • Client

Dependências

Database

MongoDB

Ambiente de Desenvolvimento

Docker e docker-compose ou Go.

Go Modules

O gerenciamento de pacotes é feito através de Go Modules no arquivo go.mod. Os módulos utilizados como dependência são:

• govalidator como helper para validação e tratamento de erros de validação
• chi como roteador HTTP
• mongo-driver como driver do MongoDB

Para baixá-las com Go instalado na máquina:

$ go mod download

Como usar

Este repositório provê um ambiente de execução Docker via Dockerfile e docker-compose com todas as dependências e configurações necessárias.

Além disso, possui uma especificação OpenAPI 3 openapi.yml.

Variáveis de Ambiente

Docker-Compose

Para executar via docker-compose

$ docker-compose up --build -d

Testes

Testando

$ go test ./...

Cobetura

Licença

A aplicação está sob a licença MIT