facets 1.3.3 → 1.4.0

data/doc/TODO

@@ -1,73 +0,0 @@
-
-= Facets' To Do List
-
-IT IS ALWAYS A GOOD IDEA TO WRITE A TEST!
-AND ITS ALWAYS A FINE THING TO IMPROVE DOCUMENTATION!
-
-* Move methods to facets/method and link back to facet/ but prefer library alias
-  instead. (Rolls)
-
-* hash/invert: What about letting Hash#invert take a block that specifies
-  what to do when a collision occurs?
-
-* hash/at_rand: allow for a _number_ of values, keys and pairs to be returned.
-
-* > Yep. Gone. But I may replace with a version that deletes only the first 
-  > matching element. Thoughts?
-  If you don't want to do that I would rather add an option hash to .delete and
-  use :once => true or something similar. (More expressive)
-
-* numeric/bound_by: Numeric includes Comparable. Maybe drop this, but 
-  might it be reasonable for Numeric but no other comparables?
-
-* nil/[]: Why should nil respond to [], but not to .each? I don't think 
-  nil should be treated as a container.
-  nil/length: See above.
-
-* nil/method_missing: I'm not so sure about this. There is a lot of 
-  libraries depending on nil raising exceptions on failed method access. I 
-  also think that this could make programming errors very hard to find.
-
-* fileutils/head&tail: Hm, I think the block forms ought to be equivalent to 
-  tail -f and so on. Then the block forms should also return all lines by default
-  instead of only the first 10.
-
-* fileutils/which: Should probably be based on fileutils/where_is as they have 
-  lots of common code. The two methods should probably also use RUBY_PLATFORM instead
-  of checking for ALT_SEPARATOR.
-
-* module/memoize: Should the main memoize method be defined as it is? 
-  (see bottom of file).
-
-* kernel/demo: It can be implemented as demo "1+1"  using Binding.of_caller. 
-  Using only the block is possibly with SCRIPT_LINES__ or File access and is quite ugly.
-
-* hash/weave: Document how does it compare to Hash#merge?
-
-* Perhaps work on alernative require mechinism. Currently there is none.
-  Here some pseudo docs for it:
-
-    and an alternative interface to requiring the extension methods.
-    With the Facets module you can require a facet method like so:
-
-      Facets.require Time, :stamp
-
-    One of the advantages of this approach is that Facets' can search the class hierarchy
-    for a method. For example if you wanted to use #each_permutation on an Array.
-
-      Facets.require 'array/each_permutation'
-
-    Even though #each_permutation is a method of Enumerable this will still work
-    because Enumerable is a superclass of Array.
-
-    Also it allows for the use operators without special recourse.
-    For instance, the Proc compostion operator can be require simply.
-
-      Facets.require 'proc/*'
-
-    If you're wondering why you have to specify the Facets module in #use,
-    it is becuase #use is a generalized method. Anyone can easily take advantage
-    of this functionality by utilizing Facets' Module-Package system (package.rb).
-    See the API Documentation for further details of putting this to use in your
-    programs.
-

data/doc/noauto

@@ -1,63 +0,0 @@
-# Files not loaded as part of the full feature set b/c
-# they either require other files that are not normally loaded
-# automatically (like fileutils), or effect the interpretor in a 
-# manner considered "fagile", or they override standard methods and
-# although may be designed to be backward compatible have not been 
-# tested enough to insure against potential problems.
-
-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   # b/c it always makes a writer
-#module/attr_reader.rb
-#module/attr_writer.rb
-#module/attr_accessor.rb
-
-# Files not included with the full feature set b/c they are potentially
-# unsafe b/c they change Ruby's default behavior in a nonconvential
-# manner and hence are not 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
-
-# These classes are not automatically loaded by Ruby 
-# (i.e. they are part of the standard lib, not core)
-# This really only applies to an "all" file which 
-# we currently dont have. So don;t worry about these
-# for now.
-
-#date/*
-#fileutils/*
-#ostruct/*
-#logger/*
-#gem/*
-
-# No longer avoided. While possible incompatibilities may arise
-# it is clear that would only do so under very bad programming
-# practices anyway. Better to discourage those practices 
-# than cater to them.
-
-#string/to_a.rb
-
-# Can't find anything inheritently wrong with this. It may 
-# seem odd, but it doesn't break anything.
-
-#object/new.rb
-

data/lib/facet/array.rb

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

data/lib/facet/class.rb

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

data/lib/facet/comparable.rb

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

