facets 0.6.3 → 0.7.0

data/lib/facet/float/round_off.rb

@@ -0,0 +1,12 @@
+
+class Float
+  # Alias for #round. This is used by both the 
+  # improved #round method and #round_to.
+  alias_method :round_off, :round
+end
+
+class Numeric
+  # To properly support Float's rounding methods,
+  # Numeric must also be augmented.
+  alias_method :round_off, :round
+end

data/lib/facet/float/round_to.rb

@@ -0,0 +1,34 @@
+
+require 'facet/float/round_off'
+
+class Float
+  # Rounds to the nearest _n_th degree.
+  #
+  #   require 'facet/float/round_to'
+  #
+  #   4.555.round_to(1)     #=> 5.0
+  #   4.555.round_to(0.1)   #=> 4.6
+  #   4.555.round_to(0.01)  #=> 4.56
+  #   4.555.round_to(0)     #=> 4.555
+  #
+  def round_to( n ) #n=1
+    return self if n == 0
+    (self * (1.0 / n)).round_off.to_f / (1.0 / n)
+  end
+end
+
+class Numeric
+  # To properly support Float's rounding methods,
+  # Numeric must also be augmented.
+  def round_to(*args)
+    self.to_f.round_to(*args)
+  end  
+end
+
+class Integer
+  # To properly support Float's rounding methods,
+  # Integer must also be augmented.
+  def round_to(*args)
+    self.to_f.round_to(*args)
+  end  
+end

data/lib/facet/floatstring.rb

@@ -0,0 +1,177 @@
+
+#:title: FloatString
+#--
+# FloatString
+# v 0.2
+#
+# Copyright (c) 2004,2005 Thomas Sawyer
+# 
+# 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.
+#
+#
+# $Id: floatstring.rb,v 0.2 2005/04/28 17:00:24 transami Exp $
+#
+# ==========================================================================
+# Revision History ::
+# YYYY.MM.DD  Ver. Dev.      Description
+# --------------------------------------------------------------------------
+# 2005.04.28  0.2  Trans     * Minor modifications to documentation.
+# ==========================================================================
+#++
+
+# = Description
+# 
+# FloatString allows unlimited string insertion between string segments.
+# 
+# == Notes
+#
+# Although usable, it is still a very new idea, and therefore 
+# has a much greater potential for change. If you decide it is useful
+# to you, please contribute to its improvement. Thanks.
+# 
+# == Author(s)
+# 
+# * Thomas Sawyer
+# 
+
+class FloatString
+
+  def initialize( str )
+    @str = str
+    @float = {}
+    i = 0
+    while i < @str.length
+      @float[i.to_f] = @str[i,1]
+      i += 1
+    end 
+  end
+
+  def undo
+    initialize( @str )
+  end
+  
+  def re_enumerate
+    initialize( to_s )
+  end
+  alias_method( :renumerate, :re_enumerate )
+  
+  def to_s
+    @float.to_a.sort_by{ |k,v| k }.collect{ |k,v| v }.join('')
+  end
+
+  def to_str
+    @float.to_a.sort_by{ |k,v| k }.collect{ |k,v| v }.join('')
+  end
+
+  # these should probably check the decimal and start there
+  # rather then startint at 0.5
+  
+  def inner_insert(s, i)
+    n = 0.5; i = i.to_f - n
+    while @float.has_key?(i)
+      n = n/2
+      i += n
+    end
+    @float[i] = s
+  end
+  
+  def outer_insert(s, i)
+    n = 0.5; i = i.to_f - 0.5
+    while @float.has_key?(i)
+      n = n/2
+      i -= n
+    end
+    @float[i] = s
+  end
+  
+  def inner_append(s, i)
+    n = 0.5; i = i.to_f + 0.5
+    while @float.has_key?(i)
+      n = n/2
+      i -= n
+    end
+    @float[i] = s
+  end
+  
+  def outer_append(s, i)
+    n = 0.5; i = i.to_f + 0.5
+    while @float.has_key?(i)
+      n = n/2
+      i += n
+    end
+    @float[i] = s
+  end
+
+  # an inner and outer wrap method would be nice
+    
+  def [](arg)
+    if arg.kind_of?(Range)
+      #r = Range.new(arg.first.to_f, arg.last.to_f, arg.exclude_end?)
+      a = @float.to_a.sort_by{ |k,v| k }
+      s = a.index(a.find{ |e| e[0] == arg.first.to_f})
+      f = a.index(a.find{ |e| e[0] == arg.last.to_f})
+      a = arg.exclude_end? ? a[s...f] : a[s..f]
+      a.collect{ |k,v| v }.join('')
+    else
+      @float[arg.to_f]
+    end
+  end
+  
+  def []=(arg,v)
+    @float[arg.to_f] = v
+  end
+  
+  def fill(val, rng=0..-1)
+    a = @float.to_a.sort_by{ |k,v| k }
+    s = a.index( a.find{ |e| e[0] == rng.first.to_f } )
+    f = a.index( a.find{ |e| e[0] == rng.last.to_f } )
+    x = (rng.exclude_end? ? a[s...f] : a[s..f])
+    x.each{ |k,v| @float[k] = val.to_s }
+    self.to_s
+  end
+  
+  def empty(rng)
+    fill('', rng)
+  end
+
+  def blank(rng)
+    fill(' ', rng)
+  end
+  
+end
+
+
+=begin
+# --- development testing ---
+
+if $0 == __FILE__
+
+  require 'test/unit'
+
+  class TC_FloatString < Test::Unit::TestCase
+    
+    def test_inner_inset
+      fs = FloatString.new( "Hello World!" )
+      fs.inner_insert("XXX", 4)
+      assert_equal("HellXXXo World!", fs.to_s)
+      fs.inner_insert("YYY", 4)
+      assert_equal("HellXXXYYYo World!", fs.to_s)
+    end
+  
+    def test_fill
+      fs = FloatString.new( "Hello World!" )
+      fs.inner_insert("XXX", 4)
+      assert_equal("HeNNNN World!", fs.fill("N", 2..4))
+    end
+    
+  end
+  
+end
+=end

