facets 1.7.46 → 1.8.0

data/lib/facet/proc/bind.rb

@@ -0,0 +1 @@
+require 'facets/core/proc/bind.rb'

data/lib/facet/proc/to_h.rb

@@ -0,0 +1 @@
+require 'facets/core/proc/to_h.rb'

data/lib/facet/proc/update.rb

@@ -0,0 +1 @@
+require 'facets/core/proc/update.rb'

data/lib/facet/script.rb

@@ -0,0 +1 @@
+require 'facets/more/script.rb'

data/lib/facet/string/rewrite.rb

@@ -0,0 +1 @@
+require 'facets/core/string/rewrite.rb'

data/lib/facet/symbol/chomp.rb

@@ -0,0 +1 @@
+require 'facets/core/symbol/chomp.rb'

data/lib/facet/uploadutils.rb

@@ -0,0 +1 @@
+require 'facets/more/uploadutils.rb'

data/lib/facet/version_number.rb

@@ -0,0 +1 @@
+require 'facets/more/version_number.rb'

data/lib/facets.rb

@@ -28,14 +28,6 @@
 #   require 'functor'
 #
 
-# Rolls Support
-# TODO Better detection
-#if defined?(Library)
-#  Library.new( 'facets' ) do |l|
-#    l.title = "Ruby Facets"
-#  }
-#end
-
 $: << File.join( File.dirname(__FILE__), 'facets/core' )
 $: << File.join( File.dirname(__FILE__), 'facets/more' )
 
@@ -45,15 +37,10 @@ $: << File.join( File.dirname(__FILE__), 'facets/more' )
 #
 # This list is still being refined.
 #
-# NOTE
-#
-# The #cmp methods are simply aliases for #<=>, they
-# are here b/c String.succ is not compataible
+# Note that the #cmp methods are simply aliases for #<=>,
+# they are here b/c String.succ is not compataible
 # with it's own #<=> method. The #cmp method proves
-# an effective way of dealing with when needs be.
-
-# DEPRECATED Use Facets.require instead (now not even that!)
-#require 'kernel/require_facet'
+# an effective way of dealing with when needed.
 
 # Elementary
 require 'facets/core/comparable/cmp'
@@ -102,194 +89,3 @@ require 'facets/core/kernel/as'
 require 'facets/core/hash/op_div'
 require 'facets/core/array/op_div'
 
