git-issue 0.7.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Tomohito Ozaki
+
+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.

data/README.markdown

@@ -0,0 +1,115 @@
+git-issue
+====================================================
+
+git subcommand of browse/modify issue traker's tickets.
+
+now supporse Redmine,Github-issues
+
+## ScreenShots
+
+<img src='https://github.com/yuroyoro/git-issue/raw/master/images/git-issue_screenshot-1.png' width='600'/>
+<img src='https://github.com/yuroyoro/git-issue/raw/master/images/git-issue_screenshot-2.png' width='600'/>
+
+## Instration
+
+    $ git clone https://github.com/yuroyoro/git-issue.git
+    $ cd git-issue
+    $ rake install jeweler
+    $ rake build
+    $ gem install pkg/git-issue-<version>.gem
+
+## Configuration
+
+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
+
+## 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.
+      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.
+      update   u update issue properties. if given no id, geuss id from current branch name.
+      branch   b checout 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  prj 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          show issue journals
+      -r, --supperss_relations         show issue relations tickets
+      -c, --supperss_changesets        show issue changesets
+      -q, --query=VALUE                filter query of listing tickets
+          --subject=VALUE              use the given value to update subject
+          --ratio=VALUE                use the given value to update done-ratio(%)
+          --status=VALUE               use the given value to update issue statues id
+          --priority=VALUE             use the given value to update issue priority id
+          --tracker=VALUE              use the given value to update tracker id
+          --assigned_to_id=VALUE       use the given value to update assigned_to id
+          --category=VALUE             use the given value to update category id
+          --fixed_version=VALUE        use the given value to 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(Redmine)
+
+    git issue <command> [ticket_id] [<args>]
+    
+    Commnads:
+      show     s show given issue summary. 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.
+      update   u update issue properties. if given no id, geuss id from current branch name.
+      branch   b checout 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.
+
+    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
+          --state=VALUE                Where 'state' is either 'open' or 'closed'
+
+## Copyright
+
+Copyright (c) 2011 Tomohito Ozaki. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,50 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "git-issue"
+    gem.summary = %Q{git extention command for issue tracker system.}
+    gem.description = %Q{git extention command for issue tracker system.}
+    gem.email = "ozaki@yuroyoro.com"
+    gem.homepage = "http://github.com/yuroyoro/git-issue"
+    gem.authors = ["Tomohito Ozaki"]
+    gem.add_development_dependency "rspec"
+    gem.add_development_dependency "activesupport"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  # spec.libs << 'lib' << 'spec'
+  # spec.spec_files = FileList['spec/**/*_spec.rb']
+  spec.pattern = 'spec/**/*_spec.rb'
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  # spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "git-issue #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.7.0

data/bin/git-issue

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+
+$LOAD_PATH.unshift File.dirname(__FILE__) + '/../lib'
+require 'git_issue'
+
+GitIssue.main(ARGV)
+

data/git-issue.gemspec

@@ -0,0 +1,62 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{git-issue}
+  s.version = "0.7.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Tomohito Ozaki"]
+  s.date = %q{2012-02-23}
+  s.default_executable = %q{git-issue}
+  s.description = %q{git extention command for issue tracker system.}
+  s.email = %q{ozaki@yuroyoro.com}
+  s.executables = ["git-issue"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README.markdown"
+  ]
+  s.files = [
+    ".document",
+    "LICENSE",
+    "README.markdown",
+    "Rakefile",
+    "VERSION",
+    "bin/git-issue",
+    "git-issue.gemspec",
+    "images/git-issue_screenshot-1.png",
+    "images/git-issue_screenshot-2.png",
+    "lib/git_issue.rb",
+    "lib/git_issue/base.rb",
+    "lib/git_issue/github.rb",
+    "lib/git_issue/redmine.rb",
+    "spec/git_issue/base_spec.rb",
+    "spec/git_issue/github_spec.rb",
+    "spec/git_issue/redmine_spec.rb",
+    "spec/git_issue_spec.rb",
+    "spec/spec.opts",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/yuroyoro/git-issue}
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.5.2}
+  s.summary = %q{git extention command for issue tracker system.}
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<activesupport>, [">= 0"])
+    else
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<activesupport>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<activesupport>, [">= 0"])
+  end
+end
+

