= Git Plugin for Trac = == Description == This is yet another plugin for Trac 0.10/0.11 which enables [http://git.or.cz/ GIT] to be used instead of [http://subversion.tigris.org/ Subversion] for the trac:VersioningSystemBackend === Features === - Browsing source code in a Git repository via the TracBrowser - Viewing the change history of a file or directory using TracRevisionLog - Performing [trac:TracDiff diffs] between any two files or two directories - Displaying submitted changes in the TracTimeline (0.11) - (Optionally) caching TracChangeset information in Trac's database (0.11) - Caching Git commit relation graph in memory (0.11) - Using the TracSearch page to search change descriptions (0.11) - Annotation support, also known as "blame" operation (0.11) - Interpretation of 40-character wide hex-strings as sha1 commit checksums - ... === Requirements === || || '''0.10 Plugin''' || '''0.11 Plugin''' || || Trac || 0.10.x || 0.11.x || || Python || 2.4+ || 2.5 || || GIT || 1.4.4+ || 1.5.2+ || == Example Sites == - The GIT repositories at [https://hosted.fedoraproject.org/ Fedora Hosted] - [http://nanosleep.org/proj/trac-git-plugin/browser nanosleep.org's GitPlugin branch] - [http://parted.alioth.debian.org/cgi-bin/trac.cgi/browser GNU Parted] - [https://reductivelabs.com/trac/puppet/browser ReductiveLabs Puppet] == Bugs/Feature Requests == As this is for now just a proof of concept implementation, it has quite some deficiencies, some of which exist as tickets already: [[TicketQuery(component=GitPlugin&status!=closed)]] ...and other potential issues/todos which aren't ticket-tracked yet: * ~~does not highlight sha1sums automatically~~ * issues with filenames containing newlines (seems to be a Trac bug) * ... Existing bugs and feature requests for GitPlugin are [report:9?COMPONENT=GitPlugin here] (all including closed ones are [report:10?COMPONENT=GitPlugin here]). If you have any issues, create a [http://trac-hacks.org/newticket?component=GitPlugin&owner=hvr new ticket]. == Download, Source == Download the [download:gitplugin zipped source], check out GitPlugin from [http://trac-hacks.org/svn/gitplugin Subversion], or [source:gitplugin browse the source]. (An experimental branch of this plugin with a hacky caching feature and some bug fixes is available from [http://nanosleep.org/proj/trac-git-plugin/ here].) == Configuration == Simply point your Trac instance to a local git repository: {{{ [trac] repository_dir = /var/git/Test.git repository_type = git ## the following is only for the 0.11 branch [git] ## let Trac cache meta-data via CachedRepository wrapper; default: false cached_repository = true ## disable automatic garbage collection for in-memory commit-tree cache; default: false persistent_cache = true ## length revision sha-sums should be tried to be abbreviated to (must be >= 4 and <= 40); default: 7 shortrev_len = 6 ## executable file name (optionally with path) of git binary; default: 'git' git_bin = /usr/src/git-dev/git }}} '''/!\ NOTE''': the `Test.git` above needs to be the `.git` repository directory (i.e. the one containing the file `HEAD` and `config`), not the working tree directory that holds the `.git/` folder. If installed globally, don't forget to enable the plugin: {{{ [components] # for plugin version 0.10 gitplugin.* = enabled # for plugin version 0.11.0.1+ tracext.git.* = enabled }}} == Recent Changes == [[ChangeLog(gitplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:hvr Herbert Valerio Riedel] [[BR]] '''Contributors:''' Hans Petter Jansson