Sergio R. Caprile scaprile

Git Subtree Basics

If you hate git submodule, then you may want to give git subtree a try.

Background

When you want to use a subtree, you add the subtree to an existing repository where the subtree is a reference to another repository url and branch/tag. This add command adds all the code and files into the main repository locally; it's not just a reference to a remote repo.

When you stage and commit files for the main repo, it will add all of the remote files in the same operation. The subtree checkout will pull all the files in one pass, so there is no need to try and connect to another repo to get the portion of subtree files, because they were already included in the main repo.

Adding a subtree

Let's say you already have a git repository with at least one commit. You can add another repository into this respository like this:

	#!/usr/bin/env bash
	# castanet.sh: Script to connect a chromecast to a WiFi network.
	#
	# Allows you to put your Chromecast on WiFi and do Chromecast initial setup
	# without using the Google Home app at all, just using a normal Linux computer.
	#
	# You do need your Chromecast to be on Ethernet, or (untested) to join its setup WiFi
	# network with your PC, and you also need to find out its IP yourself with e.g.
	# Wireshark.