GWS - Git Workspace

Have you ever used Git submodules? Then you know the pain they bring... If you just want to keep some Git repos together organized, then GWS - Git Workspace is for you!

UPDATE: See How VSHN manages Hiera data files for an example use case.

Just write your repo references in a simple file called .projects.gws and call gws update. This will clone the referenced repos and gives you some other nice helpers.

A sample .projects.gws could look like this:

# Puppet modules
stdlib    |
apache    |
apt       |

(lines beginning with a # are comments).

GWS gives you even more:

  • init - Detect the repositories and create the projects list
  • update - Update the workspace to get new repositories from projects list
  • status - Print status for all repositories in the workspace
  • fetch - Print status for all repositories in the workspace, but fetch the origin before
  • ff - Print status for all repositories in the workspace, but fast forward from origin before
  • check - Check the workspace for all repositories (known/unknown/missing)

The cloned repos are normal Git repos in which you can do whatever you want with git, without fearing to break any Git submodules or subtree magic.

If you chose to save this carefully crafted .projects.gws in it's own repo, then add the following .gitignore to this repo:

# Ignore everything, so all repositories in our case
# But not these files
You've successfully subscribed to Tobias Brunner aka tobru
Great! Next, complete checkout to get full access to all premium content.
Error! Could not sign up. invalid link.
Welcome back! You've successfully signed in.
Error! Could not sign in. Please try again.
Success! Your account is fully activated, you now have access to all content.
Error! Stripe checkout failed.
Success! Your billing info is updated.
Error! Billing info update failed.