hipe-githelper 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+.DS_Store
+coverage
+wtfami
+tmp.*
+pkg

data/History.txt

@@ -0,0 +1,8 @@
+== 0.0.1 / 2009-12-02
+* now depends on gorilla-grammar gem, more robust parsing
+* different, simplified syntax
+* 100% C1 testing code coverage w/ rcov
+* tried several differnent automated testing platforms. settled on bacon
+
+== 0.0.0 / 2009-11-??
+* standalone version, no dependencies.  hackish parser

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Mark Meves
+
+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,20 @@
+= hipe-githelper
+
+little convenience methods for git
+
+== 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. -- Use rcov if you can!
+* 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.
+
+== Thank You's
+* to rue for being the yoda to my luke, teaching me the force of metaprogramming by letting me find it.
+
+== Copyright
+
+Copyright (c) 2009 Mark Meves. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,68 @@
+require 'rubygems'
+require 'rake'
+require 'rcov/rcovtask'
+
+Rcov::RcovTask.new do |t|
+  t.test_files = FileList['test/*_test.rb']
+  t.verbose = true     # uncomment to see the executed command
+  t.rcov_opts = ['--exclude', 'test,/Library/Ruby/Gems/1.8/gems']
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "hipe-githelper"
+    gem.summary = %Q{little convenience methods for git}
+    gem.description = %Q{command-line convenience methods for git}
+    gem.email = "mark dot meves at gmail dot com"
+    gem.homepage = "http://github.com/hipe/hipe-githelper"
+    gem.authors = ["Mark Meves"]
+    gem.add_development_dependency "bacon", ">= 1.1.0"
+    gem.add_dependency "hipe-gorillagrammar", ">= 0.0.1"
+    #gem.add_development_dependency "rspec", ">= 1.2.9"
+    # gem.add_development_dependency "yard", ">= 0"
+    # gem.add_development_dependency "cucumber", ">= 0"
+    # 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 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+#Spec::Rake::SpecTask.new(:rcov) do |spec|
+#  spec.libs << 'lib' << 'spec'
+#  spec.pattern = 'spec/**/*_spec.rb'
+#  spec.rcov = true
+#end
+#
+task :spec => :check_dependencies
+
+begin
+  require 'cucumber/rake/task'
+  Cucumber::Rake::Task.new(:features)
+
+  task :features => :check_dependencies
+rescue LoadError
+  task :features do
+    abort "Cucumber is not available. In order to run features, you must: sudo gem install cucumber"
+  end
+end
+
+task :default => :spec
+
+begin
+  require 'yard'
+  YARD::Rake::YardocTask.new
+rescue LoadError
+  task :yardoc do
+    abort "YARD is not available. In order to run yardoc, you must: sudo gem install yard"
+  end
+end
+
+Dir['tasks/*.rake'].each{|f| import(f) }

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/bin/githelper

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+begin
+  require 'hipe-githelper'
+rescue LoadError
+  require 'rubygems'
+  require 'hipe-githelper'
+end
+Hipe::GitHelper.new.run

data/example1.git.status

@@ -0,0 +1 @@
+this is a bad git status string for the purpose of testing

data/hipe-githelper.gemspec

