github-reaper 0.0.1

data/.gitignore

@@ -0,0 +1 @@
+*.gem

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org/'
+
+gem 'octokit', '~> 3.0'
+gem 'slop', '~>3.6.0'
+gem 'colorize'
+gem 'github-reaper', :path => '.'

data/Gemfile.lock

@@ -0,0 +1,28 @@
+PATH
+  remote: .
+  specs:
+    github-reaper (0.0.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.3.6)
+    colorize (0.7.3)
+    faraday (0.9.0)
+      multipart-post (>= 1.2, < 3)
+    multipart-post (2.0.0)
+    octokit (3.4.2)
+      sawyer (~> 0.5.3)
+    sawyer (0.5.5)
+      addressable (~> 2.3.5)
+      faraday (~> 0.8, < 0.10)
+    slop (3.6.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  colorize
+  github-reaper!
+  octokit (~> 3.0)
+  slop (~> 3.6.0)

data/README.md

@@ -0,0 +1,2 @@
+reaper
+======

data/bin/reaper

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+
+require 'github-reaper'
+require 'slop'
+
+command = nil
+opts = Slop.parse(ARGV, strict: true, help: true) do
+  on 'u', 'user=', 'Username for Github login credentials.'
+  on 'p', 'password=', 'Password for Github login credentials.'
+  on 'r', 'repository=', 'Repository to access, e.g "amfeng/reaper"'
+  on 't', 'threshold=', 'Number of months to set as reap threshold.', as: Integer, default: 3
+  on 's', 'skip', 'Skip confirmation prompts.'
+
+  on 'version', 'Print the version.' do
+    puts Reaper::VERSION
+    exit
+  end
+end
+
+
+Reaper::CLI.new(opts).run!

data/github-reaper.gemspec

@@ -0,0 +1,16 @@
+$:.unshift(File.join(File.dirname(__FILE__), 'lib'))
+require 'reaper/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'github-reaper'
+  s.version     = Reaper::VERSION
+  s.summary     = 'Reaper'
+  s.description = "Reaper helps find and close stale Github issues."
+  s.authors     = ["Amber Feng"]
+  s.email       = 'amber.feng@gmail.com'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- test/test_*.rb`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ['lib']
+end

data/lib/github-reaper.rb

@@ -0,0 +1,119 @@
+#!/bin/env ruby
+# encoding: utf-8
+
+require 'colorize'
+require 'time'
+
+require 'reaper/version'
+require 'reaper/issue'
+require 'reaper/client'
+
+module Reaper
+  REAPER_WARNING = <<-eos
+    Hi! This is a friendly (automated) warning from the reaper that this
+    issue hasn't been updated in 3 months and will be automatically closed
+    in 1 week.
+
+    If you don't want this to be closed yet, you should remove the `to-reap`
+    label and the 3 month timeout will reset. If you never want this to be
+    reaped, add the label `do-not-reap`.
+
+    Thanks! (:
+  eos
+
+  class CLI
+    def initialize(opts)
+      @client = Reaper::Client.instance
+      @client.set_repo(opts[:repository])
+
+      @stale_threshold = 3600 * 24 * 30 * opts[:threshold]
+      @skip_confirm = opts[:skip]
+    end
+
+    def run!
+      now = Time.now
+
+      puts "Welcome to Reaper! ⟝⦆ (fetching from `#{@client.repo}`)".white.bold
+      issues_reaped = false
+
+      # Fetch to-reap issues.
+
+      options = {
+        labels: 'to-reap'
+      }
+
+      puts "Finding issues to reap..."
+      issues = @client.list_issues(options)
+      issues.each do |issue|
+        issues_reaped = true
+        issue = Reaper::Issue.new(issue)
+        # TODO: Add force-all flag.
+
+        issue_action(issue, "Close issue?", @skip_confirm) do |issue|
+          issue.reap
+          puts "Issue was reaped.".green
+        end
+      end
+
+      # Fetch issues in ascending updated order.
+      options = {
+        sort: :updated,
+        direction: :asc
+      }
+
+      puts "Finding next reapable issues..."
+      issues = @client.list_issues(options)
+      issues.each do |issue|
+        issue = Reaper::Issue.new(issue)
+
+        # Skip if this task has already been closed or has a do-not-reap tag.
+        next if issue.closed?
+        next if issue.labels.include?('do-not-reap')
+
+        # If there's a to-reap tag, close it. Else, add a to-reap tag and
+        # a warning comment.
+        # FIXME: The timeout for closing an issue after a warning should be
+        # customizable and not based on run-time of the reaper (e.g. running
+        # reaper should be idempotent).
+
+        puts "\n"
+
+        # Break out of the whole loop if the issue's updated date is outside
+        # the range.
+        break if issue.updated_at > now - @stale_threshold
+
+        issues_reaped = true
+        issue_action(issue, "Add warning?", @skip_confirm) do |issue|
+          issue.warn(Reaper::REAPER_WARNING)
+          puts "Added `to-reap` to #{issue.number}"
+        end
+      end
+
+      if issues_reaped
+        puts "Nice, you're done!".green
+      else
+        puts "No reap-able issues, woohoo!".green
+      end
+    end
+
+    def issue_action(issue, action_label, skip_confirm=false, show_title=true, &blk)
+      return yield issue if skip_confirm
+
+      puts "= Issue ##{issue.number}: #{issue.title}".white if show_title
+      print "#{action_label} [Y]es, [N]o, or n[E]ver: ".yellow
+      input = $stdin.gets.chomp.downcase
+
+      case input
+      when 'y'
+        yield issue
+      when 'n'
+        puts "OK, skipping.".red
+      when 'e'
+        issue.protect
+        puts "OK, added `do-not-reap`.".green
+      else
+        issue_action(issue, action_label, false, &blk)
+      end
+    end
+  end
+end

data/lib/reaper/client.rb

@@ -0,0 +1,30 @@
+require 'octokit'
+require 'singleton'
+
+module Reaper
+  class Client
+    include Singleton
+
+    attr_accessor :client, :repo
+
+    def initialize
+      # Look for .netrc credentials first; if they don't exist then prompt
+      # for login.
+      # TODO
+      @client = Octokit::Client.new(access_token: ENV['GITHUB_ACCESS_TOKEN'])
+      @repo = nil
+
+      # TODO: Add things other than Github.
+    end
+
+    def set_repo(repo)
+      @repo = repo
+    end
+
+    def method_missing(meth, *args, &block)
+      raise "Must provide a Github repository." unless @repo
+
+      @client.send(meth, *([@repo] + args), &block)
+    end
+  end
+end

data/lib/reaper/issue.rb

@@ -0,0 +1,60 @@
+module Reaper
+  class Issue
+    attr_accessor :state, :title, :body, :labels
+
+    def initialize(issue)
+      @issue = issue
+
+      @title = @issue.title
+      @body = @issue.body
+      @state = @issue.state
+      @labels = issue.labels.map(&:name)
+      @buffered_comments = []
+
+      @client = Reaper::Client.instance
+    end
+
+    # Action methods
+
+    def reap
+      @labels << 'reaped'
+      @labels -= ['to-reap']
+      @client.close_issue(@issue.number, labels: @labels)
+    end
+
+    def warn(warning)
+      @labels << 'to-reap'
+      comment(warning)
+      save
+    end
+
+    def protect
+      @labels << 'do-not-reap'
+      @labels -= ['to-reap']
+      save
+    end
+
+    def closed?
+      @state == 'closed'
+    end
+
+    private
+
+    def comment(comment)
+      @buffered_comments << comment
+    end
+
+    def save
+      @client.update_issue(@issue.number, @title, @body, labels: @labels)
+
+      @buffered_comments.each do |comment|
+        @client.add_comment(@issue.number, comment)
+      end
+      @buffered_comments = []
+    end
+
+    def method_missing(meth, *args, &block)
+      @issue.send(meth, *args, &block)
+    end
+  end
+end

data/lib/reaper/version.rb

@@ -0,0 +1,3 @@
+module Reaper
+  VERSION = '0.0.1'
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification
+name: github-reaper
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Amber Feng
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-22 00:00:00.000000000 Z
+dependencies: []
+description: Reaper helps find and close stale Github issues.
+email: amber.feng@gmail.com
+executables:
+- reaper
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- README.md
+- bin/reaper
+- github-reaper.gemspec
+- lib/github-reaper.rb
+- lib/reaper/client.rb
+- lib/reaper/issue.rb
+- lib/reaper/version.rb
+homepage: 
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Reaper
+test_files: []
+has_rdoc: