Development

Prerequisites

• Go 1.25+
• Make (optional, for convenience)
• golangci-lint v2+ (for linting)

Clone & Build

git clone https://github.com/nassiharel/klim.git
cd klim
make build

The binary is output to bin/klim with version/commit/date injected via ldflags.

Commands

Command	Description
make all	Lint + test + build (default target)
make build	Build bin/klim with version ldflags
make test	Run tests with race detector (go test -race -count=1 ./...)
make lint	Run golangci-lint
make cover	Generate HTML coverage report
make marketplace-validate	Validate marketplace tool/pack YAML files
make marketplace-assemble	Assemble individual files → marketplace.yaml

Testing

Tests use standard Go testing patterns:

• Table-driven tests for systematic coverage
• httptest.NewServer for HTTP endpoint testing
• t.TempDir() for filesystem tests
• In-memory archives for testing extraction
• atomic.Pointer for pmAvailableFunc test hooks

# Run all tests
make test

# Run tests for a specific package
go test ./internal/catalog/...

# Run with verbose output
go test -v ./internal/pkgmgr/...

Integration Tests

An opt-in integration test suite live-checks every marketplace package ID against real package managers:

# Runs against whatever PMs are on your PATH
go test -tags=integration -timeout=40m ./internal/marketplace/livecheck/...

This is also run weekly in CI across Linux/macOS/Windows runners.

Linting

make lint
# or directly
golangci-lint run

CI enforces gofmt, go vet, and golangci-lint on every PR.

CI Workflows

Workflow	Trigger	What it does
ci.yml	push/PR	Lint, test (Linux/macOS/Windows matrix), govulncheck
marketplace.yml	push/PR (marketplace/**)	Validate, assemble, publish catalog
marketplace-livecheck.yml	Weekly/manual	Live-check package IDs across all PMs
release.yml	v* tag	GoReleaser → release, Homebrew tap, deb/rpm, SBOM
codeql.yml	push/weekly	Security analysis

Project Structure

See the Architecture page for the full module layout and data flow.