FichteFoll

How to extract a single file with its history from a git repository

These steps show two less common interactions with git to extract a single file which is inside a subfolder from a git repository. These steps essentially reduce the repository to just the desired files and should performed on a copy of the original repository (1.).

First the repository is reduced to just the subfolder containing the files in question using git filter-branch --subdirectory-filter (2.) which is a useful step by itself if just a subfolder needs to be extracted. This step moves the desired files to the top level of the repository.

Finally all remaining files are listed using git ls, the files to keep are removed from that using grep -v and the resulting list is passed to git rm which is invoked by git filter-branch --index-filter (3.). A bit convoluted but it does the trick.

1. copy the repository to extract the file from and go to the desired branch

Markdown and reStructuredText

GitHub supports several lightweight markup languages for documentation; the most popular ones (generally, not just at GitHub) are Markdown and reStructuredText. Markdown is sometimes considered easier to use, and is often preferred when the purpose is simply to generate HTML. On the other hand, reStructuredText is more extensible and powerful, with native support (not just embedded HTML) for tables, as well as things like automatic generation of tables of contents.

Locate the section for your github remote in the .git/config file. It looks like this:

[remote "origin"]
	fetch = +refs/heads/*:refs/remotes/origin/*
	url = [email protected]:joyent/node.git

Now add the line fetch = +refs/pull/*/head:refs/remotes/origin/pr/* to this section. Obviously, change the github url to match your project's URL. It ends up looking like this:

Install

Either copy the aliases from the .gitconfig or run the commands in add-pr-alias.sh

Usage

Easily checkout local copies of pull requests from remotes:

git pr 4 - creates local branch pr/4 from the github upstream(if it exists) or origin remote and checks it out
git pr 4 someremote - creates local branch pr/4 from someremote remote and checks it out

Semantic Version Selectors

A semantic version selector (short: semsel) is a string that can match only onto specific semantic versions (semver). A semsel mainly consists of one or multiple comperators combined with inner logical ANDs and outer ORs.

A complete example could look like this:

>0.0.1-b.1337 <=0.0.2- || 0.0.3 +debug* || ~1.0 || 2.0.x +with* || 2.1.0- - 2.1.1- !2.1.1-b.9 || [3.1,3.3)

superfish.pem contains:

the Superfish certificate as found by both Chris Palmer and Matt Burke;
the encrypted private key as found by Karl Koscher.

$ openssl x509 -in superfish.pem -text
Certificate:
    Data:
        Version: 3 (0x2)

	'''
	@author Josh Bjornson

	This work is licensed under the Creative Commons Attribution-ShareAlike 3.0 Unported License.
	To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/3.0/
	or send a letter to Creative Commons, 171 Second Street, Suite 300, San Francisco, California, 94105, USA.
	'''
	# Plugin to provide access to the history of accessed files:
	# https://gist.github.com/1133602
	#

	{
	"name": "FichteMarkDown",
	"scopeName": "text.fmd",
	"fileTypes": ["fmd"],
	"patterns": [
	{
	"include": "#inline"
	},
	{
	"include": "#list-heading"

	main = lambda port: (lambda dt: (lambda mm: (lambda n: (map(lambda r: (lambda
	rr: setattr(n, *rr) if (type(rr) is tuple and len(rr) == 2) else None)(r()),
	[lambda: map(setattr, zip([(n, m, __import__(m)) for m in mm.m.decode('ba'
	'se64').split()])), lambda: map(n.s['signal.signal'], (n.s['signal.SIGINT'],
	n.s['signal.SIGTERM']), [lambda s, f: (n.s['sys.exit']() if n.f else [n.sa(
	mm.l[0], n.o)] and n.u('f', True) or n.fc(n.l))] * 2), lambda: setattr(mm,
	'l', mm.l.decode('base64').split('~~~')), lambda: ('sw', n.s['types.Functio'
	'nType'] (compile("try:\n\tv = n.select.select(n.so, n.w(), [])\nexcept n.s"
	"elect.error, e:\n\tif e[0] != n.errno.EINTR: raise\nelse:\n\tn.u('sr', v)",
	'', 'exec'), dict(n=n, OSError=OSError))),lambda: ('l', n.s['socket.socket']

	# colored stream handler for python logging framework (use the ColorStreamHandler class).
	#
	# based on:
	# http://stackoverflow.com/questions/384076/how-can-i-color-python-logging-output/1336640#1336640

	# how to use:
	# i used a dict-based logging configuration, not sure what else would work.
	#
	# import logging, logging.config, colorstreamhandler
	#