brigit 0.8.1

data/Manifest

@@ -0,0 +1,15 @@
+bin/brigit
+lib/brigit/cli.rb
+lib/brigit/commands/command.rb
+lib/brigit/commands/map_command.rb
+lib/brigit/commands/update_command.rb
+lib/brigit/config_parser.rb
+lib/brigit/version.rb
+lib/brigit.rb
+lib/ext/option_parser.rb
+Rakefile
+README.rdoc
+test/config_parser_test.rb
+test/fixtures/example.conf
+test/test_helper.rb
+Manifest

data/README.rdoc

@@ -0,0 +1,36 @@
+= Brigit
+
+A random collection of utilities for developers working with Git repositories.
+
+== Contributing
+
+Feel free to fork, send patches, etc.  Development is done at http://github.com/fiveruns/brigit
+
+== Authors
+
+The FiveRuns development team, http://www.fiveruns.org
+
+== License
+
+# (The FiveRuns License)
+#
+# Copyright (c) 2006-2008 FiveRuns Corporation
+# 
+# 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/Rakefile

@@ -0,0 +1,15 @@
+require 'rubygems'
+require 'echoe'
+
+require File.dirname(__FILE__) << "/lib/brigit/version"
+
+Echoe.new 'brigit' do |p|
+  p.version = Brigit::Version::STRING
+  p.author = "FiveRuns Development Team"
+  p.email  = 'dev@fiveruns.com'
+  p.project = 'fiveruns'
+  p.summary = "Git utilities"
+  p.url = "http://github.com/fiveruns/brigit"
+  p.include_rakefile = true
+end
+

data/bin/brigit

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+require File.dirname(__FILE__) << "/../lib/brigit"
+
+Brigit::CLI.new.parse(*ARGV) do |command|
+  command.execute!
+end
+  

data/brigit.gemspec

@@ -0,0 +1,55 @@
+
+# Gem::Specification for Brigit-0.8.1
+# Originally generated by Echoe
+
+Gem::Specification.new do |s|
+  s.name = %q{brigit}
+  s.version = "0.8.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["FiveRuns Development Team"]
+  s.date = %q{2008-07-08}
+  s.default_executable = %q{brigit}
+  s.description = %q{Git utilities}
+  s.email = %q{dev@fiveruns.com}
+  s.executables = ["brigit"]
+  s.extra_rdoc_files = ["bin/brigit", "lib/brigit/cli.rb", "lib/brigit/commands/command.rb", "lib/brigit/commands/map_command.rb", "lib/brigit/commands/update_command.rb", "lib/brigit/config_parser.rb", "lib/brigit/version.rb", "lib/brigit.rb", "lib/ext/option_parser.rb", "README.rdoc"]
+  s.files = ["bin/brigit", "lib/brigit/cli.rb", "lib/brigit/commands/command.rb", "lib/brigit/commands/map_command.rb", "lib/brigit/commands/update_command.rb", "lib/brigit/config_parser.rb", "lib/brigit/version.rb", "lib/brigit.rb", "lib/ext/option_parser.rb", "Rakefile", "README.rdoc", "test/config_parser_test.rb", "test/fixtures/example.conf", "test/test_helper.rb", "Manifest", "brigit.gemspec"]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/fiveruns/brigit}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Brigit", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{fiveruns}
+  s.rubygems_version = %q{1.2.0}
+  s.summary = %q{Git utilities}
+  s.test_files = ["test/config_parser_test.rb", "test/test_helper.rb"]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if current_version >= 3 then
+    else
+    end
+  else
+  end
+end
+
+
+# # Original Rakefile source (requires the Echoe gem):
+# 
+# require 'rubygems'
+# require 'echoe'
+# 
+# require File.dirname(__FILE__) << "/lib/brigit/version"
+# 
+# Echoe.new 'brigit' do |p|
+#   p.version = Brigit::Version::STRING
+#   p.author = "FiveRuns Development Team"
+#   p.email  = 'dev@fiveruns.com'
+#   p.project = 'fiveruns'
+#   p.summary = "Git utilities"
+#   p.url = "http://github.com/fiveruns/brigit"
+#   p.include_rakefile = true
+# end
+# 

data/lib/brigit.rb

