PRECIOUS(1)

📦
version 0.8.0+~0.2.1+20220602+~0.0.2 · 4 versions
, in ubuntu stonking

💅 PRECIOUS(1) — the precious lint glow-up

okay so bestie, welcome to PRECIOUS(1), filed under User Commands (which is giving "my lil corner of the manual, don't touch"). this is the page for precious lint, and it's literally here to ✨validate your paths against lint-checkers✨. yes we're doing this. periodt.

🦋 NAME

precious lint — validate path(s) against lint-checkers 💖

🌸 SYNOPSIS

precious lint [OPTIONS] <--all|--git|--staged|--git-diff-from
<REF>|--staged-with-stash|PATHS>

like,, you must pick one of those. no vibes-only invocations. the <--all|--git|--staged|--git-diff-from <REF>|--staged-with-stash|PATHS> thing is the main character of the whole line and it knows it.

✨ DESCRIPTION

Validate path(s) against lint-checkers. that's the whole job description and honestly? iconic.

🫶 Arguments:

  • [PATHS]... — a list of paths on which to operate. (plural, optional, the "..." is doing so much work here, we love a variable-length era.)

💅 OPTIONS

each one of these is a little gift. read them all, okay? no skimming, I see you.

  • --command <COMMAND> — the command to run. if you set this, only this command gets run, nobody else invited to the party. it should match the command name in your config file, so spell it right fr.
  • -a, --all — run against all files in the current directory and below. yes, all of them. the whole tree. the entire ecosystem.
  • -g, --git — run against files that have been modified according to git. git said "these ones changed" and we believe git.
  • -s, --staged — run against files that are staged for a git commit. your lil rehearsed lineup, ready to go on stage. 🎀
  • -d, --git-diff-from <REF> — run against files that are different as compared with the given <REF>. this <REF> can be a branch name, like master, or a ref name like HEAD~6 or master@{2.days.ago}. want more options? go read git help rev-parse, it's a whole world in there. note: this will _not_ see files with uncommitted changes in the local working directory — so like, don't be surprised when your unsaved lil guys don't show up. 🙈
  • -v, --verbose — enable verbose output. it's gonna talk more. go off king.
  • --debug — enable debugging output. for when verbose just isn't unhinged enough.
  • --staged-with-stash — run against file content that is staged for a git commit, stashing all unstaged content first.
⚠️ bestie listen to me: the stash push/pop tends to do weird things to the working directory, and is not recommended for scripting. this is the chaotic option. it's fun but it's a lot.
  • --label <LABEL> — if this is set, then only commands matching this label will be run. if this isn't set, then commands without a label or with the label "default" will be run. so basically: no label = you get the default girlies by default. 💜
  • --trace — enable tracing output (maximum logging). this is the most. the maximum. the peak. the sun at noon. 🌈
  • -h, --help — print help. (hi, that's this, you're here, you're doing great.)
  • -V, --version — print version. for when you need receipts on which era of precious you're in.

and that's the whole page!! no cap. every flag accounted for, every detail kept, nothing skipped, because we don't do that here. 🌟

as for the fine print: this lil masterpiece is precious lint 0.8.0+~0.2.1+2022..., dated June 2026, and it's the PRECIOUS(1) manual page. mwah 💋 go lint something, you absolute icon 🎀✨🦋

📦 where this page comes from