taskmapper-cli 0.0.1

data/README.rdoc

@@ -0,0 +1,94 @@
+= tm - Command line interface for TaskMapper[http://github.com/hybridgroup/taskmapper]
+
+This application provides an easy to use interface to interact with any TaskMapper 
+provider in an standard way.
+
+= Install:
+
+  gem install tm
+
+Also it will be include with TaskMapper so no need to install it alone.
+
+== Use
+
+=== Authentication 
+
+  tm --provider kanbanpad --authentication 'token:kdkdjdkd,username:username' 
+
+Refer to particular providers documentation to know which fields they need for authentication.
+After using this mechanism for authentication is better to pass the `initconfig` command to not 
+be writing the credentials for each command. This will use the specified provider name as default.
+
+=== Project command
+
+==== List projects
+
+Available options
+* --format=pretty|csv|table (Default: pretty)
+* --no-color 
+
+This is the default operation on projects. It will list all the projects for a given user. 
+(Default: --list=all)
+
+  tm project --list=all --format=table
+
+http://dl.dropbox.com/u/576024/2013-03-27-173542_952x116_scrot.png
+
+  tm project --list=single --search-attribute='name:Project' 
+
+http://dl.dropbox.com/u/576024/2013-03-27-173642_842x113_scrot.png"
+
+=== Task command
+
+==== List tasks
+
+Available options
+* --format=pretty|csv|table (Default: pretty)
+* --no-color
+
+This is the default operation on tasks. It will list all the tasks for a given project.
+
+Note: For the --project-attribute option you should send an attribute for the project to search, 
+ex. 'name:test-project'
+(Default --list=all)
+
+    tm task --project-attribute='name:test-project' 
+
+http://dl.dropbox.com/u/576024/2013-04-02-164829_1099x269_scrot.png
+
+    tm task --list=first --project-attribute='name:test-project'
+
+http://dl.dropbox.com/u/576024/2013-04-02-165558_976x133_scrot.png
+
+    tm task --list=last --project-attribute='name:test-project'
+
+http://dl.dropbox.com/u/576024/2013-04-02-165840_1011x124_scrot.png
+
+    tm task --list=single --project-attribute='name:test-project' --search-attribute='title:test-task'
+
+http://dl.dropbox.com/u/576024/2013-04-02-170111_950x124_scrot.png
+
+=== Comment command
+
+==== List comments
+
+Available options 
+* --format=pretty|csv|table (Default: pretty)
+* --no-color
+
+This is the default operation on comments. It will list all the comments for a given task.
+
+Note: This command is dependant of two other options, --project-attribute and --task-attribute.
+The --project-attribute is the same as the task command, it's needed to figure out which project
+the command will execute upon, the --task-attribute is needed to figure out on which particular task
+the user will retrieve the comments. (ex. 'title:test-task') 
+
+    tm comment --project-attribute='name:test-project' --task-attribute='title:test-task'
+
+http://dl.dropbox.com/u/576024/2013-04-04-143242_1196x148_scrot.png
+
+For more help 
+
+  tm help
+  tm help <command>
+

data/bin/tm

@@ -0,0 +1,184 @@
+#!/usr/bin/env ruby
+$LOAD_PATH << File.expand_path(File.dirname(__FILE__) + '/../lib')
+require 'gli'
+require 'tm'
+
+include TM
+
+begin # XXX: Remove this begin/rescue before distributing your app
+  require 'tm'
+rescue LoadError
+  STDERR.puts "In development, you need to use `bundle exec bin/tm` to run your app"
+  STDERR.puts "At install-time, RubyGems will make sure lib, etc. are in the load path"
+  STDERR.puts "Feel free to remove this message from bin/tm now"
+  exit 64
+end
+
+include GLI::App
+
+output_formats = {
+  'csv' => TM::Format::CSV.new,
+  'pretty' => TM::Format::Pretty.new, 
+  'table' => TM::Format::Table.new
+}
+
+program_desc 'Command line interface for Taskmapper'
+config_file File.join(ENV['HOME'], '.taskmapper.rc.yml')
+
+version Tm::VERSION
+
+desc 'Provider name'
+arg_name "ex. kanbanpad, github, etc"
+flag [:p, :provider]
+
+desc 'Authentication for provider' 
+arg_name "'token:password, username:user'"
+flag [:a, :authentication]
+
+desc 'Manage iteration with projects' 
+arg_name 'Command for managing projects' 
+command :project do |c|
+  project_commands = { 
+    'all' => TM::Commands::ListAllProjects,
+    'first' => TM::Commands::FirstProject,
+    'last' => TM::Commands::LastProject,
+    'single' => TM::Commands::SingleProject
+  }
+  c.desc 'List projects'
+  c.long_desc """
+  List projects possible arguments 'all', 'single', 'first', 'last'. Default 'all'.
+  The single flag needs attributes to search for a particular project
+  """
+  c.default_value 'all'
+  c.arg_name project_commands.keys.join("|")
+  c.flag [:l, :list]
+
+  c.desc 'Format of the output'
+  c.arg_name output_formats.keys.join("|")
+  c.default_value 'pretty'
+  c.flag :format
+
+  c.desc 'Disable color'
+  c.switch 'no-color'
+
+  c.desc 'Attributes for --list=single. ex "name:ProjectName"'
+  c.flag 'search-attribute'
+
+  c.action do |global_options, options, args| 
+    Sickill::Rainbow.enabled = false if options[:'no-color'] 
+    formatter = output_formats[options[:format]]
+    command = project_commands[options[:list]]
+    search_attributes = options[:'search-attribute']
+    command.new(TM::ProviderHandler.build_handler(
+      global_options[:provider], 
+      global_options[:authentication]), formatter, search_attributes).execute
+  end
+end
+
+desc 'Manage iteration with tickets, depends on a project name'
+command :task do |c|
+  ticket_commands = { 
+    'all' => TM::Commands::ListAllTasks,
+    'first' => TM::Commands::FirstTask,
+    'last' => TM::Commands::LastTask,
+    'single' => TM::Commands::SingleTask
+  }
+
+  c.desc 'Name of the project to execute tickets operations on'
+  c.arg_name 'name:test-project'
+  c.flag 'project-attribute'
+
+  c.desc 'List tasks'
+  c.long_desc """
+  List tasks possible arguments 'all', 'first', 'last', 'single'. Default 'all'.
+  """
+  c.default_value 'all'
+  c.arg_name ticket_commands.keys.join("|")
+  c.flag [:l, :list]
+
+  c.desc 'Format of the output'
+  c.arg_name output_formats.keys.join("|")
+  c.default_value 'pretty'
+  c.flag :format
+
+  c.desc 'Attributes for --list=single. ex "name:TaskName"'
+  c.flag 'search-attribute'
+
+  c.desc 'Disable color'
+  c.switch 'no-color'
+
+  c.action do |global_options, options, args| 
+    Sickill::Rainbow.enabled = false if options[:'no-color']
+    formatter = output_formats[options[:format]]
+    command = ticket_commands[options[:list]]
+    command.new(TM::ProviderHandler.build_handler(
+      global_options[:provider],
+      global_options[:authentication]), 
+      formatter, 
+      options[:'project-attribute']).execute(options[:'search-attribute'])
+  end
+end
+
+desc 'Manage iteration with comments, depends on a project and task'
+command :comment do |c|
+  comment_commands = { 
+    'all' => TM::Commands::ListAllCommentsForTask
+  }
+
+  c.desc 'Name of the project to execute comments operations on'
+  c.arg_name 'name:test-project'
+  c.flag 'project-attribute'
+
+  c.desc 'List tasks'
+  c.long_desc """
+  List tasks possible arguments 'all'.
+  """
+  c.default_value 'all'
+  c.arg_name comment_commands.keys.join("|")
+  c.flag [:l, :list]
+
+  c.desc 'Format of the output'
+  c.arg_name output_formats.keys.join("|")
+  c.default_value 'pretty'
+  c.flag :format
+
+  c.desc 'Use to find the task to search for comments Ex. "name:TaskName"'
+  c.flag 'task-attribute'
+
+  c.desc 'Disable color'
+  c.switch 'no-color'
+
+  c.action do |global_options, options, args| 
+    Sickill::Rainbow.enabled = false if options[:'no-color']
+    formatter = output_formats[options[:format]]
+    command = comment_commands[options[:list]]
+    command.new(TM::ProviderHandler.build_handler(
+      global_options[:provider],
+      global_options[:authentication]), 
+      formatter, 
+      options[:'project-attribute']).execute(options[:'task-attribute'])
+  end
+end
+
+pre do |global,command,options,args|
+  # Pre logic here
+  # Return true to proceed; false to abort and not call the
+  # chosen command
+  # Use skips_pre before a command to skip this block
+  # on that command only
+  true
+end
+
+post do |global,command,options,args|
+  # Post logic here
+  # Use skips_post before a command to skip this
+  # block on that command only
+end
+
+on_error do |exception|
+  # Error logic here
+  # return false to skip default error handling
+  true
+end
+
+exit run(ARGV)

data/lib/tm.rb

@@ -0,0 +1,32 @@
+require 'tm/version.rb'
+
+require 'tm/string_extensions'
+
+# Taskmapper provider handler 
+require 'tm/provider_handler'
+
+# Commands
+require 'tm/commands/command'
+require 'tm/commands/list_all_projects'
+require 'tm/commands/first_project'
+require 'tm/commands/last_project'
+require 'tm/commands/single_project'
+require 'tm/commands/list_all_tasks'
+require 'tm/commands/first_task'
+require 'tm/commands/last_task'
+require 'tm/commands/single_task'
+
+# Formatters
+require 'tm/commands/list_all_comments_for_task'
+
+require 'tm/format/format'
+require 'tm/format/csv'
+require 'tm/format/pretty'
+require 'tm/format/table'
+
+require 'tm/exceptions'
+
+module TM
+
+end
+

data/lib/tm/version.rb

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

data/tm.rdoc

@@ -0,0 +1,5 @@
+= tm
+
+Generate this with
+    tm rdoc
+After you have described your command line interface

metadata

@@ -0,0 +1,432 @@
+--- !ruby/object:Gem::Specification
+name: taskmapper-cli
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Rafael George
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: taskmapper
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: taskmapper-kanbanpad
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: taskmapper-github
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: taskmapper-basecamp
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: taskmapper-bugherd
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: taskmapper-bugzilla
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: taskmapper-fogbugz
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: taskmapper-github
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: taskmapper-kanbanpad
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: taskmapper-lighthouse
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: taskmapper-pivotal
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: taskmapper-rally
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: taskmapper-redmine
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: taskmapper-trac
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: taskmapper-unfuddle
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: taskmapper-zendesk
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rainbow
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: terminal-table
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: aruba
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: gli
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.5.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.5.5
+description: 
+email: george.rafael@gmail.com
+executables:
+- tm
+extensions: []
+extra_rdoc_files:
+- README.rdoc
+- tm.rdoc
+files:
+- bin/tm
+- lib/tm/version.rb
+- lib/tm.rb
+- README.rdoc
+- tm.rdoc
+homepage: http://github.com/cored
+licenses: []
+post_install_message: 
+rdoc_options:
+- --title
+- tm
+- --main
+- README.rdoc
+- -ri
+require_paths:
+- lib
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3180869278577975679
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -3180869278577975679
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Command line interface for TaskMapper
+test_files: []