lib

lib

Shared Go libraries for AltSoyuz projects. Single Go module (github.com/AltSoyuz/lib), one importable package per top-level directory.

These packages were extracted from the homeapp SaaS template so that other apps (shadcnsvelte, exploreassistant, …) can consume them via standard go get instead of a replace directive.

Philosophy

Inspired by VictoriaMetrics' approach to library code:

• Minimal external dependencies. Adding a dep requires justification.
• Stable APIs. Breaking changes bump the minor version (pre-1.0) or require a /v2 module path (post-1.0). No silent breakage.
• Tests are mandatory. Every package ships with *_test.go. CI runs go test -race ./... and go vet ./... on every push/PR.
• No frameworks, no magic. Plain net/http, plain database/sql, log/slog. Composition over inheritance.
• Read the code. Each package fits in your head. Read the source before reaching for docs.

Packages

Install

go get github.com/AltSoyuz/lib@latest

Then import the packages you need:

import (
    "github.com/AltSoyuz/lib/httpserver"
    "github.com/AltSoyuz/lib/logger"
)

Versioning

Standard Go module semver. Tags are vMAJOR.MINOR.PATCH. While the module is v0.x.y the API may change between minor versions; breaking changes will be called out in CHANGELOG.md.

Contributing

See CONTRIBUTING.md.

License

MIT