conformista 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1f04bcb7b29bfa87a83e80616ed0052d3b25a257
+  data.tar.gz: 19965cebba0c769c08cecac890457305da0ba9f9
+SHA512:
+  metadata.gz: 14fbe9eb6bc28bc6cbbc43a4fcc2931182a0f1f38e71cfc0d96a78e594bde95eff0f69fe260e5082ac35a27f56169e2547978738e7f6bceec21a78e9823f1bc1
+  data.tar.gz: 65723d4816355a3a2a829617f982b904a2250d2114822daa4f6fec8105e86b3a4eae61f902790335960a0556cfea50978e485071f8b3c258a986782afca7e714

data/.gitignore

@@ -0,0 +1,4 @@
+pkg
+.bundle
+.yardoc
+doc

data/.rspec

@@ -0,0 +1,6 @@
+--format progress
+--color
+--order rand
+-Ilib
+-Ispec
+-r spec_helper

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - rbx-19mode

data/.yardopts

@@ -0,0 +1,8 @@
+--no-private
+--title "Conformista"
+--readme README.md
+--markup markdown
+--markup-provider kramdown
+-
+HISTORY.md
+LICENSE

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/Gemfile.lock

@@ -0,0 +1,58 @@
+PATH
+  remote: .
+  specs:
+    conformista (0.0.1)
+      activemodel
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activemodel (4.0.0)
+      activesupport (= 4.0.0)
+      builder (~> 3.1.0)
+    activerecord (4.0.0)
+      activemodel (= 4.0.0)
+      activerecord-deprecated_finders (~> 1.0.2)
+      activesupport (= 4.0.0)
+      arel (~> 4.0.0)
+    activerecord-deprecated_finders (1.0.3)
+    activesupport (4.0.0)
+      i18n (~> 0.6, >= 0.6.4)
+      minitest (~> 4.2)
+      multi_json (~> 1.3)
+      thread_safe (~> 0.1)
+      tzinfo (~> 0.3.37)
+    arel (4.0.0)
+    atomic (1.1.14)
+    builder (3.1.4)
+    diff-lcs (1.2.4)
+    i18n (0.6.5)
+    kramdown (1.2.0)
+    minitest (4.7.5)
+    multi_json (1.8.0)
+    rake (10.1.0)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.5)
+    rspec-expectations (2.14.3)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.3)
+    sqlite3 (1.3.8)
+    thread_safe (0.1.3)
+      atomic
+    tzinfo (0.3.37)
+    yard (0.8.7.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activerecord
+  conformista!
+  kramdown
+  rake
+  rspec
+  sqlite3
+  yard

data/HISTORY.md

@@ -0,0 +1,6 @@
+# HISTORY
+
+## 0.1.0
+
+* Initial release
+

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (C) 2013 Arjan van der Gaag
+
+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/README.md

@@ -0,0 +1,173 @@
+# Conformista [![Build Status](https://secure.travis-ci.org/avdgaag/conformista.png?branch=master)](http://travis-ci.org/avdgaag/conformista)
+
+## Introduction
+
+Conformista is a library to make building presenters -- and form objects in
+particular -- easier. It provides an ActiveModel-compliant base class that your
+own form objects can inherit from, along with standard behaviour for creating,
+loading, validating and persisting business objects (usually ActiveRecord
+models).
+
+## Installation
+
+Conformista is distributed as a Ruby gem, which should be installed on most Macs and
+Linux systems. Once you have ensured you have a working installation of Ruby
+and Ruby gems, install the gem as follows from the command line:
+
+    $ gem install conformista
+
+To use it with Bundler, add it to your `Gemfile`:
+
+    gem 'conformista'
+
+Then install it by running `bundle install`.
+
+## Usage
+
+The canonical example of a form object is a sign up form. Let's say we want to
+let a visitor to our Rails application sign up for an account. That will include
+creating an `Account`, `User` and `Profile`.
+
+```ruby
+class Account < ActiveRecord::Base
+  validates :name, presence: true
+end
+
+class User < ActiveRecord::Base
+  validates :email, :password, presence: true
+  has_secure_password
+end
+
+class Profile < ActiveRecord::Base
+end
+```
+
+Instead of using `accepts_nested_attributes_for`, or cramming all the data in
+the `User` model, or using a lot of controller logic, we use a form object to
+present these three entities as a single object to the view:
+
+```ruby
+class SignupController < ApplicationController
+  def new
+    @signup = Signup.new
+  end
+
+  def create
+    @signup = Signup.new(params[:signup])
+    if @signup.save
+      redirect_to root_url, notice: 'Thanks for signing up!'
+    else
+      render 'new'
+    end
+  end
+end
+```
+
+The single object we use is a form object that inherits from
+`Conformista::FormObject`:
+
+```ruby
+class Signup < Conformista::FormObject
+  presents User    => %i[email password],
+           Account => %i[name],
+           Profile => %i[bio twitter github]
+
+  attr_accessor :password_confirmation,
+                :terms_and_conditions
+
+  validates :password, confirmation: true
+  validates :terms_and_conditions, acceptance: true
+
+  after_save :deliver_welcome_email
+
+  private
+
+  def deliver_welcome_email
+    Notifications.welcome_email(user).deliver
+  end
+end
+```
+
+We can now generate a form for our form object:
+
+```erb
+<%= form_for @signup, url: signup_path do |f| %>
+  <p>
+    <%= f.label :name %><br>
+    <%= f.text_field :name %>
+  </p>
+  <p>
+    <%= f.label :email %><br>
+    <%= f.text_field :email %>
+  </p>
+  <p>
+    <%= f.label :password %>
+    <%= f.password_field :password %>
+  </p>
+  <p>
+    <%= f.label :password_confirmation %><br>
+    <%= f.password_field :password_confirmation %>
+  </p>
+  <p>
+    <%= f.label :bio %><br>
+    <%= f.text_area :bio %><br>
+  </p>
+  <p>
+    <%= f.label :twitter %><br>
+    <%= f.text_field :twitter %><br>
+  </p>
+  <p>
+    <%= f.label :github %><br>
+    <%= f.text_field :github %><br>
+  </p>
+  <p>
+    <%= f.check_box :terms_and_conditions %>
+    I have read and agree to the terms and conditions
+  </p>
+  <p>
+    <%= f.submit %>
+  </p>
+<% end %>
+```
+
+Note how the logic specifically tied to the form, like the acceptance and
+confirmation validations, and the email delivery, have been moved out of the
+model layer into the presenter layer. However, the single presenter object
+will re-use the data-specific validations defined in the model.
+
+### Documentation
+
+See the inline [API
+docs](http://rubydoc.info/github/avdgaag/conformista/master/frames) for more
+information.
+
+## Other
+
+### Note on Patches/Pull Requests
+
+1. Fork the project.
+2. Make your feature addition or bug fix.
+3. Add tests for it. This is important so I don't break it in a future version
+   unintentionally.
+4. Commit, do not mess with rakefile, version, or history. (if you want to have
+   your own version, that is fine but bump version in a commit by itself I can
+   ignore when I pull)
+5. Send me a pull request. Bonus points for topic branches.
+
+### Issues
+
+Please report any issues, defects or suggestions in the [Github issue
+tracker](https://github.com/avdgaag/conformista/issues).
+
+### What has changed?
+
+See the [HISTORY](https://github.com/avdgaag/conformista/blob/master/HISTORY.md) file
+for a detailed changelog.
+
+### Credits
+
+Created by: Arjan van der Gaag  
+URL: [http://arjanvandergaag.nl](http://arjanvandergaag.nl)  
+Project homepage: [http://avdgaag.github.com/conformista](http://avdgaag.github.com/conformista)  
+Date: september 2013  
+License: [MIT-license](https://github.com/avdgaag/conformista/blob/master/LICENSE) (same as Ruby)

data/Rakefile

@@ -0,0 +1,15 @@
+#!/usr/bin/env rake
+require 'bundler'
+Bundler::GemHelper.install_tasks
+Bundler.setup
+
+desc 'Default: run specs.'
+task :default => :spec
+
+require 'rspec/core/rake_task'
+desc 'Run specs'
+RSpec::Core::RakeTask.new
+
+require 'yard'
+desc 'Generate API docs'
+YARD::Rake::YardocTask.new

data/conformista.gemspec

@@ -0,0 +1,46 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/conformista/version', __FILE__)
+
+Gem::Specification.new do |s|
+  # Metadata
+  s.name        = 'conformista'
+  s.version     = Conformista::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Arjan van der Gaag']
+  s.email       = %q{arjan@arjanvandergaag.nl}
+  s.description = %q{A library for creating form objects for Rails applications.}
+  s.homepage    = %q{http://avdgaag.github.com/conformista}
+  s.summary     = <<-EOS
+Conformista is a library to make building presenters -- and form objects in
+particular -- easier. It provides an ActiveModel-compliant base class that your
+own form objects can inherit from, along with standard behaviour for creating,
+loading, validating and persisting business objects (usually ActiveRecord
+models).
+EOS
+
+  # Files
+  s.files         = `git ls-files`.split("
+")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("
+")
+  s.executables   = `git ls-files -- bin/*`.split("
+").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # Rdoc
+  s.rdoc_options = ['--charset=UTF-8']
+  s.extra_rdoc_files = [
+     'LICENSE',
+     'README.md',
+     'HISTORY.md'
+  ]
+
+  # Dependencies
+  s.add_dependency 'activemodel'
+  s.add_development_dependency 'kramdown'
+  s.add_development_dependency 'yard'
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'activerecord'
+  s.add_development_dependency 'sqlite3'
+end

data/lib/conformista.rb

@@ -0,0 +1,9 @@
+require 'active_model'
+require 'conformista/version'
+require 'conformista/validations'
+require 'conformista/transactions'
+require 'conformista/presenting'
+require 'conformista/form_object'
+
+module Conformista
+end

data/lib/conformista/form_object.rb

@@ -0,0 +1,123 @@
+module Conformista
+  # The FormObject is an ActiveModel-compliant object that knows how to present
+  # multiple Ruby objects (usually descendents of ActiveRecord::Base) to the
+  # view layer in an application. The form object is specifically designed to
+  # work with Rails `form_for` helpers.
+  #
+  # The form object's responsibility is not too complex:
+  #
+  # * Provide accessors to presented models.
+  # * Delegate selected attributes on the form object to the appropriate
+  #   presented models.
+  # * Delegate model validation and persistence.
+  #
+  # We can make the behaviour a little more complex by defining validations
+  # specific to our form object. Validations that belong on presenters rather
+  # than data models include:
+  #
+  # * Matching password confirmation
+  # * Acceptance of terms and conditions
+  #
+  # In your `FormObject` subclass, you can override methods to customize the
+  # default behaviour. The default behaviour includes:
+  #
+  # * models are built using the `new` method
+  # * models are saved using the `save` method
+  # * model attributes are set using accessor methods
+  # * models are validated using the `valid?` method
+  #
+  # You can customise its behaviour by overriding methods. You can add new
+  # behaviour by using callbacks (`:validation`, `:save` and `:persist`).
+  #
+  # @example Present multiple models and override some default behaviour
+  #   class SignupForm < Conformista::FormObject
+  #     presents account: %i[name],
+  #                 user: %i[email password],
+  #              profile: %i[twitter github bio]
+  #
+  #     private
+  #
+  #     def build_profile
+  #       user.build_profile
+  #     end
+  #
+  #     def persist_user
+  #       user.save!
+  #     end
+  #   end
+  class FormObject
+    extend ActiveModel::Callbacks
+    include ActiveModel::Model
+    include ActiveModel::Validations::Callbacks
+
+    define_model_callbacks :save, :persist
+    before_save :delegate_attributes
+
+    include Transactions
+    include Validations
+    extend Presenting
+
+    def initialize(params = {})
+      set_attributes(params)
+    end
+
+    # Whether all presented models are persisted.
+    def persisted?
+      presented_models.all? do |model|
+        send(model.model_name.singular).persisted?
+      end
+    end
+
+    # Persist all models, if they are all valid. This invokes
+    # the `:save` hook.
+    def save
+      run_callbacks :save do
+        persist_models
+      end
+    end
+
+    # Delegate the hash of attributes to the presented models
+    # and save the object.
+    #
+    # @see #save
+    # @param [Hash] params
+    def update_attributes(params)
+      set_attributes(params)
+      save
+    end
+
+    private
+
+    def set_attributes(params)
+      params.each do |attr, value|
+        public_send :"#{attr}=", value
+      end if params
+    end
+
+    def presented_models
+      []
+    end
+
+    def delegate_attributes
+      each_model do |record, name|
+        send :"delegate_#{name}_attributes"
+      end
+    end
+
+    def persist_models
+      run_callbacks :persist do
+        presented_models.inject(true) do |all_saved, model|
+          record_saved = send :"persist_#{model.model_name.singular}"
+          all_saved &&= record_saved
+        end
+      end
+    end
+
+    def each_model
+      presented_models.each do |presented_model|
+        name = presented_model.model_name.singular
+        yield send(name), name
+      end
+    end
+  end
+end

data/lib/conformista/presenting.rb

@@ -0,0 +1,117 @@
+module Conformista
+  # Presenting provides the macro to extend a form object with the methods to
+  # present models and to build, persist and validate them.
+  #
+  # Given a model `User`, you can override the following methods to customise
+  # the default behaviour:
+  #
+  # * `build_user`: should return a new instance of the model
+  # * `user`: should return the currently presented model instance
+  # * `user=`: set the currently presented model instance
+  # * `persist_user`: persist the current model instance
+  # * `load_user_attributes`: get model attributes and store it in the form
+  #   object
+  # * `delegate_user_attributes`: set model attributes from the form object
+  #   attributes
+  # * `validate_user`: test if the model instance is valid
+  #
+  # @example Present a single model
+  #   class SignupForm < Conformista::FormObject
+  #     presents User, :email, :password
+  #   end
+  #
+  # @example Present multiple models
+  #   class SignupForm < Conformista::FormObject
+  #     presents User    => %i[email password],
+  #              Profile => %i[twitter github bio]
+  #   end
+  #
+  # @see FormObject
+  module Presenting
+    # Convenience method to use either `present_models` or `present_model`,
+    # based on the number of arguments passed in.
+    #
+    # @overload presents(model, *attributes)
+    #   Present a single model and its attributes
+    #   @param [Class] model
+    #   @param [Symbol] method name
+    # @overload presents(models)
+    #   Present multiple models using a Hash of classes and attributes
+    #   @param [Hash] models as keys, array of attributes as value
+    def presents(*args)
+      if args.size == 1
+        present_models *args
+      else
+        present_model *args
+      end
+    end
+
+    # Present multiple models using a Hash of classes and attributes
+    #
+    # @param [Hash] options models as keys, array of attributes as value
+    def present_models(options = {})
+      options.each do |model, attributes|
+        present_model model, *attributes
+      end
+    end
+
+    # Present a single model and its attributes
+    #
+    # @param [Class] model the class of object to present
+    # @param [Symbol] attributes one or more attribute names
+    def present_model(model, *attributes)
+      model_name = model.model_name.singular
+      ivar = :"@#{model_name}".to_sym
+
+      mod = Module.new do
+        attr_accessor *attributes
+
+        define_method :presented_models do
+          super().tap do |orig|
+            orig << model unless orig.include? model
+          end
+        end
+
+        define_method model_name do
+          if instance_variable_get(ivar).nil?
+            instance_variable_set ivar, send(:"build_#{model_name}")
+          else
+            instance_variable_get ivar
+          end
+        end
+
+        define_method :"build_#{model_name}" do
+          model.new
+        end
+
+        define_method :"#{model_name}=" do |obj|
+          instance_variable_set(ivar, obj).tap do |obj|
+            send :"load_#{model_name}_attributes"
+          end
+        end
+
+        define_method :"load_#{model_name}_attributes" do
+          attributes.each do |attribute|
+            send("#{attribute}=", send(model_name).send("#{attribute}"))
+          end
+        end
+
+        define_method :"delegate_#{model_name}_attributes" do
+          attributes.each do |attribute|
+            send(model_name).send("#{attribute}=", send(attribute))
+          end
+        end
+
+        define_method :"validate_#{model_name}" do
+          send(model_name).valid?
+        end
+
+        define_method :"persist_#{model_name}" do
+          send(model_name).save
+        end
+      end
+
+      include mod
+    end
+  end
+end

data/lib/conformista/transactions.rb

@@ -0,0 +1,20 @@
+module Conformista
+  # Provides transactional functionality to form objects, wrapping persistence
+  # operations in a database transaction to ensure either all presented models
+  # are persisted, or none are.
+  module Transactions
+    def self.included(base)
+      base.around_persist :wrap_in_database_transaction
+    end
+
+    private
+
+    def wrap_in_database_transaction
+      ActiveRecord::Base.transaction do
+        yield.tap do |all_saved|
+          raise ActiveRecord::Rollback unless all_saved
+        end
+      end
+    end
+  end
+end

data/lib/conformista/validations.rb

@@ -0,0 +1,36 @@
+module Conformista
+  # Adds validation behaviour to ActiveModel-compliant objects. This means that
+  # objects this module is mixed into will only run `save` if it responds
+  # positively to `valid?`.
+  #
+  # This model makes sure that all attributes are properly delegated before any
+  # validations run, and copies any presented model errors to the host object.
+  #
+  # You can override how specific models are validated by overriding the
+  # `validate_MODEL_NAME` method.
+  module Validations
+    def self.included(base)
+      base.before_validation :delegate_attributes
+      base.before_validation :validate_models
+      base.before_validation :copy_validation_errors
+      base.before_save :valid?
+    end
+
+    private
+
+    def validate_models
+      each_model do |record, name|
+        send :"validate_#{name}"
+      end
+    end
+
+    def copy_validation_errors
+      each_model do |record, name|
+        record.errors.each do |key, value|
+          errors.add key, value
+        end
+      end
+    end
+  end
+
+end

data/lib/conformista/version.rb

@@ -0,0 +1,3 @@
+module Conformista
+  VERSION = '0.0.1'
+end

data/spec/conformista/form_object_spec.rb

@@ -0,0 +1,126 @@
+module Conformista
+  describe FormObject do
+    it_should_behave_like 'ActiveModel'
+
+    it { should respond_to(:save) }
+    it { should have(0).presented_models }
+
+    context 'when presenting a single model' do
+      let(:example_form_object_class) do
+        Class.new(described_class) do
+          presents Post, :title
+          validates :title, length: { minimum: 2, allow_blank: true }
+        end
+      end
+
+      before do
+        stub_const('Example', example_form_object_class)
+      end
+
+      subject { example_form_object_class.new }
+
+      it { should have(1).presented_models }
+      its(:presented_models) { should include(Post) }
+      its(:post) { should be_instance_of(Post) }
+      it { should_not be_persisted }
+
+      it 'is persisted after saving' do
+        subject.title = 'foo'
+        subject.save
+        expect(subject).to be_persisted
+      end
+
+      it 'can be created using an existing record' do
+        post = Post.new
+        example = example_form_object_class.new(post: post)
+        expect(example.post).to be(post)
+      end
+
+      it 'can customize the build strategy' do
+        example = example_form_object_class.new
+        def example.build_post; 'foo'; end
+        expect(example.post).to eql('foo')
+      end
+
+      it 'delegates listed attributes to the model before validating' do
+        subject.title = 'foo'
+        subject.valid?
+        expect(subject.post.title).to eql('foo')
+      end
+
+      it 'reads attributes from models when initializing' do
+        post = Post.new
+        post.title = 'foo'
+        example = example_form_object_class.new(post: post)
+        expect(example.title).to eql('foo')
+      end
+
+      it 'validates the model when validating the form object' do
+        expect(subject.post).to receive(:valid?)
+        subject.valid?
+      end
+
+      it 'copies validation errors to the form object' do
+        subject.valid?
+        expect(subject).to have(1).errors
+      end
+
+      it 'saves the post when valid' do
+        subject.title = 'foo'
+        expect(subject).to be_valid
+        expect { subject.save }.to change { Post.count }.by(1)
+      end
+
+      it 'does not save the post when invalid' do
+        expect(subject.post).not_to receive(:save)
+        expect { subject.save }.not_to change { Post.count }
+      end
+
+      it 'sets and saves attributes with update_attributes' do
+        subject.title = 'foo'
+        subject.save
+        expect {
+          subject.update_attributes title: 'bla'
+        }.to change { subject.post.title }.from('foo').to('bla')
+      end
+
+      it 'uses own validations to generate errors' do
+        subject.title = 'x'
+        expect(subject).not_to be_valid
+        expect(subject.errors[:title]).to include('is too short (minimum is 2 characters)')
+      end
+    end
+
+    context 'when presenting two models' do
+      let(:example_form_object_class) do
+        Class.new(described_class) do
+          presents Post, :title
+          presents Comment, :body
+        end
+      end
+
+      before { stub_const('Example', example_form_object_class) }
+      subject { example_form_object_class.new }
+      it { should have(2).presented_models }
+      its(:presented_models) { should include(Comment) }
+      its(:comment) { should be_instance_of(Comment) }
+      it { should_not be_persisted }
+
+      it 'is persisted after saving' do
+        subject.title = 'foo'
+        subject.body = 'bar'
+        subject.save
+        expect(subject).to be_persisted
+      end
+
+      it 'does not save one model when the other fails' do
+        subject.title = 'foo'
+        subject.body = 'bar'
+        expect(subject.post).to receive(:save).and_return(false)
+        expect {
+          subject.save
+        }.not_to change { Comment.count }
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,3 @@
+require 'conformista'
+
+Dir[File.expand_path('../support/**/*', __FILE__)].each { |f| require f }

data/spec/support/active_model_examples.rb

@@ -0,0 +1,44 @@
+shared_examples_for 'ActiveModel' do
+  it '#to_key' do
+    expect(model).to respond_to(:to_key)
+    def model.persisted?() false end
+    expect(model.to_key).to be_nil
+  end
+
+  it '#to_param' do
+    expect(model).to respond_to(:to_param)
+    def model.to_key() [1] end
+    def model.persisted?() false end
+    expect(model.to_param).to be_nil
+  end
+
+  it '#to_partial_path' do
+    expect(model).to respond_to(:to_partial_path)
+    expect(model.to_partial_path).to be_kind_of(String)
+  end
+
+  it '#persisted?' do
+    expect(model).to respond_to(:persisted?)
+    expect { model.persisted? == true || model.persisted? == false }
+  end
+
+  it 'model naming' do
+    expect(model.class).to respond_to(:model_name)
+    model_name = model.class.model_name
+    expect(model_name).to respond_to(:to_str)
+    expect(model_name.human).to respond_to(:to_str)
+    expect(model_name.singular).to respond_to(:to_str)
+    expect(model_name.plural).to respond_to(:to_str)
+  end
+
+  it 'errors aref' do
+    expect(model).to respond_to(:errors)
+    expect(model.errors[:hello]).to be_a(Array)
+  end
+
+  private
+
+  def model
+    subject
+  end
+end

data/spec/support/post.rb

@@ -0,0 +1,22 @@
+require 'active_record'
+
+ActiveRecord::Base.establish_connection adapter: "sqlite3", database: ":memory:"
+ActiveRecord::Migration.verbose = false
+
+ActiveRecord::Migration.create_table :posts do |t|
+  t.string :title
+  t.timestamps
+end
+
+ActiveRecord::Migration.create_table :comments do |t|
+  t.text :body
+  t.timestamps
+end
+
+class Post < ActiveRecord::Base
+  validates :title, presence: true
+end
+
+class Comment < ActiveRecord::Base
+  validates :body, presence: true
+end

metadata

@@ -0,0 +1,173 @@
+--- !ruby/object:Gem::Specification
+name: conformista
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Arjan van der Gaag
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: kramdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A library for creating form objects for Rails applications.
+email: arjan@arjanvandergaag.nl
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE
+- README.md
+- HISTORY.md
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- .yardopts
+- Gemfile
+- Gemfile.lock
+- HISTORY.md
+- LICENSE
+- README.md
+- Rakefile
+- conformista.gemspec
+- lib/conformista.rb
+- lib/conformista/form_object.rb
+- lib/conformista/presenting.rb
+- lib/conformista/transactions.rb
+- lib/conformista/validations.rb
+- lib/conformista/version.rb
+- spec/conformista/form_object_spec.rb
+- spec/spec_helper.rb
+- spec/support/active_model_examples.rb
+- spec/support/post.rb
+homepage: http://avdgaag.github.com/conformista
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options:
+- --charset=UTF-8
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.1.5
+signing_key: 
+specification_version: 4
+summary: Conformista is a library to make building presenters -- and form objects
+  in particular -- easier. It provides an ActiveModel-compliant base class that your
+  own form objects can inherit from, along with standard behaviour for creating, loading,
+  validating and persisting business objects (usually ActiveRecord models).
+test_files:
+- spec/conformista/form_object_spec.rb
+- spec/spec_helper.rb
+- spec/support/active_model_examples.rb
+- spec/support/post.rb
+has_rdoc: