jiraMule 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d008f2c8e0cba19fd13ccd63a83a5a7b7781fb0c
+  data.tar.gz: 3c9b22e555541db99d55a69d053248119ef90a28
+SHA512:
+  metadata.gz: 031b45942d961a29fe74eb7df4ca9bd0b11a5c6c094208ee849b71267ec5146d209ee82575a224fda9ca7e8021409541326a3f8e7db8171f80f0e9768d8be602
+  data.tar.gz: 76e18cfc740fae51ec9554cbe4d603a230fd93dc0a86ef9f0ee43467ec8b8bb3cab3bc09c7d0fea61f6a4f8ac70df6943e6c1621ee0c6be542ddc3c4ca05948b

data/.gitignore

@@ -0,0 +1,23 @@
+.DS_Store
+.AppleDouble
+.LSOverride
+Icon
+*.sw[a-z]
+cookies
+.jiraProject
+.rpjProject
+.jiramulerc
+jiraMule-*.gem
+tags
+
+xcuserdata
+Pods/
+
+# Thumbnails
+._*
+
+# Files that might appear on external disk
+.Spotlight-V100
+.Trashes
+
+Gemfile.lock

data/Gemfile

@@ -0,0 +1,17 @@
+source 'http://rubygems.org'
+
+gemspec
+
+gem 'chronic_duration'
+gem 'commander'
+gem 'inifile', '~> 3.0'
+gem 'mime-types', '~> 1.25.1'
+gem 'mime-types-data', '~> 3.2016'
+gem 'multipart-post'
+gem 'mustache'
+gem "octokit", "~> 4.0"
+gem 'terminal-table'
+gem 'vine'
+gem 'zip'
+
+

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 michael conrad tadpol tilstra
+
+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.md