data/lib/facet/functor.rb

@@ -0,0 +1,65 @@
+#:title: Functor
+#--
+# Functor
+# v 1.0
+#
+# Copyright (c) 2004,2005 Thomas Sawyer
+# 
+# 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.
+#
+#
+# $Id: functor.rb,v 1.0 2005/04/28 17:00:24 transami Exp $
+#
+# ==========================================================================
+# Revision History ::
+# YYYY.MM.DD  Ver. Dev.      Description
+# --------------------------------------------------------------------------
+# 2005.04.28  1.0  Trans     * Minor modifications to documentation.
+# ==========================================================================
+#++
+
+# = Description
+# 
+# By definition a Functor is simply a first class method, but these are common
+# in the form of Method and Proc. So here a Functor is a bit more specialied
+# as a 1st class _metafunction_. Essentally, a Functor can vary its behavior
+# accorrding to the operation applied to it.
+# 
+# == Synopsis
+# 
+#   require 'facet/functor'
+#   
+#   f = Functor.new { |op, x| x.send(op, x) }
+#   f + 1  #=> 2
+#   f + 2  #=> 4
+#   f + 3  #=> 6
+#   f * 1  #=> 1
+#   f * 2  #=> 2
+#   f * 3  #=> 9
+#   
+# == Notes
+# 
+# It would probably be a little better if we had a kernelless base object class.
+# Built-in public Object methods will not work in a Functor b/c of this.
+# Or perhaps this can improved via delegation.
+# 
+# == Author(s)
+#
+# * Thomas Sawyer
+#
+
+class Functor
+  def initialize(&func)
+    @func = func
+  end
+  def method_missing(op, *args)
+    @func.call(op, *args)
+  end
+end

data/lib/facet/harray.rb

@@ -0,0 +1,532 @@
+#:title: HArray
+#--
+# HArray
+# v 0.9
+#
+# Copyright (c) 2004,2005 Thomas Sawyer
+# 
+# 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.
+#
+#
+# $Id: harray.rb,v 0.9 2005/04/28 17:00:24 transami Exp $
+#
+# ==========================================================================
+# Revision History ::
+# YYYY.MM.DD  Ver. Dev.      Description
+# --------------------------------------------------------------------------
+# 2005.04.28  0.9  Trans     * Minor modifications to documentation.
+# ==========================================================================
+#++
+
+# = Description
+# 
+# HArray is an implemenation of the Array class using only Hashes.
+# Regular Arrays are never used except once to delegate the #pack method,
+# and for *args parameters (since there is no way around those is some cases).
+# HArray is for all practical purposes 100% compatible with Array.
+# 
+# HArray is slower then the built in Array class, but not as slow
+# as one might expect, since a Hash in general is faster than an Array.
+# It might be interesting to see how this would perform if it were 
+# written in c. Not all that useful, but an interesting example.
+# 
+# == AUTHOR(s)
+# 
+# * Thamas Sawyer  
+# 
+
+class HArray < Hash
+  VERSION = '0.9.0'
+
+  def HArray.[](*args)
+    nha = HArray.new
+    args.each { |a| nha.set(nha.length,a) }
+    nha
+  end
+
+  def HArray.new_h(hsh)
+    nha=HArray.new
+    nha.replace(hsh)
+    #nha.reindex!
+  end
+
+  def initialize(i=0,e=nil)
+    if i > 0
+      i.times { self.set(self.length,e) }
+    end
+  end
+
+  def &(ha)
+    nha=HArray.new
+    (0..self.length-1).each do |i|
+      if ha.has_value?(self.fetch(i)) and !nha.has_value?(self.fetch(i))
+        nha.set(nha.length,self.fetch(i))
+      end
+    end
+    nha
+  end
+
+  def *(j)
+    if j.kind_of?(String)
+      return self.join(j)
+    else
+      nha = HArray.new
+      j.times { (0...self.length).each { |i| nha.set(nha.length,self.fetch(i)) } }
+      return nha
+    end
+  end
+
+  def +(ha)
+    nha = self.dup
+    (0..ha.length-1).each { |i| nha.set(nha.length,ha.fetch(i)) }
+    nha
+  end
+
+  def -(ha)
+    nha = HArray.new
+    self.each { |v| nha << v if !ha.has_value?(v) }
+    #ha.each { |v| nha << i if !self.include?(v) }
+    nha
+  end
+
+  def <<(e)
+    self.set(self.length,e)
+    self
+  end
+
+  def <=>(ha)
+    (0..self.length-1).each do |i|
+      ieq = (self.fetch(i) <=> ha.fetch(i))
+      return ieq if ieq != 0
+    end
+    self.length <=> ha.length
+  end
+
+  def ===(ha)
+    self.==(ha)
+  end
+
+  alias_method :get, :[]
+  private :get
+
+  def [](i,l=nil)
+    if l
+      i = i...i+l
+    elsif ! i.kind_of?(Range)
+      return self.at(i)
+    end
+    nha = HArray.new
+    i.each { |j| nha.set(nha.length,get(j)) if has_key?(j) }
+    nha
+  end
+
+  alias set []=
+  def []=(i,b,c=nil)
+    if c
+      rng = (Integer(i)..Integer(i+b))
+      b = c
+    elsif i.kind_of? Range
+      rng = i
+    else
+      self.set(Integer(i),b)
+      return b
+    end
+    if b == nil
+      rng.each { |i| qdelete(i) }
+      self.reindex!
+    elsif b.kind_of?(Array) or b.kind_of?(HArray)
+      j = 0
+      rng.each { |i| self[i] = b[j]; j+=1 }
+    else
+      rng.each { |i| qdelete(i) }
+      self[rng.fist] = b
+      self.reindex!
+    end
+  end
+
+  def |(ha)
+    nha = self.dup
+    ha.each { |v| nha << v if !nha.has_value?(v) }
+    nha
+  end
+
+  def assoc(k)
+    (0...self.length).each { |i| return self.fetch(i) if self.fetch(i)[0] == k }
+    return nil
+  end
+
+  def at(i)
+    i = self.length + i if i <= -1
+    get(i)
+    #return nil if i < 0 or i >= self.length
+    #return self.fetch(i)
+  end
+
+  # clear okay
+
+  def collect
+    nha = HArray.new
+    (0...self.length).each { |i| nha << yield(self.fetch(i)) }
+    nha
+  end
+
+  def collect!
+    nha = HArray.new
+    (0...self.length).each { |i| nha << yield(self.fetch(i)) }
+    self.replace(nha)
+  end
+
+  def compact
+    nha, j = HArray.new, 0
+    (0..self.length-1).each do |i|
+      if self.fetch(i) != nil
+        nha.set(j,self.fetch(i))
+        j+=1
+      end
+    end
+    nha
+  end
+
+  def compact!
+    if self.has_value?(nil)
+      nha, j = HArray.new, 0
+      (0..self.length-1).each do |i|
+        if self.fetch(i) != nil
+          nha.set(j,self.fetch(i))
+          j+=1
+        end
+      end
+      return self.replace(nha)
+    else
+      return nil
+    end
+  end
+
+  def concat(ha)
+    (0...ha.length).each { |i| self.set(self.length,ha.fetch(i)) }
+    self
+  end
+
+  def count(e=nil)
+    if block_given?
+      cnt = 0
+      (0...self.length).each { |i| cnt += 1 if yield(self.fetch(i)) }
+      return cnt
+    else
+      cnt = 0
+      (0...self.length).each { |i| cnt += 1 if self.fetch(i) == e }
+      return cnt
+    end
+  end
+
+  alias qdelete delete
+  private :qdelete
+
+  def delete(e)
+    if has_value?(e)
+      qdelete_if { |i,v| v == e }
+      reindex!
+      return e
+    else
+      return yield if block_given?
+      return nil
+    end
+  end
+
+  def delete_at(i)
+    if self.has_key?(i)
+      e = self.fetch(i)
+      qdelete(i)
+      reindex!
+      return e
+    else
+      return nil
+    end
+  end
+
+  alias qdelete_if delete_if
+  private :qdelete_if
+
+  def delete_if
+    qdelete_if { |i,v| yield(v) }
+    reindex!
+  end
+
+  def each
+    (0...self.length).each { |i| yield(self.fetch(i)) }
+  end
+
+  def each_index
+    (0...self.length).each { |i| yield(i) }
+  end
+
+  # empty? okay as is
+
+  def eql?(ha)
+    return false if self.length != ha.length
+    return true if (0...self.length).all? { |i| self.fetch(i).eql?(ha.fetch(i)) }
+    return false
+  end
+
+  def fill(f,s=nil,l=nil)
+    if s.kind_of?(Range)
+      r = s
+    else
+      s = 0 if !s
+      l = self.length - s if !l
+      r = s...(s+l)
+    end
+    r.each{ |i| self.set(i,f) }
+    self
+  end
+
+  def first
+    return nil if self.empty?
+    self.fetch(0)
+  end
+
+  def flatten
+    nha = HArray.new
+    (0...self.length).each do |i|
+      sfi = self.fetch(i)
+      if sfi.kind_of?(HArray) or sfi.kind_of?(Array)
+        nha.concat(sfi.flatten)
+      else
+        nha.set(nha.length,sfi)
+      end
+    end
+    nha
+  end
+
+  def flatten!
+    return nil if !self.any? { |e| e.kind_of?(HArray) or e.kind_of?(Array) }
+    self.replace(self.flatten)
+  end
+
+  def include?(v)
+    self.has_value?(v)
+  end
+
+  # index okay
+
+  def join(sep='')
+    s = ''
+    (0...self.length).each { |i| s << "#{self.fetch(i)}#{sep}" }
+    return s.chomp(sep)
+  end
+
+  def last
+    self[self.length-1]
+  end
+
+  # length okay
+
+  alias map! collect!
+
+  def nitems
+    cnt = 0
+    (0...self.length).each { |i| cnt += 1 if self.fetch(i) != nil }
+    cnt
+  end
+
+  def pack(*args)
+    self.to_a.pack(*args)
+  end
+
+  def pop
+    self.delete_at(self.length-1)
+  end
+
+  def push(*e)
+    self.concat(e)
+  end
+
+  def rassoc(k)
+    (0...self.length).each { |i| return self.fetch(i) if self.fetch(i)[1] == k }
+    return nil
+  end
+
+  def reindex
+    nha, j, k, tl = HArray.new, 0, 0, self.length
+    while k < tl
+      if self.has_key?(j)
+        nha.set(k,self.fetch(j))
+        j+=1; k+=1
+      else
+        j+=1
+      end
+    end
+    nha
+  end
+
+  def reindex!
+    self.replace(self.reindex)
+  end
+
+  def reject!
+    chg=nil
+    qdelete_if { |i,v| r=yield(v); chg=true if r; r }
+    return nil if !chg
+    reindex!
+  end
+
+  #def replace(ha)
+  #  if ha.length < self.length
+  #    (ha.length..self.length-1).each { |i| self.delete(i) }
+  #    (0..ha.length-1).each { |i| self.set(i,ha[i]) }
+  #  end
+  #end
+
+  def reverse
+    nha = HArray.new
+    (0...self.length).each { |i| nha.set(self.length-1-i,self.fetch(i)) }
+    nha
+  end
+
+  def reverse!
+    (0...self.length/2).each do |i|
+      ri = self.length-1-i
+      tmp = self.fetch(ri)
+      self.set(ri,self.fetch(i))
+      self.set(i,tmp)
+    end
+    self
+  end
+
+  def reverse_each
+    i = self.length - 1
+    while i >= 0
+      yield(self.fetch(i))
+      i -= 1
+    end
+  end
+
+  def rindex(e)
+    i = self.length - 1
+    while i >= 0
+      return i if self.fetch(i) == e
+      i -= 1
+    end
+    return nil
+  end
+
+  def shift
+    e1 = self[0]
+    tl = self.length - 1
+    (1..tl).each { |i| self.set(i-1,self.fetch(i)) }
+    self.delete_at(tl)
+    e1
+  end
+
+  # size okay
+
+  def slice(*args)
+    self[*args]
+  end
+
+  def slice!(*args)
+    result = self[*args]
+    self[*args] = nil
+    result
+  end
+
+  def sort
+    raise "HArray does not currently support sorting with blocks" if block_given?
+    nha = self.dup
+    qsort(nha,0,nha.length-1)
+  end
+
+  def qsort(ha, l, r)
+    l_hold = l
+    r_hold = r
+    pivot = ha[l]
+    while l < r
+      r -= 1 while (ha[r] <=> pivot) >= 0 and l < r
+      if l != r
+        ha[l] = ha[r]
+        l += 1
+      end
+      l += 1 while (ha[l] <=> pivot) <= 0 and l < r
+      if l != r
+        ha[r] = ha[l]
+        r -= 1
+      end
+    end
+    ha[l] = pivot
+    pivot = l
+    l = l_hold
+    r = r_hold
+    qsort(ha,l,pivot-1) if l < pivot
+    qsort(ha,pivot+1,r) if r > pivot
+    ha
+  end
+
+  def sort!
+    raise "HArray does not currently support sorting with blocks" if block_given?
+    qsort(self,0,self.length-1)
+  end
+
+  def to_a
+    a = []
+    (0..self.length-1).each { |i| a << self.fetch(i) }
+    a
+  end
+
+  def to_ary
+    self
+  end
+
+  def to_h
+   h = Hash.new
+   self.each { |k,v| h[k] = v }
+   h
+  end
+
+  def to_s
+   self.join
+  end
+
+  def uniq
+    nha = HArray.new
+    (0..self.length-1).each do |i|
+      nha[nha.length] = self[i] if !nha.has_value?(self[i])
+    end
+    nha
+  end
+
+  def uniq!
+    j = 0
+    (1..self.length-1).each do |i|
+      if !self[0..j].has_value?(self[i])
+        self[j+1] = self[i]
+        j+=1
+      end
+    end
+    (j+1..self.length-1).each { |i| qdelete(i) }
+  end
+
+  def unshift(e)
+    i = self.length - 1
+    while i >= 0
+      self.set(i+1,self.fetch(i))
+      return i if self.fetch(i) == e
+      i -= 1
+    end
+    self.set(0,e)
+    self
+  end
+
+  def values_at(*ix)
+    nha = HArray.new
+    ix.each {|i| nha[nha.length] = self.at(i)}
+    nha
+  end
+
+end