ptt 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 177f45ed434f0c9445c126552d97f002dfee98e1
+  data.tar.gz: 76108946a21a1f3e7dd7382f4758c25eff072d1f
+SHA512:
+  metadata.gz: 350f9a6cab523e8db5debc0b68705870207a1f460f642278292f62b84566f6ec72e9cc402e0191f75a9bb71e422700c70f8faf44a45f0d5110c39705447866fc
+  data.tar.gz: 8fa115bfebd364f360e07dd0666801abfbae7ba318dbcf844df7a64e05e0d27bf85f05387921b694fdd24cc8d5cbc91ded5c94304ea27abfdf5c975f8356189f

data/Changelog.md

@@ -0,0 +1,119 @@
+# ptt changelog
+
+Upgrade to Pivotal Tracker API V5
+
+
+# pt changelog
+
+## v0.7.3
+
+Fix to `pt list` ( icetan )
+
+## v0.7.2
+
+Show task updates for attachments, labels, and a recent stories list
+
+## v0.7.1
+
+Fixes to pt show
+Updates to the help
+Fixed the -m option
+
+## v0.7.0
+
+Comment, Assign, Estimate, Start, Finish, Deliver, Accept all accept the num value in `pt` or a story id
+
+## v0.6.3 & v0.6.4
+
+Added the ability to see started by username ( good idea marcolz )
+
+## v0.6.2
+
+Added "-m" to create that will load the description in your editor ( good idea ahunt09 )
+
+## v0.6
+
+Added command pt started ( Matthijs Groen )
+Added command pt tasks ( Matthijs Groen )
+
+## v0.5.8
+
+Improved support for ruby 1.8 ( Paco Benavent )
+
+## v0.5.7
+
+Fixed `pt list [username]` ( stephencelis )
+
+## v0.5.6
+
+Added `pt list all` which shows tickets from all members of the project ( kylewest )
+
+## v0.5.5
+
+Show the id of tickes by default in tables, adds the url of the task to show and shows more information about attachments ( derwiki )
+
+## v0.5.4
+
+Fix to pt create, wherein skipping optional parameters wouldn't work as expected, or at all. ( aniccolai )
+
+## v0.5.3
+
+Added a command todo, that only shows unscheduled stories ( orta )
+
+## v0.5.2
+
+Made create agnostic of order for assignee / type, and use defaults of you / feature ( orta )
+Added query limit size to activity ( jonmountjoy )
+
+## v0.5.1
+
+Extra commands added, they can be accessed through 'pt help' ( orta )
+Fix for 1.9.3 not getting deprecation warnings
+
+## v0.4
+
+Added support for calling functions without going through the walkthroughs ( orta )
+
+## v0.3.9
+
+Attachments displayed in 'show' task, thanks Anthony Crumley!
+
+## v0.3.8
+
+Fix converting encodings, thanks Johan Andersson!
+
+## v0.3.7
+Fix and story's id in "show" command
+
+## v0.3.6
+Fix for ruby 1.9 strings, thanks David Ramirez for reporting!
+
+## v0.3.5
+New 'show' command largely based on craftycode's (Anthony Crumley) contribution
+
+## v0.3.4
+Improved charset support
+
+## v0.3.3
+Added SSL support
+
+## v0.3.2
+Fix in requests debugger
+
+## v0.3.1
+Dependencies versions added to gemspec
+
+## v0.3.0
+Added --debug option to see the interaction with PT's API
+
+## v0.2.2
+Fix: list of tasks to start
+
+## v0.2.1
+Error message when using pt from ~
+
+## v0.2
+Fix for ruby 1.8
+
+## v0.1
+First release

data/Gemfile

