mundo-pepino 0.1.5 → 0.1.6

data/History.txt

@@ -1,8 +1,19 @@
+== 0.1.6 2009-11-13 ("Iria's half year old!" release)
+* 1 new step definition w/ es_ES matcher:
+  * I fill field of a nested attribute
+* 1 convention changed:
+  * 'name' is the literal to map for 'the name field' of a model ('nombre' is
+    now deprecated)
+* README_es improvements:
+  * MundoPepino philosofy added,
+  * Sections swapping (to give more relevance to steps definitions than to
+    dependendies)
+
 == 0.1.5 2009-11-09
 * Fixed bug in children search if their name field it's not "name" (by Paco
   Guzman).
 * Dynamic load and refactoring of Matchers::Fragments delegation
-* X new step definitions in es_ES:
+* 5 new step definitions in es_ES:
   * I press the following sequence of links and/or buttons + fit table
   * Given I am on _page_
   * Then I should be on _page_

data/README_es.markdown

@@ -12,6 +12,15 @@ Al mismo tiempo existen expresiones que son de uso frecuente cuando describimos
 
 Por otro lado, cuando el idioma utilizado no es inglés es necesario evitar las posibles ambigüedades que genera la traducción de nuestra aplicación. Para posibilitar un lenguaje ubicuo, MundoPepino fuerza la vinculación de las distintas partes de la aplicación (modelos, atributos, acciones y rutas) con los términos con los que nos referimos a las mismas desde nuestras características/features.
 
+## Filosofía del MundoPepino
+La aproximación que MundoPepino realiza para resolver su cometido se basa en tres conceptos principalmente: 
+
+* Definir **convenciones** generales **que reduzcan el número de posibilidades** de expresar un paso.
+* Aprovechar toda la potencia de las **expresiones regulares** para que la definición de un paso capture el **mayor número de posible formas de expresarlo**.
+* Uso indiscriminado de **metaprogramación** de cara a **reducir el código necesario** para implementar sus pasos.
+
+El uso de expresiones regulares complejas dificulta notablemente la lectura y comprensión de las definiciones de los pasos. Algo similar ocurre con el uso de metaprogramación en su implementación. MundoPepino vive con ello y cree que merece la pena, pero comprende y respeta que OtrosMundos ataquen el problema con una visión completamente distinta.
+
 ## Recursos
 
 * **fuentes**: git://github.com/nando/mundo-pepino.git
@@ -31,206 +40,59 @@ Por otro lado, cuando el idioma utilizado no es inglés es necesario evitar las
     rake db:migrate
     rake caracteristicas
 
-
 En este punto deberíamos obtener dos errores, ambos debidos a que el *scaffold* genera las vistas en inglés y el generador de *caracteristica* los espera en castellano. El primero es el botón "Create" y el segundo el enlace "Destroy":
 
     $EDITOR app/views/orchards/index.html.erb # "Borrar" en lugar de "Destroy"
     $EDITOR app/views/orchards/new.html.erb # "Crear" en lugar de "Create"
     rake caracteristicas
 
-Ahora sí, los escenarios deberían ser válidos, sin errores ni definiciones pendientes. Para tener precargado el entorno utilizando Spork bastaría con añadir ''--spork'' al ''script/generate cucumber'' y meter la opción ''--drb'' dentro del profile y/o tarea de rake.
+Ahora sí, los escenarios deberían ser válidos, sin errores ni definiciones pendientes. Para tener precargado el entorno utilizando Spork bastaría con añadir ''--spork'' al ''script/generate cucumber'' y meter la opción ''--drb'' dentro del profile y/o de la tarea de rake.
 
 El generador mundo_pepino nos prepara el entorno para utilizar las definiciones de MundoPepino sin copiarnos las mismas en ''features/steps_definitions'', cargándolas directemente desde su código. Existe otro generador equivalente llamado **mundo_pepino_steps** que hace lo mismo pero copiando dichas definiciones dentro de ''features/steps_definitions''.
 
