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

ratch 0.2.3 → 0.3.0

Files changed (129) hide show

data/bin/ratch +60 -47
data/bin/ratch-find +21 -0
data/demo/{README → XR} +0 -0
data/demo/task/stats +0 -2
data/doc/images/clipboard.jpg +0 -0
data/doc/images/clipboard2.png +0 -0
data/doc/images/milles-tn.jpg +0 -0
data/doc/images/mints.png +0 -0
data/doc/images/ratch2.png +0 -0
data/doc/images/ruby-sm.png +0 -0
data/doc/images/silver.gif +0 -0
data/doc/images/toolbox.jpg +0 -0
data/doc/index.html +181 -0
data/doc/notes/original.rb +308 -0
data/doc/rdoc/classes/Array.html +194 -0
data/doc/rdoc/classes/Dir.html +317 -0
data/doc/rdoc/classes/Hash.html +217 -0
data/doc/rdoc/classes/Ratch.html +201 -0
data/doc/rdoc/classes/Ratch/ArgvUtils.html +173 -0
data/doc/rdoc/classes/Ratch/ArgvUtils/Ext.html +285 -0
data/doc/rdoc/classes/Ratch/BatchFile.html +207 -0
data/doc/rdoc/classes/Ratch/BatchManager.html +250 -0
data/doc/rdoc/classes/Ratch/BatchScript.html +127 -0
data/doc/rdoc/classes/Ratch/Batchable.html +373 -0
data/doc/rdoc/classes/Ratch/Build.html +321 -0
data/doc/rdoc/classes/Ratch/BuildManager.html +319 -0
data/doc/rdoc/classes/Ratch/Buildable.html +202 -0
data/doc/rdoc/classes/Ratch/ConfigUtils.html +281 -0
data/doc/rdoc/classes/Ratch/ConsoleUtils.html +189 -0
data/doc/rdoc/classes/Ratch/EmailUtils.html +209 -0
data/doc/rdoc/classes/Ratch/FileUtils.html +674 -0
data/doc/rdoc/classes/Ratch/GeneralOptions.html +430 -0
data/doc/rdoc/classes/Ratch/Task.html +201 -0
data/doc/rdoc/classes/Ratch/TaskManager.html +330 -0
data/doc/rdoc/classes/Ratch/Taskable.html +231 -0
data/doc/rdoc/classes/Ratch/UploadUtils.html +566 -0
data/doc/rdoc/created.rid +1 -0
data/doc/rdoc/files/COPYING.html +1003 -0
data/{demo/doc → doc}/rdoc/files/README.html +36 -5
data/doc/rdoc/files/lib/ratch/argvutils_rb.html +131 -0
data/doc/rdoc/files/lib/ratch/batch_rb.html +155 -0
data/doc/rdoc/files/lib/ratch/batchable_rb.html +131 -0
data/doc/rdoc/files/lib/ratch/batchfile_rb.html +148 -0
data/doc/rdoc/files/lib/ratch/buildable_rb.html +131 -0
data/doc/rdoc/files/lib/ratch/consoleutils_rb.html +131 -0
data/{demo/doc/rdoc/files/lib/foo/foo_rb.html → doc/rdoc/files/lib/ratch/emailutils_rb.html} +35 -41
data/doc/rdoc/files/lib/ratch/facets/multiglob_rb.html +137 -0
data/doc/rdoc/files/lib/ratch/fileutils_rb.html +139 -0
data/doc/rdoc/files/lib/ratch/options_rb.html +131 -0
data/doc/rdoc/files/lib/ratch/taskable_rb.html +131 -0
data/doc/rdoc/files/lib/ratch/uploadutils_rb.html +150 -0
data/doc/rdoc/fr_class_index.html +48 -0
data/doc/rdoc/fr_file_index.html +41 -0
data/doc/rdoc/fr_method_index.html +133 -0
data/{demo/doc → doc}/rdoc/index.html +1 -1
data/{demo/doc → doc}/rdoc/rdoc-style.css +0 -0
data/doc/scrap/flexihead-flip.jpg +0 -0
data/doc/scrap/flexihead.jpg +0 -0
data/doc/scrap/head1.jpg +0 -0
data/doc/scrap/ratch.jpg +0 -0
data/doc/scrap/ratch1.png +0 -0
data/doc/scrap/ratch2.jpg +0 -0
data/doc/scrap/ratch3.png +0 -0
data/doc/scrap/red-ratch.jpg +0 -0
data/doc/scrap/redratchet.jpg +0 -0
data/doc/scrap/ruby-kit/ruby.png +0 -0
data/doc/scrap/scrap.red +256 -0
data/doc/sitemap.yaml +10 -0
data/doc/siteparts/index.red +100 -0
data/doc/siteparts/layout.rhtml +56 -0
data/doc/siteparts/tutorial.red +578 -0
data/doc/style.css +112 -0
data/doc/tutorial.html +722 -0
data/lib/ratch/batch.rb +417 -30
data/lib/ratch/{argvutils.rb → batch/argvutils.rb} +27 -19
data/lib/ratch/batch/build.rb +95 -0
data/lib/ratch/{consoleutils.rb → batch/consoleutils.rb} +0 -0
data/lib/ratch/{emailutils.rb → batch/emailutils.rb} +0 -0
data/lib/ratch/{fileutils.rb → batch/fileutils.rb} +32 -32
data/lib/ratch/{options.rb → batch/options.rb} +0 -0
data/lib/ratch/batch/task.rb +43 -0
data/lib/ratch/manager.rb +34 -0
data/lib/ratch/project/information.rb +257 -0
data/lib/ratch/project/package.rb +82 -0
data/lib/ratch/project/project.rb +531 -0
data/lib/ratch/project/release.rb +112 -0
data/lib/ratch/support/filetest.rb +29 -0
data/lib/ratch/support/setuputils.rb +124 -0
data/lib/ratch/support/signiture.rb +252 -0
data/lib/ratch/support/stage.rb +292 -0
data/lib/ratch/toolset/ruby/pack/gem +85 -0
data/lib/ratch/toolset/ruby/pack/tgz +85 -0
data/lib/ratch/toolset/ruby/{crosstest → test/crosstest} +0 -0
data/lib/ratch/toolset/ruby/{extest → test/extest} +0 -0
data/lib/ratch/toolset/ruby/{isotest → test/isotest} +0 -0
data/lib/ratch/toolset/ruby/{load → test/load} +0 -0
data/lib/ratch/toolset/ruby/{loadtest → test/loadtest} +0 -0
data/lib/ratch/toolset/ruby/{syntax → test/syntax} +0 -0
data/lib/ratch/toolset/ruby/{test → test/test} +0 -0
data/log/{history.rd → history} +6 -0
data/log/{todo.rd → todo} +0 -0
data/meta/MANIFEST +52 -36
data/meta/ROLLRC +2 -0
data/meta/icli.yaml +16 -0
data/meta/{ratch-0.2.3.roll → project.yaml} +1 -7
data/task/release +12 -0
data/{lib/ratch → work/old}/batchfile.rb +0 -0
data/work/project-old.rb +67 -0
data/work/scrap/install +89 -0
data/work/scrap/install.0 +49 -0
data/work/scrap/install.1 +63 -0
data/work/scrap/ludo +25 -0
data/work/scrap/oldtaskable.rb +573 -0
data/work/scrap/ratch.man +39 -0
data/work/scrap/taskable-simple.rb +42 -0
data/work/scrap/taskable.rb +120 -0
metadata +170 -72
data/demo/doc/rdoc/created.rid +0 -1
data/demo/doc/rdoc/fr_class_index.html +0 -26
data/demo/doc/rdoc/fr_file_index.html +0 -28
data/demo/doc/rdoc/fr_method_index.html +0 -27
data/demo/task/config.yaml +0 -2
data/lib/ratch/batchable.rb +0 -169
data/lib/ratch/buildable.rb +0 -182
data/lib/ratch/configutils.rb +0 -132
data/lib/ratch/facets/multiglob.rb +0 -160
data/lib/ratch/taskable.rb +0 -152
data/log/recent.rd +0 -8
data/task/config.yaml +0 -10

	@@ -1 +0,0 @@
