reap 6.0.0 → 6.0.1

data/ProjectInfo

@@ -0,0 +1,102 @@
+--- %YAML:1.0
+
+version  : 6.0.1
+status   : 'beta'
+
+title    : Reap
+name     : reap
+author   : Thomas Sawyer
+created  : '2004-04-01'
+email    : &email transfire@gmail.com
+homepage : "http://reap.rubyforge.org"
+
+summary  : The Flexible Ruby Project Management Assistant
+
+description: >
+  Reap comprises a set of tasks commonly needed by Ruby package
+  developers/deployers, such as testing, packaging, releasing, etc.
+  You can also use Reap to create your own custom tasks.
+  Reap utilizes a YAML configuration file to harvest common project
+  information, significantly simplifying these chores.
+
+rubyforge:
+  project  : reap
+  username : transami
+
+# not used yet
+revision:
+  type: darcs
+  exclude:
+    - 'forge'
+    - 'note'
+    - 'web/doc/api'
+    - 'web/images'
+    - 'setup.rb'
+
+rdoc: !!rdoc
+  dir: 'web/doc/api'
+  main: README
+
+package: !!package
+  distribute   : [ tar.bz2, gem, deb ] #pac
+  dependencies : [ facets ]
+  executables  : [ reap, rubytest ]
+  dir          : release
+  #source      : 'http://rubyforge.org/frs/download.php/10311/reap-6.0.1.tar.bz2'
+  exclude:
+    - release
+    - web/doc/api
+
+release: !!release
+  host         : rubyforge.org
+  username     : transami
+  project      : reap
+  groupid      : 811
+  package      : Reap
+  dir          : release
+
+publish: !!publish
+  target   : rubyforge
+  type     : web
+  host     : rubyforge.org
+  username : transami
+  dir      : web
+
+ann: !!announce
+  to       : transfire@gmail.com  # ruby-talk@ruby-lang.org
+  from     : *email
+  domain   : unit.rubyforge.org
+  server   : smtp.gmail.com
+  port     : 587
+  account  : *email # transfire@gmail.com
+  type     : login  # cram_md5, plain
+  security : tls    # ~, tls, ssl (not working yet)
+  file     : note/LATEST    # which file contains announcement
+  slogan   : REAP THE REWARDS!
+  links    : []
+
+doap: !!doap
+  dir: note
+
+count: !!count
+  include: 'lib/**/*'
+
+setup: !!setup
+
+# perm: !!perm
+#   filemod: 644
+#   dirmod: 755
+#   user: trans
+#   group: users
+
+# TESTING PURPOSES
+
+# demo: !!demo
+#   desc: Alternate description for a task
+#   message: Hello Baby!
+
+# mytask: !!custom
+#   desc: This is a test of a cutom task.
+#   task:
+#     puts "Hello Moto!"
+

data/data/reap/install.rb

