RubyGems - ratch - Versions diffs - 0.2.2 → 0.2.3 - Mend

ratch 0.2.2 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (73) hide show

data/COPYING +674 -0
data/README +5 -5
data/bin/lt +11 -11
data/bin/ratch +3 -2
data/demo/README +1 -0
data/demo/WILMA +1 -0
data/demo/doc/rdoc/created.rid +1 -1
data/demo/doc/rdoc/files/README.html +1 -1
data/demo/doc/rdoc/files/lib/foo/foo_rb.html +1 -1
data/demo/doc/rdoc/index.html +3 -3
data/demo/p.rb +9 -0
data/demo/r.rb +6 -0
data/demo/t.rb +3 -0
data/demo/task/config.yaml +2 -0
data/demo/{util → task}/one +0 -0
data/demo/task/rdoc +88 -0
data/demo/task/rdoc-old +182 -0
data/demo/task/simplebuild +15 -0
data/demo/task/stats +6 -0
data/demo/task/task +6 -0
data/demo/{util → task}/tryme +0 -0
data/lib/ratch/argvutils.rb +57 -14
data/lib/ratch/batch.rb +73 -21
data/lib/ratch/batchable.rb +56 -26
data/lib/ratch/batchfile.rb +95 -0
data/lib/ratch/buildable.rb +117 -42
data/lib/ratch/configutils.rb +43 -13
data/lib/ratch/consoleutils.rb +76 -19
data/lib/ratch/emailutils.rb +24 -0
data/lib/ratch/facets/multiglob.rb +160 -0
data/lib/ratch/fileutils.rb +40 -8
data/lib/ratch/options.rb +43 -4
data/lib/ratch/taskable.rb +48 -12
data/{data/ratch/rubyproject → lib/ratch/toolset/ruby}/announce +0 -0
data/lib/ratch/toolset/ruby/crosstest +305 -0
data/{data/ratch/rubyproject → lib/ratch/toolset/ruby}/extest +0 -0
data/{data/ratch/rubyproject → lib/ratch/toolset/ruby}/install +0 -0
data/lib/ratch/toolset/ruby/isotest +293 -0
data/{data/ratch/rubyproject → lib/ratch/toolset/ruby}/load +0 -0
data/lib/ratch/toolset/ruby/loadtest +28 -0
data/{data/ratch/rubyproject → lib/ratch/toolset/ruby}/notes +0 -0
data/{data/ratch/rubyproject → lib/ratch/toolset/ruby}/publish +0 -0
data/lib/ratch/toolset/ruby/rdoc +88 -0
data/{data/ratch/rubyproject → lib/ratch/toolset/ruby}/setup +0 -0
data/{data/ratch/rubyproject → lib/ratch/toolset/ruby}/stats +0 -0
data/lib/ratch/toolset/ruby/syntax +29 -0
data/lib/ratch/toolset/ruby/test +26 -0
data/lib/ratch/uploadutils.rb +25 -4
data/log/history.rd +10 -0
data/log/recent.rd +8 -0
data/log/todo.rd +2 -0
data/man/ratch.man +73 -0
data/meta/MANIFEST +45 -31
data/meta/{RATCH-0.2.2.roll → ratch-0.2.3.roll} +3 -3
data/task/clobber/package +10 -0
data/task/config.yaml +4 -0
data/task/man +14 -0
data/task/publish +1 -1
data/task/rdoc +6 -0
metadata +64 -40
data/LICENSE +0 -344
data/data/ratch/rubyproject/rdoc +0 -42
data/demo/util/conf/rdoc +0 -4
data/demo/util/rdoc +0 -39
data/dev/install +0 -89
data/dev/install.0 +0 -49
data/dev/install.1 +0 -63
data/dev/ludo +0 -25
data/dev/oldtaskable.rb +0 -573
data/dev/taskable-simple.rb +0 -42
data/dev/taskable.rb +0 -120
data/lib/ratch/t.rb +0 -0
data/lib/ratch/taskutils.rb +0 -41

data/README CHANGED Viewed

@@ -5,7 +5,7 @@
 Ratch is a Ruby-based Batch file system. It provides a Ruby-based DSL
 for creating utility/task scripts. It is similar in function to build tools,
 like Make, Ant, Maven, Rake, et al. But unlike these it stears clear
-of monolithic ? and instead more closely follows the "UNIX-way".
+of monolithic design and instead more closely follows the "UNIX-way".
 == Installation
@@ -26,12 +26,12 @@ For Windows users the last line will be:
 == Usage
 Basic usage simply entails writing a script that utilizes Ratch's syntax.
+See lib/ratch/toolset/ruby for examples.
-== License
+== Copying
-Copyright (c) 2007 Thomas Sawyer (Trans)
-GPL 3 ???
+Copyright (c) 2007 T. Sawyer (Psi T. Corp)
+Ratch is distributed under the terms of the GPLv3.

data/bin/lt CHANGED Viewed

@@ -2,12 +2,12 @@
 # scan task scripts for descriptions
-def script_desc( dir )
+def script_desc(dir)
   help = {}
-  files = Dir.glob( File.join( dir, '*' ) )
+  files = Dir.glob(File.join(dir,'**/*'))
   files.each do |fname|
-    next if FileTest.directory?( fname )
-    next unless FileTest.executable?( fname )
+    next if FileTest.directory?(fname)
+    next unless FileTest.executable?(fname)
     desc = ''
     File.open(fname) do |f|
       line = ''
@@ -23,25 +23,25 @@ def script_desc( dir )
         end
       end
     end
-    help[File.basename(fname)] = desc
+    help[fname] = desc
   end
   help
 end
-def show( dir )
-  tasks = script_desc( dir )
+def show(dir)
+  tasks = script_desc(dir)
   max = tasks.keys.max{ |a,b| a.size <=> b.size }.size
   if dir == ''
     max += 4 + 2
   else
     max += dir.size + 2
   end
+  tasks = tasks.sort_by{|k,v| k }
   tasks.each do |name, sum|
-    #sum = Sake.help_summary( type )
     if dir == ''
-      cmd = "sake #{name}"
+      cmd = "ratch #{name}"
     else
-      cmd = File.join( dir.chomp('/'), name )
+      cmd = name
     end
     puts "%-#{max}s # %s" % [cmd, sum]
   end
@@ -49,7 +49,7 @@ end
 dir = ARGV[0] || '.'
-if File.directory?( dir )
+if File.directory?(dir)
   show( dir )
 else
   puts "#{dir} is not a directory"

data/bin/ratch CHANGED Viewed

@@ -2,6 +2,7 @@
 #require 'shellwords'
 require 'rbconfig'  # replace with facets/rbsystem in future ?
+#require 'ratch/batchfile'
 require 'ratch/batch'
 module Ratch
@@ -48,7 +49,7 @@ module Ratch
 end
-#load($0 = ARGV.shift)
+load($0 = ARGV.shift)
-Ratch::RatchCommand.start(ARGV.shift)
+#Ratch::RatchCommand.start(ARGV.shift)

data/demo/README CHANGED Viewed

	@@ -6,3 +6,4 @@ The Ruby Batch System
6 6
7 7	This is Foo business.
8 8
9	+

data/demo/WILMA ADDED Viewed

	@@ -0,0 +1 @@
1	+ Here

data/demo/doc/rdoc/created.rid CHANGED Viewed

	@@ -1 +1 @@
1	- Sun, 19 ~~Aug~~ 2007 08:19:45 -~~0700~~
1	+ Sun, 11 Nov 2007 10:50:18 -0500

data/demo/doc/rdoc/files/README.html CHANGED Viewed

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Tue Jul 24 12:24:03 -0700 2007</td>
+      <td>Sun Nov 11 10:49:16 -0500 2007</td>
     </tr>
     </table>
   </div>

data/demo/doc/rdoc/files/lib/foo/foo_rb.html CHANGED Viewed

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Sat Jul 28 14:20:30 -0700 2007</td>
+      <td>Sun Nov 11 10:29:00 -0500 2007</td>
     </tr>
     </table>
   </div>

