domino 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f53dbf7a0e24f6b9fe707570a47a60a4a6dcdfaa
-  data.tar.gz: 783a69aedf7543b0e78c0e64c431ce4165252709
+  metadata.gz: 3059a81fc3233b83f748c35d895915d477778062
+  data.tar.gz: 5ba1c3b35b0b12919712ad789dd3a50d8b4d2fea
 SHA512:
-  metadata.gz: 764cc8f1e20079d75ae4c66ec4266884431498a6ddc853926c3d74df5a836b8d11f45085c847880d716d19ef5ee5ef0cda315b19678b4fa633514d82a8847973
-  data.tar.gz: 61f0c02649ac0a6f6f19937345ee995751f9eca029baecc6c5febc2a66a4a4b095edeccf1279dd4e075de7461cfcd82b01fe5c4c8f18f8d28a7bbaa2891ad407
+  metadata.gz: 629bc9d4a700d9161ba1cc46953556fb42ad6d447a5d90ee64a5d410eb416a6095ef57c9a5bf94dd96ba664d335a4e095ee4e245fec6c69298aa4211672d0e84
+  data.tar.gz: 9edb66f4135a320f85836e9e2c04af3f8eee8245cf8ea6c040e96da86fdf1ac30139c27c61be933bdfe63b83467b15a160ddc538a189c133207cbe1e2cfbb104

data/.travis.yml

@@ -1,8 +1,9 @@
 language: ruby
 rvm:
-  - 1.9.3
   - 2.0.0
-  - 2.1.2
+  - 2.1.3
+  - 2.2.9
+  - 2.3.6
   - 2.4.3
   - 2.5.0
   - jruby

data/README.md

