Taylor MacDonald tcmacdonald

Forking a single package in a monorepo

The trend of using monorepos makes a lot of things easier to manage. However, when you want to fork a single package inside a monorepo, you'll have to chose one of two options:

Fork the entire monorepo (meaning you get all those extra boilerplate you don't really care about)
Manually copying the package files into a new git repo (meaning you'll loose all git history and have a lot of work to do when there's a new version of your base package)

The good news: There's a solution for this! And it's actually built in to git.

`git subtree`

One of the lesser-known (and vaguely documented) features of git is subtree. It's intended for this purpose, working as a great alternative to the criticized submodules. There are very few resources about using this in practice, so here's a guide for this specific use case.

Intro

Bellow follows a list of aliases, split between beginner and advanced.

To start using them right away you should place the aliases you like most in a file like ~/.zsh/git. Now all that remains is to add the following line to your ~/.zshrc or ~/.bashrc:

. ~/.zsh/git # git aliases

There are many (old) clients available:

https://github.com/tpitale/legato (active, supports API v3)
https://github.com/activenetwork/gattica
https://github.com/vigetlabs/garb

The Google Analytics API is at v3 (at time of writing).

This example uses Google's Ruby API client to access Analytics. Use https://github.com/google/google-api-ruby-client (Google supported).

	[Settings]
	ID = "Your_Site_ID"

	# Settings in the [build] context are global and are applied to all contexts unless otherwise overridden by more specific contexts.

	[build]
	# This is the directory to change to before starting a build.
	base = "project/"
	# NOTE: This is where we will look for package.json/.nvmrc/etc, not root.
	# This is the directory that you are publishing from (relative to root of your repo)

	'use strict';

	var Octokat = require('octokat');
	var extend = require('lodash/object/assign');

	var defaults = {
	branchName: 'master',
	token: '',
	username: '',
	reponame: ''

	# This monkey patches the PostgreSQL adapter to use asynchronous
	# communication when doing its "SELECT 1" check for is-connection-active.
	# One symptom of this problem is stalled processing queues in Sidekiq.
	# See also:
	#
	# https://github.com/rails/rails/issues/12867
	#
	# At the time of writing we have seen indefinite blocking down in the C
	# library's "poll()" method due to the out-of-box Rails code using blocking
	# I/O, in multithreaded environments - one thread gets stuck in the I/O and

	# Usage:
	# 1. Drop this file into lib/capistrano/submodule_strategy.rb
	# 2. Add the following to your Capfile:
	# require 'capistrano/git'
	# require './lib/capistrano/submodule_strategy'
	# 3. Add the following to your config/deploy.rb
	# set :git_strategy, SubmoduleStrategy

	module SubmoduleStrategy
	# do all the things a normal capistrano git session would do

	# db/migrate/XXXXXXXXXXXXX_add_authentication_token_to_users.rb

	class AddAuthenticationTokenToUsers < ActiveRecord::Migration
	def change
	add_column :users, :authentication_token, :string

	add_index :users, :authentication_token, :unique => true
	end
	end

	/*
	* fonts.com implement one different font-family name per weight or style of
	* the same font. This means you need to explicitly declare in your elements
	* that use a font-weight different to `normal`, the new font-family
	* corresponding to that weight.
	*
	* See http://stackoverflow.com/questions/5824925/is-there-any-way-to-fix-fonts-com-font-face-declarations
	*/

	var FontsComLoader = (function() {

	# http://stackoverflow.com/questions/5108876/kill-a-postgresql-session-connection
	namespace :db do
	desc "Fix 'database is being accessed by other users'"
	task :terminate => :environment do
	ActiveRecord::Base.connection.execute <<-SQL
	SELECT
	pg_terminate_backend(pid)
	FROM
	pg_stat_activity
	WHERE