-La intención del generador de características es más didáctica que pragmática. Ofrece un ejemplo simple que podemos toquetear para probar el plugin. Por otro lado se limita a hacer exactamente lo mismo que hace `generate feature` exceptuando el hecho de que no genera un fichero de **definiciones específicas** para la nueva *caracteristica* (ya que las utilizadas están comprendidas dentro de las **definiciones genéricas** ya implementadas en MundoPepino).
-
-Dentro del código de MundoPepino, en `features/support/app` está la aplicación que el MundoPepino utiliza para probarse a si mismo. En particular la característica `features/mundo-pepino.feature` pretente ser un compendio de escenarios que muestren las posibilidades que ofrece.
-
-## Instalación
-
-Como gema:
-
-    gem install mundo-pepino
-
-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 mundo-pepino como plugin debemos tener instaladas las gemas o plugins de **cucumber**, **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/brynary/webrat.git
-    script/plugin install git://github.com/dchelimsky/rspec.git
-    script/plugin install git://github.com/dchelimsky/rspec-rails.git
-
-  Además necesitamos instalar la gema o plugin StringMapper:
-
-    gem install string-mapper
+La intención del generador de características es más didáctica que pragmática. Ofrece un ejemplo simple que podemos toquetear para probar el MundoPepino. Por otro lado se limita a hacer exactamente lo mismo que hace `generate feature` de Cucumber, exceptuando el hecho de que no genera un fichero de **definiciones específicas** para la nueva *caracteristica* (ya que las utilizadas están comprendidas dentro de las **definiciones genéricas** ya implementadas en MundoPepino).
 
-  o
+El primer paso del primer escenario generado por ''caracteristica'' en el fichero ''features/gestion_de_huertos.feature'' es la siguiente:
 
-    script/plugin install git://github.com/nando/string-mapper.git
+    Dado que visito la página de nuevo/a Huerto
 
-  Si hacemos uso de alguno de los pasos que hacen referencia a la **selección de un mes** como parte de una fecha en un formulario necesitamos que el método ''strftime'' devuelva en nombre del mes en castellano cuando se utilice ''"%B"''. Para conseguirlo, tenemos entre otras las siguientes opciones (ver más abajo):
+Para que MundoPepino sepa que cuando hablamos de //Huerto// nos estamos refiriendo al modelo //Orchard// es necesario realizar lo que llamamos un "mapeo de modelo". El generador de hecho nos lo ha metido en ''mundo_pepino_es_ES.rb'':
 
-* instalar el módulo ruby-locale,
-* o redefinir la función strftime para lograr dicho comportamiento.
-
-#### [FixtureReplacement](http://replacefixtures.rubyforge.org/)
-
-De fábrica MundoPepino utiliza ActiveRecord para incorporar a la BBDD los datos que soliciten los escenarios. 
-
-Opcionalmente MundoPepino puede utilizar FixtureReplacement haciendo dicha tarea más simple y permitiéndo que los textos se centren en los objetivos de los escenarios sin preocuparse por el modelo de datos subyacente.
-
-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)):
-
-    class MiMundo < MundoPepino
-      include FixtureReplacement
+    MundoPepino.configure do |config|
+      config.model_mappings = {
+        /^huertos?$/i => Orchard
+      }
+      config.field_mappings = { ... }
+      config.url_mappings = { ... }
     end
