facets 3.0.0 → 3.2.0

data/.index

@@ -1,76 +0,0 @@
----
-revision: 2013
-type: ruby
-sources:
-- Indexfile
-- Gemfile
-authors:
-- name: Thomas Sawyer
-  email: transfire@gmail.com
-organizations:
-- name: Rubyworks
-requirements:
-- groups:
-  - test
-  version: '>= 0'
-  name: lemon
-- groups:
-  - test
-  version: '>= 0'
-  name: qed
-- groups:
-  - test
-  version: '>= 0'
-  name: rubytest-cli
-- groups:
-  - test
-  version: '>= 0'
-  name: rake
-- groups:
-  - test
-  version: '>= 0'
-  name: simplecov
-conflicts: []
-alternatives: []
-resources:
-- type: home
-  uri: http://rubyworks.github.com/facets
-  label: Homepage
-- type: code
-  uri: http://github.com/rubyworks/facets
-  label: Source Code
-- type: docs
-  uri: http://rubyworks.github.com/facets/learn.html
-  label: Documentation
-- type: wiki
-  uri: http://wiki.github.com/rubyworks/facets
-  label: User Guide
-- type: talk
-  uri: http://groups.google.com/group/facets-universal
-repositories:
-- name: upstream
-  scm: git
-  uri: git@github.com:rubyworks/facets.git
-categories: []
-copyrights:
-- holder: Rubyworks
-  year: '2004'
-  license: BSD-2-Clause
-customs: []
-paths:
-  load:
-  - lib/core
-  - lib/standard
-name: facets
-title: Ruby Facets
-version: 3.0.0
-summary: The orginal well curated collection of extension methods for Ruby.
-slogan: ALL YOUR BASE ARE BELONG TO RUBY!
-description: Facets is the premier collection of extension methods for the Ruby programming
-  language. Facets extensions are unique by virtue of thier atomicity. They are stored
-  in individual files allowing for highly granular control of requirements. In addition,
-  Facets includes a few additional classes and mixins suitable to wide variety of
-  applications.
-scm_uri: https://github.com/rubyworks/facets/tree/master
-created: '2004-12-16'
-date: '2014-12-20'

data/.yardopts

@@ -1,10 +0,0 @@
---title "Ruby Facets"
---readme README.rdoc
---protected
---private
---tag uncommon:Uncommon
---tag standard:Standard
-lib/core
-lib/standard
--
-[A-Z]*.*

data/CONTRIBUTE.md