data/lib/git_issue.rb

@@ -0,0 +1,96 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+
+$KCODE="UTF8" if RUBY_VERSION < '1.9.0'
+
+require 'pp'
+require 'rubygems'
+require 'uri'
+require 'open-uri'
+require "net/http"
+require "net/https"
+require "uri"
+require 'fileutils'
+require 'json'
+require 'optparse'
+require 'tempfile'
+require 'active_support/all'
+
+module GitIssue
+  class Command
+    attr_reader :name, :short_name, :description
+    def initialize(name, short_name, description)
+      @name, @short_name, @description = name, short_name, description
+    end
+  end
+
+  module Helper
+
+    CONFIGURE_MESSAGE = <<-END
+    please set issue tracker %s.
+
+      %s
+    END
+
+    def configure_error(attr_name, example)
+      raise CONFIGURE_MESSAGE % [attr_name, example]
+    end
+
+
+    def configured_value(name)
+      res = `git config issue.#{name}`
+      res.strip
+    end
+
+    def global_configured_value(name)
+      res = `git config --global #{name}`
+      res.strip
+    end
+
+    def its_klass_of(its_type)
+      case its_type
+        when /redmine/i then GitIssue::Redmine
+        when /github/i  then GitIssue::Github
+        else
+          raise "unknown issue tracker type : #{its_type}"
+      end
+    end
+
+    module_function :configured_value, :global_configured_value, :configure_error, :its_klass_of
+  end
+
+  def self.main(argv)
+    status = true
+
+    begin
+      its_type = Helper.configured_value('type')
+      apikey   = Helper.configured_value('apikey')
+
+      # Use global config for hub
+      if its_type.blank?
+        github_user = Helper.global_configured_value('github.user')
+        unless github_user.blank?
+          its_type = 'github'
+          apikey   = Helper.global_configured_value('github.token')
+        end
+      end
+
+      Helper.configure_error('type (redmine | github)', "git config issue.type redmine") if its_type.blank?
+      Helper.configure_error('apikey', "git config issue.apikey some_api_key")           if apikey.blank?
+
+      its_klass = Helper.its_klass_of(its_type)
+      status = its_klass.new(ARGV).execute || true
+    rescue => e
+      puts e
+      puts e.backtrace.join("\n")
+      status = false
+    end
+
+    exit(status)
+  end
+
+end
+
+require File.dirname(__FILE__) + '/git_issue/base'
+require File.dirname(__FILE__) + '/git_issue/redmine'
+require File.dirname(__FILE__) + '/git_issue/github'

data/lib/git_issue/base.rb

@@ -0,0 +1,263 @@
+# -*- coding: utf-8 -*-
+
+class GitIssue::Base
+  include GitIssue::Helper
+
+  attr_reader :apikey, :command, :tickets, :options
+  attr_accessor :sysout, :syserr
+
+  def initialize(args, options = {})
+
+    @opt_parse_obj = opt_parser
+    args = parse_options(args)
+
+    @sysout = options[:sysout] || $stdout
+    @syserr = options[:syserr] || $stderr
+
+    split_ticket = lambda{|s| s.nil? || s.empty? ? nil : s.split(/,/).map{|v| v.strip.to_i} }
+
+    @tickets = []
+    cmd = args.shift || default_cmd
+
+    if cmd =~ /(\d+,?\s?)+/
+      @tickets = split_ticket.call(cmd)
+      cmd = :show
+    end
+    cmd = cmd.to_sym
+
+    @command = find_command(cmd)
+
+    exit_with_message("invalid command <#{cmd}>") unless @command
+
+    @tickets += args.map{|s| split_ticket.call(s)}.flatten.uniq
+    @tickets = [guess_ticket] if @tickets.empty?
+  end
+
+  def default_cmd
+    :list
+  end
+
+  def execute
+    if @tickets.nil? ||  @tickets.empty?
+      self.send(@command.name, @options)
+    else
+      @tickets.each do |ticket|
+        self.send(@command.name, @options.merge(:ticket_id => ticket))
+      end
+    end
+    true
+  end
+
+  def help(options = {})
+    puts @opt_parse_obj.banner
+    puts "  Commnads:"
+    puts usage
+    puts ""
+    puts "  Options:"
+    puts @opt_parse_obj.summarize
+  end
+
+  def publish(options = {})
+    ticket, branch_name = ticket_and_branch(options)
+    remote = options[:remote] || "origin"
+    system "git push -u #{remote} #{branch_name}"
+  end
+
+  def rebase(options = {})
+    raise '--onto is required.' unless options[:onto]
+    ticket, branch_name = ticket_and_branch(options)
+    onto = options[:onto]
+
+    cb = current_branch
+
+    system "git rebase --onto #{onto} #{onto} #{branch_name}"
+    system "git checkout #{cb}"
+  end
+
+  def commands
+    [
+    GitIssue::Command.new(:show,   :s, 'show given issue summary. if given no id,  geuss id from current branch name.'),
+    GitIssue::Command.new(:list,   :l, 'listing issues.'),
+    GitIssue::Command.new(:mine,   :m, 'display issues that assigned to you.'),
+    GitIssue::Command.new(:commit, :c, 'commit with filling issue subject to messsage.if given no id, geuss id from current branch name.'),
+    GitIssue::Command.new(:add,    :a, 'create issue.'),
+    GitIssue::Command.new(:update, :u, 'update issue properties. if given no id, geuss id from current branch name.'),
+    GitIssue::Command.new(:branch, :b, "checout to branch using specified issue id. if branch dose'nt exisits, create it. (ex ticket/id/<issue_id>)"),
+
+    GitIssue::Command.new(:publish,:pub, "push branch to remote repository and set upstream "),
+    GitIssue::Command.new(:rebase, :rb,  "rebase branch onto specific newbase"),
+
+    GitIssue::Command.new(:help,   :h, "show usage.")
+    ]
+  end
+
+  def find_command(cmd)
+    cmd = cmd.to_sym
+    commands.find{|c| c.name == cmd || c.short_name == cmd }
+  end
+
+  def usage
+    commands.map{|c| "%-8s %s %s" % [c.name, c.short_name, c.description ] }.join("\n")
+  end
+
+  def time_ago_in_words(time)
+    t = Time.parse(time)
+    a = (Time.now - t).to_i
+
+    case a
+      when 0              then return 'just now'
+      when 1..59          then return a.to_s + '秒前'
+      when 60..119        then return '1分前'
+      when 120..3540      then return (a/60).to_i.to_s + '分前'
+      when 3541..7100     then return '1時間前'
+      when 7101..82800    then return ((a+99)/3600).to_i.to_s + '時間前'
+      when 82801..172000  then return '1日前'
+      when 172001..432000 then return ((a+800)/(60*60*24)).to_i.to_s + '日前'
+      else return ((a+800)/(60*60*24)).to_i.to_s + '日前'
+    end
+  end
+
+  def exit_with_message(msg, status=1)
+    err msg
+    exit(status)
+  end
+
+  BRANCH_NAME_FORMAT = "ticket/id/%s"
+
+  def ticket_branch(ticket_id)
+    BRANCH_NAME_FORMAT % ticket_id
+  end
+
+  def current_branch
+    %x(git branch -l | grep "*" | cut -d " " -f 2).strip
+  end
+
+  def guess_ticket
+    branch = current_branch
+    if branch =~ %r!id/(\d+)!
+      ticket = $1
+    end
+  end
+
+  def ticket_and_branch(options)
+    if options[:ticket_id]
+      ticket = options[:ticket_id]
+      branch_name = ticket_branch(ticket)
+    else
+      branch_name = current_branch
+      ticket = guess_ticket
+    end
+    [ticket, branch_name]
+  end
+
+  def response_success?(response)
+    code = response.code.to_i
+    code >= 200 && code < 300
+  end
+
+  # this is unnecessary hacks for multibytes charactors handling...
+  def mlength(s)
+    width = 0
+    cnt = 0
+    s.split(//u).each{|c| cnt += 1 ;width += 1 if c.length > 1 }
+    cnt + width
+  end
+
+  # this is unnecessary hacks for multibytes charactors handling...
+  def mljust(s, n)
+    return "" unless s
+    cnt = 0
+    chars = []
+
+    s.split(//u).each do |c|
+      next if cnt > n
+      chars << c
+      cnt += 1
+      cnt += 1 if c.length > 1
+    end
+    if cnt > n
+      chars.pop
+      cnt -= 1
+      cnt -= 1 if chars.last.length > 1
+    end
+    chars << " " * (n - cnt) if n > cnt
+    chars.join
+  end
+
+  # for 1.8.6...
+  def mktmpdir(prefix_suffix=nil, tmpdir=nil)
+    case prefix_suffix
+    when nil
+      prefix = "d"
+      suffix = ""
+    when String
+      prefix = prefix_suffix
+      suffix = ""
+    when Array
+      prefix = prefix_suffix[0]
+      suffix = prefix_suffix[1]
+    else
+      raise ArgumentError, "unexpected prefix_suffix: #{prefix_suffix.inspect}"
+    end
+    tmpdir ||= Dir.tmpdir
+    t = Time.now.strftime("%Y%m%d")
+    n = nil
+    begin
+      path = "#{tmpdir}/#{prefix}#{t}-#{$$}-#{rand(0x100000000).to_s(36)}"
+      path << "-#{n}" if n
+      path << suffix
+      Dir.mkdir(path, 0700)
+    rescue Errno::EEXIST
+      n ||= 0
+      n += 1
+      retry
+    end
+
+    if block_given?
+      begin
+        yield path
+      ensure
+        FileUtils.remove_entry_secure path
+      end
+    else
+      path
+    end
+  end
+
+  def to_date(d)
+    Date.parse(d).strftime('%Y/%m/%d') rescue d
+  end
+
+  def parse_options(args)
+    @options = {}
+    @opt_parse_obj.parse!(args)
+    args
+  end
+
+  def opt_parser
+    OptionParser.new{|opts|
+      opts.banner = 'git issue <command> [ticket_id] [<args>]'
+      opts.on("--all",        "-a", "update all paths in the index file "){ @options[:all] = true }
+      opts.on("--force",      "-f", "force create branch"){ @options[:force] = true }
+      opts.on("--verbose",    "-v", "show issue details"){|v| @options[:verbose] = true}
+      opts.on("--max-count=VALUE", "-n=VALUE", "maximum number of issues "){|v| @options[:max_count] = v.to_i}
+      opts.on("--oneline",          "display short info"){|v| @options[:oneline] = true}
+      opts.on("--raw-id",           "output ticket number only"){|v| @options[:raw_id] = true}
+      opts.on("--remote=VALUE",     'on publish, remote repository to push branch ') {|v| @options[:remote] = v}
+      opts.on("--onto=VALUE",       'on rebase, start new branch with HEAD equal to "newbase" ') {|v| @options[:onto] = v}
+
+      opts.on("--debug", "debug print"){@debug= true }
+    }
+
+  end
+
+  def puts(msg)
+    @sysout.puts msg
+  end
+
+  def err(msg)
+    @syserr.puts msg
+  end
+
+end
+