GIT-FAME(1)

📦 version 2.0.1, in fedora 43, fedora 44

✨ GIT-FAME(1) ✨

okay bestie, welcome to the git-fame manual page, and yes it's literally the main character of contributor stats 💅

🌸 NAME 🌸

git-fame — pretty-print git repository collaborators sorted by contributions. that's it. that's the whole vibe. your repo's whole group chat, ranked, looking cute 💖

🦋 SYNOPSIS 🦋

git-fame [--help | options] [<gitdir>...]

🎀 DESCRIPTION 🎀

go look at <https://github.com/casperdcl/git-fame>. that's the whole source of truth, no cap.

Probably not necessary on UNIX systems:

git config --global alias.fame "!python -m gitfame"

and like, for example, to print statistics regarding all source files in a C++/CUDA repository (*.c/h/t(pp), *.cu(h)), carefully handling whitespace and line copies:

git fame --incl '\.[cht][puh]{0,2}$' -twMC

obsessed with that command actually. -twMC is giving power user energy 🔥

👑 OPTIONS 👑

  • <gitdir> — Git directory [default: ./]. may be specified multiple times to aggregate across multiple repositories. yes you can stan several repos at once, she contains multitudes 🫶
  • -h, --help — print this help and exit. simple. iconic.
  • -v, --version — print module version and exit. no notes.
  • --branch=b — branch or tag [default: HEAD] up to which to check.
  • --sort=key — [default: loc]|commits|files|hours|months. pick your ranking metric bestie 🎀
  • --loc=type — surv(iving)|ins(ertions)|del(etions) — what loc actually represents. use ins,del to count both. defaults to surviving unless --cost is specified.
  • --excl=f — excluded files (default: None). in no-regex mode, may be a comma-separated list. escape (\,) for a literal comma (may require \\, in shell). the shell is dramatic like that 😭
  • --incl=f — included files [default: .*]. see --excl for format.
  • --since=date — date from which to check. can be absoulte (eg: 1970-01-31) or relative to now (eg: 3.weeks). time travel but make it git ✨
  • --cost=method — include time cost in person-months (COCOMO) or person-hours (based on commit times). Methods: month(s)|cocomo|hour(s)|commit(s). may be multiple comma-separated values. alters --loc default to imply ins (COCOMO) or ins,del (hours). lowkey the glow-up option fr fr
  • -R, --recurse — recursively find repositories & submodules within .
  • -n, --no-regex — assume are comma-separated exact matches rather than regular expressions [default: False]. NB: if regex is enabled , is equivalent to |.
  • -s, --silent-progress — suppress tqdm [default: False]. bye bye progress bar, you were doing amazing sweetie 💜
  • --warn-binary — don't silently skip files which appear to be binary data [default: False]. she will tell you, and honestly? good communication 🌈
  • -e, --show-email — show author email instead of name [default: False].
  • --enum — show row numbers [default: False].
  • -t, --bytype — show stats per file extension [default: False].
  • -w, --ignore-whitespace — ignore whitespace when comparing the parent's version and the child's to find where the lines came from [default: False]. -M detect intra-file line moves and copies [default: False]. -C detect inter-file line moves and copies [default: False]. the trio of truth 💅
  • --ignore-rev=rev — ignore changes made by the given revision (requires --loc=surviving).
  • --ignore-revs-file=f — ignore revisions listed in the given file (requires --loc=surviving).
  • --format=format — table format [default: pipe]|md|markdown|yaml|yml|json|csv|tsv|tabulate. may require git-fame[<format>], e.g. pip install git-fame[yaml]. any tabulate.tabulate_formats is also accepted. pick your aesthetic, all of them slay 🎀
  • --manpath=path — directory in which to install git-fame man pages.
  • --log=lvl — FATAL|CRITICAL|ERROR|WARN(ING)|[default: INFO]|DEBUG|NOTSET.

💖 AUTHORS 💖

Casper da Costa-Luis <https://github.com/casperdcl>. the founder, the icon, the moment 👑

real talk bestie: if something here is dangerous, deprecated, or straight-up undefined behaviour, treat it with the respect it deserves. i'm not making up new behaviour for you — everything above is exactly what the page says, just with more sparkle 💀✨

that's a wrap! this was the git-fame User Manuals page, git-fame era 2016-2023, and yes it's still called GIT-FAME(1) around here. go rank your contributors, you absolute legend 🦋🌸💅

📦 where this page comes from