octaccord 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f41906f4168cda2e216acac50a102ad60bcfbedc
+  data.tar.gz: 3a19307ac59fbb1a20c21d1086a711ff04c5c417
+SHA512:
+  metadata.gz: 8213ef2b4423e1cc6b0ac200a1d63d8a8f223710668ffd10773ae05f0fe3146f1561c3047e5283ada35162139298c69f8f580952994f3740dbed75f2c5845808
+  data.tar.gz: 24c88ad022a415bbff508c8a515f7f3c7aec1d28e2217874abaaebc8f571eee149e918e1b36b58564edc628711bd9bf402c17ab21c5cf08860c927900dbdf616

data/.gitignore

@@ -0,0 +1,62 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+#
+# Added from https://raw.github.com/github/gitignore/master/Ruby.gitignore
+#
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+.ruby-version
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+/vendor/bundle/
+/attic/

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.1.2

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in octaccord.gemspec
+gemspec
+gem "octokit"
+gem "pit"
+gem "thor"
+gem "rugged"
+gem 'faraday-http-cache'

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Yoshinari Nomura
+
+MIT License
+
+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.org

@@ -0,0 +1,95 @@
+#+TITLE: octaccord
+#+AUTHOR: Nomura Laboratory, Yoshinari Nomura
+#+EMAIL:
+#+DATE: 2014-07-26
+#+OPTIONS: H:3 num:2 toc:nil
+#+OPTIONS: ^:nil @:t \n:nil ::t |:t f:t TeX:t
+#+OPTIONS: skip:nil
+#+OPTIONS: author:t
+#+OPTIONS: email:nil
+#+OPTIONS: creator:nil
+#+OPTIONS: timestamp:nil
+#+OPTIONS: timestamps:nil
+#+OPTIONS: d:nil
+#+OPTIONS: tags:t
+#+TEXT:
+#+DESCRIPTION:
+#+KEYWORDS:
+#+LANGUAGE: ja
+#+LATEX_CLASS: jsarticle
+#+LATEX_CLASS_OPTIONS: [a4j]
+# #+LATEX_HEADER: \usepackage{plain-article}
+# #+LATEX_HEADER: \renewcommand\maketitle{}
+# #+LATEX_HEADER: \pagestyle{empty}
+# #+LaTeX: \thispagestyle{empty}
+
+* Octaccord
+** What is octaccord?
+
+   Octaccord is a small CLI tool to manipulate issues (tickets) for the GitHub.
+   It reduces some complex operations on the issues of GitHub:
+
+   + Bulk label update with complex search queries
+   + Pretty issue printer in many format including Markdown
+   + Extract statistic information to the GitHub Wiki
+
+** INSTALL for developers:
+   Current code is a very alpha and kind of proof-of-concept demonstration.
+   I recommend you not to install via usual gem-style procedure.
+
+   1) Install rbenv + ruby-build
+      (see https://github.com/sstephenson/rbenv#basic-github-checkout for details)
+      #+BEGIN_SRC shell-script
+        $ git clone https://github.com/sstephenson/rbenv.git ~/.rbenv
+        $ git clone https://github.com/sstephenson/ruby-build.git ~/.rbenv/plugins/ruby-build
+        # Edit your shell dot files to add some path and environment variables.
+      #+END_SRC
+
+   2) Install Latest Ruby and bundler
+      #+BEGIN_SRC shell-script
+        # Install ruby 2.1.2
+        $ rbenv install 2.1.2
+
+        # Installation check
+        $ rbenv global 2.1.2
+        $ ruby -v # -> You will see: ruby 2.1.2...
+
+        # Install bundler for your new Ruby
+        $ gem install bundler
+
+        # Get back to your sytem default Ruby if you want
+        $ rbenv global system # say, /usr/bin/ruby
+        $ ruby -v
+      #+END_SRC
+
+   3) Clone octaccord from github
+      #+BEGIN_SRC shell-script
+        $ git clone git@github.com:nomlab/octaccord.git ~/src/octaccord
+      #+END_SRC
+
+   4) Set default ruby version in octaccord project
+      #+BEGIN_SRC shell-script
+        $ cd ~/src/octaccord
+        $ echo '2.1.2' > .ruby-version
+        $ ruby -v # -> You will see: ruby 2.1.2...
+      #+END_SRC
+
+   5) Install requied gem packages in sandbox ~/src/octaccord/vendor/bundle
+      #+BEGIN_SRC shell-script
+        $ cd ~/src/octaccord
+        $ bundle install --path vendor/bundle
+      #+END_SRC
+
+   6) Setup data-cache and auth-cache directory
+      #+BEGIN_SRC shell-script
+        $ mkdir -p ~/.cache/octaccord
+        $ mkdir -p ~/.pit
+      #+END_SRC
+
+   7) Check if octaccord is alive.
+      #+BEGIN_SRC shell-script
+        $ ~/src/octaccord/bin/octaccord scan nomlab/octaccord
+      #+END_SRC
+
+   You may add ~/src/octaccord/bin directory to your $PATH for dogfooding.
+   If you are zsh user, [[file:examples/octaccord-completion.zsh]] would help you.

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+

