facets 2.6.0 → 2.7.0

data/doc/release-notes/RELEASE-2.4.5

@@ -1,37 +0,0 @@
-Facets 2.4.5 is a maintaince release. This release is notable
-however in that it will likely be the last that to use SVN.
-Facets will be switching to Git. Also, some libraries that
-have been flagged "to be deprecated" for some time will
-finally be so.
-
-
-### 2.4.5 / 2008-10-02
-
-* 6 Major Enhancements
-
-    * Re-added date.rb to lore library, and removed from core.  (#r1014)
-    * Much improved date.rb extension now in Lore library.  (#r1027)
-    * Deprecated kernel/suppress. Use Exception.suppress from now on.  (#r1040)
-    * Deprecated string/style.rb. Use English project instead.  (#r1074)
-    * Console namespace is no longer supported (for Ansicode).  (#r1077)
-    * enumerable/mode.rb, Enumerable#mode returns array since there can be more than one.  (#r1079)
-    * OpenCascade automatically creates nodes, use foo? to query.  (#r1056)
-
-* 11 Minor Enhancements
-
-    * Moved variablize methods out of metaid.rb and into separate files (string/ and symbol/).  (#r1042)
-    * Added Time#advance.  (#r1046)
-    * Speed up of Integer odd/even methods.  (#r1057)
-    * Array#index now takes a block (this is a core override).  (#r1059)
-    * Spilt file/write.rb into separate method files (append, create, writelines).  (#r1073)
-    * Modified Enumerable#split to behave like String#split.  (#r1076)
-    * hash/op.rb, split into separate method files.  (#r1081)
-    * Added string/modulize. string/methodize handles path names now too.  (#r1085)
-    * Class#cattr is now part of core.  (#r1089)
-
-* 2 Bug Fixes
-
-    * OpenStruct#to_h dups internal table.  (#r1015)
-    * Fixed require of string/xor in bicrypt.rb.  (#r1039)
-    * integer/odd.rb, fixed Ruby 1.9 condition.  (#r1080)
-

data/doc/release-notes/RELEASE-2.5.0

@@ -1,83 +0,0 @@
-Facets 2.5.0 is an important milestone in the development of Facets.
-
-This release has been tested against Rails' ActiveSupport library.
-As long as Facets is loaded after ActiveSupport, everything
-should work fine. Of course, there's no counting for real world
-trials, but all ActiveSupport testcases pass under this scenario.
-
-Secondly, this release is the first of two (or three) down-scaling
-releases intended to remove all the remaining "excess" from the
-library. This is being done for a variety of reasons. Some scripts
-are substantial enough to be one their own and have been spun-off
-into separate largely compatible projects. In this release:
-
-  If you were using...   Use this project instead...
-
-    annotations.rb         Anise
-
-    bytes.rb               RichUnits
-    times.rb
-
-    command.rb             Clio
-    consoleutils.rb
-
-A few others scripts have been deprecated, without an alternative
-recourse, simply because they were too weak, such as  uploadutils.rb,
-or highly experimental, such as chain.rb and eventhook.rb.
-
-Although this release constitutes an over all slimming down of Facets,
-two excellent new libraries have been added.
-
-1) *ini.rb* by Jeena Paradies. While YAML is frequently used by
-Rubyists for configuration files, a full-on serializer like YAML
-is often overkill. INI files provide a lightweight solution
-specifically geared for configuration.
-
-2) *filter.rb* by Brian Candler offers lazy evaluation chains of 
-Enumerable methods. This is an elegant way to optimize contiguous
-maps, selections, etc. --effective even on infinite enumerators.
-(Note, the name of this library may be changed in the next release.)
-
-While work remains to be done, I am happy to say, Facets is 
-finally beginning to approach the level of solidity I set out to
-achieve just over a year ago. Thank the Maker!
-
-Special thanks to Brian Candler, Jeena Paradies and Tyler Rick.
-
-Enjoy!
-
-
-### 2.5.0 / 2008-11-23
-
-* 9 Major Changes
-
-    * added Brian Candler's Enumerator::Filter
-    * added sparse_array.rb (was old harray.rb)
-    * added Jeena Paradies' ini.rb
-    * renamed CacheDelegator to Memoizer
-    * renamed DictionaryMatcher to just Matcher
-    * deprecated bytes.rb and times.rb (use RichUnits instead)
-    * deprecated uploadutils.rb; ziputils.rb will be (use Folio)
-    * deprecated annotations.rb (use Anise instead)
-    * deprecated command.rb and consoleutils.rb (use Clio instead)
-
-* 5 Minor Changes
-
-    * deprecated chain.rb (very expiremental)
-    * deprecated eventhook.rb (moved to ToadCode project)
-    * deprecated tagiter.rb (moved to ToadCode project)
-    * moved Hash#symolize_keys and #stringify_keys to core lib
-      (still recommend #rekey instead though)
-    * switched to git as of 2.4.5
-
-* 4 Bug Fixes
-
-    * memoize.rb, cache was at class-level, now at instance-level
-    * binding/caller.rb, fixed require for callstack.rb
-    * fixed missing require in string/tabto.rb
-    * Fixed some bugs with Time#ago/Time#hence not changing years
-      correctly when you changed months.
-      (For example, Time.utc(2008, 1, 1).ago(12, :months) incorrectly
-      returned 2009-01-01 instead of 2007-01-01.)
-      Changed Time#ago/Time#hence to still work if passed negative number.
-

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

@@ -1,19 +0,0 @@
-require 'facets/functor'
-
-module Kernel
-
-  # Access internals of an object as if with
-  # private access.
-  #
-  #   class X
-  #     metaclass.instance.attr_reader :x
-  #   end
-  #
-  def instance
-    @_instance_functor ||= Functor.new do |op,*args|
-      send(op,*args)
-    end
-  end
-
-end
-

data/lib/lore/facets/basicobject.rb

@@ -1,14 +0,0 @@
-# Facets' old BasicObject has been replaced totally replaced by 
-# Jim Weirich's BlankSlate. Since Ruby 1.9 has a BasicObject class
-# this  will of course be deprecated when 1.9 goes mainstream.
-
-unless defined? ::BasicObject  # just in case it already exists!
-
-  require 'facets/blankslate'
-
-  # ActiveSupport compatiable version of BasicObject
-  # if not Ruby 1.9+ uses Jim Weirich's BlankSlate.
-  BasicObject = BlankSlate
-
-end
-

data/lib/lore/facets/enumerator.rb

@@ -1,67 +0,0 @@
-require 'enumerator'
-
-if RUBY_VERSION < "1.9"
-
-  module Enumerable
-
-    class Enumerator
-
-      alias :old_initialize :initialize
-
-      # Provides the ruby-1.9 block form of Enumerator, where you can write:
-      #
-      #    obj = Enumerator.new do |yielder|
-      #       .. do stuff
-      #       yielder.yield data      # or: yielder << data
-      #       .. etc
-      #    end
-      #
-      # When obj.each is called, the block is run once. It should call
-      # yielder.yield with each item it wishes to generate.
-      #
-      # Example:
-      #
-      #   fib = Enumerator.new { |y|
-      #     a = b = 1
-      #     loop {   
-      #       y << a
-      #       a, b = b, a + b
-      #     }
-      #   }  
-      #
-      #   assert_equal [1, 1, 2, 3, 5, 8, 13, 21, 34, 55], fib.take(10)
-                                                    
-      def initialize(*args, &block)
-        if block_given?
-          @body = block
-          old_initialize(self, :_start)
-        else
-          old_initialize(*args)
-        end
-      end
-
-      def _start(*args,&receiver) #:nodoc:
-        @body.call(Yielder.new(receiver), *args)
-      end
-
-      # Wrapper to allow yielder.yield(output) or yielder << output
-      # in the same way as ruby-1.9
-
-      class Yielder #:nodoc:
-        def initialize(proc)
-          @proc = proc
-        end
-        def yield(*args)
-          @proc[*args]
-        end
-        alias :<< :yield
-      end
-    end
-    
-  end
-
-  # For ruby-1.9 compatibility, define Enumerator class at top level
-  Enumerator = Enumerable::Enumerator unless defined? ::Enumerator
-
-end # if RUBY_VERSION
-

data/lib/lore/facets/logger.rb

@@ -1,291 +0,0 @@
-# = Logger
-#
-# Extended variation of Ruby's standard Logger library.
-#
-#   log = Logger.new
-#
-#   log.setup_format do |severity, timestamp, progname, msg|
-#     Logger::SIMPLE_FORMAT % [severity, msg]
-#   end
-#
-# == Conventions
-#
-# When using debug level logger messages always append 'if $DBG'
-# at the end. This hack is needed because Ruby does not support
-# lazy evaluation (lisp macros).
-#
-# == Authors
-#
-# * George Moschovitis
-# * TransLogarithim
-#
-# == Copying
-#
-# Copyright (c) 2005 George Moschovitis
-#
-# Ruby License
-#
-# This module is free software. You may use, modify, and/or redistribute this
-# software under the same terms as Ruby.
-#
-# This program is distributed in the hope that it will be useful, but WITHOUT
-# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
-# FOR A PARTICULAR PURPOSE.
-
-require "logger"
-require "time"
-require "facets/ansicode"
-
-# = Logger
-#
-# Extended variation of Ruby's standard Logger library.
-# Mainly for compatibility purposes (with what?)
-#
-#   log = Logger.new
-#
-#   log.setup_format do |severity, timestamp, progname, msg|
-#     Logger::SIMPLE_FORMAT % [severity, msg]
-#   end
-#
-# When using debug level logger messages always append 'if $DBG'
-# at the end. This hack is needed because Ruby does not support
-# lazy evaluation (lisp macros).
-#
-# TODO: What's all this about then?
-
-class Logger
-
-  # Some available logging formats.
-  SIMPLE_FORMAT = "%5s: %s\n"
-  DETAILED_FORMAT = "%s %5s: %s\n"
-
-  # Why these names ?
-  alias_method :devel, :debug
-  alias_method :fine, :debug
-
-  def ansicolor=(on)
-    unless is_a?(Ansicolor)
-      class << self
-        include Ansicolor
-      end
-    end
-    @logdev.ansicolor = on
-  end
-
-# NOTE: trace is deprecated b/c binding of caller is no longer possible.
-=begin
-  # Prints a trace message to DEBUGLOG (at debug level).
-  # Useful for emitting the value of variables, etc.  Use
-  # like this:
-  #
-  #   x = y = 5
-  #   trace 'x'        # -> 'x = 5'
-  #   trace 'x ** y'   # -> 'x ** y = 3125'
-  #
-  # If you have a more complicated value, like an array of
-  # hashes, then you'll probably want to use an alternative
-  # output format.  For instance:
-  #
-  #   trace 'value', :yaml
-  #
-  # Valid output format values (the _style_ parameter) are:
-  #
-  #   :p :inspect
-  #   :pp                     (pretty-print, using 'pp' library)
-  #   :s :to_s
-  #   :y :yaml :to_yaml       (using the 'yaml' library')
-  #
-  # The default is <tt>:p</tt>.
-  #
-  # CREDITS:
-  #
-  # This code comes straight from the dev-utils Gem.
-  # Author: Gavin Sinclair <gsinclair@soyabean.com.au>
-
-  def trace(expr, style=:p)
-    unless expr.respond_to? :to_str
-      warn "trace: Can't evaluate the given value: #{caller.first}"
-    else
-      raise "FACETS: binding/or_caller is no longer possible"
-      require "facets/core/binding/self/of_caller"
-
-      Binding.of_caller do |b|
-        value = b.eval(expr.to_str)
-        formatter = TRACE_STYLES[style] || :inspect
-        case formatter
-        when :pp then require 'pp'
-        when :y, :yaml, :to_yaml then require 'yaml'
-        end
-        value_s = value.send(formatter)
-        message = "#{expr} = #{value_s}"
-        lines = message.split(/\n/)
-        indent = "   "
-        debug(lines.shift)
-        lines.each do |line|
-          debug(indent + line)
-        end
-      end
-    end
-  end
-
-  TRACE_STYLES = {}  # :nodoc:
-  TRACE_STYLES.update(
-    :pp => :pp_s, :s => :to_s, :p => :inspect,
-    :y => :to_yaml, :yaml => :to_yaml,
-    :inspect => :inspect, :to_yaml => :to_yaml
-  )
-=end
-
-  # Dictate the way in which this logger should format the
-  # messages it displays. This method requires a block. The
-  # block should return formatted strings given severity,
-  # timestamp, msg, progname.
-  #
-  # === Example
-  #
-  # logger = Logger.new
-  # logger.setup_format do |severity, timestamp, msg, progname|
-  #   "#{progname}@#{timestamp} - #{severity}::#{msg}"
-  # end
-
-  def setup_format(&format_proc)
-    raise "Formating block needed" unless format_proc
-    @format_proc = format_proc
-  end
-
-  def format_procedure
-    @format_proc
-  end
-
-private
-
-  attr_accessor :format_proc
-
-  alias_method :format_message_without_proc, :format_message # :nodoc:
-
-  def format_message(*args) # :nodoc:
-    @format_proc ? @format_proc.call(*args) : format_message_without_proc(*args)
-  end
-
-  class LogDevice
-    attr_writer :ansicolor
-
-    def ansicolor?
-      @ansicolor
-    end
-  end
-
-  # For adding ansicolor output.
-
-  module Ansicolor
-
-    def info(str)
-      return unless info?
-      @logdev.ansicolor? ? info_with_color{ super } : super
-    end
-
-    def warn(str)
-      return unless warn?
-      @logdev.ansicolor? ? warn_with_color{ super } : super
-    end
-
-    def debug(str)
-      return unless debug?
-      @logdev.ansicolor? ? debug_with_color{ super } : super
-    end
-
-    def error(str)
-      return unless error?
-      @logdev.ansicolor? ? error_with_color{ super } : super
-    end
-
-    def fatal(str)
-      return unless error?
-      @logdev.ansicolor? ? fatal_with_color{ super } : super
-    end
-
-    def info_with_color #:yield:
-      self << ANSICode.green
-      yield
-      self << ANSICode.clear
-    end
-
-    def warn_with_color #:yield:
-      self << ANSICode.cyan
-      yield
-      self << ANSICode.clear
-    end
-
-    def error_with_color #:yield:
-      self << ANSICode.red
-      yield
-      self << ANSICode.clear
-    end
-
-    def debug_with_color #:yield:
-      self << ANSICode.yellow
-      yield
-      self << ANSICode.clear
-    end
-
-    def fatal_with_color #:yield:
-      self << ANSICode.bold + ANSICode.red
-      yield
-      self << ANSICode.clear
-    end
-
-  end
-
-end
-
-# OLD WAY TO ADD COLOR
-=begin
-module Console
-
-  class  Logger < ::Logger
-
-    attr_accessor :style
-
-    def style
-      @style ||= Style.new
-    end
-
-    def info(str)
-      return if level > Logger::INFO
-      self << style.info(str)
-      super
-      self << ANSICode.clear
-    end
-
-    def warn(str)
-      self << style.warn(str)
-      super
-      self << ANSICode.clear
-    end
-
-    def error(str)
-      return if level > Logger::ERROR
-      self << style.error(str)
-      super
-      self << ANSICode.clear
-    end
-
-    def debug(str)
-      self << style.debug(str)
-      super
-      self << ANSICode.clear
-    end
-
-    # Logger Style
-
-    class Style
-      def info(str)  ; ANSICode.green ; end
-      def warn(str)  ; ANSICode.cyan ; end
-      def error(str) ; ANSICode.bold + ANSICode.red ; end
-      def debug(str) ; '' ; end
-    end
-
-  end
-end
-=end
-