Skip to main content

A Git Project Manager

Project description

Metagit

Git for Git Repositories


If you:

  • have a directory full of Git repos
  • want to version-control the configuration of those repos
  • like Git

Then you might find Metagit useful. It offers a Git-like experience for managing Git repos.

Demo

Initialize a Metagit repository:

$ cd ~/projects/    # or wherever you store your Git projects, or use metagit -C
$ metagit init      # creates .metagit, a Git repo where tracked project configs are kept
Initialized Metagit repository in /home/dmtucker/projects
$ metagit status
Untracked projects
  (use "metagit add <project>..." to begin tracking)
	project1/
	project2/

Track changes to project config:

$ metagit add project1/ project2/    # start tracking some projects
$ git -C project1/ remote add foo git@somehost.com:foo/project1.git
$ rm -rf project2/
$ metagit status
Changes
  (use "metagit add/rm <project>..." to accept changes)
  (use "metagit restore <project>..." to undo changes)
	modified: project1
	deleted:  project2

Git tracks lines in files. Metagit tracks config in projects.

$ metagit diff
diff --git a/project1 b/project1
index 515f483..93a874c 100644
--- a/project1
+++ b/project1
@@ -3,3 +3,6 @@
 	filemode = true
 	bare = false
 	logallrefupdates = true
+[remote "foo"]
+	url = git@somehost.com:foo/project1.git
+	fetch = +refs/heads/*:refs/remotes/foo/*
diff --git a/project2 b/project2
deleted file mode 100644
index 515f483..0000000
--- a/project2
+++ /dev/null
@@ -1,5 +0,0 @@
-[core]
-	repositoryformatversion = 0
-	filemode = true
-	bare = false
-	logallrefupdates = true

This example deleted project2 so as to demonstrate metagit restore (below), but keep in mind, ONLY CONFIGURATION IS TRACKED. If you need all of project2 back, you should restore from a backup.

$ metagit restore project2  # only restores git config! not branches/tags/etc.
$ metagit add project1      # add the project again to keep the changes
$ metagit rm project1       # stop tracking a project (does not affect the actual project)

About .metagit

.metagit is just another Git repo in your projects folder. It is created by metagit init, which automatically starts tracking it. When metagit add is used to start tracking a project, that project's .git/config file is copied into .metagit and committed.

$ git -C .metagit log
36cec91 (HEAD -> master) Remove project1
a1ed312 Add project1
185ed15 Add project2
e4d274d Add project1
1e16b5e Add .metagit

Pro tip: Consider a clone of the .metagit repo a (Metagit) "clone" of your projects folder. For example, push the .metagit repo to GitHub to allow for easy provisioning of new dev machines:

$ mkdir ~/projects
$ cd ~/projects/
$ git clone git@github.com:dmtucker/.metagit.git
...
$ metagit restore project2

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

metagit-1.2.0.tar.gz (25.1 kB view hashes)

Uploaded Source

Built Distribution

metagit-1.2.0-py3-none-any.whl (16.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page