@@ -0,0 +1,69 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{hipe-githelper}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Mark Meves"]
+  s.date = %q{2009-12-02}
+  s.default_executable = %q{githelper}
+  s.description = %q{command-line convenience methods for git}
+  s.email = %q{mark dot meves at gmail dot com}
+  s.executables = ["githelper"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".gitignore",
+     "History.txt",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "bin/githelper",
+     "example1.git.status",
+     "hipe-githelper.gemspec",
+     "lib/hipe-githelper.rb",
+     "tasks/bacon.rake_",
+     "test/argv.rb",
+     "test/bacon_test.rb",
+     "test/example1.git.status",
+     "test/other_testing_frameworks/coulda.all_test_.rb",
+     "test/other_testing_frameworks/riot.all_test_.rb",
+     "test/other_testing_frameworks/teststrap.rb"
+  ]
+  s.homepage = %q{http://github.com/hipe/hipe-githelper}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{little convenience methods for git}
+  s.test_files = [
+    "test/argv.rb",
+     "test/bacon_test.rb",
+     "test/other_testing_frameworks/coulda.all_test_.rb",
+     "test/other_testing_frameworks/riot.all_test_.rb",
+     "test/other_testing_frameworks/teststrap.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<bacon>, [">= 1.1.0"])
+      s.add_runtime_dependency(%q<hipe-gorillagrammar>, [">= 0.0.1"])
+    else
+      s.add_dependency(%q<bacon>, [">= 1.1.0"])
+      s.add_dependency(%q<hipe-gorillagrammar>, [">= 0.0.1"])
+    end
+  else
+    s.add_dependency(%q<bacon>, [">= 1.1.0"])
+    s.add_dependency(%q<hipe-gorillagrammar>, [">= 0.0.1"])
+  end
+end
+

data/lib/hipe-githelper.rb

@@ -0,0 +1,307 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'hipe-gorillagrammar'
+require 'hipe-gorillagrammar/extensions/syntax'
+
+
+# This puppy is intended to be a standalone command line script written in ruby
+# with useful features that are not out-of-the-box available for git -- Features like
+# "add all files that haven't been added yet" or "add all files that have been modified"
+# or "do an equivalent of svn-info.".  If you use this a lot, it is recommended that you do something like 
+#   "alias gh='githelper' in your ~/.bash_profile"
+#
+# For example:
+#   githelper info
+#   githelper add modified and add untracked and delete deleted as dry run
+#   githelper add both and delete deleted as dry run
+#   githelper help
+# 
+#  Just for fun, the syntax of this command line tool is kind of strange in two ways:
+#
+#  1) instead of --options-like="this" or options like -abc, we just type them inline with the commands
+#   so for example, we don't say "githelper add modified --dry-run" ,
+#   we say "githelper add modified as dry run"
+#  
+#  2) the options can appear before or after the "verb phrase", so in addition to the above we could also say
+#           "githelper as dry run add modified"
+#
+#
+#  Wishlist: required verb modifiers.  utilize ruby 1.9 stuff
+                        
+
+module Hipe
+  
+  class GitHelper
+
+    class BufferString < String # there was StringIO but i couldn't figure out how to use it
+      def read
+        output = self.dup
+        self.replace('')
+        output
+      end
+      def puts mixed
+        if mixed.kind_of? Array
+          mixed.each{|x| puts x}
+        else
+          self << mixed
+          self << "\n" if (mixed.kind_of? String and mixed.length > 0 and mixed[mixed.size-1] != "\n"[0])
+        end
+      end
+      public :puts
+    end
+
+    class Command
+      def initialize name, desc, ast
+        @name, @desc, @ast = name, desc, ast
+      end
+      def syntax; @symbol.syntax; end
+      def help_short opts
+        buffer = opts[:buffer] || ''
+        col1width,col2width = opts[:col1width], opts[:col2width]
+        syntax = sprintf(%{  %-#{col1width-3}s },@ast.syntax)
+        buffer << syntax
+        (buffer << ("\n" + ' ' * col1width )) if syntax.length > (col1width)
+        buffer << self.class.wordwrap(@desc,col2width).gsub(/$\n/,"\n"+' '*col1width)
+        buffer
+      end
+      def self.wordwrap text, line_width  # thansks rails
+        text.split("\n").collect do |line|
+          line.length > line_width ? line.gsub(/(.{1,#{line_width}})(\s+|$)/, "\\1\n").strip : line
+        end * "\n"
+      end
+    end
+    
+    class GitHelperException < Exception; end    
+
+    @screen = {:col1width=>26, :col2width=>46}
+    VERSION = '0.0.1beta'
+    REGGIE =
+     %r< 
+      (?:^\#\sOn\sbranch.*$\n)
+      (?:^\#\sYour\sbranch\sis\sahead[^\n]+\n\#\n)?
+      (?:^\#\s^\#\sInitial\sCommit\n\#\s)?
+      (?:
+        (?:^\#\sChanges\sto\sbe\scommitted:$\n)
+        (?:^\#\s+[[:print:]]+$\n)+
+        (?:^\#$\n)
+        ((?:^\#\s+(?:new\sfile|modified|deleted|renamed|copied|[a-z ]+):\s+.+$\n)+)
+        (?:^\#$\n)                       
+      )?
+      (?:
+        (?:^\#\sChanged\sbut\snot\supdated:$\n)
+        (?:^\#\s+[[:print:]]+$\n)+
+        (?:^\#$\n)
+        ((?:^\#\s+(?:modified|deleted):\s+.+$\n)+)
+        (?:^\#$\n)                       
+      )?  
+      (?:
+        (?:^\#\sUntracked\sfiles:$\n)
+        (?:^\#\s+[[:print:]]+$\n)+
+        (?:^\#$\n)
+        ((?:^\#\s+.+$\n)+)
+      )?        
+      >ix  
+    @grammar = Hipe.GorillaGrammar {
+      :help_command    =~ 'help'
+      :info_command    =~ 'info'
+      :version_command =~ 'version'
+      :delete_command  =~ ['delete',zero_or_one('deleted')]
+      :add_command     =~ ['add',one('untracked','modified','both')]
+      :command         =~ :add_command | :delete_command | :help_command | 
+                          :version_command | :info_command
+      :dry             =~ zero_or_one([zero_or_one('as'),'dry',zero_or_one('run')])                          
+      :argv            =~ [:command,zero_or_more(['and',:command]),:dry]
+    }
+    
+    class << self
+      attr_accessor :commands, :grammar, :screen
+    end
+    
+    @commands = []
+    def self.command name, *other, &block
+      @commands << Command.new(name, other[0], @grammar[(name.to_s+'_command'.to_s).to_sym])
+    end
+    
+    def initialize(opts={})
+      opts = {:output_buffer => $stdout }.merge opts
+      @out = opts[:output_buffer]
+    end
+
+    def program_name;  File.basename($PROGRAM_NAME) end
+
+    def run 
+      self << ARGV
+    end
+
+    def << (argv)
+      tree = parse_command argv
+      execute_command tree
+      @out
+    end
+    
+    def read
+      @out.read # will fail unless the user passed in something that responds to this.
+    end
+    
+    def parse_command argv
+      if (0==argv.size || ['--help','-h'].include?(argv[0])) then argv[0] = 'help'
+      elsif (['-v','--version'].include?(argv[0])) then argv[0] = 'version'
+      end
+      tree = self.class.grammar.parse argv
+      tree
+    end
+    
+    def execute_command tree
+      if tree.is_error?
+        @out.puts tree.message 
+        @out.puts "Please try 'help' for syntax and usage."
+      else
+        commands = tree.recurse {|x| (x.name.to_s =~ /_command$/) ? [x] : [] }
+        dry      = tree.recurse {|x| (x.name.to_s =~ /dry/) ? [x] : [] }
+        commands.each do |x| 
+          send(x.name.to_s.match(/^(.+)_command$/).captures[0],[x,dry]) 
+        end
+      end
+      @out      
+    end
+
+    command :help, "show this screen"
+    def help args
+      argv = self.class.grammar[:argv].fork_for_parse # make a deep copy,
+      dry = argv.instance_variable_get('@group').pop.dereference # explain dry separately
+      argv_syntax = %{#{argv.syntax} #{dry.syntax}}
+      @out << <<-END.gsub(/^ {6}/, '')
+      Helpful little shortcuts for git.
+      usage: #{program_name} #{argv_syntax}
+      
+      available commands:
+      END
+      @out << self.class.commands.map{ |x| x.help_short(self.class.screen) }.join("\n")
+      @out << "\n\n"
+      @out << "available options:\n"+Command.new(:dry,
+      "Don't actually do anything, just show a preview of what you would do (where applicable.)", dry).
+      help_short(self.class.screen)
+      @out << "\n"
+    end
+    
+    command :version, "show version number of this script" 
+    def version args
+      @out.puts %{#{program_name} version #{VERSION}}
+    end
+    
+    command :add, "add all files of that kind"
+    def add tree
+      is_dry = tree[1].size > 0 && tree[1][0].name == :dry
+      do_untracked = ['both','untracked'].include? tree[0][1][0]
+      do_modified  = ['both','modified'].include? tree[0][1][0]
+      tree = git_status_parse_tree
+      raise GitHelperException("failed to parse command") unless do_untracked || do_modified
+      list = {}
+      list[:modified] = do_modified ? tree[:changed]['modified'] : [] # names are strings!
+      list[:untracked] = do_untracked ? tree[:untracked] : []
+      [:modified,:untracked].each do |which|
+        count = ( list[which] && list[which].size ) ? list[which].size : 0
+        @out << %{# adding #{count} #{which.to_s} file(s)#{(is_dry&&count>0)? ' (dry run -- not actually doing it)' : '' }\n}
+        next if count == 0
+        list[which].each do |filename| 
+          cmd = %{git add #{filename}}
+          @out.puts cmd
+          unless is_dry
+            if (res = shell!(cmd)).length > 0
+              raise GitHelperException.new(%{I wasn't expecting any response from this.  Got: "#{res}"})
+            end
+          end
+        end
+      end
+      @out.puts '# done.'
+    end
+    
+    def shell! cmd
+      %x{#{cmd}}      
+    end
+
+    def git_status_string
+      shell! 'git status'
+    end
+
+    def try_to_write_git_status_to_file(str)
+      i = 0
+      head = File.expand_path(FileUtils.pwd)+'/example'
+      tail = '.git.status'
+      begin
+        filename = %{#{head}#{i+=1}#{tail}} 
+      end while File.exist?(filename)
+      e = nil
+      File.open(filename, 'w'){|fh| fh.write(str)} rescue e
+      e ? e.message : %{Wrote git status to "#{filename}".}
+    end
+    
+    def git_status_parse_tree
+      str = self.git_status_string
+      unless (matches = REGGIE.match str)
+        response = try_to_write_git_status_to_file(str)
+        raise GitHelperException.new(%{Sorry, failed to parse the git status string.  Please make a note }+
+        %{of the git status for a bug report. #{response}})        
+      end
+      caps = matches.captures
+      ret = {
+        :pending   =>  _to_hash(caps[0]),
+        :changed   =>  _to_hash(caps[1]),
+        :untracked =>  caps[2] ? caps[2].scan(/^\#\t(.*)$\n/).flatten : []
+      }
+      ret
+    end
+    
+    def _to_hash(mixed)
+      mixed ||= ''
+      hash = Hash.new{|x,y|x[y] = []}
+      x = mixed.scan(/^\#\t([^:]+): +(.*)$\n/)
+      x.each{|pair| hash[pair[0]] << pair[1] }
+      hash
+    end
+
+    command :info, "Similar to svn info (Thanks Duane Johnson!)"
+    # This is a port of Duane Johnson's shell script (duane D0T johnson AT gmail D0T com, License: MIT): 
+    # http://blog.inquirylabs.com/2008/06/12/git-info-kinda-like-svn-info/
+    # Based on discussion at http://kerneltrap.org/mailarchive/git/2007/11/12/406496
+    def info args
+      # Find base of git directory
+      until Dir.glob('.git').length > 0 do
+        if '/'==Dir.pwd   
+          @out.puts "can't find .git directory this or any parent folder!"
+          return
+        end
+        Dir.chdir('..')
+      end
+
+      @out.puts "(in "+Dir.pwd+')'
+
+      # Show various information about this git directory
+      @out.puts "== Remote URL: "
+      @out.puts `git remote -v`
+
+      @out.puts "== Remote Branches: "
+      @out.puts `git branch -r`
+
+      @out.puts "== Local Branches:"
+      @out.puts `git branch`
+      @out.puts "\n"
+
+      @out.puts "== Configuration (.git/config)"
+      File.open('.git/config'){|fh| @out.puts fh.read }
+      @out.puts "\n"
+
+      @out.puts "== Most Recent Commit"
+      @out.puts `git log --max-count=1`
+      @out.puts "\n"
+
+      @out.puts "Type 'git log' for more commits, or 'git show' for full commit details."
+      
+    end
+  
+  end # class GitHelper
+  
+end # module Hipe
+
+# pz.to_enum.with_index.select{|e,i| e > 5 }.map{|e,i| i } from manveru sunday 18:08    
+# we considered using Diff::LCS.LCS for this but -- we need contiguous matches

data/tasks/bacon.rake_

@@ -0,0 +1,77 @@
+desc 'Run all bacon specs with pretty output'
+task :bacon do
+  require 'open3'
+  require 'scanf'
+  require 'matrix'
+  
+  PROJECT_SPECS = FileList[
+   'test/*_test.rb'
+  ]  
+ 
+  specs = PROJECT_SPECS
+ 
+  some_failed = false
+  specs_size = specs.size
+  require 'ruby-debug'
+  len = specs.map{|s| s.size }.sort.last
+  total_tests = total_assertions = total_failures = total_errors = 0
+  totals = Vector[0, 0, 0, 0]
+ 
+  red, yellow, green = "\e[31m%s\e[0m", "\e[33m%s\e[0m", "\e[32m%s\e[0m"
+  left_format = "%4d/%d: %-#{len + 11}s"
+  spec_format = "%d specifications (%d requirements), %d failures, %d errors"
+ 
+  load_path = File.expand_path('../../lib', __FILE__)
+ 
+  specs.each_with_index do |spec, idx|
+    print(left_format % [idx + 1, specs_size, spec])
+ 
+    Open3.popen3(RUBY, '-I', load_path, spec) do |sin, sout, serr|
+      out = sout.read.strip
+      err = serr.read.strip
+ 
+      # this is conventional
+      if out =~ /^Bacon::Error: (needed .*)/
+        puts(yellow % ("%6s %s" % ['', $1]))
+      elsif out =~ /^Spec (precondition: "[^"]*" failed)/
+        puts(yellow % ("%6s %s" % ['', $1]))
+      elsif out =~ /^Spec require: "require" failed: "(no such file to load -- [^"]*)"/
+        puts(yellow % ("%6s %s" % ['', $1]))
+      else
+        total = nil
+ 
+        out.each_line do |line|
+          scanned = line.scanf(spec_format)
+ 
+          next unless scanned.size == 4
+ 
+          total = Vector[*scanned]
+          break
+        end
+ 
+        if total
+          totals += total
+          tests, assertions, failures, errors = total_array = total.to_a
+ 
+          if tests > 0 && failures + errors == 0
+            puts((green % "%6d passed") % tests)
+          else
+            some_failed = true
+            puts(red % " failed")
+            puts out unless out.empty?
+            puts err unless err.empty?
+          end
+        else
+          some_failed = true
+          puts(red % " failed")
+          puts out unless out.empty?
+          puts err unless err.empty?
+        end
+      end
+    end
+  end
+ 
+  total_color = some_failed ? red : green
+  puts(total_color % (spec_format % totals.to_a))
+  exit 1 if some_failed
+end

data/test/argv.rb

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+# this is for debugging with how the shell parses strings into tokens
+puts Marshal.dump(ARGV)

data/test/bacon_test.rb

@@ -0,0 +1,155 @@
+# bacon test/bacon_test.rb
+# WARNING! currently this uses the shell to see exactly how the shell will parse a string 
+# and turn it into an array.  These tests will likely fail on windows. @FIXME
+
+
+require 'rubygems'
+require 'hipe-githelper'
+require 'bacon'
+
+##################################
+module TestHelper
+ # dangerous! -- we pass anything to shell and execute it to see how the shell parses it
+  @argv_filename = %{#{File.expand_path(File.dirname(__FILE__))}/argv.rb}
+  class << self
+    attr_accessor :argv_filename
+  end
+  def shell! str
+    response = %x{ruby #{TestHelper.argv_filename} #{str}}    
+    Marshal.load response
+  end    
+end
+include TestHelper
+#################################
+
+include TestHelper
+
+describe "Parsing user input in General context" do
+  
+  before do
+    @g = Hipe::GitHelper.new(:output_buffer=>(@s = Hipe::GitHelper::BufferString.new))    
+  end
+  
+  it "should help on no input (b1)" do
+    @g << shell!('')
+    @g.read.should.match( /usage[^\n]+(\n[^\n]*){5}/ )
+  end
+  
+  it "should complain on bad input (b2)" do
+    @g << shell!('bling blang blong')
+    @g.read.should.match( /don't know what you mean by .*bling.*expecting.*help/)
+  end
+  
+  it "should do version command (b3)" do
+    @g << shell!('version')
+    @g.read.should.match( /version.*\d+\.\d+\.\d/)
+  end
+end
+
+describe Hipe::GitHelper::BufferString,"in General context" do
+  it "puts should work with arrays" do
+    s =  Hipe::GitHelper::BufferString.new
+    s.puts(['alpha','beta'])
+    s.read.should.equal "alpha\nbeta\n"
+  end
+end
+
+
+describe 'Actual script in real environment, in General context' do
+  before do
+    @g = Hipe::GitHelper.new(:output_buffer=>(@s = Hipe::GitHelper::BufferString.new))    
+  end  
+
+  it "should report in actual status (Fragile test--needs actual git repository) (r1)" do # was p3
+    @g << shell!('info');
+    @g.read.should.match(
+      /Remote URL.*== Remote Branches.*== Local Branches.*== Configuration.*== Most Recent Commit.*/m
+    )
+  end
+  
+  it "should do add as dry run (Fragile test--needs actual git repository)(r2)" do     
+    @g << shell!('add modified as dry run')
+    s = @g.read
+    s.should.match(/^# adding /)
+  end
+  
+  it "should actually run from the command line (r3)" do
+    fullpath = File.expand_path(File.dirname(__FILE__))+'/../bin/githelper'
+    %x{#{fullpath} version}.should.match(/version.*\d+\.\d+\.\d+/i)
+  end
+  
+  
+  it "should complain about missing git, or that ...blah blah(p6)" do
+    # "YOU'RE GOING TO FEEL REALLY DUMB WHEN THIS FAILS"
+    @app = Hipe::GitHelper.new
+    class << @app; self end.send(:define_method,'shell!'){'dummy response for testing'} # metaprogramming just for fun\
+    def @app.git_status_string # @todo fixme -- this needs actual stubbing or mocking or whatever
+      File.open(File.dirname(__FILE__)+'/example1.git.status','r'){|f| f.read}
+    end    
+    fn = 'erase-me-now-'+Time.now.strftime('%Y-%m-%d--%H:%I:%S')
+    FileUtils.touch fn
+    lambda{ @app << shell!('add untracked') }.should.raise(Hipe::GitHelper::GitHelperException).
+      message.should.match(/^I wasn't expecting any response from this\.  Got: "dummy response for testing"$/)
+    FileUtils.rm fn
+  end
+  
+end
+
+describe 'Parsing the git status in General context' do
+  before do
+    @app = Hipe::GitHelper.new :output_buffer=>Hipe::GitHelper::BufferString.new
+    def @app.git_status_string # @todo fixme -- this needs actual stubbing or mocking or whatever
+      File.open(File.dirname(__FILE__)+'/example1.git.status','r'){|f| f.read}
+    end
+  end
+
+  it "parses the git file into a pretty tree (p1)" do
+    @app.git_status_parse_tree.should.equal({
+    :pending=>
+     {"modified"=>["lib/hipe-gorillagrammar.rb", "spec/parsing_spec.rb"],
+      "deleted"=>["spec/unparse_spec.rb"]},
+    :changed=>
+     {"modified"=>
+       ["History.txt",
+        "README.txt",
+        "lib/hipe-gorillagrammar.rb",
+        "spec/parsing_spec.rb",
+        "spec/sequence_spec.rb",
+        "spec/shorthand_spec.rb"]},
+      :untracked=>
+      ["lame",
+       "oh.rb",
+       "spec/FOCUS",
+       "spec/parse_tree_spec.rb",
+       "spec/symbol_reference_spec.rb"]
+    })
+  end
+  
+  it "should do add as dry run (p2)" do     
+    @app << shell!('add modified as dry run')
+    s = @app.read
+    s.should.match(/add.*History.*README.txt\n(.*\n){3}/m)
+  end  
+  
+  it "should complain when not in git dir (p4)" do
+    name = '/tmp/this_is_a_temporary_folder_for_tests'
+    pwd = Dir.pwd
+    FileUtils.mkdir name unless File.exist?(name)
+    FileUtils.cd name 
+    @app << shell!('info')
+    FileUtils.cd pwd 
+    @app.read.should.match(/can't find \.git directory this or any parent folder!/)
+  end
+  
+  it "should write that file thing.(p5)" do
+    str = "this is a bad git status string for the purpose of testing"
+    class << @app; self end.send(:define_method,:git_status_string){str}  # thanks rue
+    begin
+      @app.git_status_parse_tree    
+    rescue Hipe::GitHelper::GitHelperException => e
+      md = /Wrote git status to "([^"]+)"/.match(e)
+      md.should.be.kind_of MatchData
+      str.should.equal File.open(md[1],'r'){|fh| fh.read } # ridiculous test
+    end
+  end
+end

data/test/example1.git.status

@@ -0,0 +1,27 @@
+# On branch master
+# Changes to be committed:
+#   (use "git reset HEAD <file>..." to unstage)
+#
+#	modified:   lib/hipe-gorillagrammar.rb
+#	modified:   spec/parsing_spec.rb
+#	deleted:    spec/unparse_spec.rb
+#
+# Changed but not updated:
+#   (use "git add <file>..." to update what will be committed)
+#   (use "git checkout -- <file>..." to discard changes in working directory)
+#
+#	modified:   History.txt
+#	modified:   README.txt
+#	modified:   lib/hipe-gorillagrammar.rb
+#	modified:   spec/parsing_spec.rb
+#	modified:   spec/sequence_spec.rb
+#	modified:   spec/shorthand_spec.rb
+#
+# Untracked files:
+#   (use "git add <file>..." to include in what will be committed)
+#
+#	lame
+#	oh.rb
+#	spec/FOCUS
+#	spec/parse_tree_spec.rb
+#	spec/symbol_reference_spec.rb

data/test/other_testing_frameworks/coulda.all_test_.rb

@@ -0,0 +1,35 @@
+require 'rubygems'
+require 'coulda'
+require 'hipe-githelper'
+include Coulda
+
+module Helper
+  def get_app
+    Githelper.new(:output_buffer=>'')
+  end
+  
+  def shell_argv! string
+    Marshal.load %x{ruby #{File.dirname(__FILE__).'/argv.rb'}}
+  end
+  
+end
+
+Feature "Parse user commands" do
+  include helper
+  in_order_to "understand user requests"
+  as_a "pieces of software"
+  i_want_to "use an LA parser generator to understand commands"
+  
+  Scenario "the user enters nothing" do
+    Given "the user inputs this" do 
+      @app = get_app
+      @argv = shell_argv! ''
+    end
+    When "i parse it" do
+      @app << @argv
+    end
+    Then "it should make a pretty tree" do 
+      assert_match /usage.*\n.*\n.*\n/i, @app->flush
+    end
+  end
+end

data/test/other_testing_frameworks/riot.all_test_.rb

@@ -0,0 +1,51 @@
+# ruby test/all_test.rb
+require 'rubygems'
+require 'ruby-debug'
+require File.dirname(__FILE__)+'/teststrap'
+
+
+# dangerous -- we pass anything to shell and execute it to see how the shell parses it
+def shell! str
+  Marshal.load %x{ruby #{File.dirname(__FILE__)}/argv #{str}}
+end
+
+class BufferString < String; def flush; t = s.dup; s.replace(''); t end end
+
+context "parsing input" do
+  #setup do
+  #  @s = BufferString.new
+  #  Githelper.new(:output_buffer=>@s)
+  #end
+  #
+  #asserts("displays help when given empty input") do
+  #  
+  #end
+  #  
+  #  
+  #end
+      
+end
+
+
+
+Hipe::GitHelper.new(:output_buffer=>@s).git_status_parse_tree
+
+context "parsing git status" do
+  setup do
+    
+    debugger
+   #@s = BufferString.new 
+   #@g = Hipe::GitHelper.new(:output_buffer=>@s)
+   #def @g.git_statuz_string
+   #  File.open(File.dirname(__FILE__)+'/example1.git.status','r'){|f| f.read}
+   #end
+   #
+  end
+  
+  asserts("parses the git file into a pretty tree"){ 
+    debugger
+    @g.git_status_parse_tree
+    
+    
+     }
+end

data/test/other_testing_frameworks/teststrap.rb

@@ -0,0 +1,5 @@
+require 'rubygems'
+require 'riot'
+require 'hipe-githelper'
+
+

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification 
+name: hipe-githelper
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Mark Meves
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-02 00:00:00 -05:00
+default_executable: githelper
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: bacon
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hipe-gorillagrammar
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.0.1
+    version: 
+description: command-line convenience methods for git
+email: mark dot meves at gmail dot com
+executables: 
+- githelper
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .gitignore
+- History.txt
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- bin/githelper
+- example1.git.status
+- hipe-githelper.gemspec
+- lib/hipe-githelper.rb
+- tasks/bacon.rake_
+- test/argv.rb
+- test/bacon_test.rb
+- test/example1.git.status
+- test/other_testing_frameworks/coulda.all_test_.rb
+- test/other_testing_frameworks/riot.all_test_.rb
+- test/other_testing_frameworks/teststrap.rb
+has_rdoc: true
+homepage: http://github.com/hipe/hipe-githelper
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: little convenience methods for git
+test_files: 
+- test/argv.rb
+- test/bacon_test.rb
+- test/other_testing_frameworks/coulda.all_test_.rb
+- test/other_testing_frameworks/riot.all_test_.rb
+- test/other_testing_frameworks/teststrap.rb