ruby_peter_v 0.0.3 → 0.0.4

data/HISTORY.txt

@@ -8,4 +8,8 @@
 
 0.0.3 (2013-05-22)
 
-* Object#max_with_nil added
+* Object#max_with_nil(a, b) added
+
+0.0.4 (20123-05-22)
+
+* Object#set_once(attribute, value) added

data/README.md

@@ -34,6 +34,15 @@ Or install it yourself as:
   This is similar to the behavior ios nil would be considered
   smaller than all other objects.
 
+* #set_once(attribute, value) on Object
+
+  Setting the instance variable with name attribute (a symbol),
+  once to a value value. This acts as a simple form of an
+  immutable attribute. After initialization of the object, it
+  can still be set once from nil to a specific value, but after
+  that, it can never be changed to a different value. Writing
+  it twice with the same value does not trow an exception. 
+
 ## Contributing
 
 1. Fork it

data/lib/ruby_peter_v/set_once.rb

@@ -0,0 +1,16 @@
+class SetOnceError < StandardError ; end
+
+class Object
+
+  def set_once(attribute, value)
+    ivar_symbol = :"@#{attribute}"
+    instance_value = instance_variable_get(ivar_symbol)
+    if (instance_value && instance_value != value)
+      raise(
+        SetOnceError,
+        "Value of #{attribute} was #{instance_value}, trying to set it to #{value}")
+    end
+    instance_variable_set(:"@#{attribute}", value)
+  end
+
+end

data/lib/ruby_peter_v/version.rb

@@ -1,3 +1,3 @@
 module RubyPeterV
-  VERSION = "0.0.3"
+  VERSION = "0.0.4"
 end

data/lib/ruby_peter_v.rb

@@ -1,3 +1,4 @@
 require 'ruby_peter_v/version'
 require 'ruby_peter_v/single'
 require 'ruby_peter_v/max_with_nil'
+require 'ruby_peter_v/set_once'

data/spec/set_once_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+describe "set_once" do
+
+  let(:subject) { Object.new }
+
+  it "can be set when nil" do
+    subject.instance_variable_get(:@attr).should be_nil # assert pre-condition
+    value = 10
+    subject.set_once(:attr, value)
+    subject.instance_variable_get(:@attr).should == value
+  end
+
+  describe "setting it two times" do
+    it "with the same value just works" do
+      value = 10
+      subject.set_once(:attr, value)
+      subject.set_once(:attr, value)
+      subject.instance_variable_get(:@attr).should == value
+    end
+
+    it "with a different value raises a SetOnceError" do
+      value = 10
+      subject.set_once(:attr, value)
+      lambda { subject.set_once(:attr, value+1) } . should raise_error(
+        SetOnceError,
+        "Value of attr was 10, trying to set it to 11")
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_peter_v
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-21 00:00:00.000000000 Z
+date: 2013-05-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -43,10 +43,12 @@ files:
 - Rakefile
 - lib/ruby_peter_v.rb
 - lib/ruby_peter_v/max_with_nil.rb
+- lib/ruby_peter_v/set_once.rb
 - lib/ruby_peter_v/single.rb
 - lib/ruby_peter_v/version.rb
 - ruby_peter_v.gemspec
 - spec/max_with_nil_spec.rb
+- spec/set_once_spec.rb
 - spec/single_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/petervandenabeele/ruby_peter_v
@@ -75,5 +77,6 @@ specification_version: 3
 summary: Ruby helpers for @peter_v
 test_files:
 - spec/max_with_nil_spec.rb
+- spec/set_once_spec.rb
 - spec/single_spec.rb
 - spec/spec_helper.rb