@@ -0,0 +1,62 @@
+
+class String
+  def /(str)
+    File.join( self, str.to_s )
+  end
+end
+
+    # XXX use pathname
+    def self.config(name)
+      prefix = Regexp.quote(Config::CONFIG["prefix"])
+      exec_prefix = Regexp.quote(Config::CONFIG["exec_prefix"])
+      Config::CONFIG[name].gsub(/\A\/?(#{prefix}|#{exec_prefix})\/?/, '')
+    end
+
+    KINDS = [
+      :bin, :lib, :ext, :data, :conf, :doc
+    ]
+
+    SITE_DIRS = {
+      :bin  => config("bindir"),
+      :lib  => config("sitelibdir"),
+      :ext  => config("sitearchdir"),
+      :data => config("datadir"),
+      :conf => config("sysconfdir"),
+      :doc  => File.join(config("datadir"), "doc")
+    }
+
+    VEND_DIRS = {
+      :bin  => config("bindir"),
+      :lib  => config("rubylibdir"),
+      :ext  => config("archdir"),
+      :data => config("datadir"),
+      :conf => config("sysconfdir"),
+      :doc  => File.join(config("datadir"), "doc")
+    }
+
+    MODES = {
+      :bin  => 0755,
+      :lib  => 0644,
+      :ext  => 0755,  # was: 0555,
+      :data => 0644,
+      :conf => 0644,
+      :doc  => 0644
+    }
+
+    # Return installation prefix.
+    def prefix #( kind )
+      Config::CONFIG["prefix"]
+    end
+
+    # Return the installation directory.
+    def dir( kind, type=:site )
+      case type
+      when :site
+        prefix / SITE_DIRS[ kind ]
+      when :vendor
+        prefix / VEND_DIRS[ kind ]
+      else
+        raise ArgumentError, "unknown install type -- #{type}"
+      end
+    end
+

data/forge/ProjectInfo

@@ -0,0 +1,38 @@
+--- %YAML:1.0
+
+version  : 6.0.1
+status   : 'beta'
+
+title    : Reap
+name     : reap
+author   : Thomas Sawyer
+created  : '2004-04-01'
+email    : &email transfire@gmail.com
+homepage : "http://reap.rubyforge.org"
+
+summary  : The Flexible Ruby Project Management Assistant
+
+description: >
+  Reap comprises a set of tasks commonly needed by Ruby package
+  developers/deployers, such as testing, packaging, releasing, etc.
+  You can also use Reap to create your own custom tasks.
+  Reap utilizes a YAML configuration file to harvest common project
+  information, significantly simplifying these chores.
+
+rubyforge:
+  project  : reap
+  username : transami
+
+revision:
+  type: darcs
+  include:
+    - '[A-Z]*'
+    - 'trunk/*'
+    - 'web/*.html'
+  exclude:
+    - 'trunk/setup.rb'
+
+trunk: !!subinfo
+  merge: true
+  location: trunk
+

data/forge/ProjectInfo.rb

@@ -0,0 +1,76 @@
+#!/usr/bin/env ruby
+
+# This is an intersing example of a pure Ruby alternative to the
+# YAML based project file. I someway I find it more attractive 
+# than the YAML. But of course, YAML is not limited to one langauge
+# so it is much better for that.
+
+title   'Reap'
+name    'reap'
+version '4.3.4'
+date    '2006-04-07'
+created '2004-04-01'
+status  'beta/stable'
+
+author   'Thomas Sawyer'
+email    'transfire@gmail.com'
+homepage 'http://reap.rubyforge.org'
+summary  'Tools for Ruby project testing, management and assistance.'
+
+description %{
+  Reap comprises a set of commonly needed tools for Ruby package
+  developers/deployers. Because of the commonality,
+  Reap utilizes a YAML configuration file to harvest project
+  information, significantly simplifying usage.
+}
+
+distribute    [ 'gem', 'deb' ]  # zip, tar.gz, tbz, tgz, deb
+dependencies  [ 'facets' ]
+executables   [ 'reap' ]
+
+package {
+  dir         '../DISTRIBUTION'
+  distribute  [ 'deb' ]
+  exclude     [ 'dist', 'dev', 'scrap', 'web' ]
+}
+
+rubyforge {
+  project    'reap'
+  username   'transami'
+}
+
+release {
+  host       'rubyforge.org'
+  username   'transami'
+  project    'reap'
+  groupid    '811'
+  package    'Reap'
+  dir        '../DISTRIBUTION'
+}
+
+publish {
+  type       'web'
+  host       'rubyforge.org'
+  username   'transami'
+  dir        'web'
+}
+
+rdoc {
+  dir        'web/doc/api'
+  include    [ 'A-Z*', 'lib/**/*' ]
+  exclude    [ 'lib/reap/data' ]
+}
+
+anncounce {
+  to         'transfire@gmail.com'  # ruby-talk@ruby-lang.org
+  from       'transfire@gmail.com'
+  domain     'unit.rubyforge.org'
+  server     'smtp.gmail.com'
+  port       '587'
+  account    'transfire@gmail.com'
+  type       'login'  # cram_md5, plain
+  security   'tls'    # ~, tls, ssl (not working yet)
+  #file      'ANN'    # which file contains announcement
+  slogan     'REAP THE REWARDS!'
+  links      []
+}

data/forge/TODO

@@ -0,0 +1,10 @@
+
+2006-06-04:
+
+  Allow pattern amtching in tags? For exmaple
+
+    % reap rdoc-*
+
+  Would run all tasks with names starting with 'rdoc-'.
+
+

data/forge/installer.rb

@@ -0,0 +1,250 @@
+require 'rbconfig'
+require 'fileutils'
+
+module Reap
+
+  # = Installer
+  #
+  # The Installer class generates a specialized install.rb
+  # script specifically for your project. It currently 
+  # does not support c/c++ ext/ compilation.
+
+  class Installer
+
+    # Installer can not use the TaskUtils b/c it must also
+    # be able to run as a stand alone accplication.
+    #include TaskUtils
+
+#     def self.config(name)
+#       # XXX use pathname
+#       prefix = Regexp.quote(Config::CONFIG["prefix"])
+#       exec_prefix = Regexp.quote(Config::CONFIG["exec_prefix"])
+#       Config::CONFIG[name].gsub(/\A\/?(#{prefix}|#{exec_prefix})\/?/, '')
+#     end
+
+    KINDS = [
+      :bin, :lib, :ext, :data, :conf, :doc
+    ]
+
+#     SITE_DIRS = {
+#       :bin  => config("bindir"),
+#       :lib  => config("sitelibdir"),
+#       :ext  => config("sitearchdir"),
+#       :data => config("datadir"),
+#       :conf => config("sysconfdir"),
+#       :doc  => File.join(config("datadir"), "doc")
+#     }
+# 
+#     VEND_DIRS = {
+#       :bin  => config("bindir"),
+#       :lib  => config("rubylibdir"),
+#       :ext  => config("archdir"),
+#       :data => config("datadir"),
+#       :conf => config("sysconfdir"),
+#       :doc  => File.join(config("datadir"), "doc")
+#     }
+#
+#     MODES = {
+#       :bin  => 0755,
+#       :lib  => 0644,
+#       :ext  => 0755,  # was: 0555,
+#       :data => 0644,
+#       :conf => 0644,
+#       :doc  => 0644
+#     }
+
+    attr_accessor :trunk, :template, :name, :version #, :options
+
+    def initialize( options )
+      # prime attributes
+      options.each do |k,v|
+        send( "#{k}=", v ) if respond_to?("#{k}=")
+      end
+
+      @trunk = '.' unless @trunk
+      @transfer = Hash.new { |h,k| h[k] = [] }
+      @spec = parse( @template )
+    end
+
+    #--
+    # TODO use shellwords
+    #++
+    def parse( spec )
+      lines = spec.strip.split("\n")
+      lines.each { |line|
+        words = line.strip.split(/\s+/)
+        #send( *words )
+        kind, from, glob, to = *words
+        @transfer[kind.to_sym] << { :from=>vsub(from), :glob=>vsub(glob), :to=>vsub(to) }
+      }
+    end
+
+    # substitute variables
+    def vsub( str )
+      return nil if str.nil?
+      str = str.gsub( '$version', @version.to_s ) #@options[:version].to_s )
+      str = str.gsub( '$name', @name.to_s ) #options[:name].to_s )
+      str
+    end
+
+
+#     # Return the installation directory.
+#     def dir( kind, mode=:site )
+#       case mode
+#       when :site
+#         SITE_DIRS[ kind ]
+#       when :vendor
+#         VEND_DIRS[ kind ]
+#       else
+#         raise ArgumentError, "unknown mode -- #{mode}"
+#       end
+#     end
+#
+#     # Return installation prefix.
+#     def prefix #( kind )
+#       Config::CONFIG["prefix"]
+#     end
+
+
+#     #--
+#     # DSL methods for setting installation spec.
+#     #++
+# 
+#     # Setup a lib installation transfer.
+#     def lib( from, glob, to )
+#       to = '' if to == '.'
+#       @transfer[:lib] << { :from=>vsub(from), :glob=>vsub(glob), :to=>vsub(to) }
+#     end
+# 
+#     # Setup a bin installation transfer.
+#     def bin( from, glob, to=nil )
+#       #to = '' if to == '.'
+#       @transfer[:bin] << { :from=>vsub(from), :glob=>vsub(glob), :to=>vsub(to) }
+#     end
+# 
+#     # Setup a data installation transfer.
+#     def data( from, glob, to=nil )
+#       #to = '' if to == '.'
+#       @transfer[:data] << { :from=>vsub(from), :glob=>vsub(glob), :to=>vsub(to) }
+#     end
+
+    # Compile script and write to install file (install.rb).
+
+    def compile_and_write
+      #write( compile )
+      compile
+    end
+
+    alias_method :call, :compile_and_write
+
+#     def compile
+#       script = ""
+#       script << "# INSTALL SCRIPT\n"
+#       script << "# Generated by Reap\n"
+#       script << "# #{Time.now}\n"
+#       script << "\n"
+#       script << instructions
+#       script << "\n"
+#       script << "# END"
+#       script
+#     end
+
+
+  private
+
+    # Compile installation instructions.
+
+    def instructions
+        KINDS.each do |kind|
+          @transfer[kind].each { |trans|
+            package( kind, trans[:from], trans[:glob], trans[:to] )
+          }
+        end
+    end
+
+
+
+    def package( kind, from, glob, to )
+      mkdirp = []
+      #script = ''
+      Dir.chdir( @trunk ) do
+        #KINDS.each { |kind|
+          #@transfer[kind].each { |trans|
+            next unless File.directory?( from )
+            files = []
+            Dir.chdir( from ) {
+              files = Dir.glob( glob ).reject { |f| File.directory?( f ) }
+            }
+            files.each { |file|
+              f = File.join( from, file )
+              t = to ? File.join( @mirror_path, to, file ) : File.join( @mirror_path, file )
+
+              m = "mode(:#{kind})" # MODES[kind]
+
+              d = File.dirname(t)
+              unless mkdirp.include?(d)
+                #script << %{makedir :#{kind}, "%s"\n} % d
+                puts "makedir_p #{d}"
+                mkdirp << d
+              end
+
+              #script << %{install :#{kind}, "%s" => "%s"\n} % [ f, t ]
+
+              puts "safe_ln #{from}, #{to}"
+
+              #script << %{install "%s" =>\n dir(:#{kind})/"%s", :mode=>%s\n} % [ f, t, m ]
+              #script << "install_#{kind} '%s', '%s', :mode=>%o\n" % [ f, t, m ]
+            #}
+          #}
+        }
+      end
+      #script
+    end
+
+  end
+
+end #module Reap
+
+
+#     def write( script )
+#       install_file = File.join( @trunk, 'install.rb' )
+#       if File.file?( install_file )
+#         script_template = File.read( install_file )
+#         script = script_template.gsub(/\# INSTALL SCRIPT.*\# END/, script)
+# exit 0
+#         File.open( install_file, 'w+' ) do |f|
+#           f << script
+#         end
+#       end
+#     end
+
+#     # Move to install.rb script
+#     def package( kind, from, glob, to )
+#       mkdirp = []
+#       script = ''
+#       Dir.chdir( @trunk ) do
+#         @transfer[kind].each { |trans|
+#           next unless File.directory?( transfrom )
+#           files = []
+#           Dir.chdir( from ) {
+#             files = Dir.glob( trans[:glob] ).reject { |f| File.directory?( f ) }
+#           }
+#           files.each { |file|
+#             f = File.join( trans[:from], file )
+#             #t = File.join( prefix(kind), dir(kind), trans[:to], file )
+#             t = trans[:to] ? File.join( trans[:to], file ) : file
+#             m = "mode(:#{kind})" # MODES[kind]
+#             d = File.dirname(t)
+#             unless mkdirp.include?(d)
+#               script << %{makedir :#{kind}, "%s"\n} % d
+#               mkdirp << d
+#             end
+#             script << %{install :#{kind}, "%s" => "%s"\n} % [ f, t ]
+#             #script << %{install "%s" =>\n dir(:#{kind})/"%s", :mode=>%s\n} % [ f, t, m ]
+#             #script << "install_#{kind} '%s', '%s', :mode=>%o\n" % [ f, t, m ]
+#           }
+#         }
+#       end
+#       script
+#     end
+

data/forge/reference/Rakefile

@@ -0,0 +1,124 @@
+#!/usr/bin/env ruby rake
+# Rakefile for Calibre
+
+require 'rake/rdoctask'
+
+desc "Run all the tests"
+task :default => [:test]
+
+
+# tests
+
+desc "Run all tests"
+task :test => [:"test-facets", :"test-carats"]
+
+desc "Run tests for Ruby Facets"
+Rake::TestTask.new(:"test-facets") do |t|
+  t.libs << "packages/facets/lib"
+  t.test_files = FileList['packages/facets/test/**/tc*.rb']
+  t.verbose = true
+end
+
+desc "Run tests for Ruby Carats"
+Rake::TestTask.new(:"test-carats") do |t|
+  t.libs << "packages/carats/lib"
+  t.test_files = FileList['packages/carats/test/**/tc*.rb']
+  t.verbose = true
+end
+
+
+# rdocs
+
+desc "Generate All RDoc documentation"
+task :rdoc => [:"rdoc-facets", :"rdoc-carats"]
+
+desc "Generate RDoc documentation for Facets"
+Rake::RDocTask.new(:"rdoc-facets") do |rd|
+  cdir = Dir.pwd
+  Dir.chdir 'packages/facets'
+    rd.main = 'README'
+    rd.template = 'html'
+    rd.rdoc_dir = 'pub/facet/doc'
+    rd.rdoc_files.include('README', 'LIC*', 'lib/facet/')
+    rd.rdoc_files.exclude 'InstalledFiles'
+    rd.options << '--promiscuous --merge --all'
+  Dir.chdir(cdir)
+end
+
+desc "Generate RDoc documentation for Carats"
+Rake::RDocTask.new(:"carat-doc") do |rd|
+  cdir = Dir.pwd
+  Dir.chdir 'packages/carats'
+    rd.main = 'README'
+    rd.template = 'html'
+    rd.rdoc_dir = 'doc'
+    rd.rdoc_files.include('README', 'LIC*', 'lib/carat/')
+    rd.rdoc_files.exclude 'InstalledFiles'
+    rd.options << '--promiscuous --merge --all'
+  Dir.chdir(cdir)
+end
+
+# web publish
+
+desc "Publish Rubyforge Website"
+task :webpub do
+  rubyforge_project = 'calibre'
+  username = 'transami'
+  web_dir = 'pub/www'
+  # do it
+  current_dir = Dir.pwd
+  Dir.chdir( web_dir )
+  web_files = FileList.new
+  web_files.include('**/*')
+  web_files = '"' << web_files.join('" "') << '"'
+  cmd = "scp #{web_files} #{username}@rubyforge.org:/var/www/gforge-projects/#{rubyforge_project}/"
+  system cmd
+  Dir.chdir( current_dir )
+end
+
+
+#desc "Do predistribution stuff"
+#task :predist => [:changelog, :doc]
+
+
+
+desc "Make an archive as .tar.gz"
+task :dist => :test do
+  system "export DARCS_REPO=#{File.expand_path "."}; " +
+         "darcs dist -d rand#{get_darcs_tree_version}"
+end
+
+desc "Generate a ChangeLog"
+task :changelog do
+  system "darcs changes --repo=#{ENV["DARCS_REPO"] || "."} >ChangeLog"
+end
+
+
+# --- Helper Methods ---
+
+# Helper to retrieve the "revision number" of the darcs tree.
+def get_darcs_tree_version
+
+  return ""  unless File.directory? "_darcs"
+
+  changes = `darcs changes`
+  count = 0
+  tag = "0.0"
+  
+  changes.each("\n\n") { |change|
+    head, title, desc = change.split("\n", 3)
+    
+    if title =~ /^  \*/
+      # Normal change.
+      count += 1
+    elsif title =~ /tagged (.*)/
+      # Tag.  We look for these.
+      tag = $1
+      break
+    else
+      warn "Unparsable change: #{change}"
+    end
+  }
+
+  "-" + tag + "." + count.to_s
+end