pt 0.3.9 → 0.5

data/Changelog.md

@@ -1,5 +1,9 @@
 # pt changelog
 
+## v0.4
+
+Added support for calling functions without going through the walkthroughs ( orta )
+
 ## v0.3.9
 
 Attachments displayed in 'show' task, thanks Anthony Crumley!

data/README.md

@@ -12,31 +12,35 @@ The first time you run it, `pt` will ask you some data about your Pivotal Tracke
 
 Run `pt` from the root folder of your project.
 
-    pt          # shows your "My work" tasks list
+    pt                                     # show all available tasks
 
-Run `pt create` to create a new bug, chore or feature.
+    pt create    [title] ~[owner] ~[type]  # create a new task
 
-The rest of the commands will open you a list of your tasks and let you interact with it:
+    pt show      [id]                      # shows detailed info about a task
 
-    pt show     # shows detailed info about a task
+    pt open      [id]                      # open a task in the browser
 
-    pt open     # open a task in the browser
+    pt assign    [id] [member]             # assign owner
 
-    pt assign   # assign owner
+    pt comment   [id] [comment]            # add a comment
 
-    pt comment  # add a comment
+    pt estimate  [id] [0-3]                # estimate a task in points scale
 
-    pt estimate # estimate a task in points scale
+    pt start     [id]                      # mark a task as started
 
-    pt start    # mark a task as started
+    pt finish    [id]                      # indicate you've finished a task
 
-    pt finish   # indicate you've finished a task
+    pt deliver   [id]                      # indicate the task is delivered
 
-    pt deliver  # indicate the task is delivered
+    pt accept    [id]                      # mark a task as accepted
 
-    pt accept   # mark a task as accepted
+    pt reject    [id] [reason]             # mark a task as rejected, explaining why
 
-    pt reject   # mark a task as rejected, explaining why
+    pt find      [query]                   # search for a task by title and show it
+
+    pt done      [id] ~[0-3]               # lazy mans finish task, does everything
+
+    pt updates                             # show recent activity from your current project
 
 ## Problems?
 