@@ -0,0 +1,37 @@
+# jiraMule
+
+## Install
+
+### From source
+```
+> bundler install
+> rake install
+```
+
+### By Gem
+```
+> gem install JiraMule
+```
+
+## Setup
+
+You need to set a few config keys before anyhting really works.
+
+Globally:
+```
+jm config net.url <URL to your Jira> --user
+jm config user.name <Your account name in Jira> --user
+```
+
+Then in each project directory:
+```
+jm config jira.project <Project ID>
+```
+
+(you could add that to your user config too if you wanted.)
+
+
+#### Jira API Docs
+
+[https://docs.atlassian.com/jira/REST/6.4.7/][]
+

data/Rakefile

@@ -0,0 +1,95 @@
+require "bundler/gem_tasks"
+
+#task :default => []
+
+tagName = "v#{Bundler::GemHelper.gemspec.version}"
+gemName = "jiraMule-#{Bundler::GemHelper.gemspec.version}.gem"
+builtGem = "pkg/#{gemName}"
+
+desc "Install gem in user dir"
+task :bob do
+	sh %{gem install --user-install #{builtGem}}
+end
+
+desc "Uninstall from user dir"
+task :unbob do
+	sh %{gem uninstall --user-install #{builtGem}}
+end
+
+task :echo do
+    puts tagName
+    puts gemName
+    puts builtGem
+end
+
+namespace :git do
+    desc "Push only develop, master, and tags to origin"
+    task :origin do
+        sh %{git push origin develop}
+        sh %{git push origin master}
+        sh %{git push origin --tags}
+    end
+
+#    desc "Push only develop, master, and tags to upstream"
+#    task :upstream do
+#        sh %{git push upstream develop}
+#        sh %{git push upstream master}
+#        sh %{git push upstream --tags}
+#    end
+
+    desc "Push to origin and upstream"
+    task :all => [:origin]
+end
+
+task :gemit do
+    mrt=Bundler::GemHelper.gemspec.version
+    sh %{git checkout v#{mrt}}
+    Rake::Task[:build].invoke
+    Rake::Task[:bob].invoke
+    Rake::Task['push:gem'].invoke
+    sh %{git checkout develop}
+end
+
+namespace :push do
+    desc 'Push gem up to RubyGems'
+    task :gem do
+        sh %{gem push #{builtGem}}
+    end
+
+    namespace :github do
+        desc "Make a release in Github"
+        task :makeRelease do
+            # ENV['GITHUB_TOKEN'] set by CI.
+            # ENV['GITHUB_USER'] set by CI.
+            # ENV['GITHUB_REPO'] set by CI
+            # Create Release
+            sh %{github-release info --tag #{tagName}} do |ok, res|
+                if not ok then
+                    sh %{github-release release --tag #{tagName}}
+                end
+            end
+        end
+
+        desc 'Push gem up to Github Releases'
+        task :gem => [:makeRelease, :build] do
+            # ENV['GITHUB_TOKEN'] set by CI.
+            # ENV['GITHUB_USER'] set by CI.
+            # ENV['GITHUB_REPO'] set by CI
+            # upload gem
+            sh %{github-release upload --tag #{tagName} --name #{gemName} --file #{builtGem}}
+        end
+    end
+end
+
+task :run do
+	sh %{ruby -Ilib bin/jm }
+end
+
+desc "Prints a cmd to test this in another directory"
+task :testwith do
+    pwd=Dir.pwd.sub(Dir.home, '~')
+    puts "ruby -I#{pwd}/lib #{pwd}/bin/jm "
+end
+
+
+#  vim: set sw=4 ts=4 :

data/TODO.taskpaper

@@ -0,0 +1,6 @@
+
+New commands:
+	- 'comment' for adding a comment. If no '-m' then open $EDITOR
+	- 'assign' Assign to another user.
+
+

data/bin/jm

@@ -0,0 +1,87 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'commander/import'
+require 'JiraMule'
+require 'pp'
+require 'json'
+
+Signal.trap('INT', 'EXIT') # Don't drop traces on ^C
+
+program :version, JiraMule::VERSION
+program :description, %{A collection of things that I do with jira.
+
+Many of which are either big batch operations, or need bits of info from
+the command line.  All of which turn out to be better handled as a command
+line app.
+
+This very specifically does not try to be a generic jira tool; those exist
+already.  Rather this is specific to things I need.
+}
+global_option('-V', '--verbose', 'Be chatty') {
+  $cfg['tool.verbose'] = true
+}
+global_option('-n', '--dry', "Don't run actions that make changes") {
+  $cfg['tool.dry'] = true
+  $cfg['tool.verbose'] = true # dry implies verbose
+}
+#global_option('--username USERNAME') {|un|
+#  $cfg['jira.userpass'] = un
+#}
+#global_option('--project PROJECT', "Which project to use") {|project|
+#  $cfg['jira.project'] = project
+#}
+#global_option('--url URL', "Set jira base url") {|url|
+#  $cfg['jira.url'] = url
+#}
+global_option('-L', '--curl', 'Print out a curl command for each network call') {
+  $cfg['tool.curldebug'] = true
+}
+global_option '--skip-plugins', %{Don't load plugins. Good for when one goes bad.}
+
+global_option('-C', '--configfile FILE', %{Load additional configuration file}) {|file|
+  # this is called after all of the top level code in this file.
+  $cfg.load_specific(file)
+}
+global_option('-c', '--config KEY=VALUE', %{Set a single config key}) {|param|
+  key, value = param.split('=', 2)
+  # a=b :> ["a","b"]
+  # a= :> ["a",""]
+  # a :> ["a"]
+  raise "Bad config '#{param}'" if key.nil?
+  if value.nil? then
+    $cfg[key] = 'true'
+  else
+    $cfg[key] = value
+  end
+}
+
+default_command :help
+
+$cfg = JiraMule::Config.new
+$cfg.load
+
+# Look for plug-ins
+pgds = [
+  Pathname.new(Dir.home) + '.jiramule' + 'plugins'
+]
+# Add plugin dirs from configs
+# This is run before the command line options are parsed, so need to check old way.
+if not ARGV.include? '--skip-plugins' then
+  pgds << Pathname.new(ENV['JIRAMULE_PLUGIN_DIR']) if ENV.has_key? 'JIRAMULE_PLUGIN_DIR'
+  pgds.each do |path|
+    next unless path.exist?
+    path.each_child do |plugin|
+      next if plugin.directory?
+      next unless plugin.readable?
+      next if plugin.basename.fnmatch('.*') # don't read anything starting with .
+      begin
+        require plugin.to_s
+      rescue Exception => e
+        $stderr.puts "Failed to load plugin at #{plugin} because #{e}"
+      end
+    end
+  end
+end
+
+#  vim: set sw=2 ts=2 :

data/jiraMule.gemspec

@@ -0,0 +1,43 @@
+# -*- encoding: utf-8 -*-
+$LOAD_PATH.push File.expand_path('../lib', __FILE__)
+require 'jiraMule/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'jiraMule'
+  s.version     = JiraMule::VERSION
+  s.authors     = ['Michael Conrad Tadpol Tilstra']
+  s.email       = ['tadpol@tadpol.org']
+  s.license     = 'MIT'
+  s.homepage    = ''
+  s.summary     = 'A collection of things that I do with jira'
+  s.description = %{A collection of things that I do with jira.
+
+Many of which are either big batch operations, or need bits of info from
+the command line.  All of which turn out to be better handled as a command
+line app.
+
+This very specifically does not try to be a generic jira tool; those exist
+already.  Rather this is specific to things I need.
+}
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
+  s.require_paths = ['lib']
+
+  s.add_runtime_dependency('chronic_duration', '~> 0.10.6')
+  s.add_runtime_dependency('commander', '~> 4.4.0')
+  s.add_runtime_dependency('inifile', '~> 3.0')
+  s.add_runtime_dependency('mime-types', '~> 1.25.1')
+  s.add_runtime_dependency('mime-types-data', '~> 3.2016')
+  s.add_runtime_dependency('multipart-post', '~> 2.0.0')
+  s.add_runtime_dependency('mustache', '~> 1.0')
+  s.add_runtime_dependency('terminal-table', '~> 1.4.5')
+  s.add_runtime_dependency('vine', '~> 0.2')
+  s.add_runtime_dependency('zip', '~> 2.0.0')
+
+  s.add_development_dependency('bundler', '~> 1.12.0')
+  s.add_development_dependency('rspec', '~> 3.2')
+  s.add_development_dependency('rake')
+end
+

data/lib/JiraMule/Tempo.rb

@@ -0,0 +1,75 @@
+require 'date'
+require 'json'
+require 'pp'
+require 'vine'
+require 'JiraMule/Config'
+require 'JiraMule/Passwords'
+require 'JiraMule/http'
+require 'JiraMule/verbosing'
+
+module JiraMule
+    class Tempo
+        include Verbose
+        include Http
+
+        def initialize()
+            acc = Account.new
+            up = acc.loginInfo
+            @username = up[:email]
+            @password = up[:password]
+        end
+        attr_reader :username, :password
+
+        def endPoint(path='')
+          URI($cfg['net.url'] + '/rest/tempo-timesheets/3/' + path.to_s)
+        end
+
+        # Get worklogs from Tempo plugin
+        def workLogs(username=@username, dateFrom=nil, dateTo=nil, project=nil)
+            q = {:username => username}
+            q[:dateFrom] = DateTime.parse(dateFrom).to_date.iso8601 unless dateFrom.nil?
+            q[:dateTo] = DateTime.parse(dateTo).to_date.iso8601 unless dateTo.nil?
+            q[:projectKey] = project unless project.nil?
+            #q[:accountKey]
+            #q[:teamId]
+
+            verbose "Fetching worklogs for #{q}"
+            get('worklogs', q)
+        end
+
+        ## Submit a timesheet for approval.
+        def submitForApproval(period=nil, name=@username, comment='')
+          if period.nil? then
+            # First day of work week
+            cur = currentApprovalStatus(nil, name)
+            period = cur.access 'period.dateFrom'
+          end
+          verbose "Submitting timesheet for #{period}"
+          post('timesheet-approval/', {
+            :user=>{
+              :name=>name,
+            },
+            :period=>{
+              :dateFrom=>period,
+            },
+            :action=>{
+              :name=>:submit,
+              :comment=>comment,
+            }
+          }) unless $cfg['tool.dry']
+        end
+
+        def currentApprovalStatus(period=nil, name=@username)
+          verbose "Getting current approval status; #{period} #{name}"
+          q = {
+            :username => name,
+          }
+          q[:periodStartDate] = period unless period.nil?
+
+          get('timesheet-approval/current/', q)
+        end
+    end
+
+end
+
+#  vim: set ai et sw=2 ts=2 :

data/lib/JiraMule/commands/assign.rb

@@ -0,0 +1,38 @@
+require 'JiraMule/jiraUtils'
+
+command :assign do |c|
+  c.syntax = 'jm assign [options] <to user> <keys...> '
+  c.summary = 'Assign keys to another user'
+
+  c.action do |args, options|
+
+    jira = JiraMule::JiraUtils.new(args, options)
+
+    muser = args.shift
+    if muser == '-1' or muser =~ /^:de/ then
+      # assign to default
+      to = '-1'
+    else
+      to = jira.checkUser(muser)
+      if to.count > 1 then
+        say "Username '#{muser}' is ambigious."
+        say "Could be: #{to.join(' ')}"
+        exit 4
+      elsif to.empty? then
+        say "No such user: '#{muser}'"
+        exit 4
+      end
+      to = to.first
+    end
+
+    # keys can be with or without the project prefix.
+    keys = jira.expandKeys(args)
+
+    jira.printVars(:key=>keys, :to=>to)
+
+    jira.assignTo(keys, to)
+
+  end
+end
+
+#  vim: set sw=2 ts=2 :

data/lib/JiraMule/commands/githubImport.rb

@@ -0,0 +1,46 @@
+require 'octokit'
+
+command 'github import' do |c|
+  c.syntax = %{jm github import <issue id>}
+  c.summary = %{Import a Github issue into Jira}
+
+  c.action do |args, options|
+
+    iid = args.shift
+
+    okey = $cfg['github.token']
+    if okey.nil? then
+      say_error "Missing github token!"
+      exit 2
+    end
+
+    oc = Octokit::Client.new(:access_token => okey)
+    if oc.nil? then
+      exit 3
+    end
+    oc.login
+
+    repo = oc.repo $cfg['github.project']
+    rel = repo.rels[:issues]
+    gissue = rel.get(:uri=>{:number=>iid})
+    if gissue.status != 200 then
+      say_error "Failed to get issue: #{gissue}"
+      exit 2
+    end
+    gissue = gissue.data
+
+    jira = JiraMule::JiraUtils.new(args, options)
+    # Create Issue
+    it = jira.checkIssueType
+
+    jissue = jira.createIssue(it.first[:name], gissue[:title], gissue[:body])
+    jira.verbose "Created #{jissue[:key]}"
+
+    # Link
+    jira.linkTo(jissue[:key], gissue[:html_url], gissue[:title])
+
+  end
+end
+alias_command :ghi, 'github import'
+
+#  vim: set ai et sw=2 ts=2 :

data/lib/JiraMule/commands/link.rb

@@ -0,0 +1,41 @@
+require 'JiraMule/jiraUtils'
+
+command :links do |c|
+  c.syntax = %{jm links <keys>}
+  c.summary = %{Show all remote links}
+
+  c.action do |args, options|
+    jira = JiraMule::JiraUtils.new(args, options)
+    keys = jira.expandKeys(args)
+    keys.each do |key|
+      jira.remote_links(key).each do |link|
+        obj = link[:object]
+        unless obj.nil? then
+          say "- #{obj[:title]}"
+          say "  #{obj[:url]}"
+        end
+      end
+    end
+  end
+end
+
+command :addLink do |c|
+  c.syntax = %{jm addLink <key> <url> <title>}
+  c.summary = %{Add a remote link to an issue}
+  c.action do |args, options|
+    jira = JiraMule::JiraUtils.new(args, options)
+    key = jira.expandKeys([args[0]]).first
+    url = args[1]
+    title = args[2]
+    if url.nil? then
+      say_error "Missing URL"
+    elsif title.nil? then
+      say_error "Missing Title"
+    else
+      jira.linkTo(key, url, title)
+    end
+  end
+end
+alias_command :link, :addLink
+
+#  vim: set ai et sw=2 ts=2 :

data/lib/JiraMule/commands/timesheet.rb

@@ -0,0 +1,113 @@
+require 'chronic_duration'
+require 'date'
+require 'terminal-table'
+require 'vine'
+require 'JiraMule/jiraUtils'
+require 'JiraMule/Tempo'
+
+command :timesheet do |c|
+  c.syntax = 'jm timesheet [options]'
+  c.summary = 'Show work done this week'
+  c.description = %{Show the work done this week
+  }
+  c.example 'Show work done this week', 'jm timesheet'
+  c.example 'Show work done for project', 'jm timesheet --project DEV'
+  c.example 'Show work done for projects', 'jm timesheet --project DEV,PROD'
+  c.example 'Show work done for keys', 'jm timesheet 12 PROD-15 99 STG-6'
+
+  c.option '--project PROJECTS', Array, 'Limit results to specific projects'
+
+  #c.option '--prev COUNT', Integer, 'Look at previous weeks'
+  c.option '--starts_on DAY', String, 'Which day does the week start on'
+
+  c.action do |args, options|
+    options.default :starts_on => 'Mon'
+
+    jira = JiraMule::JiraUtils.new
+    tempo = JiraMule::Tempo.new
+
+    #Days Of Week
+    dows = [:Sun,:Mon,:Tue,:Wed,:Thu,:Fri,:Sat]
+    dayShift = dows.index{|i| options.starts_on.downcase.start_with? i.to_s.downcase}
+    workweek = dows.rotate dayShift
+
+    dayTo = Date.today
+    dayFrom = dayTo
+    while not dayFrom.wday == dayShift do
+      dayFrom = dayFrom.prev_day
+    end
+
+    # Get keys to get worklogs from
+    keys = jira.expandKeys(args)
+    if keys.empty? then
+      query = %{worklogAuthor = #{jira.username}}
+      query << %{ AND worklogDate >= #{dayFrom.iso8601}}
+
+      if options.project and not options.project.empty? then
+        query << ' AND ('
+        query << options.project.map{|p| %{project="#{p}"}}.join(' OR ')
+        query << ')'
+      end
+
+      keys = jira.getIssues(query, ['key']).map{|k| k[:key]}
+    end
+    jira.printVars(:keys=>keys) if $cfg['tool.verbose']
+
+    wls = tempo.workLogs(jira.username, dayFrom.iso8601, dayTo.iso8601)
+
+    # filter out entries not in keys.
+    selected = wls.select{|i| keys.include? i.access('issue.key')}
+
+    # build table; each row is a key. each column is hours worked in SSMTWTF
+    # multiple passes.
+    # 1: build hash by issue, each value is a hash by week day.
+    hrows = {}
+    selected.each do |isu|
+      k = isu.access('issue.key')
+      hrows[k] = {} unless hrows.has_key? k
+      ds = DateTime.parse(isu[:dateStarted]).to_date
+      dow = dows[ds.wday]
+      hrows[k][dow] = 0 unless hrows[k].has_key?(dow)
+      hrows[k][dow] += isu[:timeSpentSeconds]
+    end
+
+    totals = Hash[ *(workweek.map{|i| [i,0]}.flatten) ]
+    # 2: reshape into Array or Arrays.
+    rows = hrows.to_a.map do |row|
+      # row[0] is key, want to keep that.
+      # row[1] is a hash we want to sort and flatten.
+      row[1] = workweek.map do |d|
+        s = row[1][d]
+        if s.nil? then
+          nil
+        else
+          totals[d] += s
+          ChronicDuration.output(s, :format=>:short)
+        end
+      end
+      row.flatten
+    end
+
+    trow = workweek.map do |d|
+      s = totals[d]
+      if s.nil? then
+        nil
+      else
+        ChronicDuration.output(s, :format=>:short)
+      end
+    end
+    trow.insert(0, 'TOTALS:')
+
+    hdr = workweek.insert(0, :Key)
+    table =  Terminal::Table.new do |t|
+      t.headings = hdr
+      t.rows = rows
+      t.add_separator
+      t.add_row trow
+    end
+    puts table
+  end
+end
+alias_command :ts, :timesheet
+
+#  vim: set sw=2 ts=2 :

data/lib/JiraMule/gb.rb

@@ -0,0 +1,33 @@
+require 'pp'
+
+# You don't need this.
+# To use this:
+# - mkdir -p ~/.jiramule/plugins
+# - ln gb.rb ~/.jiramule/plugins
+
+command :_gb do |c|
+  c.syntax = %{jm _gb <class> <method> (<args>)}
+  c.summary = %{Call internal class methods directly.}
+  c.description = %{Call internal class methods directly.}
+
+  c.action do |args, options|
+    cls = args[0]
+    meth = args[1].to_sym
+    args.shift(2)
+
+    begin
+      gb = Object::const_get("JiraMule::#{cls}").new
+      if gb.respond_to? meth then
+        pp gb.__send__(meth, *args)
+      else
+        say_error "'#{cls}' doesn't '#{meth}'"
+      end
+    rescue Exception => e
+      say_error e.message
+      pp e
+    end
+  end
+end
+
+
+#  vim: set ai et sw=2 ts=2 :