🏦 GOBANK API Project

A simple rest api for bank accounts.

About the project   |    Technologies   |    Getting started   |    Docs   |    How to contribute   |    License

📊 About the project

Back-end app built with Golang and Go-Chi.

🚀 Technologies

Technologies that I used to develop this api

• go
• go-chi
• tern
• sqlc
• pgx
• air
• docker

💻 Getting started

Requirements

• Go
• One instance of PostgreSQL

Obs.: I recommend to use docker

Clone the project and access the folder

$ git clone https://github.com/dudubernardino/gobank && cd gobank

Follow the steps below

# Install the dependencies
$ go mod tidy

# Make a copy of '.env.example' to '.env'
# and set with YOUR environment variables.
# The aws variables do not need to be filled for dev environment
$ cp .env.example .env

# Create the instance of postgreSQL using docker compose
$ docker compose up -d

# To finish, run the api service
$ go run ./cmd/api

# (Optional) Run the Go Server Using Air-Verse for hot reload
$ air --build.cmd "go build -o ./bin/api ./cmd/api" --build.bin "./bin/api"

# Well done, project is started!

📚 Docs

I used REST Client to document the API. You can access api.http file.

🤔 How to contribute

Make a fork of this repository

# Fork using GitHub official command line
# If you don't have the GitHub CLI, use the web site to do that.

$ gh repo fork dudubernardino/gobank

Follow the steps below

# Clone your fork
$ git clone your-fork-url && cd gobank

# Create a branch with your feature
$ git checkout -b my-feature

# Make the commit with your changes
$ git commit -m 'feat: My new feature'

# Send the code to your remote branch
$ git push origin my-feature

After your pull request is merged, you can delete your branch

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Made with ❤️  by Eduardo Bernardino 👋  See my linkedin