scrumninja-git-cli 0.0.2

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Renewable Funding, LLC
+
+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.rdoc

@@ -0,0 +1,17 @@
+= scrumninja-git-cli
+
+A command-line interface to integrate the ScrumNinja (http://scrumninja.com) API with a git workflow.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2010 Renewable Funding, LLC. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,57 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "scrumninja-git-cli"
+    gem.summary = %Q{Workflow tools for git/ScrumNinja integration}
+    gem.description = %Q{A command-line interface to integrate the ScrumNinja (http://scrumninja.com) API with a git workflow.}
+    gem.email = "johnwilger@gmail.com"
+    gem.homepage = "http://github.com/jwilger/scrumninja-git-cli"
+    gem.authors = ["John Wilger", "Sam Livingston-Gray", "JD Huntington"]
+    gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
+    gem.add_development_dependency "mocha", "= 0.9.8"
+    gem.add_dependency "grit", "= 2.0.0"
+    gem.add_dependency "activesupport", "= 2.3.5"
+    gem.add_dependency "xml-simple", "= 1.0.12"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "scrumninja-git-cli #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.2

data/bin/scrumninja-git-cli

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require 'scrum_ninja_git_cli'
+ScrumNinjaGitCli.run_command(*ARGV)

data/lib/git_wrapper.rb

@@ -0,0 +1,164 @@
+require 'grit'
+require 'shell_cmd'
+
+module GitWrapper
+  module_function
+
+  class WorkingFolderDirtyException < Exception; end
+  class WrongBranchException < Exception; end
+  class OutOfDateGitException < Exception; end
+
+  def git
+    @git ||= Grit::Repo.new(locate_git_repo_root)
+  end
+
+  def locate_git_repo_root(start_dir = nil)
+    pwd = start_dir || ENV['PWD']
+    if Dir.new(pwd).entries.include?('.git')
+      pwd
+    else
+      parent = File.dirname(pwd)
+      return nil if parent == pwd
+      locate_git_repo_root(parent)
+    end
+  end
+
+  def current_branch_name
+    git.head.name
+  end
+
+  def is_git_current_enough?
+    (git_version <=> [1, 7]) != -1
+  end
+
+  def git_version
+    @git_version ||= run_git('--version').match(/^git version (.*)$/).captures.first.split('.').map(&:to_i)
+  end
+
+  def branches(remote_name = nil)
+    if remote_name
+      git.remotes.select { |e| e.name =~ Regexp.new("^#{remote_name}") }
+    else
+      git.branches
+    end
+  end
+
+  def local_branch_exists?(name)
+    git.branches.any? { |e| e.name == name }
+  end
+
+  def remote_branch_exists?(name, remote='origin')
+    branches(remote).any? { |b| b.name == "#{remote}/#{name}" }
+  end
+
+  def is_state_clean?
+    current_status = run_git 'status'
+    !!(current_status =~ /nothing to commit \(working directory clean\)/)
+  end
+
+  ##### Modification commands:  these just shell out to git (directly or indirectly) #####
+  def checkout(branch_name, remote='origin')
+    fetch(remote)
+    create_branch(branch_name) unless local_branch_exists?(branch_name)
+    publish_remote_branch(branch_name, remote) unless remote_branch_exists?(branch_name, remote)
+    track_remote_branch(branch_name, remote)
+    checkout_branch(branch_name, remote)
+  end
+
+  def fetch(remote='origin')
+    run_git "fetch #{remote}"
+  end
+
+  def create_branch(branch_name)
+    run_git "branch #{branch_name}".strip
+  end
+
+  def publish_remote_branch(branch_name, remote='origin')
+    run_git "push #{remote} #{branch_name}:refs/heads/#{branch_name}"
+  end
+
+  def track_remote_branch(branch_name, remote='origin')
+    # Note that this could also be written as:
+    #   run_git "config branch.#{branch_name}.remote #{remote}"
+    #   run_git "config branch.#{branch_name}.merge refs/heads/#{branch_name}"
+    # ...but that doesn't read nearly as well.  Just upgrade your damn git install already.
+    run_git "branch --set-upstream #{branch_name} #{remote}/#{branch_name}"
+  end
+
+  def checkout_branch(branch_name, remote='origin')
+    run_git "checkout #{branch_name}"
+  end
+
+  def merge_from_master
+    require_clean_story_branch
+    story_branch = current_branch_name
+    run_git 'checkout master'
+    run_git 'pull'
+    run_git "checkout #{story_branch}"
+    run_git 'merge master'
+  end
+
+  def push_master
+    require_clean_master_branch
+    run_git 'pull --rebase'
+    run_git "push origin master"
+  end
+
+  def push_branch
+    require_clean_story_branch
+    run_git 'pull --rebase'
+    run_git "push origin #{current_branch_name}"
+  end
+
+  def merge_branch_into_master(branch=nil)
+    if branch
+      require_clean_master_branch
+      branch_to_be_squashed = branch
+    else
+      require_clean_story_branch
+      branch_to_be_squashed = current_branch_name
+      run_git 'checkout master'
+    end
+    run_git 'pull'
+    run_git "merge #{branch_to_be_squashed}"
+  end
+
+  def require_clean_story_branch
+    raise WorkingFolderDirtyException.new unless is_state_clean?
+    raise WrongBranchException.new if 'master' == current_branch_name
+  end
+
+  def require_clean_master_branch
+    raise WorkingFolderDirtyException.new unless is_state_clean?
+    raise WrongBranchException.new unless 'master' == current_branch_name
+  end
+
+  def add(*args)
+    run_git "add #{args.join(" ")}"
+  end
+
+  def commit(default_message = "")
+    run_git "commit -m \"#{default_message}\" -e", true
+  end
+
+  def run_git(cmd, interactive=false)
+    puts "*" * 80
+    puts "* git #{cmd}"
+    puts "*" * 80
+    old_env = ENV['I_AM_A_GIT_GURU']
+    ENV['I_AM_A_GIT_GURU'] = '1'
+    if interactive
+      ShellCmd.run "git #{cmd}"
+    else
+      out = `git #{cmd}`
+      puts out
+      return out
+    end
+  ensure
+    ENV['I_AM_A_GIT_GURU'] = old_env
+  end
+
+  def string_hyphenize(str)
+    str.gsub(/[^A-Za-z ]/, '').gsub(/\s+/, '-').downcase
+  end
+end

data/lib/scrum_ninja.rb

@@ -0,0 +1,2 @@
+require 'active_support'
+Dir[File.dirname(__FILE__)+ '/scrum_ninja/*.rb'].each {|x| require x.sub(/\.rb$/,'') }

data/lib/scrum_ninja/server.rb

@@ -0,0 +1,34 @@
+require 'tempfile'
+
+module ScrumNinja
+  module Server
+    module_function
+
+    def get_stories(api_key, project_id)
+      get_page_contents "http://scrumninja.com/projects/#{project_id}/stories.xml?api_key=#{api_key}"
+    end
+
+    def get_story(api_key, project_id, story_id)
+      get_page_contents "http://scrumninja.com/projects/#{project_id}/stories/#{story_id}.xml?api_key=#{api_key}"
+    end
+
+
+    def update_story(api_key, project_id, story_id, xml)
+      url = "http://scrumninja.com/projects/#{project_id}/stories/#{story_id}.xml?api_key=#{api_key}"
+      # raise [story_id, url].inspect
+      post_xml(url, xml)
+    end
+
+
+    def get_page_contents(url)
+      `curl -s "#{url}"`
+    end
+
+    def post_xml(url, xml)
+      f = Tempfile.new('curl_hackery')
+      f << xml
+      f.close
+      `curl -s -H "Content-Type: application/xml; charset=utf-8" -X PUT -d @#{f.path} "#{url}"`
+    end
+  end
+end

data/lib/scrum_ninja/session.rb

@@ -0,0 +1,87 @@
+require 'xmlsimple'
+
+module ScrumNinja
+  class Session
+    attr_reader :api_key, :project_id, :user_id, :options
+
+    def initialize(opts={})
+      @options = opts_maybe_with_defaults_from_config_files(opts)
+
+      @api_key    = options[:api_key   ]
+      @project_id = options[:project_id]
+      @user_id    = options[:user_id   ]
+
+      raise ArgumentError.new("Your ScrumNinja API key could not be determined!") if @api_key.blank?
+    end
+
+    @read_config_from_filesystem = true
+    class << self
+      attr_accessor :read_config_from_filesystem
+    end
+
+    protected
+    def opts_maybe_with_defaults_from_config_files(opts)
+      opts = HashWithIndifferentAccess.new(opts)
+      return opts unless self.class.read_config_from_filesystem
+
+      search_dirs = [File.expand_path('~')]
+      search_dirs << opts[:project_dir] if opts[:project_dir].present?
+      opt_hashes = search_dirs.reverse.map { |dirname|
+        fname = File.join(dirname, '.scrumninja.yml')
+        YAML.load_file(fname)
+      }
+
+      return opt_hashes.inject(opts) { |mem, var| mem.reverse_merge(var) }
+    rescue Errno::ENOENT => e
+      opts
+    end
+    public
+
+    def get_stories
+      xml = Server.get_stories(api_key, project_id)
+      h = XmlSimple.xml_in(xml)
+      h['story'].map { |hh| story_from_xml_hash(hh) } #rescue raise h.inspect
+    end
+
+    def get_story_xml(story_id)
+      Server.get_story(api_key, project_id, story_id)
+    end
+
+    def get_story(story_id)
+      xml = get_story_xml(story_id)
+      h = XmlSimple.xml_in(xml)
+      story_from_xml_hash(h)
+    end
+
+    def story_from_xml_hash(h)
+      type = 'Story'
+      id   = h['id'].first['content'].to_i
+      owner_id = h['owner-user-id'].first['content'].to_i
+      name = h['name'].first
+      Story.new(type, id, name, owner_id)
+    end
+    protected :story_from_xml_hash
+
+    def update_ownership(story_id, new_owner_id = nil, opts={})
+      return if opts[:abort_if_already_owned] && get_story(story_id).has_owner?
+      new_owner_id ||= user_id
+      Server.update_story api_key, project_id, story_id, <<-XML
+        <story>
+          <owner-user-id type="integer">#{new_owner_id}</owner-user-id>
+        </story>
+      XML
+    end
+
+    def update_status(story_id, new_status)
+      allowed_statuses = ['in process', 'delivered', 'accepted', 'deployed']
+      unless allowed_statuses.include?(new_status)
+        raise ArgumentError.new("Allowed statuses are #{allowed_statuses.join(', ')}")
+      end
+      Server.update_story api_key, project_id, story_id, <<-XML
+        <story>
+          <status>#{new_status}</status>
+        </story>
+      XML
+    end
+  end
+end

data/lib/scrum_ninja/story.rb

@@ -0,0 +1,25 @@
+module ScrumNinja
+  Story = Struct.new(:type, :story_number, :name, :owner_id) do
+    def to_s
+      '%-5s %6d: %s' % [type, story_number, name]
+    end
+
+    def to_i
+      story_number.to_i
+    end
+
+    def has_owner?
+      @owner_id
+    end
+
+    def branch_name
+      [story_number, hyphenized_name] * '-'
+    end
+
+    def hyphenized_name
+      GitWrapper.string_hyphenize(name)
+    rescue
+      "indeterminate-branch-name-#{rand(100000000000)}"
+    end
+  end
+end