mundo-pepino 0.2.0 → 0.2.1

data/History.txt

@@ -1,3 +1,8 @@
+== 0.2.1 2010-4-16
+* Two minor changes:
+  * Capybara extensions automagically loaded if Capybara is present
+  * Capybara/Webrat dependency managed at run time
+
 == 0.2.0 2010-3-5
 
 * Two great features by Paco Guzman (thanks Paco!!!)

data/Manifest.txt

@@ -6,6 +6,7 @@ README_es.markdown
 init.rb
 lib/mundo_pepino.rb
 lib/mundo_pepino/base.rb
+lib/mundo_pepino/capybara/extensions.rb
 lib/mundo_pepino/config.rb
 lib/mundo_pepino/en_US.rb
 lib/mundo_pepino/en_US/definitions.rb

data/README.markdown

@@ -34,7 +34,6 @@ For other languages, before start your own implementation, it'd be nice if you:
 * **sources**: git://github.com/nando/mundo-pepino.git
 * **todo**: [github issues](http://github.com/nando/mundo-pepino/issues)
 * **list**: [google group](http://groups.google.es/group/mundo-pepino)
-* **build**: [run-code-run](http://runcoderun.com/nando/mundo-pepino)
 * **gem**: mundo-pepino
 
 ## Definitions

data/README_es.markdown

@@ -22,7 +22,6 @@ Por otro lado, cuando el idioma utilizado no es inglés es necesario evitar las
 * **fuentes**: git://github.com/nando/mundo-pepino.git
 * **cosillas**: [github issues](http://github.com/nando/mundo-pepino/issues)
 * **lista**: [google group](http://groups.google.es/group/mundo-pepino)
-* **ic**: [run-code-run](http://runcoderun.com/nando/mundo-pepino)
 * **gema**: mundo-pepino
 
 ## Toma de contacto
@@ -495,14 +494,13 @@ Como plugin (ver dependencias más abajo):
     script/plugin install git://github.com/nando/mundo-pepino.git
 
 ### Dependencias
-  Si instalamos la gema junto con ella deberían quedar instaladas todas sus dependencias.
+  Si instalamos la gema junto con ella deberían quedar instaladas todas sus dependencias excepto Capybara y/o Webrat (ver más abajo).
 
   Si instalamos mundo-pepino como plugin debemos tener instaladas las gemas o plugins de **cucumber**, **cucumber-rails**, **webrat**, **rspec** y **rspec-rails**. Por ejemplo, para instalar todas ellas como plugins:
 
     gem install term-ansicolor treetop diff-lcs nokogiri # dependencias de Cucumber
     script/plugin install git://github.com/aslakhellesoy/cucumber.git
     script/plugin install git://github.com/aslakhellesoy/cucumber-rails.git
-    script/plugin install git://github.com/brynary/webrat.git
     script/plugin install git://github.com/dchelimsky/rspec.git
     script/plugin install git://github.com/dchelimsky/rspec-rails.git
 
@@ -519,6 +517,11 @@ Como plugin (ver dependencias más abajo):
 * instalar el módulo ruby-locale,
 * o redefinir la función strftime para lograr dicho comportamiento.
 
+#### [Capybara](http://github.com/jnicklas/capybara/) o [Webrat](http://github.com/brynary/webrat/)
+Para manejar los pasos que hacen referencia a interacciones del usuario con el navegador MundoPepino depende de Capybara o Webrat. Es necesario tener instalada alguna de dichas gemas y que además el entorno de Cucumber las cargue convenientemente (tal y como hace en el `env.rb` que genera `generate cucumber`).
+
+La gema de MundoPepino no depende directamente de ninguna de dichas gemas y maneja esta dependencia en tiempo de ejecución, quejándose cuando lanzamos los tests sin que ninguna de ellas esté cargada en el entorno.
+
 #### [FixtureReplacement](http://replacefixtures.rubyforge.org/)
 
 De fábrica MundoPepino utiliza ActiveRecord para incorporar a la BBDD los datos que soliciten los escenarios. 
@@ -530,7 +533,7 @@ Para ello por un lado tenemos que instalar el plugin:
     script/plugin install http://thmadb.com/public_svn/plugins/fixture_replacement2/
     script/generate fixture_replacement
 
-...y por otro, al final de `env.rb` (que el generador de cucumber deja dentro del directorio `features/support`) tenemos que incluir FixtureReplacement como módulo de nuestro *mundo pepino* (más sobre esto en [A Whole New World](http://wiki.github.com/aslakhellesoy/cucumber/a-whole-new-world)):
+...y por otro, al final de `mundo_pepino_es_ES.rb` tenemos que incluir FixtureReplacement como módulo de nuestro *mundo pepino* (más sobre esto en [A Whole New World](http://wiki.github.com/aslakhellesoy/cucumber/a-whole-new-world)):
 
     class MiMundo < MundoPepino
       include FixtureReplacement
@@ -539,7 +542,6 @@ Para ello por un lado tenemos que instalar el plugin:
     World do
       MiMundo.new
     end 
-
 #### [FactoryGirl](http://github.com/thoughtbot/factory_girl/)
 
 Otra opción es utilizar FactoryGirl
@@ -557,7 +559,7 @@ También se debe incluir un fichero donde se definan las factories a utilizar en
 
 #### Selección de un mes en formularios
 
-  Para los pasos que hacen referencia a la selección de un mes en una fecha la implementación actual (de Webrat) busca en nuestro HTML un mes cuyo nombre sea el devuelto por **strftime('%B')** en una instancia de Time creada a partir de la fecha facilitada. En Ruby, si no hacemos nada para remediarlo, esto es sinónimo del nombre del mes de dicha fecha en inglés.
+  Para los pasos que hacen referencia a la selección de un mes en una fecha la implementación actual (de Webrat y la extensión de MP para Capybara) busca en nuestro HTML un mes cuyo nombre sea el devuelto por **strftime('%B')** en una instancia de Time creada a partir de la fecha facilitada. En Ruby, si no hacemos nada para remediarlo, esto es sinónimo del nombre del mes de dicha fecha en inglés.
 
   La opción más simple para resolver este problema es redefinir `strftime` para que devuelva el nombre del mes en el locale de la aplicación. Por ejemplo:
 

data/lib/mundo_pepino.rb

@@ -11,6 +11,14 @@ require 'mundo_pepino/config'
 
 require 'string-mapper'
 
+if defined?(Capybara)
+  require  'mundo_pepino/capybara/extensions'
+else
+  unless defined?(Webrat)
+    raise "MundoPepino depends on Capybara or Webrat. Please load any of them and try again. Thanks!"
+  end
+end
+
 World(MundoPepino)
 
 module MundoPepino

data/lib/mundo_pepino/capybara/extensions.rb

@@ -0,0 +1,130 @@
+module Capextensions
+
+  DATE_TIME_SUFFIXES = {
+          :year   => '1i',
+          :month  => '2i',
+          :day    => '3i',
+          :hour   => '4i',
+          :minute => '5i'
+  }
+
+  def click_link_within(selector, link_text)
+    within(:css, selector) do
+      click_link link_text
+    end
+  end
+
+  def select_date(date_to_select, options={})
+    date = date_to_select.is_a?(Date) || date_to_select.is_a?(Time) ?
+            date_to_select : Date.parse(date_to_select)
+
+    if options[:id_prefix].blank?
+      if options[:from].blank?
+        source = locate(:xpath, Capybara::XPath.append("//select[contains(@id, '_#{DATE_TIME_SUFFIXES[:year]}')]"))
+        id_prefix = source.node.attributes["id"].value[/(.*?)_#{DATE_TIME_SUFFIXES[:year]}$/, 1]
+      else
+        msg = "cannot select option, no select box with id, name, or label '#{options[:from]}' found"
+        begin
+          label = locate(:xpath, Capybara::XPath.append("//label[text()='#{options[:from]}']"), msg)
+          id_prefix = label.node.attributes["for"].value
+        rescue Capybara::ElementNotFound
+          begin
+            previous_exception = $!
+            label = locate(:xpath, Capybara::XPath.append("//label[text()='#{options[:from].capitalize}']"), msg)
+            id_prefix = label.node.attributes["for"].value
+          rescue
+            raise "#{previous_exception}\nand\n#{$!}"
+          end
+        end
+      end
+    end
+
+    id_prefix ||= options[:id_prefix]
+
+    select date.year, :from => "#{id_prefix}_#{DATE_TIME_SUFFIXES[:year]}"
+    select date.strftime('%B'), :from => "#{id_prefix}_#{DATE_TIME_SUFFIXES[:month]}"
+    select date.day, :from => "#{id_prefix}_#{DATE_TIME_SUFFIXES[:day]}"
+  end
+
+  def select_time(time_to_select, options ={})
+    time = time_to_select.is_a?(Time) ? time_to_select : Time.parse(time_to_select)
+
+    if options[:id_prefix].blank?
+      if options[:from].blank?
+        source = locate(:xpath, Capybara::XPath.append("//select[contains(@id, '_#{DATE_TIME_SUFFIXES[:hour]}')]"))
+        id_prefix = source.node.attributes["id"].value[/(.*?)_#{DATE_TIME_SUFFIXES[:hour]}$/, 1]
+      else
+        msg = "cannot select option, no select box with id, name, or label '#{options[:from]}' found"
+        begin
+          label = locate(:xpath, Capybara::XPath.append("//label[text()='#{options[:from]}']"), msg)
+          id_prefix = label.node.attributes["for"].value
+        rescue Capybara::ElementNotFound
+          begin
+            previous_exception = $!
+            label = locate(:xpath, Capybara::XPath.append("//label[text()='#{options[:from].capitalize}']"), msg)
+            id_prefix = label.node.attributes["for"].value
+          rescue
+            raise "#{previous_exception}\nand\n#{$!}"
+          end
+        end
+      end
+    end
+
+    id_prefix ||= options[:id_prefix]
+
+    select time.hour.to_s.rjust(2, '0'), :from => "#{id_prefix}_#{DATE_TIME_SUFFIXES[:hour]}"
+    select time.min.to_s.rjust(2, '0'), :from => "#{id_prefix}_#{DATE_TIME_SUFFIXES[:minute]}"
+  end
+
+  def select_datetime(time_to_select, options={})
+    time = time_to_select.is_a?(Time) ? time_to_select : Time.parse(time_to_select)
+
+    if options[:from]
+      msg = "cannot select option, no select box with id, name, or label '#{options[:from]}' found"
+      begin
+        label = locate(:xpath, Capybara::XPath.append("//label[text()='#{options[:from]}']"), msg)
+        id_prefix = label.node.attributes["for"].value
+      rescue Capybara::ElementNotFound
+        begin
+          previous_exception = $!
+          label = locate(:xpath, Capybara::XPath.append("//label[text()='#{options[:from].capitalize}']"), msg)
+          id_prefix = label.node.attributes["for"].value
+        rescue
+          raise "#{previous_exception}\nand\n#{$!}"
+        end
+      end
+    end
+
+    options[:id_prefix] ||= (options[:from] ? id_prefix : nil)
+
+    select_date time, options
+    select_time time, options
+  end
+
+  # Maybe this methos should be defined in the other order, capybara is the default?
+  def response(*args, &block)
+    page(*args, &block)
+  end
+
+  def have_tag(*args, &block)
+    text = args[1]
+    unless text.blank?
+      have_css(args.first, :text => text)
+    else
+      have_css(args.first)
+    end
+  end
+
+  def have_selector(path, options = {})
+    # content key to text key
+    content = options.delete(:content)
+    options[:text] = content unless content.nil?
+    have_css(path, options)
+  end
+
+  def contain(content)
+    have_text(content)
+  end
+end
+
+World(Capextensions)

data/lib/mundo_pepino/es_ES/definitions.rb

@@ -1,3 +1,4 @@
+# encoding: UTF-8
 # MundoPepino's step definitions in es_ES
 # Creación simple con nombre opcional
 Dado /^(?:que tenemos )?(#{_numero_}) (?!.+ #{_cuyo_})(.+?)(?: (?:llamad[oa]s? )?['"](.+)["'])?$/i do |numero, modelo, nombre|
@@ -274,14 +275,13 @@ Entonces /^(#{_veo_o_no_}) marcad[ao] (?:la casilla|el checkbox)? ?(.+)$/ do |sh
 end
 
 Entonces /^(#{_veo_o_no_}) (?:una|la) tabla (?:(["'].+?['"]|[^ ]+) )?con (?:el|los) (?:siguientes? )?(?:valore?s?|contenidos?):$/ do |should, table_id, valores|
-  table_id = "##{table_id.to_unquoted}" if table_id
+  table_id = "[@id = '#{table_id.to_unquoted}']" if table_id
   shouldified = shouldify(should)
-  #TODO For capybara page instead response and have_css instead have_selector
-  response.send shouldified, have_selector("table#{table_id}")
+  response.send shouldified, have_xpath("//table#{table_id}")
 
-  if have_selector("table#{table_id} tbody").matches?(response)
+  if have_xpath("//table#{table_id}/tbody").matches?(response)
     start_row = 1
-    tbody = "tbody"
+    tbody = "/tbody"
   else
     start_row = 2
     tbody = ""
@@ -289,8 +289,8 @@ Entonces /^(#{_veo_o_no_}) (?:una|la) tabla (?:(["'].+?['"]|[^ ]+) )?con (?:el|l
 
   valores.raw[1..-1].each_with_index do |row, i|
     row.each_with_index do |cell, j|
-      response.send shouldified,
-      have_selector("table#{table_id} #{tbody} tr:nth-child(#{i+start_row})>td:nth-child(#{j+1})") { |td|
+      response.send shouldified, 
+      have_xpath("//table#{table_id}#{tbody}/tr[position() = #{i+start_row} ]/td[position() = #{j+1}]") { |td|
         td.inner_text.should =~ /#{cell == '.*' ? cell : Regexp.escape((cell||"").to_translated)}/
       }
     end
@@ -303,14 +303,14 @@ Entonces /^(#{_veo_o_no_}) un formulario con (?:el|los) (?:siguientes? )?(?:camp
     elementos.raw[1..-1].each do |row|
       label, type = row[0].to_translated, row[1]
       case type
-        when "submit":
+        when "submit" then
           with_tag "input[type='submit'][value='#{label}']"
-        when "radio":
+        when "radio" then
           with_tag('div') do
             with_tag "label", label
             with_tag "input[type='radio']"
           end
-        when "select", "textarea":
+        when "select", "textarea" then
           field_labeled(label).element.name.should == type
         else
           field_labeled(label).element.attributes['type'].to_s.should == type

data/lib/mundo_pepino/es_ES/mappings.rb

@@ -1,3 +1,4 @@
+# encoding: UTF-8
 module MundoPepino
   class << self
     include Matchers::Fragments

data/lib/mundo_pepino/es_ES/matchers.rb

@@ -1,3 +1,4 @@
+# encoding: UTF-8
 module MundoPepino
   module Matchers
     module Fragments

data/lib/mundo_pepino/version.rb

@@ -2,7 +2,7 @@ module MundoPepino #:nodoc:
   class VERSION #:nodoc:
     MAJOR = 0
     MINOR = 2
-    TINY  = 0
+    TINY  = 1
     PATCH = nil # Set to nil for official release
 
     STRING = [MAJOR, MINOR, TINY, PATCH].compact.join('.')

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: mundo-pepino
 version: !ruby/object:Gem::Version 
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors: 
 - "Fernando Garc\xC3\xADa Samblas"
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-03-05 00:00:00 +01:00
+date: 2010-04-16 00:00:00 +02:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -42,16 +42,6 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: 0.3.0
     version: 
-- !ruby/object:Gem::Dependency 
-  name: webrat
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 0.7.0
-    version: 
 - !ruby/object:Gem::Dependency 
   name: rspec
   type: :runtime
@@ -121,6 +111,7 @@ files:
 - init.rb
 - lib/mundo_pepino.rb
 - lib/mundo_pepino/base.rb
+- lib/mundo_pepino/capybara/extensions.rb
 - lib/mundo_pepino/config.rb
 - lib/mundo_pepino/en_US.rb
 - lib/mundo_pepino/en_US/definitions.rb