1	- Sun, 11 Nov 2007 10:50:18 -0500

data/demo/doc/rdoc/fr_class_index.html DELETED

@@ -1,26 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!--
-    Classes
-  -->
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>Classes</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <link rel="stylesheet" href="rdoc-style.css" type="text/css" />
-  <base target="docwin" />
-</head>
-<body>
-<div id="index">
-  <h1 class="section-bar">Classes</h1>
-  <div id="index-entries">
-  </div>
-</div>
-</body>
-</html>

data/demo/doc/rdoc/fr_file_index.html DELETED

@@ -1,28 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!--
-    Files
-  -->
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>Files</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <link rel="stylesheet" href="rdoc-style.css" type="text/css" />
-  <base target="docwin" />
-</head>
-<body>
-<div id="index">
-  <h1 class="section-bar">Files</h1>
-  <div id="index-entries">
-    <a href="files/README.html">README</a><br />
-    <a href="files/lib/foo/foo_rb.html">lib/foo/foo.rb</a><br />
-  </div>
-</div>
-</body>
-</html>

data/demo/doc/rdoc/fr_method_index.html DELETED

@@ -1,27 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!--
-    Methods
-  -->
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
-<head>
-  <title>Methods</title>
-  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-  <link rel="stylesheet" href="rdoc-style.css" type="text/css" />
-  <base target="docwin" />
-</head>
-<body>
-<div id="index">
-  <h1 class="section-bar">Methods</h1>
-  <div id="index-entries">
-    <a href="files/lib/foo/foo_rb.html#M000001">hello (lib/foo/foo.rb)</a><br />
-  </div>
-</div>
-</body>
-</html>

