facets 2.9.2 → 2.9.3

data/work/site/posts/2010-01-25-test_rails_with_facets.post

@@ -1,151 +0,0 @@
---- 
-title  : Development Notes
-author : Trans
-tags   : [release]
-layout : post
-
---- rdoc
-
-= Facets Development Notes
-
-This is a record of some musings along the way in the creatiojn of
-Facets. It is not in any way all that important. Its' simply here
-to give some historical context to development and to provide and
-cues for recollection.
-
-== Testing Rails with Facets Loaded
-
-Add this to Rails' Rakefile:
-
-  task 'test:facets' do
-    require 'activesupport'
-    require 'facets'
-    Rake::Task['test'].invoke
-  end
-
-Run 'rake test:facets'.
-
-== On the Name "Ruby Facets"
-
-A lot of mental anguish went into finding this good project name Ruby Facets. Of course, in the end only one name can take the honor. Other good names which were considered: Calibre, Florida and California, Warchest w/ Atomix, Downs & Ace, Trix & Atomx and even Pillbox & Pills (a _why suggestion). Then the names that almost won out and were used for a good while: Nano Methods and Mega Modules --great names but a little too "fad". Finally let's not forget even older "working" titles that were used along the way: Raspberry, ABC, Succ and the very original Tomslib.
-
-== Features that May Return
-
-[EXTACTED FROM README]
-
-It is possible to eliminate the need for the 'facets/' prefix on requires if the Facets libpaths are added to the LOAD_PATH. But this isn't as straight-forward as it is for most libraries b/c of the layout of Facets library.
-
-  require 'facets-topload'
-  require 'basicobject'
-
-Understand that on the off chance that another library has the same name as one of Facets' everything will still work fine. You will just not be able to use the prefixless shortcut to require it.
-
-== Some convesion extemnsions that turned out to be bad.
-
-  class Symbol
-
-    # Same functionality as before, just a touch more efficient.
-    #
-    #--
-    # CHANGE transami@gmail.com - removed #freeze from #id2name
-    # BAD BAD. Somehow it breaks things. Very weired breaks too,
-    # like making Time#parse alwsy output Time.now _after_ first use.
-    #++
-
-    def to_s
-      @to_s || (@to_s = id2name)
-    end
-
-    # Symbol's really are just simplified strings.
-    # Thus #to_str seems quite reasonable.
-    # This uses the Kernal#String method.
-    #--
-    # Maybe just change to #to_s?
-    # BTW: This would be lots faster, I bet, if implemented in core.
-    #
-    # NOTE This causes Struct.new to bomb!
-    #++
-
-    def to_str
-      String( self )
-    end
-
-  end
-
-== String#to_a extension is too dangerous
-
-  class String
-
-    # Essentially makes #to_a an alias for split,
-    # with the exception that if no divider is given
-    # then the array is split on charaters, and
-    # NOT on the global input record divider ($/).
-    #
-    # WARNING There is a slight chance of
-    # incompatability with other libraries which
-    # depend on spliting with $/ (although doing
-    # so is a very bad idea!).
-
-    #def to_a(div=//,limit=0)
-    #  split(div,limit)
-    #end
-
-  end
-
-== Lazy Enumerator
-
-Brian Candler provided his Filter class.
-
-Originally he had suggested to the Ruby community the idea l-methods for Enumerable.
-Eg. lmap, lselect, etc.
-
-== On <i>instance_</i> Methods
-
-Kernel extension prefixed by instance_ which provide
-internal (eg private) access to the object.
-Kernel extension using instance_ prefix which is beneficial
-to separation of metaprogramming from general programming.
-object_ methods, in contrast to the instance_ methods,
-do not access internal state.
-
-
-== On <i>object_</i> Methods
-
-I was considering this core addition to Facets:
-
-  module Kernel
-    alias_method :object_dup, :dup
-    alias_method :object_clone, :clone
-  end
-
-Already Facets has #object_class. The method goes along with #object_id
-and serves to stay out of the programmers way. Of course, since 'class'
-is a keyword in Ruby, it doesn't help as much. However, mwhen using
-method_missing one can exclude all object_* methods from removal so
-as to still have access to these important introspective methods. That's
-what I have traditionally done. Essentially,
-
-  private *instance_methods.select{ |m| m !~ /^(__|instance_|object__)/ }
-
-With the advent of 1.9 and BasicObject, this is no longer as important,
-but BasicObject leaves us in a bit of a lurch, b/c it removes nearly 
-everything leaving us no recourse to these methods. I can think of two
-good solutions: 1) Have some global "methods" that can handle objects
-at a higher level of abstraction. These can be defined as lambdas and
-called using#[], eg.
-
-  $class[x]
-  $id[x]
-  $dup[x]
-
-The other is to define a special method, perhaps #object, using fluent
-notaiton, we could handle this in a more object-oritented fashion:
-
-  x.object.class
-  x.object.id
-  x.object.dup
-
-In anycase, whatever might come along to provide this functionality, it
-is clear that "object_" methods will not be the solution, and for
-that reason #object_dup and #object_clone will never be facets.
-

