ki_pivotal 0.0.1

data/.gitignore

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

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ki_pivotal.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Ben Brinckerhoff
+
+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,2 @@
+ki_pivotal
+==========

data/Rakefile

@@ -0,0 +1,23 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+desc 'Default: run specs.'
+task :default => :spec
+
+desc "Run specs"
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = "./spec/**/*_spec.rb"
+end
+
+desc "Generate code coverage"
+RSpec::Core::RakeTask.new("spec:coverage") do |t|
+  ENV['COVERAGE'] = "true"
+end
+
+desc "Delete *all* VCR cassettes (!)"
+namespace :spec do
+  task :vcr_wipe do
+    FileUtils.rm_rf('spec/fixtures/vcr_cassettes')
+  end
+end

data/bin/ki_pivotal

@@ -0,0 +1,69 @@
+#!/usr/bin/env ruby
+# 1.9 adds realpath to resolve symlinks; 1.8 doesn't
+# have this method, so we add it so we get resolved symlinks
+# and compatibility
+unless File.respond_to? :realpath
+  class File #:nodoc:
+    def self.realpath path
+      return realpath(File.readlink(path)) if symlink?(path)
+      path
+    end
+  end
+end
+
+$LOAD_PATH << File.expand_path(File.dirname(File.realpath(__FILE__)) + '/../lib')
+
+require 'rubygems'
+require 'gli'
+require 'ki_pivotal'
+require 'colored'
+include GLI
+
+program_desc 'A command-line interface for Pivotal Tracker'
+
+version KiPivotal::VERSION
+
+desc 'Setup'
+command :setup do |c|
+  c.action do |global_options,options,args|
+    print "Enter API key> "
+    token = $stdin.gets.chomp
+    Kiseru::Config[:ki_pivotal].write('api_token', token)
+  end
+end
+
+desc 'Get projects'
+command :projects do |c|
+  c.action do |global_options,options,args|
+    pretty = $stdout.tty?
+    $stdout.puts KiPivotal::Api.projects(:pretty => pretty)
+  end
+end
+
+desc 'Create a bug'
+command :story do |c|
+  c.flag [:project]
+  c.flag [:f, :file]
+  c.action do |global_options,options,args|
+
+    unless project_id = options[:project]
+      projects = KiPivotal::Api.projects
+
+      $stderr.puts "\n  Project ID must be specified with --project=<ID>"
+      $stderr.puts "\n  Available projects:"
+
+      MultiJson.load(projects).each { |project| $stderr.puts "    #{project['id']}".green + " #{project['name']}" }
+
+      $stderr.puts
+      raise "No project ID given"
+    end
+
+    if options[:f]
+      story_json = File.read(options[:f])
+    end
+    story_json ||= $stdin.read
+    $stdout.puts KiPivotal::Api.create_story(project_id, story_json)
+  end
+end
+
+exit GLI.run(ARGV)

data/ki_pivotal.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/ki_pivotal/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Ben Brinckerhoff", "Aaron Cronin"]
+  gem.email         = ["ben@freeagent.com", "aaron@freeagent.com"]
+  gem.description   = %q{Kiseru Pivotal Tracker client}
+  gem.summary       = %q{Kiseru Pivotal Tracker client}
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "ki_pivotal"
+  gem.require_paths = ["lib"]
+  gem.version       = KiPivotal::VERSION
+
+  gem.add_dependency 'gli'
+  gem.add_dependency 'multi_json'
+  gem.add_dependency 'pivotal-tracker'
+  gem.add_dependency 'colored'
+
+  gem.add_development_dependency('debugger')
+  gem.add_development_dependency('rake')
+  gem.add_development_dependency('simplecov')
+  gem.add_development_dependency('rspec')
+  gem.add_development_dependency('test-construct')
+  gem.add_development_dependency('vcr')
+  gem.add_development_dependency('webmock')
+end

data/lib/ki_pivotal/api.rb

