fogbugz 1.0.1

data/bin/fogbugz

@@ -0,0 +1,78 @@
+#!/usr/bin/env ruby
+
+basename = File.basename(__FILE__)
+absolute = File.expand_path(__FILE__)
+
+usage = <<HERE
+usage: #{basename} <subcommand> [options]
+       #{basename} <case>
+
+The subcommands are:
+   areas        List active areas.
+   assign       Assign a case.
+   categories   List available categories.
+   close        Close a resolved case.
+   edit         Edit an existing case.
+   filter       Set the current default filter.
+   filters      List available filters.
+   list         List cases by the current filter or a search query.
+   login        Create an API token.
+   logoff       Invalidate an API token.
+   milestones   List active milestones.
+   new          Create a new case.
+   people       List active users.
+   priorities   List available priorities.
+   projects     List active projects.
+   reactivate   Reactivate a resolved case.
+   reopen       Reopen a closed case.
+   resolve      Resolve a case.
+   show         Show details on a case.
+   start        Start working on a case.
+   statuses     List available statuses.
+   stop         Stop working on a case.
+
+See '#{basename} help <commands>' for more information on a \
+specific command.
+HERE
+
+if ARGV.length == 0
+  puts usage
+  exit 1
+end
+
+case ARGV[0]
+when 'help'
+  if ARGV.length == 1
+    puts usage
+    exit 1
+  else
+    case ARGV[1]
+    when 'areas', 'assign', 'categories', 'close', 'edit', 'filter', 'filters',
+      'list', 'login', 'logoff', 'milestones', 'new', 'people', 'priorities',
+      'projects', 'reactivate', 'reopen', 'resolve', 'show', 'start',
+      'statuses', 'stop'
+      subcommand = ARGV[1]
+      ARGV.clear
+      ARGV.push '--help'
+      load "#{absolute}-#{subcommand}"
+      exit 0
+    else
+      puts usage
+      exit 1
+    end
+  end
+when 'areas', 'assign', 'categories', 'close', 'edit', 'filter', 'filters',
+  'list', 'login', 'logoff', 'milestones', 'new', 'people', 'priorities',
+  'projects', 'reactivate', 'reopen', 'resolve', 'show', 'start',
+  'statuses', 'stop'
+  load "#{absolute}-#{ARGV.shift}"
+  exit 0
+else
+  if ARGV[0].to_i.to_s == ARGV[0]
+    load "#{absolute}-show"
+    exit 0
+  else
+    puts usage
+    exit 1
+  end
+end

data/bin/fogbugz-areas

@@ -0,0 +1,64 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'typhoeus'
+require 'xml'
+require 'optparse'
+
+api_url = ENV['FOGBUGZ_API_URL']
+unless api_url
+  puts "Environment variable FOGBUGZ_API_URL must be set."
+  exit 1
+end
+
+api_token = ENV['FOGBUGZ_API_TOKEN']
+unless api_url
+  puts "Environment variable FOGBUGZ_API_TOKEN must be set."
+  exit 1
+end
+
+options = {}
+optparse = OptionParser.new do |opts|
+  opts.banner = "usage: #{File::basename(__FILE__)} [options]"
+
+  options[:verbose] = false
+  opts.on('-v', '--verbose', 'Output verbose debugging information') do
+    options[:verbose] = true
+  end
+
+  opts.on_tail('-h', '--help') do
+    puts optparse.help
+    exit 1
+  end
+
+  options[:project] = nil
+  opts.on('--project=<project>', 'Filter by project.') do |project|
+    options[:project] = project
+  end
+end
+optparse.parse!
+
+response = Typhoeus::Request.get(api_url,
+  :verbose => options[:verbose],
+  :params => {
+    :cmd => 'listAreas',
+    :token => api_token,
+    :ixProject => options[:project] })
+if response.code != 200
+  puts "HTTP request to #{api_url} failed with code #{response.code}."
+  exit 1
+end
+
+result = XML::Parser.string(response.body).parse
+error = result.find_first('/response/error')
+if error
+  puts "Failed with error: #{error.content}."
+  exit 1
+end
+
+result.find('/response/areas/area').each do |status|
+  puts format("%-20.20s  %-20.20s  %s\n",
+              status.find_first('sPersonOwner').content,
+              status.find_first('sProject').content,
+              status.find_first('sArea').content).strip!
+end

data/bin/fogbugz-assign

@@ -0,0 +1,58 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'typhoeus'
+require 'xml'
+require 'optparse'
+
+api_url = ENV['FOGBUGZ_API_URL']
+unless api_url
+  puts "Environment variable FOGBUGZ_API_URL must be set."
+  exit 1
+end
+
+api_token = ENV['FOGBUGZ_API_TOKEN']
+unless api_url
+  puts "Environment variable FOGBUGZ_API_TOKEN must be set."
+  exit 1
+end
+
+options = {}
+optparse = OptionParser.new do |opts|
+  opts.banner = "usage: #{File::basename(__FILE__)} [options] <case> <assignee>"
+
+  options[:verbose] = false
+  opts.on('-v', '--verbose', 'Output verbose debugging information.') do
+    options[:verbose] = true
+  end
+
+  opts.on_tail('-h', '--help') do
+    puts optparse.help
+    exit 1
+  end
+end
+optparse.parse!
+
+unless ARGV.length == 2
+  puts optparse.help
+  exit 1
+end
+
+response = Typhoeus::Request.get(api_url,
+  :verbose => options[:verbose],
+  :params => {
+    :cmd => 'assign',
+    :token => api_token,
+    :ixBug => ARGV[0],
+    :sPersonAssignedTo => ARGV[1] })
+if response.code != 200
+  puts "HTTP request to #{api_url} failed with code #{response.code}."
+  exit 1
+end
+
+result = XML::Parser.string(response.body).parse
+error = result.find_first('/response/error')
+if error
+  puts "Failed with error: #{error.content}."
+  exit 1
+end

data/bin/fogbugz-categories

@@ -0,0 +1,55 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'typhoeus'
+require 'xml'
+require 'optparse'
+
+api_url = ENV['FOGBUGZ_API_URL']
+unless api_url
+  puts "Environment variable FOGBUGZ_API_URL must be set."
+  exit 1
+end
+
+api_token = ENV['FOGBUGZ_API_TOKEN']
+unless api_url
+  puts "Environment variable FOGBUGZ_API_TOKEN must be set."
+  exit 1
+end
+
+options = {}
+optparse = OptionParser.new do |opts|
+  opts.banner = "usage: #{File::basename(__FILE__)} [options]"
+
+  options[:verbose] = false
+  opts.on('-v', '--verbose', 'Output verbose debugging information') do
+    options[:verbose] = true
+  end
+
+  opts.on_tail('-h', '--help') do
+    puts optparse.help
+    exit 1
+  end
+end
+optparse.parse!
+
+response = Typhoeus::Request.get(api_url,
+  :verbose => options[:verbose],
+  :params => {
+    :cmd => 'listCategories',
+    :token => api_token })
+if response.code != 200
+  puts "HTTP request to #{api_url} failed with code #{response.code}."
+  exit 1
+end
+
+result = XML::Parser.string(response.body).parse
+error = result.find_first('/response/error')
+if error
+  puts "Failed with error: #{error.content}."
+  exit 1
+end
+
+result.find('/response/categories/category').each do |status|
+  puts status.find_first('sCategory').content
+end

data/bin/fogbugz-close

@@ -0,0 +1,57 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'typhoeus'
+require 'xml'
+require 'optparse'
+
+api_url = ENV['FOGBUGZ_API_URL']
+unless api_url
+  puts "Environment variable FOGBUGZ_API_URL must be set."
+  exit 1
+end
+
+api_token = ENV['FOGBUGZ_API_TOKEN']
+unless api_url
+  puts "Environment variable FOGBUGZ_API_TOKEN must be set."
+  exit 1
+end
+
+options = {}
+optparse = OptionParser.new do |opts|
+  opts.banner = "usage: #{File::basename(__FILE__)} [options] <case>"
+
+  options[:verbose] = false
+  opts.on('-v', '--verbose', 'Output verbose debugging information.') do
+    options[:verbose] = true
+  end
+
+  opts.on_tail('-h', '--help') do
+    puts optparse.help
+    exit 1
+  end
+end
+optparse.parse!
+
+unless ARGV[0]
+  puts optparse.help
+  exit 1
+end
+
+response = Typhoeus::Request.get(api_url,
+  :verbose => options[:verbose],
+  :params => {
+    :cmd => 'listAreas',
+    :token => api_token,
+    :ixBug => ARGV[0] })
+if response.code != 200
+  puts "HTTP request to #{api_url} failed with code #{response.code}."
+  exit 1
+end
+
+result = XML::Parser.string(response.body).parse
+error = result.find_first('/response/error')
+if error
+  puts "Failed with error: #{error.content}."
+  exit 1
+end

