reap 9.3.5 → 9.4.0

data/CHANGES

@@ -1,3 +1,13 @@
+=== 9.4.0 // 2008-04-04
+
+* Created tools to help seperate some project task into isolated tasks.
+* I debated weak vs strong coupling for these classes and settled on strong.
+* Improved announce system for better output.
+* Email and Rubyforge news posting now works.
+* Create hosts classes, to support multiple hosts all at once.
+* Creats scm systems classes to eventuall support more than SVN.
+* Fixed many small bugs and improved overall interface.
+
 === 9.3.2 // 2008-02-18
 
 * Renamed reap-stamp to reap-version.

data/MANIFEST

@@ -1,7 +1,15 @@
 Rakefile
 MANIFEST
 test
-test/fixtures
+test/case
+test/case/test_scaffold.rb
+test/case/test_init.rb
+test/lib
+test/lib/case_testable.rb
+test/data
+test/data/scaffold
+test/data/scaffold/meta
+test/data/scaffold/meta/project.yaml
 test/unit
 test/unit/lib
 test/unit/lib/reap
@@ -13,20 +21,15 @@ README
 setup.rb
 meta
 meta/project.yaml
+meta/version
 meta/unixname
-meta/VERSION
 meta/description
-demo
-demo/doc
-demo/README
-demo/pkg
-demo/meta
-demo/meta/project.yaml
-demo/meta/VERSION
-demo/lib
-demo/lib/foo
-demo/lib/foo/foo.rb
-demo/log
+task
+task/allshare.rb
+task/configure
+task/install
+task/clean
+task/compile
 lib
 lib/reap
 lib/reap/default.yaml
@@ -38,14 +41,26 @@ lib/reap/extensions/net/smtp_tls.rb
 lib/reap/extensions/array.rb
 lib/reap/extensions/string.rb
 lib/reap/systems
-lib/reap/systems/rubyforge.rb
-lib/reap/systems/subversion.rb
+lib/reap/systems/system.rb
+lib/reap/systems/git.rb
+lib/reap/systems/svn.rb
+lib/reap/systems/hg.rb
 lib/reap/application.rb
+lib/reap/runmodes.rb
 lib/reap/project.rb
+lib/reap/emailer.rb
 lib/reap/iobject.rb
+lib/reap/hosts.rb
+lib/reap/systems.rb
 lib/reap/settings.rb
 lib/reap/extensions.rb
+lib/reap/tool.rb
 lib/reap/metadata.rb
+lib/reap/hosts
+lib/reap/hosts/mailinglist.rb
+lib/reap/hosts/host.rb
+lib/reap/hosts/rubyforge.rb
+lib/reap/hosts/rubytalk.rb
 lib/reap/project
 lib/reap/project/release.rb
 lib/reap/project/rdoc.rb
@@ -54,7 +69,6 @@ lib/reap/project/log.rb
 lib/reap/project/test.rb
 lib/reap/project/site.rb
 lib/reap/project/version.rb
-lib/reap/project/rubyforge.rb
 lib/reap/project/html.rb
 lib/reap/project/stats.rb
 lib/reap/project/gem.rb
@@ -62,12 +76,13 @@ lib/reap/project/scaffold.rb
 lib/reap/project/clean.rb
 lib/reap/project/publish.rb
 lib/reap/project/spec.rb
-lib/reap/project/svn.rb
 lib/reap/project/scm.rb
 lib/reap/project/package.rb
 lib/reap/project/check.rb
 lib/reap/project/announce.rb
+lib/reap/defaults.rb
 lib/reap/utilities.rb
+lib/reap/announcement.rb
 data
 data/reap
 data/reap/init
@@ -86,16 +101,18 @@ data/reap/base/setup.rb
 data/reap/base/meta
 data/reap/base/meta/version
 data/reap/base/meta/unixname.erb
+data/reap/base/site
 data/reap/base/lib
 data/reap/base/data
 data/reap/base/bin
 data/reap/base/COPYING
 log
-log/Changelog.txt
-log/Fixme.txt
-log/Todo.txt
+log/todo.rdoc
+log/changelog.rdoc
+log/fixme.rdoc
 bin
 bin/reap-package-tgz
+bin/reap-doc-spec
 bin/reap-package-gem
 bin/reap-uninstall
 bin/reap-log
@@ -130,7 +147,6 @@ bin/reap-inspect
 bin/reap-release
 bin/reap-make
 bin/reap-doc-rdoc
-bin/reap-spec-doc
 bin/reap-test-solo
 bin/reap-scm-branch
 bin/reap-doc-ri

data/NOTES

@@ -1,16 +1,18 @@
-The 9.x series of Reap is a beta version leading
-upto a stable 10.0 release.
+The 9.x series of Reap is a beta version leading upto
+a stable 10.0 release.
 
 The system is starting to work well. There are still some
-rough edges to iron and polish, but on the whole it's becoming
-very usable.
+rough edges to iron and polish, but on the whole it is
+looking good. In fact this release marks a high-usability
+point with the system. And with the next release or two
+it should be just about ready for general consumption.
 
-The latest changes fix the doc/, pkg/ and log/ directories
-as standard conventions, and can no longer be changed. The
-advantage of using convention here greatly outway the
-flexability of configuration.
+Two last major considerations are left: the orginizaiton of
+the metadata; and many binaries vs. one binary. While I
+like the many binaries idea, borrowed from git. The one
+binary design is more flexible for supporting per-project plugins.
 
-What remains to be done now is mostly cleanup and fine
-tuning, such as better command line output and additional
-documentation.
+An important previous change, that I will reiterate in these
+notes: doc/, pkg/ and log/ directories are now fixed standard
+conventions.
 

data/bin/reap-announce

@@ -2,6 +2,44 @@
 
 require 'reap/application'
 
-app = Reap::Application.new
+HELP = <<-END
+Usage: #{File.basename($0)} [options]
+
+Generate and email a release announcement. The announcement
+text is read from ANNOUNCE{.txt} or another template file
+is specified, or if no template is given, the  announcemnet
+is automatically built from project metadata, ant the 
+CHANGES and NOTES files.
+
+Templates support metadata substitutions using $name$ syntax.
+Also, it will subsititue the first line matching /please see notes/i
+for the notelog. And /please see change/i for the changelog.
+
+The following settings apply:
+
+   template     Announcement template file (ANNOUNCE.txt).
+   cutoff       Max number of lines of changelog to show.
+   mailto       Email address(es) to send announcemnt.
+
+If <em>mailto</em> is set then these also apply:
+
+   from         Message FROM address [email].
+   subject      Subject of email message ([ANN] title verison).
+   server       Email server to route message.
+   port         Email server's port.
+   domain       Email server's domain name.
+   account      Email account name [email].
+   login        Login type: plain, cram_md5 or login.
+   secure       Uses TLS security, true or false?
+
+The announcement will be printed to standard out before sending
+so it can be verified.
+END
+
+if ARGV.include?('--help')
+  puts HELP
+else
+  app = Reap::Application.new
+  app.announce
+end
 
-app.announce

data/bin/reap-check-load

@@ -2,7 +2,25 @@
 
 require 'reap/application'
 
-app = Reap::Application.new
+HELP = <<-END
+Usage: #{File.basename($0)} [options]
 
-app.check_load
+Load each script independently to ensure there are no require
+dependency issues. This takes one option:
+
+  scripts     ruby files to check
+
+Scripts is a glob of files or a list of globs. By default this
+is all scripts in the libpath(s).
+
+WARNING! You should only run this on scripts that have no
+toplevel side-effects!!!
+END
+
+if ARGV.include?('--help')
+  puts HELP
+else
+  app = Reap::Application.new
+  app.check_load
+end
 

data/bin/reap-check-syntax

@@ -2,6 +2,24 @@
 
 require 'reap/application'
 
-app = Reap::Application.new
+HELP = <<-END
+Usage: #{File.basename($0)} [options]
+
+Verify syntax of ruby scripts.
+
+This takes one option:
+
+  scripts     files is check
+
+The scripts option is a glob or list of globs of
+the scripts to check. By default this is all 
+scripts in the libpath(s).
+END
+
+if ARGV.include?('--help')
+  puts HELP
+else
+  app = Reap::Application.new
+  app.check_syntax
+end
 
-app.check_syntax

data/bin/reap-clean

@@ -2,6 +2,28 @@
 
 require 'reap/application'
 
