pivotal-cli 0.0.1

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+/.idea
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+/pmip

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Omar Skalli
+
+MIT License
+
+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,34 @@
+# Pivotal-cli
+
+Simple command line tool for working with pivotal stories.
+
+# Installing
+
+To install the gem:
+
+```bash
+gem install pivotal_cli
+```
+
+# Usage
+
+```
+NAME
+    pivotal - Pivotal Tracker CLI
+
+SYNOPSIS
+    pivotal_cli [global options] command [command options] [arguments...]
+
+VERSION
+    0.0.1
+
+GLOBAL OPTIONS
+    --help    - Show this message
+    --version - Display the program version
+
+COMMANDS
+    branch - Start a pivotal task, and create a branch for it
+    help   - Shows a list of commands or help for one command
+    list   - Display pivotal items assigned to you
+    setup  - Setup your pivotal account, by creating a config file in ~/.pivotal_cli
+```

data/bin/pivotal

@@ -0,0 +1,154 @@
+#!/usr/bin/env ruby
+require 'gli'
+require 'rainbow'
+require 'pivotal_cli'
+require 'highline/import'
+
+# Application high level settings
+
+include GLI::App
+program_desc 'Pivotal Tracker CLI'
+version PivotalCli::VERSION
+
+# Shared re-usable actions
+
+def setup_config
+  username   = ask("What's your full name? ")
+  project_id = ask("Project Id? ", Integer)
+  token      = ask("API Token? (Available at https://www.pivotaltracker.com/profile) ") {|q| q.validate = /\A[A-Za-z0-9]{32}\z/ }
+
+  @tracker.setup(username, project_id, token)
+  puts Rainbow("Configuration has been saved to `#{@tracker.config_file}`.").yellow
+end
+
+def ensure_setup_complete
+  unless @tracker.setup_complete?
+    puts Rainbow("Missing configuration file `#{@tracker.config_file}`. Let's get you setup.").yellow
+    setup_config
+  end
+  @tracker.load_configuration
+end
+
+def formatted_story(story, index = nil)
+  estimate = (1..8).map { |i| i <= story.estimate.to_i ? '*' : ' ' }.join
+
+  output =  '  '
+  output << "#{index.to_s.rjust(2)}: " unless index.nil?
+  output << Rainbow("#{story.id} ").yellow
+  output << Rainbow("#{story.current_state.rjust(11)} [#{estimate}] ").blue
+  output << story.name
+  output
+end
+
+# CLI entry points
+
+desc 'Display pivotal items assigned to you'
+command :list do |c|
+  c.action do |global_options,options,args|
+    ensure_setup_complete
+    stories = @tracker.my_stories
+    puts Rainbow("\n  You have #{stories.length} stories assigned to you.\n").green
+
+    stories.each_with_index do |story, index|
+      puts formatted_story(story)
+    end
+  end
+end
+
+desc 'Start a pivotal task, and create a branch for it'
+arg_name '<branchname> [task id]'
+command :branch do |c|
+  c.action do |global_options,options,args|
+    ensure_setup_complete
+    if args.length < 1
+      puts Rainbow("\n  Please specify a branch name to create.\n").red
+      next
+    end
+
+    stories = @tracker.my_stories
+    branch_name = args[0]
+    task_id     = args[1].to_i
+    story       = task_id && stories.find { |story| story.id == task_id }
+    new_story   = PivotalTracker::Story.new(name: '<Create a new story>', id: '????????', current_state: '', estimate: -1)
+
+    # Ask the user to select a task from the menu
+    if story.nil?
+      puts Rainbow("\n  You have #{stories.length} stories assigned to you.\n").green
+
+      # Create a dummy new story
+      stories << new_story
+      stories.each_with_index do |story, index|
+        puts formatted_story(story, index + 1)
+      end
+
+      question   = Rainbow("\nWhich of the #{stories.length} stories are you starting? ").green
+      task_index = ask(question, Integer) { |q| q.in = 1..(stories.length) }
+      story = stories[task_index - 1]
+    end
+
+    # Create the new story on the fly
+    if story == new_story
+      story_name = ask(Rainbow('Story name? ').green)
+      story_description = ask(Rainbow('Story description? ').green)
+      story = @tracker.create_story(story_name, story_description)
+      if story.errors && story.errors.count > 0
+        puts Rainbow("Whoops, something went wrong when creating the story:").red
+        story.errors.each do |error|
+          puts "  * #{error}"
+        end
+        next
+      end
+    end
+
+    # Make sure feature is estimated (can't start otherwise)
+    if story.estimate < 0
+      question   = Rainbow("How many points in the story (0-8)? ").green
+      points = ask(question, Integer) { |q| q.in = 0..8 }
+      @tracker.set_points(story, points)
+    end
+
+    # Checkout branch
+    branch_name = "pv-#{story.id}-#{branch_name}"
+    command = "git checkout -b #{branch_name}"
+    puts "Executing: #{command}"
+    success = system(command)
+
+    # Update status
+    if success
+       @tracker.start(story)
+       puts Rainbow("Set story #{story.id} as 'Started'\n").green
+    else
+      puts Rainbow("^ Whoops, something went wrong...").red
+    end
+  end
+end
+
+desc 'Setup your pivotal account, by creating a config file in ~/.pivotal_cli'
+command :setup do |c|
+  c.action do |global_options,options,args|
+
+    if @tracker.setup_complete?
+      puts Rainbow("Looks like you already have an existing `#{@tracker.config_file}` config file.").yellow
+      answer = ask('Overwrite file? [y, n]') { |q| q.in = ['y', 'n']; q.default = 'n' }
+      next if answer == 'n'
+    end
+
+    # Required information for the API
+    setup_config
+  end
+end
+
+pre do |global,command,options,args|
+  @tracker = PivotalCli::Tracker.new
+  true
+end
+
+post do |global,command,options,args|
+  puts ""
+end
+
+on_error do |exception|
+  true
+end
+
+exit run(ARGV)

