[SCRIPT] git-upstream: prints the tracking chain starting at the named ref

Howdy, all.

Here's a script I've sort of `grown' over the past few weeks.

I use it to quickly see where a tracking branch stands with respect to upstream refs _without_ actually fetching or even switching to the tracking branch. This may not be useful for everyones' work-flows; but I find it handy. I'm posting because it may be of use to others (and feedback, if any, can only improve it).

Example:

	$ git upstream -v --abbrev master
	ce567d1... master* is behind 'origin/master' by 17 commits, and can  
be fast-forwarded.
	186458b... origin/master
	186458b... master@origin, git://git.kernel.org/pub/scm/git/git.git

For more info, try: git upstream -v -h

It's a perl script and uses Git.pm. Tries to fit into git standard practices. Supports colors (defaults to color like git branch), configs. It has a few rough edges, but it's very usable. The tiny pause before printing a remote tracking branch is ls-remote. I hope the name doesn't conflict with anything.

I apologize for attaching rather than inserting in-line; but this is a complete file, not a patch and I also don't trust my mailer :-(

hopefully someone else finds this useful :-) _____________ Scott Collins