ghi 0.3.1 → 0.9.0.dev

data/lib/ghi/commands/list.rb

@@ -0,0 +1,133 @@
+require 'curses'
+require 'date'
+
+module GHI
+  module Commands
+    class List < Command
+      attr_accessor :reverse
+      attr_accessor :quiet
+
+      def options
+        OptionParser.new do |opts|
+          opts.banner = 'usage: ghi list [options]'
+          opts.separator ''
+          opts.on '-a', '--global', '--all', 'all of your issues on GitHub' do
+            @repo = nil
+          end
+          opts.on(
+            '-s', '--state <in>', %w(open closed),
+            {'o'=>'open', 'c'=>'closed'}, "'open' or 'closed'"
+          ) do |state|
+            assigns[:state] = state
+          end
+          opts.on(
+            '-L', '--label <labelname>...', Array, 'by label(s)'
+          ) do |labels|
+            assigns[:labels] = labels.join ','
+          end
+          opts.on(
+            '-S', '--sort <by>', %w(created updated comments),
+            {'c'=>'created','u'=>'updated','m'=>'comments'},
+            "'created', 'updated', or 'comments'"
+          ) do |sort|
+            assigns[:sort] = sort
+          end
+          opts.on '--reverse', 'reverse (ascending) sort order' do
+            self.reverse = !reverse
+          end
+          opts.on(
+            '--since <date>', 'issues more recent than',
+            "e.g., '2011-04-30'"
+          ) do |date|
+            begin
+              assigns[:since] = DateTime.parse date # TODO: Better parsing.
+            rescue ArgumentError => e
+              raise OptionParser::InvalidArgument, e.message
+            end
+          end
+          opts.on '-v', '--verbose' do
+            self.verbose = true
+          end
+          opts.separator ''
+          opts.separator 'Global options'
+          opts.on(
+            '-f', '--filter <by>',
+            filters = %w(assigned created mentioned subscribed),
+            Hash[filters.map { |f| [f[0, 1], f] }],
+            "'assigned', 'created', 'mentioned', or", "'subscribed'"
+          ) do |filter|
+            assigns[:filter] = filter
+          end
+          opts.separator ''
+          opts.separator 'Project options'
+          opts.on(
+            '-M', '--[no-]milestone [<n>]', Integer,
+            'with (specified) milestone'
+          ) do |milestone|
+            assigns[:milestone] = any_or_none_or milestone
+          end
+          opts.on(
+            '-u', '--[no-]assignee [<user>]', 'assigned to specified user'
+          ) do |assignee|
+            assigns[:assignee] = any_or_none_or assignee
+          end
+          opts.on '--mine', 'assigned to you' do
+            assigns[:assignee] = Authorization.username
+          end
+          opts.on(
+            '-U', '--mentioned [<user>]', 'mentioning you or specified user' 
+          ) do |mentioned|
+            assigns[:mentioned] = mentioned || Authorization.username
+          end
+          opts.separator ''
+        end
+      end
+
+      def execute
+        begin
+          options.parse! args
+        rescue OptionParser::InvalidOption => e
+          fallback.parse! e.args
+          retry
+        end
+
+        if reverse
+          assigns[:sort] ||= 'created'
+          assigns[:direction] = 'asc'
+        end
+
+        unless quiet
+          print format_issues_header
+          print "\n" unless STDOUT.tty?
+        end
+        res = throb(
+          0, format_state(assigns[:state], quiet ? CURSOR[:up][1] : '#')
+        ) { api.get uri, assigns }
+        loop do
+          issues = res.body
+          if verbose
+            puts issues.map { |i| format_issue i }
+          else
+            puts format_issues(issues, repo.nil?)
+          end
+          break unless res.next_page
+          page?
+          res = throb { api.get res.next_page }
+        end
+      end
+
+      private
+
+      def uri
+        repo ? "/repos/#{repo}/issues" : '/issues'
+      end
+
+      def fallback
+        OptionParser.new do |opts|
+          opts.on('-c', '--closed') { assigns[:state] = 'closed' }
+          opts.on('-q', '--quiet')  { self.quiet = true }
+        end
+      end
+    end
+  end
+end