@@ -0,0 +1,82 @@
+module KiPivotal
+
+  class Api
+
+    # TODO - this is only used internally, unlike the other methods
+    # It also doesn't return JSON because it is used internally
+    def self.get_token(username, password)
+      PivotalTracker::Client.token(username, password)
+    end
+
+    def self.projects(opts = {})
+      with_session do
+        pretty = opts.fetch(:pretty) { true }
+
+        projects = PivotalTracker::Project.all
+        data = []
+        projects.each do |project|
+          data <<
+            {
+            'id' => project.id,
+            'name' => project.name
+          }
+        end
+        MultiJson.dump(data, :pretty => pretty)
+      end
+    end
+
+    def self.create_story(project_id, json)
+      from_and_to_json(json, true) do |data|
+        with_session do
+          data.delete('ki_type')
+
+          # You must provide current_state or the Pivotal UI will give an error
+          defaults = {
+            :current_state => 'unscheduled'
+          }
+
+          new_story = add_story_to_project(project_id, defaults.merge(data))
+          new_story
+        end
+      end
+    end
+
+    private
+
+    # TODO - We need to determine what concerns the API has vs
+    # 'lower-level' classes. Right now it's all mixed in. At least we
+    # have smallish methods
+    # Possible different responsibilities:
+    # * change JSON to data
+    # * set up session
+    # * clean up incoming data (remove fields that don't make sense)
+    # * interact with PivotalTracker gem
+    # * convert PivotalTracker gem response (object) into data
+    # * convert data back into JSON
+    def self.add_story_to_project(project_id, data)
+      project = PivotalTracker::Project.find(project_id)
+      story = project.stories.create(data)
+
+      created_story = {}
+      story.instance_variables.each do |instance_var|
+        string_name = instance_var.to_s.gsub('@','')
+        created_story[string_name] = story.instance_variable_get(instance_var)
+      end
+      created_story
+    end
+
+    def self.from_and_to_json(json, pretty=false)
+      data = MultiJson.load(json)
+      new_data = yield data
+      MultiJson.dump(new_data, :pretty => pretty)
+    end
+
+    def self.with_session
+      session = Session.new(Kiseru::Config[:ki_pivotal])
+      session.init
+      yield
+    end
+
+  end
+
+end

data/lib/ki_pivotal/kiseru.rb

@@ -0,0 +1,48 @@
+module Kiseru
+
+  class ConfigDir
+
+    DIR_NAME = '.kiseru'
+
+    attr_reader :path
+
+    def initialize(opts = {})
+      root = Pathname.new(File.expand_path(opts.fetch(:root) { '~' }))
+      @path = root + DIR_NAME
+      unless File.directory?(@path)
+        Dir.mkdir(@path)
+      end
+    end
+
+    def config(app_name)
+      Config.new(@path, app_name)
+    end
+
+  end
+
+  class Config
+
+    def self.[](key)
+      ConfigDir.new.config(key)
+    end
+
+    def initialize(root_path, app_name)
+      file_path = (root_path + "#{app_name}.yml").to_s
+      @store = YAML::Store.new(file_path)
+    end
+
+    def write(key, time)
+      @store.transaction do
+        @store[key] = time
+      end
+    end
+
+    def read(key)
+      @store.transaction(read_only=true) do
+        @store[key]
+      end
+    end
+
+  end
+
+end

data/lib/ki_pivotal/session.rb

@@ -0,0 +1,16 @@
+module KiPivotal
+
+  class Session
+
+    def initialize(config)
+      @config = config
+    end
+
+    def init
+      PivotalTracker::Client.token = @config.read('api_token')
+    end
+
+  end
+
+
+end

data/lib/ki_pivotal/version.rb

@@ -0,0 +1,3 @@
+module KiPivotal
+  VERSION = "0.0.1"
+end

data/lib/ki_pivotal.rb

@@ -0,0 +1,14 @@
+require 'yaml/store'
+require 'pivotal-tracker'
+require 'multi_json'
+
+require "ki_pivotal/version"
+
+autoload :Kiseru, 'ki_pivotal/kiseru'
+
+module KiPivotal
+
+  autoload :Api, 'ki_pivotal/api'
+  autoload :Session, 'ki_pivotal/session'
+
+end

