ghi 0.3.1 → 0.9.0.dev

data/lib/ghi/commands/close.rb

@@ -0,0 +1,45 @@
+module GHI
+  module Commands
+    class Close < Command
+      def options
+        OptionParser.new do |opts|
+          opts.banner = <<EOF
+usage: ghi close [options] <issueno>
+EOF
+          opts.separator ''
+          opts.on '-l', '--list', 'list closed issues' do
+            assigns[:command] = List
+          end
+          opts.separator ''
+          opts.separator 'Issue modification options'
+          opts.on '-m', '--message <text>', 'close with message' do |text|
+            assigns[:comment] = text
+          end
+          opts.separator ''
+        end
+      end
+
+      def execute
+        options.parse! args
+        require_repo
+
+        if list?
+          List.execute %W(-sc -- #{repo})
+        else
+          require_issue
+          Edit.execute %W(-sc #{issue} -- #{repo})
+          puts 'Closed.'
+          if assigns[:comment]
+            Comment.execute %W(#{issue} -m #{assigns[:comment]} -- #{repo})
+          end
+        end
+      end
+
+      private
+
+      def list?
+        assigns[:command] == List
+      end
+    end
+  end
+end

data/lib/ghi/commands/command.rb

@@ -0,0 +1,114 @@
+module GHI
+  module Commands
+    class MissingArgument < RuntimeError
+    end
+
+    class Command
+      include Formatting
+
+      def self.execute args
+        command = new args
+        if i = args.index('--')
+          command.repo = args.slice!(i, args.length)[1] # Raise if too many?
+        end
+        command.execute
+      end
+
+      attr_reader :args
+      attr_writer :issue
+      attr_accessor :action
+      attr_accessor :verbose
+
+      def initialize args
+        @args = args.map! { |a| a.dup }
+      end
+
+      def assigns
+        @assigns ||= {}
+      end
+
+      def api
+        @api ||= Client.new
+      end
+
+      def repo
+        return @repo if defined? @repo
+        @repo = ENV['GHI_REPO'] || `git config --local ghi.repo`.chomp
+        @repo = detect_repo if @repo.empty?
+        @repo
+      end
+      alias extract_repo repo
+
+      def repo= repo
+        @repo = repo.dup
+        unless @repo.include? '/'
+          @repo.insert 0, "#{Authorization.username}/"
+        end
+        @repo
+      end
+
+      private
+
+      def require_repo
+        return true if repo
+        warn 'Not a GitHub repo.'
+        warn ''
+        abort options.to_s
+      end
+
+      def detect_repo
+        remotes = `git config --get-regexp remote\..+\.url`.split "\n"
+        remotes.reject! { |r| !r.include? 'github.com'}
+
+        remotes.map! { |r|
+          remote, user, repo = r.scan(
+            %r{remote\.([^\.]+)\.url .*?([^:/]+)/([^/\s]+?)(?:\.git)?$}
+          ).flatten
+          { :remote => remote, :user => user, :repo => "#{user}/#{repo}" }
+        }
+
+        remote   = remotes.find { |r| r[:remote] == 'upstream' }
+        remote ||= remotes.find { |r| r[:remote] == 'origin' }
+        remote ||= remotes.find { |r| r[:user]   == Authorization.username }
+        remote[:repo] if remote
+      end
+
+      def issue
+        return @issue if defined? @issue
+        index = args.index { |arg| /^\d+$/ === arg }
+        @issue = (args.delete_at index if index)
+      end
+      alias extract_issue     issue
+      alias milestone         issue
+      alias extract_milestone issue
+
+      def require_issue
+        raise MissingArgument, 'Issue required.' unless issue
+      end
+
+      def require_milestone
+        raise MissingArgument, 'Milestone required.' unless milestone
+      end
+
+      # Handles, e.g. `--[no-]milestone [<n>]`.
+      def any_or_none_or input
+        input ? input : { nil => '*', false => 'none' }[input]
+      end
+
+      def page? message = 'Load more?'
+        return unless STDIN.tty?
+
+        STDOUT.print "#{message} [Yn] "
+        begin
+          system 'stty raw -echo'
+          # Continue on y, j, <ENTER>, <DOWN>...
+          exit unless [?y, ?Y, ?j, 13, 27].include? STDIN.getc
+          STDOUT.print "\r" + ' ' * columns
+          STDOUT.print "\r  Loading..."
+        ensure
+          system 'stty -raw echo'
+        end
+      end
+    end
+  end
+end

data/lib/ghi/commands/comment.rb

@@ -0,0 +1,104 @@
+module GHI
+  module Commands
+    class Comment < Command
+      attr_accessor :comment
+
+      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 '-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.separator ''
+        end
+      end
+
+      def execute
+        require_issue
+        require_repo
+        self.action ||= 'create'
+        options.parse! args
+
+        case action
+        when 'list'
+          res = index
+          loop do
+            puts format_comments(res.body)
+            break unless res.next_page
+            page?
+            res = throb { api.get res.next_page }
+          end
+        when 'create'
+          create
+        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 %W(-m #{assigns[:body]} #{issue} -- #{repo})
+        end
+      end
+
+      protected
+
+      def index
+        throb { api.get uri }
+      end
+
+      def create
+        require_body
+        throb { api.post uri, assigns }
+        puts 'Comment created.'
+      end
+
+      def update
+        require_body
+        throb { api.patch uri, assigns }
+        puts 'Comment updated.'
+      end
+
+      def destroy
+        throb { api.delete uri }
+        puts 'Comment deleted.'
+      end
+
+      private
+
+      def uri
+        comment ? comment['url'] : "/repos/#{repo}/issues/#{issue}/comments"
+      end
+
+      def require_body
+        if assigns[:body].nil?
+          warn 'Missing argument: -m'
+          abort options.to_s
+        end
+      end
+    end
+  end
+end

data/lib/ghi/commands/config.rb

@@ -0,0 +1,35 @@
+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>:<password>]' do |credentials|
+            self.action = 'auth'
+            username, password = credentials.split ':', 2 if credentials
+            assigns[:username] = username
+            assigns[:password] = password
+          end
+          opts.separator ''
+        end
+      end
+
+      def execute
+        global = true
+        options.parse! args.empty? ? %w(-h) : args
+
+        if self.action == 'auth'
+          Authorization.authorize!(
+            assigns[:username], assigns[:password], assigns[:local]
+          )
+        end
+      end
+    end
+  end
+end

data/lib/ghi/commands/edit.rb

@@ -0,0 +1,49 @@
+module GHI
+  module Commands
+    class Edit < Command
+      def options
+        OptionParser.new do |opts|
+          opts.banner = <<EOF
+usage: ghi edit [options] <issueno>
+EOF
+          opts.separator ''
+          opts.on(
+            '-m', '--message <text>', 'change issue description'
+          ) do |text|
+            assigns[:title], assigns[:body] = text.split(/\n+/, 2)
+          end
+          opts.on(
+            '-u', '--[no-]assign [<user>]', 'assign to specified user'
+          ) do |assignee|
+            assigns[:assignee] = assignee
+          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] = labels
+          end
+          opts.separator ''
+        end
+      end
+
+      def execute
+        require_issue
+        require_repo
+        options.parse! args
+        i = throb { api.patch "/repos/#{repo}/issues/#{issue}", assigns }.body
+        puts format_issue(i)
+      end
+    end
+  end
+end

data/lib/ghi/commands/help.rb

@@ -0,0 +1,62 @@
+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
+
+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,153 @@
+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> [-a] [-d] [-f]
+   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 = issue ? 'add' : 'create'
+          end
+          opts.on '-d', '--delete', 'remove labels from issue' do
+            self.action = issue ? 'remove' : 'destroy'
+          end
+          opts.on '-f', '--force', 'replace existing labels' do
+            self.action = issue ? 'replace' : 'update'
+          end
+          opts.separator ''
+        end
+      end
+
+      def execute
+        extract_issue
+        require_repo
+        options.parse! args.empty? ? %w(-l) : args
+
+        if issue
+          self.action ||= 'add'
+          self.name = args.shift.to_s.split ','
+        else
+          self.action ||= 'create'
+          self.name ||= args.shift
+        end
+
+        send action
+      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
+        labels.delete_if { |l| !name.include?(l['name']) }
+        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
+          puts "Issue #%d labeled %s." % [issue, format_labels(labels)]
+        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
+        puts "Issue #%d labeled %s." % [issue, format_labels(labels)]
+      end
+
+      private
+
+      def base_uri
+        "/repos/#{repo}/#{issue ? "issues/#{issue}/labels" : 'labels'}"
+      end
+    end
+  end
+end