Gokit is a comprehensive Go toolkit designed to simplify the development of cloud-native applications. It provides a wide range of features and utilities for logging, observability, messaging, database integration, configuration management, and more. Whether you're a seasoned Go developer or just getting started with cloud-native development, Gokit aims to streamline your workflow and enhance the reliability and efficiency of your applications.
- Configuration Management: Flexible configuration system with environment-based loading and validation
- Logging: Structured logging with multiple output formats and levels
- Observability:
- OpenTelemetry integration for distributed tracing
- Prometheus metrics for monitoring and analysis
- Messaging:
- MQTT client for IoT and pub/sub messaging
- RabbitMQ integration for message queuing
- Kafka support for event streaming
- Database:
- SQL database integration with connection pooling
- Migration tools for schema management
- HTTP: Lightweight HTTP server and client utilities
- Authentication: Identity and authorization utilities
- Secrets Management: Secure handling of sensitive configuration
- Utilities:
- GUID generation and manipulation
- Health check endpoints
Some packages require additional system dependencies:
# Ubuntu/Debian
sudo apt install libssl-dev build-essential cmake pkg-config llvm-dev libclang-dev clang libmosquitto-dev sqlite3
# CentOS/RHEL
sudo yum install openssl-devel gcc cmake pkg-config llvm-devel clang-devel clang mosquitto-devel sqliteAdd Gokit to your project:
# Install the entire toolkit
go get -u github.com/ralvescosta/gokit
# Or install specific packages as needed
go get -u github.com/ralvescosta/gokit/logging
go get -u github.com/ralvescosta/gokit/metrics
go get -u github.com/ralvescosta/gokit/mqttHere's a simple example of using Gokit's configuration and logging packages:
package main
import (
"github.com/ralvescosta/gokit/configs_builder"
"github.com/ralvescosta/gokit/logging"
)
func main() {
// Build configuration
cfg, err := configs_builder.NewConfigsBuilder().
HTTP().
Metrics().
Build()
if err != nil {
panic(err)
}
// Initialize logger
logger := cfg.Logger
logger.Info("Application started")
// Use other Gokit packages...
}Gokit is organized into the following packages:
- auth: Authentication and authorization utilities
- configs: Configuration structures and types
- configs_builder: Configuration builder pattern implementation
- guid: UUID generation and manipulation
- httpw: HTTP wrapper utilities
- kafka: Kafka client integration
- logging: Structured logging utilities
- messaging: Abstractions for messaging brokers like MQTT, RabbitMQ and Kafka
- metrics: Prometheus and OpenTelemetry integration.
- mqtt: MQTT client implementation
- rabbitmq: RabbitMQ client integration
- secrets_manager: Secure secrets management
- sql: SQL database utilities and migrations
- tiny_http: Lightweight HTTP server
- tracing: OpenTelemetry tracing integration
Check out our examples repository for complete working examples of Gokit in action, including:
- RabbitMQ publisher and consumer
- HTTP server with metrics and tracing
- Configuration management with environment variables
- Database migrations and queries
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Gokit is released under the MIT License. See the LICENSE file for details.
If you have questions, encounter issues, or want to discuss ideas, please:
- Open an issue on the GitHub Issues page
- Check the documentation for detailed API information
- Visit our examples repository for usage examples