classy 1.0.3 → 1.1.0

data/VERSION

@@ -1 +1 @@
-1.0.3
+1.1.0

data/lib/classy.rb

@@ -1,3 +1,4 @@
-Dir.foreach( File.join( File.dirname(__FILE__), 'classy' ) ) do |entry|
-  require "classy/#{entry}" if entry =~ /\.rb$/
+path = File.join(File.dirname(__FILE__), 'classy')
+Dir.foreach( path ) do |entry|
+  require "#{path}/#{entry}" if entry =~ /\.rb$/
 end

data/lib/classy/templatable.rb

@@ -0,0 +1,61 @@
+module Templatable
+
+  # A hash to track templatable variables that have been locally set.
+  # (Required to distinguish between variables explicitly set to nil and those
+  # left as nil by default.)
+  #
+  @@ever_been_set = Hash.new { |hash, key| hash[key] = {} }
+
+  def templatable_attr (*symbols)
+    symbols.each do |symbol|
+      # define the instance setter method
+      #
+      define_method("#{symbol}=".to_sym) do |value|
+        instance_variable_set("@#{symbol}", value)
+        @@ever_been_set[self][symbol] = true
+      end
+
+      # define the instance getter method
+      #
+      define_method(symbol) do 
+        if @@ever_been_set[self][symbol]
+          return instance_variable_get("@#{symbol}")
+        elsif self.class.class_variable_defined?("@@#{symbol}")
+          return self.class.class_exec { class_variable_get("@@#{symbol}") }
+        else
+          return nil
+        end
+      end
+
+      class_exec do
+        # define the class setter method
+        #
+        # We have to use this send hack, since define_method is private.
+        #
+        self.class.send(:define_method, "#{symbol}=".to_sym) do |value|
+          class_variable_set("@@#{symbol}", value)
+        end
+
+        # define the class getter/setter method
+        #
+        # We want to be able to call this like a dsl as a setter, or like a
+        # class method as a getter, so we need variable arity, which
+        # define_method doesn't support.  In order to use the standard `def`
+        # with variable arity, eval'ing a string seems to be the only option.
+        #
+        # Oh man would I love for somebody to submit a patch to do this in a
+        # less horrible way.
+        #
+        self.class.class_eval "
+          def #{symbol} (value = nil)
+            if value
+              class_variable_set(\"@@#{symbol}\", value)
+            end
+            class_variable_get(\"@@#{symbol}\") if class_variable_defined?(\"@@#{symbol}\")
+          end
+        "
+      end
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -7,3 +7,10 @@ require 'spec/autorun'
 Spec::Runner.configure do |config|
   
 end
+
+# Doesn't work for anything inside a module (eg, if you try to remove
+# Testify::Framework::RSpec this will totally blow up).
+def destroy_class ( klass )
+  klass = klass.name.to_s if klass.kind_of? Class
+  Object.class_exec { remove_const klass } if Object.const_defined? klass
+end

data/spec/templatable_spec.rb

@@ -0,0 +1,76 @@
+require File.join(File.dirname(__FILE__), 'spec_helper')
+
+describe "Templatable" do
+
+  before do
+    destroy_class(Widget) if defined?(Widget)
+    class Widget
+      extend Templatable
+      templatable_attr :temperature, :awesomeness
+    end
+
+    Widget.awesomeness = :total
+
+    @doodad = Widget.new
+  end
+
+  it "should allow default values to be set as an assignment" do
+    Widget.temperature = :cool
+    Widget.temperature.should equal :cool
+  end
+
+  it "should allow default values to be via a dsl" do
+    class Widget
+      temperature :hot!
+    end
+    Widget.temperature.should equal :hot!
+  end
+
+  it "should return the default value from the class when set" do
+    Widget.awesomeness.should equal :total
+  end
+
+  it "should return nil from the class when unset" do
+    Widget.temperature.should be_nil
+  end
+
+  it "should return the default value from an instance when set and not overridden" do
+    @doodad.awesomeness.should equal :total
+  end
+
+  it "should return nil from an instance when unset and not overrideen" do
+    @doodad.temperature.should be_nil
+  end
+
+  it "should allow instances to override the default values" do
+    @doodad.awesomeness = :sorta_i_guess
+    @doodad.awesomeness.should equal :sorta_i_guess
+  end
+
+  it "shouldn't affect other instances when overriding a value" do
+    @whatsit = Widget.new
+    @whatsit.awesomeness = :locally
+
+    @doodad.awesomeness.should equal(:total)
+  end
+
+  it "shouldn't affect other Templatable classes" do
+    destroy_class(Pony) if defined?(Pony)
+    class Pony
+      extend Templatable
+      templatable_attr :name, :awesomeness
+    end
+    sugar = Pony.new    # You get a pony!
+
+    Pony.awesomeness.should be_nil
+    sugar.awesomeness.should be_nil
+
+    Pony.awesomeness = :omg
+    Pony.awesomeness.should equal(:omg)
+    sugar.awesomeness.should equal(:omg)
+
+    sugar.awesomeness = :meh    # Apparently, you get a bad pony.
+    sugar.awesomeness.should equal(:meh)
+  end
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: classy
 version: !ruby/object:Gem::Version 
-  version: 1.0.3
+  version: 1.1.0
 platform: ruby
 authors: 
 - John Hyland
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-01-04 00:00:00 -05:00
+date: 2010-01-12 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -41,10 +41,12 @@ files:
 - lib/classy.rb
 - lib/classy/aliasable.rb
 - lib/classy/subclass_aware.rb
+- lib/classy/templatable.rb
 - spec/aliasable_spec.rb
 - spec/spec.opts
 - spec/spec_helper.rb
 - spec/subclass_aware_spec.rb
+- spec/templatable_spec.rb
 has_rdoc: true
 homepage: http://github.com/djspinmonkey/classy
 licenses: []