git subcommand of browse/modify issue traker's tickets.
Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
images
lib
spec
.document
.gitignore
Gemfile
LICENSE
README.markdown
Rakefile
VERSION
git-issue.gemspec

README.markdown

git-issue

git subcommand of browse/modify issue traker's tickets.

now available issue-tracker system is Redmine and Github-issues.

ScreenShots

Installation

$ gem install git-issue

or

$ git clone https://github.com/yuroyoro/git-issue.git
$ cd git-issue
$ gem install jeweler
$ rake install

Configuration(Redmine)

set type of issue traking system(redmine or github)

$ git config issue.type redmine

set url of issue traking system's api endopoint.

$ git config issue.url http://redmine.example.com

set api-key for accessing issue traking system.

$ git config issue.apikey FWeaj3I9laei03A....

set repository name if using github.

$ git config issue.repo gitterb

set your account name if using github.

$ git config issue.user yuroyoro

Configuration(Github Issues)

set type of issue traking system(redmine or github)

$ git config issue.type github

set user and password of github(for authentication)

$ EDITOR=vim pit set github

Usage(Redmine)

git issue <command> [ticket_id] [<args>]

Commnads:
  show     s show given issue summary. if given no id,  geuss id from current branch name.
  view     v view issue in browser. if given no id,  geuss id from current branch name.
  list     l listing issues.
  mine     m display issues that assigned to you.
  commit   c commit with filling issue subject to messsage.if given no id, geuss id from current branch name.
  add      a create issue.
  update   u update issue properties. if given no id, geuss id from current branch name.
  branch   b checkout to branch using specified issue id. if branch dose'nt exisits, create it. (ex ticket/id/<issue_id>)
  publish  pub push branch to remote repository and set upstream
  rebase   rb rebase branch onto specific newbase
  help     h show usage.
  local    loc listing local branches tickets
  project  pj listing ticket belongs to sspecified project

Options:
  -a, --all                        update all paths in the index file
  -f, --force                      force create branch
  -v, --verbose                    show issue details
  -n, --max-count=VALUE            maximum number of issues
      --oneline                    display short info
      --raw-id                     output ticket number only
      --remote=VALUE               on publish, remote repository to push branch
      --onto=VALUE                 on rebase, start new branch with HEAD equal to "newbase"
      --debug                      debug print
  -j, --supperss_journals          do not show issue journals
  -r, --supperss_relations         do not show issue relations tickets
  -c, --supperss_changesets        do not show issue changesets
  -q, --query=VALUE                filter query of listing tickets
      --project_id=VALUE           use the given value to create subject
      --description=VALUE          use the given value to create subject
      --subject=VALUE              use the given value to create/update subject
      --ratio=VALUE                use the given value to create/update done-ratio(%)
      --status=VALUE               use the given value to create/update issue statues id
      --priority=VALUE             use the given value to create/update issue priority id
      --tracker=VALUE              use the given value to create/update tracker id
      --assigned_to_id=VALUE       use the given value to create/update assigned_to id
      --category=VALUE             use the given value to create/update category id
      --fixed_version=VALUE        use the given value to create/update fixed_version id
      --custom_fields=VALUE        value should be specifies '<custom_fields_id1>:<value2>,<custom_fields_id2>:<value2>, ...'
      --notes=VALUE                add notes to issue

Usage(Github Issues)

git issue <command> [ticket_id] [<args>]

Commnads:
  show     s show given issue summary. if given no id,  geuss id from current branch name.
  view     v view issue in browser. if given no id,  geuss id from current branch name.
  list     l listing issues.
  mine     m display issues that assigned to you.
  commit   c commit with filling issue subject to messsage.if given no id, geuss id from current branch name.
  add      a create issue.
  update   u update issue properties. if given no id, geuss id from current branch name.
  branch   b checkout to branch using specified issue id. if branch dose'nt exisits, create it. (ex ticket/id/<issue_id>)
  publish  pub push branch to remote repository and set upstream
  rebase   rb rebase branch onto specific newbase
  help     h show usage.
  mention  men create a comment to given issue

Options:
  -a, --all                        update all paths in the index file
  -f, --force                      force create branch
  -v, --verbose                    show issue details
  -n, --max-count=VALUE            maximum number of issues
      --oneline                    display short info
      --raw-id                     output ticket number only
      --remote=VALUE               on publish, remote repository to push branch
      --onto=VALUE                 on rebase, start new branch with HEAD equal to "newbase"
      --debug                      debug print
  -s, --supperss_commentsc         show issue journals
      --title=VALUE                Title of issue.Use the given value to create/update issue.
      --body=VALUE                 Body content of issue.Use the given value to create/update issue.
      --state=VALUE                Use the given value to create/update issue. or query of listing issues.Where 'state' is either 'open' or 'closed'
      --milestone=VALUE            Use the given value to create/update issue. or query of listing issues, (Integer Milestone number)
      --assignee=VALUE             Use the given value to create/update issue. or query of listing issues, (String User login)
      --mentioned=VALUE            Query of listing issues, (String User login)
      --labels=VALUE               Use the given value to create/update issue. or query of listing issues, (String list of comma separated Label names)
      --sort=VALUE                 Query of listing issues, (created,  updated,  comments,  default: created)
      --direction=VALUE            Query of listing issues, (asc or desc,  default: desc.)
      --since=VALUE                Query of listing issue, (Optional string of a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ)
      --password=VALUE             For Authorizaion of create/update issue.  Github API v3 doesn't supports API token base authorization for now. then, use Basic Authorizaion instead token.
      --sslnoverify                don't verify SSL

Copyright

Copyright (c) 2011 Tomohito Ozaki. See LICENSE for details.