golusoris¶
A composable Go framework built around go.uber.org/fx. Pick the modules your app needs — nothing else ships.
import (
"github.com/golusoris/golusoris"
"github.com/golusoris/golusoris/otel"
)
fx.New(
golusoris.Core, // config · log · clock · id · validate · crypto
golusoris.DB, // pgx pool · migrate
otel.Module, // tracer · meter · logs · OTLP exporter
golusoris.HTTP, // chi router · HTTP server
golusoris.K8s, // pod metadata · Kubernetes client
golusoris.Jobs, // river client · worker registry
golusoris.CacheRedis, // rueidis distributed cache
// ... add what you need
).Run()
The default core/config.Module reads APP_ environment variables through
koanf. Applications can opt into YAML or JSON files; packages without
configuration expose constructors or options directly.
Documentation map¶
- Contributing — Conventional Commits, DCO sign-off, CI gates, local dev commands, git hooks, and the release process.
- Principles — coding and assurance contract (Power-of-10, SEI CERT, Google Go Style, RFC 9457, and evidence-backed supply-chain controls).
- Architecture Decisions — Nygard-format ADRs, one per decision.
- Architecture — C4 diagrams for the system.
- Migration Guides — current constructor, atomic-store, secure-default, lifecycle, and resource-bound upgrades; older guides remain in navigation.
- Capability contract — every package → capability keys → replaced modules; what praetor
needsresolves against. - Licensing — EUPL-1.2 code, CC-BY-SA-4.0 prose, REUSE, DCO.
- Governance — project scope, decision process, and maintainer roles.
- Security — supported versions and how to report a vulnerability.
- Upstream Snapshots — version-pinned API references for the framework's dependencies.
- CI / Downstream Consumption — how apps consume
tools/Makefile.sharedand the reusable GitHub Actions workflows.
The source lives on GitHub.