#github

app git-collage

A tool for selectively mirroring Git repositories

7 unstable releases

0.4.3 Aug 18, 2024
0.4.2 Mar 28, 2024
0.4.0 Aug 29, 2022
0.3.0 Aug 29, 2022
0.1.0 May 21, 2022

#931 in Development tools

27 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
~621K SLoC