facets 1.7.0 → 1.7.30

data/doc/CAUTION

@@ -1,55 +0,0 @@
-
-  # Some caution should be taken when using certain facets.
-  # What follows ois list of such facets and the reasons
-  # these particular facets should given special consideration.
-
-  # Some facets require other files to be loaded first
-  # that are not loaded automatically, like fileutils
-  # (i.e. they are part of the standard lib, not core).
-  # The file include all of the following.
-
-  date/*
-  fileutils/*
-  ostruct/*
-  logger/*
-  gem/*
-
-  # Others effect the system in slightly non-standard ways.
-  # Though such changes are kept to a minumim and intended
-  # to be backward compatible, there still may be edge cases
-  # that could cause another library to misbehave. 
-  # The following is a list known facets that may have 
-  # this potential.
-
-  array/op_fetch.rb
-  array/op_store.rb
-  binding/self/of_caller.rb
-  hash/op_fetch.rb
-  hash/op_store.rb
-  numeric/succ.rb
-  numeric/pred.rb
-  string/succ.rb
-  string/unpack.rb
-  module/attr.rb
-  #module/attr_reader.rb
-  #module/attr_writer.rb
-  #module/attr_accessor.rb
-
-  # There are also some facets that are potentially unsafe b/c
-  # they change Ruby's default behavior in a nonconvential
-  # manner and hence are not designed to be backward compatible.
-  # Using these with a pre-existent program may cause the program
-  # to misbehave. So while they can be useful, be sure to 
-  # understand exactly what they do before putting them to 
-  # serious use.
-
-  hash/each.rb
-  module/methods.rb
-  object/method.rb
-  nilclass/op_fetch.rb
-  nilclass/empty.rb
-  nilclass/include.rb
-  nilclass/size.rb
-  nilclass/length.rb
-  nilclass/method_missing.rb
-

data/doc/IMPORTANT

@@ -1,8 +0,0 @@
-Facets is a GENERAL PURPOSE library. It is vital that is stay that way!
-
-Under no circumstances should something be added to Facets specific to
-a particular use case or application. While a lib might serve the needs
-of such, the lib itself must have general applicability. Although not a
-sure test in either "direction", a good rule of thumb for such a 
-condition is whether a lib has an external dependency --it should not.
-

data/doc/LATEST

@@ -1,41 +0,0 @@
-
-The 1.4 series of Facets is now official!
-
-There are have been quite a few improvements since the last offical release. The single biggest change is actually completely behind the scenes. Darcs is now being usd as the revision control system. Darcs really is a dream to use and should make it easier for others to contribute to the project. (I only wish Rubyforge and Tracs would gear up their Darcs support.)
-
-Here are the other major highlights of 1.4 series:
-
-* Added nilclass/status which allows a message to be passed through a failure chain.
-
-* Added enumerable/cascade, a cascade a list of actions on each element of an enumerable. Thanks to Sean O'Halpin for this.
-
-* Removed hash/keys_to_iv because it is a poor name. Since the alternative of 'keys_to_instance_variables' conveys the wrong idea, we simply deprecated it in favor of the Rails compatible #variablize_keys.
-
-* Fixed bug in BasicObject#__self__.
-
-* Addedd Cookie, HTTP and HTTPAccess of Hiroshi Nakamura's httpaccess2.rb library. Cookie has been moved to Web namespace.
-
-* OpenObject's __get__ and __set__ methods have been changed to __fetch__ and __store__ to correspond to the Hash methods.
-
-* Added OpenCascade, which is like OpenObject but chains access.
-
-* Included MenTaLguY's lazy.rb which include's Future and Promise classes. Cool lib!
-
-* Created task.rb, which provides a Rake interface compatible task system, but that can be used in any code. Instead of defining tasks globally it defines them as methods of the current module or class. This makes the "task pattern" reusable.
-
-* Improved Hash#traverse (it now does all traversing before yielding).
-
-* kernel/me, kernel/methodname and kernel/method_name have all been deprecated in favor of 1.9's kernel/__method__ and kernel/__callee__ (but why more __ methods if you don't like them, matz?)
-
-* Console::Application is deprecated as an alias for Console::Command.
-
-* Console::Command now supports run-on flags (eg. -xvzf).
-
-* More's classinherit.rb has been removed, and classmethods.rb will eventaully be deprecated as well. You should transition all uses of these to the core method module/class_extension.
-
-* Updated tuple.rb so that when a string is converted to a Tuple (#to_t) the values wll be made integers if they are composed of only numbers. If you need all strings you can use a block since the block bypasses auto coerce, eg. to_t{ |v| v }.
-
-* If anyone missed the changes from 1.3 the main of them were the inclusion of xoxo.rb, json.rb and rtals.rb; the moving of the cattr methods from module/ to class/. The mattr methods are still being reconsidered (They were aliases for cattr.); and adding zimba.tm's string/modulize, pathize and methodize methods.
-
-I see the gleen in your eye ;) Enjoy!
-

data/doc/history/ANN-0.6.0

@@ -1,40 +0,0 @@
-Happy Winter Solstice,
-
-I am pleased to finally announce the first public release of Ruby
-Facets. Ruby Facets was born, as I imagine many such projects
-are, over a period of years, as a growing collection of routines
-for which I commonly found need. Recently the library had
-grown large enough that I thought it might stand on its own. 
-So a few weeks ago, I decided I'd go ahead and prepare a 
-release. There was a good bit of work to do --organizing, 
-documenting, testing; and I had the "bright" idea of scouring
-the web for other tidbits that I might add. That turned into a
-whole project in itself! But I persevered and now Facets is
-finally polished enough for an initial offering.
-  
-Of course, there are still plenty of things left to do: write better
-documentation, improve the tests and write a few yet missing,
-improve the methods themselves, perhaps even a few improvements
-in method and file names, plus error catching code --I'm sure there
-are a number of places for that improvement, and of course there's
-plenty of room for adding new goodies, too. In fact I hope the
-Ruby community at large will take this opportunity to contribute any
-extension methods used personally but deemed generally useful.
-As the project manager I am quite open to the many possibilities.
-Please contribute!
-
-Being the very first release, I expect there may arise some
-unforeseen bugs. If you come across any please let me know,
-as soon as possible, so I can fix. You can contact me either 
-privately or via ruby-talk, or through the new calibre-cuts
-mailing-list:
-
-  http://rubyforge.org/mailman/listinfo/calibre-cuts
-
-My hope for Ruby Facets, and the other children of its parent
-project, Ruby Calibre, is that Ruby will gain a vast and widely
-used set of useful classes and routines in a nice all-in-one package
---Ruby's Tertiary library after Core and Standard, if you will.
-
-Thanks and Happy Holidays, 
-T.

data/doc/history/ANN-0.6.1

@@ -1,36 +0,0 @@
-Happy New Year,
-
-A new version of Ruby Facets is out: 0.6.1. This version updates the common 
-"mix" files to be insync with the previous 0.6 updates (they were lagging 
-behind at version 0.5). Not to be confused with a _mixin_, a mix simply 
-bundles a group of atomic requires into single file. The most common are
-for the class and modules themselves. For example:
-
-  require 'facet/string'
-  
-This mix requires all String facets considerd most commonly useful.
-
-Also added are a few new extra mixes: 'facet/rand' and 'facet/nil-as-emptiness'.
-'rand' requires an assortment of random related methods. 'nil-as-emptiness'
-makes NilClass return nil to a number of common methods, like #empty?
-and #[].
-
-If you are interested in contributing to a project but have little time
-to spare, helping with Facets may be a perfect project. There are still
-plenty of light-weight tasks to do: improve documentation, improve the
-tests and write a few yet missing, improve the rohbustness of methods
-themselves, including exceptional error catching, and of course there's
-plenty of room for adding new goodies, too. If you have any extension 
-methods that you use and think may be of benefit to others, please let
-us know. We are quite open to the many possibilities.
-
-And, of course, please let us know if you come across any bugs.
-
-You can contact us either privately or via ruby-talk, or through the
-new calibre-cuts mailing-list:
-
-  http://rubyforge.org/mailman/listinfo/calibre-cuts
-
-Thanks,
-T.
-

data/doc/history/ANN-0.6.3

@@ -1,43 +0,0 @@
-Hi--
-
-Ruby Facets 0.6.3 is now out. This version adds some new methods (as
-usual). But the biggest news is that Facets is now avaialble via
-RubyGems. To install simply run 'gem install facets'.
-
-Here's a rundown of the ChangeLog for 0.6.3:
-
-* Added kernel/require_all which allows one to require a pattern of files,
-making it easy to require every file in a directory.
-
-* Added hash/traverse and hash/traverse!, which takes a block and iterates over
-each key-value pair descending into subhash values and applying the block.
-Thanks goes to Ara T. Howard and robert for their help.
-
-* Changed enumerable/build_hash to enumerable/graph. The method #build_hash
-has been aliased to #graph for the time being for backward compatability.
-
-* Added hash/collect. This uses enumerable/graph so that
-hash/collect will return a hash rather then an array.
-
-* Added numeric/before and numeric/after in place of #ago and #since
-and aliased #ago and #since to them, per the suggestions of
-Francis Hwang.
-
-* Added "poor man's profiler", time/elapse. Credit goes to Hal Fulton.
-
-* Added array/last_index. Thanks goes to Jabari.
-
-
-If you have any extension methods that you use and think may be of benefit
-to others, please submit them. And, of course, please let me know if you 
-come across any bugs.
-
-You can contact me either privately or via ruby-talk, 
-or via the Ruby Muse mailing list, suby-ruby at berlios.de 
-(membership required).
-
-  http://rubyforge.org/mailman/listinfo/calibre-cuts
-
-Thanks,
-T.
-

data/doc/history/ANN-0.7.0

@@ -1,59 +0,0 @@
-Hi--
-
-Exciting news! Ruby Facets 0.7 series is officially out. And this version goes ballistic.
-Why? Well, what used to be the Carats library has now been merged into Facets! So not only
-does Facets have the atomic methods, it now has a plethora of classes, modules and mixins
-to draw upon.
-
-Here's a list of the general changes for the current version 0.7.2:
-
-* The Carats library has been ported into the Facet lib. These files sit in the 
-  main lib directory 'facet/' above the "atomic" methods which are all in 
-  subdirectories 'facet/{module|class}/'. This layout works well, and allows for
-  everything to be provided from the same location.
-
-* All methods with names containing non-alphanumeric characters are now CGI-escaped.
-  This removes some incompatibilites with some file systems. For instance Object#in?
-  is now stored in object/in%3F.rb.
-
-* So one doesn't have to fuss with these escape chars, a new method has been added,
-  kernel/require_facet, which automatically does the substitutions.
-
-* An expiremental file, facet.rb, had been added that allows automatic requiring of 
-  atomic methods. It uses object/method_missing to require the methods on demand.
-
-* A number of "molecular" files have been added. These require multiple
-  related "atoms" at once for greater convenience.
-
-* A few methods that were grouped together in the same file have been separated
-  into their own files. (This is more feasible thanks to the additional
-  "require collections.")
-
-* The method array/put has been changed to array/top (it is an alias for #unshift).
-
-* Methods #matchdata/post_match_from and #matchdata/pre_match_from have been 
-  deprecated in favor of some more generalized methods that serves the same 
-  purposes, matchdata/matchtree and matchdata/matchset.
-
-* Added module/include_as which allows one to include a module but within a specified
-  namespace.
-
-* Added array/each_permutation, which applys a block to each permutation (in contrast
-  to each_combination).
-
-As for the rest. Well, this thing is HUGE! There's no way I can go into it all of it here.
-So dig in and check it out. Documentation is a bit improved, too btw, albeit there's still
-plenty of work to be done in this regard.
-
-If you have any extension methods that you use and think may be of benefit
-to others, please submit them. And, of course, please let me know if you 
-come across any bugs.
-
-You can contact me either privately or via ruby-talk, 
-or via the Ruby Muse mailing list, suby-ruby at berlios.de 
-(membership required).
-
-  http://rubyforge.org/mailman/listinfo/calibre-cuts
-
-Thanks,
-T.

data/doc/history/ANN-0.8.1

@@ -1,127 +0,0 @@
-
-DRUM ROLL PLEASE. I'm happy to announce two new sister projects: 
-Nano Methods and Mega Modules. They are born from the heritage of the
-old Ruby Facets project (now deprecated). In the course of the last 
-several months a slew of major improvements have been made. We have some
-spiffy new websites and, most importantly, this release marks the 
-beginning of a clear window toward 1.0 status.
-
-GREAT NEWS! Nano Methods and Mega Modules are now the official
-support libraries for Nitro and Og (http://www.nitrohq.com).
-Nitro is a sophisticated Web Application Engine and Og is an
-intuitive yet powerful Object Relational Mapping Library.
-
-WHY MEGA? You may have noticed that I back peddled on the major change to
-Facets 0.7.0. In that release I had merged the class and module additions
-library, Ruby Carats, into Facets. But I had to separate them out again. It 
-simply proved too cumbersome to have such a variety of content all in one
-location. I am very excited the re-separation though. It has already lent 
-itself to major improvements to the library, with a number of exciting 
-additions on the way.
-
-NANO SYSTEM. Another new feature is the introduction of the NanoSystem
-module. This module provides access to meta-info about Nano's extensions.
-Primarily it is an index of all the methods. With this information at its
-disposal another unique way to require method becomes possible:
-
-  require 'nanosys'
-
-  String.use :capitalized?, :underscore
-
-I am not recommending this approach at the moment. But in the long run,
-as the NanoSystem module matures, it may well prove to be a much more
-elegant means of extension loading.
-
-FOR FACETS USERS. To upgrade, the project name change will require
-you to change the #require path-space from 'facet/' to 'nano/', or 
-occasionally 'mega/'. The division is pretty clear, Nano stores methods
-and Mega stores classes and modules. Sorry for the inconvenience, but 
-after a long debate I decided it was worth it --and better to do so now
-rather then later. Hope you like the new names.
-
-CORNUCOPIA. Finally, there are also _a lot_ of minor changes in this release.
-Some of them are simply improvements in the naming of methods or more appropriate 
-class/module placement. I've gone over all the methods enough now to be
-confident that the present methods are pretty well set. You can expect many fewer
-name/location changes from here on out. Also, a good number of new methods have
-been added. Most of these I have managed to make mention of in the following
-ChangeLog summary.
-
-* Class methods are not prefixed with '::' to separate them from instance methods.
-
-* Added logger #format and #format_message (whomever wrote these please let me know,
-I got them thru a second-hand source and the original author is lost to me. I try
-very hard to credit where credit is due.)
-
-* Renamed object/supers to object/superup. Better!
-
-* Got rid of symbol/gen. Use object/generate_method_name or 
-module#generate_instance_method_name instead. [ed- Is that the longest
-non-foo method name ever?]
-
-* The file 1st.rb file has moved to object/method!. This provides a version
-of #method that persists the returned Method object.
-
-* Added module/clone_using, module/clone_renaming and module/clone_removing.
-
-* Added module/integrate (I love this one, but note that its syntax is not yet
-set in stone.)
-
-* Added many new enumerable methods: #filter_map, #compact_map, #commonality,
-#frequency, #probability and #find_collisions.
-
-* Moved some methods from array to enumerable: #each_permutation,
-#each_combination, #each_unique_pair and the class method ::combinations.
-
-* Added string/bytes per ruby-dev summary 26385-26467.
-
-* Moved #cattr_reader, #cattr_writer and #cattr_accessor from Class to Module.
-These are the class variable attributes as defined by Rails DHH.
-
-* Added class instance attribute methods: iattr_reader, iatter_writer, &c.
-The name of these are not set in stone. It's a bad misnomer. Looking
-for suggestions.
-
-* Added methods to comparable: #cap, #clip. #clip replaces #bound_by, since
-'by' generally indicates the method takes a block parameter. I have retained
-#at_least and #at_most, although #cap and #clip handle the same functionality.
-
-* Added class/descendants (alias subclasses) and class/remove_descendants.
-
-* Removed string/table_name and string/class_name (were too Rails specific).
-Note: A new module has been added to Mega Modules, called orm_inflect.rb. 
-It contains numerous methods for doing this sort of thing.
-
-* Added numeric/ceil_multiple.
-
-* Added string/soundex for calculating the soundex code of a word/name.
-
-* numeric/octet_units has bee moved to mega/binary_multipliers, which
-is a rewrite of Richard Kilmer's bytes.rb. Actually #octet_units is
-now just an alias or #strfbytes, accompanied by #strfbits.
-
-* Placed Florian's binding-of-caller.rb in binding/of_caller. Makes more
-sense there.
-
-* Fixed Continuation::create; it wasn't defined as a class method
-and should have been.
-
-* Fixed bug with string/capitalized? which wasn't always giving the correct
-result.
-
-There are a number of others, but this particular session of development was
-so rapid and choked full, I wasn't able to log them all. 
-Please see the API RDocs for a complete listing.
-
-CONTRIBUTE. As always, if you have any extension methods that you use and think
-may be of benefit to others, please submit them. There's a good chance they'll be
-incorporated. Also, if you happen to notice any code that is mis-credited or is
-not credited at all and should be, please correct me. Giving credit where credit 
-is due is _vry_ important to me, unfortuantely in the juggle of things it doesn't
-always get doen as wellas it should. And, of course, please let me know if you
-come across any bugs.
-
-You can contact me either privately or via ruby-talk.
-
-Thanks and Enjoy,
-trans|onoma

data/doc/history/INTRO

@@ -1,172 +0,0 @@
-
-= Ruby Calibre, Common Applications Library Suite
-
-  "ALL BASE COMMON"
-
-== Introduction
-
-Welcome to the Ruby Calibre Project[1].
-
-Calibre is an open API repository project for the Ruby programming language.
-The intent of the project is to provide extensive general purposed library
-collections to supplement the core and standard libraries already
-included with Ruby. Specifically, it is an free and open repository of
-useful and well tested classes, modules, mixins and methods.
-
-Calibre has a simple slogan, "ALL BASE COMMON". The notion is that small 
-commonly used tools are better served whole. There are a number of 
-advantages in bundling these into a single suite.
-
-  * Better code reuse
-  * Collabretive improvements
-  * Name consistency
-  * One-stop shop and installation
-
-The name Calibre is derived from the term used in gemstones:
-  
-  "Calibre-cut stones are small stones that are cut into special shapes
-   that are meant for use in commonly-used designs."
-
-So you see, the gemstone analogy is perfect. :)
-
-The project is presently divided into two parts.
-
-The first and most fundemental of these is Ruby Facets, the Fantasic Atomic
-Core Extensions. The uniquness of this library collection lies in the
-atomicity of its extensions layout (hence the name) --nearly every core
-extension method is in it's own file, so it can be required independently.
-
-The second is Cuts&Carats, a Collection of API Useful Tools. This is a higher-level
-general purpose library which includes classes, modules, mixins, and other
-assorted general purposed additions.
-
-All Calibre libraries include expiremental development repositories where
-new potential additions are kept for research and testing. Please,
-feel free to explore these repositories and help contribute to those
-works-in-progess. If you have something you'd like to add, please
-submit and it will be placed into the appropriate development area,
-where it will reside until deemed fit for inclusion in the main.
-
-  Note: Calibre is still a young project so a number of libs
-  still need improvements despite their inclusion in the main.
-
-
-== Installation
-
-presently only a manual install is avaliable but it is simple enough
-in that it uses setup.rb. Simply uncompress the package and run
-setup.rb. For example:
-  
-  > tar -xvzf trix-x.y.z.tar.gz
-  > cd trix-x.y.z
-  > sudo ruby setup.rb
-
-
-== Usage
-
-Umm... that might require a book. You should look at the API RDocs.
-To date, not everything in documented. But it's getting there.
-You are welcome to help out. The basic requires are:
-  
-  require 'calib/<file>'
-  
-  require 'calib/cut/<file>'
-  require 'calib/carat/<file>'
-
-  require 'facet/<file>'
-  require 'facet/<class>/<file>'
-
-For instance:
-  
-  require 'facet/nil/empty?'
-
-The #empty? method will be the only new method added to NilClass. 
-In the Facet's lib almost every file is named for the method in 
-contains. The only exceptions are for methods that are tightly 
-related. In these few cases either the file will be named after
-the "core" method, or named as a conjunction, like +true&false?.rb+.
-
-
-== Mascots
-
-Doesn't every good project need a mascot? Well, ours is the Raspberry,
-becasue it's red and faceted. But we also like Carrots, Baseball Diamonds
-and Swirling Atoms. :)
-
-==== Why Raspberry?
-
-Becasue it adds color (namely red) and a nice flavor to the whole affair.
-
-
-== Authorship
-
-This collection was put together by, and much of it written by Thomas Sawyer
-(aka T. Onoma). He can be reached via email at transami at runbox.com.
-
-This package is a collection of work by many persons. 
-If it matters, the collection(s) per collection(s) is licensed:
-
-  Calibre, Common Application Libraries
-  Copyright (c) 2004 Thomas Sawyer
-  Ruby License
-
-  Carats, the Ruby Toolchest
-  Copyright (c) 2004 Thomas Sawyer
-  Ruby License
-  
-  Cuts, Common Useful Tools
-  Copyright (c) 2004 Thomas Sawyer
-  Ruby License
-  
-But the individual pieces of code are licensed according to the original authors
-desires, thus far being one of the following: Ruby, GPL, LGPL, MIT, or Artistic.
-Copies of these licenses should accompany this document. Any piece of code
-not specifically laballed shall fall under the Ruby License.
-   
-  Please Note: I am working to make sure everything is labeled appropriately.
-  Please forgive me if I have not done so in a particular place --just let 
-  me know and I will fix.
-
-  Also, I would like to ask all those authors, whose code is collected here,
-  to consider moving to a common license, assumedly the Ruby license,
-  so one license can serve for all.
-
-=== Contributing Authors
-
-This follwoing is a list code contributors.
-(Please notify me, if anyone is missing.)
-
-* Thomas Sawyer      <transami#runbox.com>
-* Paul Brannan       <paul#atdesk.com>
-* Renald Buter       <buter#cwts.nl>
-* Daniel J. Berger
-* Hal Fulton         <hal9000#hypermetrics.com>
-* Gavin Sinclair     <gavin#>
-* Michael Granger    <ged#FaerieMUD.org>
-* Michael Neumann    <mneumann#ntecs.de>
-* Florian Frank
-* Mohammad Khan      <mkhan#lextranet.com> 
-* Derek Lewis        <lewisd#f00f.net>
-* Thomas-Ivo Heinen
-* Jan Molic
-* Shashank Date
-* Austin Ziegler     <halostatue#gmail.com>
-
-
-== Pitch
-
-  ALL YOUR BASE ARE BELONG TO RUBY
-
-
-----
-
-
-[1] A lot of mental anguish went into finding good titles. Of course in the end,
-    only one theme could take the honor. Other good names that were considered were
-    Ruby Warchest w/ Atomix, Ruby Downs & Ace, Ruby Pillbox & Pills (a _why suggestion),
-    and one that almost won out, Trix & Atomx. Of course, let us not forget even older
-    "working" names that were used along the way: Tomslib, Succ, ABC and finally Raspberry.
-
-
-# Copyright (c)2004 Thomas Sawyer 
-# --.com : The web page without a name.