Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/diegoclair/go_boilerplate
Golang boilerplate
https://github.com/diegoclair/go_boilerplate
boilerplate clean-architecture ddd ddd-architecture docker docker-compose go go-template go-testing golang golang-application
Last synced: 8 days ago
JSON representation
Golang boilerplate
- Host: GitHub
- URL: https://github.com/diegoclair/go_boilerplate
- Owner: diegoclair
- License: mit
- Created: 2021-09-25T23:55:23.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-03-15T20:27:47.000Z (7 months ago)
- Last Synced: 2024-03-16T22:46:02.192Z (7 months ago)
- Topics: boilerplate, clean-architecture, ddd, ddd-architecture, docker, docker-compose, go, go-template, go-testing, golang, golang-application
- Language: Go
- Homepage:
- Size: 14.1 MB
- Stars: 26
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
GO BOILERPLATE
This is a boilerplate that you can use for your go projects :)
Developed with the software and tools below.
## Description
This project is a boilerplate for creating API projects in Go, incorporating key principles of Domain-Driven Design and Clean Architecture. It reflects my expertise in Golang, drawn from previous projects, and is structured to facilitate maintainability and scalability.
All layers of the codebase are tested to ensure reliability and robustness. The project is open to contributions and improvements. Feel free to fork the repository, submit pull requests, or open issues to discuss enhancements or report bugs.
### Project architecture:
For the presentation layer, which I refer to as the transport layer, its purpose is to handle data transportation. It is responsible for receiving and responding to various types of requests, including API calls, gRPC, and messaging via RMQ, among others.
### Tests:
For unit tests with MySQL and Redis, we are using real dependencies with [testcontainers](https://testcontainers.com/).
It’s like putting our functions through a real-world.
And we are also using mocks to test the errors scenarios, this way we can achieve 100% of cover. 💪
## 💻 Getting Started
### Prerequisites ❗
* Ensure Docker is installed on your machine.
* An installation of Go 1.21.0 or later. For installation instructions, see [Installing Go](https://go.dev/doc/install).
### ▶️ Launching the Application
To start the application, execute the command:
```bash
docker-compose up
```
Once you see the message `your server started on [::]:5000`, the application is up and running!
## 📝 API Documentation:
For detailed API endpoint documentation, navigate to the `/docs` directory where you will find the Swagger documentation.
These swagger docs was generated using [goswag](https://github.com/diegoclair/goswag)
## Running tests
```bash
make tests
```
## Generating docs
```bash
make docs
```
## Contributing
Contributions are welcome! Here are several ways you can contribute:
- **Submit Pull Requests**: Review open PRs, and submit your own PRs.
- **[Join the Discussions](https://github.com/diegoclair/go_boilerplate/discussions)**: Share your insights, provide feedback, or ask questions.
- **[Report Issues](https://github.com/diegoclair/go_boilerplate/issues)**: Submit bugs found or log feature requests for Go_boilerplate.
Contributing Guidelines
1. **Fork the Repository**: Start by forking the project repository to your GitHub account.
2. **Clone Locally**: Clone the forked repository to your local machine using a Git client.
```sh
git clone https://github.com//go_boilerplate
```
3. **Create a New Branch**: Always work on a new branch, giving it a descriptive name.
```sh
git checkout -b new-feature-x
```
4. **Make Your Changes**: Develop and test your changes locally.
5. **Commit Your Changes**: Commit with a clear message describing your updates.
```sh
git commit -m 'Implemented new feature x.'
```
6. **Push to GitHub**: Push the changes to your forked repository.
```sh
git push origin new-feature-x
```
7. **Submit a Pull Request**: Create a PR against the original project repository. Clearly describe the changes and their motivations.
Once your PR is reviewed and approved, it will be merged into the main branch.
---
## License
This project is protected under the [MIT License](https://choosealicense.com/licenses/mit/) License. For more details, refer to the [LICENSE](./LICENSE) file.
:bowtie: