tedium 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 258164c5ea7bfe3aa42b680ae6d6a2443a96d9c1
-  data.tar.gz: 8e9d628b16f9645b89200f7b8ff0e6e983f82ddd
+  metadata.gz: 40026ddb3d89f0c51494434b3fe167775c509a3f
+  data.tar.gz: ca15f4b60a8ac79a3d83f6290d900f31509425c3
 SHA512:
-  metadata.gz: cd72b84371b4180094a5fdce5492729a012463d442e222c2ec8d17cbf7d73e11ccb8c20e03e7f60f9a806e3e77bdd972f243a3dc224fb86d36f4bd8241d659f0
-  data.tar.gz: 745577fab02b9c49ccf801499709a63d104e95ec4c96a747d5c1ec31dad25f78e9c4df8a902be4af21ebeb82f6e6cf5164839240501c06b961639feba19d2776
+  metadata.gz: 909797fff65e5be7cbb1661a81e0891a33d2a49bb0e3d048d31c0ddd30cfd369314c5350d505b67882ed4bd7a5c9e6c0c5f990af01970cff4b15772fed187e8d
+  data.tar.gz: 84b1b77f8bbcfd590f353c39cf4536eb4991431eb0cbd1d8816be797c3b63a5158cc7849f4b2585e4dffc760b4f17c2c85e9cc4100f5b43a120fdf7a296399a8

data/CHANGELOG.md

@@ -0,0 +1,10 @@
+# v0.0.2
+
+* add `datetime_field` DSL method to manage Rails `datetime_select` HTML
+* `:option_with_value_or_label` selector converts to string the passed value
+* `#has_record?` redefinition using `.element` SitePrism DSL (which gives us all the other helpers)
+
+# v0.0.1
+
+* First release!
+

data/CONTRIBUTING.md

