#git

nightly bin+lib git-repo-manager

Manage multiple git repositories. You configure the git repositories in a file, the program does the rest!

4 releases (breaking)

Uses new Rust 2021

new 0.4.0 Nov 29, 2021
0.3.0 Nov 26, 2021
0.2.0 Nov 24, 2021
0.1.0 Nov 19, 2021

#286 in Development tools

Download history 17/week @ 2021-11-16 52/week @ 2021-11-23

69 downloads per month

GPL-3.0-only

130KB
2.5K SLoC

Rust 1.5K SLoC // 0.0% comments Python 1K SLoC // 0.3% comments

GRM — Git Repository Manager

GRM helps you manage git repositories in a declarative way. Configure your repositories in a TOML file, GRM does the rest.

Take a look at the official documentation for installation & quickstart.

Why?

I have a lot of repositories on my machines. My own stuff, forks, quick clones of other's repositories, projects that never went anywhere ... In short, I lost overview.

To sync these repositories between machines, I've been using Nextcloud. The thing is, Nextcloud is not too happy about too many small files that change all the time, like the files inside .git. Git also assumes that those files are updated as atomically as possible. Nextcloud cannot guarantee that, so when I do a git status during a sync, something blows up. And resolving these conflicts is just no fun ...

In the end, I think that git repos just don't belong into something like Nextcloud. Git is already managing the content & versions, so there is no point in having another tool do the same. But of course, setting up all those repositories from scratch on a new machine is too much hassle. What if there was a way to clone all those repos in a single command?

Also, I once transferred the domain of my personal git server. I updated a few remotes manually, but I still stumble upon old, stale remotes in projects that I haven't touched in a while. What if there was a way to update all those remotes in once place?

This is how GRM came to be. I'm a fan of infrastructure-as-code, and GRM is a bit like Terraform for your local git repositories. Write a config, run the tool, and your repos are ready. The only thing that is tracked by git it the list of repositories itself.

Future & Ideas

  • Operations over all repos (e.g. pull)
  • Show status of managed repositories (dirty, compare to remotes, ...)

Optional Features

  • Support multiple file formats (YAML, JSON).
  • Add systemd timer unit to run regular syncs

Crates

  • toml for the configuration file
  • serde because we're using Rust, after all
  • git2, a safe wrapper around libgit2, for all git operations
  • clap, console and shellexpand for good UX

Links

Dependencies

~16MB
~367K SLoC

a