#git-repository #git #github #mirror #backup-utility

app git-collage

A tool for selectively mirroring Git repositories

6 releases (3 breaking)

0.4.2 Mar 28, 2024
0.4.1 Mar 25, 2024
0.4.0 Aug 29, 2022
0.3.0 Aug 29, 2022
0.1.0 May 21, 2022

#434 in Development tools

Download history 5/week @ 2024-02-23 1/week @ 2024-03-01 191/week @ 2024-03-22 115/week @ 2024-03-29 23/week @ 2024-04-05

206 downloads per month

MIT license

38KB
1K SLoC

git-collage CI Crates.io dependency status

A tool for selectively mirroring Git repositories.

git-collage was created to fill my desire to backup my own Git repos and mirror the parts of 3rd party repos I care about. To this end the key features this tool has are:

  • Ability to discover repositories (currently only from GitHub, but more can be added easily)
  • Ability to filter refs that are mirrored, preventing "useless" refs being created locally (e.g. feature branches, GitHub PR merge commits)
  • Is a single binary that can be scheduled via cron or systemd (personally I did not want to run a service for what is essentially a time scheduled backup job)

Usage

See git-collage --help for syntax and examples for a sample configuration file.

Things to note:

  • Console output below INFO level may contain sensitive information (e.g. Github tokens).
  • GitHub tokens must be generated with the repo scope.

Dependencies

~23–36MB
~641K SLoC