facets 3.0.0 → 3.2.0

data/lib/core/facets/enumerable/sum.rb

@@ -1,30 +0,0 @@
-module Enumerable
-
-  # Uses #+ to sum the enumerated elements.
-  #
-  #     [1,2,3].sum      #=> 6
-  #     [3,3,3].sum      #=> 9
-  #     [].sum           #=> 0
-  #
-  # A initial value can be passed to the method.
-  #
-  #     [].sum(5)        #=> 5
-  #     [1,2,3].sum(10)  #=> 16
-  #
-  # A block can also be passed to coax the elements before summation.
-  # 
-  #     [1.1,2.2,3.3].sum(10.4, &:to_i)  #=> 16.4
-  #
-  # Notice the initial value is not effected by the block.
-  #
-  # @author Dawid Marcin Grzesiak
-
-  def sum(*identity, &block)
-    if block_given?
-      map(&block).sum(*identity)
-    else
-      reduce(*identity) { |sum, element| sum + element }
-    end
-  end
-
-end

data/lib/core/facets/exception/set_message.rb

@@ -1,10 +0,0 @@
-class Exception
-
-  # See exception message.
-  #
-  def set_message(string)
-    @mesg = string.to_s
-  end
-
-end
-

data/lib/core/facets/file/write.rb

@@ -1,24 +0,0 @@
-class File
-
-  unless defined?(write)  # 1.9+
-
-    # Writes the given data to the given path and closes the file.  This is
-    # done in binary mode, complementing <tt>IO.read</tt> in standard Ruby.
-    #
-    #   str = 'The content for the file'
-    #   File.write('write.txt', str)
-    #
-    # Returns the number of bytes written.
-    #
-    # CREDIT: Gavin Sinclair
-
-    def self.write(path, data)
-      File.open(path, "wb") do |file|
-        return file.write(data)
-      end
-    end
-
-  end
-
-end
-

data/lib/core/facets/fixnum.rb

@@ -1,7 +0,0 @@
-class Fixnum
-  n_bits = ([42].pack('L!').size * 8)
-
-  MAX = 2 ** (n_bits - 2) - 1
-  MIN = -MAX - 1
-end
-

data/lib/core/facets/kernel/__dir__.rb

