octaccord 0.0.1

data/examples/Itr0000-template.md.erb

@@ -0,0 +1,93 @@
+:bangbang: This Iteration Record is created by octaccord from examples/Itr0000-template.md.erb
+
+Example:
+```sh
+$ octaccord create_iteration nomlab/LastNote Itr0095 \
+      --team="nomlab/GN" \
+      --start="2014-07-03T16:30:00+09:00" \
+      --due="2014-07-16T13:00:00+09:00" \
+      --manager="okada-takuya" \
+      --template=../octaccord/examples/Itr0000-template.md.erb \
+   | octaccord filter > Itr0095-sample.md
+
+$ octaccord filter < Product-Backlog.md > tmp.md
+$ mv tmp.md Product-Backlog.md
+```
+<%
+   now     = Time.now.iso8601
+   repos   = itr.repository
+   members = itr.members.sort.map{|m| "@" + m}.join(", ")
+-%>
+[[(<%= itr.prev.name %>)|<%= itr.prev.name %>]] | [[(<%= itr.next.name %>)|<%= itr.next.name %>]] | [[(PBL)|Product-Backlog]] | [PBL Issues](../issues?labels=PBL&state=open&sort=updated)
+
+# <%= itr.name %> Iteration Record
+
+* Manager: @<%= itr.manager %>
+* Term: <%= itr.start.strftime("%Y-%m-%d %H:%M") %>..<%= itr.due.strftime("%Y-%m-%d %H:%M") %>
+
+## <%= itr.start.strftime("%Y-%m-%d") %> Iteration Plan
+
+* Attendees: <%= members %>
+* Pairs: <%= members %>
+
+### 1. High-Level Objectives
+
+[[PBL|Product-Backlog]] と [PBL Issues](../issues?labels=PBL&state=open&sort=updated) を見ながら以下について議論した．
+
+#### 完成イメージと本イテレーションの方針について
+
+* blah blah ........
+  * blah blah ........
+* blah blah ........
+
+#### [[Product Backlog|Product-Backlog]] の調整について
+
+* #17 は，Cost を 5 から 8 に上げるべき．なぜなら blah blah ........
+* #17 よりも #38 を優先したほうがよい．なぜなら blah blah ........
+* blah blah ........
+
+#### 本イテレーションで取り組む PBL Issue について
+
+* 議論の結果，[[Product Backlog|Product-Backlog]] を調整して優先順位の並べ替えを行った．
+* 取り組むべき PBL Issue に PBL と <% itr.name %> ラベルを付与し，それらの description 欄に Story, Demo, Cost の項目を記述した．
+* 個々の PBL Issue に関する技術的議論は，その Issue のコメント欄に記述した．
+* 以下，[PBL Issues](../issues?labels=PBL&state=open&sort=updated) から octaccord によって自動抽出した結果を示す．
+
+<!-- begin:octaccord scan <%= repos %> --search="label:PBL label:<%= itr.name %>" --format=pbl --topology=Product-Backlog.md -->
+<!-- end:octaccord -->
+
+#### 本議論中で更新された Issue コメント一覧
+
+<!-- begin:octaccord comments <%= repos %> --since="<%= itr.start.iso8601 %>" --before="<%= (itr.start + 3600 * 2).iso8601 %>"-->
+<!-- end:octaccord -->
+
+### 2. Work Item Assignments
+
+<!-- begin:octaccord scan <%= repos %> --search="label:<%= itr.name %> -label:PBL" --format=list -->
+<!-- end:octaccord -->
+
+### 3. Evaluation Criteria
+
+* 全テストの完成と通過
+* コードレビューの完了
+* 全ての PBL Issue について，デモを実施
+
+## <%= itr.due.strftime("%Y-%m-%d") %> Iteration Review
+
+* Attendees: <%= members %>
+
+できあがったプロダクトを見ながら，リリース可能かどうかを判断する会議．
+* 完了できなかった，プロダクトバックログについて担当者が説明する
+* プロダクトバックログに追加すべき項目の有無について議論する
+* プロジェクトを進めるうえで問題となる項目について議論する
+* 現在の進捗をふまえて，リリース日や完了日を予測する
+
+### 1. Issue and Pull Request Review
+
+Issues を見ながら，Issues にコメントを付ける．議事は，Issues のコメントとして付ける．
+本 Wiki には， octaccord がコメントを追加する．
+
+#### 本議論中で更新された Issue コメント一覧
+
+<!-- begin:octaccord comments <%= repos %> --since="<%= itr.due.iso8601 %>" --before="<%= (itr.due + 3600 * 2).iso8601 %>"-->
+<!-- end:octaccord -->

data/examples/octaccord-completion.zsh

@@ -0,0 +1,11 @@
+compdef _octaccord octaccord
+
+_octaccord () {
+  local curcontext="$curcontext"
+  local line state _opts
+
+  _opts=("${(@f)$(octaccord completions -- ${(Q)words[2,-1]})}")
+  $_opts && return 0
+
+  return 1
+}

data/lib/extensions.rb

@@ -0,0 +1,2 @@
+dir = File.dirname(__FILE__) + "/extensions"
+require "#{dir}/octokit.rb"

data/lib/extensions/octokit.rb

@@ -0,0 +1,16 @@
+require "octokit"
+
+module Octokit
+  class Client
+    module Issues
+      # There are these two PRs in the octokit upstream issues.
+      # However, both of them are not merged yet.
+      # So, I introduced PR 232 by hand.
+      # https://github.com/octokit/octokit.rb/pull/229
+      # https://github.com/octokit/octokit.rb/pull/232
+      def ext_update_issue(repo, number, options = {})
+        patch "#{Repository.path repo}/issues/#{number}", options
+      end
+    end
+  end
+end

data/lib/octaccord.rb

@@ -0,0 +1,10 @@
+require "octaccord/version"
+require "octaccord/errors"
+require "octaccord/command"
+require "octaccord/formatter"
+require "octaccord/iteration"
+require "extensions"
+
+module Octaccord
+  # Your code goes here...
+end

data/lib/octaccord/command.rb

@@ -0,0 +1,16 @@
+module Octaccord
+  module Command
+    dir = File.dirname(__FILE__) + "/command"
+    autoload :AddCollaborator, "#{dir}/add_collaborator.rb"
+    autoload :Comments,        "#{dir}/comments.rb"
+    autoload :Completions,     "#{dir}/completions.rb"
+    autoload :GetTeamMembers,  "#{dir}/get_team_members.rb"
+    autoload :Info,            "#{dir}/info.rb"
+    autoload :Label,           "#{dir}/label.rb"
+    autoload :Link,            "#{dir}/link.rb"
+    autoload :Scan,            "#{dir}/scan.rb"
+    autoload :Show,            "#{dir}/show.rb"
+    autoload :UpdateIssues,    "#{dir}/update_issues.rb"
+    autoload :CreateIteration, "#{dir}/create_iteration.rb"
+  end # module Command
+end # module Octaccord

data/lib/octaccord/command/add_collaborator.rb

@@ -0,0 +1,34 @@
+module Octaccord
+  module Command
+    class AddCollaborator
+      Encoding.default_external = "UTF-8"
+
+      def initialize(client, repos, **options)
+        if options[:users]
+          add_users(client, repos, options[:users].split(','))
+        elsif options[:teams]
+          add_team_members(client, repos, options[:teams].split(','))
+        end
+      end
+
+      def add_users(client, repos, users)
+        users.each do |user|
+          response = client.add_collaborator(repos, user)
+        end
+      end
+
+      def add_team_members(client, repos, teams)
+        teams.each do |team|
+          org, team_name = team.split('/')
+          response = client.organization_teams(org)
+          team_id = response.select{|t| t.name == team_name}.first.id
+          response = client.team_members(team_id)
+          members = response.map(&:login)
+          members.each do |member|
+            response = client.add_collaborator(repos, member)
+          end
+        end
+      end
+    end # class AddCollaborator
+  end # module Command
+end # module Octaccord

data/lib/octaccord/command/comments.rb