data/lib/facet/continuation.rb

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

data/lib/facet/date.rb

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

data/lib/facet/dir.rb

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

data/lib/facet/enumerable.rb

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

data/lib/facet/file.rb

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

data/lib/facet/fileutils.rb

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

data/lib/facet/float.rb

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

data/lib/facet/gem.rb

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

data/lib/facet/hash.rb

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

data/lib/facet/integer.rb

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

data/lib/facet/kernel.rb

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

data/lib/facet/logger.rb

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

data/lib/facet/matchdata.rb

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

data/lib/facet/module.rb

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

data/lib/facet/module/undef.rb

@@ -1 +0,0 @@
-require 'facets/core/module/undef.rb'

data/lib/facet/nilclass.rb

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

data/lib/facet/numeric.rb

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

data/lib/facet/pathname.rb

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

data/lib/facet/proc.rb

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

data/lib/facet/range.rb

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

data/lib/facet/regexp.rb

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

data/lib/facet/string.rb

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

data/lib/facet/symbol.rb

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

data/lib/facet/time.rb

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

data/lib/facet/unboundmethod.rb

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

data/lib/facets/core/array.rb

@@ -1,35 +0,0 @@
-require 'facets/core/array/at_rand'
-require 'facets/core/array/body'
-require 'facets/core/array/delete_unless'
-require 'facets/core/array/delete_values'
-require 'facets/core/array/delete_values_at'
-require 'facets/core/array/each_with_key'
-require 'facets/core/array/first'
-require 'facets/core/array/foot'
-require 'facets/core/array/head'
-require 'facets/core/array/join_sentence'
-require 'facets/core/array/last'
-require 'facets/core/array/last_index'
-require 'facets/core/array/merge'
-require 'facets/core/array/mid'
-require 'facets/core/array/middle'
-require 'facets/core/array/op_fetch'
-require 'facets/core/array/op_mod'
-require 'facets/core/array/op_store'
-require 'facets/core/array/pick'
-require 'facets/core/array/pos'
-require 'facets/core/array/pot'
-require 'facets/core/array/pull'
-require 'facets/core/array/rand_index'
-require 'facets/core/array/rand_subset'
-require 'facets/core/array/range'
-require 'facets/core/array/rotate'
-require 'facets/core/array/select'
-require 'facets/core/array/shuffle'
-require 'facets/core/array/store'
-require 'facets/core/array/tail'
-require 'facets/core/array/thru'
-require 'facets/core/array/to_b'
-require 'facets/core/array/to_h'
-require 'facets/core/array/to_hash'
-require 'facets/core/array/unzip'

data/lib/facets/core/class.rb

@@ -1,11 +0,0 @@
-require 'facets/core/class/by_name'
-require 'facets/core/class/cattr'
-require 'facets/core/class/cattr_accessor'
-require 'facets/core/class/cattr_reader'
-require 'facets/core/class/cattr_writer'
-require 'facets/core/class/descendents'
-require 'facets/core/class/method_name'
-require 'facets/core/class/remove_descendents'
-require 'facets/core/class/remove_subclasses'
-require 'facets/core/class/subclasses'
-require 'facets/core/class/unix_path'

data/lib/facets/core/comparable.rb

@@ -1,5 +0,0 @@
-require 'facets/core/comparable/at_least'
-require 'facets/core/comparable/at_most'
-require 'facets/core/comparable/cap'
-require 'facets/core/comparable/clip'
-require 'facets/core/comparable/cmp'

data/lib/facets/core/continuation.rb

@@ -1 +0,0 @@
-require 'facets/core/continuation/self/create'

data/lib/facets/core/date.rb

@@ -1,6 +0,0 @@
-require 'facets/core/date/days_in_month'
-require 'facets/core/date/days_of_month'
-require 'facets/core/date/stamp'
-require 'facets/core/date/to_date'
-require 'facets/core/date/to_s'
-require 'facets/core/date/to_time'

data/lib/facets/core/dir.rb

@@ -1,4 +0,0 @@
-require 'facets/core/dir/self/ancestor'
-require 'facets/core/dir/self/ascend'
-require 'facets/core/dir/self/ls_r'
-require 'facets/core/dir/self/recurse'

data/lib/facets/core/enumerable.rb

