This repository is a collection of my personal tools and utilities for the Go programming language. It is designed to be used in a wide range of applications, from simple scripts to complex web applications.
It is designed to be simple and easy to use, with a focus on performance and reliability. It is also designed to be flexible and extensible, so that you can easily add new features and functionality as needed.
The repository is divided into several modules, each of which provides a different set of tools and utilities. The following is a brief overview of each module:
- apimanager: A simple way to manage an API server with the ability to add routes, route-groups, and middlewares. It is built on top of the gofiber/fiber framework.
- config: A wrapper around spf13/viper to load configuration files with into a struct and validate them.
- dependency: A simple dependency injection container that allows you to register and resolve dependencies.
- env: A simple way to load and convert environment variables into a desired type.
- executors: Useful executors and policies to handle common scenarios like retries with exponential backoff and more.
- lists: A collection of functions to complement the
slicespackage in the standard library. - metrics: A set of tools to collect and expose metrics for a Go application.
- rest: A generic REST client to make HTTP requests towards a (RESTful) API.
You can find the documentation for each module in their respective directories. Each module has its own README.md file that provides an overview of the module and how to use it.
You can find examples for each module in the example directory. Each example demonstrates how to use the module in a specific scenario.
This project has adopted the Contributor Covenant in version 2.1 as our code of conduct. Please see the details in our CODE_OF_CONDUCT.md. All contributors must abide by the code of conduct.
We decided to apply English as the primary project language.
Consequently, all content will be made available primarily in English. We also ask all interested people to use English as the preferred language to create issues, in their code (comments, documentation, etc.) and when you send requests to us. The application itself and all end-user facing content will be made available in other languages as needed.
The following channels are available for discussions, feedback, and support requests:
| Type | Channel |
|---|---|
| Issues |  |
Contribution and feedback is encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our Contribution Guidelines. By participating in this project, you agree to abide by its Code of Conduct at all times.
Copyright (c) 2024 lvlcn-t.
Licensed under the MIT (the "License"); you may not use this file except in compliance with the License.
You may obtain a copy of the License at https://www.mit.edu/~amini/LICENSE.md.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an " AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the LICENSE for the specific language governing permissions and limitations under the License.