data/bin/fogbugz-edit

@@ -0,0 +1,281 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'typhoeus'
+require 'xml'
+require 'tempfile'
+require 'optparse'
+require 'yaml'
+require 'English'
+
+api_url = ENV['FOGBUGZ_API_URL']
+unless api_url
+  puts "Environment variable FOGBUGZ_API_URL must be set."
+  exit 1
+end
+
+api_token = ENV['FOGBUGZ_API_TOKEN']
+unless api_url
+  puts "Environment variable FOGBUGZ_API_TOKEN must be set."
+  exit 1
+end
+
+editor = ENV['EDITOR'] || 'vim'
+
+options = {}
+optparse = OptionParser.new do |opts|
+  opts.banner = "usage: #{File::basename(__FILE__)} [options] <case>"
+
+  options[:verbose] = false
+  opts.on('-v', '--verbose', 'Output verbose debugging information') do
+    options[:verbose] = true
+  end
+
+  opts.on_tail('-h', '--help') do
+    puts optparse.help
+    exit 1
+  end
+
+  options[:file] = nil
+  opts.on('-f', '--file=<file>',
+          'Take the case content from the given file. Use - to read from STDIN.') do |file|
+    options[:file] = file
+  end
+
+  options[:template] = nil
+  opts.on('-t', '--template=<template>',
+          'Use the file content or - for STDIN as the initial case content.') do |template|
+    options[:template] = template
+  end
+end
+optparse.parse!
+
+unless ARGV.length == 1
+  puts optparse.help
+  exit 1
+end
+case_id = ARGV[0]
+
+response = Typhoeus::Request.get(api_url,
+  :verbose => options[:verbose],
+  :params => {
+    :cmd => 'search',
+    :token => api_token,
+    :cols => 'ixBug,ixBugParent,tags,sTitle,sProject,sArea,sFixFor,sCategory,sPersonAssignedTo,sPriority,hrsCurrEst,events',
+    :q => case_id })
+if response.code != 200
+  puts "HTTP request to #{api_url} failed with code #{response.code}."
+  exit 1
+end
+
+result = XML::Parser.string(response.body).parse
+error = result.find_first('/response/error')
+if error
+  puts "Failed with error: #{error.content}."
+  exit 1
+end
+
+bug = result.find_first("/response/cases/case[@ixBug='#{case_id}']")
+unless bug
+  puts "Case #{case_id} does not exist."
+  exit 1
+end
+
+invoke_editor = true
+if options[:file]
+  if options[:file] == '-'
+    ARGV.replace []
+  else
+    ARGV.replace [options[:file]]
+  end
+  template = ARGF.read
+  invoke_editor = false
+elsif options[:template]
+  if options[:template] == '-'
+    ARGV.replace []
+  else
+    ARGV.replace [options[:template]]
+  end
+  template = ARGF.read
+else
+  template = ''
+  template << <<HERE
+# Fill in metadata for the case.
+HERE
+
+  sTitle = bug.find_first('sTitle')
+  if sTitle and sTitle.content and not sTitle.content.empty?
+    template << "# title: #{sTitle.content}\n"
+  else
+    template << "# title: <title>\n"
+  end
+
+  sPersonAssignedTo = bug.find_first('sPersonAssignedTo')
+  if sPersonAssignedTo and sPersonAssignedTo.content and
+      not sPersonAssignedTo.content.empty?
+    template << "# assignee: #{sPersonAssignedTo.content}\n"
+  else
+    template << "# assignee: <person>\n"
+  end
+
+  ixBugParent = bug.find_first('ixBugParent')
+  if ixBugParent and ixBugParent.content and not ixBugParent.content.empty? and
+      ixBugParent.content != '0'
+    template << "# parent: #{ixBugParent.content}\n"
+  else
+    template << "# parent: <case>\n"
+  end
+
+  tags = bug.find('tags/tag').collect { |tag| tag.content }
+  if tags and not tags.empty?
+    template << "# tags: [#{tags.join(', ')}]\n"
+  else
+    template << "# tags: [bug, enhancement]\n"
+  end
+
+  sProject = bug.find_first('sProject')
+  if sProject and sProject.content and not sProject.content.empty?
+    template << "# project: #{sProject.content}\n"
+  else
+    template << "# project: <project>\n"
+  end
+
+  sArea = bug.find_first('sArea')
+  if sArea and sArea.content and not sArea.content.empty?
+    template << "# area: #{sArea.content}\n"
+  else
+    template << "# area: <area>\n"
+  end
+
+  sFixFor = bug.find_first('sFixFor')
+  if sFixFor and sFixFor.content and not sFixFor.content.empty?
+    template << "# milestone: #{sFixFor.content}\n"
+  else
+    template << "# milestone: <milestone>"
+  end
+
+  sCategory = bug.find_first('sCategory')
+  if sCategory and sCategory.content and not sCategory.content.empty?
+    template << "# category: #{sCategory.content}\n"
+  else
+    template << "# category: <category>"
+  end
+
+  sPriority = bug.find_first('sPriority')
+  if sPriority and sPriority.content and not sPriority.content.empty?
+    template << "# priority: #{sPriority.content}\n"
+  else
+    template << "# priority: <priority>"
+  end
+
+  hrsCurrEst = bug.find_first('hrsCurrEst')
+  if hrsCurrEst and hrsCurrEst.content and not hrsCurrEst.content.empty? and
+      hrsCurrEst.content != '0'
+    template << "# estimate: #{hrsCurrEst.content}\n"
+  else
+    template << "# estimate: <estimate>\n"
+  end
+
+  template << "\n"
+  bug.find('events/event').each do |event|
+    evtDescription = event.find_first('evtDescription')
+    if evtDescription and evtDescription.content and
+        not evtDescription.content.empty?
+      time = Time.parse(event.find_first('dt').content).localtime
+      template << format("# %s at %s on %s.\n", evtDescription.content,
+                         time.strftime('%-l:%M %p'),
+                         time.strftime('%A, %B %e %Y'))
+    end
+
+    sChanges = event.find_first('sChanges')
+    if sChanges and sChanges.content and not sChanges.content.empty?
+      commented = sChanges.content.gsub(/\n/, "\n# ")
+      template << "# #{commented}\n"
+    end
+
+    summary = event.find_first('s')
+    if summary and summary.content and not summary.content.empty?
+      commented = summary.content.gsub(/\n/, "\n# ")
+      template << "# #{commented}\n"
+    end
+    template << "\n"
+  end
+  template << <<HERE
+# Enter an additional note for the case after the dashes.
+---
+HERE
+end
+
+content = template
+if invoke_editor
+  tempfile = Tempfile.new ['case', '.md']
+  tempfile.write template
+  tempfile.close
+  rc = system "#{editor} #{tempfile.path}"
+  unless rc
+    puts "Editor exited with non-zero status. Aborting."
+    exit 1
+  end
+  tempfile.open
+  content = tempfile.read
+  tempfile.close
+  tempfile.delete
+end
+
+data = {}
+if content =~ /(.*?\n?)^(---\s*$\n?)/m
+  # Combined YAML front matter with text content.
+  begin
+    data = YAML.load($1) || {}
+    data['body'] = $POSTMATCH if $POSTMATCH and not $POSTMATCH.empty?
+  rescue => e
+    puts "Exception reading YAML front matter. #{e.inspect}"
+    exit 1
+  end
+else
+  begin
+    # YAML only content.
+    data = YAML.load(content)
+    was_yaml = true if data and not data.empty?
+    if data.instance_of? String
+      # Text only content.
+      data = { 'body' => data }
+    end
+  rescue => e
+    data = {}
+  end
+end
+
+if not data or data.empty?
+  puts "No changes to case. Aborting."
+  exit 1
+end
+
+response = Typhoeus::Request.get(api_url,
+  :verbose => options[:verbose],
+  :params => {
+    :cmd => 'edit',
+    :token => api_token,
+    :ixBug => case_id,
+    :sTitle => data['title'],
+    :ixBugParent => data['parent'],
+    :sTags => data['tags'] ? data['tags'].join(',') : nil,
+    :sProject => data['project'],
+    :sArea => data['area'],
+    :sFixFor => data['milestone'],
+    :sCategory => data['category'],
+    :sPersonAssignedTo => data['assignee'],
+    :sPriority => data['priority'],
+    :hrsCurrEst => data['estimate'],
+    :sEvent => data['body'] })
+if response.code != 200
+  puts "HTTP request to #{api_url} failed with code #{response.code}."
+  exit 1
+end
+
+result = XML::Parser.string(response.body).parse
+error = result.find_first('/response/error')
+if error
+  puts "Failed with error: #{error.content}."
+  exit 1
+end