@@ -1,42 +0,0 @@
-require 'facets/core/enumerable/accumulate'
-require 'facets/core/enumerable/collect_if'
-require 'facets/core/enumerable/collect_with_counter'
-require 'facets/core/enumerable/collect_with_index'
-require 'facets/core/enumerable/commonality'
-require 'facets/core/enumerable/compact_collect'
-require 'facets/core/enumerable/compact_map'
-require 'facets/core/enumerable/cross'
-require 'facets/core/enumerable/each_by'
-require 'facets/core/enumerable/each_combination'
-require 'facets/core/enumerable/each_pair'
-require 'facets/core/enumerable/each_permutation'
-require 'facets/core/enumerable/each_slice'
-require 'facets/core/enumerable/each_unique_pair'
-require 'facets/core/enumerable/each_with_counter'
-require 'facets/core/enumerable/elementwise'
-require 'facets/core/enumerable/entropy'
-require 'facets/core/enumerable/every'
-require 'facets/core/enumerable/ew'
-require 'facets/core/enumerable/filter_collect'
-require 'facets/core/enumerable/filter_map'
-require 'facets/core/enumerable/find_collisions'
-require 'facets/core/enumerable/frequency'
-require 'facets/core/enumerable/graph'
-require 'facets/core/enumerable/ideal_entropy'
-require 'facets/core/enumerable/map_if'
-require 'facets/core/enumerable/map_with_counter'
-require 'facets/core/enumerable/map_with_index'
-require 'facets/core/enumerable/none'
-require 'facets/core/enumerable/nonuniq'
-require 'facets/core/enumerable/occur'
-require 'facets/core/enumerable/one'
-require 'facets/core/enumerable/op_pow'
-require 'facets/core/enumerable/partition_by'
-require 'facets/core/enumerable/permute'
-require 'facets/core/enumerable/probability'
-require 'facets/core/enumerable/project'
-require 'facets/core/enumerable/self/combinations'
-require 'facets/core/enumerable/self/cross'
-require 'facets/core/enumerable/to_h'
-require 'facets/core/enumerable/uniq_by'
-require 'facets/core/enumerable/where'

data/lib/facets/core/file.rb

@@ -1,8 +0,0 @@
-require 'facets/core/file/self/append'
-require 'facets/core/file/self/create'
-require 'facets/core/file/self/open_as_string'
-require 'facets/core/file/self/read_binary'
-require 'facets/core/file/self/read_list'
-require 'facets/core/file/self/sanitize'
-require 'facets/core/file/self/split_all'
-require 'facets/core/file/self/write'

data/lib/facets/core/fileutils.rb

@@ -1,8 +0,0 @@
-require 'facets/core/fileutils/head'
-require 'facets/core/fileutils/safe_ln'
-require 'facets/core/fileutils/slice'
-require 'facets/core/fileutils/split_all'
-require 'facets/core/fileutils/tail'
-require 'facets/core/fileutils/wc'
-require 'facets/core/fileutils/whereis'
-require 'facets/core/fileutils/which'

data/lib/facets/core/float.rb

@@ -1,4 +0,0 @@
-require 'facets/core/float/approx'
-require 'facets/core/float/round_at'
-require 'facets/core/float/round_off'
-require 'facets/core/float/round_to'

data/lib/facets/core/gem.rb

@@ -1,4 +0,0 @@
-require 'facets/core/gem/self/active'
-require 'facets/core/gem/self/gemdir'
-require 'facets/core/gem/self/gempath'
-require 'facets/core/gem/self/gemspec'

data/lib/facets/core/hash.rb

@@ -1,40 +0,0 @@
-require 'facets/core/hash/alias'
-require 'facets/core/hash/assert_has_keys'
-require 'facets/core/hash/assert_has_only_keys'
-require 'facets/core/hash/at'
-require 'facets/core/hash/collate'
-require 'facets/core/hash/delete_unless'
-require 'facets/core/hash/each'
-require 'facets/core/hash/each_with_index'
-require 'facets/core/hash/each_with_key'
-require 'facets/core/hash/graph'
-require 'facets/core/hash/has_keys'
-require 'facets/core/hash/has_only_keys'
-require 'facets/core/hash/inverse'
-require 'facets/core/hash/join'
-require 'facets/core/hash/keys_to_iv'
-require 'facets/core/hash/keys_to_s'
-require 'facets/core/hash/keys_to_sym'
-require 'facets/core/hash/op_fetch'
-require 'facets/core/hash/op_lshift'
-require 'facets/core/hash/op_store'
-require 'facets/core/hash/rand_key'
-require 'facets/core/hash/rand_pair'
-require 'facets/core/hash/rand_value'
-require 'facets/core/hash/replace_each'
-require 'facets/core/hash/self/zipnew'
-require 'facets/core/hash/shuffle'
-require 'facets/core/hash/slice'
-require 'facets/core/hash/stringify_keys'
-require 'facets/core/hash/swap'
-require 'facets/core/hash/swapkey'
-require 'facets/core/hash/symoblize_keys'
-require 'facets/core/hash/to_h'
-require 'facets/core/hash/to_ostruct'
-require 'facets/core/hash/to_ostruct_recurse'
-require 'facets/core/hash/traverse'
-require 'facets/core/hash/update_each'
-require 'facets/core/hash/update_keys'
-require 'facets/core/hash/update_values'
-require 'facets/core/hash/variablize_keys'
-require 'facets/core/hash/weave'

