Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/tochemey/gopack

GoPack
https://github.com/tochemey/gopack

go golang grpc logger microservices opentelemetry-go postgres protocol-buffers rpc

Last synced: about 2 months ago
JSON representation

GoPack

Host: GitHub
URL: https://github.com/tochemey/gopack
Owner: Tochemey
License: mit
Created: 2023-06-24T16:00:09.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2024-09-15T08:02:43.000Z (2 months ago)
Last Synced: 2024-09-15T10:57:08.604Z (2 months ago)
Topics: go, golang, grpc, logger, microservices, opentelemetry-go, postgres, protocol-buffers, rpc
Language: Go
Homepage:
Size: 211 KB
Stars: 2
Watchers: 2
Forks: 0
Open Issues: 8
Metadata Files:
- Readme: readme.md
- Contributing: contributing.md
- License: LICENSE
- Code of conduct: code_of_conduct.md

Awesome Lists containing this project

README

        # 🎒GoPack

[![build](https://img.shields.io/github/actions/workflow/status/Tochemey/gopack/build.yml?branch=main)](https://github.com/Tochemey/gopack/actions/workflows/build.yml)

[![codecov](https://codecov.io/gh/Tochemey/gopack/branch/main/graph/badge.svg?token=LJO3LHe1Ox)](https://codecov.io/gh/Tochemey/gopack)

GoPack is kind of your Swiss Army Knife for golang microservices.

The project adheres to [Semantic Versioning](https://semver.org) and [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/).

## Features

- gRPC client and server 

  - Traces and Metrics are automatically handled depending upon the configuration.

  - ratelimiter interceptors (unary/stream) for both client and server

  - trace interceptors (unary/stream) for both client and server

  - metrics interceptors (unary/stream) for both client and server

  - recovery interceptors (unary/stream) for both client and server

  - request id interceptors (unary/stream) for both client and server

  - customizable options for both gRPC client and server

  - testkit to start a gRPC test server

- Postgres database interface to execute SQL statement with postgres with traces and metrics out of the box.

    - testkit to smoothly implement unit/integration tests with postgres

- OpenTelemetry trace and metrics provider to simplify the creation of trace and metrics providers

    - testkit to create an opentelemetry test collector

- Scheduler wrapper around [gocron](https://github.com/go-co-op/gocron)

- Zap logger wrapper with _request_id_, _trace_id_ and _span_id_ injected to log when present in the context

- Request ID injector into context

### Note

Traces and Metrics are accessible via the integration with [OpenTelemetry](https://github.com/open-telemetry/opentelemetry-go).

## Contribution

Contributions are welcome!

The project adheres to [Semantic Versioning](https://semver.org) and [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/).

This repo uses [Earthly](https://earthly.dev/get-earthly).

To contribute please:

- Fork the repository

- Create a feature branch

- Submit a [pull request](https://help.github.com/articles/using-pull-requests)

### Test & Linter

Prior to submitting a [pull request](https://help.github.com/articles/using-pull-requests), please run:

```bash

earthly +test