data/demo/task/config.yaml DELETED

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

data/lib/ratch/batchable.rb DELETED

@@ -1,169 +0,0 @@
-# TITLE:
-#
-#   Batchable
-#
-# COPYING:
-#
-#   Copyright (c) 2007 Psi T Corp.
-#
-#   This file is part of the ProUtils' Ratch program.
-#
-#   Ratch is free software: you can redistribute it and/or modify
-#   it under the terms of the GNU General Public License as published by
-#   the Free Software Foundation, either version 3 of the License, or
-#   (at your option) any later version.
-#
-#   Ratch is distributed in the hope that it will be useful,
-#   but WITHOUT ANY WARRANTY; without even the implied warranty of
-#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-#   GNU General Public License for more details.
-#
-#   You should have received a copy of the GNU General Public License
-#   along with Ratch.  If not, see <http://www.gnu.org/licenses/>.
-module Ratch
-  class BatchManager
-    # Task cache, which prevents batch runs from re-executing.
-    attr :cache
-    # New BatchManager.
-    def initialize(runspace)
-      @runspace = runspace
-      @cache = {}
-    end
-    #
-    def batch(batchfile, arguments=nil)
-      @cache[batchfile] ||= run(batchfile, arguments)
-    end
-    # Run a batch file.
-    # TODO: How to handle arguments?
-    def run(batchfile, arguments=nil)
-      # # TODO probably should raise error instead
-      # abort "missing batch file -- #{batchfile}" unless File.file?(batchfile)
-      #BatchFile.new(batchfile).call # Old way with batch execution context object.
-      script = File.read($0 = batchfile)
-      eval(script, $batch_binding, $0)
-    end
-    #
-    def done?(batchfile)
-      batchfile == $0 or @cache.key?(batchfile)
-    end
-  end
-  #
-  module Batchable
-    # Reference batch manager.
-    def batch_manager
-      @batch_manager ||= BatchManager.new(self)
-    end
-    # Batch run, ie. run and cache.
-    # Usually this can be take care of by method_missing.
-    # But, in some cases, built in method names block task
-    # calls, so you have to use #batch to invoke those.
-    def batch(batchfile, arguments=nil)
-      batch_manager.batch(batchfile, arguments=nil)  # why did I have task instead of batchfile before?
-    end
-    # Lauch a batch file (non-cached)
-    def launch(batchfile, arguments=nil)
-      batch_manager.run(batchfile, arguments=nil)
-    end
-    # Is a batch run complete or in the process of being completed?
-    def done?(batchfile)
-      batch_manager.done?(batchfile)
-    end
-    # Shell runner.
-    # TODO Does this belong here?
-    def sh(cmd)
-      if noharm?
-        puts cmd
-        true
-      else
-        puts "--> system call: #{cmd}" if trace?
-        system(cmd)
-      end
-    end
-    # Is a file a local batch file?
-    def batch?(path)
-      b = File.dirname($0) + "/#{path}"
-      b.chomp!('!')
-      b if FileTest.file?(b) && FileTest.executable?(b)
-    end
-    # Abort running.
-    #def abort(msg=nil)
-    #  puts msg if msg
-    #  exit 0
-    #end
-    # If method is missing try to run an external task
-    # or binary by that name. If it is a binary, arguments
-    # translate into commandline parameters. For example:
-    #
-    #   tar 'foo/', :x=>true, :v=>true, :z=>true, :f=>'foo.tar.gz'
-    #
-    # or
-    #
-    #   tar '-xvzf', "foo.tar.gz", "foo/"
-    #
-    # becomes
-    #
-    #   tar -x -v -z -f foo.tar.gz foo/
-    #
-    # If it is a task, it will be cached. Tasks only ever run once.
-    # To run them more than once you can manually execute them with #run.
-    # Likewise you can manually run and cache by calling #batch.
-    # This is good to know, b/c in some cases built in method names
-    # block task calls, so you have to #batch to invoke them.
-    def method_missing(sym,*args)
-      puts "method_missing: #{sym}" if debug?
-      name = sym.to_s
-      bat   = batch?(name)
-      done  = bat && done?(bat)
-      cache = bat && !done && name[1,-1] != '!'
-      bin   = bin?(name) if (!bat || done)
-      none  = bat && done && !bin
-      #bat  = name if bin
-      return super unless bat || bin
-      return if none  # nothing to do
-      params = args.to_params
-      if bin
-        cmd = "#{File.basename(bin)} #{params}"
-        res = sh(cmd)
-      elsif bat
-        cmd = "./#{bat} #{params}"
-        puts "--> #{cache ? '' : 'not-'}cached execution: #{cmd}" if trace?
-        res = batch(bat, args)
-        if cache
-          #@batch_catch[bat] ||= (system(cmd); true)
-          #batch_cache[bat] ||= res
-          batch_manager.cache ||= res
-        end
-      end
-      return res
-    end
-  end
-end

