utils

README

egl-utils-go

Production-ready Go utilities for concurrency, resilience, HTTP middleware, configuration, and observability.

Part of the Enterprise-Grade Libraries series. A library written in Go 1.24+, built and governed to an enterprise quality bar: full CI matrix, static analysis, sanitizers, documented design decisions, and SemVer releases.

What it is

Provide a production-ready Go utilities module — advanced concurrency primitives, resilience patterns, high-performance HTTP middleware, and API-development helpers — that removes boilerplate and correctness risk (goroutine leaks, GC pressure, unsafe shutdown) from Go backend services. Design philosophy (imported from the brief): idiomatic Go throughout (channels, context.Context, the error interface); zero goroutine leaks — every internal goroutine stops deterministically via context or close(done); allocation-conscious hot paths via pointer discipline and sync.Pool object reuse.

The frozen specification is in docs/specs/01_spec_utils.md.

Build, test, run

go build ./...
go test ./...

• Toolchain: go build (go modules), go test (+ testify; rapid for property tests), gofumpt (gofmt superset), golangci-lint (govet, staticcheck, errcheck, revive, gosec).
• Supported platforms: Linux / Windows / macOS on Go 1.25 & 1.26 (module floor 1.24).
• Consumers import the public surface via: import "github.com/danielPoloWork/egl-utils-go/workerpool".

See docs/development/local-build.md for the full local setup.

How this project is run

Document	Purpose
AGENTS.md	How AI agents (and humans) work in this repo — the contract.
ROADMAP.md	The numbered plan and what is done.
docs/adr/	Why it is built the way it is (Architecture Decision Records).
docs/patterns/	Design patterns adopted, rejected, or considered.
docs/workflow/	Git, documentation, release, and maintenance conventions.
CHANGELOG.md	User-visible changes per release.
SECURITY.md	How to report a vulnerability.

Milestones

#	Title	Status
1	Project bootstrap & CI	✅ done
2	Concurrency primitives	⏳ planned
3	Resilience patterns	⏳ planned
4	HTTP middleware	⏳ planned
5	Configuration & environment	⏳ planned
6	Structured logging	⏳ planned
7	Caching & data helpers	⏳ planned
8	Validation & security	⏳ planned
9	Diagnostics & lifecycle	⏳ planned

License

MIT © 2026 Daniel Polo. See LICENSE.

Documentation

Overview

Package utils is the root of the egl-utils-go module: production-ready Go utilities for concurrency, resilience, HTTP middleware, configuration, and observability, delivered as small, orthogonal feature packages that compose through standard-library contracts (context.Context, net/http.Handler, error) only.

The root package carries module-wide metadata such as Version. Feature packages live in their own directories at the module root and are imported individually, e.g.

import "github.com/danielPoloWork/egl-utils-go/workerpool"

The layout is decided in ADR-0003 (docs/adr/0003-adopt-idiomatic-go-root-layout.md).

Index

• Constants

Constants

const Version = "0.1.0"

Version is the module's current Semantic Version. It is the source of truth the README status badge and release tags must stay in lockstep with (enforced by tools/consistency_lint.py; release protocol in AGENTS.md §11).