@@ -0,0 +1,40 @@
+# Contributing
+
+We love pull requests. Here's a quick guide:
+
+1. Fork the repo.
+2. Run the tests. We only take pull requests with passing tests, and it's great
+   to know that you have a clean slate: `bundle && rake`
+3. Add a test for your change. Only refactoring and documentation changes
+   require no new tests. If you are adding functionality or fixing a bug, we need
+   a test!
+4. Make the test pass.
+5. Make sure your changes adhere to the [thoughtbot Style
+   Guide](https://github.com/thoughtbot/guides/tree/master/style)
+6. Push to your fork and submit a pull request.
+7. At this point you're waiting on us. We like to at least comment on, if not
+   accept, pull requests within three business days (and, typically, one business
+   day). [We may suggest some changes or improvements or
+   alternatives](https://github.com/thoughtbot/guides/tree/master/code-review).
+
+## Increase your chances of getting merged
+
+Some things that will increase the chance that your pull request is accepted,
+taken straight from the Ruby on Rails guide:
+
+* Use Rails idioms and helpers
+* Include tests that fail without your code, and pass with it
+* Update the documentation: that surrounding your change, examples elsewhere,
+  guides, and whatever else is affected by your contribution
+* Syntax:
+    * Two spaces, no tabs.
+    * No trailing whitespace. Blank lines should not have any space.
+    * Make sure your [source files end with newline
+      characters](http://stackoverflow.com/questions/729692/why-should-files-end-with-a-newline#answer-729725).
+    * Prefer `&&`/`||`  over `and`/`or`.
+    * `MyClass.my_method(my_arg)` not `my_method( my_arg )` or
+      `my_method my_arg`.
+    * `a = b` and not `a=b`.
+    * Follow the conventions you see used in the source already.
+* And in case we didn't emphasize it enough: *We love tests!*
+

data/Gemfile

@@ -1,4 +1,6 @@
 source 'https://rubygems.org'
 
-# Specify your gem's dependencies in tedium.gemspec
 gemspec
+
+gem 'coveralls', require: false
+

data/README.md

@@ -1,8 +1,9 @@
 # Tedium
 
 [![Build Status](https://travis-ci.org/cantierecreativo/tedium.png?branch=master)](https://travis-ci.org/cantierecreativo/tedium)
+[![Coverage Status](https://coveralls.io/repos/cantierecreativo/tedium/badge.png)](https://coveralls.io/r/cantierecreativo/tedium)
 
-Remove the tedium of formulaic form filling with SitePrism and Capybara. Tedium allows you to specify a set of fields and actions to be performed rather than procedurally calling Capybara’s DSL methods on SitePrism elements.
+Remove the tedium of formulaic form filling with [SitePrism](https://github.com/natritmeyer/site_prism) and [Capybara](https://github.com/jnicklas/capybara). Tedium allows you to specify a set of fields and actions to be performed rather than procedurally calling Capybara’s DSL methods on SitePrism elements.
 
 ## Usage
 
@@ -58,6 +59,16 @@ Declares the presence of a `date_select` set of selects within the page. Once a
 
 You can access to the specific year select element with `date_of_birth_field.year_element` method (the same applies also for month and day selects).
 
+### datetime_field
+
+```ruby
+datetime_field(name, attribute_name = name)
+```
+
+Similar to `date_field`, it declares the presence of a `datetime_select` set of selects within the page.
+
+You can access to the specific hour and minute select elements with `.hour_element` and `.minute_element` method.
+
 ### submit_button
 
 ```ruby
@@ -105,10 +116,23 @@ end
 action(name, role = name)
 ```
 
-Declares the presence of an action button/link within the page. Once a `:sign_out` action is declared, the page object will define a `#sign_out_element` method, which will return the corresponding Capybara node and a `#sign_out!` method, which will click on the element.
+Declares the presence of an action button/link within the page. Once a `:sign_out` action is declared, the page object will define a `#sign_out_element` method, which will return the corresponding Capybara node and a `#sign_out!` method, which will perform a click on the element.
 
 The selector relies on a `role` attribute present in the action element (see `submit_button` for details). If the role attribute differs from the name you want to give to the page object action, provide it as a second argument.
 
+```html
+<a href="/session" data-method="delete" role="sign-out">Sign out</a>
+```
+```ruby
+class DashboardPage < SitePrism::Page
+  action :sign_out
+end
+
+page = DashboardPage.load
+page.sign_out_element # => <Capybara::Node::Element ...>
+page.sign_out! # clicks on the link
+```
+
 ### actions
 
 ```ruby
@@ -117,9 +141,9 @@ actions(*names)
 
 If you need to declare multiple actions at once, you can use this batch method.
 
-### Changes to the Capybara node element #set method
+## Changes to the Capybara node element #set method
 
-In order to fill in text inputs, selects and checkboxes using the same API, Tedium extends the default `Capybara::Node::Element#set` behaviour, so that it will select the first option matching either the its value or its text:
+In order to be able to fill in text inputs, selects and checkboxes using the same API, Tedium slightly extends the default `Capybara::Node::Element#set` behaviour. If the element is a select, the first option with a value or text that matches the provided value will be selected:
 
 ```html
 <select>
@@ -134,9 +158,9 @@ page.find_first('select').set('Option 2')
 page.find_first('select').set('2')
 ```
 
-### has_record?
+## has_record?
 
-Every SitePrism page inherits the `has_record?(record)` method, useful in conjunction with the [Rails `div_for` helper](http://devdocs.io/rails/actionview/helpers/recordtaghelper#method-i-div_for):
+Every SitePrism page inherits the `has_record?(record)` method, useful in conjunction with the [Rails `div_for` helper](http://devdocs.io/rails/actionview/helpers/recordtaghelper#method-i-div_for) or [Showcase Record trait](https://github.com/stefanoverna/showcase#showcasetraitsrecord):
 
 ```erb
 <%= div_for(@person, class: "foo") do %>
@@ -145,6 +169,6 @@ Every SitePrism page inherits the `has_record?(record)` method, useful in conjun
 ```
 
 ```ruby
-expect(page).to have_record(@person) # this PASSes
+expect(page).to have_record(@person) # green!
 ```
 

data/lib/tedium/capybara/selectors.rb

@@ -66,6 +66,7 @@ Capybara.add_selector :option_with_value_or_label do
   label 'option with value or label'
 
   xpath do |value|
+    value = value.to_s
     XPath.descendant(:option)[XPath.text.equals(value) | XPath.attr(:value).equals(value)]
   end
 end

data/lib/tedium/site_prism/form_dsl.rb

@@ -1,4 +1,5 @@
 require "tedium/virtual_date_element"
+require "tedium/virtual_datetime_element"
 
 module Tedium
   module SitePrism
@@ -17,6 +18,12 @@ module Tedium
         end
       end
 
+      def datetime_field(name, attribute_name = name)
+        define_method "#{name}_field" do
+          VirtualDateTimeElement.new(root_element_or_page, attribute_name)
+        end
+      end
+
       def submit_button(role = nil)
         element :submit_button, :submit_button, role
 

data/lib/tedium/site_prism/has_record.rb

@@ -1,8 +1,8 @@
 module Tedium
   module SitePrism
     module HasRecord
-      def has_record?(record)
-        element_exists?(:record, record)
+      def self.included(base)
+        base.element :record, :record
       end
     end
   end

data/lib/tedium/version.rb

@@ -1,3 +1,4 @@
 module Tedium
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end
+

data/lib/tedium/virtual_datetime_element.rb

@@ -0,0 +1,16 @@
+class VirtualDateTimeElement < VirtualDateElement
+  def set(datetime)
+    super datetime
+    hour_element.set(datetime.hour.to_s.rjust(2, '0'))
+    minute_element.set(datetime.min.to_s.rjust(2, '0'))
+  end
+
+  def hour_element
+    token_element('4i')
+  end
+
+  def minute_element
+    token_element('5i')
+  end
+end
+

data/spec/features/fill_in_datetimes_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe 'Given a SitePrism page object with a datetime field' do
+  let(:page_object) { page_object_klass.new }
+
+  let(:page_object_klass) do
+    Class.new(SitePrism::Page) do
+      datetime_field :start_at
+    end
+  end
+
+  before do
+    visit 'datetime'
+  end
+
+  it 'fills up all the tokens' do
+    page_object.start_at_field.set Time.new(2014, 05, 22, 9, 30)
+
+    expect(page_object.start_at_field.year_element.value).to eq '2014'
+    expect(page_object.start_at_field.month_element.value).to eq '5'
+    expect(page_object.start_at_field.day_element.value).to eq '22'
+    expect(page_object.start_at_field.hour_element.value).to eq '09'
+    expect(page_object.start_at_field.minute_element.value).to eq '30'
+  end
+end
+

data/spec/fixtures/datetime.html

@@ -0,0 +1,144 @@
+<select name="event[start_at(1i)]">
+  <option value="2020">2020</option>
+  <option value="2019">2019</option>
+  <option value="2018">2018</option>
+  <option value="2017">2017</option>
+  <option value="2016">2016</option>
+  <option value="2015">2015</option>
+  <option value="2014">2014</option>
+</select>
+<select name="event[start_at(2i)]">
+  <option value="1">January</option>
+  <option value="2">February</option>
+  <option value="3">March</option>
+  <option value="4">April</option>
+  <option value="5">May</option>
+  <option value="6">June</option>
+  <option value="7">July</option>
+  <option value="8">August</option>
+  <option value="9">September</option>
+  <option value="10">October</option>
+  <option value="11">November</option>
+  <option value="12">December</option>
+</select>
+<select name="event[start_at(3i)]">
+  <option value="1">1</option>
+  <option value="2">2</option>
+  <option value="3">3</option>
+  <option value="4">4</option>
+  <option value="5">5</option>
+  <option value="6">6</option>
+  <option value="7">7</option>
+  <option value="8">8</option>
+  <option value="9">9</option>
+  <option value="10">10</option>
+  <option value="11">11</option>
+  <option value="12">12</option>
+  <option value="13">13</option>
+  <option value="14">14</option>
+  <option value="15">15</option>
+  <option value="16">16</option>
+  <option value="17">17</option>
+  <option value="18">18</option>
+  <option value="19">19</option>
+  <option value="20">20</option>
+  <option value="21">21</option>
+  <option value="22">22</option>
+  <option value="23">23</option>
+  <option value="24">24</option>
+  <option value="25">25</option>
+  <option value="26">26</option>
+  <option value="27">27</option>
+  <option value="28">28</option>
+  <option value="29">29</option>
+  <option value="30">30</option>
+  <option value="31">31</option>
+</select>
+<select name="event[start_at(4i)]">
+  <option value="00">00</option>
+  <option value="01">01</option>
+  <option value="02">02</option>
+  <option value="03">03</option>
+  <option value="04">04</option>
+  <option value="05">05</option>
+  <option value="06">06</option>
+  <option value="07">07</option>
+  <option value="08">08</option>
+  <option value="09">09</option>
+  <option value="10">10</option>
+  <option value="11">11</option>
+  <option value="12">12</option>
+  <option value="13">13</option>
+  <option value="14">14</option>
+  <option value="15">15</option>
+  <option value="16">16</option>
+  <option value="17">17</option>
+  <option value="18">18</option>
+  <option value="19">19</option>
+  <option value="20">20</option>
+  <option value="21">21</option>
+  <option value="22">22</option>
+  <option value="23">23</option>
+</select>
+<select name="event[start_at(5i)]">
+  <option value="00">00</option>
+  <option value="01">01</option>
+  <option value="02">02</option>
+  <option value="03">03</option>
+  <option value="04">04</option>
+  <option value="05">05</option>
+  <option value="06">06</option>
+  <option value="07">07</option>
+  <option value="08">08</option>
+  <option value="09">09</option>
+  <option value="10">10</option>
+  <option value="11">11</option>
+  <option value="12">12</option>
+  <option value="13">13</option>
+  <option value="14">14</option>
+  <option value="15">15</option>
+  <option value="16">16</option>
+  <option value="17">17</option>
+  <option value="18">18</option>
+  <option value="19">19</option>
+  <option value="20">20</option>
+  <option value="21">21</option>
+  <option value="22">22</option>
+  <option value="23">23</option>
+  <option value="24">24</option>
+  <option value="25">25</option>
+  <option value="26">26</option>
+  <option value="27">27</option>
+  <option value="28">28</option>
+  <option value="29">29</option>
+  <option value="30">30</option>
+  <option value="31">31</option>
+  <option value="32">32</option>
+  <option value="33">33</option>
+  <option value="34">34</option>
+  <option value="35">35</option>
+  <option value="36">36</option>
+  <option value="37">37</option>
+  <option value="38">38</option>
+  <option value="39">39</option>
+  <option value="40">40</option>
+  <option value="41">41</option>
+  <option value="42">42</option>
+  <option value="43">43</option>
+  <option value="44">44</option>
+  <option value="45">45</option>
+  <option value="46">46</option>
+  <option value="47">47</option>
+  <option value="48">48</option>
+  <option value="49">49</option>
+  <option value="50">50</option>
+  <option value="51">51</option>
+  <option value="52">52</option>
+  <option value="53">53</option>
+  <option value="54">54</option>
+  <option value="55">55</option>
+  <option value="56">56</option>
+  <option value="57">57</option>
+  <option value="58">58</option>
+  <option value="59">59</option>
+</select>

data/spec/spec_helper.rb

@@ -1,3 +1,6 @@
+require 'coveralls'
+Coveralls.wear!
+
 require 'capybara/dsl'
 require 'tedium'
 require 'pry'

data/tedium.gemspec

@@ -23,7 +23,7 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
-  spec.add_dependency 'site_prism'
+  spec.add_dependency 'site_prism', '>= 2.6'
   spec.add_dependency 'activesupport'
 
   spec.add_development_dependency "bundler", "~> 1.3"
@@ -32,6 +32,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "pry"
   spec.add_development_dependency "actionpack"
   spec.add_development_dependency "activemodel"
-  spec.add_development_dependency "launchy"
 end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tedium
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Stefano Verna
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-03-02 00:00:00.000000000 Z
+date: 2014-03-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: site_prism
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.6'
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
@@ -122,20 +122,6 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: launchy
-  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: "Removes the tedium of form filling with SitePrism by allowing you\n
   \   to specify a set of fields, actions and submissions rather than \n    procedurally
   calling Capybara’s DSL methods.\n"
@@ -147,6 +133,8 @@ extra_rdoc_files: []
 files:
 - .gitignore
 - .travis.yml
+- CHANGELOG.md
+- CONTRIBUTING.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -160,8 +148,10 @@ files:
 - lib/tedium/site_prism/root_element_or_page.rb
 - lib/tedium/version.rb
 - lib/tedium/virtual_date_element.rb
+- lib/tedium/virtual_datetime_element.rb
 - spec/features/fill_in_checkboxes_spec.rb
 - spec/features/fill_in_dates_spec.rb
+- spec/features/fill_in_datetimes_spec.rb
 - spec/features/fill_in_form_spec.rb
 - spec/features/have_record_spec.rb
 - spec/features/perform_actions_spec.rb
@@ -169,6 +159,7 @@ files:
 - spec/fixtures/action.html
 - spec/fixtures/checkbox.html
 - spec/fixtures/date.html
+- spec/fixtures/datetime.html
 - spec/fixtures/followed.html
 - spec/fixtures/form.html
 - spec/fixtures/record.html
@@ -202,6 +193,7 @@ summary: Simplify form filling with SitePrism
 test_files:
 - spec/features/fill_in_checkboxes_spec.rb
 - spec/features/fill_in_dates_spec.rb
+- spec/features/fill_in_datetimes_spec.rb
 - spec/features/fill_in_form_spec.rb
 - spec/features/have_record_spec.rb
 - spec/features/perform_actions_spec.rb
@@ -209,6 +201,7 @@ test_files:
 - spec/fixtures/action.html
 - spec/fixtures/checkbox.html
 - spec/fixtures/date.html
+- spec/fixtures/datetime.html
 - spec/fixtures/followed.html
 - spec/fixtures/form.html
 - spec/fixtures/record.html