data/lib/ghi/commands/milestone.rb

@@ -0,0 +1,150 @@
+require 'date'
+
+module GHI
+  module Commands
+    class Milestone < Command
+      attr_accessor :reverse
+
+      #--
+      # FIXME: Opt for better interface, e.g.,
+      #
+      #   ghi milestone [-v | --verbose] [--[no-]closed]
+      #   ghi milestone add <name> <description>
+      #   ghi milestone rm <milestoneno>
+      #++
+      def options
+        OptionParser.new do |opts|
+          opts.banner = <<EOF
+usage: ghi milestone [<modification options>] [<milestoneno>]
+   or: ghi milestone -D <milestoneno>
+   or: ghi milestone -l [-c] [-v]
+EOF
+          opts.separator ''
+          opts.on '-l', '--list', 'list milestones' do
+            self.action = 'index'
+          end
+          opts.on '-c', '--[no-]closed', 'show closed milestones' do |closed|
+            assigns[:state] = closed ? 'closed' : 'open'
+          end
+          opts.on(
+            '-S', '--sort <on>', %w(due_date completeness),
+            {'d'=>'due_date', 'due'=>'due_date', 'c'=>'completeness'},
+            "'due_date' or 'completeness'"
+          ) do |sort|
+            assigns[:sort] = sort
+          end
+          opts.on '--reverse', 'reverse (ascending) sort order' do
+            self.reverse = !reverse
+          end
+          opts.on '-v', '--verbose', 'list milestones verbosely' do
+            self.verbose = true
+          end
+          opts.separator ''
+          opts.separator 'Milestone modification options'
+          opts.on(
+            '-m', '--message <text>', 'change milestone description'
+          ) do |text|
+            self.action = 'create'
+            assigns[:title], assigns[:description] = text.split(/\n+/, 2)
+          end
+          # FIXME: We already describe --[no-]closed; describe this, too?
+          opts.on(
+            '-s', '--state <in>', %w(open closed),
+            {'o'=>'open', 'c'=>'closed'}, "'open' or 'closed'"
+          ) do |state|
+            self.action = 'create'
+            assigns[:state] = state
+          end
+          opts.on(
+            '--due <on>', 'when milestone should be complete',
+            "e.g., '2012-04-30'"
+          ) do |date|
+            self.action = 'create'
+            begin
+              # TODO: Better parsing.
+              assigns[:due_on] = DateTime.parse(date).strftime
+            rescue ArgumentError => e
+              raise OptionParser::InvalidArgument, e.message
+            end
+          end
+          opts.on '-D', '--delete', 'delete milestone' do
+            self.action = 'destroy'
+          end
+          opts.separator ''
+        end
+      end
+
+      def execute
+        self.action = 'index'
+        extract_milestone
+
+        begin
+          options.parse! args
+        rescue OptionParser::AmbiguousOption => e
+          fallback.parse! e.args
+        end
+
+        milestone and case action
+          when 'create' then self.action = 'update'
+          when 'index'  then self.action = 'show'
+        end
+
+        if reverse
+          assigns[:sort] ||= 'created'
+          assigns[:direction] = 'asc'
+        end
+
+        case action
+        when 'index'
+          state = assigns[:state] || 'open'
+          print format_state state, "# #{repo} #{state} milestones"
+          print "\n" unless STDOUT.tty?
+          res = throb(0, format_state(state, '#')) { api.get uri }
+          loop do
+            milestones = res.body
+            if verbose
+              puts milestones.map { |m| format_milestone m }
+            else
+              puts format_milestones(milestones)
+            end
+            break unless res.next_page
+            page?
+            res = throb { api.get res.next_page }
+          end
+        when 'show'
+          m = throb { api.get uri }.body
+          print format_milestone(m)
+          puts 'Issues:'
+          List.execute %W(-q -M #{milestone} -- #{repo})
+        when 'create'
+          m = throb { api.post uri, assigns }.body
+          puts 'Milestone #%d created.' % m['number']
+        when 'update'
+          throb { api.patch uri, assigns }
+          puts 'Milestone updated.'
+        when 'destroy'
+          throb { api.delete uri }
+          puts 'Milestone deleted.'
+        end
+      end
+
+      private
+
+      def uri
+        if milestone
+          "/repos/#{repo}/milestones/#{milestone}"
+        else
+          "/repos/#{repo}/milestones"
+        end
+      end
+
+      def fallback
+        OptionParser.new do |opts|
+          opts.on '-d' do
+            self.action = 'destroy'
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ghi/commands/open.rb

@@ -0,0 +1,69 @@
+module GHI
+  module Commands
+    class Open < Command
+      def options
+        #--
+        # TODO: Support shortcuts, e.g,
+        #
+        #   ghi open "Issue Title"
+        #++
+        OptionParser.new do |opts|
+          opts.banner = <<EOF
+usage: ghi open [options]
+   or: ghi reopen [options] <issueno>
+EOF
+          opts.separator ''
+          opts.on '-l', '--list', 'list open tickets' do
+            self.action = 'index'
+          end
+          opts.separator ''
+          opts.separator 'Issue modification options'
+          opts.on '-m', '--message <text>', 'describe issue' 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(
+            '-M', '--milestone <n>', '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
+        self.action = 'create'
+
+        if extract_issue
+          Edit.new(args.unshift('-so', issue)).execute
+          puts 'Reopened.'
+          exit
+        end
+
+        options.parse! args
+
+        case action
+        when 'index'
+          List.new(args).execute
+        when 'create'
+          if assigns[:title].nil? # FIXME: Open $EDITOR
+            warn "Missing argument: -m"
+            abort options.to_s
+          end
+          i = throb { api.post "/repos/#{repo}/issues", assigns }.body
+          puts format_issue(i)
+          puts 'Opened.'
+        end
+      end
+    end
+  end
+end

data/lib/ghi/commands/show.rb

@@ -0,0 +1,21 @@
+module GHI
+  module Commands
+    class Show < Command
+      def options
+        OptionParser.new do |opts|
+          opts.banner = 'usage: ghi show <issueno> [[<user>/]<repo>]'
+          opts.separator ''
+        end
+      end
+
+      def execute
+        require_issue
+        require_repo
+        i = throb { api.get "/repos/#{repo}/issues/#{issue}" }.body
+        puts format_issue(i)
+        page? 'Load comments?'
+        Comment.execute %W(-l #{issue} -- #{repo})
+      end
+    end
+  end
+end

data/lib/ghi/commands/version.rb

@@ -0,0 +1,16 @@
+module GHI
+  module Commands
+    module Version
+      MAJOR   = 0
+      MINOR   = 9
+      PATCH   = 0
+      PRE     = 'dev'
+
+      VERSION = [MAJOR, MINOR, PATCH, PRE].compact.join '.'
+
+      def self.execute args
+        puts "ghi version #{VERSION}"
+      end
+    end
+  end
+end

data/lib/ghi/formatting.rb

@@ -0,0 +1,301 @@
+# encoding: utf-8
+require 'date'
+require 'erb'
+
+module GHI
+  module Formatting
+    autoload :Colors, 'ghi/formatting/colors'
+    include Colors
+
+    CURSOR = {
+      :up     => lambda { |n| "\e[#{n}A" },
+      :column => lambda { |n| "\e[#{n}G" },
+      :hide   => "\e[?25l",
+      :show   => "\e[?25h"
+    }
+
+    THROBBERS = [
+      %w(⠋ ⠙ ⠹ ⠸ ⠼ ⠴ ⠦ ⠧ ⠇ ⠏),
+      %w(⠋ ⠙ ⠚ ⠞ ⠖ ⠦ ⠴ ⠲ ⠳ ⠓),
+      %w(⠄ ⠆ ⠇ ⠋ ⠙ ⠸ ⠰ ⠠ ⠰ ⠸ ⠙ ⠋ ⠇ ⠆ ),
+      %w(⠋ ⠙ ⠚ ⠒ ⠂ ⠂ ⠒ ⠲ ⠴ ⠦ ⠖ ⠒ ⠐ ⠐ ⠒ ⠓ ⠋),
+      %w(⠁ ⠉ ⠙ ⠚ ⠒ ⠂ ⠂ ⠒ ⠲ ⠴ ⠤ ⠄ ⠄ ⠤ ⠴ ⠲ ⠒ ⠂ ⠂ ⠒ ⠚ ⠙ ⠉ ⠁),
+      %w(⠈ ⠉ ⠋ ⠓ ⠒ ⠐ ⠐ ⠒ ⠖ ⠦ ⠤ ⠠ ⠠ ⠤ ⠦ ⠖ ⠒ ⠐ ⠐ ⠒ ⠓ ⠋ ⠉ ⠈),
+      %w(⠁ ⠁ ⠉ ⠙ ⠚ ⠒ ⠂ ⠂ ⠒ ⠲ ⠴ ⠤ ⠄ ⠄ ⠤ ⠠ ⠠ ⠤ ⠦ ⠖ ⠒ ⠐ ⠐ ⠒ ⠓ ⠋ ⠉ ⠈ ⠈ ⠉)
+    ]
+
+    def puts *strings
+      strings = strings.flatten.map { |s|
+        s.gsub(/@([^@\s]+)/) {
+          if $1 == Authorization.username
+            bright { fg(:yellow) { "@#$1" } }
+          else
+            bright { "@#$1" }
+          end
+        }
+      }
+      stdout, $stdout = $stdout, IO.popen('less -ErX', 'w')
+      super strings
+    rescue Errno::EPIPE
+    ensure
+      $stdout.close_write
+      $stdout = stdout
+      print CURSOR[:show]
+    end
+
+    def truncate string, reserved
+      result = string.scan(/.{0,#{columns - reserved}}(?:\s|\Z)/).first.strip
+      result << "..." if result != string
+      result
+    end
+
+    def indent string, level = 4
+      string = string.gsub(/\r/, '')
+      string.gsub!(/[\t ]+$/, '')
+      string.gsub!(/\n{3,}/, "\n\n")
+      width = columns - level - 1
+      lines = string.scan(
+        /.{0,#{width}}(?:\s|\Z)|[\S]{#{width},}/ # TODO: Test long lines.
+      ).map { |line| " " * level + line.chomp }
+      format_markdown lines.join("\n").rstrip, level
+    end
+
+    def columns
+      dimensions[1] || 80
+    end
+
+    def dimensions
+      `stty size`.chomp.split(' ').map { |n| n.to_i }
+    end
+
+    #--
+    # Specific formatters:
+    #++
+
+    def format_issues_header
+      state = assigns[:state] || 'open'
+      header = "# #{repo || 'Global,'} #{state} issues"
+      if repo
+        if milestone = assigns[:milestone]
+          header.sub! repo, "#{repo} milestone ##{milestone}"
+        end
+        if assignee = assigns[:assignee]
+          header << case assignee
+            when '*'    then ', assigned'
+            when 'none' then ', unassigned'
+          else
+            assignee = 'you' if Authorization.username == assignee
+            ", assigned to #{assignee}"
+          end
+        end
+        if mentioned = assigns[:mentioned]
+          mentioned = 'you' if Authorization.username == mentioned
+          header << ", mentioning #{mentioned}"
+        end
+      else
+        header << case assigns[:filter]
+          when 'created'    then ' you created'
+          when 'mentioned'  then ' that mention you'
+          when 'subscribed' then " you're subscribed to"
+        else
+          ' assigned to you'
+        end
+      end
+      if labels = assigns[:labels]
+        header << ", labeled #{assigns[:labels].gsub ',', ', '}"
+      end
+      if sort = assigns[:sort]
+        header << ", by #{sort} #{reverse ? 'ascending' : 'descending'}"
+      end
+      format_state assigns[:state], header
+    end
+
+    # TODO: Show milestones.
+    def format_issues issues, include_repo
+      return 'None.' if issues.empty?
+
+      include_repo and issues.each do |i|
+        %r{/repos/[^/]+/([^/]+)} === i['url'] and i['repo'] = $1
+      end
+
+      nmax, rmax = %w(number repo).map { |f|
+        issues.sort_by { |i| i[f].to_s.size }.last[f].to_s.size
+      }
+
+      issues.map { |i|
+        n, title, labels = i['number'], i['title'], i['labels']
+        l = 8 + nmax + rmax + no_color { format_labels labels }.to_s.length
+        a = i['assignee'] && i['assignee']['login'] == Authorization.username
+        l += 2 if a
+        p = i['pull_request']['html_url'] and l += 2
+        c = i['comments'] if i['comments'] > 0 and l += 2
+        [
+          " ",
+          (i['repo'].to_s.rjust(rmax) if i['repo']),
+          "#{bright { n.to_s.rjust nmax }}:",
+          truncate(title, l),
+          format_labels(labels),
+          (fg('aaaaaa') { c } if c),
+          (fg('aaaaaa') { '↑' } if p),
+          (fg(:yellow) { '@' } if a)
+        ].compact.join ' '
+      }
+    end
+
+    # TODO: Show milestone, number of comments, pull request attached.
+    def format_issue i
+      ERB.new(<<EOF).result binding
+<% p = i['pull_request'].key? 'html_url' %>\
+<%= bright { \
+indent '%s%s: %s' % [p ? '↑' : '#', *i.values_at('number', 'title')], 0 } %>
+@<%= i['user']['login'] %> opened this <%= p ? 'pull request' : 'issue' %> \
+<%= format_date DateTime.parse(i['created_at']) %>. \
+<%= format_state i['state'], format_tag(i['state']), :bg %>\
+<% if i['assignee'] || !i['labels'].empty? %>
+<% if i['assignee'] %>@<%= i['assignee']['login'] %> is assigned. <% end %>\
+<% unless i['labels'].empty? %><%= format_labels(i['labels']) %><% end %>\
+<% end %>
+<% if i['body'] && !i['body'].empty? %>\n<%= indent i['body'] %>
+<% end %>
+
+EOF
+    end
+
+    def format_comments comments
+      return 'None.' if comments.empty?
+      comments.map { |comment| format_comment comment }
+    end
+
+    def format_comment c
+      <<EOF
+@#{c['user']['login']} commented \
+#{format_date DateTime.parse(c['created_at'])}:
+#{indent c['body']}
+
+
+EOF
+    end
+
+    def format_milestones milestones
+      return 'None.' if milestones.empty?
+
+      max = milestones.sort_by { |m|
+        m['number'].to_s.size
+      }.last['number'].to_s.size
+
+      milestones.map { |m|
+        due_on = m['due_on'] && DateTime.parse(m['due_on'])
+        [
+          "  #{bright { m['number'].to_s.rjust max }}:",
+          fg((:red if due_on && due_on <= DateTime.now)) {
+            truncate(m['title'], max + 4)
+          }
+        ].compact.join ' '
+      }
+    end
+
+    def format_milestone m
+      ERB.new(<<EOF).result binding
+<%= bright { indent '#%s: %s' % m.values_at('number', 'title'), 0 } %>
+@<%= m['creator']['login'] %> created this milestone <%= m['created_at'] %>. \
+<%= format_state m['state'], format_tag(m['state']), :bg %>
+<% if m['due_on'] %>\
+<% due_on = DateTime.parse m['due_on'] %>\
+Due <%= fg((:red if due_on <= DateTime.now)) { format_date due_on } %>.
+<% end %>\
+<% if m['description'] && !m['description'].empty? %>
+<%= indent m['description'] %>\
+<% end %>
+EOF
+    end
+
+    def format_state state, string = state, layer = :fg
+      send(layer, state == 'closed' ? :red : :green) { string }
+    end
+
+    def format_labels labels
+      return if labels.empty?
+      [*labels].map { |l| bg(l['color']) { format_tag l['name'] } }.join ' '
+    end
+
+    def format_tag tag
+      (colorize? ? ' %s ' : '[%s]') % tag
+    end
+
+    def format_markdown string, indent = 4
+      # Headers.
+      string.gsub!(/^( {#{indent}}\#{1,6} .+)$/, bright{'\1'})
+      string.gsub!(
+        /(^ {#{indent}}.+$\n^ {#{indent}}[-=]+$)/, bright{'\1'}
+      )
+      # Emphasis.
+      string.gsub!(
+        /(^|\s)(\*\w(?:[^*]*\w)?\*)(\s|$)/m, '\1' + underline{'\2'} + '\3'
+      )
+      string.gsub!(
+        /(^|\s)(_\w(?:[^_]*\w)?_)(\s|$)/m, '\1' + underline{'\2'} + '\3'
+      )
+      # Strong.
+      string.gsub!(
+        /(^|\s)(\*{2}\w(?:[^*]*\w)?\*{2})(\s|$)/m, '\1' + bright{'\2'} + '\3'
+      )
+      string.gsub!(
+        /(^|\s)(_{2}\w(?:[^_]*\w)?_{2})(\s|$)/m, '\1' + bright {'\2'} + '\3'
+      )
+      # Code.
+      string.gsub!(
+        /
+          (^\ {#{indent}}```.*?$)(.+?^\ {#{indent}}```$)|
+          (^|[^`])(`[^`]+`)([^`]|$)
+        /mx,
+        fg(c = '268bd2'){'\1'} + bg(c){'\2'} + '\3' + fg(c){'\4'} + '\5'
+      )
+      # URI.
+      string.gsub!(
+        %r{\b(<)?(https?://[\s]+|\w+@\w+)(>)?\b},
+        '\1' + underline{'\2'} + '\3'
+      )
+      string
+    end
+
+    def format_date date
+      days = (interval = DateTime.now - date).to_i.abs
+      string = if days.zero?
+        hours, minutes, seconds = DateTime.day_fraction_to_time interval.abs
+        if hours > 0
+          "#{hours} hour#{'s' unless hours == 1}"
+        elsif minutes > 0
+          "#{minutes} minute#{'s' unless minutes == 1}"
+        else
+          "#{seconds} second#{'s' unless seconds == 1}"
+        end
+      else
+        "#{days} day#{'s' unless days == 1}"
+      end
+      [string, interval < 0 ? 'from now' : 'ago'].join ' '
+    end
+
+    def throb position = 0, redraw = CURSOR[:up][1]
+      return yield unless STDOUT.tty?
+
+      throb = THROBBERS[rand(THROBBERS.length)]
+      throb.reverse! if rand > 0.5
+      i = rand throb.length
+
+      thread = Thread.new do
+        dot = lambda do
+          print("\r#{CURSOR[:column][position]}#{throb[i]}#{CURSOR[:hide]}")
+          i = (i + 1) % throb.length
+          sleep 0.1 and dot.call
+        end
+        dot.call
+      end
+      yield
+    ensure
+      if thread
+        thread.kill
+        puts "\r#{CURSOR[:column][position]}#{redraw}#{CURSOR[:show]}"
+      end
+    end
+  end
+end