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

ratch 0.2.3 → 0.3.0

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 (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

data/demo/doc/rdoc/created.rid DELETED

	@@ -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