data/bin/octaccord

@@ -0,0 +1,311 @@
+#!/usr/bin/env ruby
+
+if File.symlink?(__FILE__) and ENV["RBENV_VERSION"]
+  ENV["RBENV_VERSION"] = nil
+  shims_path = File.expand_path("shims", ENV["RBENV_ROOT"])
+  ENV["PATH"] = shims_path + ":" + ENV["PATH"]
+  exec(File.readlink(__FILE__), *ARGV)
+end
+
+ENV["BUNDLE_GEMFILE"] = File.expand_path("../../Gemfile", __FILE__)
+
+require 'rubygems'
+require 'bundler/setup'
+Bundler.require
+
+require "time"
+require "shellwords"
+require "pp"
+
+Encoding.default_external="UTF-8"
+
+require "dbm"
+class FileStore
+  CACHE_FILE = "#{ENV["HOME"]}/.cache/octaccord/http_cache"
+
+  def initialize
+    @cache = DBM.open(CACHE_FILE, 0666)
+  end
+
+  def read(key)
+    if value = @cache[key]
+      STDERR.puts "HIT #{key}" if $OCTACCORD_DEBUG
+
+    else
+      STDERR.puts "MISS #{key}" if $OCTACCORD_DEBUG
+    end
+    value
+  end
+
+  def write(key, value)
+    @cache[key] = value
+  end
+end
+
+class OctaccordCLI < Thor
+  check_unknown_options! :except => :completions
+  package_name 'Octaccord'
+
+  class_option :debug, :type => :boolean, :desc => "Set debug flag"
+
+  map ["--version", "-v"] => :version
+
+  default_command :help
+  map ["--help", "-h"] => :help
+
+  desc "version", "Show version"
+  def version
+    puts Octaccord::VERSION
+  end
+
+  ################################################################
+  ## Command: scan
+  ################################################################
+  desc "scan REPOSITORY [OPTIONS...]", "Scan issues"
+
+  long_desc <<-LONGDESC
+    scan and print issues in various formats
+  LONGDESC
+
+  method_option :format, :desc => "Set printing format", :enum => %w(debug list number pbl table text)
+  method_option :type,   :desc => "Set issue type", :enum => %w(pr issue)
+  method_option :search, :desc => "Set search query"
+  method_option :topology, :desc => "Set information file name for topological sort", :banner => "FILE"
+
+  def scan(repos)
+    if options[:topology] == "-"
+      orig_text = $stdin.gets(nil)
+    elsif options[:topology]
+      orig_text = File.open(options[:topology]).gets(nil)
+    end
+    Octaccord::Command::Scan.new(client, repos, orig_text, **symbolize_keys(options))
+  end
+
+  ################################################################
+  ## Command: subscriptions
+  ################################################################
+  desc "subscriptions", "List your watching repositories"
+
+  long_desc <<-LONGDESC
+    List your watching repositories
+  LONGDESC
+
+  def subscriptions
+    client.subscriptions.each do |repos|
+      puts repos.full_name
+    end
+  end
+
+  ################################################################
+  ## Command: update_issues
+  ################################################################
+  desc "update_issues REPOSITORY [OPTIONS...] NUM...", "Update issues"
+
+  long_desc <<-LONGDESC
+    update issues in specified repository
+  LONGDESC
+
+  method_option "add-label",    :desc => "Add a LABEL to issues", :banner => "LABEL"
+  method_option "remove-label", :desc => "Remove a LABEL from issues", :banner => "LABEL"
+
+  def update_issues(repos, *issues)
+    Octaccord::Command::UpdateIssues.new(client, repos, issues, **symbolize_keys(options))
+  end
+
+  ################################################################
+  ## Command: add_collaborator
+  ################################################################
+  desc "add_collaborator REPOSITORY [OPTIONS...]", "Add collaborator to a REPOSITORY"
+
+  long_desc <<-LONGDESC
+    add users or team members to collaborator of repository
+  LONGDESC
+
+  method_option :users, :desc => "Add users to collaborator of repository"
+  method_option :teams, :desc => "Add team members to collaborator of repository"
+
+  def add_collaborator(repos)
+    Octaccord::Command::AddCollaborator.new(client, repos, **symbolize_keys(options))
+  end
+
+  ################################################################
+  ## Command: comments
+  ################################################################
+  desc "comments REPOSITORY [OPTIONS...]", "List comments created in a period of time"
+
+  long_desc <<-LONGDESC
+    list comments created in a period of time
+  LONGDESC
+
+  method_option :since,  :banner => "ISO8601_DATETIME", :desc => "Only comments updated at or after this time"
+  method_option :before, :banner => "ISO8601_DATETIME", :desc => "Only comments updated at or before this time"
+  def comments(repos)
+    since  = Time.iso8601(options[:since])
+    before = if options[:before] then Time.iso8601(options[:before]) else Time.now end
+    Octaccord::Command::Comments.new(client, repos, since, before)
+  end
+
+  ################################################################
+  ## Command: completions
+  ################################################################
+  desc "completions [COMMAND]", "List available commands or options for COMMAND", :hide => true
+
+  long_desc <<-LONGDESC
+    List available commands or options for COMMAND
+    This is supposed to be a zsh compsys helper"
+  LONGDESC
+
+  def completions(*command)
+    help = self.class.commands
+    global_options = self.class.class_options
+    Octaccord::Command::Completions.new(help, global_options, command)
+  end
+
+  ################################################################
+  ## Command: create_iteration
+  ################################################################
+  desc "create_iteration REPOSITORY ITERATION_NAME", "Make new iteration record file"
+
+  long_desc <<-LONGDESC
+    Make a new iteration record file from skeleton
+  LONGDESC
+
+  method_option :start,    :desc => "start date-time", :banner => "ISO8601_DATETIME"
+  method_option :due,      :desc => "due date-time", :banner => "ISO8601_DATETIME"
+  method_option :manager,  :desc => "set manager name", :banner => "USER"
+  method_option :team,     :desc => "set github organization/team style team name"
+  method_option :template, :desc => "set ERB template", :banner => "FILE"
+  def create_iteration(repos, iteration_name)
+    Octaccord::Command::CreateIteration.new(client, repos, iteration_name, **symbolize_keys(options))
+  end
+
+  ################################################################
+  ## Command: filter
+  ################################################################
+  desc "filter", "Decorate markdown as filter"
+
+  def filter
+    block_finalize = false
+    block_inside   = false
+    block_content  = ""
+    block_argv     = []
+
+    while line = STDIN.gets # STDIN.noecho(&:gets)
+      if /begin:octaccord (.*)-->/ =~ line
+        block_inside = true
+        block_argv = $1.chomp.shellsplit
+        print line
+        next
+      end
+
+      if /end:octaccord/ =~ line
+        orig_stdout = $stdout
+        orig_stdin  = $stdin
+        $stdout = StringIO.new
+        $stdin  = StringIO.new(block_content)
+        self.class.start(block_argv)
+        result = $stdout.string
+        $stdout = orig_stdout
+        $stdin  = orig_stdin
+
+        print result
+        print line
+        block_inside = false
+        next
+      end
+
+      if block_inside
+        block_content << line
+      else
+        print line.gsub(/(^|[^\[])\#(\d+)/, '\1[#\2](../issues/\2)')
+      end
+    end
+  end
+
+  ################################################################
+  ## Command: get_team_members
+  ################################################################
+  desc "get_team_members ORGANIZATION/TEAM", "Get team members"
+
+  long_desc <<-LONGDESC
+    Get team members
+  LONGDESC
+
+  def get_team_members(teams)
+    Octaccord::Command::GetTeamMembers.new(client, teams, **symbolize_keys(options))
+  end
+
+  ################################################################
+  ## Command: info
+  ################################################################
+  desc "info", "Show github remote info"
+
+  def info
+    Octaccord::Command::Info.new(client, **symbolize_keys(options))
+  end
+
+  ################################################################
+  ## Command: show
+  ################################################################
+  desc "show REPOSITORY NUM", "Show details of issue #NUM"
+
+  def show(repos, issue)
+    Octaccord::Command::Show.new(client, repos, issue, **symbolize_keys(options))
+  end
+
+  ################################################################
+  ## patch to insert  setup_global_options
+  ################################################################
+  no_commands do
+    def invoke_command(command, *args)
+      setup_global_options
+      super
+    end
+  end
+
+  ################################################################
+  ## private
+  ################################################################
+  private
+
+  def exit_on_error(&block)
+    begin
+      yield if block_given?
+    rescue Octaccord::ConfigurationError => e
+      STDERR.print "ERROR: #{e.message}.\n"
+      exit 1
+    end
+  end
+
+  attr_reader :client, :config
+
+  def setup_global_options
+    exit_on_error do
+      @config ||= Pit.get("github.com", :require => {
+        "login"    => "Your login name here",
+        "password" => "Your password here"
+      })
+
+      $OCTACCORD_DEBUG = true if options[:debug]
+      @store ||= FileStore.new
+      @stack ||= Faraday::RackBuilder.new do |builder|
+        builder.response :logger if options[:debug]
+        builder.use Faraday::HttpCache, shared_cache: false, store: @store, serializer: YAML
+        builder.use Octokit::Response::RaiseError
+        builder.adapter Faraday.default_adapter
+      end
+
+      Octokit.middleware = @stack
+      Octokit.auto_paginate = true
+      @client ||= Octokit::Client.new(:login    => @config["login"],
+                                      :password => @config["password"])
+    end
+  end
+
+  def symbolize_keys(hash)
+    Hash[hash.map {|k,v| [k.to_s.gsub('-', '_').to_sym, v]}]
+  end
+
+end # class OctaccordCLI
+
+command = OctaccordCLI.start(ARGV)