gritpack go

Set up Go for the hub, and package and publish Go modules

Generated from gritpack go --helpGritpack 1.2.63
gritpack go [OPTIONS] <COMMAND>

Commands

pack
Make a package file from a Go module's source, without building it
import
Make a package file from a module's .info, .mod and .zip proxy files
verify
Check a Go module package file without publishing it
publish
Publish a Go module package file to the hub
setup
Set up the go command to fetch modules from the hub, with credentials
doctor
Check the go command, its settings, credentials and the hub's proxy

Options

-h, --helpPrint help

gritpack go pack

Make a package file from a Go module's source, without building it

gritpack go pack [OPTIONS] --version <VERSION> --published-at <TIME> --output <OUTPUT>

Options

--path <PATH>Directory containing the module's go.mod and source filesDefault: .
--version <VERSION>Module version, with its leading v, such as v1.2.0
--published-at <TIME>Publication time recorded in the module's .info file, as RFC 3339
--output <OUTPUT>Where to write the package file
-h, --helpPrint help

gritpack go import

Make a package file from a module's .info, .mod and .zip proxy files

gritpack go import [OPTIONS] --module <MODULE> --version <VERSION> --info <INFO> --mod <MOD_FILE> --zip <ZIP> --output <OUTPUT>

Options

--module <MODULE>Module path, as in the go.mod module line
--version <VERSION>Module version, with its leading v, such as v1.2.0
--info <INFO>The version's .info file from a Go module proxy
--mod <MOD_FILE>The version's .mod file from a Go module proxy
--zip <ZIP>The version's .zip file from a Go module proxy
--output <OUTPUT>Where to write the package file
-h, --helpPrint help

gritpack go verify

Check a Go module package file without publishing it

gritpack go verify [OPTIONS] <PACKAGE_FILE>

Arguments

<PACKAGE_FILE>Package file made by gritpack go pack or gritpack go import

Options

-h, --helpPrint help

gritpack go publish

Publish a Go module package file to the hub

gritpack go publish [OPTIONS] <PACKAGE_FILE>

Arguments

<PACKAGE_FILE>Package file made by gritpack go pack or gritpack go import

Options

-h, --helpPrint help (see a summary with '-h')

Hub connection

--hub <HUB>The hub, as host[:port] or https://host[:port]Environment: GRITPACK_SERVER
--cert <CERT>Client certificate for the hubEnvironment: GRITPACK_CERT
--key <KEY>Private key for the client certificateEnvironment: GRITPACK_KEY
--ca <CA>Certificate authority used to authenticate the hubEnvironment: GRITPACK_CA
--profile <PROFILE>Login profile to use; cannot be combined with --hub, --cert, --key or --caEnvironment: GRITPACK_PROFILE
--config <CONFIG>Profile configuration fileEnvironment: GRITPACK_CONFIG · Default: ~/.frogfish/gritpack/config.toml
--credentials-dir <CREDENTIALS_DIR>With --hub alone: directory searched for your login; exactly one may be unexpiredEnvironment: GRITPACK_CREDENTIALS_DIR · Default: ~/.frogfish/gritpack/credentials
--cache-dir <CACHE_DIR>Directory of the shared cache of downloaded package filesEnvironment: GRITPACK_CACHE_DIR · Default: ~/.frogfish/gritpack/cache
--jobs <JOBS>How many package downloads to run at once (1-64)Environment: GRITPACK_JOBS · Default: 4

gritpack go setup

Set up the go command to fetch modules from the hub, with credentials

gritpack go setup [OPTIONS] --proxy <PROXY> --private-prefix <PRIVATE_PREFIX>

Options

--proxy <PROXY>The hub's Go proxy URL, normally ending in /go
--private-prefix <PRIVATE_PREFIX>Module path prefix or pattern kept out of the public checksum database
--no-public-fallbackUse only the hub, without proxy.golang.org as a fallback
--profile <PROFILE>Login profile whose credentials the go command uses; default the default login
--config <CONFIG>Profile configuration fileEnvironment: GRITPACK_CONFIG · Default: ~/.frogfish/gritpack/config.toml
--go <GO>go program whose saved settings are changedDefault: go
--format <FORMAT>Output format: human or jsonDefault: human · Values: human, json
--json[=<FIELDS>]Same as --format json; --json=name,version keeps only those fields
--jq <EXPRESSION>Print the JSON output through a jq expression, strings unquoted
-h, --helpPrint help

gritpack go doctor

Check the go command, its settings, credentials and the hub's proxy

gritpack go doctor [OPTIONS] --proxy <PROXY> --private-prefix <PRIVATE_PREFIX>

Options

--proxy <PROXY>The hub's Go proxy URL, normally ending in /go
--private-prefix <PRIVATE_PREFIX>Module path prefix or pattern expected in GONOSUMDB
--profile <PROFILE>Login profile whose credentials the go command uses; default the default login
--config <CONFIG>Profile configuration fileEnvironment: GRITPACK_CONFIG · Default: ~/.frogfish/gritpack/config.toml
--go <GO>go program to checkDefault: go
--format <FORMAT>Output format: human or jsonDefault: human · Values: human, json
--json[=<FIELDS>]Same as --format json; --json=name,version keeps only those fields
--jq <EXPRESSION>Print the JSON output through a jq expression, strings unquoted
-h, --helpPrint help