data/work/site/posts/enumargs.md

@@ -1,30 +0,0 @@
-      <div class="spy">
-        <span class="spot">I Spy</span> EnumerablePass
-      </div>
-
-      <p>[NOTE: <i>This module used to be called EnumerableArgs.</i>]</p>
-
-      <p>Has it ever occurred to you that you can't define an #each method which takes parameters
-      and have it work with the Enumerable mixin? It's true. Try it and you'll get an ArgumentError.
-      Enumerable's methods just weren't designed to pass through any parameters to #each.
-      Well, if you've never thought about it before, I suppose it's never been a bother.
-      But if you're one of the unlucky few who has actually tried to do so, probably not thinking much
-      of it, you know just how frustrating it is. You are reduced to writing your own #find, #map, #select
-      and the many other normally eager-to-mix methods of Enumerable.</p>
-
-      <p>No Worries. EnumerablePass is here. Simply include it into your class and it will take
-      care of the rest. It's quite nearly 100% compatible to Enumerable in every way. So you
-      shouldn't miss a beat.</p>
-
-      <p>Here's a simply example of how EnumberablePass can be useful.</p>
-
-      <pre>
-        class &lt;&lt; ObjectSpace
-          include EnumerablePass
-          alias :each, :each_object
-        end
-      </pre>
-
-      <p>With the above it becomes possible to use all the familiar Enumerable methods
-      when looking through Ruby's object space!</p>
-

data/work/site/posts/tomslib.rb

@@ -1,47 +0,0 @@
-# TomsLib - Tom's Ruby Support Library
-# Copyright (c) 2002 Thomas Sawyer, LGPL
-#
-# About
-# A plethora of modules, mixins and methods. Have fun!
-
-# TomsLib is free software; you can redistribute it and/or modify
-# it under the terms of the GNU Lesser General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# TomsLib 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.  See the
-# GNU Lesser General Public License for more details.
-#
-# You should have received a copy of the GNU Lesser General Public License
-# along with TomsLib; if not, write to the Free Software
-# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-
-
-module TomsLib
-  
-  TITLE = "TomsLib"
-	RELEASE = "02.06.18"
-	STATUS = "UCC"
-	AUTHOR = "Thomas Sawyer"
-	EMAIL = "transami@transami.net"
-  
-	Package = "#{TITLE}"
-	Version = "v#{RELEASE} #{STATUS}"
-	Copyright = "Copyright � 2002 #{AUTHOR}, #{EMAIL}"
-
-  def self.about
-    puts
-    puts TomsLib::Package
-    puts TomsLib::Version
-    puts TomsLib::Copyright
-    puts
-  end
-
-end
-
-# Write about info to standerd out
-if $0 == __FILE__
-	TomsLib.about
-end

data/work/site/posts/weblog.xml

