reap 5.0.0 → 5.10.10

data/ANN

@@ -0,0 +1,3 @@
+
+This is a test.
+

data/COPYING

@@ -0,0 +1,11 @@
+= BUTTERED PANCAKES LICENSE
+
+The following stipulations:
+
+  1) Butter my panakes
+  2) Don't feed the lawyers
+
+Which means:
+ 
+  1) Acknowledge arthor and sources
+  2) Don't sue any one over it

data/ChangeLog

@@ -0,0 +1,25 @@
+
+= Reap ChangeLog
+
+== 04
+
+* Killed the Rake idea. Now a fully independent project,
+  and better than before.
+
+== 03
+
+* Major overhaul. Reap is no longer an independent project.
+  Rather, it is now an extension of Rake. All Reap tasks are
+  now a subclass of Rake::TaskLib.
+
+== 02
+
+* Improved test task. Each test now runs in its own process.
+  Output is summarized and in YAML.
+* Improved configuration loading a bit.
+* Wrote some basic docs on how to write a Reap task.
+* Adjusted for Nano upgrade (was Facets).
+
+== 01
+
+* Alpha Development

data/ProjectInfo

@@ -1,90 +1,65 @@
 --- %YAML:1.0
 
-title    : Reap
-name     : reap
-version  : '5.0.0'
-status   : 'beta/stable'
-created  : '2004-04-01'
+TITLE    : Reap
+NAME     : reap
+DATE     : '2005-10-10'
+SERIES   : '4.0'
+STATUS   : 'beta/stable'
 
-author   : Thomas Sawyer
-email    : &email transfire@gmail.com
-homepage : "http://reap.rubyforge.org"
-summary  : The Flexible Ruby Project Management Assistant
+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 tasks commonly need ber Ruby package
-  developers/deployers, such as testing, packaging, releasing, etc.
-  You can also use Reap to create your own custom tasks.
+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 these chores.
+  information, significantly simplifying usage.
 
-rubyforge:
-  project  : reap
-  username : transami
-
-install: !!install
+DISTRIBUTE   : [ gem, tar.bz2, zip ]  # tar.gz, tbz, tgz
+DEPENDENCIES : [ facets ]
+EXECUTABLES  : [ reap ]
 
-package: !!package
-  distribute   : [ gem, tar.bz2 ]  # zip, tar.gz, tbz, tgz, gem, deb
-  dependencies : [ facets ]
-  executables  : [ reap, rubytest ]
-  dir: '../DISTRIBUTION'
-  exclude:
-    - dist
-    - dev
-    - scrap
-    - web
+RUBYFORGE:
+  PROJECT: reap
+  USERNAME: transami
 
-release: !!release
-  host       : rubyforge.org
-  username   : transami
-  project    : reap
-  groupid    : 811
-  package    : Reap
-  dir        : '../DISTRIBUTION'
-
-publish: !!publish
-  target   : rubyforge
+PUBLISH:
   type     : web
   host     : rubyforge.org
   username : transami
   dir      : web
 
-rdoc: !!rdoc
-  dir: 'web/doc/api'
-  main: 'doc/README'
-#  include:
-#    - 'A-Z*'
-#    - 'lib/**/*'
+RDOC:
+  dir: 'web/rdoc'
+  include:
+    - 'A-Z*'
+    - 'lib/**/*'
+  exclude:
+    - 'lib/reap/data'
 
-announce: !!announce
+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     : doc/LATEST    # which file contains announcement
+  authtype : login  # cram_md5, plain
+  sectype  : tls    # ~, tls, ssl (not working yet)
+  file     : ANN    # which file contains announcement
   slogan   : REAP THE REWARDS!
-  links    : []
+  links    :
+    - http://reap.rubyforge.org
+    - http://roll.rubyforge.org
 
-# perm: !!perm
-#   filemod: 644
-#   dirmod: 755
-#   user: trans
-#   group: users
+PERM:
+  filemod: 644
+  dirmod: 755
+  user: trans
+  group: users
 
-# noop1: !!noop
-#   message: Hello Dude!
-#
-# noop2: !!noop
-#   desc: Alternate description for a task
-#   message: Hello Baby!
-#
-# mytask: !!custom
-#   desc: This is a test of a cutom task.
-#   task:
-#     puts "Hello Moto!"
+NOOP:
+  MESSAGE: Hello Dude!
 

data/README

@@ -0,0 +1,125 @@
+= Reap
+
+User Friendly Project Assitant for Ruby
+
+== What's This?
+
+Reap is a user friendly project assistant for Ruby developers.
+By organizing your project in a conventional manner, 
+as promoted by setup.rb, Reap makes it easy to do the
+following tasks:
+
+* Generate RDocs.
+* Run unit tests.
+* Extract tests for scripts.
+* Create Ruby Gem packages.
+* Create standard .tgz, tbz (bzip2) and/or .zip packages.
+* Publish documents to Rubyforge or other web sites.
+* Announce a release to Ruby-talk or other mailing list.
+* Prepare files for distribution (i.e. chmod, tag, etc.).
+* Upload packages (coming soon!).
+
+If you have special needs that Reap doesn't accomodate,
+new task are farily easy to create. And I am always
+happy to hear suggestions.
+
+== Installation
+
+=== Gem Install
+
+Install the ruby gem as you would any other:
+
+  <tt>gem install reap</tt>
+
+Reap requires Ruby Facets.
+
+=== Manual Install
+
+To install manually follow the usual setup.eb steps:
+
+1. Download the compressed package.
+2. Unpack it.
+3. Change into the unpacked directory.
+4. run <tt>sudo ruby setup.rb</tt>
+
+You should be good to go.
+
+== Usage
+
+=== Using a Reap Task
+
+Reap makes it pretty easy to use it's built-in tasks.
+Largely this is because it grabs common data from a ProjectInfo
+(or Reapfile) as available. Some Reap tasks are
+automatic b/c there are reasonable defaults, others
+_require_ entries in the ProjectInfo file.
+
+For instance, to create a "package" target you generally do not need
+an entry in the ProjectInfo file. Reap will package up everything
+in the typical directories and makes compressed versions in the
+common formats. It will then place those in either ../leaf/
+(for those or you using trunk/ branches/ layouts) or pkg/ otherwise.
+The same holds for other tasks. Reap will do it's best to extrapolate
+the needed information from the ProjectInfo file.
+
+Of course no matter the level of content, you will of course need to
+create this file in you projects main directory. A template is provided
+and a command line tool to copy it to your current directory. Simply type:
+
+  > reap template
+
+Then edit the ProjectInfo file. The fields are fairly self
+explanitiory. Apart from Reap such a file is nice to have just on
+it's own merits too.
+
+=== Building a Reap Task
+
+Building a Reap task differs from building a Rake task
+by two important factors. First there is only one target
+per task (this may change) Second, task blocks are yeilded
+_prior_ to the #init routine being exectuted. So your #init
+routine should expect data to already be present in
+the tasks attribute and take that into account (usually that
+means using ++||=++)
+
+Here's an, oh so simple, example:
+
+  class OhSoSimple < Reap::Task
+
+     task_desc 'This is a custom reap task'
+
+     attr_accessor :message
+
+     def init
+       @message ||= master['default'] || 'None Found!'
+       @another ||= section['another'] || 'Again!'
+     end
+
+     # run the target task
+     def run
+       puts @message + "\n" + @another
+     end
+
+   end
+
+The corresponding settings in the ProjectInfo file (master) will then be:
+
+   default: Default text, if any.
+   ohsosimple:
+     another: Your other message here.
+
+And to use it
+
+  > reap ohsosimple
+
+== Status
+
+Reap is currently Usable Beta. Most of the tasks
+work very well. Refinements are still common though,
+and a few important tasks are still being planned.
+
+== Legal
+
+Reap
+Copyright(c)2004-2005 Thomas Sawyer
+Ruby License

data/Rakefile

@@ -1,10 +0,0 @@
-require 'rake'
-require 'reap/rake'
-
-task :default => [:tasks]
-
-task :tasks do
-  Rake.application.options.show_task_pattern = //
-  Rake.application.display_tasks_and_comments
-end
-

data/bin/reap

@@ -1,6 +1,5 @@
-#! /usr/bin/ruby1.8
+#!/usr/bin/env ruby
 
-require 'reap/bin/reap.rb'
-
-ReapCommand.new.execute
+require 'reap/bin/reap'
 
+ReapCommand.new.go

data/data/reap/scaffold/COPYING

@@ -0,0 +1,11 @@
+= BUTTERED PANCAKES LICENSE
+
+The following stipulations:
+
+  1) Butter my panakes
+  2) Don't feed the lawyers
+
+Which means:
+ 
+  1) Acknowledge arthor and sources
+  2) Don't sue any one over it

data/data/reap/scaffold/{standard/ProjectInfo → ProjectInfo}

@@ -2,7 +2,8 @@
 
 TITLE    : &title Your App's Title
 NAME     : &pkg your_unix_name
-VERSION  : '0.0.1'
+SERIES   : '0.0.1'
+DATE     : '2005-01-01'
 STATUS   : beta
 
 AUTHOR   : Your Name
@@ -19,36 +20,22 @@ RUBYFORGE:
   PROJECT: your_projects_unix_name
   USERNAME: your_rubyforge_username
 
+DISTRIBUTE   : [ gem, tar.bz2, zip ]
+DEPENDENCIES : []
+EXECUTABLES  : []
 
 #=================================================
 # Unremark and use as needed. Often defaults
-# are sufficiant and need not specify
-# extra parameters.
+# are sufficiant and you do not need to specify
+# extra paramters.
 #=================================================
 
-PACKAGE:
-  DISTRIBUTE   : [ gem, tar.bz2 ]  # tgz zip deb
-  DEPENDENCIES : []
-  EXECUTABLES  : []
-  DIR: pkg  # where to put dist packages
-  INCLUDE:
-    - '**/*'
-  EXCLUDE: []
-
 # PUBLISH:
 #  - HOST: rubyforge
 #    TYPE: web
 #    USERNAME: your_username
 #    DIR: www
 
-# RELEASE:
-#   host       : rubyforge.org
-#   username   : user_username_for_host
-#   project    : *pkg
-#   groupid    : 999   # group id
-#   package    : Release-pacakge-name
-#   dir        : pkg  # where the dist packages are stored
-
 # RDOC:
 #   TITLE: *title
 #   DIR: 'rdoc'  # 'web/rdoc'
@@ -61,6 +48,13 @@ PACKAGE:
 #     - 'bin/**/*.rb'
 #   EXCLUDE: []
 
+# PACKAGE:
+#   DIR: pkg
+#   INCLUDE:
+#     - '**/*'
+#   EXCLUDE:
+#     - InstalledFiles
+
 # ANNOUNCE:
 #   TO: ruby-talk@ruby-lang.org
 #   FROM: *email
@@ -76,3 +70,9 @@ PACKAGE:
 #     - http://your_homepage.org
 #     - http://other_links.com
 
+# TEST:
+#   FILES:
+#     - 'test/**/tc*.rb'
+#     - 'test/**/test*.rb'
+#     - 'test/**/*test.rb'
+#  FIXTURE: []

data/data/reap/scaffold/Rakefile

@@ -0,0 +1,146 @@
+
+require 'reap/tasks'
+
+=begin
+# Traditionally, a pre-built rake task would be utilized like this:
+#
+#   Reap::PublishTask.new :mypublisher do |s|
+#     s.type = 'web'
+#     s.host = 'rubyforge.org'
+#     s.username = 'transami'
+#     s.dir = 'pub/www'
+#   end
+#
+# Reap provides a way to use YAML and specilized methods to make
+# this even cleaner.
+#
+#   publish_task( :mypublisher ) {"
+#     type     : web
+#     host     : rubyforge.org
+#     username : transami
+#     dir      : pub/www
+#   "}
+#
+# Of course, one can still use a traditional block with the
+# special methods.
+#
+#   publish_task :mypublisher do |s|
+#     s.type     = 'web'
+#     s.host     = 'rubyforge.org'
+#     s.username = 'transami'
+#     s.dir      = 'pub/www'
+#   end
+#
+# But there is an additional advantage to the YAML approach. Reap prepends
+# the task YAML with the YAML in the ProjectInfo file. This way it is easy
+# to reuse master information in indivial tasks. For exmaple you might have
+# an &author anchor defined in ProjectInfo.
+#
+#   publish_task( :mypublisher ) {"
+#     type     : web
+#     host     : rubyforge.org
+#     username : *author
+#     dir      : pub/www
+#   "}
+#
+# The special method notation actually works for some prebuilt rake tasks too.
+# But do not expect the YAML string block to work /w them.
+=end
+
+include ReapTask
+
+install_task( :install )
+info_task( :info )
+
+publish_task :publish do"
+  type     : web
+  host     : rubyforge.org
+  username : transami
+  dir      : www
+"end
+
+announce_task :announce do"
+  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
+  authtype : login  # cram_md5, plain
+  sectype  : tls    # ~, tls, ssl (not working yet)
+  file     : ANN    # which file contains announcement
+  slogan   : REAP THE REWARDS!
+  links    :
+    - http://unit.rubyforge.org
+    - http://rake.rubyforge.org
+"end
+
+fileperm_task :fileperm do"
+  filemod: 644
+  dirmod: 755
+  user: trans
+  group: users
+"end
+
+extract_tests_task :exttests do"
+  files:
+    - 'lib/**/*.rb'
+"end
+
+test_task :test do"
+  files:
+    - 'test/**/tc*.rb'
+    - 'test/**/test*.rb'
+    - 'test/**/*test.rb'
+  options: ~  # not used yet
+"end
+
+rdoc_task :rdoc do"
+  title: *title
+  dir: 'pub/www/rdoc'
+  template: jamis #html
+  options: ['--merge', '--all']
+  main: README
+  include:
+    - 'README*'
+    - 'LICEN*'
+    - 'COPY*'
+    - 'lib/**/*.rb'
+    - 'bin/**/*.rb'
+  exclude: []
+"end
+
+package_task :package do"
+  #dir: ../tag
+  include:
+    - 'lib/**/*'
+    - 'data/**/*'
+    - 'ext/**/*'
+    - 'bin/**/*'
+    - 'bench/**/*'
+    - 'test/**/*'
+    - 'doc/**/*'
+    - 'rdoc/**/*'
+    - 'pub/**/*'
+    - 'www/**/*'
+    - 'demo/**/*'
+    - 'samples/**/*'
+    - 'examples/**/*'
+    - 'bench/**/*'
+    - 'setup.rb'
+    - '[A-Z]*'
+  exclude:
+    - InstalledFiles
+  autorequire: ~
+  requirements: []
+  dependencies: *dep #[]
+  executables: *exe #[]
+  gem: true
+  zip: false
+  gzip: false
+  bzip2: true
+"end
+
+noop_task :noop do"
+  message: 'Hello, World!'
+"end