Skip to content

pablontiv/picokit

picokit

A zero-dependency Go module providing small, focused utility packages.

Module path: github.com/pablontiv/picokit

Packages

Package Description
autoupdate Parameterized staged async binary updater
coverage Go coverage profile parser and per-package floor checker
diag Diagnostic utilities for system and environment inspection
diff Utilities for computing and comparing differences
fuzzy Fuzzy matching and searching algorithms
hashfile Utilities for computing and verifying file hashes
output Output formatting and presentation utilities
pathsec Path security and validation utilities

Features

  • Zero external dependencies — each package imports only the Go standard library
  • Small and focused — each package solves a specific problem
  • Well-tested — 85%+ coverage on all packages
  • Community-friendly — clear APIs, comprehensive docs, and maintainable code

Getting Started

go get github.com/pablontiv/picokit

Then import the packages you need:

import "github.com/pablontiv/picokit/pathsec"

Coverage tooling

picokit ships pkcov, a CLI that implements coverage-spec v1.1 — a uniform 85% floor policy applied automatically to every package in the module.

# Build the tool
go build -o pkcov ./cmd/pkcov/

# Per-package report
pkcov report --profile coverage.out --module github.com/pablontiv/picokit

# Gate (exits 1 on violations)
pkcov check --floors .coverage-floors.toml --module github.com/pablontiv/picokit

# Machine-readable output
pkcov check --output json ...

Minimal .coverage-floors.toml (v1.1 — no packages list needed):

default = 85
# exclude = ["cmd/experimental"]  # optional, with justification

Repos that adopt this policy declare compliance in their CLAUDE.md:

Coverage policy: complies with github.com/pablontiv/picokit coverage-spec v1.1

See docs/coverage-spec.md for the full contract.

Contributing

See CONTRIBUTING.md for development setup and workflow.

License

picokit is licensed under the PolyForm Noncommercial License 1.0.0. See LICENSE for terms.

Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

About

Small, zero-dependency Go utility packages

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages