ghi 0.2.0 → 1.2.0

data/lib/ghi/commands/comment.rb

@@ -0,0 +1,168 @@
+module GHI
+  module Commands
+    class Comment < Command
+      attr_accessor :comment
+      attr_accessor :verbose
+      attr_accessor :web
+
+      def options
+        OptionParser.new do |opts|
+          opts.banner = <<EOF
+usage: ghi comment [options] <issueno>
+EOF
+          opts.separator ''
+          opts.on '-l', '--list', 'list comments' do
+            self.action = 'list'
+          end
+          opts.on('-w', '--web') { self.web = true }
+          # opts.on '-v', '--verbose', 'list events, too'
+          opts.separator ''
+          opts.separator 'Comment modification options'
+          opts.on '-m', '--message [<text>]', 'comment body' do |text|
+            assigns[:body] = text
+          end
+          opts.on '--amend', 'amend previous comment' do
+            self.action = 'update'
+          end
+          opts.on '-D', '--delete', 'delete previous comment' do
+            self.action = 'destroy'
+          end
+          opts.on '--close', 'close associated issue' do
+            self.action = 'close'
+          end
+          opts.on '-v', '--verbose' do
+            self.verbose = true
+          end
+          opts.separator ''
+        end
+      end
+
+      def execute
+        require_issue
+        require_repo
+        self.action ||= 'create'
+        options.parse! args
+
+        case action
+        when 'list'
+          get_requests(:index, :events)
+          res = index
+          page do
+            elements = sort_by_creation(res.body + paged_events(events, res))
+            puts format_comments_and_events(elements)
+            break unless res.next_page
+            res = throb { api.get res.next_page }
+          end
+        when 'create'
+          if web
+            Web.new(repo).open "issues/#{issue}#issue_comment_form"
+          else
+            create
+          end
+        when 'update', 'destroy'
+          res = index
+          res = throb { api.get res.last_page } if res.last_page
+          self.comment = res.body.reverse.find { |c|
+            c['user']['login'] == Authorization.username
+          }
+          if comment
+            send action
+          else
+            abort 'No recent comment found.'
+          end
+        when 'close'
+          Close.execute [issue, '-m', assigns[:body], '--', repo].compact
+        end
+      end
+
+      protected
+
+      def index
+        @index ||= throb { api.get uri, :per_page => 100 }
+      end
+
+      def create message = 'Commented.'
+        e = require_body
+        c = throb { api.post uri, assigns }.body
+        puts format_comment(c)
+        puts message
+        e.unlink if e
+      end
+
+      def update
+        create 'Comment updated.'
+      end
+
+      def destroy
+        throb { api.delete uri }
+        puts 'Comment deleted.'
+      end
+
+      def events
+        @events ||= begin
+          events = []
+          res = api.get(event_uri, :per_page => 100)
+          loop do
+            events += res.body
+            break unless res.next_page
+            res = api.get res.next_page
+          end
+          events
+        end
+      end
+
+      private
+
+      def get_requests(*methods)
+        threads = methods.map do |method|
+          Thread.new { send(method) }
+        end
+        threads.each { |t| t.join }
+      end
+
+      def uri
+        if comment
+          comment['url']
+        else
+          "/repos/#{repo}/issues/#{issue}/comments"
+        end
+      end
+
+      def event_uri
+        "/repos/#{repo}/issues/#{issue}/events"
+      end
+
+      def require_body
+        assigns[:body] = args.join ' ' unless args.empty?
+        return if assigns[:body]
+        if issue && verbose
+          i = throb { api.get "/repos/#{repo}/issues/#{issue}" }.body
+        else
+          i = {'number'=>issue}
+        end
+        filename = "GHI_COMMENT_#{issue}"
+        filename << "_#{comment['id']}" if comment
+        e = Editor.new filename
+        message = e.gets format_comment_editor(i, comment)
+        e.unlink 'No comment.' if message.nil? || message.empty?
+        if comment && message.strip == comment['body'].strip
+          e.unlink 'No change.'
+        end
+        assigns[:body] = message if message
+        e
+      end
+
+      def paged_events(events, comments_res)
+        if comments_res.next_page
+          last_comment_creation = comments_res.body.last['created_at']
+          events_for_this_page, @events = events.partition do |event|
+            event['created_at'] < last_comment_creation
+          end
+          events_for_this_page
+        else
+          events
+        end
+      end
+    end
+  end
+end

data/lib/ghi/commands/config.rb

@@ -0,0 +1,57 @@
+module GHI
+  module Commands
+    class Config < Command
+      def options
+        OptionParser.new do |opts|
+          opts.banner = <<EOF
+usage: ghi config [options]
+EOF
+          opts.separator ''
+          opts.on '--local', 'set for local repo only' do
+            assigns[:local] = true
+          end
+          opts.on '--auth [<username>]' do |username|
+            self.action = 'auth'
+            assigns[:username] = username || Authorization.username
+          end
+          opts.separator ''
+        end
+      end
+
+      def execute
+        # TODO: Investigate whether or not this variable is needed
+        global = true
+        
+        options.parse! args.empty? ? %w(-h) : args
+
+        if action == 'auth'
+          assigns[:password] = Authorization.password || get_password
+          Authorization.authorize!(
+            assigns[:username], assigns[:password], assigns[:local]
+          )
+        end
+      end
+
+      private
+
+      def get_password
+        print "Enter #{assigns[:username]}'s GitHub password (never stored): "
+        current_tty = `stty -g`
+        system 'stty raw -echo -icanon isig' if $?.success?
+        input = ''
+        while char = $stdin.getbyte and not (char == 13 or char == 10)
+          if char == 127 or char == 8
+            input[-1, 1] = '' unless input.empty?
+          else
+            input << char.chr
+          end
+        end
+        input
+      rescue Interrupt
+        print '^C'
+      ensure
+        system "stty #{current_tty}" unless current_tty.empty?
+      end
+    end
+  end
+end

data/lib/ghi/commands/disable.rb

@@ -0,0 +1,35 @@
+module GHI
+  module Commands
+    class Disable < Command
+
+      def options
+        OptionParser.new do |opts|
+          opts.banner = 'usage: ghi disable'
+        end
+      end
+
+      def execute
+        begin
+          options.parse! args
+          @repo ||= ARGV[0] if ARGV.one?
+        rescue OptionParser::InvalidOption => e
+          fallback.parse! e.args
+          retry
+        end
+        repo_name = require_repo_name
+        unless repo_name.nil?
+          patch_data = {}
+          patch_data[:name] = repo_name
+          patch_data[:has_issues] = false
+          res = throb { api.patch "/repos/#{repo}", patch_data }.body
+          if !res['has_issues']
+            puts "Issues are now disabled for this repo"
+          else
+            puts "Something went wrong disabling issues for this repo"
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/ghi/commands/edit.rb

@@ -0,0 +1,139 @@
+module GHI
+  module Commands
+    class Edit < Command
+      attr_accessor :editor
+
+      def options
+        OptionParser.new do |opts|
+          opts.banner = <<EOF
+usage: ghi edit <issueno> [options]
+EOF
+          opts.separator ''
+          opts.on(
+            '-m', '--message [<text>]', 'change issue description'
+          ) do |text|
+            next self.editor = true if text.nil?
+            assigns[:title], assigns[:body] = text.split(/\n+/, 2)
+          end
+          opts.on(
+            '-u', '--[no-]assign [<user>]', 'assign to specified user'
+          ) do |assignee|
+            assigns[:assignee] = assignee || nil
+          end
+          opts.on '--claim', 'assign to yourself' do
+            assigns[:assignee] = Authorization.username
+          end
+          opts.on(
+            '-s', '--state <in>', %w(open closed),
+            {'o'=>'open', 'c'=>'closed'}, "'open' or 'closed'"
+          ) do |state|
+            assigns[:state] = state
+          end
+          opts.on(
+            '-M', '--[no-]milestone [<n>]', Integer, 'associate with milestone'
+          ) do |milestone|
+            assigns[:milestone] = milestone
+          end
+          opts.on(
+            '-L', '--label <labelname>...', Array, 'associate with label(s)'
+          ) do |labels|
+            (assigns[:labels] ||= []).concat labels
+          end
+          opts.separator ''
+          opts.separator 'Pull request options'
+          opts.on(
+            '-H', '--head [[<user>:]<branch>]',
+            'branch where your changes are implemented',
+            '(defaults to current branch)'
+          ) do |head|
+            self.action = 'pull'
+            assigns[:head] = head
+          end
+          opts.on(
+            '-b', '--base [<branch>]',
+            'branch you want your changes pulled into', '(defaults to master)'
+          ) do |base|
+            self.action = 'pull'
+            assigns[:base] = base
+          end
+          opts.separator ''
+        end
+      end
+
+      def execute
+        self.action = 'edit'
+        require_repo
+        require_issue
+        options.parse! args
+        case action
+        when 'edit'
+          begin
+            if editor || assigns.empty?
+              i = throb { api.get "/repos/#{repo}/issues/#{issue}" }.body
+              e = Editor.new "GHI_ISSUE_#{issue}"
+              message = e.gets format_editor(i)
+              e.unlink "There's no issue." if message.nil? || message.empty?
+              assigns[:title], assigns[:body] = message.split(/\n+/, 2)
+            end
+            if i && assigns.keys.map { |k| k.to_s }.sort == %w[body title]
+              titles_match = assigns[:title].strip == i['title'].strip
+              if assigns[:body]
+                bodies_match = assigns[:body].to_s.strip == i['body'].to_s.strip
+              end
+              if titles_match && bodies_match
+                e.unlink if e
+                abort 'No change.' if assigns.dup.delete_if { |k, v|
+                  [:title, :body].include? k
+                }
+              end
+            end
+            unless assigns.empty?
+              i = throb {
+                api.patch "/repos/#{repo}/issues/#{issue}", assigns
+              }.body
+              puts format_issue(i)
+              puts 'Updated.'
+            end
+            e.unlink if e
+          rescue Client::Error => e
+            raise unless error = e.errors.first
+            abort "%s %s %s %s." % [
+              error['resource'],
+              error['field'],
+              [*error['value']].join(', '),
+              error['code']
+            ]
+          end
+        when 'pull'
+          begin
+            assigns[:issue] = issue
+            assigns[:base] ||= 'master'
+            head = begin
+              if ref = %x{
+                git rev-parse --abbrev-ref HEAD@{upstream} 2>/dev/null
+              }.chomp!
+                ref.split('/', 2).last if $? == 0
+              end
+            end
+            assigns[:head] ||= head
+            if assigns[:head]
+              assigns[:head].sub!(/:$/, ":#{head}")
+            else
+              abort <<EOF.chomp
+fatal: HEAD can't be null. (Is your current branch being tracked upstream?)
+EOF
+            end
+            throb { api.post "/repos/#{repo}/pulls", assigns }
+            base = [repo.split('/').first, assigns[:base]].join ':'
+            puts 'Issue #%d set up to track remote branch %s against %s.' % [
+              issue, assigns[:head], base
+            ]
+          rescue Client::Error => e
+            raise unless error = e.errors.last
+            abort error['message'].sub(/^base /, '')
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ghi/commands/enable.rb

@@ -0,0 +1,36 @@
+module GHI
+  module Commands
+    class Enable < Command
+
+      def options
+        OptionParser.new do |opts|
+          opts.banner = 'usage: ghi enable'
+        end
+      end
+
+      def execute
+        begin
+          options.parse! args
+          @repo ||= ARGV[0] if ARGV.one?
+        rescue OptionParser::InvalidOption => e
+          fallback.parse! e.args
+          retry
+        end
+        repo_name = require_repo_name
+        unless repo_name.nil?
+          patch_data = {}
+          patch_data[:name] = repo_name
+          patch_data[:has_issues] = true
+          res = throb { api.patch "/repos/#{repo}", patch_data }.body
+          if res['has_issues']
+            puts "Issues are now enabled for this repo"
+          else
+            puts "Something went wrong enabling issues for this repo"
+          end
+        end
+      end
+
+    end
+
+  end
+end

data/lib/ghi/commands/help.rb

@@ -0,0 +1,65 @@
+module GHI
+  module Commands
+    class Help < Command
+      def self.execute args, message = nil
+        new(args).execute message
+      end
+
+      attr_accessor :command
+
+      def options
+        OptionParser.new do |opts|
+          opts.banner = 'usage: ghi help [--all] [--man|--web] <command>'
+          opts.separator ''
+          opts.on('-a', '--all', 'print all available commands') { all }
+          opts.on('-m', '--man', 'show man page')                { man }
+          opts.on('-w', '--web', 'show manual in web browser')   { web }
+          opts.separator ''
+        end
+      end
+
+      def execute message = nil
+        self.command = args.shift if args.first !~ /^-/
+
+        if command.nil? && args.empty?
+          puts message if message
+          puts <<EOF
+
+The most commonly used ghi commands are:
+   list        List your issues (or a repository's)
+   show        Show an issue's details
+   open        Open (or reopen) an issue
+   close       Close an issue
+   edit        Modify an existing issue
+   comment     Leave a comment on an issue
+   label       Create, list, modify, or delete labels
+   assign      Assign an issue to yourself (or someone else)
+   milestone   Manage project milestones
+   status      Determine whether or not issues are enabled for this repo
+   enable      Enable issues for the current repo
+   disable     Disable issues for the current repo
+
+See 'ghi help <command>' for more information on a specific command.
+EOF
+          exit
+        end
+
+        options.parse! args.empty? ? %w(-m) : args
+      end
+
+      def all
+        raise 'TODO'
+      end
+
+      def man
+        GHI.execute [command, '-h']
+        # TODO:
+        # exec "man #{['ghi', command].compact.join '-'}"
+      end
+
+      def web
+        raise 'TODO'
+      end
+    end
+  end
+end

data/lib/ghi/commands/label.rb

@@ -0,0 +1,196 @@
+module GHI
+  module Commands
+    class Label < Command
+      attr_accessor :name
+
+      #--
+      # FIXME: This does too much. Opt for a secondary command, e.g.,
+      #
+      #   ghi label add <labelname>
+      #   ghi label rm <labelname>
+      #   ghi label <issueno> <labelname>...
+      #++
+      def options
+        OptionParser.new do |opts|
+          opts.banner = <<EOF
+usage: ghi label <labelname> [-c <color>] [-r <newname>]
+   or: ghi label -D <labelname>
+   or: ghi label <issueno(s)> [-a] [-d] [-f] <label>
+   or: ghi label -l [<issueno>]
+EOF
+          opts.separator ''
+          opts.on '-l', '--list [<issueno>]', 'list label names' do |n|
+            self.action = 'index'
+            @issue ||= n
+          end
+          opts.on '-D', '--delete', 'delete label' do
+            self.action = 'destroy'
+          end
+          opts.separator ''
+          opts.separator 'Label modification options'
+          opts.on(
+            '-c', '--color <color>', 'color name or 6-character hex code'
+          ) do |color|
+            assigns[:color] = to_hex color
+            self.action ||= 'create'
+          end
+          opts.on '-r', '--rename <labelname>', 'new label name' do |name|
+            assigns[:name] = name
+            self.action = 'update'
+          end
+          opts.separator ''
+          opts.separator 'Issue modification options'
+          opts.on '-a', '--add', 'add labels to issue' do
+            self.action = issues_present? ? 'add' : 'create'
+          end
+          opts.on '-d', '--delete', 'remove labels from issue' do
+            self.action = issues_present? ? 'remove' : 'destroy'
+          end
+          opts.on '-f', '--force', 'replace existing labels' do
+            self.action = issues_present? ? 'replace' : 'update'
+          end
+          opts.separator ''
+        end
+      end
+
+      def execute
+        extract_issue
+        require_repo
+        options.parse! args.empty? ? %w(-l) : args
+
+        if issues_present?
+          self.action ||= 'add'
+          self.name = args.shift.to_s.split ','
+          self.name.concat args
+          multi_action(action)
+        else
+          self.action ||= 'create'
+          self.name ||= args.shift
+          send action
+        end
+      end
+
+      protected
+
+      def index
+        if issue
+          uri = "/repos/#{repo}/issues/#{issue}/labels"
+        else
+          uri = "/repos/#{repo}/labels"
+        end
+        labels = throb { api.get uri }.body
+        if labels.empty?
+          puts 'None.'
+        else
+          puts labels.map { |label|
+            name = label['name']
+            colorize? ? bg(label['color']) { " #{name} " } : name
+          }
+        end
+      end
+
+      def create
+        label = throb {
+          api.post "/repos/#{repo}/labels", assigns.merge(:name => name)
+        }.body
+        return update if label.nil?
+        puts "%s created." % bg(label['color']) { " #{label['name']} "}
+      rescue Client::Error => e
+        if e.errors.find { |error| error['code'] == 'already_exists' }
+          return update
+        end
+        raise
+      end
+
+      def update
+        label = throb {
+          api.patch "/repos/#{repo}/labels/#{name}", assigns
+        }.body
+        puts "%s updated." % bg(label['color']) { " #{label['name']} "}
+      end
+
+      def destroy
+        throb { api.delete "/repos/#{repo}/labels/#{name}" }
+        puts "[#{name}] deleted."
+      end
+
+      def add
+        labels = throb {
+          api.post "/repos/#{repo}/issues/#{issue}/labels", name
+        }.body
+        puts "Issue #%d labeled %s." % [issue, format_labels(labels)]
+      end
+
+      def remove
+        case name.length
+        when 0
+          throb { api.delete base_uri }
+          puts "Labels removed."
+        when 1
+          labels = throb { api.delete "#{base_uri}/#{name.join}" }.body
+          if labels.empty?
+            puts "Issue #%d unlabeled." % issue
+          else
+            puts "Issue #%d labeled %s." % [issue, format_labels(labels)]
+          end
+        else
+          labels = throb {
+            api.get "/repos/#{repo}/issues/#{issue}/labels"
+          }.body
+          self.name = labels.map { |l| l['name'] } - name
+          replace
+        end
+      end
+
+      def replace
+        labels = throb { api.put base_uri, name }.body
+        if labels.empty?
+          puts "Issue #%d unlabeled." % issue
+        else
+          puts "Issue #%d labeled %s." % [issue, format_labels(labels)]
+        end
+      end
+
+      private
+
+      def base_uri
+        "/repos/#{repo}/#{issue ? "issues/#{issue}/labels" : 'labels'}"
+      end
+
+      # This method is usually inherited from Command and extracts a single issue
+      # from args - we override it to handle multiple issues at once.
+      def extract_issue
+        @issues = []
+        args.delete_if do |arg|
+          arg.match(/^\d+$/) ? @issues << arg : break
+        end
+        infer_issue_from_branch_prefix unless @issues.any?
+      end
+
+      def issues_present?
+        @issues.any? || @issue
+      end
+
+      def multi_action(action)
+        if @issues.any?
+          override_issue_reader
+          threads = @issues.map do |issue|
+            Thread.new do
+              Thread.current[:issue] = issue
+              send action
+            end
+          end
+          threads.each(&:join)
+        else
+          send action
+        end
+      end
+
+      def override_issue_reader
+        def issue
+          Thread.current[:issue]
+        end
+      end
+    end
+  end
+end