@@ -0,0 +1,50 @@
+module Octaccord
+  module Command
+    class Comments
+
+      def initialize(client, repos, since, before)
+        begin
+          comments = client.issues_comments(repos, :since => since)
+          issues = gather_issues(comments, before)
+
+          issues.each do |uri, comments|
+            next if comments.empty?
+            issue = comments.first.rels[:issue].get.data
+            print format_issue(issue)
+
+            comments.each do |comment|
+              print format_comment(comment)
+            end
+          end
+          print "\n"
+        rescue Octokit::ClientError => e
+          STDERR.puts "Error: ##{issue} -- #{e.message.split(' // ').first}"
+        end
+      end
+      private
+
+      def gather_issues(comments, before)
+        issues = {}
+
+        comments.each do |comment|
+          next if comment.updated_at > before
+          uri = comment.rels[:issue].href
+          issues[uri] ||= []
+          issues[uri] << comment
+        end
+        return issues
+      end
+
+      def format_comment(comment)
+        comment = Formatter::Comment.new(comment)
+        "  * #{comment.summary} #{comment.link(text: "...")}\n"
+      end
+
+      def format_issue(issue)
+        issue = Formatter::Issue.new(issue)
+        return "* #{issue.link} #{issue.status} #{issue.title}\n"
+      end
+
+    end # class Comments
+  end # module Command
+end # module Octaccord

data/lib/octaccord/command/completions.rb

@@ -0,0 +1,56 @@
+module Octaccord
+  module Command
+    class Completions
+
+      def initialize(help, global_options, arguments)
+        command_name = arguments.first
+
+        if command_name and help[command_name]
+          options(help, global_options, command_name)
+        else
+          commands(help)
+        end
+      end
+
+      private
+
+      def commands(help)
+        puts "_values"
+        puts "Sub-commands:"
+        puts "help[Available commands or one specific COMMAND]"
+
+        help.each do |name, option|
+          next if name == "completions"
+          puts "#{name}[#{option.description}]"
+        end
+      end
+
+      def options(help, global_options, command_name)
+        print "_arguments\n-A\n*\n"
+        options = help[command_name].options.merge(global_options)
+
+        options.each do |name, opt|
+          if opt.type == :boolean
+            print "(--#{name})--#{name}[#{opt.description}]\n"
+          else
+            print "(--#{name})--#{name}=-[#{opt.description}]:#{opt.banner}:#{possible_values(opt)}\n"
+          end
+        end
+      end
+
+      def possible_values(option)
+        return "(" + option.enum.join(" ") + ")" if option.enum
+
+        case option.banner
+        when "FILE"
+          "_files"
+        when "DIRECTORY"
+          "_files -/"
+        else
+          ""
+        end
+      end
+
+    end # class Completions
+  end # module Command
+end # module Octaccord

data/lib/octaccord/command/create_iteration.rb

@@ -0,0 +1,21 @@
+require "erb"
+
+module Octaccord
+  module Command
+    class CreateIteration
+      def initialize(client, repos, name, **options)
+        if file = options[:template]
+          content = File.open(file).read
+        else
+          content = gets(nil)
+        end
+        template = ERB.new(content, nil, "-")
+        options.delete(:template)
+
+        # binding itr, repos
+        itr = Octaccord::Iteration.new(client: client, name: name, repository: repos, **options)
+        puts template.result(binding)
+      end
+    end # class CreateIteration
+  end # module Command
+end # module Octaccord

data/lib/octaccord/command/get_team_members.rb

@@ -0,0 +1,18 @@
+module Octaccord
+  module Command
+    class GetTeamMembers
+      Encoding.default_external = "UTF-8"
+
+      def initialize(client, teams, **options)
+        teams.split(',').each do |team|
+          org, team_name = team.split('/')
+          response = client.organization_teams(org)
+          team_id = response.select{|t| t.name == team_name}.first.id
+          response = client.team_members(team_id)
+          members = response.map(&:login)
+          puts members.join(', ')
+        end
+      end
+    end # class GetTeamMembers
+  end # module Command
+end # module Octaccord

data/lib/octaccord/command/info.rb

@@ -0,0 +1,18 @@
+require "rugged"
+
+module Octaccord
+  module Command
+    class Info
+
+      def initialize(client, **options)
+        begin
+          repo = Rugged::Repository.discover(".")
+          url = repo.remotes.find {|remote| remote.url =~ /github\.com/}.url
+          puts url
+        rescue Rugged::RepositoryError => e
+          STDERR.print "Error: you are not in github repository.\n"
+        end
+      end
+    end # class Info
+  end # module Command
+end # module Octaccord

data/lib/octaccord/command/label.rb

