Version 0.0.4

En esta version:
-Datos del INE
-Tests
-Gestión de ciudades

README.md

@@ -1,39 +1,48 @@
 # Provincias
 
-Stop storing spanish provinces in a static table in your database. Use this gem and reclaim a few bytes of your storage quota.
+Deja de desperdiciar espacio de tu base de datos con tablas estáticas para guardar nombres de provincias y ciudades que no cambian prácticamente nunca.
 
-## Thanks
+Esta gema contiene los datos de provincias y ciudades provistos por el INE (http://www.ine.es) para el año 2012. Los datos se mantienen en formato CSV para facilitar posibles actualizaciones.
 
-Province names and codes were gently stolen from 'provincias_espana_rails' gem, a database-based solution for the same problem: https://github.com/diacode/provincias_espana_rails
+## Instalación
 
-## Installation
-
-Add this line to your application's Gemfile:
+Añade esta línea al Gemfile de tu aplicación:
 
     gem 'provincias'
 
-And then execute:
+Y ejecuta:
 
     $ bundle
 
-Or install it yourself as:
+O instálala ejecutando el siguiente comando:
 
     $ gem install provincias
 
 ## Usage
 
-The interface is simmilar to ActiveRecord's and provides provinces numeric codes you can use to search or easily link provinces to your classes.
+La interfaz es similar a la de ActiveRecord, salvando las distancias. La gema provee con códigos numéricos de provincias y ciudades que puedes usar para enlazarlas con tus modelos.
+
+Gestión de provincias:
 
     Provincias.find(28) => #<Provincia: @id=28, @name="Madrid">
     Provincias.find_by_name('Palmas, Las') => #<Provincia: @id=35, @name="Palmas, Las">
     Provincias.find_by_name('wombat') => nil
-    Provincias.all => [...] # An array of Provincia instances
-    Provincias.all_for_select => [...] # An array in form [name, id] to use in your select helpers in Rails
+    Provincias.all => [...] # Un array de provincias
+    Provincias.all_for_select => [...] # Un array de la forma [name, id] para usarlo en los helpers de tipo select en Rails
+
+Gestión de ciudades de forma absoluta:
+
+    Provincias::Ciudades.find(35017) => #<Ciudad: @id=35017, @name="Puerto del Rosario" ...>
+    Provincias::Ciudades.find_by_name("Puerto del Rosario") => #<Ciudad: @id=35017, @name="Puerto del Rosario" ...>
+    Provincias::Ciudades.all => [...] # Un array de ciudades
+    Provincias::Ciudades.all_for_select => [...] # Un array de la forma [name, id] para usarlo en los helpers de tipo select en Rails
+    Provincias::Ciudades.find_by_name("Puerto del Rosario").provincia => #<Provincia: @id=35, @name="Palmas, Las">
+
+Gestión de ciudades de forma relativa a una provincia (Esta es la parte que no se parece a ActiveRecord):
 
-## Contributing
+    Provincias.find(28).ciudades => [...] # Un array con las ciudades de la provincia de Madrid
+    Provincias.find(28).ciudades_for_select => [...] # Un array con las ciudades de la provincia de Madrid de la forma [name, id] para usarlo en los helpers de tipo select en Rails
+    Provincias.find(28).find_ciudad(28006) => #<Ciudad: @id=28006, @name="Alcobendas" ...>
+    Provincias.find(28).find_ciudad_by_name("Alcobendas") => #<Ciudad: @id=28006, @name="Alcobendas" ...>
 
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Added some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+Todas las búsquedas retornan nil si no encuentran coincidencias con lo que estás buscando.

Rakefile

@@ -1,2 +1,9 @@
 #!/usr/bin/env rake
 require "bundler/gem_tasks"
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/test*.rb']
+  t.verbose = true
+end