data/spec/integration/api_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+
+include KiPivotal
+
+describe KiPivotal::Api do
+
+  it "returns projects", :vcr do
+    json = Api.projects
+    projects = MultiJson.load(json)
+
+    projects.each do |project|
+      project['id'].should_not be_nil
+      project['name'].should_not be_nil
+    end
+  end
+
+  it "creates bugs", :vcr do
+    # uses open-source kiseru tracker project
+    name = "Something is broken"
+
+    input_json = MultiJson.dump({ 'ki_type' => 'pivotal_story',
+                                  'name' => name,
+                                  'requested_by' => 'Kiseru',
+                                  'story_type'   => 'bug'
+                                })
+    json = Api.create_story(617613, input_json)
+    story = MultiJson.load(json)
+
+    story['id'].should_not be_nil
+    story['name'].should == name
+    story['story_type'].should == 'bug'
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,42 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+
+require 'ki_pivotal'
+require 'construct'
+require 'pp'
+require 'vcr'
+
+include Construct::Helpers
+
+if [0, 'false', false, 'f', 'n', 'no', 'off'].include?(ENV['VCR'])
+  puts "VCR off"
+else
+  puts "VCR on!"
+  VCR.configure do |c|
+    c.cassette_library_dir = 'spec/fixtures/vcr_cassettes'
+    c.hook_into :webmock
+    c.allow_http_connections_when_no_cassette = true
+    c.configure_rspec_metadata!
+  end
+end
+
+if ENV['COVERAGE']
+  require 'simplecov'
+  SimpleCov.start
+end
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end

data/spec/unit/kiseru_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+include KiPivotal
+
+describe Kiseru::ConfigDir do
+
+  context "when directory does not exist" do
+
+    it "should create directory" do
+      within_construct(false) do |c|
+        Kiseru::ConfigDir.new(:root => c)
+        File.directory?(c+'.kiseru').should be_true
+      end
+    end
+
+  end
+
+  it "creates ki_pivotal.yml and writes API token" do
+    within_construct(false) do |c|
+      d = c.directory '.kiseru'
+      config_dir = Kiseru::ConfigDir.new(:root => c)
+      config = config_dir.config(:ki_pivotal)
+
+      config.write(:api_token, 'fake_token')
+
+      config.read(:api_token).should == 'fake_token'
+    end
+  end
+
+end

metadata

@@ -0,0 +1,194 @@
+--- !ruby/object:Gem::Specification
+name: ki_pivotal
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Ben Brinckerhoff
+- Aaron Cronin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-08-14 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gli
+  requirement: &70342954522960 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70342954522960
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: &70342954521720 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70342954521720
+- !ruby/object:Gem::Dependency
+  name: pivotal-tracker
+  requirement: &70342954520800 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70342954520800
+- !ruby/object:Gem::Dependency
+  name: colored
+  requirement: &70342954519680 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70342954519680
+- !ruby/object:Gem::Dependency
+  name: debugger
+  requirement: &70342954518840 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70342954518840
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70342954517660 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70342954517660
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: &70342954516980 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70342954516980
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70342954516480 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70342954516480
+- !ruby/object:Gem::Dependency
+  name: test-construct
+  requirement: &70342954515800 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70342954515800
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: &70342954515260 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70342954515260
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: &70342954514660 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70342954514660
+description: Kiseru Pivotal Tracker client
+email:
+- ben@freeagent.com
+- aaron@freeagent.com
+executables:
+- ki_pivotal
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/ki_pivotal
+- ki_pivotal.gemspec
+- lib/ki_pivotal.rb
+- lib/ki_pivotal/api.rb
+- lib/ki_pivotal/kiseru.rb
+- lib/ki_pivotal/session.rb
+- lib/ki_pivotal/version.rb
+- spec/integration/api_spec.rb
+- spec/spec_helper.rb
+- spec/unit/kiseru_spec.rb
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -2523248348125131754
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -2523248348125131754
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Kiseru Pivotal Tracker client
+test_files:
+- spec/integration/api_spec.rb
+- spec/spec_helper.rb
+- spec/unit/kiseru_spec.rb