virtus 0.0.10 → 0.1.0

data/spec/integration/custom_attributes_spec.rb

@@ -0,0 +1,49 @@
+require 'spec_helper'
+
+describe 'custom attribtues' do
+
+  module Virtus
+    class Coercion
+      class String < Virtus::Coercion::Object
+        def self.to_upcase(value)
+          value.upcase
+        end
+      end
+    end
+  end
+
+  before do
+    module Examples
+      class UpperCase < Virtus::Attribute::Object
+        primitive String
+        coercion_method :to_upcase
+      end
+
+      class RegularExpression < Virtus::Attribute::Object
+        primitive Regexp
+      end
+
+      class User
+        include Virtus
+
+        attribute :name, String
+        attribute :scream, UpperCase
+        attribute :expression, RegularExpression
+      end
+    end
+  end
+
+  subject { Examples::User.new }
+
+  specify 'allows you to define custom attributes' do
+    regexp = /awesome/
+    subject.expression = regexp
+    subject.expression.should == regexp
+  end
+
+  specify 'allows you to define coercion methods' do
+    subject.scream = 'welcome'
+    subject.scream.should == 'WELCOME'
+  end
+
+end

data/spec/integration/default_values_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+
+describe "default values" do
+
+  before do
+    module Examples
+      class Page
+        include Virtus
+
+        attribute :title,      String
+        attribute :slug,       String,  :default => lambda { |post, attribute| post.title.downcase.gsub(' ', '-') }
+        attribute :view_count, Integer, :default => 0
+      end
+    end
+  end
+
+  subject { Examples::Page.new }
+
+  specify 'without a default the value is nil' do
+    subject.title.should be_nil
+  end
+
+  specify 'can be supplied with the :default option' do
+    subject.view_count.should == 0
+  end
+
+  specify "you can pass a 'callable-object' to the :default option" do
+    subject.title = 'Example Blog Post'
+    subject.slug.should == 'example-blog-post'
+  end
+
+end

data/spec/integration/defining_attributes_spec.rb

@@ -0,0 +1,79 @@
+require 'spec_helper'
+
+describe "virtus attribute definitions" do
+
+  before do
+    module Examples
+      class Person
+        include Virtus
+
+        attribute :name, String
+        attribute :age, Integer
+        attribute :doctor, Boolean
+        attribute :salery, Decimal
+      end
+
+      class Manager < Person
+
+      end
+    end
+  end
+
+  subject { Examples::Person.new }
+
+  specify 'virtus creates accessor methods' do
+    subject.name = 'Peter'
+    subject.name.should == 'Peter'
+  end
+
+  specify 'the constructor accepts a hash for mass-assignment' do
+    john = Examples::Person.new(:name => 'John', :age => 13)
+    john.name.should == 'John'
+    john.age.should == 13
+  end
+
+  specify 'Boolean attributes have a getter with questionmark' do
+    subject.doctor?.should be_false
+    subject.doctor = true
+    subject.doctor?.should be_true
+  end
+
+  context 'with attributes' do
+    let(:attributes) { {:name => 'Jane', :age => 45, :doctor => true, :salery => 4500} }
+    subject { Examples::Person.new(attributes) }
+
+    specify "#attributes returns the object's attributes as a hash" do
+      subject.attributes.should == attributes
+    end
+
+    specify "#to_hash returns the object's attributes as a hash" do
+      subject.to_hash.should == attributes
+    end
+  end
+
+  context 'inheritance' do
+    specify 'inherits all the attribtues from the base class' do
+      fred = Examples::Manager.new(:name => 'Fred', :age => 29)
+      fred.name.should == 'Fred'
+      fred.age.should == 29
+    end
+
+    specify 'lets you add attributes to the base class at runtime' do
+      frank = Examples::Manager.new(:name => 'Frank')
+      Examples::Person.attribute :just_added, String
+      frank.just_added = 'it works!'
+      frank.just_added.should == 'it works!'
+    end
+
+    specify 'lets you add attributes to the subclass at runtime' do
+      person_jack = Examples::Person.new(:name => 'Jack')
+      manager_frank = Examples::Manager.new(:name => 'Frank')
+      Examples::Manager.attribute :just_added, String
+
+      manager_frank.just_added = 'awesome!'
+      manager_frank.just_added.should == 'awesome!'
+      person_jack.should_not respond_to(:just_added)
+      person_jack.should_not respond_to(:just_added=)
+    end
+  end
+end

data/spec/integration/embedded_value_spec.rb

@@ -0,0 +1,50 @@
+require 'spec_helper'
+
+describe 'embedded values' do
+  before do
+    module Examples
+      class City
+        include Virtus
+
+        attribute :name, String
+      end
+
+      class Address
+        include Virtus
+
+        attribute :street,  String
+        attribute :zipcode, String
+        attribute :city,    City
+      end
+
+      class User
+        include Virtus
+
+        attribute :name,    String
+        attribute :address, Address
+      end
+    end
+  end
+
+  subject { Examples::User.new(:name => 'the guy',
+                               :address => address_attributes) }
+  let(:address_attributes) do
+      { :street => 'Street 1/2', :zipcode => '12345', :city => { :name => 'NYC' } }
+  end
+
+  specify '#attributes returns instances of the embedded values' do
+    subject.attributes.should == {
+      :name => 'the guy',
+      :address => subject.address
+    }
+  end
+
+  specify 'allows you to pass a hash for the embedded value' do
+    user = Examples::User.new
+    user.address = address_attributes
+    user.address.street.should == 'Street 1/2'
+    user.address.zipcode.should == '12345'
+    user.address.city.name.should == 'NYC'
+  end
+
+end

data/spec/integration/overriding_virtus_spec.rb

@@ -0,0 +1,46 @@
+require 'spec_helper'
+
+describe 'overriding virtus behavior' do
+
+  before do
+    module Examples
+      class Article
+        include Virtus
+
+        attribute :title, String
+
+        def title
+          super || '<unknown>'
+        end
+
+        def title=(name)
+          super unless self.title == "can't be changed"
+        end
+      end
+    end
+  end
+
+  describe 'overriding an attribute getter' do
+    specify 'calls the defined getter' do
+      Examples::Article.new.title.should == '<unknown>'
+    end
+
+    specify 'super can be used to access the getter defined by virtus' do
+      Examples::Article.new(:title => 'example article').title.should == 'example article'
+    end
+  end
+
+  describe 'overriding an attribute setter' do
+    specify 'calls the defined setter' do
+      article = Examples::Article.new(:title => "can't be changed")
+      article.title = 'this will never be assigned'
+      article.title.should == "can't be changed"
+    end
+
+    specify 'super can be used to access the setter defined by virtus' do
+      article = Examples::Article.new(:title => 'example article')
+      article.title = 'my new title'
+      article.title.should == 'my new title'
+    end
+  end
+end

data/spec/integration/virtus/instance_level_attributes_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+describe Virtus, 'instance level attributes' do
+  subject do
+    subject = Object.new
+    subject.singleton_class.send(:include, Virtus)
+    subject
+  end
+
+  let(:attribute) { subject.singleton_class.attribute(:name, String) }
+
+  before do
+    pending if RUBY_VERSION < '1.9'
+  end
+
+  context 'adding an attribute' do
+    it 'allows setting the attribute value on the instance' do
+      attribute
+      subject.name = 'foo'
+      subject.name.should eql('foo')
+    end
+  end
+end

data/spec/rcov.opts

@@ -4,3 +4,4 @@
 --xrefs
 --profile
 --text-summary
+--failure-threshold 100

data/spec/shared/constants_helpers.rb

@@ -0,0 +1,9 @@
+module ConstantsHelpers
+
+  extend self
+
+  # helper to remove constants after test-runs.
+  def undef_constant(mod, constant_name)
+    mod.send(:remove_const, constant_name)
+  end
+end

data/spec/shared/options_class_method.rb

