README
¶
crates
Browse the crates.io Rust package registry
crates is a single pure-Go binary. It speaks to cratesio over plain
HTTPS, shapes the responses into clean records, and pipes into the rest of your
tools. No API key, nothing to run alongside it.
Install
go install github.com/tamnd/cratesio-cli/cmd/crates@latest
Or grab a prebuilt binary from the releases, or run the container image:
docker run --rm ghcr.io/tamnd/crates:latest --help
Usage
crates --help
crates version
This is a fresh scaffold. The command tree starts with version; build out the
real commands in cli/ on top of the cratesio library package.
Development
cmd/crates/ thin main, wires cli.Root into fang
cli/ the cobra command tree
cratesio/ the library: HTTP client and data models
docs/ tago documentation site
make build # ./bin/crates
make test # go test ./...
make vet # go vet ./...
Releasing
Push a version tag and GitHub Actions runs GoReleaser, which builds the archives, Linux packages, the multi-arch GHCR image, checksums, SBOMs, and a cosign signature:
git tag v0.1.0
git push --tags
The Homebrew and Scoop steps self-disable until their tokens exist, so the first release works with no extra secrets.
License
Apache-2.0. See LICENSE.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package cli builds the crates command tree on top of the cratesio library.
|
Package cli builds the crates command tree on top of the cratesio library. |
|
cmd
|
|
|
crates
command
Command crates is a single-binary command line for cratesio.
|
Command crates is a single-binary command line for cratesio. |
|
Package cratesio is the library behind the crates command: the HTTP client, request shaping, and the typed data models for crates.io.
|
Package cratesio is the library behind the crates command: the HTTP client, request shaping, and the typed data models for crates.io. |
|
pkg
|
|
|
render
Package render turns slices of record structs into one of the output formats hackernews-cli supports: table, json, jsonl, csv, tsv, url, and raw.
|
Package render turns slices of record structs into one of the output formats hackernews-cli supports: table, json, jsonl, csv, tsv, url, and raw. |