转载

[工具资源] 一个用来统计项目中每个成员贡献代码量的小工具

GitFame

Pretty-print collaborators sorted by contributions.

Output

Total number of files: 2,053 Total number of lines: 63,132 Total number of commits: 4,330  +------------------------+--------+---------+-------+--------------------+ | name                   | loc    | commits | files | distribution       | +------------------------+--------+---------+-------+--------------------+ | Johan Sørensen         | 22,272 | 1,814   | 414   | 35.3 / 41.9 / 20.2 | | Marius Mathiesen       | 10,387 | 502     | 229   | 16.5 / 11.6 / 11.2 | | Jesper Josefsson       | 9,689  | 519     | 191   | 15.3 / 12.0 / 9.3  | | Ole Martin Kristiansen | 6,632  | 24      | 60    | 10.5 / 0.6 / 2.9   | | Linus Oleander         | 5,769  | 705     | 277   | 9.1 / 16.3 / 13.5  | | Fabio Akita            | 2,122  | 24      | 60    | 3.4 / 0.6 / 2.9    | | August Lilleaas        | 1,572  | 123     | 63    | 2.5 / 2.8 / 3.1    | | David A. Cuadrado      | 731    | 111     | 35    | 1.2 / 2.6 / 1.7    | | Jonas Ängeslevä        | 705    | 148     | 51    | 1.1 / 3.4 / 2.5    | | Diego Algorta          | 650    | 6       | 5     | 1.0 / 0.1 / 0.2    | | Arash Rouhani          | 629    | 95      | 31    | 1.0 / 2.2 / 1.5    | | Sofia Larsson          | 595    | 70      | 77    | 0.9 / 1.6 / 3.8    | | Tor Arne Vestbø        | 527    | 51      | 97    | 0.8 / 1.2 / 4.7    | | spontus                | 339    | 18      | 42    | 0.5 / 0.4 / 2.0    | | Pontus                 | 225    | 49      | 34    | 0.4 / 1.1 / 1.7    | +------------------------+--------+---------+-------+--------------------+

Installation

[sudo] gem install git_fame

Usage

Console

Start by navigating to a git repository.

Run git fame to generate output as above.

Options

git fame --bytype Should a breakout of line counts by file type be output? Default is false .
git fame --exclude=paths/to/files,paths/to/other/files Comma separated, realtive paths to exclude from the counts. Note that you should not start the paths with a dot. Default is none.
git fame --sort=loc Order table by loc . Available options are: loc , commits and files . Default is loc .
git fame --progressbar=1 Should a progressbar be visible during the calculation? Default is 1 .
git fame --whitespace Ignore whitespace changes when blaming files. Default is false .
git fame --repository=/path/to/repo Git repository to be used. Default is the current folder.
git fame --branch=master Branch to run on. Default is master .
git fame --format=output Output format. Default is pretty . Additional: csv.

Class

Want to work with the data before printing it?

Constructor arguments

repository (String) Path to repository.
sort (String) What should #authors be sorted by? Available options are: loc , commits and files . Default is loc .
progressbar (Boolean) Should a progressbar be shown during the calculation? Default is false .
whitespace (Boolean) Ignore whitespace changes when blaming files. Default is false .
bytype (Boolean) Should a breakout of line counts by file type be output? Default is 'false'
exclude (String) Comma separated paths to exclude from the counts. Default is none.
branch (String) Branch to run on. Default is master .
format (String) Output format. Default is pretty .

repository = GitFame::Base.new({   sort: "loc",   repository: "/tmp/repo",   progressbar: false,   whitespace: false   bytype: false,   exclude: "vendor, public/assets",   branch: "master",   format: "pretty" })

Print table to console

repository.pretty_puts

Print csv table to console

repository.csv_puts

Statistics

GitFame

repository.loc (Fixnum) Total number of lines.
repository.commits (Fixnum) Total number of commits.
repository.files (Fixnum) Total number of files.
repository.authors (Array< Author >) All authors.

Author

author = repository.authors.first

Formated
- author.loc (String) Number of lines.
- author.commits (String) Number of commits.
- author.files (String) Number of files changed.
Non formated
- author.distribution (String) Distribution (in %) between users (loc/commits/files)
- author.raw_loc (Fixnum) Number of lines.
- author.raw_commits (Fixnum) Number of commits.
- author.raw_files (Fixnum) Number of files changed.
- author.file_type_counts (Array) File types (k) and loc (v)

A note about authors found

The list of authors may include duplicate people. If a git user's configured name or email address change over time, the person will appear multiple times in this list (and your repo's git history). Git allows you to configure this using the .mailmap feature. See git shortlog --help for more information.