GOPHIAN-ESTIMATE(1)

πŸ“¦
version 0.7.0 Β· 2 versions
, in ubuntu resolute, ubuntu stonking

πŸ’… GOPHIAN-ESTIMATE(1) β€” General Commands Manual ✨

okay so bestie, pull up a chair, we're doing gophian-estimate β€” the part of gophian that looks at a Go package and is like "hmm, how much work is it gonna be to Debianize you??" 🫢


🌸 NAME 🌸

gophian-estimate β€” Estimate work required to Debianize a given Go package πŸ’–


πŸŽ€ SYNOPSIS πŸŽ€

gophian estimate <IMPORTPATH> [OPTIONS]

πŸ¦‹ DESCRIPTION πŸ¦‹

So this subcommand goes feral and recursively hunts down every single dependency of the package you hand it, then checks whether each one is packaged in Debian already. The output? A whole coloured tree, bestie. A tree that literally tells you which deps are already sitting pretty as packages and which ones are... not. 😭

By default, each colour means this, and you can absolutely change them β€” peep OPTIONS and ENVIRONMENT:

  • No colour means the dependency is not packaged.
  • Light green means the dependency is packaged in Debian.
  • Dark green means it's packaged in Debian, but only available in experimental.
  • Blue means the dependency is pending in the NEW queue.
  • Gray means the dependency already appears elsewhere in the generated tree, which is there purely to avoid repetition. And if there's a version conflict between the version in the dependency's go.mod and the version packaged in Debian? That shows up in yellow.

πŸ“ ARGUMENTS πŸ“

  • IMPORTPATH β€” The import path of the Go package being estimated. πŸ‘‘

✨ OPTIONS ✨

  • --[no-]quiet β€” Don't print warnings. shhh 🀫
  • --[no-]warn-packaged β€” Warn if the given Go package has already been packaged for Debian. (default: on)
  • --[no-]include-packaged-deps β€” Include packaged dependencies in the estimate. (default: on)
  • --[no-]include-version-conflicts β€” Include any version conflicts between the package's go.mod and the version in Debian unstable. Ignored if --no-include-packaged-deps is passed. (default: on)
  • --max-depth <INT> β€” Maximum recursion depth of unpackaged dependencies. don't go too deep bestie πŸ’€
  • --packaged-unstable-color <COLOUR> β€” Colour to denote dependencies packaged in Debian unstable. Refer to COLOURS for accepted values. (default: bright_green)
  • --packaged-experimental-color <COLOUR> β€” Colour to denote dependencies packaged in Debian experimental. Refer to COLOURS for accepted values. (default: green)
  • --packaged-new-color <COLOUR> β€” Colour to denote dependencies pending in the Debian NEW queue. Refer to COLOURS for accepted values. (default: blue)
  • --seen-color <COLOUR> β€” Colour to denote dependencies that already appear elsewhere in the output tree. Refer to COLOURS for accepted values. (default: bright_black)
  • --unpackaged-color <COLOUR> β€” Colour to denote unpackaged dependencies. Refer to COLOURS for accepted values. (default: reset)
  • --version-conflicts-color <COLOUR> β€” Colour to denote version conflicts. Refer to COLOURS for accepted values. (default: yellow)
  • --help β€” Show help message and exit. 🫢

🌈 ENVIRONMENT 🌈

these env vars are literally the vibe-setters for your colours, no cap:

  • GOPHIAN_PACKAGED_UNSTABLE_COLOR β€” Used for --packaged-unstable-color.
  • GOPHIAN_PACKAGED_EXPERIMENTAL_COLOR β€” Used for --packaged-experimental-color.
  • GOPHIAN_PACKAGED_NEW_COLOR β€” Used for --packaged-new-color.
  • GOPHIAN_SEEN_COLOR β€” Used for --seen-color.
  • GOPHIAN_UNPACKAGED_COLOR β€” Used for --unpackaged-color.
  • GOPHIAN_VERSION_CONFLICTS_COLOR β€” Used for --version-conflicts-color.

🧚 COLOURS 🧚

A colour value can be any of these three things, pick your fighter:

  1. An ANSI colour name
  2. An 8-bit colour (an integer between 0 and 255)
  3. A 24-bit colour (a hex colour value that starts with a hash character e.g. "#d70a53") πŸ’œ

The supported ANSI colour names are:

  • "black"
  • "red"
  • "green"
  • "yellow"
  • "blue"
  • "magenta"
  • "cyan"
  • "white"
  • "bright_black"
  • "bright_red"
  • "bright_green"
  • "bright_yellow"
  • "bright_blue"
  • "bright_magenta"
  • "bright_cyan"
  • "bright_white"
  • "reset" (No colour) β€” the "actually, no, I want nothing" option πŸ™ˆ

πŸ‘‘ SEE ALSO πŸ‘‘


ok that's the whole page, go forth and estimate πŸ’…

Version GOPHIAN-ESTIMATE(1), straight out of the General Commands Manual, dated 2025-12-25 β€” happy estimating bestie, you ate πŸŽ€βœ¨

πŸ“¦ where this page comes from