@@ -74,6 +74,100 @@ Dom::Post.find_by_title('First Post').delete
 assert_nil Dom::Post.find_by_title('First Post')
 ```
 
+## Domino::Form
+
+Domino makes it easy to model your forms for testing with `Domino::Form`.
+To create a basic form, simply inherit from `Domino::Form` and define a
+selector, a key (optional), and a set of fields.
+
+```ruby
+module Dom
+  class PersonForm < Domino::Form
+    selector 'form.person'
+
+    # For forms with names like `person[age]`, no need to define the
+    # locator on each field. Define a key to automatically generate
+    # locators based on the field name.
+    key 'person'
+
+    # Define a custom selector to click to submit the form
+    submit_with "input[type='submit']" # this is the default
+
+    # locate field by label
+    field :first_name, 'First Name'
+
+    # locate field by automatically generated name (uses key, person[last_name])
+    field :last_name
+
+    # locate field by fully qualified name
+    field :biography, 'person[bio]'
+
+    # locate select field by label, acts as select
+    # callback mapper operates on selected option nodes
+    field :favorite_color, 'Favorite Color', as: :select, &:text
+
+    # automatically handles select[multiple]
+    # callback mapper operates on selected option nodes: &:value by default
+    field :allergies, as: :select
+
+    # locate by id, convert value via callback
+    field :age, 'person_age', &:to_i
+
+    # use a custom field type for unusual or composite fields
+    field :vehicles, '.input.vehicles', as: CheckBoxesField
+
+    # locate a field with a name that doesn't use the key
+    field :is_human, 'is_human', as: :boolean
+
+    # still supports attributes for non-input nodes
+    attribute :action, "&[action]"
+    attribute :submit_method, "&[method]"
+  end
+end
+```
+
+In the above example, you can define a field to get a reader and writer
+method for the field. A form will also provide a mass-assignment writer
+and a save method to submit the form.
+
+```ruby
+person = Dom::PersonForm.find!
+person.age            #=> 25
+person.vehicles       #=> ["Car", "Bike"]
+person.is_human       #=> true
+person.favorite_color #=> Blue
+
+person.age = 35
+person.age #=> 35
+
+person.set(vehicles: ["Car", "Van"], first_name: "Jessica", last_name: "Jones")
+person.attributes #=> { first_name: "Jessica", last_name: "Jones", biography: "", favorite_color: "Blue", age: 35, vehicles: ["Car", "Van"], is_human: true }
+```
+
+`Domino::Form` provides basic field types for text inputs and textareas,
+single-selects, and boolean fields. You can create custom field types
+for more complex form inputs by subclassing `Domino::Form::Field` and
+overriding the `read` and `write` methods. For example, if you have a
+collection of check boxes, this might suit your needs:
+
+```ruby
+class CheckBoxesField < Domino::Form::Field
+  def read(node)
+    node.find(locator).all('input[type=checkbox]').select(&:checked?).map(&:value)
+  end
+
+  def write(node, value)
+    value = Array(value)
+    node.find(locator).all('input[type=checkbox]').each do |box|
+      box.set(value.include?(box.value))
+    end
+  end
+end
+```
+
+Provide your custom class using the `:as` option when defining your field,
+as shown in the example above.
+
 ## Integration with capybara
 
 Domino uses capybara internally to search html for nodes and

data/Rakefile

@@ -2,7 +2,8 @@ require 'bundler/gem_tasks'
 
 desc "Run the tests"
 task :test do
-  require File.join(File.dirname(__FILE__), 'test', 'domino_test')
+  require File.join(File.dirname(__FILE__), 'test', 'test_helper.rb')
+  Dir[File.join(File.dirname(__FILE__), "test", "**", "*.rb")].each { |f| require f }
 end
 
 task :default => :test

data/domino.gemspec

@@ -1,7 +1,7 @@
 # -*- encoding: utf-8 -*-
 Gem::Specification.new do |gem|
   gem.name = "domino"
-  gem.version = "0.8.0"
+  gem.version = "0.9.0"
   gem.platform = Gem::Platform::RUBY
   gem.authors = ["Nick Gauthier"]
   gem.email = ["ngauthier@gmail.com"]

data/lib/domino.rb

@@ -1,5 +1,4 @@
 require 'capybara/dsl'
-require 'set'
 # To create a basic Domino class, inherit from Domino and
 # define a selector and attributes:
 #
@@ -44,6 +43,9 @@ class Domino
   include Capybara::DSL
   extend  Capybara::DSL
 
+  require 'domino/attribute'
+  require 'domino/form'
+
   # Namespaced Domino::Error
   class Error < StandardError; end
 
@@ -136,14 +138,13 @@ class Domino
 
       attribute_definitions[attribute] = Attribute.new(attribute, selector, &callback)
 
-      class_eval %{
-        def #{attribute}
-          self.class.attribute_definitions[:#{attribute}].value(node)
-        end
-        def self.find_by_#{attribute}(value)
-          find_by_attribute(:#{attribute}, value)
-        end
-      }
+      define_method :"#{attribute}" do
+        self.class.attribute_definitions[attribute].value(node)
+      end
+
+      define_singleton_method :"find_by_#{attribute}" do |value|
+        find_by_attribute(attribute, value)
+      end
     end
 
     private
@@ -194,55 +195,4 @@ class Domino
   def initialize(node)
     @node = node
   end
-
-  class Attribute
-    attr_reader :name, :selector, :callback
-
-    def initialize(name, selector = nil, &callback)
-      @callback = callback
-      @name = name
-      @selector = selector || %(.#{name.to_s.tr('_', '-')})
-    end
-
-    def value(node)
-      val = value_before_typecast(node)
-
-      if val && callback.is_a?(Proc)
-        callback.call(val)
-      else
-        val
-      end
-    end
-
-    # Get the text of the first dom element matching a selector
-    #
-    #   Dom::Post.all.first.attribute('.title')
-    def value_before_typecast(node)
-      if combinator?
-        node[node_attribute_key] || node.matches_css?(combinator)
-      else
-        node.find(selector).text
-      end
-    rescue Capybara::ElementNotFound
-      nil
-    end
-
-    def match_value?(node, value)
-      value === value(node)
-    end
-
-    private
-
-    def combinator?
-      selector[0] == "&".freeze
-    end
-
-    def combinator
-      @combinator ||= selector.sub(/&/, "") if combinator?
-    end
-
-    def node_attribute_key
-      @node_attribute_key ||= combinator.match(/(?<=\[).+?(?=\])/) { |m| m[0] }
-    end
-  end
 end

data/lib/domino/attribute.rb

@@ -0,0 +1,50 @@
+class Domino::Attribute
+  attr_reader :name, :selector, :callback
+
+  def initialize(name, selector = nil, &callback)
+    @callback = callback
+    @name = name
+    @selector = selector || %(.#{name.to_s.tr('_', '-')})
+  end
+
+  def value(node)
+    val = value_before_typecast(node)
+
+    if val && callback.is_a?(Proc)
+      callback.call(val)
+    else
+      val
+    end
+  end
+
+  # Get the text of the first dom element matching a selector
+  #
+  #   Dom::Post.all.first.attribute('.title')
+  def value_before_typecast(node)
+    if combinator?
+      node[node_attribute_key] || node.matches_css?(combinator)
+    else
+      node.find(selector).text
+    end
+  rescue Capybara::ElementNotFound
+    nil
+  end
+
+  def match_value?(node, value)
+    value === value(node)
+  end
+
+  private
+
+  def combinator?
+    selector[0] == '&'.freeze
+  end
+
+  def combinator
+    @combinator ||= selector.sub(/&/, '') if combinator?
+  end
+
+  def node_attribute_key
+    @node_attribute_key ||= combinator.match(/(?<=\[).+?(?=\])/) { |m| m[0] }
+  end
+end

data/lib/domino/form.rb

@@ -0,0 +1,82 @@
+class Domino::Form < Domino
+  require 'domino/form/field'
+  require 'domino/form/select_field'
+  require 'domino/form/boolean_field'
+
+  FIELD_TYPES = {
+    select: SelectField,
+    boolean: BooleanField
+  }.freeze
+
+  def self.key(k)
+    @key = k
+  end
+
+  def self.fields
+    field_definitions.keys
+  end
+
+  def self.field_definitions
+    @field_definitions ||= {}
+  end
+
+  def self.submit_with(submitter)
+    @submitter = submitter
+  end
+
+  def self.submitter
+    @submitter ||= "input[type='submit']"
+  end
+
+  def self.field(*args, &callback)
+    options = args.last.is_a?(::Hash) ? args.pop : {}
+    attribute, locator = *args
+
+    locator ||= !@key.to_s.empty? ? "#{@key}[#{attribute}]" : attribute
+
+    field_type = options.delete(:as)
+    field_class = field_type.is_a?(Class) && field_type.ancestors.include?(Field) ? field_type : FIELD_TYPES[field_type] || Field
+
+    field_definitions[attribute] = field_class.new(attribute, locator, options, &callback)
+
+    define_method :"#{attribute}" do
+      self.class.field_definitions[attribute].value(node)
+    end
+
+    define_method :"#{attribute}=" do |value|
+      self.class.field_definitions[attribute].write(node, value)
+    end
+  end
+
+  def self.create(attributes = {})
+    find!.create(attributes)
+  end
+
+  def self.update(attributes = {})
+    find!.update(attributes)
+  end
+
+  def create(attributes = {})
+    set(attributes)
+    save
+  end
+
+  def update(attributes = {})
+    set(attributes)
+    save
+  end
+
+  def set(attributes = {})
+    attributes.each { |k, v| send("#{k}=", v) }
+  end
+
+  def save
+    find(self.class.submitter).click
+  end
+
+  def fields
+    self.class.fields.each_with_object({}) do |field, memo|
+      memo[field] = send(field)
+    end
+  end
+end

data/lib/domino/form/boolean_field.rb

@@ -0,0 +1,13 @@
+class Domino::Form::BooleanField < Domino::Form::Field
+  def read(node)
+    node.find_field(locator, options).checked?
+  end
+
+  def write(node, value)
+    if value
+      node.check(locator, options)
+    else
+      node.uncheck(locator, options)
+    end
+  end
+end

data/lib/domino/form/field.rb

@@ -0,0 +1,44 @@
+class Domino::Form::Field
+  attr_reader :name, :locator, :options, :callback
+
+  def initialize(name, locator, options = {}, &callback)
+    @name = name
+    @locator = locator
+    @options = options
+    @callback = callback
+    extract_field_options
+  end
+
+  # Delete any options for your field type that shouldn't be passed to
+  # the field locator.
+  # Default: noop
+  def extract_field_options
+  end
+
+  # Convert the value from `#read` via callback if provided.
+  def value(node)
+    val = read(node)
+    if val && callback.is_a?(Proc)
+      callback.call(val)
+    else
+      val
+    end
+  end
+
+  # Locate the field using the locator and options
+  def field(node)
+    node.find_field(locator, options)
+  end
+
+  # Value that will be passed to the callback.
+  # Default: field_node.value
+  def read(node)
+    field(node).value
+  end
+
+  # Sets the value on the field node.
+  # Default: node.fill_in for text fields.
+  def write(node, value)
+    node.fill_in(locator, with: value, **options)
+  end
+end

data/lib/domino/form/select_field.rb

@@ -0,0 +1,37 @@
+class Domino::Form::SelectField < Domino::Form::Field
+  # Returns the set of selected options that can be processed in the callback.
+  def read(node)
+    s = field(node)
+    selected = s.all("option[selected]")
+    s.multiple? ? selected : selected.first
+  end
+
+  def write(node, value)
+    s = field(node)
+    values = Array(value)
+
+    s.all('option').each do |o|
+      if values.include?(o.text) || values.include?(o.value)
+        o.select_option
+      elsif s.multiple?
+        o.unselect_option
+      end
+    end
+  end
+
+  def value(node)
+    val = read(node)
+    return val unless callback
+    if field(node).multiple?
+      val.map { |opt| callback.call(opt) }
+    else
+      callback.call(val)
+    end
+  end
+
+  # Any callback mapping on a select will recieve one or more option nodes.
+  # Applying to one item or an Enumerable.
+  def callback
+    @callback ||= :value.to_proc
+  end
+end

data/test/domino_form_test.rb

@@ -0,0 +1,206 @@
+class DominoFormTest < Minitest::Test
+  include Capybara::DSL
+
+  module Dom
+    class CheckBoxesField < Domino::Form::Field
+      def read(node)
+        node.find(locator).all('input[type=checkbox]').select(&:checked?).map(&:value)
+      end
+
+      def write(node, value)
+        value = Array(value)
+        node.find(locator).all('input[type=checkbox]').each do |box|
+          box.set(value.include?(box.value))
+        end
+      end
+    end
+
+    class PersonForm < Domino::Form
+      selector 'form.person'
+      key 'person'
+
+      field :name, 'First Name'
+      field :last_name
+      field :biography, 'person[bio]'
+      field :favorite_color, 'Favorite Color', as: :select, &:text
+      field :age, 'person_age', &:to_i
+      field :vehicles, '.input.vehicles', as: CheckBoxesField
+      field :is_human, 'is_human', as: :boolean
+
+      attribute :action, '&[action]'
+      attribute :submit_method, '&[method]'
+    end
+
+    class PersonFormB < Domino::Form
+      selector 'form.person'
+
+      field :is_human, as: :boolean
+      field :allergies, as: :select
+    end
+  end
+
+  def setup
+    visit '/people/23/edit'
+  end
+
+  def test_form_field_with_label_locator
+    assert_equal 'Alice', Dom::PersonForm.find!.name
+  end
+
+  def test_form_field_with_default_locator_and_form_key
+    assert_equal 'Cooper', Dom::PersonForm.find!.last_name
+  end
+
+  def test_form_field_with_name_locator
+    assert_equal 'Alice is fun', Dom::PersonForm.find!.biography
+  end
+
+  def test_form_field_as_select_field_type
+    assert_equal 'Blue', Dom::PersonForm.find!.favorite_color
+  end
+
+  def test_form_field_as_multiple_select_field_type
+    formb = Dom::PersonFormB.find!
+    assert_equal [], formb.allergies
+    formb.allergies = %w[Peanut Corn]
+    assert_equal %w[peanut corn], formb.allergies
+    formb.allergies = ['corn']
+    assert_equal ['corn'], formb.allergies
+  end
+
+  def test_form_field_with_id_locator_and_callback
+    assert_equal 23, Dom::PersonForm.find!.age
+  end
+
+  def test_form_field_with_custom_field_type
+    assert_equal [], Dom::PersonForm.find!.vehicles
+  end
+
+  def test_form_field_with_boolean_field_type
+    assert_equal false, Dom::PersonForm.find!.is_human
+  end
+
+  def test_form_set_multiple_attributes
+    person = Dom::PersonForm.find!
+    person.set name: 'Marie', last_name: 'Curie', biography: 'Scientific!', favorite_color: 'Red', age: 25, vehicles: %w[Bike Car], is_human: true
+
+    assert_equal 'Marie', person.name
+    assert_equal 'Curie', person.last_name
+    assert_equal 'Scientific!', person.biography
+    assert_equal 'Red', person.favorite_color
+    assert_equal 25, person.age
+    assert_equal %w[Bike Car], person.vehicles
+    assert_equal true, person.is_human
+  end
+
+  def test_form_fields
+    person = Dom::PersonForm.find!
+    assert_equal({ name: 'Alice', last_name: 'Cooper', biography: 'Alice is fun', favorite_color: 'Blue', age: 23, vehicles: [], is_human: false }, person.fields)
+  end
+
+  def test_form_set_nil_clears_field
+    person = Dom::PersonForm.find!
+    person.name = nil
+    assert_equal '', person.name
+  end
+
+  def test_form_set_by_attribute_writer
+    person = Dom::PersonForm.find!
+    assert_equal 23, person.age
+    person.age = 66
+    assert_equal 66, person.age
+  end
+
+  def test_form_default_selector_without_key
+    formb = Dom::PersonFormB.find!
+    assert_equal false, formb.is_human
+    formb.is_human = true
+    assert_equal true, formb.is_human
+    formb.is_human = false
+    assert_equal false, formb.is_human
+  end
+
+  def test_save_submits_form
+    person = Dom::PersonForm.find!
+    refute page.has_content?('Person updated successfully.')
+
+    person.set name: 'Marie', last_name: 'Curie', biography: 'Scientific!', age: 25, favorite_color: 'Green', vehicles: %w[Bike Car], is_human: true
+
+    person.save
+
+    assert page.has_content?('Person updated successfully.')
+
+    updated_person = Dom::PersonForm.find!
+    assert_equal 'Marie', updated_person.name
+    assert_equal 'Curie', updated_person.last_name
+    assert_equal 'Scientific!', updated_person.biography
+    assert_equal 'Green', updated_person.favorite_color
+    assert_equal 25, updated_person.age
+    assert_equal %w[Bike Car], updated_person.vehicles
+    assert_equal true, updated_person.is_human
+  end
+
+  def test_update_fills_and_submits_form
+    person = Dom::PersonForm.find!
+    refute page.has_content?('Person updated successfully.')
+
+    person.update name: 'Marie', last_name: 'Curie', biography: 'Scientific!', favorite_color: 'Green', age: 25, vehicles: %w[Bike Car], is_human: true
+
+    assert page.has_content?('Person updated successfully.')
+
+    updated_person = Dom::PersonForm.find!
+    assert_equal({ name: 'Marie', last_name: 'Curie', biography: 'Scientific!', favorite_color: 'Green', age: 25, vehicles: %w[Bike Car], is_human: true }, updated_person.fields)
+  end
+
+  def test_create_fills_and_submits_form
+    person = Dom::PersonForm.find!
+    refute page.has_content?('Person updated successfully.')
+
+    person.create name: 'Marie', last_name: 'Curie', biography: 'Scientific!', favorite_color: 'Green', age: 25, vehicles: %w[Bike Car], is_human: true
+
+    assert page.has_content?('Person updated successfully.')
+
+    updated_person = Dom::PersonForm.find!
+    assert_equal({ name: 'Marie', last_name: 'Curie', biography: 'Scientific!', favorite_color: 'Green', age: 25, vehicles: %w[Bike Car], is_human: true }, updated_person.fields)
+  end
+
+  def test_static_update_fills_and_submits_form
+    refute page.has_content?('Person updated successfully.')
+
+    Dom::PersonForm.create name: 'Marie', last_name: 'Curie', biography: 'Scientific!', favorite_color: 'Green', age: 25, vehicles: %w[Bike Car], is_human: true
+
+    assert page.has_content?('Person updated successfully.')
+
+    updated_person = Dom::PersonForm.find!
+    assert_equal({ name: 'Marie', last_name: 'Curie', biography: 'Scientific!', favorite_color: 'Green', age: 25, vehicles: %w[Bike Car], is_human: true }, updated_person.fields)
+  end
+
+  def test_static_create_fills_and_submits_form
+    refute page.has_content?('Person updated successfully.')
+
+    Dom::PersonForm.create name: 'Marie', last_name: 'Curie', biography: 'Scientific!', favorite_color: 'Green', age: 25, vehicles: %w[Bike Car], is_human: true
+
+    assert page.has_content?('Person updated successfully.')
+
+    updated_person = Dom::PersonForm.find!
+    assert_equal({ name: 'Marie', last_name: 'Curie', biography: 'Scientific!', favorite_color: 'Green', age: 25, vehicles: %w[Bike Car], is_human: true }, updated_person.fields)
+  end
+
+  def test_static_create_with_no_matches
+    visit "/"
+    assert_raises Capybara::ElementNotFound do
+      Dom::PersonForm.create name: 'Marie', last_name: 'Curie'
+    end
+  end
+
+  def test_static_update_with_no_matches
+    visit "/"
+    assert_raises Capybara::ElementNotFound do
+      Dom::PersonForm.update name: 'Marie', last_name: 'Curie'
+    end
+  end
+
+  def test_supports_normal_attributes
+    assert_equal({ action: '/people/23', submit_method: 'post' }, Dom::PersonForm.find!.attributes)
+  end
+end