data/demo/doc/rdoc/index.html CHANGED Viewed

@@ -5,12 +5,12 @@
 <!--
-    Foo
+    RDoc Documentation
   -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
-  <title>Foo</title>
+  <title>RDoc Documentation</title>
   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
 </head>
 <frameset rows="20%, 80%">
@@ -19,6 +19,6 @@
         <frame src="fr_class_index.html"  name="Classes" />
         <frame src="fr_method_index.html" name="Methods" />
     </frameset>
-    <frame src="files/README.html" name="docwin" />
+    <frame src="files/lib/foo/foo_rb.html" name="docwin" />
 </frameset>
 </html>

data/demo/p.rb ADDED Viewed

@@ -0,0 +1,9 @@
+f = Functor.new do |op,x|
+  x.send(op,x)
+end
+p f + 1
+p f + 2

data/demo/r.rb ADDED Viewed

@@ -0,0 +1,6 @@
+require 'facets/functor'
+script = File.read($0 = './t.rb')
+eval(script, binding, $0)

data/demo/t.rb ADDED Viewed

	@@ -0,0 +1,3 @@
1	+
2	+ load('./p.rb')
3	+

data/demo/task/config.yaml ADDED Viewed

	@@ -0,0 +1,2 @@
1	+
2	+

data/demo/{util → task}/one RENAMED Viewed

File without changes

data/demo/task/rdoc ADDED Viewed

@@ -0,0 +1,88 @@
+#!/usr/bin/env ratch
+# generate rdocs
+#
+# Generate Rdoc documentation. Settings are
+# the same as the rdoc command's options.
+main :rdoc do
+  config, output, input = *rdoc_configuration
+  file output => input do
+    rdoc_target(config)
+  end
+  file 'README' do
+    puts "OH YEH README"
+  end
+  build output
+end
+# Document target.
+def rdoc_target(config)
+  output = config['op']
+  input  = config.delete('include')
+  # Check for 'doc' directory.
+  # (Helps to ensure we're in the right place.)
+  #dir!(File.dirname(site))
+  # Remove old rdocs.
+  rm_r(output) if exist?(output) and safe?(output)
+  #input = input.collect{ |i| glob(i) }.flatten
+  vector = [input, config]
+  rdoc(vector.to_console)
+  insert_ads(output)
+end
+# Collect RDocs configuration.
+def rdoc_configuration
+  config = configuration['rdoc'] || {}
+  config = {
+    'template'       => 'html',
+    'op'             => 'doc/rdoc',
+    'merge'          => true,
+    'inline-source'  => true,
+    'exclude'        => [],
+    'include'        => ['lib', '[A-Z]*']
+  }.merge(config)
+  if config['output']
+    config['op'] = config.delete('output')
+  end
+  output = config['op']
+  input  = config['include'].collect do |i|
+    dir?(i) ? File.join(i,'**','*') : i
+  end
+  return config, output, input
+end
+# Insert an ad if available.
+def insert_ads(site)
+  adfile = configuration['ad_file'] || 'meta/site_ad.html'
+  return unless adfile && File.file?(adfile)
+  adtext = File.read(adfile)
+  #puts
+  dirs = Dir.glob(File.join(site,'*/'))
+  dirs.each do |dir|
+    files = Dir.glob(File.join(dir, '**/*.html'))
+    files.each do |file|
+      html = file_read(file)
+      bodi = html.index('<body>')
+      html[bodi + 7] = "\n" + adtext
+      #print "Augmenting #{file}..."
+      file_write(file, html) unless dryrun?
+      #puts "[done]"
+    end
+  end
+end

data/demo/task/rdoc-old ADDED Viewed

@@ -0,0 +1,182 @@
+#!/usr/bin/env ratch
+# generate rdocs
+#
+# Geneate RDoc documentation. This uses the rdoc config entry.
+# most entires are shodows of the argument the rdoc command
+# takes. Three execptions -- you can use 'output' instead of
+# 'op' if you prefer. You can sopecify 'chdir', from which
+# rdoc will work relative. And you can specify 'groups'.
+# Groups  allow you to document groups of files separetely.
+# Using groups, any file not part of a group will be document
+# on it's own.
+#
+# Eg.
+#
+#   rdoc:
+#     title : Foo Aop
+#     main  : README
+#     output: doc/rdoc
+#     chdir : lib
+#
+#   rdoc:
+#     doc/rdoc:
+#       title : Foo Aop
+#       main  : README
+#       chdir : lib/core
+#     doc/rdoc/aop:
+#       title : Foo Aop
+#       main  : README
+#       chdir : lib/core
+#
+#
+# You can also specify more than one rdoc process by using
+# an array of such entries.
+# Load RDoc configuration.
+rdoc_configs = configuration['rdoc']
+rdoc_configs = [configs] unless Array===configs
+targets = rdoc_configs.collect{ |config| config['output'] }
+main :rdoc => targets do
+  puts "RDoc complete."
+end
+file configuration['rdoc'] do |config|
+    if config['groups']
+      rdoc_groups(config)
+    else
+      rdoc_target(config)
+    end
+  end
+end
+#
+rdoc_configs.each do |config|
+  file config['output'] do |config|
+    if config['groups']
+      rdoc_groups(config)
+    else
+      rdoc_target(config)
+    end
+  end
+end
+# Docuement groups of targets.
+def rdoc_groups(config)
+  site = config.delete('output') || config.delete('op') || 'doc/rdoc'
+  tdir = config['chdir']
+  groups = config.delete('groups')
+  groups = TrueClass===groups ? [] : groups
+  # the rest
+  rest = []
+  chdir(tdir){rest=glob('**/*').select{|f| File.file?(f)}}
+  rest = rest - groups.flatten
+  groups.concat(rest.collect{ |r| [r] })
+  title = config['title'].to_s
+  # rdoc each group
+  groups.each do |group|
+    gf1st  = File.basename(group.first)
+    gname  = gf1st.chomp(File.extname(gf1st))
+    gsite  = File.join(site,gname)  # *
+    gtitle = "#{title} #{gname.capitalize}".strip
+    gconfig = config.merge('title' => gtitle, 'op' => gsite, 'files' => group)
+    rdoc_target(gconfig)
+  end
+end
+# Document target.
+def rdoc_target(config)
+  config = {
+    'template'       => 'html',
+    'merge'          => true,
+    'inline-source'  => true,
+    'files'          => '**/*'
+  }.merge(config)
+  site  = config.delete('output') || config.delete('op') || 'doc/rdoc'
+  tgdir = config.delete('chdir')
+  files = config.delete('files')
+  config['op'] = File.expand_path(site)
+  config['main'] = File.expand_path(config['main']) if config['main']
+  # Helps to ensure we're in the right place.
+  #dir!(File.dirname(site))
+  # Remove all old rdocs.
+  rm_r(site) if dir?(site) and safe?(site)
+  # Prepare command arguments.
+  vector = [files, config] #.flatten.compact
+  # Create Documentation.
+  cd(tgdir) do
+    rdoc(vector.to_console)
+  end
+  insert_ads(site)
+end
+# Insert ads.
+def insert_ads(site)
+  adfile = configuration['ad_file'] || 'meta/site_ad.html'
+  return unless adfile && File.file?(adfile)
+  adtext = File.read(adfile)
+  #puts
+  dirs = Dir.glob(File.join(site,'*/'))
+  dirs.each do |dir|
+    files = Dir.glob(File.join(dir, '**/*.html'))
+    files.each do |file|
+      html = file_read(file)
+      bodi = html.index('<body>')
+      html[bodi + 7] = "\n" + adtext
+      #print "Augmenting #{file}..."
+      file_write(file, html) unless dryrun?
+      #puts "[done]"
+    end
+  end
+end
+class RDocGroup
+  attr_accessor :title
+  attr_accessor :main
+  def initialize(config, group)
+    populate(config)
+    @group = group
+  end
+  def name
+    @name ||= (
+      name = File.basename(group.first)
+      name.chomp(File.extname(name))
+    )
+  end
+  def output
+    site = config.delete('output') || config.delete('op') || 'doc/rdoc'
+  end
+end