-app = Reap::Application.new
+HELP = <<-END
+Usage: #{File.basename($0)} [options]
+
+Clean scrap products. All directory paths and or file globs
+listed under the clean configuration entry, can be removed via
+this method. By default all files ending with "~" or .bak
+are removed. To specifcy an alternate provide a list of files
+and/or globs under +remove:+ sub-entry. You can also provide
+an +exclude:+ sub-entry to isolate files not to be removed.
+For example:
+
+    clean:
+      remove [ '**/*~', '**/*.bak', '.config' ]
+
+Clean is run as a prerequiste to #release via #prepare.
+END
+
+if ARGV.include?('--help')
+  puts HELP
+else
+  app = Reap::Application.new
+  app.clean
+end
+
 
-app.clean

data/bin/reap-clobber

@@ -2,6 +2,21 @@
 
 require 'reap/application'
 
-app = Reap::Application.new
+HELP = <<-END
+Usage: #{File.basename($0)} [options]
+
+This tool runs all built-in clobber procedures. Clobber
+procedures are "undo" procedures for built-in generators,
+such as the documentation and package generators.
+Clobber also runs the clean task.
+
+Use clobber to restore a project to it's "pristine" state.
+END
+
+if ARGV.include?('--help')
+  puts HELP
+else
+  app = Reap::Application.new
+  app.clobber
+end
 
-app.clobber

data/bin/reap-doc

@@ -2,6 +2,16 @@
 
 require 'reap/application'
 
-app = Reap::Application.new
+HELP = <<-END
+Usage: #{File.basename($0)} [options]
+
+Generate documentation. This simply runs reap-doc-rdoc.
+END
+
+if ARGV.include?('--help')
+  puts HELP
+else
+  app = Reap::Application.new
+  app.document
+end
 
-app.rdoc

data/bin/reap-doc-rdoc

@@ -2,6 +2,21 @@
 
 require 'reap/application'
 
-app = Reap::Application.new
+HELP = <<-END
+Usage: #{File.basename($0)} [options]
+
+Generate Rdoc documentation. Settings are the same as the rdoc
+command options, with two exceptions: +output+ for +op+ and
++inline+ for +inline-source+.
+
+The rdoc command can also be configured to generate multiple
+documentation sets. (To be continued...)
+END
+
+if ARGV.include?('--help')
+  puts HELP
+else
+  app = Reap::Application.new
+  app.rdoc
+end
 
-app.rdoc

data/bin/reap-doc-ri

@@ -2,6 +2,20 @@
 
 require 'reap/application'
 
-app = Reap::Application.new
+HELP = <<-END
+Usage: #{File.basename($0)} [options]
+
+Gerneates local ri api documentation. The generated files
+are stored in the conventional location doc/ri.
+
+These are useful to checking ri docs look good. Try it with
+a tool such as webri or rbbr.
+END
+
+if ARGV.include?('--help')
+  puts HELP
+else
+  app = Reap::Application.new
+  app.ridoc
+end
 
-app.ridoc

data/bin/reap-doc-spec

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+require 'reap/application'
+
+HELP = <<-END
+Usage: #{File.basename($0)} [options]
+
+Generate specification documentation. This shells out to the
+'spec' command per RSpec to generate the specification outline.
+END
+
+if ARGV.include?('--help')
+  puts HELP
+else
+  app = Reap::Application.new
+  app.spec_doc
+end
+

data/bin/reap-init

@@ -8,6 +8,15 @@ require 'reap/utilities'
 
 include Reap::Utilities
 
+HELP = <<-END
+Usage: #{File.basename($0)} [options]
+END
+
+if ARGV.include?('--help')
+  puts HELP
+  exit
+end
+
 def dryrun?
   ARGV.include?('--dryrun')
 end

data/bin/reap-inspect

@@ -2,6 +2,24 @@
 
 require 'reap/application'
 
-app = Reap::Application.new
+HELP = <<-END
+Usage: #{File.basename($0)} [options]
+
+Thois command dumps project metadata. It is useful for debugging
+configuration settings. You can speciify the name of a particular
+piece of metadata to see just that information. For example:
+
+  #{File.basename($0)} version
+  9.3.5
+
+If no name is given then all metadata is dumped to standard-out
+in YAML format.
+END
+
+if ARGV.include?('--help')
+  puts HELP
+else
+  app = Reap::Application.new
+  app.introspect
+end
 
-app.introspect