data/lib/ratch/buildable.rb DELETED

@@ -1,182 +0,0 @@
-# TITLE:
-#
-#   Buildable
-#
-# COPYING:
-#
-#   Copyright (c) 2007 Psi T Corp.
-#
-#   This file is part of the ProUtils' Ratch program.
-#
-#   Ratch is free software: you can redistribute it and/or modify
-#   it under the terms of the GNU General Public License as published by
-#   the Free Software Foundation, either version 3 of the License, or
-#   (at your option) any later version.
-#
-#   Ratch is distributed in the hope that it will be useful,
-#   but WITHOUT ANY WARRANTY; without even the implied warranty of
-#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-#   GNU General Public License for more details.
-#
-#   You should have received a copy of the GNU General Public License
-#   along with Ratch.  If not, see <http://www.gnu.org/licenses/>.
-module Ratch
-  # = Buildable mixin
-  #
-  module Buildable
-    # Reference task manager.
-    def build_manager
-      @build_manager ||= BuildManager.new(self)
-    end
-    # Define a build target.
-    def file(name, &block)
-      name, deps, block = *parse_build_dependencies(name, &block)
-      build_manager.define_file(name, *deps, &block)
-    end
-    # Build a file.
-    def build(file)
-      build_manager.call(file)
-    end
-    private
-      #
-      def parse_build_dependencies(name_deps, &block)
-        if Hash===name_deps
-          name = name_deps.keys[0]
-          deps = name_deps.values[0]
-        else
-          name = name_deps
-          deps = []
-        end
-        [name, deps, block]
-      end
-  end
-  # = BuildManager class
-  #
-  class BuildManager
-    attr :builds
-    def initialize(runspace)
-      @runspace = runspace
-      @builds = []
-    end
-    def force? ; @runspace.force? ; end
-    # Define a file build task.
-    def define_file(name, *depend, &block)
-      build = Build.new(name, *depend, &block)
-      builds << build
-    end
-    # Call build.
-    def call(path)
-      # TODO How to handle more than one matching means of building?
-      #warn "More than one build definition matches #{path} using #{means.first}" if means.size > 1
-      if build = find(path)
-        if build.needed_for?(path) || force?
-          list, todo = *plan(build, path)
-          todo.each{|bld, pth| bld.call(pth) } #@builds[name].call }
-          build.call(path)
-        end
-      else
-        raise
-      end
-    end
-    def find(path)
-      builds.find{ |b| b.match?(path) }
-    end
-    # Prepare plan, checking for circular dependencies.
-    def plan(build, path, list=[], todo=[])
-      #if list.include?(build)
-      #  raise "Circular build dependency #{build.name}."
-      #end
-      build.needed_paths.each do |npath|
-        next if list.include?(npath)
-        if nbuild = find(npath)
-          plan(nbuild, npath, list, todo)
-          todo << [nbuild, npath]
-        else
-          list << npath
-        end
-      end
-      return list, todo
-    end
-  end
-  # = Build class
-  #
-  class Build
-    attr :match
-    attr :needs
-    attr :action
-    alias_method :name, :match
-    # Create a new build definition.
-    def initialize(match, *needs, &action)
-      @match         = match
-      @needs         = needs
-      @action        = action
-    end
-    # Call this build process for the given path.
-    def call(path)
-      if File.exist?(path)
-        mtime = File.mtime(path)
-        dated = needs.find do |file|
-          !File.exist?(file) || File.mtime(file) > mtime
-        end
-      else
-        dated = true
-      end
-      action.call(path) if dated
-    end
-    # Does a file match this build definition?
-    def match?(path)
-      case match
-      when String
-        File.fnmatch(match, path)
-      when Regexp
-        match =~ path
-      else
-        false        # ???
-      end
-    end
-    # Is this build needed to update/create path?
-    def needed_for?(path)
-      return true unless File.exist?(path)
-      mtimes = needed_paths.collect{|f| File.mtime(f)}
-      mtimes.max > File.mtime(path)
-    end
-    # Glob expanded needs.
-    def needed_paths
-      #exact = needs.select{|n| File.fnmatch?(n,n)} +
-      exact = needs.select{|n| n !~ /[\[*?]/ }
-      globs = needs.collect{|n| Dir.glob(n)}.flatten
-      (exact + globs).uniq
-    end
-  end
-end

data/lib/ratch/configutils.rb DELETED

@@ -1,132 +0,0 @@
-# TITLE:
-#
-#   ConfigUtils
-#
-# COPYING:
-#
-#   Copyright (c) 2007 Psi T Corp.
-#
-#   This file is part of the ProUtils' Ratch program.
-#
-#   Ratch is free software: you can redistribute it and/or modify
-#   it under the terms of the GNU General Public License as published by
-#   the Free Software Foundation, either version 3 of the License, or
-#   (at your option) any later version.
-#
-#   Ratch is distributed in the hope that it will be useful,
-#   but WITHOUT ANY WARRANTY; without even the implied warranty of
-#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-#   GNU General Public License for more details.
-#
-#   You should have received a copy of the GNU General Public License
-#   along with Ratch.  If not, see <http://www.gnu.org/licenses/>.
-module Ratch
-  module ConfigUtils
-    #DEFAULT_CONFIG_FILE = '{config, config/general}'
-    # Load configuration data from a file. The file will
-    # be looked for in the current script directory then
-    # from the project root.
-    #
-    # Since they are YAML files, they can optionally
-    # end with '.yaml' or '.yml'.
-    def configuration(file=nil)
-      @configuration ||= {}
-      @configuration[file] ||= (
-        if file = config_file(file)
-          config_read(file)
-        else
-          Hash.new{ |h,k| h[k] = {} }
-        end
-     )
-    end
-    # If a +path+ is given it will first be looked for in the config directory of
-    # the utility directory. If not there, then it will be looked for in the project's trunk.
-    #
-    # If +path+ is not given then config.yaml or config/general.yaml will be used.
-    def config_file(path=nil)
-      if path
-        find = "{#{utility_directory}/config/,}#{path}{.yaml,.yml,}"
-      else
-        #path = DEFAULT_CONFIG_FILE
-        find = "{#{utility_directory}/config,#{utility_directory}/config/general}{.yaml,.yml,}"
-      end
-      file = Dir.glob(find).find{ |f| File.file?(f) }
-      return file
-    end
-    #
-    def config_read(path)
-      #find = "{#{utility_directory}/,}#{path}{.yaml,.yml,}"
-      #if file = Dir.glob(find)[0]
-      if File.file?(path)
-        YAML::load(File.open(path)) || {}  # The || {} is in case the file is empty.
-      else
-        raise LoadError, "Missing file -- #{path}"
-      end
-    end
-    # TODO Better name? Better definition? (Won't handle task subdirs!).
-    def utility_directory
-      File.dirname($0)
-    end
-    # Create an argument vector from a set of config options.
-    # TODO Deprecate in favor of Hash extension.
-    def config_vector(config, args_field=nil)
-      config.command_vector(args_field)
-    end
-#     # FIXME ProjectInfo, if available.
-#
-#     def projectinfo
-#       require 'box/project'
-#       @projectinfo
-#
-#       #begin
-#       #  @projectinfo = ProjectInfo.open
-#       #rescue LoadError
-#       #  @projectinfo = nil
-#       #end
-#     end
-#     def config_file
-#       @config_file ||= (
-#         dir  = utility_directory
-#         name = Dir.basename(dir)
-#         Dir.glob("{#{dir},meta,info,}/{#{name},config}{.yaml,.yml}")
-#       )
-#     end
-#     # Load task configuration if any.
-#
-#     def config_load(*names) #, defaults=nil)
-#
-#       names.inject({}) do |memo, name|
-#         name     = name.to_s
-#         #defaults = defaults || {}
-#
-#         if file = config_file(name)
-#           config = YAML.load(File.open(file))
-#         elsif file = Dir.glob("#{utility_directory}/config{,.yaml,.yml}")[0]
-#           config = YAML.load(File.open(file))[name.to_s]
-#         else
-#           config = {}
-#         end
-#
-#         config.update(memo)
-#       end
-#       #return defaults.update(config || {})
-#     end
-  end
-end