@@ -0,0 +1,19 @@
+shared_examples_for 'an options class method' do
+  context 'with no argument' do
+    subject { object.send(method) }
+
+    it { should be(default) }
+  end
+
+  context 'with a default value' do
+    subject { object.send(method, value) }
+
+    let(:value) { stub('value') }
+
+    it { should equal(object) }
+
+    it 'sets the default value for the class method' do
+      expect { subject }.to change { object.send(method) }.from(nil).to(value)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -1,27 +1,40 @@
 require 'backports'
-require 'pathname'
 require 'rubygems'
-require 'rspec'
+
+begin
+  require 'rspec'  # try for RSpec 2
+rescue LoadError
+  require 'spec'   # try for RSpec 1
+  RSpec = Spec::Runner
+end
 
 require 'virtus'
 
 ENV['TZ'] = 'UTC'
 
-SPEC_ROOT = Pathname(__FILE__).dirname.expand_path
-
-Pathname.glob((SPEC_ROOT + '**/shared/**/*.rb').to_s).each { |file| require file }
+# require spec support files and shared behavior
+Dir[File.expand_path('../**/shared/**/*.rb', __FILE__)].each { |file| require file }
 
 RSpec.configure do |config|
 
-  # Remove anonymous Attribute classes from Attribute descendants
+  # Remove anonymous- and example- Attribute classes from Attribute descendants
   config.after :all do
     stack = [ Virtus::Attribute ]
     while klass = stack.pop
       klass.descendants.delete_if do |descendant|
-        descendant.name.nil? || descendant.name.empty?
+        descendant.name.nil? || descendant.name.empty? || descendant.name.start_with?('Examples::')
       end
       stack.concat(klass.descendants)
     end
   end
 
+  # Remove constants in the Example-Module
+  config.after :each do
+    if defined?(Examples)
+      Examples.constants.each do |const_name|
+        ConstantsHelpers.undef_constant(Examples, const_name)
+      end
+    end
+  end
+
 end

data/spec/unit/virtus/attribute/array/coerce_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+describe Virtus::Attribute::Array, '#coerce' do
+  subject { attribute.coerce(value) }
+
+  let(:attribute) { described_class.new(:colors) }
+
+  context 'with a Hash' do
+    let(:value) { { :foo => 'bar' } }
+
+    it { should eql([ [ :foo, 'bar' ] ]) }
+  end
+end

data/spec/unit/virtus/attribute/boolean/coerce_spec.rb

@@ -0,0 +1,85 @@
+require 'spec_helper'
+
+describe Virtus::Attribute::Boolean, '#coerce' do
+  subject { attribute.coerce(value) }
+
+  let(:attribute) { described_class.new(:is_admin) }
+
+  context 'with 1' do
+    let(:value) { 1 }
+
+    it { should be(true) }
+  end
+
+  context 'with "1"' do
+    let(:value) { '1' }
+
+    it { should be(true) }
+  end
+
+  context 'with "true"' do
+    let(:value) { 'true' }
+
+    it { should be(true) }
+  end
+
+  context 'with "TRUE"' do
+    let(:value) { 'TRUE' }
+
+    it { should be(true) }
+  end
+
+  context 'with "t"' do
+    let(:value) { 't' }
+
+    it { should be(true) }
+  end
+
+  context 'with "T"' do
+    let(:value) { 'T' }
+
+    it { should be(true) }
+  end
+
+  context 'with 0' do
+    let(:value) { 0 }
+
+    it { should be(false) }
+  end
+
+  context 'with "0"' do
+    let(:value) { '0' }
+
+    it { should be(false) }
+  end
+
+  context 'with "false"' do
+    let(:value) { 'false' }
+
+    it { should be(false) }
+  end
+
+  context 'with "FALSE"' do
+    let(:value) { 'FALSE' }
+
+    it { should be(false) }
+  end
+
+  context 'with "f"' do
+    let(:value) { 'f' }
+
+    it { should be(false) }
+  end
+
+  context 'with "F"' do
+    let(:value) { 'F' }
+
+    it { should be(false) }
+  end
+
+  context 'with "Foo"' do
+    let(:value) { 'Foo' }
+
+    it { should equal(value) }
+  end
+end