-    
-    World do
-      MiMundo.new
-    end 
-
-#### [FactoryGirl](http://github.com/thoughtbot/factory_girl/)
-
-Otra opción es utilizar FactoryGirl
-
-Para ello por un lado tenemos que instalar la gema (para más información sobre FactoryGirl consultar (aquí)[http://github.com/thoughtbot/factory_girl/]):
-
-    gem install thoughtbot-factory_girl --source http://gems.github.com
-
-...y por otro, al final de `env.rb` (que el generador de cucumber deja dentro del directorio ''features/support'') tenemos que requerir la librería seguida de la definición de nuestras factorias:
-
-    require 'factory_girl'
-    require File.expand_path(File.dirname(__FILE__) + '/app/db/factories')
-
-También se debe incluir un fichero donde se definan las factories a utilizar en nuestro mundo-pepino, como ejemplo consultar el fichero de factories que se encuentra en el directorio ''features/support/app/db/factories''
-
-#### 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.
-
-  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:
-
-    class Time
-      alias :strftime_nolocale :strftime
-      def strftime(format)
-        format = format.dup
-        format.gsub!(/%B/, I18n.translate('date.month_names')[self.mon])
-        self.strftime_nolocale(format)
-      end
-    end
-
-  Otra opción sería instalar **ruby-locale**. **ruby-locale** es un (viejo) módulo que añade **soporte para locales en Ruby** al que se hace referencia [desde el wiki de Rails](http://wiki.rubyonrails.org/rails/pages/HowToOutputDatesInAnotherLanguage/). Instalándolo en el sistema tendremos la posibilidad de que strftime('%B') devuelva el nombre del mes en castellano.
-
-  Para instalarlo nos bajamos [su código fuente](http://sourceforge.net/project/platformdownload.php?group_id=68254) y lo compilamos e instalamos en el sistema:
-
-    ruby extconf.rb
-    make
-    sudo make install
-    irb
-    irb> require 'locale'
-    => true
-    irb> Time.now.strftime('%B')
-    => "January"
-    irb> Locale.setlocale(Locale::LC_TIME, "es_ES.UTF-8")
-    => "es_ES"
-    irb> Time.now.strftime('%B')
-    => "enero" 
 
-Por último, para que los helpers de Rails relacionados con la selección de fechas muestren los meses en castellano es necesario hacer uso de la opción **:use\_month\_names**, pasándole en la misma un array con los nombres de los doce meses que deseamos utilizar. Por ejemplo, en algún punto de nuestra aplicación definimos el array con los meses con:
+De forma similar se pueden definir mapeos para los atributos (//field_mappings//, p.e ''/^usado$/i => :used'') y las rutas de la aplicación (//url_mappings//, p.e. ''/^la portada$/ => "/"'').
 
-    Meses = %w(enero febrero marzo abril mayo junio julio agosto septiembre octubre noviembre diciembre)
-
-Y posteriormente en las vistas llamamos al helper con algo parecido a:
-
-    <%= pepino.datetime_select :harvested_at, :use_month_names => Meses %>
-
-## Uso
-### generate mundo\_pepino
-
-    rails_root$ script/generate mundo_pepino
-          exists  features/step_definitions
-          create  features/step_definitions/mundo_pepino_es_ES.rb
-          exists  lib/tasks
-          create  lib/tasks/mundo_pepino.rake
+Del mapeo de atributos lo más destacable es la convención de que, si no se le indica lo contrario, el nombre del campo que guarda el //nombre// de cualquier modelo es **name**. Este mapeo nos permite escribir frases como ''Dado que tengo un usuario llamado "Casimiro"'' sin necesidad de hacer referencia al nombre del campo en el que debe guardarse //Casimiro//.
 
-En `mundo_pepino_es_ES.rb` tenemos lo siguiente:
+Es recomendable para evitar problemas que los valores en el mapeo de atributos sean símbolos en lugar de cadenas ya que algunas factorias (p.e. FixtureReplacement) los quieren así.
 
-    require 'mundo_pepino/es_ES'    # Cargamos las definiciones en castellano
-    MundoPepino.configure do |c|
-      c.models_to_clean = []        # Array con los modelos que serán limpiados 
-                                    # antes de lanzar cada escenario.
-      c.model_mappings = {}         # Hash con el mapeo de los modelos a partir
-                                    # de sus equivalencias en castellano.
-      c.field_mappings = {}         # Hash con el mapeo de los campos.
-    class MiMundo < MundoPepino     # Ejemplo de uso del MundoPepio con herencia. 
-      # include FixtureReplacement  # FR listo para entrar en acción. Meter aquí 
-      # def mi_funcion; ...; end    # las funciones específicas que necesitemos
-    end                             # desde nuestras definiciones.
-    Before do                       # La limpieza de modelos propiamente dicha... 
-      MundoPepino.clean_models
-    end                             # ...se realizará antes de cada escenario.
-                                    # Finalmente le pedimos a Cucumber que
-    World(MiMundo)                  # utilice una instancia de nuestro mundo como
-                                    # ámbito local de nuestros escenarios.
+Del mapeo de rutas cabe destacar que si MundoPepino detecta la presencia del **método ''path_to''** (creado actualmente por Cucumber al preparar el entorno) ignorará dicho mapeo y utilizará ''path_to'' para obtener las rutas a partir de las capturas en los textos.
 
-Por otro lado `mundo_pepino.rake` añade una tarea llamada **caracteristicas** que lanza con la opción `--language es` todos los ficheros con extensión `.feature` que tengamos dentro del directorio `caracteristicas`.
+### Primera convención y como saltársela: campo **name** para el //nombre// en todos los modelos
 
-### generate caracteristica
+Como acabamos de comentar:
+    
+    ''Dado que tengo un usuario llamado "Casimiro"''
 
-Se trata del generador equivalente a `script/generate feature` de Cucumber:
+MundoPepino, por convención, intentará guardar "Casimiro" en el campo ''name'' del modelo contra el que esté mapeado "usuario". Vamos a tirar de imaginación y continuemos asumiendo que dicho modelo es ''User''.
 
-    $ script/generate caracteristica Orchard Huerto name:string:nombre area:integer:área used:boolean:usado
-    model_cleaning  added Orchard (Orchard.destroy_all call before each scenario)
-    model_mapping   added /huertos?$/i => Orchard
-    field_mapping   added /nombres?$/i => :name
-    field_mapping   added /áreas?$/i => :area
-    field_mapping   added /usados?$/i => :used
-          create  caracteristicas/gestion_de_huertos.feature
+Si queremos saltarnos la convención y que "Casimiro" se guarde en el campo ''login'' tendremos que indicarlo con un mapeo de atributo similar al siguiente:
 
-El fichero `gestion_de_huertos.feature` tendría:
+    config.model_mappings = {
+      /^User::name$/ => :login
+    }
 
-    Característica: Gestión de Huertos
-      Para [beneficio]
-      Como [sujeto]
-      Quiero [característica/comportamiento]
-    
-      Escenario: Añadir un/a nuevo/a Huerto
-        Dado que visito la página de nuevo/a Huerto
-        Cuando relleno nombre con "nombre 0"
-             Y relleno área con "0"
-             Y relleno usado con "true"
-             Y pulso el botón "Crear"
-        Entonces debería ver el texto "nombre 0"
-               Y debería ver el texto "0"
-               Y debería ver el texto "true"
-    
-      Escenario: Borrar Huerto
-        Dado que tenemos los/las siguientes Huertos:
-          |nombre|área|usado|
-          |nombre 1|1|false|
-          |nombre 2|2|true|
-          |nombre 3|3|false|
-          |nombre 4|4|true|
-        Cuando borro el/la Huerto en la tercera posición
-        Entonces debería ver una tabla con los siguientes contenidos:
-          |nombre|área|usado|
-          |nombre 1|1|false|
-          |nombre 2|2|true|
-          |nombre 4|4|true|
+Si lo que nos interesa es cambiar la convención globalmente, es decir, que siempre se utilice otro nombre de campo para el nombre, simplemente tendriamos que quitar el modelo y los dos dos puntos del mapeo anterior. Por ejemplo, si queremos que dicho nombre de campo fuese **title** sería algo como:
 
-A diferencia de `generate feature` aquí no se crea un fichero `step_definitions.rb` con definiciones e implementaciones específicas ya que las mismas se encuentran dentro de las tratadas genéricamente dentro del MundoPepino.
+    config.model_mappings = {
+      /^name$/ => :title
+    }
 
 ### Relación con modelo utilizando un nombre que no se corresponde con el mismo
 Con un ejemplo se entiende mejor, creo. Tenemos un modelo User y un modelo Garden y este último "belongs_to :author, class_name => 'User'", de tal forma que //a_garden.author// nos devuelve un User.
@@ -255,6 +117,7 @@ Tengo que meter los siguentes mapeos en nuestro entorno:
 
 Con estos mapeos también deberían funcionar el resto de definiciones de MP en las que se haga referencia a una relación.
 
+
 ## Definiciones implementadas en MundoPepino
 
 **Cada definición** existente en MundoPepino tiene **al menos un escenario** que comprueba:
@@ -268,9 +131,9 @@ Para todos los escenarios podríamos tener una narrativa genérica que expresase
       Como usuario de Cucumber
       Quiero tener los pasos más habituales definidos, implementados y bien documentados
 
-Cada definición ha sido separada en un fichero `.feature` específico para poder enlazarlas desde este índice.
+Cada definición ha sido separada en un fichero `.feature` específico para poder enlazarlas con //markdown// desde este README. La característica `features/mundo-pepino.feature` pretente ser todo lo contrario, un compendio de escenarios que muestren las posibilidades que ofrece más alla de una definición concreta (la aplicación que MundoPepino utiliza para correr estos tests se encuentra en `features/support/app`). 
 
-Como **convención general** los nombres correspondientes a modelos y campos pueden ir sin comillas pero los valores deben ir entre comillas (simples o dobles). Por ejemplo:
+Como **convención general**, aunque MundoPepino pretende ser lo más flexible posible en general, y con las comillas en particular, los nombres correspondientes a modelos y campos pueden ir sin comillas pero los valores deben ir entre comillas (simples o dobles). Por ejemplo:
 
     Dado que tenemos un artículo que tiene como título "Título del artículo"
 
@@ -396,7 +259,10 @@ Convenciones generales:
 #### Relleno/completo un campo con un texto (*text* o *textarea*) \*
      Cuando completo 'nombre' con 'Wadus'
 [más ejemplos](/nando/mundo-pepino/tree/master/features/es_ES/cuando-relleno-el-campo.feature)
-#### Relleno/completo varios campos (*text* o *textarea*) desde una step-table \*
+#### Relleno/completo un campo (*text* o *textarea*) de un atributo anidado
+     Cuando relleno el email del usuario 'Antonio' con 'wadus@example.com'
+[más ejemplos](/nando/mundo-pepino/tree/master/features/es_ES/cuando-relleno-el-campo-de-atributo-anidado.feature)
+#### Relleno/completo varios campos (*text* o *textarea*) desde una step-table
      Cuando completo:
        | Campo    | Valor    |
        | Nombre   | Lechuga  |
@@ -525,6 +391,192 @@ Convenciones generales:
 
 (\*) Los **asteriscos** al final de la definición hacen referencia a las **definiciones oficialmente comunes** generadas en inglés por `script/generate cucumber`. Dos asteríscos (\*\*) hacen referencia a una definición presente en la feature autogenerada por `script/generate feature`.
 
+## Instalación
+
+Como gema:
+
+    gem install mundo-pepino
+
+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 mundo-pepino como plugin debemos tener instaladas las gemas o plugins de **cucumber**, **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/brynary/webrat.git
+    script/plugin install git://github.com/dchelimsky/rspec.git
+    script/plugin install git://github.com/dchelimsky/rspec-rails.git
+
+  Además necesitamos instalar la gema o plugin StringMapper:
+
+    gem install string-mapper
+
+  o
+
+    script/plugin install git://github.com/nando/string-mapper.git
+
+  Si hacemos uso de alguno de los pasos que hacen referencia a la **selección de un mes** como parte de una fecha en un formulario necesitamos que el método ''strftime'' devuelva en nombre del mes en castellano cuando se utilice ''"%B"''. Para conseguirlo, tenemos entre otras las siguientes opciones (ver más abajo):
+
+* instalar el módulo ruby-locale,
+* o redefinir la función strftime para lograr dicho comportamiento.
+
+#### [FixtureReplacement](http://replacefixtures.rubyforge.org/)
+
+De fábrica MundoPepino utiliza ActiveRecord para incorporar a la BBDD los datos que soliciten los escenarios. 
+
+Opcionalmente MundoPepino puede utilizar FixtureReplacement haciendo dicha tarea más simple y permitiéndo que los textos se centren en los objetivos de los escenarios sin preocuparse por el modelo de datos subyacente.
+
+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)):
+
+    class MiMundo < MundoPepino
+      include FixtureReplacement
+    end
+    
+    World do
+      MiMundo.new
+    end 
+
+#### [FactoryGirl](http://github.com/thoughtbot/factory_girl/)
+
+Otra opción es utilizar FactoryGirl
+
+Para ello por un lado tenemos que instalar la gema (para más información sobre FactoryGirl consultar (aquí)[http://github.com/thoughtbot/factory_girl/]):
+
+    gem install thoughtbot-factory_girl --source http://gems.github.com
+
+...y por otro, al final de `env.rb` (que el generador de cucumber deja dentro del directorio ''features/support'') tenemos que requerir la librería seguida de la definición de nuestras factorias:
+
+    require 'factory_girl'
+    require File.expand_path(File.dirname(__FILE__) + '/app/db/factories')
+
+También se debe incluir un fichero donde se definan las factories a utilizar en nuestro mundo-pepino, como ejemplo consultar el fichero de factories que se encuentra en el directorio ''features/support/app/db/factories''
+
+#### 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.
+
+  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:
+
+    class Time
+      alias :strftime_nolocale :strftime
+      def strftime(format)
+        format = format.dup
+        format.gsub!(/%B/, I18n.translate('date.month_names')[self.mon])
+        self.strftime_nolocale(format)
+      end
+    end
+
+  Otra opción sería instalar **ruby-locale**. **ruby-locale** es un (viejo) módulo que añade **soporte para locales en Ruby** al que se hace referencia [desde el wiki de Rails](http://wiki.rubyonrails.org/rails/pages/HowToOutputDatesInAnotherLanguage/). Instalándolo en el sistema tendremos la posibilidad de que strftime('%B') devuelva el nombre del mes en castellano.
+
+  Para instalarlo nos bajamos [su código fuente](http://sourceforge.net/project/platformdownload.php?group_id=68254) y lo compilamos e instalamos en el sistema:
+
+    ruby extconf.rb
+    make
+    sudo make install
+    irb
+    irb> require 'locale'
+    => true
+    irb> Time.now.strftime('%B')
+    => "January"
+    irb> Locale.setlocale(Locale::LC_TIME, "es_ES.UTF-8")
+    => "es_ES"
+    irb> Time.now.strftime('%B')
+    => "enero" 
+
+Por último, para que los helpers de Rails relacionados con la selección de fechas muestren los meses en castellano es necesario hacer uso de la opción **:use\_month\_names**, pasándole en la misma un array con los nombres de los doce meses que deseamos utilizar. Por ejemplo, en algún punto de nuestra aplicación definimos el array con los meses con:
+
+    Meses = %w(enero febrero marzo abril mayo junio julio agosto septiembre octubre noviembre diciembre)
+
+Y posteriormente en las vistas llamamos al helper con algo parecido a:
+
+    <%= pepino.datetime_select :harvested_at, :use_month_names => Meses %>
+
+## Uso
+### generate mundo\_pepino
+
+    rails_root$ script/generate mundo_pepino
+          exists  features/step_definitions
+          create  features/step_definitions/mundo_pepino_es_ES.rb
+          exists  lib/tasks
+          create  lib/tasks/mundo_pepino.rake
+
+En `mundo_pepino_es_ES.rb` tenemos lo siguiente:
+
+    require 'mundo_pepino/es_ES'    # Cargamos las definiciones en castellano
+    MundoPepino.configure do |c|
+      c.models_to_clean = []        # Array con los modelos que serán limpiados 
+                                    # antes de lanzar cada escenario.
+      c.model_mappings = {}         # Hash con el mapeo de los modelos a partir
+                                    # de sus equivalencias en castellano.
+      c.field_mappings = {}         # Hash con el mapeo de los campos.
+    class MiMundo < MundoPepino     # Ejemplo de uso del MundoPepio con herencia. 
+      # include FixtureReplacement  # FR listo para entrar en acción. Meter aquí 
+      # def mi_funcion; ...; end    # las funciones específicas que necesitemos
+    end                             # desde nuestras definiciones.
+    Before do                       # La limpieza de modelos propiamente dicha... 
+      MundoPepino.clean_models
+    end                             # ...se realizará antes de cada escenario.
+                                    # Finalmente le pedimos a Cucumber que
+    World(MiMundo)                  # utilice una instancia de nuestro mundo como
+                                    # ámbito local de nuestros escenarios.
+
+Por otro lado `mundo_pepino.rake` añade una tarea llamada **caracteristicas** que lanza con la opción `--language es` todos los ficheros con extensión `.feature` que tengamos dentro del directorio `caracteristicas`.
+
+### generate caracteristica
+
+Se trata del generador equivalente a `script/generate feature` de Cucumber:
+
+    $ script/generate caracteristica Orchard Huerto name:string:nombre area:integer:área used:boolean:usado
+    model_cleaning  added Orchard (Orchard.destroy_all call before each scenario)
+    model_mapping   added /huertos?$/i => Orchard
+    field_mapping   added /nombres?$/i => :name
+    field_mapping   added /áreas?$/i => :area
+    field_mapping   added /usados?$/i => :used
+          create  caracteristicas/gestion_de_huertos.feature
+
+El fichero `gestion_de_huertos.feature` tendría:
+
+    Característica: Gestión de Huertos
+      Para [beneficio]
+      Como [sujeto]
+      Quiero [característica/comportamiento]
+    
+      Escenario: Añadir un/a nuevo/a Huerto
+        Dado que visito la página de nuevo/a Huerto
+        Cuando relleno nombre con "nombre 0"
+             Y relleno área con "0"
+             Y relleno usado con "true"
+             Y pulso el botón "Crear"
+        Entonces debería ver el texto "nombre 0"
+               Y debería ver el texto "0"
+               Y debería ver el texto "true"
+    
+      Escenario: Borrar Huerto
+        Dado que tenemos los/las siguientes Huertos:
+          |nombre|área|usado|
+          |nombre 1|1|false|
+          |nombre 2|2|true|
+          |nombre 3|3|false|
+          |nombre 4|4|true|
+        Cuando borro el/la Huerto en la tercera posición
+        Entonces debería ver una tabla con los siguientes contenidos:
+          |nombre|área|usado|
+          |nombre 1|1|false|
+          |nombre 2|2|true|
+          |nombre 4|4|true|
+
+A diferencia de `generate feature` aquí no se crea un fichero `step_definitions.rb` con definiciones e implementaciones específicas ya que las mismas se encuentran dentro de las tratadas genéricamente dentro del MundoPepino.
+
 ## License
 
 Copyright 2008, The Cocktail Experience. Fernando García Samblas <fernando.garcia at the-cocktail.com>

data/lib/mundo_pepino/base.rb

@@ -44,7 +44,7 @@ module MundoPepino
         attribs = Hash.new
         attributes.each do |key, value|
           if child_model = (key.to_s.to_model || key.to_s.to_relation_model)
-            child = add_resource(child_model, field_for(child_model, 'nombre') => value)
+            child = add_resource(child_model, field_for(child_model) => value)
             field_name = key.to_s.to_relation_model ? key : child_model.name.underscore
             attribs["#{field_name}_id"] = child.id
           else

data/lib/mundo_pepino/en_US/mappings.rb

@@ -5,7 +5,7 @@ module MundoPepino
         /^tru(e|th)$/i  => true,
         /^false$/i       => false
       }) { |value| value }  # "true".to_real_value # => true
-      String.add_mapper(:field, {:nombre => :name})
+      String.add_mapper(:field)
     
       String.add_mapper(:number, { 
         /^an?$/i    => 1,

data/lib/mundo_pepino/es_ES/definitions.rb

@@ -149,7 +149,7 @@ Cuando /^(?:que )?#{_pulso_} (?:en )?los (?:siguientes )?(?:enlaces|botones)(?:
   end
 end
 
-Cuando /^(?:que )?(?:completo|relleno) (.+) con (?:el valor )?['"](.+)["']$/i do |campo, valor|
+Cuando /^(?:que )?(?:completo|relleno) (?!#{_localizador_de_atributo_anidado_(false)})(.+) con (?:el valor )?['"](.+)["']$/i do |campo, valor|
   find_field_and_do_with_webrat :fill_in, campo, :with => valor
 end
 
@@ -159,6 +159,11 @@ Cuando /^(?:que )?(?:completo|relleno):$/i do |tabla|
   end
 end
 
+Cuando /^(?:que )?(?:completo|relleno) #{_localizador_de_atributo_anidado_} con (?:el valor )?['"](.+)["']$/i do |campo, modelo_anidado, nombre_anidado, valor|
+  field_id = nested_field_id(campo, modelo_anidado, nombre_anidado, last_mentioned)
+  find_field_and_do_with_webrat :fill_in, field_id, :with => valor
+end
+
 Cuando /^(?:que )?elijo (?:la|el)? ?(.+) ['"](.+)["']$/i do |campo, valor|
   choose(campo_to_field(campo).to_s + '_' + valor.downcase.to_underscored)
 end

data/lib/mundo_pepino/es_ES/matchers.rb

@@ -34,6 +34,10 @@ module MundoPepino
       def _debo_estar_en_
         '(?:debo|deber[ií]a) (?:estar|encontrarme) en'
       end
+      def _localizador_de_atributo_anidado_(capture=true)
+        o,c = capture ? ['(', ')'] : ['', '']
+        "(?:(?:el|la) )?#{o}.+?#{c} (?:del|de la) #{o}.+?#{c} ['\"]#{o}[^\"']+#{c}[\"']"
+      end
     end
   end
 end

data/lib/mundo_pepino/implementations.rb

@@ -41,7 +41,7 @@ module MundoPepino
     def then_we_have_a_number_of_instances_in_our_database(raw_number, raw_model, name)
       model = raw_model.to_unquoted.to_model
       conditions = if name
-        {:conditions => [ "#{field_for(model, 'nombre')}=?", name ]}
+        {:conditions => [ "#{field_for(model)}=?", name ]}
       else
         {}
       end

data/lib/mundo_pepino/implementations_api.rb

@@ -1,3 +1,5 @@
+require 'nokogiri'
+
 module MundoPepino
   module ImplementationsApi
     def real_value_for(v)
@@ -7,7 +9,7 @@ module MundoPepino
     def names_for_simple_creation(model, number, name_or_names, options = {})
       base_hash = base_hash_for(options)
       if name_or_names
-        field = field_for(model, 'nombre')
+        field = field_for(model)
         names = name_or_names.split(/ ?, | y /)
         if names.size == number
           names.map { |name| base_hash.dup.merge(field => name) }
@@ -19,8 +21,16 @@ module MundoPepino
       end
     end
   
-    def field_for(model, campo = 'nombre')
-      "#{model && model.name}::#{campo}".to_field || campo.to_field
+    def field_for(model=nil, field = nil)
+      model_name = "#{model && model.name+'::'}"
+      if field
+        "#{model_name}#{field}".to_field || field.to_field
+      else
+        # The use of "nombre" the name field mapping is deprecated
+        "#{model_name}nombre".to_field || 'nombre'.to_field || 
+        # "Model::name" or "name" (for a global mapping) is the right use.
+        "#{model_name}name".to_field || 'name'.to_field || :name
+      end
     end
 
     def shouldify(should_or_not)
@@ -175,6 +185,32 @@ module MundoPepino
         raise MundoPepino::ModelNotMapped.new(unquoted_model)
       end
     end
+
+    def nested_field_id(nested_field, nested_model, nested_name, parent_resource=nil)
+      unquoted_model = nested_model.to_unquoted
+      if model = unquoted_model.to_model
+        if res = model.send("find_by_#{field_for(model)}", nested_name)
+          if field_prefix = nested_field_id_prefix(res, parent_resource)
+            "#{field_prefix}#{nested_field.to_field}"
+          end
+        else
+          raise MundoPepino::ResourceNotFound.new("No '#{unquoted_model}' called '#{nested_name}'")
+        end
+      else
+        raise MundoPepino::ModelNotMapped.new(unquoted_model)
+      end
+    end
+
+    def nested_field_id_prefix(resource, parent_resource=nil)
+      parent = parent_resource ? parent_resource.mr_model.name.underscore : '[a-z][a-z_]*[a-z]'
+      children = resource.class.name.pluralize.underscore
+      preprefix = "#{parent}_#{children}_attributes"
+      Nokogiri::HTML.parse(response.body).xpath(
+        "//input[@type='hidden' and @value=#{resource.id}]"
+      ).each do |input|
+        return "#{preprefix}_#{$1}_" if input.attributes['id'].to_s =~ /#{preprefix}_([0-9]+)_id/
+      end
+    end
   end  
 end
 

data/lib/mundo_pepino/resources_history.rb

@@ -90,7 +90,7 @@ module MundoPepino
   
     def add_resource_from_database(modelo, nombre)
       model = modelo.to_unquoted.to_model
-      field = field_for(model, 'nombre')
+      field = field_for(model)
       if resource = model.send("find_by_#{field}", nombre)
         pile_up resource
       else
@@ -165,7 +165,7 @@ module MundoPepino
         arr.detect { |r| r.respond_to?(method) && r.send(method, value) }
       elsif value.is_a? Array
         model, val = value # [ class, value ]
-        name_field = field_for(model, 'nombre')
+        name_field = field_for(model)
         arr.detect do |r| 
           r.respond_to?(:is_a?) && r.is_a?(model) && r.send(name_field) =~ /#{val}/i
         end
@@ -187,7 +187,7 @@ module MundoPepino
         [[ mentioned ], [ valor ]]
       end
       field, values = if (child_model = campo.to_model)
-        child_name_field = field_for(mentioned.mr_model, 'nombre')
+        child_name_field = field_for(mentioned.mr_model)
         values = add_resource(child_model,
           valores.map { |val| { child_name_field => val } })
         values = [ values ] unless values.is_a?(Array)

data/lib/mundo_pepino/version.rb

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

data/rails_generators/mundo_pepino/templates/mundo_pepino_es_ES.rb

@@ -16,13 +16,13 @@ MundoPepino.configure do |config|
 
   config.field_mappings = {
     # TRADUCCIÓN DE CAMPOS AQUÍ:
-    # /^[Ááa]reas?$/i    => 'area',
-    # /^color(es)?$/i   => 'color',
-    # /^latitud(es)?$/i => 'latitude',
-    # /^longitud(es)?/i => 'length'
+    # /^[Ááa]reas?$/i    => :area,
+    # /^color(es)?$/i   => :color,
+    # /^latitud(es)?$/i => :latitude,
+    # /^longitud(es)?/i => :length
     #
     # TRADUCCIÓN ESPECÍFICA PARA UN MODELO
-    # /^Orchard::longitud(es)?$/   => 'longitude'
+    # /^Orchard::longitud(es)?$/   => :longitude
   }
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: mundo-pepino
 version: !ruby/object:Gem::Version 
-  version: 0.1.5
+  version: 0.1.6
 platform: ruby
 authors: 
 - "Fernando Garc\xC3\xADa Samblas"
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-11-04 00:00:00 +01:00
+date: 2009-11-13 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -62,6 +62,16 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: 1.2.6
     version: 
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.0
+    version: 
 - !ruby/object:Gem::Dependency 
   name: string-mapper
   type: :runtime