data/test/domino_test.rb

@@ -1,59 +1,6 @@
-require 'bundler/setup'
-unless ENV['CI']
-  require 'simplecov'
-  SimpleCov.start
-end
-Bundler.require
-require 'minitest/autorun'
-require 'minitest/mock'
-
-class TestApplication
-  def call(_env)
-    [200, { 'Content-Type' => 'text/plain' }, [%(
-        <html>
-          <body>
-            <h1>Here are people and animals</h1>
-            <div id='people'>
-              <div class='person active' data-rank="1" data-uuid="e94bb2d3-71d2-4efb-abd4-ebc0cb58d19f">
-                <h2 class='name'>Alice</h2>
-                <p class='last-name'>Cooper</p>
-                <p class='bio'>Alice is fun</p>
-                <p class='fav-color'>Blue</p>
-                <p class='age'>23</p>
-              </div>
-              <div class='person' data-rank="3" data-uuid="05bf319e-8d6a-43c2-be37-2dad8ddbe5af">
-                <h2 class='name'>Bob</h2>
-                <p class='last-name'>Marley</p>
-                <p class='bio'>Bob is smart</p>
-                <p class='fav-color'>Red</p>
-                <p class='age'>52</p>
-              </div>
-              <div class='person' data-rank="2" data-uuid="4abcdeff-1d36-44a9-a05e-8fc57564d2c4">
-                <h2 class='name'>Charlie</h2>
-                <p class='last-name'>Murphy</p>
-                <p class='bio'>Charlie is wild</p>
-                <p class='fav-color'>Red</p>
-              </div>
-              <div class='person' data-rank="7" data-blocked data-uuid="2afccde0-5d13-41c7-ab01-7f37fb2fe3ee">
-                <h2 class='name'>Donna</h2>
-                <p class='last-name'>Summer</p>
-                <p class='bio'>Donna is quiet</p>
-              </div>
-            </div>
-            <div id='animals'></div>
-            <div id='receipts'>
-              <div class='receipt' id='receipt-72' data-store='ACME'></div>
-            </div>
-          </body>
-        </html>
-    )]]
-  end
-end
-
-Capybara.app = TestApplication.new
-
-class DominoTest < MiniTest::Unit::TestCase
+class DominoTest < Minitest::Test
   include Capybara::DSL