data/lib/pivotal_cli/tracker.rb

@@ -0,0 +1,59 @@
+require 'pivotal-tracker'
+
+module PivotalCli
+  class Tracker
+    attr_accessor :project, :username
+
+    def config_file
+      @config_file ||= "#{ENV['HOME']}/.pivotal"
+    end
+
+    def setup_complete?
+      File.exists?(config_file)
+    end
+
+    def setup(username, project_id, token)
+      username = username.strip
+      File.open(config_file, 'w') do |file|
+        file.puts(username)
+        file.puts(project_id)
+        file.puts(token)
+      end
+    end
+
+    def my_stories
+      @project.stories.all(owned_by: username).reject { |s| s.current_state =~ /accepted/ }
+    end
+
+    def create_story(name, description)
+      attributes = {
+          story_type: 'feature',
+          name: name,
+          description: description,
+          owned_by: username
+      }
+      @project.stories.create(attributes)
+    end
+
+    def set_points(story, points)
+      story.update(estimate: points)
+    end
+
+    def start(story)
+      story.update(current_state: 'started')
+    end
+
+    def load_configuration
+      File.open(config_file, 'r') do |file|
+        lines = file.readlines
+        @username  = lines[0].strip
+        token      = lines[2].strip
+        project_id = lines[1].strip
+
+        PivotalTracker::Client.token = token
+        PivotalTracker::Client.use_ssl = true
+        @project = PivotalTracker::Project.find(project_id)
+      end
+    end
+  end
+end

data/lib/pivotal_cli/version.rb

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

data/lib/pivotal_cli.rb

@@ -0,0 +1,2 @@
+require 'pivotal_cli/version.rb'
+require 'pivotal_cli/tracker.rb'

data/pivotal_cli.gemspec

@@ -0,0 +1,20 @@
+# Ensure we require the local version and not one we might have installed already
+require File.join([File.dirname(__FILE__),'lib','pivotal_cli','version.rb'])
+spec = Gem::Specification.new do |s| 
+  s.name = 'pivotal-cli'
+  s.version = PivotalCli::VERSION
+  s.author = 'Omar Skalli'
+  s.email = 'chetane@gmail.com'
+  s.platform = Gem::Platform::RUBY
+  s.summary = 'Simple command line tool for working with Pivotal Stories'
+  s.homepage = 'https://github.com/chetane/pivotal-cli'
+  s.license = 'MIT'
+  s.files = `git ls-files`.split($/)
+  s.require_paths << 'lib'
+  s.bindir = 'bin'
+  s.executables << 'pivotal'
+  s.add_runtime_dependency('gli','2.11.0')
+  s.add_runtime_dependency('rainbow', '2.0.0')
+  s.add_runtime_dependency('highline','1.6.21')
+  s.add_runtime_dependency('pivotal-tracker', '0.5.12')
+end

metadata

@@ -0,0 +1,120 @@
+--- !ruby/object:Gem::Specification
+name: pivotal-cli
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Omar Skalli
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-07-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gli
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.11.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.11.0
+- !ruby/object:Gem::Dependency
+  name: rainbow
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.6.21
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.6.21
+- !ruby/object:Gem::Dependency
+  name: pivotal-tracker
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.5.12
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.5.12
+description: 
+email: chetane@gmail.com
+executables:
+- pivotal
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- bin/pivotal
+- lib/pivotal_cli.rb
+- lib/pivotal_cli/tracker.rb
+- lib/pivotal_cli/version.rb
+- pivotal_cli.gemspec
+homepage: https://github.com/chetane/pivotal-cli
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Simple command line tool for working with Pivotal Stories
+test_files: []