@@ -1,78 +0,0 @@
-# CONTRIBUTING TO FACETS
-
-* Facets methods must have no external dependencies. (The only possible
-  exception to this is if the functor gets spun-off as a separate gem along
-  with related methods, but for now that's not happening.)
-
-* Each method must be in it's own file of the same name. If the method ends
-  with `=` or `?` just leave it off the file name. 
-
-* On rare occasion two or more methods can be very tightly related. In these
-  cases the methods can all go in a single file under the name of the method
-  considered most significant. Usually files for the other methods should
-  still be created that simply require the main file.
-
-* Methods must be tested either via a Lemon unit test or a QED demo,
-  preferably both. The Lemon unit tests are for testing a method in
-  detail whereas the QED demos are for demonstrating usage.
-
-* Facets is divided into two parts, *core* and *standard* libraries.
-  All of the core library is loaded by default when using `require 'facets'`
-  (actually, almost all). The standard library (sometimes called the *more*
-  library) must be required per-script.
-
-* Some core methods are included on a *trial* basis, and these are not 
-  necessary loaded automatically with `require 'facets'`.
-
-* Standard libraries that are not extensions of existing standard libraries
-  do not have to be divvied up into individual method files. But note that
-  full classes and/or modules are less likely to make it into Facets, as
-  these sorts of additions to Facets are only for very basic sorts of things.
-  Otherwise they'd deserve their own gem.
-
-* When submitting new methods for consideration, it is best if each method
-  (or *tightly related* set of methods) is in it's own pull request. If you
-  have only one method to submit then a simple  commit will do the tirck. If
-  you have more than one it best to use separate branches. Let me emphasizes
-  this point because it makes it *much more likely* that your pull request
-  will be merged. If you submit a bunch of methods in a single pull request,
-  it is very likely that it will not be merged even if methods you submitted
-  are accepted!!!
-
-* Don't be discouraged when you get feedback about a method that isn't
-  all sunshine and roses. Facets has been around long enough now that 
-  it needs to maintain a certain degree of quality control, and that means
-  serious discernment about what goes into the library. That includes 
-  having in depth discussions the merits of methods, even about the best
-  name for a method --even if the functionality has been accepted the name
-  may not!
-
-* When making a commit, if the commit is only a documentation change, then
-  and `[doc]` to the end of the first line of commit message. If it is only
-  a change to tests then add `[test]`. If the change only effects build files
-  then add `[admin]`. For actual code changes, if the change is not somethng
-  anyone would notice, use `[tweak]` or `[minor]` (minor being slightly more
-  improtant than tweak). For typical code changes no comment tag is necessary.
-  If the change fixes a bug that was reported via the issue system be sure to
-  reference the issue id in the message using `#` and add `[bug]`. If a change
-  is a significant change to the API, then end the message with `[major]`.
-  These are all rules of thumb, and no expects them to be applied perfectly.
-
-## Documentation
-
-Facets started when the only choice for API documentation was RDoc. So originally
-that's how methods were documented. Since then both YARD and Tomdoc have come
-along. And some of these documentation styles have creeped into a number of
-methods. So right now, things are a bit messy. But going forward it looks like we 
-are going to settle on Tomdoc as the official documentation style (but using
-the tomparse gem's extensions). Using Tomdoc will give us reasonable
-interoperabiltiy with both RDoc and YARD, both of which now have support for
-Tomdoc (albeit support is not 100% the same, but hopefully it's close enough).
-
-Offically we publish documentation via rubydoc.info, which is the YARD server,
-and via the Facets website in Shomen JSON format.
-
-When writting documentation for a method it is best to give a simple summary 
-explaination, followed by some basic examples. Follow that up with deeper
-explaination if needed, including *when* and *why* the method could be useful.
-

data/NOTICE.rdoc

@@ -1,167 +0,0 @@
-= COPYRIGHT NOTICES
-
-== Ruby Facets
-
-Copyright:: (c) 2005,2011 Thomas Sawyer
-
-  Copyright (c) 2005,2011 Thomas Sawyer
-
-  You may distribute this software under the same terms as Ruby.
-
-
-== Ruby/Extensions
-
-Copyright:: (c) 2004 Gavin Sinclair
-License:: Ruby
-
-  Copyright (c) 2004 Gavin Sinclair
-
-  Ruby/Extensions (extensions.rubyforge.org) is copyrighted free software
-  created and maintained by Gavin Sinclair (gsinclair@soyabean.com.au) and
-  released under the same license as Ruby.
-
-  THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
-  IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-  PURPOSE.
-
-
-==  Nitro/Glue
-
-Copyright:: (c) 2006, George Moschovitis
-License:: BSD-3-Clause
-
-  Copyright (c) 2006, George Moschovitis
-  All rights reserved.
-
-  Redistribution and use in source and binary forms, with or without
-  modification, are permitted provided that the following conditions
-  are met:
-
-  * Redistributions of source code must retain the above copyright notice,
-    this list of conditions and the following disclaimer.
-
-  * Redistributions in binary form must reproduce the above copyright notice,
-    this list of conditions and the following disclaimer in the documentation
-    and/or other materials provided with the distribution.
-
-  * Neither the name of the <ORGANIZATION> nor the names of its contributors
-    may be used to endorse or promote products derived from this software
-    without specific prior written permission.
-
-  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-  POSSIBILITY OF SUCH DAMAGE.
-
-
-== ActiveSupport
-
-Copyright:: (c) 2005-2011 David Heinemeier Hansson
-License:: MIT
-Website:: http://rails.org
-
-  Copyright (c) 2005-2011 David Heinemeier Hansson
-
-  Permission is hereby granted, free of charge, to any person obtaining
-  a copy of this software and associated documentation files (the
-  "Software"), to deal in the Software without restriction, including
-  without limitation the rights to use, copy, modify, merge, publish,
-  distribute, sublicense, and/or sell copies of the Software, and to
-  permit persons to whom the Software is furnished to do so, subject to
-  the following conditions:
-
-  The above copyright notice and this permission notice shall be
-  included in all copies or substantial portions of the Software.
-
-  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-  OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-  WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-
-== Ruby Treasures
-
-Copyright:: (c) 2001 Paul Brannan
-License:: Ruby License
-
-  Ruby Treasures 0.1
-  Copyright (c) 2001 Paul Brannan <paul@atdesk.com>
-
-  You may distribute this software under the same terms as Ruby (see the file
-  RUBY.txt that was distributed with this library).
-
-
-== Metaid
-
-Copyright:: (c) why the lucky stiff
-
-  Copyright (c) why the lucky stiff
-
-
-== CLAP
-
-Copyright:: (c) 2010 Michel Martens
-License:: MIT
-Website:: https://github.com/soveran/clap
-
-  Copyright (c) 2010 Michel Martens
-
-  Permission is hereby granted, free of charge, to any person obtaining a copy
-  of this software and associated documentation files (the "Software"), to deal
-  in the Software without restriction, including without limitation the rights
-  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
-  of the Software, and to permit persons to whom the Software is furnished to
-  do so, subject to the following conditions:
-
-  The above copyright notice and this permission notice shall be included in all
-  copies or substantial portions of the Software.
-
-  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
-  OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
-  IN THE SOFTWARE.
-
-
-== String#natcmp
-
-Copyright:: (c) 2003 by Alan Davies
-License:: Custom
-
-  String#natcmp is based on Martin Pool's "Natural Order String Comparison"
-  originally written in C. (see http://sourcefrog.net/projects/natsort/)
-
-  This implementation is Copyright (C) 2003 by Alan Davies
-  <cs96and_AT_yahoo_DOT_co_DOT_uk>
-
-  This software is provided 'as-is', without any express or implied
-  warranty.  In no event will the authors be held liable for any damages
-  arising from the use of this software.
-
-  Permission is granted to anyone to use this software for any purpose,
-  including commercial applications, and to alter it and redistribute it
-  freely, subject to the following restrictions:
-
-  1. The origin of this software must not be misrepresented; you must not
-     claim that you wrote the original software. If you use this software
-     in a product, an acknowledgment in the product documentation would be
-     appreciated but is not required.
-
-  2. Altered source versions must be plainly marked as such, and must not be
-     misrepresented as being the original software.
-
-  3. This notice may not be removed or altered from any source distribution.
-

data/demo/applique/assertion_framework.rb

@@ -1 +0,0 @@
-require 'ae'

data/demo/applique/file_helpers.rb

@@ -1,34 +0,0 @@
-require 'fileutils'
-require 'pathname'
-
-def temporary_directory
-  @temporary_directory ||= 'tmp'
-end
-
-Before :document do
-  if File.exist?(temporary_directory)
-    FileUtils.rm_r(temporary_directory)
-  end
-  FileUtils.mkdir(temporary_directory)
-end
-
-When /Given a directory '(.*?)' containing/ do |dir, text|
-  #abort unless /^#{temporary_directory}/ =~ dir
-  text.lines.each do |file|
-    next if file =~ /^\s*$/
-    file = File.join(dir, file.strip)
-    path = File.dirname(file)
-    FileUtils.mkdir_p(path)
-    File.open(file, 'w'){ |f| f << "SPINICH" }
-  end
-end
-
-# Return project root directory by looking for +lib+ directory.
-def root_directory
-  @root_directory ||= (
-    Pathname.new(Dir.pwd).ascend do |root|
-      break root if root.join('lib').directory?
-    end
-  )
-end
-

data/demo/core/array/combination.rdoc

@@ -1,19 +0,0 @@
-== Array#combination
-
-  require 'facets/array/combination'
-
-finds pairs of combinations
-
-  e = [[1, 2], [1, 3], [1, 4], [2, 3], [2, 4], [3, 4]]
-  a = [1,2,3,4]
-  r = a.combination(2).to_a
-  r.assert == e
-
-can also take a block
-
-  e = [[1,2],[1,3],[1,4],[2,3],[2,4],[3,4]]
-  r = []
-  a = [1,2,3,4]
-  a.combination(2){ |a,b| r << [a,b] }
-  r.assert == e
-

data/demo/core/array/delete.rdoc

@@ -1,23 +0,0 @@
-== Array#delete_unless
-
-  require 'facets/array/delete'
-
-  a = [1,2,3]
-  a.delete_unless{ |e| e == 2 }
-  a.assert == [2]
-
-== Array#delete_values
-
-  a = [1,2,3,4]
-  a.delete_values(1,2).assert == [1,2]
-  a.assert == [3,4]
-
-== Array#delete_values_at
-
-  a = [1,2,3,4]
-  a.delete_values_at(1,2).assert == [2,3]
-  a.assert == [1,4]
-  a = [1,2,3,4]
-  a.delete_values_at(0..2).assert == [1,2,3]
-  a.assert == [4]
-

data/demo/core/array/index.rdoc

@@ -1,14 +0,0 @@
-== Array#index
-
-  require 'facets/array/index'
-
-can handle a block
-
-  i = [1,2,3].index{ |e| e == 2 }
-  i.assert == 1
-
-when no element is found
-
-  i = [1,2,3].index{ |e| e == 5 }
-  i.assert.nil?
-

data/demo/core/array/merge.rdoc

@@ -1,15 +0,0 @@
-== Array#merge
-
-  require 'facets/array/merge'
-
-  a = [1,2,3]
-  b = [3,4,5]
-  a.merge(b).assert == [1,2,3,4,5]
-
-== Array#merge!
-
-  a = [1,2,3]
-  b = [3,4,5]
-  a.merge!(b)
-  a.assert == [1,2,3,4,5]
-

data/demo/core/array/only.rdoc

@@ -1,9 +0,0 @@
-== Array#only
-
-  require 'facets/array/only'
-
-  [5].only.assert == 5
-  [nil].only.assert == nil
-  expect(IndexError){ [].only }
-  expect(IndexError){ [1,2,3].only }
-

data/demo/core/array/pad.rdoc

@@ -1,28 +0,0 @@
-== Array#pad
-
-  require 'facets/array/pad'
-
-  r = [0,1,2,3].pad(7,"x")
-  x = [0,1,2,3,"x","x","x"]
-  r.assert == x
-
-negative index
-
-  r = [0,1,2,3].pad(-7,"n")
-  x = ["n","n","n",0,1,2,3]
-  r.assert == x
-
-== Array#pad!
-
-  a = [0,1,2,3]
-  r = a.pad!(6,"y")
-  x = [0,1,2,3,"y","y"]
-  r.assert == x
-
-negative index
-
-  a = [0,1,2,3]
-  r = a.pad!(-6,"q")
-  x = ["q","q",0,1,2,3]
-  r.assert == x
-

data/demo/core/array/permutation.rdoc

@@ -1,10 +0,0 @@
-== Array#permutation
-
-  require 'facets/array/permutation'
-  require 'set'
-
-  r = Set.new
-  %w[a b c].permutation{ |x| r << x.join('') }
-  x = Set.new(['abc','acb','bac','bca','cab','cba'])
-  r.assert == x
-

data/demo/core/array/product.rdoc

@@ -1,26 +0,0 @@
-== Array#product
-
-  require 'facets/array/product'
-
-single argument
-
-  r = [1,2,3].product([4,5,6])
-  x = [[1, 4],[1, 5],[1, 6],[2, 4],[2, 5],[2, 6],[3, 4],[3, 5],[3, 6]]
-  r.assert == x
-
-multiple arguments
-
-  a = %w|a b|
-  b = %w|a x|
-  c = %w|x y|
-  r = a.product(b, c)
-  x = [ ["a", "a", "x"],
-        ["a", "a", "y"],
-        ["a", "x", "x"],
-        ["a", "x", "y"],
-        ["b", "a", "x"],
-        ["b", "a", "y"],
-        ["b", "x", "x"],
-        ["b", "x", "y"] ]
-  r.assert == x
-

data/demo/core/array/recursively.rdoc

@@ -1,16 +0,0 @@
-== Array#recursive
-
-  require 'facets/array/recursively'
-
-each
-
-  r = []
-  [1,2,['a','b']].recursively.each{ |v| r << v }
-  r.assert == [1,2,'a','b']
-
-
-map
-
-  r = [1,2,['a','b']].recursively.map{ |v| v.succ }
-  r.assert == [2,3,['b','c']]
-

data/demo/core/array/rotate.rdoc

@@ -1,30 +0,0 @@
-== Array#rotate
-
-  require 'facets/array/rotate'
-
-clockwise
-
-  a = [1,2,3]
-  r = a.rotate
-  r.assert == [2,3,1]
-
-counter-clockwise
-
-  a = [1,2,3]
-  r = a.rotate(-1)
-  r.assert == [3,1,2]
-
-== Array#rotate!
-
-clockwise
-
-  a = [1,2,3]
-  a.rotate!
-  a.assert == [2,3,1]
-
-counter-clockwise
-
-  a = [1,2,3]
-  a.rotate!(-1)
-  a.assert == [3,1,2]
-

data/demo/core/array/select.rdoc

@@ -1,8 +0,0 @@
-== Array#select
-
-  require 'facets/array/select'
-
-  a = [1,2,3,4,5,6,7,8,9,10]
-  a.select!{ |e| e % 2 == 0 }
-  a.assert == [2,4,6,8,10]
-

data/demo/core/array/uniq_by.rdoc

@@ -1,9 +0,0 @@
-== Array#uniq_by!
-
-  require 'facets/array/uniq_by'
-
-  e = [-5, -4, -3, -2, -1, 0]
-  r = (-5..5).to_a
-  r.uniq_by!{ |i| i*i }
-  r.assert == e
-

data/demo/core/binding/caller.rdoc

@@ -1,57 +0,0 @@
-The caller.rb script includes a few related methods.
-We will use the following code to demonstrate their use.
-
-  require 'facets/binding/caller'
-
-  a = 1
-  b = 2
-  x = "hello"
-  
-  @bind = binding
-  @line = __LINE__  # the line number must be updated if it moves
-  @file = __FILE__  # why does it equal basename only?
-
-== Binding#caller
-
-  @bind.caller
-
-== Binding#callstack
-
-  @bind.callstack.assert.is_a?(Array)
-
-== Binding#__LINE__
-
-  @bind.__LINE__.assert == @line - 1
-
-== Binding#__FILE__
-
-  @bind.__FILE__.assert == @file
-
-== Binding#__DIR__
-
-  @bind.__DIR__.assert == File.dirname(@file)
-
-== Binding#__callee__
-
-This only works for certain versions.
-
-  def alternate_callee
-    binding
-  end
-
-  unless RUBY_VERSION < "1.9"
-    alternate_callee.__callee__.assert == :alternate_callee
-  end
-
-== Binding#__method__
-
-This only works for certain versions.
-
-  def alternate_method
-    binding
-  end
-
-  unless RUBY_VERSION < "1.8.7"
-    alternate_method.__method__.assert == :alternate_method
-  end
-

data/demo/core/binding/defined.rdoc

@@ -1,10 +0,0 @@
-== Binding#defined?
-
-  require 'facets/binding/defined'
-
-  a = 1
-  b = 2
-  x = "hello"
-
-  binding.assert.defined?("x")
-

data/demo/core/binding/eval.rdoc

@@ -1,8 +0,0 @@
-== Binding#eval
-
-  require 'facets/binding/eval'
-
-  x = "hello"
-
-  binding.eval("x").assert == "hello"
-