madx-ruacce 1.0.0

data/README

@@ -0,0 +1,68 @@
+
+        ruacce -- the repository updater and custom command executer
+
+-------------------------------------------------------------------------------
+
+ruacce (pronounced "lu-ah-tché") is a small command line tool that helps you 
+with managing the repositories
+you're tracking. You can also define rules that performs some actions on your
+repositories (like building gems, running (R|M)akefiles,...)
+
+ruacce is scm-agnostic so you can mix Git, Mercurial or Subversion repositories
+without any worry.
+
+** Install **
+
+$ sudo gem install madx-ruacce --source=http://gems.github.com/
+or
+$ cd your/repos/folder/
+$ git clone git://github.com/madx/ruacce.git
+$ cd ruacce; rake
+And a fresh gem will be placed in the pkg/ folder
+
+** Usage **
+
+First, run ruacce --help.
+Then, cd to the folder where you keep your repos and run ruacce -C to generate 
+a blank config file (.ruacce_rules, created in the current folder)
+
+Ok let's say you've got those awesome repositories in your folder:
+
+shoes, merb-core, merb-more, dm-core, dm-more, haml and mtest (managed by git)
+trac, lighttpd (managed by svn)
+audacious (tracked by mercurial)
+
+That's a big bunch of repositories, and when you want to update them all you
+have to manually cd in the folder an run the appropriate command.
+But wait. No. You just installed ruacce !!!
+
+The first thing you may want to do is defining a command to fetch the latest
+changes on you repos.
+It's "git/hg pull" for Git and Mercurial and "svn update" for Subversion.
+
+So for defining the actions for git repositories you could do a :
+$ ruacce -s shoes,merb-more,merb-core,dm-core,dm-more,haml,mtest -A pull
+
+This will add a rule "pull" for those repos. The system will ask you for the
+command to be run when executing this rule. Type "git pull" and push Enter.
+Since you've grasped how it works, you already added rules for your Mercurial
+and Subversion repositories.
+
+The important thing is that -s selects repositories, and the action will be
+executed upon each of them.
+
+You can show the rules defined on some projects using -R and selecting them 
+with -s
+
+The -X switch is used to hide some folders from ruacce so it doesn't count them
+as repositories.
+
+Well, I think this should be enough to start, the --help switch will tell you
+the rest.
+
+** Bug reports/testimonials **
+
+Feel free to send them on github (http://github.com/madx/ruacce) or drop me an
+email. I also accept patches :)
+If you're using ruacce and want to be in this README, write a funny testimonial
+and email it to me.

data/Rakefile

@@ -0,0 +1,12 @@
+require 'rubygems'
+require 'rake'
+require 'rake/gempackagetask'
+
+RUACCE_GEMSPEC = eval(File.read('ruacce.gemspec'))
+
+Rake::GemPackageTask.new(RUACCE_GEMSPEC) do |pkg|
+  pkg.need_tar_bz2 = true
+end
+task :default => "pkg/#{RUACCE_GEMSPEC.name}-#{RUACCE_GEMSPEC.version}.gem" do
+  puts "generated latest version"
+end

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/bin/ruacce

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require File.dirname(__FILE__) + '/../lib/ruacce'
+
+Ruacce::ArgvParser.parse(ARGV)

data/lib/ruacce.rb

@@ -0,0 +1,32 @@
+require 'yaml'
+require 'optparse'
+require 'ostruct'
+require 'fileutils'
+
+dir = File.dirname(__FILE__)
+$LOAD_PATH << dir unless $LOAD_PATH.include?(dir)
+
+require 'ruacce/argv_parser'
+require 'ruacce/config'
+require 'ruacce/repository'
+
+module Ruacce
+  RULES_FILE = '.ruacce_rules'
+  
+  module Formats
+    def self.included(parent)
+      { :o => "33", :p => "35", :g => "32", :r => "1;31", :w => "1;37"}.
+      each do |meth, color|
+        parent.class_eval { define_method(meth) { "\e[#{color}m#{self}\e[00m" } }
+      end
+      parent.class_eval do 
+        define_method(:i) do 
+          self.ljust(78).split("\n").collect{|l| "  #{l}"}.join("\n")
+        end
+      end
+    end
+  end
+
+  String.send(:include, Formats)
+  
+end

data/lib/ruacce/argv_parser.rb

