qualitysmith_extensions 0.0.5 → 0.0.6

data/Readme

@@ -1,10 +1,14 @@
-== Our Extensions Readme
+= QualitySmith Extensions
+
+[<b>Home page</b>:]        http://qualitysmithext.rubyforge.org/
+[<b>Project site</b>:]     http://rubyforge.org/projects/qualitysmithext/
+[<b>License</b>:]          {Ruby License}[link:files/License.html]
 
 == Introduction
 
-This is a library of miscellaneous general-purpose, reusable Ruby code, quite similar in purpose and layout to {Ruby Facets}[http://facets.rubyforge.org/], but it's certainly not meant to *compete* with it!
+This is a library of miscellaneous general-purpose, reusable Ruby code, quite similar in purpose and layout to {Ruby Facets}[http://facets.rubyforge.org/]. It is certainly not meant to _compete_ with Facets though!
 
-Instead, developers are encouraged to first check if it the method or class they are looking for already exists in one of the fine existing open-source projects (like {Facets}[http://facets.rubyforge.org/] or {Extensions}[http://extensions.rubyforge.org/rdoc/index.html] or {stdlib}[http://www.ruby-doc.org/stdlib/]).
+Developers are encouraged to first check if the method or class they are looking for already exists in one of the fine existing open-source projects (like {Facets}[http://facets.rubyforge.org/] or {Extensions}[http://extensions.rubyforge.org/rdoc/index.html] or {stdlib}[http://www.ruby-doc.org/stdlib/]).
 
 If the code you are needing hasn't already been written by someone else, then you can throw it in this library. Also submit it to an existing extensions project if you think it's any good.
 
@@ -14,59 +18,36 @@ Like Facets, this library contains:
 
 == Installation
 
-=== Non-gem
-
-Install the plugin from Subversion and add an svn:external to your vendor/plugins directory with this command:
-
-  ./script/plugin install -x http://code.qualitysmith.com/gemables/qualitysmith_extensions
-
-=== Gem
-
-In your dreams.
+  gem install qualitysmith_extensions
 
 == Usage
 
-=== In Rails (non-gem)
-
-Install the plugin from Subversion and add an svn:external to your vendor/plugins directory with this command:
-
-  ./script/plugin install -x http://code.qualitysmith.com/gemables/qualitysmith_extensions
-
-Put this in your config/environment.rb :
+  require "rubygems"
+  gem "qualitysmith_extensions"
 
- Rails::Initializer.run do |config|
-   config.load_paths += %W( #{RAILS_ROOT}/vendor/plugins )
- end
- require "qualitysmith_extensions/lib/qualitysmith_extensions/all.rb"
+And then <b>include as much or as little as you want</b>.
 
-=== Include as much or as little as you want
+Use the handy <tt>all.rb</tt> files to load everything in a particular directory (and all subdirectories).
 
 To load everything:
 
-  require "../path/to/qualitysmith_extensions/lib/qualitysmith_extensions/all.rb"
+  require "qualitysmith_extensions/all"
 
 To load everything just for one class:
 
-  require "../path/to/qualitysmith_extensions/lib/qualitysmith_extensions/string/all.rb"
+  require "qualitysmith_extensions/string/all"
 
 To load just an individual method:
 
-  require "../path/to/qualitysmith_extensions/lib/qualitysmith_extensions/array/average.rb"
+  require "qualitysmith_extensions/array/average"
 
-=== Gem
-
-It's not packaged as a gem yet,... but if it were, it might work something like this?:
-
-  require "rubygems"
-  require_gem "qualitysmith_extensions"
-  require "qualitysmith_extensions/lib/qualitysmith_extensions/array/all.rb"
 
 == Running tests
 
 Tests are self-contained within the file for the code that is under test.
 
-To run the tests directly, you need to use the <tt>rubytest</tt> command that is included with the {Reap}[http://reap.rubyforge.org/] tool.
+To run the tests directly, you need to use the <tt>exrb</tt> command that is part of the {Ratchets}[http://ratchets.rubyforge.org/] project.
 
-If you use <tt>vim</tt>, you can set up your editor to run the tests just by typing the <tt>:Test</tt> command. To set that up, just include <tt>~/svn/devscripts/vim/include.vim</tt> .
+At some point in time, we may extract them into separate files using the Exacto test extractor tool.
 
-At some point in time, we may extract them into separate files using the Reap test extractor tool.
+<b>QualitySmith developers</b>: If you use <tt>vim</tt>, you can set up your editor to run the tests just by typing the <tt>:Test</tt> command. To set that up, just include <tt>~/svn/devscripts/vim/include.vim</tt> .

data/lib/qualitysmith_extensions/array/expand_ranges.rb

@@ -9,7 +9,9 @@ require 'rubygems'
 require 'facets/core/kernel/silence_warnings'
 
 class Array
-  # Expands (calls to_a on) all Ranges contained in this array, replacing the range with the list of elements that the range represents.
+  # Expands (calls +to_a+ on) all Ranges contained in this array, replacing the range with the list of *elements* that the range represents.
+  #
+  # This is especially useful when you want to have "discontiguous ranges" like [1..3, 5..7]...
   #
   #   [1..3, 5..7].expand_ranges
   #   => [1, 2, 3, 5, 6, 7]

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.8.11
 specification_version: 1
 name: qualitysmith_extensions
 version: !ruby/object:Gem::Version 
-  version: 0.0.5
-date: 2007-03-22 00:00:00 -07:00
+  version: 0.0.6
+date: 2007-03-23 00:00:00 -07:00
 summary: A collection of reusable Ruby methods developed by QualitySmith.
 require_paths: 
 - lib
@@ -46,7 +46,7 @@ files:
 - lib/qualitysmith_extensions/kernel/filter_output.rb
 - lib/qualitysmith_extensions/kernel/backtrace.rb
 - lib/qualitysmith_extensions/kernel/capture_output.rb
-- lib/qualitysmith_extensions/object/singleton.rb
+- lib/qualitysmith_extensions/object/singleton_send.rb
 - lib/qualitysmith_extensions/object/own_methods.rb
 - lib/qualitysmith_extensions/file/exact_match_regexp.rb
 - lib/qualitysmith_extensions/date/iso8601.rb