data/lib/facets/core/integer.rb

@@ -1,9 +0,0 @@
-require 'facets/core/integer/even'
-require 'facets/core/integer/fac'
-require 'facets/core/integer/fact'
-require 'facets/core/integer/factorial'
-require 'facets/core/integer/multiple'
-require 'facets/core/integer/odd'
-require 'facets/core/integer/ordinal'
-require 'facets/core/integer/times_collect'
-require 'facets/core/integer/times_map'

data/lib/facets/core/kernel.rb

@@ -1,69 +0,0 @@
-require 'facets/core/kernel/__DIR__'
-require 'facets/core/kernel/__class__'
-require 'facets/core/kernel/__self__'
-require 'facets/core/kernel/adhoc'
-require 'facets/core/kernel/as'
-require 'facets/core/kernel/assign_from'
-require 'facets/core/kernel/assign_with'
-require 'facets/core/kernel/autoreload'
-require 'facets/core/kernel/autoreload_files'
-require 'facets/core/kernel/autoreload_glob'
-require 'facets/core/kernel/bool'
-require 'facets/core/kernel/bug'
-require 'facets/core/kernel/call_stack'
-require 'facets/core/kernel/called'
-require 'facets/core/kernel/complete'
-require 'facets/core/kernel/constant'
-require 'facets/core/kernel/copy'
-require 'facets/core/kernel/deep_copy'
-require 'facets/core/kernel/demo'
-require 'facets/core/kernel/eigenclass'
-require 'facets/core/kernel/false'
-require 'facets/core/kernel/fn'
-require 'facets/core/kernel/generate_method_name'
-require 'facets/core/kernel/get_by_id'
-require 'facets/core/kernel/here'
-require 'facets/core/kernel/in'
-require 'facets/core/kernel/instance_assign'
-require 'facets/core/kernel/instvar'
-require 'facets/core/kernel/is'
-require 'facets/core/kernel/maybe'
-require 'facets/core/kernel/me'
-require 'facets/core/kernel/metaclass'
-require 'facets/core/kernel/method'
-require 'facets/core/kernel/method_name'
-require 'facets/core/kernel/methodname'
-require 'facets/core/kernel/methods'
-require 'facets/core/kernel/nack'
-require 'facets/core/kernel/new'
-require 'facets/core/kernel/object_class'
-require 'facets/core/kernel/object_hexid'
-require 'facets/core/kernel/op_esc'
-require 'facets/core/kernel/own'
-require 'facets/core/kernel/p'
-require 'facets/core/kernel/pp_exception'
-require 'facets/core/kernel/require_all'
-require 'facets/core/kernel/require_esc'
-require 'facets/core/kernel/require_facet'
-require 'facets/core/kernel/require_local'
-require 'facets/core/kernel/resc'
-require 'facets/core/kernel/returning'
-require 'facets/core/kernel/send_as'
-require 'facets/core/kernel/set_from'
-require 'facets/core/kernel/set_with'
-require 'facets/core/kernel/silence_warnings'
-require 'facets/core/kernel/silently'
-require 'facets/core/kernel/singleton'
-require 'facets/core/kernel/superior'
-require 'facets/core/kernel/supermethod'
-require 'facets/core/kernel/this'
-require 'facets/core/kernel/to_b'
-require 'facets/core/kernel/to_bool'
-require 'facets/core/kernel/true'
-require 'facets/core/kernel/unuri'
-require 'facets/core/kernel/uri'
-require 'facets/core/kernel/val'
-require 'facets/core/kernel/warn_with_line'
-require 'facets/core/kernel/with_accessor'
-require 'facets/core/kernel/with_reader'
-require 'facets/core/kernel/with_writer'