propertybuilder 1.0.0

data/History.txt

@@ -0,0 +1,3 @@
+=== 1.0.0 / 2008-03-25
+
+* Initial release

data/Manifest.txt

@@ -0,0 +1,7 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/property_builder.rb
+lib/propertybuilder.rb
+test/test_property_builder.rb

data/README.txt

@@ -0,0 +1,67 @@
+= propertybuilder
+
+* http://propertybuilder.rubyforge.org
+
+== DESCRIPTION:
+
+Property Builder is a small library for building chains of symbols that will silently fail on nil. This is meant as an alternative to Object#andand and the ilk.  This is mostly a theoretical approach, meant to encourage discussion. 
+
+== FEATURES/PROBLEMS:
+
+Two main components:
+
+Object#is to build a PropertyBuilder chain
+
+Object#build_on to build the PropertyBuilder on the object and return the specified property
+
+== SYNOPSIS:
+
+class TestClass
+  attr_accessor :attachment
+end
+
+class TestAttachment
+  def a_method(an_argument="argument")
+    an_argument
+  end
+end
+
+@test = TestClass.new
+@test.attachment = TestAttachment.new
+# same as @test.attachment.a_method, but will fail silently if @test.attachment is nil
+@test.build_on(is(:attachment, :a_method))
+# same as @test.attachment.a_method("test_argument")
+@test.build_on(is(:attachment, [:a_method, "test_argument"]))
+
+== REQUIREMENTS:
+
+ActiveSupport
+
+== INSTALL:
+
+gem install propertybuilder
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 FIX
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,12 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require './lib/property_builder'
+
+Hoe.new('propertybuilder', PropertyBuilder::VERSION) do |p|
+  p.rubyforge_name = 'propertybuilder' # if different than lowercase project name
+  p.developer('Erik Peterson', 'erik@subwindow.com')
+end
+
+# vim: syntax=Ruby

data/lib/property_builder.rb

@@ -0,0 +1,85 @@
+module PropertyBuilder
+  VERSION = '1.0.0'
+  class PropertyList < Hash
+    attr_accessor :key_order
+    def initialize(&block)
+      @key_order = []
+      yield(self)
+    end
+
+    def each
+      @key_order.each do |key|
+        yield(key,self[key])
+      end
+    end
+  
+    def first
+      self[@key_order.first]
+    end
+
+    def [](position)
+      if position.is_a?(Integer) && !@key_order.include?(position)
+        self[@key_order[position]]
+      else
+        super
+      end
+    end
+
+    def []= (key,val)
+      if not @key_order.include? key
+        @key_order << key
+      end
+      eval("      
+        def #{key}(value=nil)
+          self[:#{key}]=(value.is_a?(Array) ? value.first : value)||is(:#{key})
+        end
+      ")
+      super key,val
+    end
+  
+    def method_missing(name, *args)
+      self[name] = nil
+      self.send(name, args)
+    end
+  end
+
+  class PropertyDefinition
+    attr_accessor :chain, :options
+    def initialize(options)
+      @chain = options.select{|a|!a.is_a?(Hash)}
+      @options = options.last.is_a?(Hash) ? options.last : {}
+    end
+    
+    def build(obj)
+      PropertyDefinition.build(obj, @chain.dup)
+    end
+    
+    def self.build(level, chain)
+      if !chain.nil? && chain.is_a?(Array) && chain.size > 0
+        sender = chain.shift
+        if sender.is_a?(Array) #Only supports one argument for now
+          result = level.send(sender.first, sender.last)
+        elsif sender.is_a?(String)
+          result = level.instance_eval(sender)
+        else
+          result = level.send(sender)
+        end
+        chain.size == 0 ? result : (result.nil? ? result : build(result, chain)) 
+      elsif chain.is_a?(String)
+        chain
+      elsif chain.is_a?(Symbol)
+        level.send(chain)
+      end
+    end
+  end
+end
+
+class Object
+  def is(*args)
+    PropertyBuilder::PropertyDefinition.new(args)
+  end
+  
+  def build_on(builder)
+    builder.build(self)
+  end
+end

data/lib/propertybuilder.rb

@@ -0,0 +1 @@
+require 'property_builder'

data/test/test_property_builder.rb

@@ -0,0 +1,39 @@
+require 'test/unit'
+require File.dirname(__FILE__) + '/../lib/property_builder'
+
+class TestClass
+  attr_accessor :attachment
+end
+
+class TestAttachment
+  def a_method(an_argument="argument")
+    an_argument
+  end
+end
+
+class PropertyBuilderTest < Test::Unit::TestCase
+  def setup
+    @test = TestClass.new
+    @test.attachment = TestAttachment.new
+  end
+  
+  def test_object_is
+    chain = is(:attachment)
+    assert_equal PropertyBuilder::PropertyDefinition, chain.class
+  end
+  
+  def test_chain_build_no_arguments
+    chain = is(:attachment, :a_method)
+    assert_equal "argument", chain.build(@test)
+  end
+  
+  def test_chain_build_with_argument
+    chain = is(:attachment, [:a_method, "test_argument"])
+    assert_equal "test_argument", chain.build(@test)
+  end
+  
+  def test_build_on
+    assert_equal "argument", @test.build_on(is(:attachment, :a_method))
+  end
+end
+

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification 
+name: propertybuilder
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Erik Peterson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-03-25 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.5.1
+    version: 
+description: Property Builder is a small library for building chains of symbols that will silently fail on nil. This is meant as an alternative to Object#andand and the ilk.  This is mostly a theoretical approach, meant to encourage discussion.
+email: 
+- erik@subwindow.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- lib/property_builder.rb
+- lib/propertybuilder.rb
+- test/test_property_builder.rb
+has_rdoc: true
+homepage: http://propertybuilder.rubyforge.org
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: propertybuilder
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: Property Builder is a small library for building chains of symbols that will silently fail on nil
+test_files: 
+- test/test_property_builder.rb