@@ -1,28 +0,0 @@
-module Kernel
-
-  # Similar to __FILE__, __DIR__ provides the directory
-  # path to the current executing script.
-  #
-  # DEPRECATED: As of Ruby 2.0, which will have #__dir__ method.
-  #
-  # CREDIT: Trans
-
-  def __DIR__(*paths)
-    c = caller.first
-    return nil unless c.rindex(/:\d+(:in `.*')?$/)
-    file = $` # File.dirname(c)
-    return nil if /\A\((.*)\)/ =~ file # eval, etc.
-    #File.expand_path(File.join(File.dirname(file), paths))
-    File.join(File.dirname(file), paths)
-  end
-
-  #--
-  # Old defintion ...
-  #
-  #  def __DIR__
-  #    (/^(.+)?:\d+/ =~ caller[0]) ? File.dirname($1) : nil
-  #  end
-  #++
-
-end
-

data/lib/core/facets/kernel/constant.rb

@@ -1,22 +0,0 @@
-module Kernel
-
-  # This is similar to +Module#const_get+ but is accessible at all levels,
-  # and, unlike +const_get+, can handle module hierarchy.
-  #
-  #   constant("Fixnum")                  # => Fixnum
-  #   constant(:Fixnum)                   # => Fixnum
-  #
-  #   constant("Process::Sys")            # => Process::Sys
-  #   constant("Regexp::MULTILINE")       # => 4
-  #
-  # TODO: As of Ruby 2.0, #constant can be deprecated, or aliased to #get_const.
-  #
-  # CREDIT: Trans
-
-  def constant(const)
-    const = const.to_s.dup
-    base = const.sub!(/^::/, '') ? Object : ( self.kind_of?(Module) ? self : self.class )
-    const.split(/::/).inject(base){ |mod, name| mod.const_get(name) }
-  end
-
-end

data/lib/core/facets/kernel/instance_exec.rb

@@ -1,47 +0,0 @@
-class Object #module Kernel
-
-  unless method_defined?(:instance_exec) # 1.9
-
-    require 'thread'
-
-    module InstanceExecMethods #:nodoc:
-    end
-
-    include InstanceExecMethods
-
-    # Evaluate the block with the given arguments within the context of
-    # this object, so self is set to the method receiver.
-    #
-    # From Mauricio's http://eigenclass.org/hiki/bounded+space+instance_exec
-    #
-    # This version has been borrowed from Rails for compatibility sake.
-    #
-    # NOTE: This is not a common core extension (due to the use of thread.rb)
-    # and is not loaded automatically when using <code>require 'facets'</code>.
-    # However it is a core method in Ruby 1.9, so this only matters for users
-    # of Ruby 1.8.x or below.
-    #
-    # @uncommon
-    #   require 'facets/kernel/instance_exec'
-    #
-    def instance_exec(*args, &block)
-      begin
-        old_critical, Thread.critical = Thread.critical, true
-        n = 0
-        n += 1 while respond_to?(method_name = "__instance_exec#{n}")
-        InstanceExecMethods.module_eval { define_method(method_name, &block) }
-      ensure
-        Thread.critical = old_critical
-      end
-
-      begin
-        __send__(method_name, *args)
-      ensure
-        InstanceExecMethods.module_eval { remove_method(method_name) } rescue nil
-      end
-    end
-
-  end
-
-end
-

data/lib/core/facets/kernel/p.rb

@@ -1,24 +0,0 @@
-module Kernel
-
-  # Alternate to standard #p method that outputs
-  # Kernel#inspect to stdout, but also passes through
-  # the orginal argument(s) ...
-  #
-  #   x = 1
-  #   r = 4 + p(1)
-  #   p r
-  #
-  # produces ...
-  #
-  #   1
-  #   5
-  #
-  # TODO: DEPRECATE as of 1.9, _if_ it will do this.
-
-  def p(*x)
-    x.each{ |e| puts e.inspect } #p(*x)
-    x.size > 1 ? x : x.last #x.last
-  end
-
-end
-

data/lib/core/facets/kernel/singleton_class.rb

@@ -1,10 +0,0 @@
-module Kernel
-
-  # Easy access to an object's "special" class.
-  #
-  # NOTE: This is already defined in Ruby 1.9+.
-  def singleton_class
-    (class << self; self; end)
-  end unless method_defined?(:singleton_class)
-
-end

data/lib/core/facets/matchdata/match.rb

@@ -1,15 +0,0 @@
-class MatchData
-
-  # Return the primary match string. This is equivalent to +md[0]+.
-  #
-  #   md = /123/.match "123456"
-  #   md.match  #=> "123"
-  #
-  # CREDIT: Martin DeMello
-
-  def match(index=0)
-    self[index]
-  end
-
-end
-

data/lib/core/facets/method/curry.rb

@@ -1,13 +0,0 @@
-require 'facets/proc'
-
-class Method
-  # Curry a Method into a new Proc.
-
-  def curry(*args)
-    to_proc.curry(*args)
-  end
-end
-
-
-# TODO: The question is as to whether to integrate this into Method::Composition,
-# or if Composition should be scuttled for just converting to Proc.

data/lib/core/facets/numeric/negative.rb

@@ -1 +0,0 @@
-require 'facets/numeric/positive'

data/lib/core/facets/numeric/positive.rb

@@ -1,15 +0,0 @@
-class Numeric
-
-  # Is a number greater than zero.
-  #
-  def positive?
-    self > 0
-  end
-
-  # Is a number less than zero.
-  #
-  def negative?
-    self < 0
-  end
-
-end

data/lib/core/facets/object/itself.rb

@@ -1,16 +0,0 @@
-class Object
-
-  # An identity method that provides access to an object's 'self'.
-  #
-  # Example
-  #
-  #   [1,2,3,4,5,1,2,2,3].group_by(&:itself)
-  #   #=> {1=>[1, 1], 2=>[2, 2, 2], 3=>[3, 3], 4=>[4], 5=>[5]}
-  #
-  # CREDIT: Michael Kohl
-
-  def itself
-    self
-  end
-
-end

data/lib/core/facets/object/try_dup.rb

@@ -1 +0,0 @@
-require 'facets/object/dup'

data/lib/core/facets/process/daemon.rb

@@ -1,32 +0,0 @@
-module Process
-
-  # Turns the current script into a daemon process
-  # that detaches from the console. It can be shut
-  # down with a TERM signal.
-  #
-  # CREDIT: David Heinemeier Hansson
-
-  def self.daemon(nochdir=nil, noclose=nil)
-    exit if fork # Parent exits, child continues.
-    Process.setsid # Become session leader.
-    exit if fork # Zap session leader. See [1].
-
-    unless nochdir
-      Dir.chdir "/" # Release old working directory.
-    end
-
-    File.umask 0000 # Ensure sensible umask. Adjust as needed.
-
-    unless noclose
-      STDIN.reopen "/dev/null" # Free file descriptors and
-      STDOUT.reopen "/dev/null", "a" # point them somewhere sensible.
-      STDERR.reopen '/dev/null', 'a'
-    end
-
-    trap("TERM") { exit }
-
-    return 0
-  end unless respond_to?(:daemon)
-
-end
-

data/lib/core/facets/range/overlap.rb

@@ -1,12 +0,0 @@
-class Range
-
-  # Do two ranges overlap?
-  #
-  # CREDIT: Daniel Schierbeck, Brandon Keepers
-
-  def overlap?(other)
-    include?(other.first) or other.include?(first)
-  end
-
-end
-

data/lib/core/facets/string/characters.rb

@@ -1,13 +0,0 @@
-class String
-
-  # Returns an array of characters.
-  #
-  #   "abc".characters.to_a  #=> ["a","b","c"]
-  #
-  # TODO: Probably should make this an enumerator. With #scan?
-  def characters
-    split(//)
-  end
-
-end
-

data/lib/core/facets/string/crypt.rb

@@ -1,22 +0,0 @@
-class String
-
-  alias_method :_crypt, :crypt
-
-  # Common Unix cryptography method.
-  # This adds a default salt to the built-in crypt method.
-  #
-  # NOTE: This method is not a common core extension and is not
-  # loaded automatically when using <code>require 'facets'</code>.
-  #
-  # @uncommon
-  #   require 'facets/string/crypt'
-  #
-  def crypt(salt=nil)
-    salt ||= (
-      (rand(26) + (rand(2) == 0 ? 65 : 97) ).chr +
-      (rand(26) + (rand(2) == 0 ? 65 : 97) ).chr
-    )
-    _crypt(salt)
-  end
-
-end

data/lib/core/facets/string/tab.rb

@@ -1,2 +0,0 @@
-# DEPRECATED
-require 'facets/string/indent'

data/lib/core/facets/string/tabto.rb

@@ -1,2 +0,0 @@
-# DEPRECATED
-require 'facets/string/margin'

data/lib/core/facets/symbol/succ.rb

@@ -1,23 +0,0 @@
-class Symbol
-
-  unless method_defined?(:succ)  # 1.9+ TODO: is this right?
-
-    # Successor method for symobol. This simply converts
-    # the symbol to a string uses String#succ and then
-    # converts it back to a symbol.
-    #
-    #   :a.succ  #=> :b
-    #
-    # TODO: Make this work more like a simple character dial?
-
-    def succ(n=1)
-      s = self.to_s
-      n.times do
-        s = s.succ
-      end
-      s.to_sym
-    end
-
-  end
-
-end

data/lib/core/facets.yml

@@ -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/lib/standard/facets/basicobject.rb

@@ -1,75 +0,0 @@
-# Facets' BasicObject is an implementation of Jim Weirich's BlankSlate.
-#
-# BlankSlate
-# Copyright 2004 by Jim Weirich (jim@weirichhouse.org).
-# All rights reserved.
-#
-# Since Ruby 1.9 has a BasicObject class this will of course be
-# deprecated as 1.9 goes mainstream.
-
-unless defined? BasicObject  # in case it already exists!
-
-  # BasicObject provides an abstract base class with no predefined
-  # methods (except for <tt>\_\_send__</tt> and <tt>\_\_id__</tt>).
-  # BlankSlate is useful as a base class when writing classes that
-  # depend upon <tt>method_missing</tt> (e.g. dynamic proxies).
-  class BasicObject
-    class << self
-      # Hide the method named +name+ in the BlankSlate class.  Don't
-      # hide +instance_eval+ or any method beginning with "__".
-      #
-      # According to 1.9.1 it should have only these methods:
-      #
-      # * #__send__
-      # * #instance_eval
-      # * #instance_exec
-      # * #equal?
-      # * #==
-      # * #!
-      # * #!=
-      # * respond_to?
-      #
-      # Seems to me it should have #__id__ too.
-      def hide(name)
-        undef_method name if
-          instance_methods.include?(name.to_s) and
-          name !~ /^(__|respond_to\?|instance_eval$|instance_exec$|equal\?$|\=\=$)/
-      end
-    end
-    instance_methods.each{ |m| hide(m) }
-  end
-
-  # Since Ruby is very dynamic, methods added to the ancestors of
-  # BlankSlate <em>after BlankSlate is defined</em> will show up in the
-  # list of available BlankSlate methods.  We handle this by defining a
-  # hook in the Object and Kernel classes that will hide any defined
-  module Kernel #:nodoc:
-    class << self
-      alias_method :facets_basic_object_method_added, :method_added
-
-      # Detect method additions to Kernel and remove them in the
-      # BlankSlate class.
-      def method_added(name)
-        facets_basic_object_method_added(name)
-        return if self != Kernel
-        BasicObject.hide(name)
-      end
-    end
-  end
-
-  class Object #:nodoc:
-    class << self
-      alias_method :facets_basic_object_method_added, :method_added
-
-      # Detect method additions to Object and remove them in the
-      # BlankSlate class.
-      def method_added(name)
-        facets_basic_object_method_added(name)
-        return if self != Object
-        BasicObject.hide(name)
-      end
-    end
-  end
-
-end
-

data/lib/standard/facets/digest/base64digest.rb

@@ -1,45 +0,0 @@
-require 'digest'
-
-module Digest
-
-  module Instance
-
-    # For Ruby < 1.9.2
-   
-    unless instance_methods.include? :base64digest
-
-      # From Ruby 1.9.2 source
-      def base64digest(str = nil)
-        [str ? digest(str) : digest].pack('m0')
-      end
-
-    end
-
-    unless instance_methods.include? :base64digest!
-
-      # From Ruby 1.9.2 source
-      def base64digest!
-        [digest!].pack('m0')
-      end
-
-    end
-
-  end
-
-  class Class
-
-    # For Ruby < 1.9.2   
-
-    unless methods.include? :base64digest
-
-      # From Ruby 1.9.2 source
-      def self.base64digest(str, *args)
-        [self.digest(str, *args)].pack('m0') 
-      end
-
-    end
-
-  end
-
-end
-

data/lib/standard/facets/ostruct/each.rb

@@ -1,11 +0,0 @@
-require 'ostruct'
-
-class OpenStruct
-
-  # Iterate over key-value pairs.
-  #
-  def each(&blk)
-    @table.each(&blk)
-  end
-
-end

data/lib/standard/facets/ostruct/merge.rb

@@ -1,21 +0,0 @@
-require 'ostruct'
-
-class OpenStruct
-
-  # Insert/update hash data on the fly.
-  #
-  #   o = OpenStruct.new
-  #   o.merge!(:a => 2)
-  #   o.a  #=> 2
-  #
-  def merge!(other)
-    raise TypeError, "can't modify frozen #{self.class}", caller(1) if self.frozen?
-    ##other = other.to_hash #to_h?
-    for k,v in other
-      @table[k.to_sym] = v
-    end
-    self
-  end
-
-end
-

data/lib/standard/facets/ostruct/op_fetch.rb

@@ -1,29 +0,0 @@
-require 'ostruct'
-
-class OpenStruct
-
-  # Access a value in the OpenStruct by key, like a Hash.
-  # This increases OpenStruct's "duckiness".
-  #
-  #   o = OpenStruct.new
-  #   o.t = 4
-  #   o['t']  #=> 4
-  #
-  def [](key)
-    key = key.to_sym unless key.is_a?(Symbol)
-    @table[key]
-  end
-
-  # Set a value in the OpenStruct by key, like a Hash.
-  #
-  #   o = OpenStruct.new
-  #   o['t'] = 4
-  #   o.t  #=> 4
-  #
-  def []=(key,val)
-    raise TypeError, "can't modify frozen #{self.class}", caller(1) if self.frozen?
-    key = key.to_sym unless key.is_a?(Symbol)
-    @table[key]=val
-  end
-
-end

data/lib/standard/facets/ostruct/op_store.rb

@@ -1 +0,0 @@
-require 'facets/ostruct/op_fetch'

data/lib/standard/facets/ostruct/to_h.rb

@@ -1,10 +0,0 @@
-require 'ostruct'
-
-class OpenStruct
-
-  #
-  def to_h
-    @table.dup
-  end
-
-end