Walrus

A multi-repo Git query tool

Purpose

I spend a fair amount of time tracking down the what and when of my daily activities. Usually this searching spans many (10+) repositories which means the task is boring and tedious. Walrus tool aims to automate the discovery of git commits based on date, author, and other criteria.

Goals

We don't want to reinvent libgit2sharp, we just want a simple query interface specific to commit messages. We don't care about diffs, code content, or even the change sets. For this reason, Gitbase was found to be entirely overkill even though it is pretty rad. It is a fantastic tool and I do make use of it but managing it is kind of a pain. For this reason, the overarching goal of this project is simplicity with the ability to opt-in to complexity when needed.

Getting Started

This utility should be used as a dotnet tool. See tools/install_as_tool.ps1 for how to build and install Walrus on your system.

# Windows
.\tools\install_as_tool.ps1

# Not Windows
bash tools/install_as_tool.ps1

To query multiple roots or query from any location, you will need to setup a simple JSON config file. This can be specified as an env WALRUS_CONFIG_FILE or a file named walrus.json placed in your current working directory. The contents should look something like this is:

{
  "DirectoryScanDepth": 3,
  "RepositoryRoots": [
    "H:\\code"
  ],
  "AuthorAliases": {
      "illyum": [
          "[email protected]",
          "[email protected]"
      ]
  },
  "IgnorePaths": [
    "H:\\code\\llvm"
  ]
}

If you like to keep a flat code directories then you can set DirectoryScanDepth to a smaller value. This value affects performance so chose carefully.

Examples

These examples assume you have installed Walrus.CLI as a dotnet tool.

Show the active configuration

walrusc show config

Print a list of all repositories

walrusc show repos

Use the default scan depth and search for repositories relative to your current directory. No config file needed!

walrusc query --current-directory

Count commits between March 2 and Jun 2 of 2021. This includes all authors on the currently checked out branch in each repository

walrusc query --after "Mar 2 2021" --before "Jun 2 2021"

Show all commits on all branches since last week (default if --after is not specified) and restrict to a single author

walrusc query --all-branches --author-email [email protected]

Print a commit summary table organized by repo and date to the console

walrusc query --author-email [email protected] --group-by repo

Repository: uarch_benchmarks [file://H:\code\system\uarch_benchmarks]
----------------------------------------------------------------------------------------------------
8/15/2021: 3 Commits
        19:16 2bbde046b8232f58357bf89b1b4478f3275e7367 add cmake build scripts
        19:38 2e630b5e20d2e66e3809641fc648ec3a7eeef3f6 [cmake] use dots in app names
        19:39 bc2232a9bea51d3343eba5e6c818692db7339362 msvc compatibility fix


Repository: Walrus [file://H:\code\tools\Walrus]
----------------------------------------------------------------------------------------------------
8/21/2021: 19 Commits
        12:02 ba29639d9eef1e33ae74d4f487eaabf04ce66afc First commit
        14:01 89421e0332f1db429a150ffac221a2d46454947a add logging to core library
        14:02 31a2cf014c844d0c9da6b93c097e118c95b24efe add ensure helper class
        14:02 0335f9a11ec0c5f83c0f412ed49e816f815d9089 enable nullable on core library
        14:04 f91dab40a622e4617e72619f56954f0896332ff0 fix crash commit enumerator
        14:07 77cfa7fa5bb717902d999e4ce16be8ad7a739379 code cleanup
        14:07 515fec7ad07d728044271e7fa6a93a34217613b3 connect logging to core lib in CLI
        14:08 666dd3aeb13fccd82676bee06e2bd50b5b367265 add query command
        14:10 b59ccd09df2811132752094bfa6307b6fbae3e40 stop tracking config files
        14:10 f47fb2990a0d9596e908a23a25e248b0b10a1f37 ignore test and launch configs
        14:10 a238cd6a745727f527ac0e7f7da55d955c26b437 remove noisy log line
        14:26 79681875e6493fcbfc0496822d440f46ad1a857a add author to query parameters
        14:29 48d258f0a443b68bd8619b982b26db6571de7853 exclude remote branches
        14:33 ce9c3cc6ebbf615c5ee354b28a06d935f0bff8a8 remove walrus service
        15:12 9142eef111af4786c0070fe7f1c75a82564fd861 make query parallel
        15:13 ef7118ce0300dd0455983ff93af22d8cb2413a97 add more info to WalrusCommit
        21:05 4994950950a5fbd27aa722a1568702a586492db7 add repo name filter
        22:24 553bb2cf992eaaf1ae8ee50f1578415715354e65 fix duplicate repo return
        22:36 f2e18d204cfb91b0fdc5dd9c880e676634d68db3 [cli] add table format printer
8/22/2021: 1 Commits
        09:12 82eb14b37e57a665e7077fb4754a8b3e6a8af6de add file link to cli table output


====================================================================================================
Total Commits: 23
====================================================================================================

Show all commits from all aliases known to be associated with a name. This requires an entry in your configuration file.

walrusc query --author-alias illyum

Roadmap

• Basic date/author query interface
• Unit tests
• Simple CLI
• Table style CLI output
• Create dotnet tool
• CI tests