Home > git-fogbugz

git-fogbugz

Git-fogbugz is a project mainly written in Ruby, based on the MIT license.

ruby program for use in git post-receive hook to integrate with FogBugz

= git-fogbugz

This is a program to process the input received by the git post-receive hook from git-receive-pack. If finds references to FogBugz tickets and transmits change information to your FogBugz server.

== Installation If you are not set up for gemcutter.org yet

gem install gemcutter gem tumble gem install git-fogbuz

If you are

gem install git-fogbuz

== Usage

Usage: git-fogbugz [options] fogbugz_server fogbugz_repo_id

Currently looks for case|bugzid|issue[:] followed by a number

Expects standard input such as sent to the git post-receive hook. See http://www.kernel.org/pub/software/scm/git/docs/githooks.html#post-receive

Example: git-fogbugz https://example.fogbugz.com 9 < file_with_old_new_ref_lines

== Options

-p, --passthrough                Output stdin
-r, --repo=REPO                  Location of repository default is current dir
-v, --version
-V, --verbose
-q, --quiet
-h, --help

== FogBugz setup

=== Cgit

Diff URL: http://[cgitserver.example.com]/cgit/[repository_name]/diff/^FILE?id=^R2

Log URL: http://[cgitserver.example.com]/cgit/[repository_name]/commit/?id=^R2

=== gitweb

Diff URL:
https://[cgitserver.example.com]/git/gitweb.cgi?p=[repository_name];a=blobdiff;f=^FILE;hb=^R2;hpb=^R1

Log URL:
https://[cgitserver.example.com]/git/gitweb.cgi?p=[repository_name];a=history;f=^FILE;hb=^R2

== Todo

  • write tests
  • add option for php vs asp
  • support 6,1

== Note on Patches/Pull Requests

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future version unintentionally.
  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.

== Copyright

Copyright (c) 2009 Roy W. Black. See LICENSE for details.