@@ -0,0 +1,16 @@
+module Octaccord
+  module Command
+    class Label
+
+      def initialize(client, repos, **options)
+        begin
+          client.labels(repos).each do |label|
+            puts label.name
+          end
+        rescue Octokit::ClientError => e
+          STDERR.puts "Error: ##{issue} -- #{e.message.split(' // ').first}"
+        end
+      end
+    end # class Label
+  end # module Command
+end # module Octaccord

data/lib/octaccord/command/scan.rb

@@ -0,0 +1,122 @@
+module Octaccord
+  module Command
+    class Scan
+      Encoding.default_external = "UTF-8"
+
+      def initialize(client, repos, replace = nil, **options)
+        if options[:format] == "json"
+          formatter = nil
+        else
+          formatter = Octaccord::Formatter.build(formatter: options[:format] || :text)
+        end
+        if query = options[:search]
+          items = search(client, repos, query, formatter)
+        else
+          items = scan(client, repos, options[:type], formatter)
+        end
+        format(items, formatter, replace)
+      end
+
+      def search(client, repos, query, formatter)
+        # https://help.github.com/articles/searching-issues
+        # or issues = client.list_issues(repos)
+        # type:issue means ignore pull request
+        query = "repo:#{repos} #{query}"
+        query << " state:open" unless query =~ /state:/
+        query << " type:issue" unless query =~ /type:/
+        STDERR.puts "Query: #{query}" if $OCTACCORD_DEBUG
+
+        if query =~ /(-)?(refers|refered):\(([^)]*)\)/
+          negop, reftype, subquery = $1, $2, $3
+          query = query.sub(/-?(refers|refered):\([^)]*\)/, "")
+
+          subquery << " repo:#{repos}"
+          subquery << " state:open" unless subquery =~ /state:/
+          subquery << " type:issue" unless subquery =~ /type:/
+
+          if $OCTACCORD_DEBUG
+            STDERR.puts "SUBQUERY: #{subquery}"
+            STDERR.puts "QUERY: #{query}"
+          end
+
+          subitems = client.search_issues(subquery).items
+          issues = client.search_issues(query).items
+
+          if reftype == "refers"
+            return refers(subitems, issues, (negop == "-"))
+          else
+            return refered(issues, subitems, (negop == "-"))
+          end
+        end
+
+        issues = client.search_issues(query).items
+      end
+
+      def scan(client, repos, type, formatter)
+        if type == "pr"
+          issues = client.issues(repos).select{|issue| issue.pull_request}
+        else
+          issues = client.issues(repos).select{|issue| not issue.pull_request}
+        end
+      end
+
+      def refers(parents, issues, negop)
+        parents, children = corss_reference(parents, issues, negop)
+        return children
+      end
+
+      def refered(parents, issues, negop)
+        parents, children = corss_reference(parents, issues, negop)
+        return parents
+      end
+
+      def corss_reference(parents, children, negop)
+        if $OCTACCORD_DEBUG
+          STDERR.puts "* PARENTS: #{parents.map{|i| i.number}.join(', ')}"
+          STDERR.puts "* CHILDREN: #{children.map{|i| i.number}.join(', ')}"
+          STDERR.puts "* NEGOP: #{negop}"
+        end
+
+        refered_parents = []
+        refering_children = []
+
+        parents.each do |parent|
+          STDERR.puts "ABOUT PARENT: #{parent.number}:" if $OCTACCORD_DEBUG
+          children.each do |child|
+            Octaccord::Formatter::Issue.new(child).references.each do |refer_num|
+              STDERR.puts "  child #{child.number} refers #{refer_num} #{parent.number.to_i == refer_num ? " FOUND" : "" }" if $OCTACCORD_DEBUG
+              if parent.number.to_i == refer_num
+                STDERR.puts "FOUND #{refer_num}" if $OCTACCORD_DEBUG
+                refered_parents << parent
+                refering_children << child
+              end
+            end
+          end
+        end
+
+        refered_parents.uniq!
+        refering_children.uniq!
+
+        if negop
+          return [parents-refered_parents, children-refering_children]
+        else
+          return [refered_parents, refering_children]
+        end
+      end
+
+      def format(issues, formatter, replace = nil)
+        if formatter == nil # raw format
+          print issues.to_s
+          return
+        end
+
+        issues.each do |issue|
+          formatter << issue
+        end
+        formatter.order(replace) if replace
+        print formatter.to_s
+      end
+
+    end # class Scan
+  end # module Command
+end # module Octaccord