capybara-bootstrap-datepicker 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: d40b9b0a137989b412752108386516e39d4a45a7
-  data.tar.gz: 925c09c8c8d70d983041d3aa4d651d7f2bcea05c
+SHA256:
+  metadata.gz: 7b56dc999900061c939c290c810b969e24cbae98165f4b610fa06bd97db66169
+  data.tar.gz: d6c4132b27a951471ff5348884d80576906af9522252483af49099aa1a7105b2
 SHA512:
-  metadata.gz: 63d96702803570b0ae95ad0e4addb4bf6464e3b380d27e155d300e59f5420d5b1fef0b4f009d7b7edddca26df2cc424eca5470906ba5415515452123d876c2f2
-  data.tar.gz: 817eb7beee7c8d0f7250f480443cc89f3f5f0cc39d51ee8aedd20f53cb7cd9fdb06a8c82339a8b74b25ad2957f2d9bc4cad2a33afb7f2d695e94ba6eeb3a3738
+  metadata.gz: d641f532e7138871e6484c0320d28a6822d661e42deef6b253480c6852b7db08149d489600e5cc79d7feb41b74830942efca15536774cc6716917d0ac9d0c1df
+  data.tar.gz: 2e4679f207765d8a41ccb972fcb22e538b5457749d26805ce6ccff7a1f4a0d0688bbaa58a8af7c10f7aa153b2ff394af2437cbccdd43b437b8ee9aef88beb21b

data/.gitignore

@@ -15,4 +15,5 @@ capybara-*.html
 **.orig
 rerun.txt
 pickle-email-*.html
-/Gemfile.lock
+/.yardoc
+/doc

data/.ruby-version

@@ -0,0 +1 @@
+2.5.3

data/.travis.yml

@@ -1,7 +1,8 @@
 language: ruby
 rvm:
-  - "2.2.2"
-  - "2.0.0"
+  - "2.5.3"
+  - "2.4.5"
+  - "2.3.8"
 script: bundle exec rspec spec
 addons:
   code_climate:

data/Gemfile

@@ -3,4 +3,5 @@ source 'https://rubygems.org'
 # Specify your gem's dependencies in capybara-bootstrap-datepicker.gemspec
 gemspec
 
-gem 'codeclimate-test-reporter', group: :test, require: nil
+gem 'nokogiri', '>= 1.6.7.2'
+gem 'rack', '>= 1.6.11'

data/Gemfile.lock

@@ -0,0 +1,73 @@
+PATH
+  remote: .
+  specs:
+    capybara-bootstrap-datepicker (0.1.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.5.2)
+      public_suffix (>= 2.0.2, < 4.0)
+    capybara (3.11.1)
+      addressable
+      mini_mime (>= 0.1.3)
+      nokogiri (~> 1.8)
+      rack (>= 1.6.0)
+      rack-test (>= 0.6.3)
+      regexp_parser (~> 1.2)
+      xpath (~> 3.2)
+    capybara-screenshot (1.0.22)
+      capybara (>= 1.0, < 4)
+      launchy
+    cliver (0.3.2)
+    diff-lcs (1.3)
+    launchy (2.4.3)
+      addressable (~> 2.3)
+    mini_mime (1.0.1)
+    mini_portile2 (2.3.0)
+    nokogiri (1.8.5)
+      mini_portile2 (~> 2.3.0)
+    phantomjs (2.1.1.0)
+    poltergeist (1.18.1)
+      capybara (>= 2.1, < 4)
+      cliver (~> 0.3.1)
+      websocket-driver (>= 0.2.0)
+    public_suffix (3.0.3)
+    rack (2.0.6)
+    rack-test (1.1.0)
+      rack (>= 1.0, < 3)
+    regexp_parser (1.3.0)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.0)
+    websocket-driver (0.7.0)
+      websocket-extensions (>= 0.1.0)
+    websocket-extensions (0.1.3)
+    xpath (3.2.0)
+      nokogiri (~> 1.8)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  capybara (~> 3.11, >= 3.11.1)
+  capybara-bootstrap-datepicker!
+  capybara-screenshot (~> 1.0, >= 1.0.22)
+  nokogiri (>= 1.6.7.2)
+  phantomjs (~> 2.1, >= 2.1.1.0)
+  poltergeist (~> 1.18, >= 1.18.1)
+  rack (>= 1.6.11)
+  rspec (~> 3.8, >= 3.8.0)
+
+BUNDLED WITH
+   1.16.1

data/README.md

