facets 2.4.4 → 2.4.5

data/README

@@ -16,7 +16,7 @@ The "more" additions are a collection of classes, modules and light meta-systems
 
 == Documentation
 
-Facets has special documentation needs due to it's extensive bredth. For this reason, RDocs are not automatically generated when installing via RubyGems. Unfortunatgely this also prevents RI docs from being created. Hopefully we can remedy this in the future. In the mean time you can manually create them by navigating to the package directory (either the gem or tgz) and running 'rdoc --ri-site' (recommended destination).
+Facets has special documentation needs due to it's extensive bredth. The RDocs generated when installing via RubyGems, are unweildly because it combines all of Facets in one set of docs. Hopefully we can remedy this in the future. In the mean time the gem package includes better documentation --divided into three sections, in the doc/rdoc directory.
 
 Online documentaiton is available at http://facets.rubyforge.org/learn.html. There is a "Quick Doc" feature that can be a bit more convenient then the usual RDocs. Prior to 2.3.1 off-line docs had to be downloaded via a separate package, but this is no longer the case. I've seen past the stigma of not including documentation along with the package itself (the extra 500K isn't even a floppy disk folks!), so you will find them in the doc/ directory of whatever package you have choosen to install. In fact, a good package installer should give you the option to install those in the appropriate place in your system (eg. in /usr/share/doc/facets/).
 
@@ -76,7 +76,17 @@ For information in usage, please see the special README for the specific set of
   README.lore     Standard extensions
   README.more     Additions
 
-Using a Facets/MORE library of modules, classes or microframeworks is essentially the same. For example:
+General usage of the CORE library is provided via:
+
+  require 'facets'
+
+This is the recommended usage. However, you can also "cherry pick" core methods. While there are exceptions the rule of thumb for loading a core method is:
+
+  require 'facets/{class|module}/{method}'
+
+See README.core for more information.
+
+Using the Facets/MORE library of modules, classes or microframeworks is essentially the same. For example:
 
   require 'facets/basicobject'
 

data/RELEASE

@@ -0,0 +1,37 @@
+Facets 2.4.5 is a maintaince release. This release is notable
+however in that it will likely be the last that to use SVN.
+Facets will be switching to Git. Also, some libraries that
+have been flagged "to be deprecated" for some time will
+finally be so.
+
+
+### 2.4.5 / 2008-10-02
+
+* 6 Major Enhancements
+
+    * Re-added date.rb to lore library, and removed from core.  (#r1014)
+    * Much improved date.rb extension now in Lore library.  (#r1027)
+    * Deprecated kernel/suppress. Use Exception.suppress from now on.  (#r1040)
+    * Deprecated string/style.rb. Use English project instead.  (#r1074)
+    * Console namespace is no longer supported (for Ansicode).  (#r1077)
+    * enumerable/mode.rb, Enumerable#mode returns array since there can be more than one.  (#r1079)
+    * OpenCascade automatically creates nodes, use foo? to query.  (#r1056)
+
+* 11 Minor Enhancements
+
+    * Moved variablize methods out of metaid.rb and into separate files (string/ and symbol/).  (#r1042)
+    * Added Time#advance.  (#r1046)
+    * Speed up of Integer odd/even methods.  (#r1057)
+    * Array#index now takes a block (this is a core override).  (#r1059)
+    * Spilt file/write.rb into separate method files (append, create, writelines).  (#r1073)
+    * Modified Enumerable#split to behave like String#split.  (#r1076)
+    * hash/op.rb, split into separate method files.  (#r1081)
+    * Added string/modulize. string/methodize handles path names now too.  (#r1085)
+    * Class#cattr is now part of core.  (#r1089)
+
+* 2 Bug Fixes
+
+    * OpenStruct#to_h dups internal table.  (#r1015)
+    * Fixed require of string/xor in bicrypt.rb.  (#r1039)
+    * integer/odd.rb, fixed Ruby 1.9 condition.  (#r1080)
+

data/Rakefile

@@ -0,0 +1,4 @@
+Dir['task/**/*.rake'].each do |lib|
+  load(lib)
+end
+

data/VERSION

@@ -0,0 +1 @@
+facets 2.4.5 stable (2008-10-04)

data/demo/bench/general/comment_loading/bench.rb

@@ -0,0 +1,46 @@
+#
+# Compare how long it takes to load commented
+# vs. non-comment files.
+#
+
+require 'benchmark'
+
+$n = 50000
+
+def load_comments_none
+  $n.times do
+    load('comments_none.rb')
+  end
+end
+
+def load_comments_sharp
+  $n.times do
+    load('comments_sharp.rb')
+  end
+end
+
+def load_comments_begin
+  $n.times do
+    load('comments_begin.rb')
+  end
+end
+
+def load_comments_end
+  $n.times do
+    load('comments_end.rb')
+  end
+end
+
+### --- bench ---
+
+puts "\nComment Loading"
+
+Benchmark.bm(15) do |b|
+  b.report("sharp :") { load_comments_sharp }
+  b.report("begin :") { load_comments_begin }
+  b.report("w/end :") { load_comments_end }
+  b.report("none  :") { load_comments_none }
+end
+
+
+

data/demo/bench/general/comment_loading/comments_begin.rb

@@ -0,0 +1,109 @@
+a = 1
+
+=begin
+
+Lots of comments
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+=end
+

data/demo/bench/general/comment_loading/comments_end.rb

@@ -0,0 +1,127 @@
+a = 1
+
+__END__
+
+# Lots of comments
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+

data/demo/bench/general/comment_loading/comments_none.rb

@@ -0,0 +1 @@
+a = 1

data/demo/bench/general/comment_loading/comments_sharp.rb

@@ -0,0 +1,125 @@
+a = 1
+
+# Lots of comments
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+