+
   module Dom
     class Person < Domino
       selector '#people .person'

data/test/test_application.rb

@@ -0,0 +1,142 @@
+class TestApplication
+  def call(env)
+    [200, { 'Content-Type' => 'text/plain' }, [response(env)]]
+  end
+
+  def response(env)
+    case env.fetch('PATH_INFO')
+    when '/'
+      root
+    when '/people/23/edit'
+      params = {
+        'person' => {
+          'id' => 23,
+          'name' => 'Alice',
+          'last_name' => 'Cooper',
+          'bio' => 'Alice is fun',
+          'fav_color' => 'blue',
+          'age' => 23,
+          'vehicles' => []
+        }, 'is_human' => false
+      }
+      edit params
+    when '/people/23'
+      params = Rack::Utils.parse_nested_query(env.fetch('rack.input').read)
+      edit params.merge(flash: "Person updated successfully.")
+    end
+  end
+
+  def root
+    <<-HTML
+      <html>
+        <body>
+          <h1>Here are people and animals</h1>
+          <div id='people'>
+            <div class='person active' data-rank="1" data-uuid="e94bb2d3-71d2-4efb-abd4-ebc0cb58d19f">
+              <h2 class='name'>Alice</h2>
+              <p class='last-name'>Cooper</p>
+              <p class='bio'>Alice is fun</p>
+              <p class='fav-color'>Blue</p>
+              <p class='age'>23</p>
+            </div>
+            <div class='person' data-rank="3" data-uuid="05bf319e-8d6a-43c2-be37-2dad8ddbe5af">
+              <h2 class='name'>Bob</h2>
+              <p class='last-name'>Marley</p>
+              <p class='bio'>Bob is smart</p>
+              <p class='fav-color'>Red</p>
+              <p class='age'>52</p>
+            </div>
+            <div class='person' data-rank="2" data-uuid="4abcdeff-1d36-44a9-a05e-8fc57564d2c4">
+              <h2 class='name'>Charlie</h2>
+              <p class='last-name'>Murphy</p>
+              <p class='bio'>Charlie is wild</p>
+              <p class='fav-color'>Red</p>
+            </div>
+            <div class='person' data-rank="7" data-blocked data-uuid="2afccde0-5d13-41c7-ab01-7f37fb2fe3ee">
+              <h2 class='name'>Donna</h2>
+              <p class='last-name'>Summer</p>
+              <p class='bio'>Donna is quiet</p>
+            </div>
+          </div>
+          <div id='animals'></div>
+          <div id='receipts'>
+            <div class='receipt' id='receipt-72' data-store='ACME'></div>
+          </div>
+        </body>
+      </html>
+    HTML
+  end
+
+  def edit(params = { 'person' => {} })
+    person = params['person']
+    <<-HTML
+      <html>
+        <body>
+          <div class="flash">#{params[:flash]}</div>
+          <h1>Edit Person</h1>
+
+          <form action="/people/#{person['id']}" method="post" class="person">
+            <div class="input name">
+              <label for="person_name">First Name</label>
+              <input type="text" id="person_name" name="person[name]" value="#{person['name']}" />
+            </div>
+
+            <div class="input last_name">
+              <label for="person_name">Last Name</label>
+              <input type="text" id="person_last_name" name="person[last_name]" value="#{person['last_name']}" />
+            </div>
+
+            <div class="input bio">
+              <label for="person_bio">Biography</label>
+              <textarea id="person_bio" name="person[bio]">#{person['bio']}</textarea>
+            </div>
+
+            <div class="input fav_color">
+              <label for="person_fav_color">Favorite Color</label>
+              <select id="person_fav_color" name="person[fav_color]">
+                <option value>- Select a Color -</option>
+                <option value="red" #{'selected="selected"' if person['fav_color'] == 'red'}>Red</option>
+                <option value="blue" #{'selected="selected"' if person['fav_color'] == 'blue'}>Blue</option>
+                <option value="green" #{'selected="selected"' if person['fav_color'] == 'green'}>Green</option>
+              </select>
+            </div>
+
+            <div class="input age">
+              <label for="person_age">Biography</label>
+              <input type="number" min="0" step="1" id="person_age" name="person[age]" value="#{person['age']}" />
+            </div>
+
+            <div class="input is_human">
+              <input type="hidden" name="is_human" value="0">
+              <label for="is_a_human">
+                <input id="is_a_human" type="checkbox" name="is_human" value="1" #{'checked' if params['is_human']}>
+                I'm a human
+              </label>
+            </div>
+
+            <div class="input vehicles">
+              <label for="person_vehicles_bike"><input id="person_vehicles_bike" type="checkbox" name="person[vehicles][]" value="Bike" #{'checked' if person['vehicles'].include?('Bike')}>Bike</label>
+              <label for="person_vehicles_car"><input id="person_vehicles_car" type="checkbox" name="person[vehicles][]" value="Car" #{'checked' if person['vehicles'].include?('Car')}>Car</label>
+            </div>
+
+            <div class="input allergies">
+              <label for="allergies">Allergies</label>
+              <select id="allergies" name="allergies" multiple="multiple">
+                <option value>None</option>
+                <option value="peanut" #{'selected="selected"' if Array(params['allergies']).include?('peanut')}>Peanut</option>
+                <option value="corn" #{'selected="selected"' if Array(person['allergies']).include?('corn')}>Corn</option>
+                <option value="wheat" #{'selected="selected"' if Array(person['allergies']).include?('wheat')}>Wheat</option>
+              </select>
+            </div>
+
+            <div class="actions">
+              <input type="submit" name="commit" value="Update Person" />
+            </div>
+          </form>
+        </body>
+      </html>
+    HTML
+  end
+end
+
+Capybara.app = TestApplication.new

data/test/test_helper.rb

@@ -0,0 +1,8 @@
+require 'bundler/setup'
+unless ENV['CI']
+  require 'simplecov'
+  SimpleCov.start
+end
+Bundler.require
+require 'minitest/autorun'
+require 'minitest/mock'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: domino
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Nick Gauthier
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-02-27 00:00:00.000000000 Z
+date: 2018-03-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: capybara
@@ -83,7 +83,15 @@ files:
 - Rakefile
 - domino.gemspec
 - lib/domino.rb
+- lib/domino/attribute.rb
+- lib/domino/form.rb
+- lib/domino/form/boolean_field.rb
+- lib/domino/form/field.rb
+- lib/domino/form/select_field.rb
+- test/domino_form_test.rb
 - test/domino_test.rb
+- test/test_application.rb
+- test/test_helper.rb
 homepage: http://github.com/ngauthier/domino
 licenses:
 - MIT
@@ -109,4 +117,7 @@ signing_key:
 specification_version: 4
 summary: View abstraction for integration testing
 test_files:
+- test/domino_form_test.rb
 - test/domino_test.rb
+- test/test_application.rb
+- test/test_helper.rb