@@ -1,7 +1,5 @@
 [![Gem Version](https://badge.fury.io/rb/capybara-bootstrap-datepicker.svg)](http://badge.fury.io/rb/capybara-bootstrap-datepicker)
 [![Travis CI](https://travis-ci.org/akarzim/capybara-bootstrap-datepicker.svg?branch=master)](https://travis-ci.org/akarzim/capybara-bootstrap-datepicker.svg?branch=master)
-[![Code Climate](https://codeclimate.com/github/akarzim/capybara-bootstrap-datepicker/badges/gpa.svg)](https://codeclimate.com/github/akarzim/capybara-bootstrap-datepicker)
-[![Test Coverage](https://codeclimate.com/github/akarzim/capybara-bootstrap-datepicker/badges/coverage.svg)](https://codeclimate.com/github/akarzim/capybara-bootstrap-datepicker/coverage)
 
 # Capybara::BootstrapDatepicker
 
@@ -13,14 +11,18 @@ All this gem does is something very simple : allow you to trigger Bootstrap date
 
 Add this line to your application's Gemfile:
 
-    gem 'capybara-bootstrap-datepicker', group: :test
+```ruby
+gem 'capybara-bootstrap-datepicker', group: :test
+```
 
 Or, add it into your test group
 
-    group :test do
-        gem 'capybara-bootstrap-datepicker'
-        ...
-    end
+```ruby
+group :test do
+    gem 'capybara-bootstrap-datepicker'
+    ...
+end
+```
 
 And then execute:
 
@@ -36,13 +38,17 @@ The gem automatically hook itself into rspec helper using Rspec.configure.
 
 Just use this method inside your capybara test:
 
-    select_date(2.weeks.ago, from: "Label of the date input")
+```ruby
+select_date(2.weeks.ago, from: "Label of the date input")
+```
 
 Or even:
 
-    select_date(2.weeks.ago, from: "Date", match: :prefer_exact)
-    select_date(Date.tomorrow, from: "Label of the date input", format: "%d/%m/%Y")
-    select_date("2013-05-24", xpath: "//path_to//your_date_input", datepicker: :bootstrap)
+```ruby
+select_date(2.weeks.ago, from: "Date", match: :prefer_exact)
+select_date(Date.tomorrow, from: "Label of the date input", format: "%d/%m/%Y")
+select_date("2013-05-24", xpath: "//path_to//your_date_input", datepicker: :bootstrap)
+```
 
 Available options are:
 + **from:** the label of your date input

data/capybara-bootstrap-datepicker.gemspec

@@ -18,11 +18,11 @@ Gem::Specification.new do |gem|
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ['lib']
 
-  gem.required_ruby_version = '>= 2.0.0'
+  gem.required_ruby_version = '>= 2.3.8'
 
-  gem.add_development_dependency 'capybara', '~> 2.4', '>= 2.4.4'
-  gem.add_development_dependency 'rspec', '~> 3.1', '>= 3.1.0'
-  gem.add_development_dependency 'capybara-screenshot', '~> 1.0', '>= 1.0.9'
-  gem.add_development_dependency 'phantomjs', '~> 1.9', '>= 1.9.7.1'
-  gem.add_development_dependency 'poltergeist', '~> 1.5', '>= 1.5.1'
+  gem.add_development_dependency 'capybara', '~> 3.11', '>= 3.11.1'
+  gem.add_development_dependency 'rspec', '~> 3.8', '>= 3.8.0'
+  gem.add_development_dependency 'capybara-screenshot', '~> 1.0', '>= 1.0.22'
+  gem.add_development_dependency 'phantomjs', '~> 2.1', '>= 2.1.1.0'
+  gem.add_development_dependency 'poltergeist', '~> 1.18', '>= 1.18.1'
 end

data/lib/capybara-bootstrap-datepicker.rb

@@ -1,30 +1,43 @@
 require 'capybara-bootstrap-datepicker/version'
 
 module Capybara
+  # Adds datepicker interaction facilities to {Capybara}
   module BootstrapDatepicker
+    # Selects a date by simulating human interaction with the datepicker or filling the input field
+    # @param value [#to_date, String] any object that responds to `#to_date` or a parsable date string
+    # @param datepicker [:bootstrap, :simple] the datepicker to use (are supported: bootstrap or input field)
+    # @param format [String, nil] a valid date format used to format value
+    # @param from [String, nil] the path to input field (required if `xpath` is nil)
+    # @param xpath [String, nil] the xpath to input field (required if `from` is nil)
+    # @param args [Hash] extra args to find the input field
     def select_date(value, datepicker: :bootstrap, format: nil, from: nil, xpath: nil, **args)
       fail "Must pass a hash containing 'from' or 'xpath'" if from.nil? && xpath.nil?
 
-      value = Date.parse(value) unless value.respond_to? :to_date
-
+      value = value.respond_to?(:to_date) ? value.to_date : Date.parse(value)
       date_input = xpath ? find(:xpath, xpath, **args) : find_field(from, **args)
 
       case datepicker
       when :bootstrap
         select_bootstrap_date date_input, value
       else
-        select_simple_date date_input, value
+        select_simple_date date_input, value, format
       end
 
       first(:xpath, '//body').click
     end
 
-    def select_simple_date(date_input, value)
-      value = value.strftime format if format.present?
+    # Selects a date by filling the input field
+    # @param date_input the input field
+    # @param value [Date] the date to set
+    # @param format [String, nil] a valid date format used to format value
+    def select_simple_date(date_input, value, format = nil)
+      value = value.strftime format unless format.nil?
 
       date_input.set "#{value}\e"
     end
 
+    # Selects a date by simulating human interaction with the datepicker
+    # @param (see #select_simple_date)
     def select_bootstrap_date(date_input, value)
       date_input.click
 
@@ -41,30 +54,45 @@ module Capybara
     end
 
     private
+
+    # The Picker class interacts with the datepicker
     class Picker
+      # Initializes the picker
       def initialize
         @element = find_picker
       end
 
+      # Reveals the decade panel
       def goto_decade_panel
         current_month.click if days.visible?
         current_year.click if months.visible?
       end
 
+      # Navigates through the decade panels until the correct one
+      # @param value [Fixnum] the year of the desired date
       def navigate_through_decades(value)
         decade_start, decade_end = current_decade_minmax
         goto_prev_decade(value, decade_start) if value < decade_start
         goto_next_decade(decade_end, value) if value > decade_end
       end
 
+      # Get the year we want to click on
+      # @param value [Fixnum] the year of the desired date
+      # @return the DOM element to click on
       def find_year(value)
         years.find '.year', text: value
       end
 
+      # Get the month we want to click on
+      # @param value [Fixnum] the month of the desired date
+      # @return the DOM element to click on
       def find_month(value)
         months.find ".month:nth-child(#{value})"
       end
 
+      # Get the day we want to click on
+      # @param value [Fixnum] the day of the desired date
+      # @return the DOM element to click on
       def find_day(value)
         day_xpath = <<-eos
             .//*[contains(concat(' ', @class, ' '), ' day ')
@@ -76,63 +104,102 @@ module Capybara
       end
 
       private
+
+      # Get the datepicker
+      # @return the DOM element of the datepicker
       def find_picker
         Capybara.find(:xpath, '//body').find('.datepicker')
       end
 
+      # Get the datepicker panel
+      # @param period [:years, :months, :days] the panel's period
+      # @return the DOM element of the panel
       def find_period(period)
         @element.find(".datepicker-#{period}", visible: false)
       end
 
+      # Get the up level panel
+      # @param (see #find_period)
+      # @return the DOM element of the switch panel button
       def find_switch(period)
         send(period).find('th.datepicker-switch', visible: false)
       end
 
+      # Get the years panel
+      # @param (see #find_period)
+      # @return (see #find_period)
       def years
         find_period :years
       end
 
+      # Get the months panel
+      # @param (see #find_period)
+      # @return (see #find_period)
       def months
         find_period :months
       end
 
+      # Get the days panel
+      # @param (see #find_period)
+      # @return (see #find_period)
       def days
         find_period :days
       end
 
+      # Get the current decade panel
+      # @param (see #find_switch)
+      # @return (see #find_switch)
       def current_decade
         find_switch :years
       end
 
+      # Get the current year panel
+      # @param (see #find_switch)
+      # @return (see #find_switch)
       def current_year
         find_switch :months
       end
 
+      # Get the current month panel
+      # @param (see #find_switch)
+      # @return (see #find_switch)
       def current_month
         find_switch :days
       end
 
+      # Get the current decade period
+      # @return [Array<Fixnum, Fixnum>] the min and max years of the decade
       def current_decade_minmax
         current_decade.text.split('-').map(&:to_i)
       end
 
+      # Click and display previous decade
       def click_prev_decade
         years.find('th.prev').click
       end
 
+      # Click and display next decade
       def click_next_decade
         years.find('th.next').click
       end
 
+      # Calculates the distance in decades between min and max
+      # @return [Fixnum] the distance in decades between min and max
       def gap(min, max)
         return 0 if min >= max
-        max/10 - min/10
+        (max - min) / 10
       end
 
+      # Go backward to the wanted decade
+      # @param value [Fixnum] the year of the desired date
+      # @param decade_start [Fixnum] the first year of a decade
       def goto_prev_decade(value, decade_start)
         gap(value, decade_start).times { click_prev_decade }
       end
 
+      # Go forward to the wanted decade
+      # @param decade_end [Fixnum] the last year of a decade
+      # @param value [Fixnum] the year of the desired date
       def goto_next_decade(decade_end, value)
         gap(decade_end, value).times { click_next_decade }
       end

data/lib/capybara-bootstrap-datepicker/version.rb

@@ -1,5 +1,7 @@
+# The gem's version
 module Capybara
   module BootstrapDatepicker
-    VERSION = "0.1.1"
+    # the current version of the gem
+    VERSION = '0.1.2'
   end
 end

data/spec/features/bootstrap_datepicker_spec.rb

@@ -8,14 +8,28 @@ RSpec.describe 'Bootstrap Datepicker', type: :feature do
     expect(page).to have_content 'Bootstrap3 Datepicker'
   end
 
-  it 'fills in datepicker based on Bootstrap 3.3', js: true do
+  it 'fills in an input without using the datepicker', js: true do
+    select_date Date.today, from: 'Label of my date input'
+    expect(Date.parse find_field('Label of my date input').value).to eq Date.today
+  end
+
+  it 'fills in a standard datepicker', js: true do
+    select_date Date.today, from: 'Label of my date input', datepicker: :simple
+    expect(Date.parse find_field('Label of my date input').value).to eq Date.today
+  end
+
+  it 'fills in a datepicker based on Bootstrap 3.3', js: true do
     select_date Date.today, from: 'Label of my date input', datepicker: :bootstrap
     expect(Date.parse find_field('Label of my date input').value).to eq Date.today
   end
 
-  it 'fills in localized datepicker based on Bootstrap 3.3', js: true do
+  it 'fills in a localized datepicker based on Bootstrap 3.3', js: true do
     select_date Date.today, from: 'Label of my localized date input', datepicker: :bootstrap
     expect(Date.parse find_field('Label of my localized date input').value).to eq Date.today
   end
-end
 
+  it 'fills in an input with DateTime object', js: true do
+    select_date DateTime.now, from: 'Label of my date input'
+    expect(Date.parse find_field('Label of my date input').value).to eq Date.today
+  end
+end

data/spec/spec_helper.rb

@@ -1,7 +1,4 @@
 # See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
-require 'codeclimate-test-reporter'
-CodeClimate::TestReporter.start
-
 require 'bundler/setup'
 Bundler.setup
 
@@ -14,7 +11,7 @@ require 'phantomjs/poltergeist'
 
 Capybara.configure do |config|
   config.javascript_driver = :poltergeist
-  config.app_host = File.join(File.dirname(__FILE__), 'features')
+  config.app_host = "file://#{File.expand_path('features', __dir__)}"
 end
 
 Capybara.register_driver :poltergeist do |app|

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: capybara-bootstrap-datepicker
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - François Vantomme
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-05-19 00:00:00.000000000 Z
+date: 2018-11-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: capybara
@@ -16,40 +16,40 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.4'
+        version: '3.11'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.4.4
+        version: 3.11.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.4'
+        version: '3.11'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.4.4
+        version: 3.11.1
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '3.8'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.0
+        version: 3.8.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '3.8'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.0
+        version: 3.8.0
 - !ruby/object:Gem::Dependency
   name: capybara-screenshot
   requirement: !ruby/object:Gem::Requirement
@@ -59,7 +59,7 @@ dependencies:
         version: '1.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.9
+        version: 1.0.22
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -69,47 +69,47 @@ dependencies:
         version: '1.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.9
+        version: 1.0.22
 - !ruby/object:Gem::Dependency
   name: phantomjs
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.9'
+        version: '2.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.9.7.1
+        version: 2.1.1.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.9'
+        version: '2.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.9.7.1
+        version: 2.1.1.0
 - !ruby/object:Gem::Dependency
   name: poltergeist
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '1.18'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.5.1
+        version: 1.18.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '1.18'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.5.1
+        version: 1.18.1
 description: Helper for triggering date input for bootstrap-datepicker javascript
   library
 email:
@@ -118,11 +118,12 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".codeclimate.yml"
 - ".gitignore"
 - ".rspec"
+- ".ruby-version"
 - ".travis.yml"
 - Gemfile
+- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
@@ -146,7 +147,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.0.0
+      version: 2.3.8
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -154,7 +155,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: Bootstrap datepicker helper for Capybara

data/.codeclimate.yml

@@ -1,4 +0,0 @@
-languages:
-  Ruby: true
-  JavaScript: true
-exclude_paths: []