oresoftware / fame

Command line tool to display git log information by user/commiter. :tickets:

🎟 Fame - a tool for displaying git log information by author

- Fame Fame Fame Fame Fame Fame Fame Fame Fame Fame Fame Fame Fame Fame Fame Fame Fame Fame Fame Fame

This command line tool is similar to git fame, but this is much faster. People were complaining that the ruby/python tools were too slow, so I wrote this.

Installation

$ npm install -g fame

For latest version, use: npm view fame version

---

---

Basic Usage

By default, a table is printed to the console. If you want JSON output, use the --json flag.

fame --json

Info for all commits by "alex"

fame --author=alex

Info for all commits on dev branch by a particular author

fame --branch=dev --author=alex

Info for all commits for multiple authors

fame --author=donnie --author=ronnie --author=jonnie

---

More options

Handling multiple email addresses for same person.

fame --add-user <display name> -e <email> 

now, when fame runs at the command line, it will pick up the info from this file ($HOME/fame.conf.json), to combine info from the different emails.

You can add multiple emails like so:

fame -u <display name> -e <email> -e <email> 

Sorting with --order and --sort options

You can sort using the --sort and --order options.

For example:

fame --sort=1 --order=asc  # will sort by the the 2nd column, ascending
fame --sort=2,3 --order=desc  # will sort by the the 3rd and 4th column, with the 3rd column the priority

Or for example, instead of numbers you can also just use the name (case-insensitive) of the column:

fame --sort='added lines, files modified' --order=asc

Comma-separated list, case-insensitive and whitespace-insensitive

Matching on files (ignoring files too)

Info for all matching files

fame --match='\.js'

---

Info for all files that end with

fame --extension='.js'  # better to just use the regex option tho

---

Example

To match all .ts files but no .d.ts files, you would do:

fame --match='\.ts$'  --not-match='\.d\.ts$'

Remember these strings are passed to new RegExp() so have to escpae the . etc.

Basic command line table output looks like this:

Command line JSON output looks like this:

fame's Issues

why would fame not process all commits?

I'm sorry that I open an issue for a support question, but I couldn't find a forum or a support email. But maybe it's a bug, who knows.

For one of my repos, I get the following output:

$ fame
fame: SHA/Branch: HEAD
fame: Files must match at least one of: [ /.*/ ]
fame: Full branch name: master
fame: processing commit no.: 101, finished: 98.06%

[snip]

But github tells me there are 103 commits and git rev-list --count HEAD also returns 103.

Question: what's the meaning of net lines added

Question: what's the meaning of net lines added

fame should default to HEAD

right now it defaults to master, but it should default to HEAD instead.

show names instead of email addresses

I really like your tool. It's very fast.

The only thing I'm missing is to see the authors' names instead of the email addresses.
Any chance you could add an option for that?

Installation fails on Windows.

Running npm install -g fame fails on my x64 Windows 11 machine:

Add sorting to the output

I would like to be able to sort the table output by any of the columns.

use puppeteer to open results in browser

page.setContent

puppeteer/puppeteer#2398 (comment)

add fame --version

fame cli is missing the implementation for --version

If an argument is passed to fame, fame ignores it

In the case of:

fame dev

fame just ignores the dev argument

but it should treat fame dev as

fame --branch=dev