golf

Golf - Go Library and Framework

A collection of packages for building robust web applications in Go with built-in resilience patterns, authentication, and comprehensive logging.

Quick Start

go get github.com/mariusfa/golf

import (
    "github.com/mariusfa/golf/middleware"
    "github.com/mariusfa/golf/health"
)

func main() {
    router := http.NewServeMux()
    
    // Health check
    health.RegisterRoute(router)
    
    // Protected routes
    authParams := middleware.NewAuthParams(jwtSecret, userRepo)
    router.Handle("GET /api/users", middleware.PrivateRoute(getUsersHandler, authParams))
    
    // Public routes  
    router.Handle("GET /api/health", middleware.PublicRoute(healthHandler))
    
    http.ListenAndServe(":8080", router)
}

Core Packages

Key Features

• Resilience: Circuit breaker and bulkhead patterns in HTTP client
• Authentication: JWT-based auth with middleware integration
• Database: Template-based migrations with baseline/standard strategy
• Logging: Structured JSON logging with multiple specialized loggers
• Configuration: Automatic struct field to environment variable mapping
• Testing: Comprehensive testcontainers support

Examples & Development

• Examples: golf-examples
• Run tests: go test ./...
• Format code: go fmt ./...
• Tasks: See TODO.md

Versioning

Currently using minor versions regardless of breaking changes. Will switch to semantic versioning when stable.