@@ -0,0 +1,146 @@
+module Ruacce
+  class ArgvParser
+
+    def self.parse(args)
+      options = OpenStruct.new
+      options.repositories = []
+      options.quiet        = false
+      
+      opts = OptionParser.new do |opts|
+        opts.banner = "Usage: ruacce [options] repos"
+        
+        opts.separator ""
+        opts.separator "Specific options:"
+        
+        opts.on('-s', '--select [REPO]', 'Select repository REPO') do |repo|
+          repo.split(',').each do |r|
+            options.repositories << Repository.new(r)
+          end
+        end
+        
+        opts.on('-a', '--all', 'Select every repository') do 
+          Repository.repos.each do |repo|
+            options.repositories << Repository.new(repo)
+          end
+        end
+        
+        opts.on('-r', '--rule [RULE]', 'Execute RULE on each selected repo') do |rule|
+          rule = rule.to_sym
+          options.repositories.each do |repo|
+            puts "> #{repo.name}".w unless options.quiet
+            if repo.rules.is_a?(Hash) && repo.rules.key?(rule)
+              FileUtils.cd(repo.name) do
+                system repo.rules[rule]
+              end
+            else
+              puts "  Warning: repository #{repo.name} has no rule #{rule}".p unless options.quiet
+            end
+          end
+        end
+        
+        opts.on('-q', '--quiet', 'Disables output when executing rules, nice for using ruacce as a rule') do
+          options.quiet = true
+        end
+        
+        opts.on('-R', '--rules', 'See available rules for the selected repos') do
+          unless options.repositories.empty?
+            options.repositories.each do |repo|
+              puts "> #{repo.name}".w
+              unless repo.rules.nil?
+                repo.rules.each do |name, command|
+                  puts "  #{name.to_s.o}: #{command}"
+                end
+              else
+                puts "  no rules defined so far."
+              end
+            end
+          else
+            err "Error: No repository specified."
+          end
+        end
+        
+        opts.on('-A', '--add-rule [NAME]', 'Add a rule NAME for the selected repo') do |name|
+          conf = Config.new
+          name = name.to_sym
+          unless options.repositories.empty?
+            print "Enter the command: ".o
+            rule = gets.chomp
+            options.repositories.each do |repo|
+              reposym = repo.name.to_sym
+              if conf.rules[reposym].is_a?(Hash) && conf.rules[reposym].key?(name)
+                print "#{reposym} already has a rule #{name}, overwrite ? (yes/no/all) ".o
+                ans = gets.chomp
+                if ! ans =~ /y(?:e(?:s))/i
+                  abort "Aborting."
+                elsif ans == 'all'
+                  break
+                end
+              end
+              (conf.rules[reposym] ||= {})[name] = rule
+            end
+            print "Added rule #{name} on: ".o
+            options.repositories.each {|repo| print repo.name+' ' }
+            conf.save
+            done "\nConfig file saved".g
+          else
+            err "Error: No repository specified.".r
+          end
+        end
+        
+        opts.on('-X', '--exclude [DIR][,DIR]', 'Add DIR(s) to excluded folders') do |d|
+          conf = Config.new
+          conf.config[:exclude] ||= []
+          print "Add to exclude list: ".o
+          d.split(',').each do |dir|
+            print dir
+            conf.config[:exclude] << dir
+          end
+          conf.save
+          done "\nConfig file saved".g
+        end
+        
+        opts.on('-C', '--config-stub', 'Generate a blank config file') do |p|
+          unless File.exist?(RULES_FILE)
+            File.open(RULES_FILE, 'w+') do |f|
+              f.write YAML.dump(Config.blank)
+            end
+            done "Blank config file generated (in .ruacce_rules)"
+          else
+            abord "A configuration file has been found, aborting"
+          end
+        end
+        
+        opts.separator ""
+        opts.separator "Common options:"
+        
+        opts.on_tail("-h", "--help", "Show this message") do
+          puts opts
+          puts  "\nDescription:",
+            "  ruacce -- This tool allows you to update your repositories",
+            "  or automatically execute custom commands on them."
+          exit
+        end
+        
+      end
+      
+      opts.parse!(args)
+      options
+    end # self.parse()
+    
+    def self.err(str)
+      puts str.r
+      exit
+    end
+    
+    def self.abort(str)
+      puts str.p
+      exit
+    end
+    
+    def self.done(str)
+      puts str.g
+      exit
+    end
+    
+  end
+end

data/lib/ruacce/config.rb

@@ -0,0 +1,35 @@
+module Ruacce
+  class Config
+
+    attr_reader :rules, :config
+
+    def initialize
+      if File.exist?(RULES_FILE)
+        yaml = YAML.load(File.read(RULES_FILE))
+        @rules  = yaml[:rules]
+        @config = yaml[:config]
+      else
+        raise "configuration file not found"
+      end
+    end
+    
+    def add_rule(repo, name, script, obj=nil)
+      @rules[repo] = {name => script}
+    end
+    
+    def add_exclude(dir)
+      (@config[:excludes] ||= []) << dir
+    end
+    
+    def save
+      File.open(RULES_FILE, 'w+') do |f|
+        f.write YAML.dump({}.merge(:rules => @rules).merge(:config => @config))
+      end
+    end
+    
+    def self.blank
+      {:config => {}, :rules => {}}
+    end
+
+  end
+end

data/lib/ruacce/repository.rb

@@ -0,0 +1,16 @@
+module Ruacce
+  class Repository
+  
+    attr_accessor :rules, :name
+  
+    def initialize(name)
+      @name  = name
+      @rules = Config.new.rules[name.to_sym]
+    end
+  
+    def self.repos
+      Dir['*'].select{|d| File.directory?(d) }.sort - Config.new.config[:exclude]
+    end
+  
+  end
+end

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification 
+name: madx-ruacce
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- "Fran\xC3\xA7ois Vaux"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-06-25 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: ruacce is a small tool to automate repository update. It can work with any version control system and also provides custom scripts execution.
+email: root+ruacce@yapok.org
+executables: 
+- ruacce
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/ruacce.rb
+- lib/ruacce/argv_parser.rb
+- lib/ruacce/config.rb
+- lib/ruacce/repository.rb
+- bin/ruacce
+- Rakefile
+- README
+- VERSION
+has_rdoc: false
+homepage: http://yapok.org/
+post_install_message: 
+rdoc_options: []
+
+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.2.0
+signing_key: 
+specification_version: 2
+summary: Repository Updater and Custom Command Executer
+test_files: []
+