@@ -44,6 +48,7 @@ You can [open a new issue](https://github.com/raul/pt/issues/new). It can be hel
 
 # Contributors
 
+[orta therox](http://orta.github.com)
 [Anthony Crumley](https://github.com/craftycode)
 [Johan Andersson](http://johan.andersson.net)
 

data/lib/pt.rb

@@ -2,7 +2,7 @@ require 'rubygems'
 
 module PT
   class InputError < StandardError; end
-  VERSION = '0.3.9'
+  VERSION = '0.5'
 end
 
 require 'pt/client'

data/lib/pt/client.rb

@@ -32,6 +32,10 @@ class PT::Client
   def get_current_iteration(project)
     PivotalTracker::Iteration.current(project)
   end
+  
+  def get_activities(project)
+    project.activities.all
+  end
 
   def get_my_work(project, user_name)
     project.stories.all :mywork => user_name

data/lib/pt/switch_ssl.rb

@@ -3,8 +3,12 @@
 module PivotalTracker
   class Client
     def self.use_ssl=(val)
-      @connection = nil if !@use_ssl == val
+      if !@use_ssl == val
+        @connection = nil if @connection
+        @connections = {} if @connections
+      end
+
       @use_ssl = val
     end
   end
-end
+end

data/lib/pt/ui.rb

@@ -15,8 +15,8 @@ class PT::UI
     @local_config = load_local_config
     @project = @client.get_project(@local_config[:project_id])
     command = args[0].to_sym rescue :my_work
-    params = args[1..-1]
-    commands.include?(command.to_sym) ? send(command.to_sym) : help(command)
+    @params = args[1..-1]
+    commands.include?(command.to_sym) ? send(command.to_sym) : help
   end
 
   def my_work
@@ -25,18 +25,46 @@ class PT::UI
     PT::TasksTable.new(stories).print
   end
 
-  def create
-    title("Let's create a new task:")
-    name = ask("Name for the new task:")
-    if ask('Do you want to assign it now? (y/n)').downcase == 'y'
+  def list
+    if @params[0] 
+      user = find_owner @params[0]
+      if user
+        stories = @client.get_my_work(@project, user.name)
+        PT::TasksTable.new(stories).print
+      end
+    else
       members = @client.get_members(@project)
       table = PT::MembersTable.new(members)
-      owner = select("Please select a member to assign him the task", table).name
+      user = select("Please select a member to see his tasks", table).name
+      title("Work for #{user} in #{project_to_s}")
+      stories = @client.get_my_work(@project, user)
+      PT::TasksTable.new(stories).print
+    end
+  end
+
+  def create
+    if @params[0]
+      name = @params[0]
+      owner = find_owner @params[1]
+      requester = @local_config[:user_name]
+      task_type = @params[2] || 'feature'
     else
-      owner = nil
+      title("Let's create a new task:")
+      name = ask("Name for the new task:")
+    end
+    
+    unless owner
+      if ask('Do you want to assign it now? (y/n)').downcase == 'y'
+        members = @client.get_members(@project)
+        table = PT::MembersTable.new(members)
+        owner = select("Please select a member to assign him the task", table).name
+      else
+        owner = nil
+      end
+      requester = @local_config[:user_name]
+      task_type = ask('Type? (c)hore, (b)ug, anything else for feature)')
     end
-    requester = @local_config[:user_name]
-    task_type = ask('Type? (c)hore, (b)ug, anything else for feature)')
+    
     task_type = case task_type
     when 'c', 'chore'
       'chore'
@@ -45,7 +73,7 @@ class PT::UI
     else
       'feature'
     end
-    result = @client.create_task(@project, name, owner, requester, task_type)
+    result = @client.create_task(@project, name, owner.name, requester, task_type)
     if result.errors.any?
       error(result.errors.errors)
     else
@@ -54,19 +82,32 @@ class PT::UI
   end
 
   def open
-    title("Tasks for #{user_s} in #{project_to_s}")
-    tasks = @client.get_my_open_tasks(@project, @local_config[:user_name])
-    table = PT::TasksTable.new(tasks)
-    task = select("Please select a story to open it in the browser", table)
+    if @params[0] 
+      tasks = @client.get_my_work(@project, @local_config[:user_name])
+      table = PT::TasksTable.new(tasks)
+      task = table[ @params[0].to_i ]
+      congrats("Opening #{task.name}")
+    else
+      tasks = @client.get_my_open_tasks(@project, @local_config[:user_name])
+      table = PT::TasksTable.new(tasks)
+      title("Tasks for #{user_s} in #{project_to_s}")
+      task = select("Please select a story to open it in the browser", table)
+    end
     `open #{task.url}`
   end
 
   def comment
-    title("Tasks for #{user_s} in #{project_to_s}")
     tasks = @client.get_my_work(@project, @local_config[:user_name])
     table = PT::TasksTable.new(tasks)
-    task = select("Please select a story to comment it", table)
-    comment = ask("Write your comment")
+    if @params[0]
+      task = table[ @params[0].to_i ]
+      comment = @params[1]
+      title("Adding a comment to #{task.name}")
+    else
+      title("Tasks for #{user_s} in #{project_to_s}")
+      task = select("Please select a story to comment it", table)
+      comment = ask("Write your comment")      
+    end
     if @client.comment_task(@project, task, comment)
       congrats("Comment sent, thanks!")
     else
@@ -75,28 +116,46 @@ class PT::UI
   end
 
   def assign
-    title("Tasks for #{user_s} in #{project_to_s}")
-    tasks = @client.get_tasks_to_assign(@project, @local_config[:user_name])
-    table = PT::TasksTable.new(tasks)
-    task = select("Please select a task to assign it an owner", table)
-    members = @client.get_members(@project)
-    table = PT::MembersTable.new(members)
-    owner = select("Please select a member to assign him the task", table).name
-    result = @client.assign_task(@project, task, owner)
+    if @params[0]
+      tasks = @client.get_my_work(@project, @local_config[:user_name])
+      table = PT::TasksTable.new(tasks)
+      task = table[@params[0].to_i]
+      owner = find_owner @params[1]
+    else    
+      title("Tasks for #{user_s} in #{project_to_s}")
+      tasks = @client.get_tasks_to_assign(@project, @local_config[:user_name])
+      table = PT::TasksTable.new(tasks)
+      task = select("Please select a task to assign it an owner", table)
+      members = @client.get_members(@project)
+      table = PT::MembersTable.new(members)
+      owner = select("Please select a member to assign him the task", table).name
+    end
+    result = @client.assign_task(@project, task, owner.name)
     if result.errors.any?
       error(result.errors.errors)
     else
-      congrats("Task assigned, thanks!")
+      congrats("Task assigned to #{owner}, thanks!")
     end
-
   end
 
   def estimate
-    title("Tasks for #{user_s} in #{project_to_s}")
-    tasks = @client.get_my_tasks_to_estimate(@project, @local_config[:user_name])
-    table = PT::TasksTable.new(tasks)
-    task = select("Please select a story to estimate it", table)
-    estimation = ask("How many points you estimate for it? (#{@project.point_scale})")
+    if @params[0]
+      tasks = @client.get_my_work(@project, @local_config[:user_name])
+      table = PT::TasksTable.new(tasks)
+      task = table[@params[0].to_i]
+      title("Estimating '#{task.name}'")  
+      
+      if [0,1,2,3].include? @params[1].to_i
+        estimation = @params[1]
+      end
+    else
+      tasks = @client.get_my_tasks_to_estimate(@project, @local_config[:user_name])
+      table = PT::TasksTable.new(tasks)
+      title("Tasks for #{user_s} in #{project_to_s}")
+      task = select("Please select a story to estimate it", table)
+    end
+    
+    estimation ||= ask("How many points you estimate for it? (#{@project.point_scale})")    
     result = @client.estimate_task(@project, task, estimation)
     if result.errors.any?
       error(result.errors.errors)
@@ -105,55 +164,64 @@ class PT::UI
     end
   end
 
-  def start
-    title("Tasks for #{user_s} in #{project_to_s}")
-    tasks = @client.get_my_tasks_to_start(@project, @local_config[:user_name])
-    table = PT::TasksTable.new(tasks)
-    task = select("Please select a story to mark it as started", table)
-    result = @client.mark_task_as(@project, task, 'started')
-    if result.errors.any?
-      error(result.errors.errors)
+  def start    
+    if @params[0]
+      tasks = @client.get_my_work(@project, @local_config[:user_name])
+      table = PT::TasksTable.new(tasks)
+      task = table[@params[0].to_i]
+      title("Starting '#{task.name}'")
     else
-      congrats("Task started, go for it!")
+      tasks = @client.get_my_tasks_to_start(@project, @local_config[:user_name])
+      table = PT::TasksTable.new(tasks)
+      title("Tasks for #{user_s} in #{project_to_s}")
+      task = select("Please select a story to mark it as started", table)    
     end
+    start_task task
   end
 
   def finish
-    title("Tasks for #{user_s} in #{project_to_s}")
-    tasks = @client.get_my_tasks_to_finish(@project, @local_config[:user_name])
-    table = PT::TasksTable.new(tasks)
-    task = select("Please select a story to mark it as finished", table)
-    if task.story_type == 'chore'
-      result = @client.mark_task_as(@project, task, 'accepted')
-    else
-      result = @client.mark_task_as(@project, task, 'finished')
-    end
-    if result.errors.any?
-      error(result.errors.errors)
+    if @params[0]
+      tasks = @client.get_my_work(@project, @local_config[:user_name])
+      table = PT::TasksTable.new(tasks)
+      task = table[@params[0].to_i]
+      title("Finishing '#{task.name}'")
     else
-      congrats("Another task bites the dust, yeah!")
+      tasks = @client.get_my_tasks_to_finish(@project, @local_config[:user_name])
+      table = PT::TasksTable.new(tasks)
+      title("Tasks for #{user_s} in #{project_to_s}")
+      task = select("Please select a story to mark it as finished", table)    
     end
+    finish_task task
   end
 
   def deliver
-    title("Tasks for #{user_s} in #{project_to_s}")
-    tasks = @client.get_my_tasks_to_deliver(@project, @local_config[:user_name])
-    table = PT::TasksTable.new(tasks)
-    task = select("Please select a story to mark it as delivered", table)
-    result = @client.mark_task_as(@project, task, 'delivered')
-    error(result.errors.errors) if result.errors.any?
-    if result.errors.any?
-      error(result.errors.errors)
+    if @params[0]
+      tasks = @client.get_my_work(@project, @local_config[:user_name])
+      table = PT::TasksTable.new(tasks)
+      task = table[@params[0].to_i]
+      title("Delivering '#{task.name}'")
     else
-      congrats("Task delivered, congrats!")
+      tasks = @client.get_my_tasks_to_deliver(@project, @local_config[:user_name])
+      table = PT::TasksTable.new(tasks)
+      title("Tasks for #{user_s} in #{project_to_s}")
+      task = select("Please select a story to mark it as delivered", table)    
     end
+
+    deliver_task task
   end
 
   def accept
-    title("Tasks for #{user_s} in #{project_to_s}")
-    tasks = @client.get_my_tasks_to_accept(@project, @local_config[:user_name])
-    table = PT::TasksTable.new(tasks)
-    task = select("Please select a story to mark it as accepted", table)
+    if @params[0]
+      tasks = @client.get_my_work(@project, @local_config[:user_name])
+      table = PT::TasksTable.new(tasks)
+      task = table[@params[0].to_i]
+      title("Accepting '#{task.name}'")
+    else
+      tasks = @client.get_my_tasks_to_accept(@project, @local_config[:user_name])
+      table = PT::TasksTable.new(tasks)
+      title("Tasks for #{user_s} in #{project_to_s}")
+      task = select("Please select a story to mark it as accepted", table)    
+    end
     result = @client.mark_task_as(@project, task, 'accepted')
     if result.errors.any?
       error(result.errors.errors)
@@ -166,16 +234,35 @@ class PT::UI
     title("Tasks for #{user_s} in #{project_to_s}")
     tasks = @client.get_my_work(@project, @local_config[:user_name])
     table = PT::TasksTable.new(tasks)
-    task = select("Please select a story to show", table)
+    if @params[0]
+      task = table[@params[0].to_i]
+    else
+      task = select("Please select a story to show", table)
+    end
+    
     result = show_task(task)
   end
 
   def reject
     title("Tasks for #{user_s} in #{project_to_s}")
-    tasks = @client.get_my_tasks_to_reject(@project, @local_config[:user_name])
-    table = PT::TasksTable.new(tasks)
-    task = select("Please select a story to mark it as rejected", table)
-    comment = ask("Please explain why are you rejecting the task")
+    if @params[0]
+      tasks = @client.get_my_work(@project, @local_config[:user_name])
+      table = PT::TasksTable.new(tasks)
+      task = table[@params[0].to_i]
+      title("Rejecting '#{task.name}'")
+    else
+      tasks = @client.get_my_tasks_to_reject(@project, @local_config[:user_name])
+      table = PT::TasksTable.new(tasks)
+      title("Tasks for #{user_s} in #{project_to_s}")
+      task = select("Please select a story to mark it as rejected", table)    
+    end
+
+    if @params[1]
+      comment = @params[1]
+    else
+      comment = ask("Please explain why are you rejecting the task")
+    end
+    
     if @client.comment_task(@project, task, comment)
       result = @client.mark_task_as(@project, task, 'rejected')
       congrats("Task rejected, thanks!")
@@ -184,6 +271,130 @@ class PT::UI
     end
   end
 
+  def done 
+    if @params[0]
+      tasks = @client.get_my_work(@project, @local_config[:user_name])
+      table = PT::TasksTable.new(tasks)
+      task = table[@params[0].to_i]
+
+      #we need this for finding again later
+      task_id = task.id
+
+      if !@params[1] && task.estimate == -1
+        error("You need to give an estimate for this task")
+        return
+      end
+
+      if @params[1] && task.estimate == -1
+          if [0,1,2,3].include? @params[1].to_i
+            estimate_task(task, @params[1].to_i)
+          end
+      end
+
+      task = find_my_task_by_task_id task_id
+      start_task task
+
+      task = find_my_task_by_task_id task_id
+      finish_task task
+      
+      task = find_my_task_by_task_id task_id
+      deliver_task task
+    end
+  end
+
+  def estimate_task task, difficulty
+    result = @client.estimate_task(@project, task, difficulty)
+    if result.errors.any?
+      error(result.errors.errors)
+    else
+      congrats("Task estimated, thanks!")
+    end
+  end
+
+  def start_task task
+    result = @client.mark_task_as(@project, task, 'started')
+    if result.errors.any?
+      error(result.errors.errors)
+    else
+      congrats("Task started, go for it!")
+    end
+  end
+
+  def finish_task task
+    if task.story_type == 'chore'
+      result = @client.mark_task_as(@project, task, 'accepted')
+    else
+      result = @client.mark_task_as(@project, task, 'finished')
+    end
+    if result.errors.any?
+      error(result.errors.errors)
+    else
+      congrats("Another task bites the dust, yeah!")
+    end
+  end
+
+  def deliver_task task
+    return if task.story_type == 'chore'
+
+    result = @client.mark_task_as(@project, task, 'delivered')
+    error(result.errors.errors) if result.errors.any?
+    if result.errors.any?
+      error(result.errors.errors)
+    else
+      congrats("Task delivered, congrats!")
+    end
+  end
+
+  def find
+    tasks = @client.get_my_work(@project, @local_config[:user_name])
+    if @params[0]
+      tasks.each do | task |
+        if (task.name.downcase.index @params[0]) && (task.current_state != 'delivered')
+          title("--- [#{(tasks.index task) + 1 }] -----------------")
+          show_task(task)
+        end
+      end
+    else
+      message("You need to provide a substring for a tasks title.")
+    end
+  end
+  
+  def updates
+    activities = @client.get_activities(@project)
+    tasks = @client.get_my_work(@project, @local_config[:user_name])
+    title("Recent Activity on #{project_to_s}")
+    activities.each do |activity|
+      show_activity(activity, tasks)
+    end
+  end
+
+  
+  def help 
+    if ARGV[0]
+      message("Command #{ARGV[0]} not recognized. Showing help.")
+    end
+    
+    title("Command line usage")
+    message("pt                                     # show all available tasks")
+    message("pt create    [title] ~[owner] ~[type]  # create a new task")
+    message("pt show      [id]                      # shows detailed info about a task")
+    message("pt open      [id]                      # open a task in the browser")
+    message("pt assign    [id] [member]             # assign owner")
+    message("pt comment   [id] [comment]            # add a comment")
+    message("pt estimate  [id] [0-3]                # estimate a task in points scale")
+    message("pt start     [id]                      # mark a task as started")
+    message("pt finish    [id]                      # indicate you've finished a task")
+    message("pt deliver   [id]                      # indicate the task is delivered");
+    message("pt accept    [id]                      # mark a task as accepted")
+    message("pt reject    [id] [reason]             # mark a task as rejected, explaining why")
+    message("pt find      [query]                   # looks in your tasks by title and presents it")
+    message("pt done      [id] ~[0-3]               # lazy mans finish task, does everything")
+    message("pt list      [member]                  # list all tasks for another pt user")
+    message("pt updates                             # show recent activity from your current project")
+    message("")
+    message("All commands can be ran without arguments for a wizard like UI.")
+  end
+
   protected
 
   def commands
@@ -295,10 +506,6 @@ class PT::UI
     @io.ask("#{msg.bold}"){ |q| q.echo = '*' }
   end
 
-  def help(command)
-    error "Command <#{command}> unknown.", "Available commands:" + commands.map{ |c| "\n- #{c}" }.join
-  end
-
   def user_s
     "#{@local_config[:user_name]} (#{@local_config[:user_initials]})"
   end
@@ -306,7 +513,36 @@ class PT::UI
   def project_to_s
     "Project #{@local_config[:project_name].upcase}"
   end
+  
+  def find_task query    
+    members = @client.get_members(@project)
+    members.each do | member |
+      if member.name.downcase.index query
+        return member.name
+      end
+    end
+    nil
+  end
+  
+  def find_my_task_by_task_id task_id    
+      tasks = @client.get_my_work(@project, @local_config[:user_name])
+      tasks.each do |task|
+        if task.id == task_id
+          return task
+        end
+      end
+  end
 
+  def find_owner query    
+    members = @client.get_members(@project)
+    members.each do | member |
+      if member.name.downcase.index query
+        return member
+      end
+    end
+    nil
+  end
+    
   def show_task(task)
     title task.name
     estimation = [-1, nil].include?(task.estimate) ? "Unestimated" : "#{task.estimate} points"
@@ -316,5 +552,16 @@ class PT::UI
     task.notes.all.each{ |n| message "#{n.author}: \"#{n.text}\"" }
     task.attachments.each{ |a| message "#{a.uploaded_by} uploaded: \"#{a.description.empty? ? "#{a.filename}" : "#{a.description} (#{a.filename})" }\" #{a.url}" }
   end
-
+  
+  def show_activity(activity, tasks)
+    story_id = activity.stories.first.id
+    task_id = nil
+    tasks.each do |story|
+      if story_id == story.id
+        task_id = tasks.index(story)
+      end
+    end
+    message("#{activity.description} [#{task_id}]")
+  end
+  
 end

metadata

@@ -1,8 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: pt
 version: !ruby/object:Gem::Version 
+  hash: 1
   prerelease: 
-  version: 0.3.9
+  segments: 
+  - 0
+  - 5
+  version: "0.5"
 platform: ruby
 authors: 
 - Raul Murciano
@@ -10,7 +14,8 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-08-13 00:00:00 Z
+date: 2011-12-25 00:00:00 +01:00
+default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: pivotal-tracker
@@ -20,7 +25,12 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 0.3.1
+        hash: 13
+        segments: 
+        - 0
+        - 4
+        - 1
+        version: 0.4.1
   type: :runtime
   version_requirements: *id001
 - !ruby/object:Gem::Dependency 
@@ -31,6 +41,11 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 5
+        segments: 
+        - 0
+        - 4
+        - 5
         version: 0.4.5
   type: :runtime
   version_requirements: *id002
@@ -42,6 +57,10 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 11
+        segments: 
+        - 1
+        - 2
         version: "1.2"
   type: :runtime
   version_requirements: *id003
@@ -53,6 +72,11 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 13
+        segments: 
+        - 1
+        - 6
+        - 1
         version: 1.6.1
   type: :runtime
   version_requirements: *id004
@@ -78,6 +102,7 @@ files:
 - LICENSE
 - README.md
 - bin/pt
+has_rdoc: true
 homepage: http://www.github.com/raul/pt
 licenses: []
 
@@ -91,17 +116,23 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
       version: "0"
 requirements: []
 
 rubyforge_project: pt
-rubygems_version: 1.8.8
+rubygems_version: 1.5.2
 signing_key: 
 specification_version: 3
 summary: Client to use Pivotal Tracker from the console.