@@ -1,78 +0,0 @@
-<?xml version="1.0" encoding="ISO-8859-1" ?>
-<?xml-stylesheet href="layout.xsl" type="text/xsl" ?>
-
-<content>
-
-<div class="blurb">
-  <div class="desc">
-    <h1>All About Facets</h1>
-    Facets was forged from need, but hewed with blood, sweat and tears.
-    Okay, blood? Maybe not so much :)
-  </div>
-</div>
-
-<div class="page">
-<!--
-  <div style="text-align: center; margin-top: 10px; margin-bottom: 30px;">
-    <img src="img/SPYlights.png" style="padding-left: 30px;"/>
-  </div>
--->
-
-  <div class="section">
-
-    <h1>On Version 2.4</h1>
-
-    <p>Facets 2.4 developed out the lessons learned from earlier versions. The most important
-    lesson being that Facets touted "atomicity" isn't neccessarily beneficial. Facets
-    Core remains an <span class="red"><i>Atomic Library</i></span> becuase all methods are
-    organized into individual files, such that nearly each can be required independently of
-    any other. However atomicity can give a false sens of security. When cherry picking methods,
-    one must keep in mind another programmer might pick a different set of methods. So ensured
-    interoperbility depends on expecting an Facets method may be required. Nonetheless,
-    atomicity still allows for highly granular control over loaded features --useful to minimize
-    resource footprint.</p>
-
-  </div>
-
-  <div class="section">
-
-    <h1>On Version 2.0</h1>
-
-    <p>Facets 2.x serious is a much leaner library than the 1.x series. Where 1.x focused on
-    gathering large swaths of new functionally, 2.x is focusing on refinement. Along with this
-    came a new "definition" of what it is to be "MORE". MORE is the equivalent of Ruby's Standard
-    library. As such, only libraries one might reasonably conceive as part of Ruby's Standard lib
-    are included. This led to a number of libraries being moved to their own projects.
-    In particular, some web-related libraries were moved to <a href="http://blow.rubyforge.org">Blow</a>,
-    the Units system to <a href="http://stick.rubyforge.org">Stick</a>, and the inflection system to
-    <a href="http://english.rubyforge.org">English</a>. There were also a few libs removed simply
-    because they weren't stable and/or useful enough.</p>
-
-  </div>
-
-  <div class="section">
-
-    <h1>How Facets Was Born</h1>
-
-    <p>As programmers are wont to do, I started collecting reusable pieces of
-    Ruby long ago. At first it was just a small function here, a useful
-    module there. Eventually the collection became sizable and I called it <i>TomsLib</i>.
-    As time wore on and my library grew, I started to feel it worth a general
-    release and I had renamed it <i>Raspberry Lib</i>. But sometime shortly thereafter
-    I hit upon the idea of <i>atomicity</i>of the core extensions. And that's how the 
-    name Facets came about -- it's all about the little things. Of course, that name
-    took a while to decide upon too. The library was almost called "Atomix &amp; Trix"!<p>
-
-    <p>Facets has eveolved considerably over the years --and lessons were learned. Probably
-    the biggest lesson was the 2.0 release, where the idea of atomicity was eroded and
-    and alternate means of library requiring was attempted. Both were rectified by 2.4.</p>
-
-    <p>Much has changed since those first days. But time has been good to Facets.
-    Today, Facets is a more solid and leaner library than ever before and will 
-    continue in the fashion for version to come.</p>
-
-  </div>
-
-</div>
-</content>
-

data/work/site/sidebar.txt

@@ -1,19 +0,0 @@
-# Sidebar
-
-<a class="big"
-   href="javascript: window.open('{{ site.url }}/{{ site.url }}/apidoc/quick.html', 'facets_quickdocs',
-         config='height=470, width=551, toolbar=no, menubar=no, scrollbars=no, status=0,
-         resizable=no, location=no, directories=no'); void(0);">
-  <img src="assets/images/mini.png" align="right" style="margin: -15px 3px;"/>
-</a>
-
-The <a href="{{ site.url }}/apidoc/quick.html">Sidebar</a> provides a convenient "quick reference" interface
-to the RDoc API documentation. It is especailly useful for browsers that support sidebar pages,
-such as Firefox. Simply drag-and-drop the "apple slice image" (left of this text) to a toolbar,
-then alter it's properties to open as a <i>sidebar</i>. If your browser doesn't support sidebars,
-or if you simply prefer, you can use the
-<a href="javascript: window.open('{{ site.url }}/apidoc/quick.html', 'facets_quickdocs',
-         config='height=470, width=551, toolbar=no, menubar=no, scrollbars=no, status=0,
-         resizable=no, location=no, directories=no'); void(0);">Mini API</a> instead.
-This offers the same interface, but in a small stand-alone window.
-

data/work/todo/more/test_basicobject.rb

@@ -1,34 +0,0 @@
-require 'facets/basicobject'
-require 'test/unit'
-
-class TestBasicObject < Test::Unit::TestCase
-
-  class A < BasicObject
-  end
-
-  def setup
-    @a = A.new
-  end
-
-  def test_ignore_new_kernel_methods
-    Kernel.module_eval { def xxx ; end }
-    assert_raises(NoMethodError) { @a.xxx }
-  end
-
-  def test_ignore_new_object_methods
-    Object.class_eval { def yyy ; end }
-    assert_raises(NoMethodError) { @a.yyy }
-  end
-
-  #def test_006
-  #  Object.class_eval { def yyy ; end }
-  #  assert( ! @a.object_self.methods.include?( 'yyy' ) )
-  #end
-
-  #def test_007
-  #  Object.class_eval { def yyy ; end }
-  #  assert( ! @a.object_class.method_defined?( :methods ) )
-  #  assert( ! @a.object_self.methods.include?( :methods ) )
-  #end
-
-end

data/work/todo/more/test_fileutils_slice.rb

@@ -1,88 +0,0 @@
-
-# TODO: This test have been remarked out until such time
-# as a mock FileSystem can be used to test it against.
-
-=begin #test
-
-  require 'test/unit'
-
-  # FIND TEST DIRECTORY
-  paths = File.expand_path(File.dirname(__FILE__)).split('/')
-  paths.size.downto(1) do |i|
-    f = (paths.slice(0..i)+['test']).join('/')
-    $TESTDIR = File.join(f,'FIXTURE') if File.directory?(f)
-  end
-  raise unless $TESTDIR
-
-  class TC_FileUtils_HeadTail < Test::Unit::TestCase
-
-    def setup
-      @workdir = Dir.getwd
-      @thisdir = $TESTDIR
-
-      @tfile = 'test_file.txt'
-
-      @expected_head1 = ["line1\n","line2\n","line3\n","line4\n","line5\n"]
-      @expected_head1.push("line6\n","line7\n","line8\n","line9\n","line10\n")
-      @expected_head2 = ["line1\n","line2\n","line3\n","line4\n","line5\n"]
-
-      @expected_tail1 = ["line16\n","line17\n","line18\n","line19\n","line20\n"]
-      @expected_tail1.push("line21\n","line22\n","line23\n","line24\n","line25\n")
-      @expected_tail2 = ["line21\n","line22\n","line23\n","line24\n","line25\n"]
-
-      @expected_body1 = ["line10\n", "line11\n", "line12\n", "line13\n", "line14\n"]
-      @expected_body1.push("line15\n","line16\n", "line17\n", "line18\n", "line19\n","line20\n")
-      @expected_body2 = ["line14\n","line15\n","line16\n","line17\n","line18\n","line19\n","line20\n"]
-      @expected_body3 = ["line5\n","line6\n","line7\n","line8\n","line9\n","line10\n"]
-    end
-
-    def test_method
-      assert_respond_to( FileUtils, :head )
-      assert_respond_to( FileUtils, :tail )
-      assert_respond_to( FileUtils, :slice )
-    end
-
-    # head
-
-    def test_head
-      Dir.chdir @thisdir
-      begin
-      assert_nothing_raised{ FileUtils.head(@tfile) }
-      assert_nothing_raised{ FileUtils.head(@tfile,5) }
-      assert_equal(@expected_head1,FileUtils.head(@tfile))
-      assert_equal(@expected_head2,FileUtils.head(@tfile,5))
-      ensure
-        Dir.chdir @workdir
-      end
-    end
-
-    # slice
-
-    def test_slice
-      Dir.chdir @thisdir
-      begin
-        assert_nothing_raised{ FileUtils.slice(@tfile,5,10) }
-        assert_equal(@expected_body3,FileUtils.slice(@tfile,5,10))
-      ensure
-        Dir.chdir @workdir
-      end
-    end
-
-    # tail
-
-    def test_tail
-      Dir.chdir @thisdir
-      begin
-        assert_nothing_raised{ FileUtils.tail(@tfile) }
-        assert_nothing_raised{ FileUtils.tail(@tfile,5) }
-        assert_equal(@expected_tail1,FileUtils.tail(@tfile))
-        assert_equal(@expected_tail2,FileUtils.tail(@tfile,5))
-      ensure
-        Dir.chdir @workdir
-      end
-    end
-
-  end
-
-=end
-