@@ -0,0 +1,24 @@
+require 'find'
+
+module Brigit
+  
+  def self.at_dot_gitmodules
+    Find.find(Dir.pwd) do |path|
+      if File.basename(path) == '.git' && File.directory?(path)
+        Find.prune
+      elsif File.file?(File.join(path, '.gitmodules'))
+        Dir.chdir path do
+          yield path
+        end
+      end
+    end
+  end
+    
+end
+
+$:.unshift File.dirname(__FILE__)
+  
+# Require all files
+Dir[File.dirname(__FILE__) << "/**/*.rb"].each do |file|
+  require file
+end

data/lib/brigit/cli.rb

@@ -0,0 +1,61 @@
+require 'ostruct'
+
+module Brigit
+  
+  class CLI
+    
+    def parse(*args)
+      self.class.parser.parse!(args)
+      if (args.first && command = Command[args.shift])
+        yield command.new(self.class.options, *args)
+      else
+        abort "No command given.\n#{parser}"
+      end
+    end
+        
+    def self.usage
+      parser.to_s
+    end
+    
+    #######
+    private
+    #######
+    
+    def self.options
+      @options ||= OpenStruct.new
+    end
+    
+    def self.parser
+      
+      command_list = Command.list.map { |command| "  * #{command.name}: #{command.help}" }.join("\n")
+      
+      options.inventory = {}
+      
+      @parser ||= OptionParser.new do |opts|
+        
+        opts.banner = %("Brigit," Submodule utilities for Git\nUSAGE: brigit COMMAND [OPTIONS])
+
+        opts.separator "COMMANDS:\n#{command_list}\n"
+        
+        opts.separator "OPTIONS:\n"
+
+        Inventory.list.each do |inventory|
+          opts.on("-#{inventory.name[0,1]}", "--#{inventory.name} PATH", "Location of #{inventory.name} (`grab' only)") do |path|
+            options.inventory[inventory] = path
+          end
+        end
+        
+        opts.on('-o', '--open', "Open with Preview.app  (`map' only, requires OSX & `dot' in PATH)") do
+          options.open = true
+        end
+        
+        opts.on_tail('-h', '--help', 'Show this message') do
+          abort opts.to_s
+        end
+        
+      end
+    end
+    
+  end
+  
+end

data/lib/brigit/commands/command.rb

@@ -0,0 +1,34 @@
+require 'brigit/listable'
+require 'brigit/fallible'
+
+module Brigit
+  
+  class Command
+    include Listable
+    include Fallible
+    
+    class << self
+      attr_accessor :help
+    end
+    
+    attr_reader :options, :args
+    def initialize(options, *args)
+      @options = options
+      @args = args
+    end
+    
+    def execute!
+      raise ArgumentError, "Must be in Git repository" unless repo?
+    end
+    
+    #######
+    private
+    #######
+
+    def repo?
+      File.directory?(File.join(Dir.pwd, '.git'))
+    end
+    
+  end
+  
+end

data/lib/brigit/commands/map_command.rb

@@ -0,0 +1,55 @@
+require 'brigit/commands/command'
+require 'find'
+
+module Brigit
+  
+  class MapCommand < Command
+    
+    self.help = "Graphs of submodules in this repository"
+    
+    def execute!
+      super
+      text =  %|digraph G {\n|
+      # TODO: Allow customization
+      text << %|ranksep=.75; size = "12,12";\n|
+      base = Dir.pwd
+      Brigit.at_dot_gitmodules do |path|
+        origin = origin_at(path)
+        text << %|  "#{origin}" [shape="box",style=filled,fillcolor=lightgrey];\n|
+        submodules_at(path).each do |submodule|
+          text << %| "#{origin}" -> "#{submodule['url']}" [fontsize=16,label="#{submodule['path']}"];\n|
+        end
+      end
+      text << %|}\n|
+      if options.open
+        IO.popen("dot -Tpng | open -f -a /Applications/Preview.app", 'w') do |file|
+          file.write text
+        end
+      else
+        puts text
+      end
+    end
+    
+    #######
+    private
+    #######
+    
+    def origin_at(path)
+      filename = File.join(path, '.git/config')
+      result = parser.parse(File.readlines(filename))
+      result['remote "origin"']['url']
+    end
+    
+    def submodules_at(path)
+      filename = File.join(path, '.gitmodules')
+      result = parser.parse(File.readlines(filename))
+      result.values
+    end
+
+    def parser
+      @parser ||= ConfigParser.new
+    end
+      
+  end
+  
+end

data/lib/brigit/commands/update_command.rb

@@ -0,0 +1,20 @@
+require 'brigit/commands/command'
+require 'find'
+
+module Brigit
+  
+  class UpdateCommand < Command
+    
+    self.help = "Update all submodules in the repo, recursively"
+    
+    def execute!
+      super
+      Brigit.at_dot_gitmodules do |path|
+        system "git submodule init"
+        system "git submodule update"
+      end
+    end
+    
+  end
+  
+end

data/lib/brigit/config_parser.rb

@@ -0,0 +1,90 @@
+module Brigit
+  
+  # Reworked from Sam Ruby's Ruby "PythonConfigParser," http://intertwingly.net/code/mars/planet/config.rb
+  # which in turn is a port of Python's ConfigParser, http://docs.python.org/lib/module-ConfigParser.html
+  class ConfigParser
+    
+    class Section
+      
+      attr_reader :name
+      def initialize(name)
+        @name = name
+      end
+      
+      def options
+        @options ||= {}
+      end
+      
+      def method_missing(*args, &block)
+        options.__send__(*args, &block)
+      end
+      
+    end
+    
+    def self.section_pattern
+      @section_pattern ||= /
+        \[                    # [
+        ([^\]]+)              # very permissive!
+        \]                    # ]
+      /x
+    end
+    
+    def self.option_pattern
+      @option_pattern ||= /
+        ([^:=\s][^:=]*)       # very permissive!
+        \s*[:=]\s*            # any number of space chars,
+                              # followed by separator
+                              # (either : or =), followed
+                              # by any # space chars
+        (.*)$                 # everything up to eol
+      /x
+    end
+
+
+    # FIXME: This is *way* ugly     
+    def parse(lines)
+      sections = Hash.new { |_, name| Section.new(name) }
+      section = nil
+      option = nil
+      lines.each_with_index do |line, number|
+        next if skip? line
+        if line =~ self.class.option_pattern
+          # option line
+          option, value = $1, $2
+          option = option.downcase.strip
+          value.sub!(/\s;.*/, '')
+          value = '' if value == '""'
+          section[option] = clean value
+        elsif line =~ /^\s/ && section && option
+          # continuation line
+          value = line.strip
+          section[option] = section[option] ? (section[option] << "\n#{clean value}") : clean(value)
+        elsif line =~ self.class.section_pattern
+          section = sections[$1]
+          sections[$1] = section
+          option = nil
+        elsif !section
+          raise SyntaxError, 'Missing section header'
+        else
+          raise SyntaxError, "Invalid syntax on line #{number}"
+        end
+      end
+      sections
+    end
+    
+    #######
+    private
+    #######
+    
+    def clean(value)
+      value.sub(/\s*#.*/, '')
+    end
+    
+    def skip?(line)
+      line.strip.empty? || line =~ /^\s*[#;]/ || line =~ /^rem(\s|$)/i
+    end
+    
+  end
+  
+end
+  

data/lib/brigit/version.rb

@@ -0,0 +1,86 @@
+# (The MIT License)
+# 
+# Copyright (c) 2008 Jamis Buck <jamis@37signals.com>,
+#               with modifications by Bruce Williams <bruce@fiveruns.com>
+# 
+# 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.
+  
+module Brigit
+  
+  # A class for describing the current version of a library. The version
+  # consists of three parts: the +major+ number, the +minor+ number, and the
+  # +tiny+ (or +patch+) number.
+  class Version
+    
+    include Comparable
+  
+    # A convenience method for instantiating a new Version instance with the
+    # given +major+, +minor+, and +tiny+ components.
+    def self.[](major, minor, tiny)
+      new(major, minor, tiny)
+    end
+    
+    def self.rails
+      @rails ||= begin
+        # handle ::Rails::VERSION not being set
+        Version.new(::Rails::VERSION::MAJOR, ::Rails::VERSION::MINOR, ::Rails::VERSION::TINY) rescue Version.new(0,0,0)
+      end
+    end
+
+    attr_reader :major, :minor, :tiny
+
+    # Create a new Version object with the given components.
+    def initialize(major, minor, tiny)
+      @major, @minor, @tiny = major, minor, tiny
+    end
+
+    # Compare this version to the given +version+ object.
+    def <=>(version)
+      to_i <=> version.to_i
+    end
+
+    # Converts this version object to a string, where each of the three
+    # version components are joined by the '.' character. E.g., 2.0.0.
+    def to_s
+      @to_s ||= [@major, @minor, @tiny].join(".")
+    end
+
+    # Converts this version to a canonical integer that may be compared
+    # against other version objects.
+    def to_i
+      @to_i ||= @major * 1_000_000 + @minor * 1_000 + @tiny
+    end
+    
+    def to_a
+      [@major, @minor, @tiny]
+    end
+
+    MAJOR = 0
+    MINOR = 8
+    TINY  = 1
+
+    # The current version as a Version instance
+    CURRENT = new(MAJOR, MINOR, TINY)
+    # The current version as a String
+    STRING = CURRENT.to_s
+          
+  end
+  
+end

data/lib/ext/option_parser.rb

@@ -0,0 +1,13 @@
+require 'optparse'
+
+# Fix OptionParser#separator's handling of strings with newlines
+# From http://rubyforge.org/tracker/?func=detail&atid=1700&aid=9177&group_id=426
+class OptionParser
+  
+  def separator(string)
+    string.split(/\n/).each do |line|
+      top.append(line.chomp, nil, nil)
+    end
+  end
+  
+end

data/test/config_parser_test.rb

@@ -0,0 +1,42 @@
+require File.dirname(__FILE__) << "/test_helper"
+
+class ConfigParserTest < Test::Unit::TestCase
+  
+  attr_reader :results
+  
+  context "ConfigParser" do
+    setup do
+      @results = parser.parse(File.read(File.dirname(__FILE__) << "/fixtures/example.conf"))
+    end
+    should "find correct number of sections" do
+      assert_equal %w(section1 section2 section3 section4), results.keys.sort
+    end
+    should "find options" do
+      counts = { 1 => 0, 2 => 2, 3 => 2, 4 => 0}
+      counts.each do |i, count|
+        assert_equal count, results["section#{i}"].size
+      end
+    end
+    should "ignore comments" do
+      assert_equal %w(
+                 lib/ham
+                 spam/eggs
+                 foo/a
+                 foo/b
+                 foo/c
+                 foo/lib/bar
+                 foo/lib/baz
+                 foo/lib/quux
+                 foo/doc/design), results["section3"]['items'].scan(/(\S+)/).flatten
+    end
+  end
+  
+  #######
+  private
+  #######
+
+  def parser
+    @parser ||= Brigit::ConfigParser.new
+  end
+  
+end

data/test/fixtures/example.conf

@@ -0,0 +1,23 @@
+[section1]
+
+[section2]
+writable = gitosis-admin
+members = a b c
+
+[section3]
+items = lib/ham
+
+           spam/eggs
+              
+           foo/a
+           foo/b
+           foo/c
+           foo/lib/bar # this is a comment
+           foo/lib/baz
+           foo/lib/quux
+           foo/doc/design
+           # this is a ful line comment
+           
+members = a b c d e f g
+
+[section4]

data/test/test_helper.rb

@@ -0,0 +1,6 @@
+require 'test/unit'
+require 'rubygems'
+require 'Shoulda'
+require 'flexmock/test_unit'
+
+require File.dirname(__FILE__) << "/../lib/brigit"

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification 
+name: brigit
+version: !ruby/object:Gem::Version 
+  version: 0.8.1
+platform: ruby
+authors: 
+- FiveRuns Development Team
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-07-08 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: Git utilities
+email: dev@fiveruns.com
+executables: 
+- brigit
+extensions: []
+
+extra_rdoc_files: 
+- bin/brigit
+- lib/brigit/cli.rb
+- lib/brigit/commands/command.rb
+- lib/brigit/commands/map_command.rb
+- lib/brigit/commands/update_command.rb
+- lib/brigit/config_parser.rb
+- lib/brigit/version.rb
+- lib/brigit.rb
+- lib/ext/option_parser.rb
+- README.rdoc
+files: 
+- bin/brigit
+- lib/brigit/cli.rb
+- lib/brigit/commands/command.rb
+- lib/brigit/commands/map_command.rb
+- lib/brigit/commands/update_command.rb
+- lib/brigit/config_parser.rb
+- lib/brigit/version.rb
+- lib/brigit.rb
+- lib/ext/option_parser.rb
+- Rakefile
+- README.rdoc
+- test/config_parser_test.rb
+- test/fixtures/example.conf
+- test/test_helper.rb
+- Manifest
+- brigit.gemspec
+has_rdoc: true
+homepage: http://github.com/fiveruns/brigit
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Brigit
+- --main
+- README.rdoc
+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: fiveruns
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Git utilities
+test_files: 
+- test/config_parser_test.rb
+- test/test_helper.rb