optionalg / github-tmbundle

TextMate bundle for working with GitHub

GitHub TextMate bundle

Contains the following commands specific to the current file:

• Show in GitHub - opens the current file in github, and selects the same lines that are selected in the current file
• Annotate/Blame/Comment Line - finds the original commit where this line was created and opens that commit in GitHub, whereby you can use the GitHub comment feature

Contains the following commands specific to the repository:

• Show Network in GitHub - opens the "Network" view in GitHub so you can see who has interesting commits that you don't have

Contains the following commands for creating gists:

• Create gist from selection - will create a gist using your GitHub credentials (see below). It will either use the current selection, or the whole file, using the filename and the currently active language. The URL of the gist will be copied to your clipboard.
• Create private gist from selection - same as above, but the Gist will be private.

Prerequisites

The bundle requires Ruby, RubyGems, and the git RubyGem:

	sudo gem install git

Installation

To install via Git:

	mkdir -p ~/Library/Application\ Support/TextMate/Bundles
	cd ~/Library/Application\ Support/TextMate/Bundles
	git clone git://github.com/drnic/github-tmbundle.git "GitHub.tmbundle"
	osascript -e 'tell app "TextMate" to reload bundles'

Source can be viewed or forked via GitHub: http://github.com/drnic/github-tmbundle/tree/master

To install without Git:

	mkdir -p ~/Library/Application\ Support/TextMate/Bundles
	cd ~/Library/Application\ Support/TextMate/Bundles
	wget http://github.com/drnic/github-tmbundle/tarball/master
	tar zxf drnic-github-tmbundle*.tar.gz
	rm drnic-github-tmbundle*.tar.gz
	mv drnic-github-tmbundle* GitHub.tmbundle
	osascript -e 'tell app "TextMate" to reload bundles'

To enable Gist support, make sure you've followed the instructions on your account page for adding your GitHub user and API Token to your global Git config. You can create gists without specifying your credentials, but they won't be associated with your account.

Author

Dr Nic Williams, [email protected], http://drnicwilliams.com

With contributions from:

• Pedro Melo
• Mathias Meyer
• Geoff Cheshire
• Loren Segal
• Jesse Newland

License

(The MIT License)

Copyright (c) 2010 Dr Nic Williams, [email protected]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.