sdk-go

module
v0.0.4 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 1, 2025 License: MIT

README

🚀 sdk-go: Powerful Go Libraries Toolkit

GitHub go.mod Go version Build Status Coverage Version

📖 Overview

sdk-go is a monorepo of Go libraries maintained by Downsized Devs. Each top-level directory exposes a focused package that can be imported on its own or pulled in as part of the complete toolkit. The project aims to streamline Go development with well-tested utilities ranging from logging and scheduled jobs to data storage helpers.

✨ Features

  • 🔧 Modular library architecture
  • 🚄 High-performance implementations
  • 🛡️ Robust error handling
  • 📦 Easy integration
  • 🧪 Thoroughly tested components

🛠️ Installation

Quick Start
go get -u github.com/downsized-devs/sdk-go
Individual Library Installation
# Install specific libraries as needed
go get -u github.com/downsized-devs/sdk-go/<package-name>

💻 Usage Example

import "github.com/downsized-devs/sdk-go/<package-name>"

📂 Repository Structure

Each top-level directory houses a standalone Go package. A few notable examples include:

  • appcontext – request-scoped context helpers
  • logger – structured logging based on Zerolog
  • scheduler – wrappers around gocron for background jobs
  • redis – thin client with distributed locking support
  • translator – i18n solution using universal-translator

Packages can be imported individually or as part of the entire toolkit.

🛠 Code Generator

The generator/ folder contains a scaffolding tool for creating boilerplate in other projects. Run it with:

go run ./generator --name <EntityName> --path <output-path> --api

🔧 Testing & Tooling

Use the provided Makefile for common tasks:

  • make build – compile all packages
  • make run-tests – execute the unit test suite
  • make mock-all – generate GoMock stubs

🌱 Explore Further

  • Dive into packages such as auth, storage, or messaging to see available APIs.
  • Review errors/ and codes/ to understand custom error handling.
  • Check instrument/ for Prometheus instrumentation examples.

📜 License

Distributed under the MIT License. See LICENSE for more information.

🌟 Support

If you encounter any problems or have suggestions, please open an issue.

🏆 Quality Metrics

GitHub Issues GitHub Pull Requests GitHub License Code Quality

📊 Repository Stats

GitHub Contributors GitHub Last Commit Repo Size Language

🛡️ Code Health

Go Report Card

🌐 Community & Engagement

GitHub Stars GitHub Forks

Happy Coding! 👨‍💻👩‍💻

Directories

Path Synopsis
helper
modifiers
modifiers/domain_initialize
modifiers/domain_item
modifiers/domain_query
modifiers/domain_redis
modifiers/domain_test
modifiers/entity
modifiers/handler_rest
modifiers/mock_file
modifiers/rest_initialize
modifiers/sql
modifiers/usecase_initialize
modifiers/usecase_item
modifiers/usecase_test
services
Package gqlclient provides a low level GraphQL client.
 Package gqlclient provides a low level GraphQL client.
tests
mock/audit
Package mock_audit is a generated GoMock package.
 Package mock_audit is a generated GoMock package.
mock/auth
Package mock_auth is a generated GoMock package.
 Package mock_auth is a generated GoMock package.
mock/configbuilder
Package mock_configbuilder is a generated GoMock package.
 Package mock_configbuilder is a generated GoMock package.
mock/configreader
Package mock_configreader is a generated GoMock package.
 Package mock_configreader is a generated GoMock package.
mock/email
Package mock_email is a generated GoMock package.
 Package mock_email is a generated GoMock package.
mock/featureflag
Package mock_featureflag is a generated GoMock package.
 Package mock_featureflag is a generated GoMock package.
mock/gqlclient
Package mock_gqlclient is a generated GoMock package.
 Package mock_gqlclient is a generated GoMock package.
mock/instrument
Package mock_instrument is a generated GoMock package.
 Package mock_instrument is a generated GoMock package.
mock/local_storage
Package mock_local_storage is a generated GoMock package.
 Package mock_local_storage is a generated GoMock package.
mock/localstorage
Package mock_localstorage is a generated GoMock package.
 Package mock_localstorage is a generated GoMock package.
mock/logger
Package mock_logger is a generated GoMock package.
 Package mock_logger is a generated GoMock package.
mock/messaging
Package mock_messaging is a generated GoMock package.
 Package mock_messaging is a generated GoMock package.
mock/parser
Package mock_parser is a generated GoMock package.
 Package mock_parser is a generated GoMock package.
mock/pdf
Package mock_pdf is a generated GoMock package.
 Package mock_pdf is a generated GoMock package.
mock/query
Package mock_query is a generated GoMock package.
 Package mock_query is a generated GoMock package.
mock/ratelimiter
Package mock_ratelimiter is a generated GoMock package.
 Package mock_ratelimiter is a generated GoMock package.
mock/redis
Package mock_redis is a generated GoMock package.
 Package mock_redis is a generated GoMock package.
mock/security
Package mock_security is a generated GoMock package.
 Package mock_security is a generated GoMock package.
mock/slack
Package mock_slack is a generated GoMock package.
 Package mock_slack is a generated GoMock package.
mock/sql
Package mock_sql is a generated GoMock package.
 Package mock_sql is a generated GoMock package.
mock/storage
Package mock_storage is a generated GoMock package.
 Package mock_storage is a generated GoMock package.
mock/tracker
Package mock_tracker is a generated GoMock package.
 Package mock_tracker is a generated GoMock package.
mock/translator
Package mock_translator is a generated GoMock package.
 Package mock_translator is a generated GoMock package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.