boost

Boost

Overview

Boost is a modular and extensible framework for Go application development, designed to simplify the creation of robust, scalable, and observable services. The framework provides a comprehensive set of components that can be used independently or combined to build complete applications.

Key Features

• Modular Architecture: Independent components that can be used as needed
• Dependency Injection: Flexible system for managing dependencies between components
• Integrated Observability: Native support for metrics, logging, and tracing
• Adapters for Popular Libraries: Consistent wrappers for various libraries in the Go ecosystem
• Design Patterns: Implementations of patterns such as Factory, Middleware, and Wrapper
• CloudEvents Support: Native integration with the CloudEvents standard
• Extensibility: Easy to add support for new libraries and frameworks

Project Structure

The project is organized into modular packages, each with specific responsibilities:

• annotation: Annotations read from Go doc comments (// @Name(key=value))
• bootstrap: Components for application initialization
• builder: Generator of REST, gRPC, MCP and function doors from @REST/@GRPC/@MCP/@Function annotations, on top of inject
• examples: Framework usage examples
• extra: Additional functionalities (health checks, middleware, multiserver)
• factory: Factory pattern implementations for various components
• fx: Dependency injection and lifecycle management
• inject: Generator of fx modules from @Provide/@Inject/@Invoke annotations
• model: Data structures and interfaces definitions
• utils: Various utilities
• wrapper: Adapters for external libraries (cache, config, log, publisher)

Getting Started

Prerequisites

• Go 1.18 or higher
• Specific dependencies vary according to the components used

Installation

go get github.com/xgodev/boost

Basic Example

package main

import (
	"github.com/xgodev/boost"
	"github.com/xgodev/boost/factory/contrib/go.uber.org/zap/v1"
	"github.com/xgodev/boost/wrapper/log"
	"os"
)

func init() {
	os.Setenv("BOOST_FACTORY_ZAP_CONSOLE_FORMATTER", "JSON")
	os.Setenv("BOOST_FACTORY_ZAP_CONSOLE_LEVEL", "DEBUG")
}

func main() {
	boost.Start()
	log.Set(zap.NewLogger())
	log.Infof("hello world!!")
}

Claude Code plugin

AI agents get boost-shaped Go guidance (Iron Laws, Echo APIs, event-driven functions, contrib layout) plus the Quality Gate through the all-in-one claude-plugin@xgodev plugin (repo xgodev/claude-plugin). Install once in your Claude Code session:

/plugin marketplace add xgodev/claude-plugin
/plugin install claude-plugin@xgodev

The plugin is maintained in its own repo; this framework repo ships no plugin skills or marketplace.

Main Components

Bootstrap

The Bootstrap package provides components for application initialization, including support for serverless functions and event processing.

Bootstrap Documentation

Factory

The Factory package implements the Factory design pattern for various components, facilitating the creation and configuration of complex objects.

Factory Documentation

Wrapper

The Wrapper package provides adapters for external libraries, including cache, configuration, logging, and message publishing.

Wrapper Documentation

FX

The FX package provides dependency injection and component lifecycle management functionalities.

FX Documentation

Annotation

The Annotation package collects // @Name(key=value) annotations from Go doc comments and returns the annotated structs, methods and functions, for code generators to build on.

Annotation Documentation

Inject

The Inject package generates fx modules from @Provide, @Inject and @Invoke comment annotations, checking the dependency graph at generation time.

Inject Documentation

Builder

The Builder package generates the doors of an application (REST routes on echo, gRPC services, MCP tools and the event function) from @REST, @GRPC, @MCP and @Function annotations, one Modules() and the main of every app, on top of inject.

Builder Documentation

Extra

The Extra package includes additional functionalities such as health checks, middleware, and support for multiple servers.

Extra Documentation

Integration with Popular Technologies

Boost offers extensive integrations with a wide range of technologies:

Cloud Providers

• AWS: AWS SDK integration for various services
• Google Cloud Platform:
  • Pub/Sub
  • BigQuery
  • Firestore
  • API integration
  • gRPC

Databases

• MongoDB: Native driver integration
• PostgreSQL: pgx driver
• Oracle: godror driver
• CockroachDB: Compatible with PostgreSQL drivers
• Cassandra: gocql driver
• BuntDB: In-memory key/value database
• MemDB: In-memory database with immutable radix tree

Caching

• Redis: go-redis client
• BigCache: In-memory caching system
• FreeCache: Zero GC cache library

Messaging & Event Systems

• NATS: Lightweight messaging system
• Kafka: Confluent Kafka Go client
• CloudEvents: SDK for CloudEvents standard
• Go Cloud Pub/Sub: Cloud-agnostic pub/sub API

Web & API

• Echo: High performance web framework
• gRPC: High performance RPC framework
• GraphQL: GraphQL server implementation
• Swagger: API documentation with echo-swagger

Observability

• Prometheus: Metrics and monitoring
• OpenTelemetry: Observability framework
• Datadog: APM and monitoring
• Zap: Structured logging
• Zerolog: Zero-allocation JSON logger
• Logrus: Structured logger

Configuration

• Koanf: Lightweight, extensible configuration management
• Cobra: CLI application library
• Viper: Configuration solution (via Koanf)

Resilience & Patterns

• Hystrix: Latency and fault tolerance library
• Ants: Goroutine pool
• FTP: FTP client
• Kubernetes: Client-go integration
• Vault: HashiCorp Vault client

Serialization

• JSON: Multiple implementations (standard, go-json)
• MessagePack: Binary serialization
• GOB: Go's native binary format

Contributing

Contributions are welcome! To contribute:

1. Fork the repository
2. Create a branch for your feature (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the terms included in the LICENSE file.

Contact

For questions, suggestions, or contributions, please open an issue in the GitHub repository.

Developed with ❤️ by the xgodev community.