@@ -0,0 +1,6 @@
+source "http://rubygems.org"
+
+gemspec
+
+gem 'tracker_api', github: 'drselump14/tracker_api', branch: :develop
+

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Raul Murciano raul@murciano.net 
+
+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,87 @@
+# ptt (pivotal tracker terminal)
+
+Minimal client to use Pivotal Tracker API v5 from the command line (forked from pt
+
+
+## Setup
+
+    gem install ptt
+
+The first time you run it, `ptt` will ask you some data about your Pivotal Tracker account and your current project.
+
+## Usage
+
+Run `ptt` from the root folder of your project.
+
+```
+  ptt                                         # show all available tasks
+
+  ptt todo      <owner>                       # show all unscheduled tasks
+
+  ptt started   <owner>                       # show all started stories
+
+  ptt create    [title] <owner> <type> -m     # create a new task (and include descripttion ala git commit)
+
+  ptt show      [id]                          # shows detailed info about a task
+
+  ptt tasks     [id]                          # manage tasks of story
+
+  ptt open      [id]                          # open a task in the browser
+
+  ptt assign    [id] <owner>                  # assign owner
+
+  ptt comment   [id] [comment]                # add a comment
+
+  ptt label     [id] [label]                  # add a label
+
+  ptt estimate  [id] [0-3]                    # estimate a task in points scale
+
+  ptt start     [id]                          # mark a task as started
+
+  ptt finish    [id]                          # indicate you've finished a task
+
+  ptt deliver   [id]                          # indicate the task is delivered
+
+  ptt acceptt    [id]                          # mark a task as acceptted
+
+  ptt reject    [id] [reason]                 # mark a task as rejected, explaining why
+
+  ptt done      [id]  <0-3> <comment>         # lazy mans finish task, opens, assigns to you, estimates, finish & delivers
+
+  ptt find      [query]                       # looks in your tasks by title and presents it
+
+  ptt list      [owner]                       # list all tasks for another ptt user
+
+  ptt list      all                           # list all tasks for all users
+
+  ptt updates                                 # shows number recent activity from your current project
+
+  ptt recent                                  # shows stories you've recently shown or commented on with ptt
+
+  All commands can be run entirely without arguments for a wizard based UI. Otherwise [required] <opttional>.
+  Anything that takes an id will also take the num (index) from the ptt command.
+```
+
+## Problems?
+
+You can [open a new issue](https://github.com/raul/ptt/issues/new). It can be helpful to include a trace of the requests and responses you're getting from Pivotal Tracker: you can get it by adding the `--debug` parameter while invoking `ptt` (remember to remove all sensible data though).
+
+# Contributors
+- Slamet Kristanto (current maintainer of ptt)
+- [orta therox](http://orta.github.com) (Current maintainer of pt)
+- [Raul Murciano](http://raul.murciano.net) (Original author)
+- [Anthony Crumley](https://github.com/craftycode)
+- [Johan Andersson](http://johan.andersson.net)
+
+## Thanks to...
+- the contributors of pt
+- the [Pivotal Tracker](https://www.pivotaltracker.com) guys for making a planning tool that doesn't suck and has an API
+- forest for 'tracker-api' gem
+
+## License
+See the LICENSE file included in the distribution.
+
+## Copyright
+Copyright (C) 2017 Slamet Kristanto <cakmet14@gmail.com>.
+Copyright (C) 2013 Orta Therox <orta.therox@gmail.com>.
+Copyright (C) 2011 Raul Murciano <raul@murciano.net>.

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/bin/ptt

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+require 'pathname'
+
+lib = (Pathname.new(__FILE__).realpath.dirname  + '../lib').to_s
+$LOAD_PATH.unshift(lib) if File.directory?(lib) && !$LOAD_PATH.include?(lib)
+
+require 'ptt'
+
+PTT::UI.new ARGV

data/lib/ptt.rb

@@ -0,0 +1,12 @@
+require 'rubygems'
+
+module PTT
+  class InputError < StandardError; end
+  VERSION = '1.0.1'
+end
+
+require 'tracker_api'
+require 'ptt/client'
+require 'ptt/data_row'
+require 'ptt/data_table'
+require 'ptt/ui'

data/lib/ptt/client.rb

@@ -0,0 +1,153 @@
+require 'ptt/switch_ssl'
+require 'uri'
+
+class PTT::Client
+
+  STORY_FIELDS=':default,requested_by,owners,tasks,comments(:default,person,file_attachments)'
+
+
+  def self.get_api_token(email, password)
+    PivotalAPI::Me.retrieve(email, password)
+  rescue RestClient::Unauthorized
+    raise PTT::InputError.new("Bad email/password combination.")
+  end
+
+  def initialize(token)
+    @client = TrackerApi::Client.new(token: token) 
+    @project = nil
+  end
+
+  def get_project(project_id)
+    project = @client.project(project_id)
+    project
+  end
+
+  def get_projects
+    @client.projects
+  end
+
+  def get_membership(project, email)
+    PivotalTracker::Membership.all(project).select{ |m| m.email == email }.first
+  end
+
+  def get_my_info
+    @client.me
+  end
+
+  def get_current_iteration(project)
+    PivotalTracker::Iteration.current(project)
+  end
+
+  def get_activities(project, limit)
+    project.activity
+  end
+
+  def get_work(project)
+    project.stories(filter: 'state:unscheduled,unstarted,started', fields: STORY_FIELDS )
+  end
+
+  def get_my_work(project, user_name)
+    project.stories(filter: "owner:#{user_name} -state:accepted", limit: 50, fields: STORY_FIELDS)
+  end
+
+  def search_for_story(project, query)
+    project.stories(filter: query.to_s ,fields: STORY_FIELDS)
+  end
+
+  def get_task_by_id(project, id)
+    project.story(id, fields: STORY_FIELDS)
+  end
+  alias :get_story :get_task_by_id
+
+  def get_my_open_tasks(project, user_name)
+    project.stories filter: "owner:#{user_name}", fields: STORY_FIELDS
+  end
+
+  def get_my_tasks_to_estimate(project, user_name)
+    project.stories( filter: "owner:#{user_name} type:feature estimate:-1", fields: STORY_FIELDS)
+  end
+
+  def get_my_tasks_to_start(project, user_name)
+    tasks = project.stories filter: "owner:#{user_name} state:unscheduled,rejected,unstarted", limit: 50, fields: STORY_FIELDS
+    tasks.reject{ |t| (t.story_type == 'feature') && (t.estimate == -1) }
+  end
+
+  def get_my_tasks_to_finish(project, user_name)
+    project.stories filter: "owner:#{user_name} -state:finished,delivered,accepted,rejected", limit: 50, fields: STORY_FIELDS
+  end
+
+  def get_my_tasks_to_deliver(project, user_name)
+    project.stories filter: "owner:#{user_name} -state:delivered,accepted,rejected", limit: 50, fields: STORY_FIELDS
+  end
+
+  def get_my_tasks_to_accept(project, user_name)
+    project.stories filter: "owner:#{user_name} -state:accepted", limit: 50, fields: STORY_FIELDS
+  end
+
+  def get_my_tasks_to_reject(project, user_name)
+    project.stories filter: "owner:#{user_name} -state:rejected", limit: 50, fields: STORY_FIELDS
+  end
+
+  def get_tasks_to_assign(project)
+    project.stories filter: "-state:accepted", limit: 50
+  end
+
+  def get_all_stories(project, user_name)
+    project.stories limit: 50, fields: STORY_FIELDS
+  end
+
+
+  def get_member(project, query)
+    member = project.memberships.select{ |m| m.person.name.downcase.start_with?(query.downcase) || m.person.initials.downcase == query.downcase }
+    member.empty? ? nil : member.first
+  end
+
+  def find_member(project, query)
+    memberships = project.memberships.detect do |m| 
+      m.person.name.downcase.start_with?(query.downcase) || m.person.initials.downcase == query.downcase
+    end
+  end
+
+  def get_members(project)
+    project.memberships fields: ':default,person'
+  end
+
+
+  def mark_task_as(project, task, state)
+    task = get_story(project, task.id)
+    task.current_state = state
+    task.save
+  end
+
+  def estimate_task(project, task, points)
+    task = get_story(project, task.id)
+    task.estimate = points
+    task.save
+  end
+
+  def assign_task(project, task, owner)
+    task = get_story(project, task.id)
+    task.add_owner(owner)
+  end
+
+  def add_label(project, task, label)
+    task = get_story(project, task.id)
+    task.add_label(label)
+    task.save
+  end
+
+  def comment_task(project, task, comment)
+    task = get_story(project, task.id)
+    task.create_comment(text: comment)
+  end
+
+  def create_task(project, name, owner_ids, task_type)
+    project.create_story(:name => name, :story_type => task_type, owner_ids: owner_ids)
+  end
+
+  def create_task_with_description(project, name, owner, task_type, description)
+    project.create_story(:name => name, :story_type => task_type, :description => description)
+  end
+
+
+end

data/lib/ptt/data_row.rb

@@ -0,0 +1,28 @@
+require 'iconv' unless "older_ruby?".respond_to?(:force_encoding)
+
+class PTT::DataRow
+
+  attr_accessor :num, :record, :state
+
+  def initialize(orig, dataset)
+    @record = orig
+    @num = dataset.index(orig) + 1
+    if defined? orig.current_state
+      @state = orig.current_state
+    end
+  end
+
+  def method_missing(method)
+    str = @record.send(method).to_s
+    str.respond_to?(:force_encoding) ? str.force_encoding('utf-8') : Iconv.iconv('UTF-8', 'UTF-8', str)
+  end
+
+  def to_s
+    @record.send(self.to_s_attribute)
+  end
+
+  def to_s_attribute
+    @n.to_s
+  end
+
+end