pttool 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3bf5a304fdae3f4e070674b98371db20a4729107
-  data.tar.gz: a218731a02d3ca720b8483f2e60d2692d69d965a
+  metadata.gz: 289e2e3641c45a7859cc2080d6fde2db0efca87c
+  data.tar.gz: 89658f299963cd8563c7a354b8defe33a9fbda26
 SHA512:
-  metadata.gz: f0ea3cf189c58660d8ce3572ddc1e8f785fbaaeca6f92da046db9ff275ef746d7086ef6eef8569e37eb99f54f9734e0d5c0acd4dba4ec77b1a87c13cb1870c98
-  data.tar.gz: 096cf82fd99f7984e8f430af67c83f48337cb2f9a9c739fb9b88ec2b02d6652390d3ca980b36342c2eaad1cb352a8904c4010004c2fd750dd0e6574c2aada352
+  metadata.gz: 044a16ccb34b76bd1145ba1d2b7068012b66526921b67f4060b75b9dd5875ce4b6975abcb341f01ebf08f809c2b6489b7703403af41b3b975a6db534a23c045c
+  data.tar.gz: d7cc566a1cb5248990c115dab0f017f2f2722e7dd72990f74b1926ea6e1daec8b979b536c4762f2f4428197891049a585d41da82065e2270410b245e6023f9e2

data/README.md

@@ -9,6 +9,11 @@
 
 ### List of PT Projects
 
+In order to use this tool, the environment variable `PT_TOKEN` must be set to
+your PivotalTracker API key. The key is listed under the "API TOKEN" section at
+the bottom of your PivotalTracker
+[profile](https://www.pivotaltracker.com/profile)."
+
     pttool projects
 
 ### Other

data/lib/pttool/application.rb

@@ -10,54 +10,68 @@ module PTTool
     pttool: A tool that interfaces with pivotal tracker.
 
     Usage:
-      pttool projects [--sort=<key>] [--members]
-      pttool sync PROJECT... [--force]
+      pttool projects [--sort=<key>] [--num_members]
+      pttool sync PROJECT... [--force] [--dryrun]
       pttool -h | --help
       pttool --version
 
     Options:
-      --force       Do not prompt for confirmation [default: false].
-      --members     Output the number of members [default: false].
-      --sort=<key>  Sort output by name or id [default: name].
-      -h --help     Show this information.
-      --version     Show the pttool version (#{VERSION}).
+      --dryrun       Do a dry run of the sync, printing out end result
+                     [default: false].
+      --force        Do not prompt for confirmation [default: false].
+      --num_members  Output the number of members for each project
+                     [default: false].
+      --sort=<key>   Sort output by name or id [default: name].
+      -h --help      Show this information.
+      --version      Show the pttool version (#{VERSION}).
     DOC
 
     def initialize
       @exit_status = 0
     end
 
-    def cmd_projects(members, sort)
+    def cmd_projects(num_members, sort)
       valid = %w(name id)
       raise Docopt::Exit, 'invalid sort option' unless valid.include?(sort)
       PTTool.client.projects.sort_by { |k| k.send(sort) }.each do |project|
-        member_extra = " (#{project.memberships.size} members)" if members
+        member_extra = " (#{project.memberships.size} members)" if num_members
         puts format("%8s: #{project.name}#{member_extra}", project.id)
       end
     end
 
-    def cmd_sync(projects, force)
-      raise Docopt::Exit, 'must list at least two projects' if projects.size < 2
+    def cmd_sync(projects, dryrun, force)
+      if projects.size < 2
+        raise Docopt::Exit, 'must list at least two projects'
+      end
 
       require 'set'
-      all_people_ids = Set.new
+      all_people = Set.new
       by_project = {}
 
       PTTool.client.projects.each do |project|
         next unless projects.include?(project.name)
         projects.delete(project.name)
-
-        all_people_ids.merge(
-          # tracker_api doesn't properly compare People objects so we'll only
-          # use their id (for now)
-          by_project[project] = project.memberships.map(&:person).map(&:id))
+        all_people.merge(
+          by_project[project] = project.memberships.map(&:person))
       end
 
       puts "Could not match: #{projects.join(', ')}" unless projects.empty?
       raise Error, 'too few matching projects' if by_project.size < 2
 
-      by_project.each do |project, people_ids|
-        to_add = all_people_ids - people_ids
+      if dryrun
+        puts "\nThe following would become members on all projects:"
+        all_people.sort_by(&:name).each { |person| display_person(person) }
+
+        by_project.each do |project, people|
+          next unless new = all_people - people
+          puts "\nNew members for #{project.name}:"
+          new.sort_by(&:name).each { |person| display_person(person) }
+        end
+        return
+      end
+
+      by_project.each do |project, people|
+        to_add = all_people - people
         next if to_add.empty? || (!force && !Helper.prompt(
           "Do you want to add #{to_add.size} people to #{project.name}?"))
         to_add.each { |person_id| Helper.add_membership(project, person_id) }
@@ -74,6 +88,10 @@ module PTTool
 
     private
 
+    def display_person(person)
+      puts person.email ? "#{person.name} (#{person.email})" : person.name
+    end
+
     def exit_with_status(msg, condition = true)
       puts msg
       @exit_status == 0 && condition ? 1 : @exit_status
@@ -81,9 +99,9 @@ module PTTool
 
     def handle_args(options)
       if options['projects']
-        cmd_projects(options['--members'], options['--sort'])
+        cmd_projects(options['--num_members'], options['--sort'])
       elsif options['sync']
-        cmd_sync(options['PROJECT'], options['--force'])
+        cmd_sync(options['PROJECT'], options['--dryrun'], options['--force'])
       else
         commands = options.find_all { |x| x[1] == true }.map { |x| x[0] }
         puts "Unhandled command(s): #{commands}"

data/lib/pttool/helper.rb

@@ -11,9 +11,7 @@ module PTTool
     end
 
     def self.add_membership(project, person_id, role = 'member')
-      data = PTTool.client.post("/projects/#{project.id}/memberships",
-                                params: { person_id: person_id, role: role })
-      puts data.body
+      project.add_membership(person_id: person_id, role: role)
     end
   end
 end

data/lib/pttool/version.rb

@@ -1,4 +1,4 @@
 # PTTool
 module PTTool
-  VERSION = '0.0.2'
+  VERSION = '0.0.3'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pttool
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Bryce Boe
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-04-11 00:00:00.000000000 Z
+date: 2015-12-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: docopt
@@ -75,8 +75,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.5.1
 signing_key: 
 specification_version: 4
-summary: Command line tool that interfaces with pivotaltracker
+summary: Command line tool that interfaces with pivotaltracker.
 test_files: []