facets 2.6.0 → 2.7.0

data/lib/more/facets/censor.rb

@@ -1,97 +0,0 @@
-# = TITLE:
-#
-#   Censor
-#
-# = DESCRIPTION:
-#
-#   Reusable class for filtering and rewriting strings.
-#
-# = AUTHORS:
-#
-#   - George Moschovitis
-#   - Trans
-#
-
-# = Censor
-#
-# Formaly known as TextFilter, this class allows one to define a
-# resuable text filter. This is useful for removing or replacing
-# cursewords or senstive information from user input.
-#
-class Censor
-
-  # Abritraty rules.
-  attr :rules
-
-  # Word-oriented rules.
-  attr :word_rules
-
-  # New Censor object.
-  #
-  def initialize()
-    @rules = []
-    @word_rules = []
-  end
-
-  # Create new rule. A rule consists of a string or regexp
-  # to match against.
-  #
-  # NOTE: The rules must be applied in order! So we cannot
-  # use a hash because the ordering is not guaranteed. So
-  # an array is used instead.
-  #
-  def rule(match, &edit)
-    edit = lambda{''} unless edit
-    @rules << [match, edit]
-  end
-
-  # Rules that apply only to words. This takes the regular
-  # expression and add word boundry matches to either side.
-  #
-  #   filter.word_rule(/damn/){ |w| 'darn' }
-  #
-  # Is equivalent to teh regular rule:
-  #
-  #   filter.rule(/\bdamn\b/){ |w| 'darn' }
-  #
-  def word_rule(match, &edit)
-    edit = lambda{''} unless edit
-    @word_rules << [/\b#{match}\b/, edit]
-  end
-
-  # Apply the set of rules (regular expression matches) to
-  # a string.
-  #
-  def filter(string)
-    rewritten_string = string.dup
-    rules.each do |match,edit|
-      rewritten_string.gsub!(match,edit)
-    end
-    return (rewritten_string or string)
-  end
-
-  alias_method :apply, :filter
-
-  # Is the string clear of any matching rules?
-  #
-  # Note that running a filter does not necessarily clear a
-  # a string of all matches, since the filter could apply
-  # edits that would also match the filter expressions.
-  #
-  def censored?(string)
-    case string
-    when *matches
-      false
-    else
-      true
-    end
-  end
-
-  #
-  #
-  def matches
-    rules.collect{ |match, modify| match }
-  end
-
-end
-

data/lib/more/facets/classmethods.rb

@@ -1,199 +0,0 @@
-# = ClassMethods
-#
-# Miniframework provides a very convenient way to have modules
-# pass along class methods in the inheritance chain.
-#
-# An oddity of Ruby, when including modules, class/module methods
-# are not inherited. To achieve this behavior requires some clever
-# Ruby Karate. Instead ClassMethods provides an easy to use and clean
-# solution. Simply place the class inheritable methods in a block of
-# the special module method #ClassMetods.
-#
-#   module Mix
-#     def inst_meth
-#       puts 'inst_meth'
-#     end
-#
-#     class_methods do
-#       def class_meth
-#         "Class Method!"
-#       end
-#     end
-#   end
-#
-#   class X
-#     include Mix
-#   end
-#
-#   X.class_meth  #=> "Class Method!"
-#
-# This is equivalent to the original (but still functional) techinique of
-# putting the class/module methods in a nested ClassMethods module
-# and extending the original module *manually*. Eg.
-#
-#   module Mix
-#     def inst_meth
-#       puts 'inst_meth'
-#     end
-#
-#     module ClassMethods
-#       def class_meth
-#         "Class Method!"
-#       end
-#     end
-#
-#     extend ClassMethods
-#   end
-#
-#   class X
-#     include Mix
-#   end
-#
-#   X.class_meth  #=> "Class Method!"
-#
-# Also note that #class_inherit is an available alias
-# for #class_methods for the sake of backward compatability.
-# And #class_extension is alias (potentially) looking forward
-# to a future version on Ruby.
-#
-# == On Topic
-#
-# Just a quick comment on the need for this behavior.
-#
-# A module is an encapsulation of code, hence when a module is included
-# (or extends), the module itself should have discretion over how it
-# effects the receiving class/module. That is the very embodiment of
-# encapsulation. Having it otherwise, as Ruby now does, stymies the
-# practice --and we end up with "hacks", like this and ClassMethods,
-# to compensate.
-#
-# Ruby would be much improved by making this bevaivor standard.
-# And making non-inheritance the exception, which is alwasy easy
-# enough to achieve: put the code in a separate (and thus uninherited)
-# module.
-#
-# == Notes
-#
-# * There are currently two approaches to this, ClassMethods and class_extensions.
-#   A third is being worked on called Component with the idea that a "component"
-#   is like a module except that it's class-level methods are mixed-in as well.
-#   This is an idea solution, however it is less that ideal to implement.
-#
-# == History
-#
-# Thanks to Nobu and Ulysses for their original work on this.
-#
-# == Authors
-#
-# * Nobu Nakada
-# * Thomas Sawyer
-# * Ulysses
-#
-# == Copying
-#
-# Copyright (c) 2005 Nobu Nakada, 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.
-
-
-# = ClassMethods
-#
-# ClassMethods provides an easy to use and clean
-# solution. Simply place the class inheritable methods in a block of
-# the special module method #ClassMetods.
-#
-#   module Mix
-#     def inst_meth
-#       puts 'inst_meth'
-#     end
-#
-#     class_methods do
-#       def class_meth
-#         "Class Method!"
-#       end
-#     end
-#   end
-#
-#   class X
-#     include Mix
-#   end
-#
-#   X.class_meth  #=> "Class Method!"
-#
-# This is equivalent to the original (but still functional) techinique of
-# putting the class/module methods in a nested ClassMethods module
-# and extending the original module *manually*. Eg.
-#
-#   module Mix
-#     def inst_meth
-#       puts 'inst_meth'
-#     end
-#
-#     module ClassMethods
-#       def class_meth
-#         "Class Method!"
-#       end
-#     end
-#
-#     extend ClassMethods
-#   end
-#
-#   class X
-#     include Mix
-#   end
-#
-#   X.class_meth  #=> "Class Method!"
-#
-# Also note that #class_inherit is an available alias
-# for #class_methods for the sake of backward compatability.
-# And #class_extension is alias (potentially) looking forward
-# to a future version on Ruby.
-
-class Module
-
-  alias_method :append_features_without_classmethods, :append_features
-
-  def append_features( base )
-    result = append_features_without_classmethods( base )
-    if const_defined?( :ClassMethods )
-      base.extend( self::ClassMethods )
-      unless base.is_a?( Class )
-        unless base.const_defined?( :ClassMethods )
-          base.const_set( :ClassMethods, Module.new )
-        end
-        my = self
-        base::ClassMethods.class_eval do
-          include my::ClassMethods
-        end
-      end
-    end
-    result
-  end
-
-  def class_methods( &yld )
-    if const_defined?( :ClassMethods )
-      self::ClassMethods.class_eval( &yld )
-    else
-      self.const_set( :ClassMethods, Module.new( &yld ) )
-    end
-    extend( self::ClassMethods )
-    self::ClassMethods
-  end
-
-  # For compatibility with old rendition.
-  alias_method :class_inherit, :class_methods
-
-end
-
-class Class
-  undef_method :class_methods
-  undef_method :class_inherit
-end
-

data/lib/more/facets/consoleutils.rb

@@ -1,99 +0,0 @@
-warn "WARNING: facets/consoleutils.rb will be deprecated. Use alternate solution, such as Clio, for future versions."
-
-# = ConsoleUtils
-#
-# ConsoleUtils provides methods that are
-# generally useful in the context of
-# creating console output.
-#
-module ConsoleUtils
-
-  module_function
-
-  # Convenient method to get simple console reply.
-
-  def ask(question, answers=nil)
-    print "#{question}"
-    print " [#{answers}] " if answers
-    until inp = $stdin.gets ; sleep 1 ; end
-    inp
-  end
-
-  # Convenience method for puts. Use this instead of
-  # puts when the output should be supressed if the
-  # global $QUIET option is set.
-
-  #def say(statement)
-  #  puts statement #unless quiet? $QUIET
-  #end
-
-  # Ask for a password. (FIXME: only for unix so far)
-
-  def password(msg=nil)
-    msg ||= "Enter Password: "
-    inp = ''
-
-    $stdout << msg
-
-    begin
-      system "stty -echo"
-      inp = gets.chomp
-    ensure
-      system "stty echo"
-    end
-
-    return inp
-  end
-
-  # Console screen width (taken from progress bar)
-  #
-  # TODO: Don't know how portable #screen_width is.
-
-  def screen_width(out=STDERR)
-    default_width = ENV['COLUMNS'] || 80
-    begin
-      tiocgwinsz = 0x5413
-      data = [0, 0, 0, 0].pack("SSSS")
-      if out.ioctl(tiocgwinsz, data) >= 0 then
-        rows, cols, xpixels, ypixels = data.unpack("SSSS")
-        if cols >= 0 then cols else default_width end
-      else
-        default_width
-      end
-    rescue Exception
-      default_width
-    end
-  end
-
-  # Print a justified line with left and right entries.
-  #
-  # A fill option can be given to fill in any empty space
-  # between the two. And a ratio option can be given which defaults
-  # to 0.8 (eg. 80/20)
-
-  def print_justified(left, right, options={})
-    fill  = options[:fill] || '.'
-    fill  = ' ' if fill == ''
-    fill  = fill[0,1]
-
-    ratio = options[:ratio] || 0.8
-    ratio = 1 + ratio if ratio < 0
-
-    width = (@screen_width ||= screen_width) - 1
-
-    #l = (width * ratio).to_i
-    r = (width * (1 - ratio)).to_i
-    l = width - r
-
-    left  = left[0,l]
-    right = right[0,r]
-
-    str = fill * width
-    str[0,left.size] = left
-    str[width-right.size,right.size] = right
-
-    print str
-  end
-
-end
-

data/lib/more/facets/crypt.rb

@@ -1,166 +0,0 @@
-# = Crypt
-#
-# A pure ruby version of crypt(3), a salted one-way hashing of a password.
-#
-# == History
-#
-#   Adapted by guillaume__dot__pierronnet_at__laposte__dot_net based on
-#   * http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/325204/index_txt
-#   which is based on FreeBSD src/lib/libcrypt/crypt.c 1.2
-#   * http://www.freebsd.org/cgi/cvsweb.cgi/~checkout~/src/lib/libcrypt/crypt.c?rev=1.2&content-type=text/plain
-#
-#   [Original License]
-#
-#   "THE BEER-WARE LICENSE" (Revision 42):
-#   <phk@login.dknet.dk> wrote this file.  As long as you retain this notice you
-#   can do whatever you want with this stuff. If we meet some day, and you think
-#   this stuff is worth it, you can buy me a beer in return.   Poul-Henning Kamp
-#
-# == Authors
-#
-# * Poul-Henning Kamp
-#
-# == Copying
-#
-# Copyright (c) 2002 Poul-Henning Kamp
-#
-# 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 'facets/string/xor.rb'
-
-# = Crypt
-#
-# A pure ruby version of crypt(3), a salted one-way hashing of a password.
-#
-module Crypt
-
-  ITOA64 = "./0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"
-
-  # A pure ruby version of crypt(3), a salted one-way hashing of a password.
-  #
-  # Supported hashing algorithms are: md5, sha1, sha256, sha384, sha512, rmd160.
-  #
-  # Only the md5 hashing algorithm is standard and compatible with crypt(3), the others
-  # are not standard.
-  #
-  # Automatically generate a 8-bytes salt if nil.
-  #
-  # Output a length hashed and salted string with size of
-  # magic.size + salt.size + 23.
-
-  def self.crypt(password, algo = :md5, salt = nil, magic='$1$')
-
-    salt ||= generate_salt(8)
-
-    case algo
-      when :md5
-        require "digest/md5"
-      when :sha1
-        require "digest/sha1"
-      when :rmd160
-        require "digest/rmd160"
-      when :sha256, :sha384, :sha512
-        require "digest/sha2"
-    else
-      raise(ArgumentError, "unknown algorithm")
-    end
-    digest_class = Digest.const_get(algo.to_s.upcase)
-
-    # The password first, since that is what is most unknown. Then our magic string. Then the raw salt.
-    m = digest_class.new
-    m.update(password + magic + salt)
-
-    # Then just as many characters of the MD5(pw,salt,pw)
-    mixin = digest_class.new.update(password + salt + password).digest
-    password.length.times do |i|
-      m.update(mixin[i % 16].chr)
-    end
-
-    # Then something really weird...
-    # Also really broken, as far as I can tell.  -m
-    i = password.length
-    while i != 0
-      if (i & 1) != 0
-        m.update("\x00")
-      else
-        m.update(password[0].chr)
-      end
-      i >>= 1
-    end
-
-    final = m.digest
-
-    # and now, just to make sure things don't run too fast
-    1000.times do |i|
-      m2 = digest_class.new
-
-      if (i & 1) != 0
-        m2.update(password)
-      else
-        m2.update(final)
-      end
-
-      if (i % 3) != 0
-        m2.update(salt)
-      end
-      if (i % 7) != 0
-        m2.update(password)
-      end
-
-      if (i & 1) != 0
-        m2.update(final)
-      else
-        m2.update(password)
-      end
-
-      final = m2.digest
-    end
-
-    # This is the bit that uses to64() in the original code.
-
-    rearranged = ""
-
-    [ [0, 6, 12], [1, 7, 13], [2, 8, 14], [3, 9, 15], [4, 10, 5] ].each do |a, b, c|
-
-      v = final[a] << 16 | final[b] << 8 | final[c]
-
-      4.times do
-        rearranged += ITOA64[v & 0x3f].chr
-        v >>= 6
-      end
-    end
-
-    v = final[11]
-
-    2.times do
-      rearranged += ITOA64[v & 0x3f].chr
-      v >>= 6
-    end
-
-    magic + salt + '$' + rearranged
-  end
-
-
-  # check the validity of a password against an hashed string
-
-  def self.check(password, hash, algo = :md5)
-    magic, salt = hash.split('$')[1,2]
-    magic = '$' + magic + '$'
-    self.crypt(password, algo, salt, magic) == hash
-  end
-
-
-  # generate a +size+ length random salt
-
-  def self.generate_salt(size)
-    (1..size).collect { ITOA64[rand(ITOA64.size)].chr }.join("")
-  end
-end
-