-module Facets
-
-  extend self
-
-  OPERATORS = %w{ +@ -@ + - ** * / % ~ <=> << >> < > === == =~ <= >= | & ^ []= [] }
-  OPERATORS_REGEXP = Regexp.new( '(' << OPERATORS.collect{ |k| Regexp.escape(k) }.join('|') << ')' )
-  OPERATORS_ESCAPE = {
-     "+@"   => "op_plus_self",
-     "-@"   => "op_minus_self",
-     "+"    => "op_plus",
-     "-"    => "op_minus",
-     "**"   => "op_pow",
-     "*"    => "op_mul",
-     "/"    => "op_div",
-     "%"    => "op_mod",
-     "~"    => "op_tilde",
-     "<=>"  => "op_cmp",
-     "<<"   => "op_lshift",
-     ">>"   => "op_rshift",
-     "<"    => "op_lt",
-     ">"    => "op_gt",
-     "==="  => "op_case_eq",
-     "=="   => "op_equal",
-     "=~"   => "op_apply",
-     "<="   => "op_lt_eq",
-     ">="   => "op_gt_eq",
-     "|"    => "op_or",
-     "&"    => "op_and",
-     "^"    => "op_xor",
-     "[]="  => "op_store",
-     "[]"   => "op_fetch"
-  }
-
-  CLASS_ANCESTORS = {
-    'array'         => ['enumerable','kernel'],
-    'binding'       => ['kernel'],
-    'class'         => ['module','kernel'],
-    'comparable'    => ['kernel'],
-    'continuation'  => ['kernel'],
-    'date'          => ['comparable','kernel'],
-    'dir'           => ['enumerable','kernel'],
-    'enumerable'    => ['kernel'],
-    'file'          => ['io','enumerable','kernel'],
-    'fileutils'     => ['kernel'],
-    'float'         => ['precision','numeric','comparable','kernel'],
-    'hash'          => ['enumerable','kernel'],
-    'integer'       => ['precision','numeric','comparable','kernel'],
-    'kernel'        => ['kernel'],
-    'logger'        => ['kernel'],
-    'matchdata'     => ['kernel'],
-    'module'        => ['kernel'],
-    'nilclass'      => ['kernel'],
-    'numeric'       => ['comparable','kernel'],
-    'ostruct'       => ['kernel'],
-    'pathname'      => ['kernel'],
-    'proc'          => ['kernel'],
-    'range'         => ['enumerable','kernel'],
-    'regexp'        => ['kernel'],
-    'string'        => ['enumerable','comparable','kernel'],
-    'symbol'        => ['kernel'],
-    'time'          => ['comparable','kernel'],
-    'unboundmethod' => ['kernel'],
-  }
-
-  NOAUTO = %w{
-    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
-    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
-    date/*
-    fileutils/*
-    ostruct/*
-    logger/*
-    gem/*
-  }
-
-  METHDIR = "facet"
-
-  def op_esc( str )
-    str = str.to_s.chomp('.rb')
-    str = str.strip.gsub(OPERATORS_REGEXP){ OPERATORS_ESCAPE[$1] }
-    str.chomp('?').chomp('!').chomp('=')
-  end
-
-  # Subs terms for Ruby's operators
-  # and removes any trailing ? ! or =.
-  def op_esc_path( name )
-    ri = name.rindex('/')
-    if ri
-      dir, file = name[0...ri], name[ri+1..-1]
-    else
-      dir, file = nil, name
-    end
-    file = op_esc(file.strip)
-    dir ? File.join( dir, file ) : file
-  end
-
-  # Returns a file list of all extensions.
-  def extensions
-    return @all_extensions if @all_extensions
-    Dir.chdir( File.join( Config::CONFIG['sitelibdir'], METHDIR ) ) do
-      all = Dir.glob( '*/*.rb' ) + Dir.glob( '*/*/*.rb' )
-    end
-    @extensions = all
-  end
-
-  # Returns file list of all extensions minus the ones that should not be autoloaded.
-  def extensions_nice
-    @safe_extensions ||= nice_only( extensions )
-  end
-
-  # Removes the NOAUTO files from the given extensions list.
-  def nice_only( exts )
-    exts = exts.dup
-    NOAUTO.each do |f|
-      if f.include?('*')
-        re = %r"#{f.gsub('*','.*')}"
-        exts.reject!{ |x| x =~ re }
-      elsif exts.include?(f)
-        exts.delete f
-      end
-    end
-    exts.sort
-  end
-
-
-  # DEPRECATE
-
-  alias_method :require_facetless, :require
-
-  # DEPRECATE (Another way to handle subclasses?)
-
-  def require( fname )
-    paths = fname.split('/')
-    klass = paths[0].downcase
-    if CLASS_ANCESTORS.key?( klass )
-      if paths.size > 1
-        klass = paths[0].downcase
-        ancestors = CLASS_ANCESTORS[ klass ] || []
-        paths[-1] = op_esc( paths[-1] )
-        begin
-          paths[0] = klass
-          require_facetless( File.join( METHDIR, *paths ) )
-        rescue LoadError => e
-          klass = ancestors.shift
-          retry if klass
-          raise e
-        end
-      else
-        require_facetless( File.join( METHDIR, fname ) )
-      end
-    else
-      require_facetless( File.join( METHDIR, fname ) )
-    end
-  end
-
-end
-
-
-# Override Kernel require method to reroute Facet requires.
-#
-#module Kernel
-#
-#  alias_method :require_facetless, :require
-#
-#  def require( fname )
-#    if /^(facet|facets|nano)[\/\\]/ =~ fname
-#      Facets.require($')
-#    else
-#      require_facetless( fname )
-#    end
-#  end
-#
-#end
-#
-

data/lib/facets/automatic.rb

@@ -0,0 +1,29 @@
+
+require 'facets/sys'
+
+# = Facets Automatic
+#
+# This module is included into the Object class
+# and allows missing methods to be automatically
+# loaded from facets.
+
+module Facets::Automatic
+
+  #alias method_was_missing method_missing
+
+  def method_missing( sym, *args, &blk )
+    begin
+      if Facets.require(self.class, sym)
+        return send( sym, *args, &blk )
+      end
+    rescue LoadError
+      super
+    end
+    super
+  end
+
+end
+
+class Object
+  include Facets::Automatic
+end

data/lib/facets/core/all.rb

@@ -1,4 +1,4 @@
-require 'facets'
+require 'facets/sys'
 
 Facets.extensions_nice.each do |f|
   require File.join( Facets::METHDIR, f )

data/lib/facets/core/array/index.rb

@@ -0,0 +1,15 @@
+# TODO Remove Array#index when future Ruby has it.
+
+class Array
+
+  alias :index_of :index
+
+  # Allows block usage with index.
+
+  def index(obj=nil,&blk)
+    return index_of(obj) unless block_given?
+    i=0; i+=1 until yield(self[i])
+    return i
+  end
+
+end

data/lib/facets/core/array/to_path.rb

@@ -0,0 +1,11 @@
+
+class Array
+
+  # Turn an array into a file path.
+
+  def to_path
+    File.join( *(self.compact) )
+  end
+
+end
+

data/lib/facets/core/class/class_load.rb

@@ -0,0 +1,3 @@
+# stub
+require 'facets/core/module/module_load.rb'
+

data/lib/facets/core/class/class_require.rb

@@ -0,0 +1,3 @@
+# stub
+require 'facets/core/module/module_load.rb'
+

data/lib/facets/core/config/inspect.rb

@@ -0,0 +1,9 @@
+require 'rbconfig'
+
+module Config
+
+  def self.inspect
+    CONFIG.inspect
+  end
+
+end

data/lib/facets/core/dir/self/multiglob.rb

@@ -0,0 +1,32 @@
+
+# Like +glob+ but can take multiple patterns.
+#
+#   Dir.multiglob( '*.rb', '*.py' )
+#
+# TODO This does not yet support glob flags.
+
+def Dir.multiglob( *patterns )
+  patterns = [patterns].flatten.compact
+  patterns.collect{ |pattern| Dir.glob(pattern) }.flatten.uniq
+end
+
+# The same as +multiglob+, but recusively includes directories.
+#
+#   Dir.multiglob_recurse( 'folder' )
+#
+# is equivalent to
+#
+#   Dir.multiglob( 'folder', 'folder/**/*' )
+#
+# TODO This does not yet support glob flags.
+
+def Dir.multiglob_recurse( *patterns )
+  patterns = [patterns].flatten.compact
+  files = patterns.collect{ |pattern| Dir.glob(pattern) }.flatten.uniq
+  files.each do |f|
+    if File.directory?(f)
+      patterns |= [ File.join(f, '**', '*' ) ]
+    end
+  end
+  patterns.collect{ |pattern| Dir.glob(pattern) }.flatten.uniq
+end

data/lib/facets/core/dir/self/multiglob_recurse.rb

@@ -0,0 +1,5 @@
+# = multiglob-recurse.rb
+#
+# Stub for multiglob.
+
+require 'facets/core/dir/self/multiglob.rb'

data/lib/facets/core/dir/self/multiglob_sum.rb

@@ -0,0 +1,40 @@
+# Summation glob. This is like multiglob but handles pattern
+# prefixes '+' and '-'. If the +files+ pattern list does not
+# start with a '+' or '-' entry, then the base is not included.
+#
+# For exmple, to collect all files in the current directory,
+# less rubby scripts:
+#
+#   Dir.multiglob_sum( '*', '-*.rb' )
+#
+# This is very useful in collecting files as specificed by
+# a configuration parameter. It easily takes the place of three
+# settings: include, exclude, and append-to-default.
+
+def Dir.multiglob_sum(base, *files)
+  base  = [base].flatten.compact
+  files = files.flatten.compact
+
+  if files.empty?
+    files = base
+  elsif files.first =~ /^[+-]/
+    files = base + files
+  end
+
+  #files.flatten!
+
+  files_include = files.select{ |f| f !~ /^-/ }
+  files_exclude = files.select{ |f| f =~ /^-/ }
+
+  files_include.collect!{ |f| f =~ /^[+-]/ ? f[1..-1] : f }
+  files_exclude.collect!{ |f| f =~ /^[+-]/ ? f[1..-1] : f }
+
+  f = []
+  f += Dir.multiglob_recurse(files_include)
+  f -= Dir.multiglob_recurse(files_exclude)
+  #f -= Dir.multiglob_recurse(MUST_EXCLUDE)
+
+  f = f.select{ |f| File.file?(f) }
+
+  return f
+end

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

@@ -1,3 +1,4 @@
+# THIS IS DEPRECATED IN FAVOR OF ENUMERATOR'S VERSION
 require 'enumerator'
 
 =begin

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

@@ -11,7 +11,7 @@ module Enumerable
   #   ['a','b','c'].every.upcase  #=> ['A','B','C']
   #
   def every
-    Functor.new do |op,*args|
+    @_functor_every ||= Functor.new do |op,*args|
       self.collect{ |a| a.send(op,*args) }
     end
   end
@@ -23,7 +23,7 @@ class Array
 
   # In place version of #every.
   def every!
-    Functor.new do |op,*args|
+    @_functor_every_inplace ||= Functor.new do |op,*args|
       self.replace( self.collect{ |a| a.send(op,*args) } )
     end
   end