provincias 0.0.3 → 0.0.4
Sign up to get free protection for your applications and to get access to all the features.
- data/README.md +26 -17
- data/Rakefile +7 -0
- data/data/cities.csv +8116 -0
- data/data/provinces.csv +52 -0
- data/lib/provincias/version.rb +2 -1
- data/lib/provincias.rb +78 -69
- data/test/test_api.rb +61 -0
- metadata +7 -3
data/README.md
CHANGED
@@ -1,39 +1,48 @@
|
|
1
1
|
# Provincias
|
2
2
|
|
3
|
-
|
3
|
+
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.
|
4
4
|
|
5
|
-
|
5
|
+
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.
|
6
6
|
|
7
|
-
|
7
|
+
## Instalación
|
8
8
|
|
9
|
-
|
10
|
-
|
11
|
-
Add this line to your application's Gemfile:
|
9
|
+
Añade esta línea al Gemfile de tu aplicación:
|
12
10
|
|
13
11
|
gem 'provincias'
|
14
12
|
|
15
|
-
|
13
|
+
Y ejecuta:
|
16
14
|
|
17
15
|
$ bundle
|
18
16
|
|
19
|
-
|
17
|
+
O instálala ejecutando el siguiente comando:
|
20
18
|
|
21
19
|
$ gem install provincias
|
22
20
|
|
23
21
|
## Usage
|
24
22
|
|
25
|
-
|
23
|
+
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.
|
24
|
+
|
25
|
+
Gestión de provincias:
|
26
26
|
|
27
27
|
Provincias.find(28) => #<Provincia: @id=28, @name="Madrid">
|
28
28
|
Provincias.find_by_name('Palmas, Las') => #<Provincia: @id=35, @name="Palmas, Las">
|
29
29
|
Provincias.find_by_name('wombat') => nil
|
30
|
-
Provincias.all => [...] #
|
31
|
-
Provincias.all_for_select => [...] #
|
30
|
+
Provincias.all => [...] # Un array de provincias
|
31
|
+
Provincias.all_for_select => [...] # Un array de la forma [name, id] para usarlo en los helpers de tipo select en Rails
|
32
|
+
|
33
|
+
Gestión de ciudades de forma absoluta:
|
34
|
+
|
35
|
+
Provincias::Ciudades.find(35017) => #<Ciudad: @id=35017, @name="Puerto del Rosario" ...>
|
36
|
+
Provincias::Ciudades.find_by_name("Puerto del Rosario") => #<Ciudad: @id=35017, @name="Puerto del Rosario" ...>
|
37
|
+
Provincias::Ciudades.all => [...] # Un array de ciudades
|
38
|
+
Provincias::Ciudades.all_for_select => [...] # Un array de la forma [name, id] para usarlo en los helpers de tipo select en Rails
|
39
|
+
Provincias::Ciudades.find_by_name("Puerto del Rosario").provincia => #<Provincia: @id=35, @name="Palmas, Las">
|
40
|
+
|
41
|
+
Gestión de ciudades de forma relativa a una provincia (Esta es la parte que no se parece a ActiveRecord):
|
32
42
|
|
33
|
-
|
43
|
+
Provincias.find(28).ciudades => [...] # Un array con las ciudades de la provincia de Madrid
|
44
|
+
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
|
45
|
+
Provincias.find(28).find_ciudad(28006) => #<Ciudad: @id=28006, @name="Alcobendas" ...>
|
46
|
+
Provincias.find(28).find_ciudad_by_name("Alcobendas") => #<Ciudad: @id=28006, @name="Alcobendas" ...>
|
34
47
|
|
35
|
-
|
36
|
-
2. Create your feature branch (`git checkout -b my-new-feature`)
|
37
|
-
3. Commit your changes (`git commit -am 'Added some feature'`)
|
38
|
-
4. Push to the branch (`git push origin my-new-feature`)
|
39
|
-
5. Create new Pull Request
|
48
|
+
Todas las búsquedas retornan nil si no encuentran coincidencias con lo que estás buscando.
|