provincias 0.0.4 → 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8e0142d3ca78de4e327b1bf0ae09de7396486d9a
+  data.tar.gz: 95c4cae04e6ea67ec46b3ea41bedfecbf09f5dba
+SHA512:
+  metadata.gz: 1699f369933d3984bf89f28368b39ccdd58e3e62222218827ab7a064963f612df1668b54312252621450bd0f459089efb671485a844b4da4387c8aa7daf1bb00
+  data.tar.gz: 3d96f844964fb65b4cb140bcdfe0ea77c30519126b2443090405b91c46636fdcb6c8299a06a760035b6e06efcc2580f4defc350b2fb33937fe6be67d6dbadcc5

data/README.md

@@ -20,20 +20,22 @@ O instálala ejecutando el siguiente comando:
 
 ## Usage
 
-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.
+La interfaz es similar a la de ActiveRecord, salvando las distancias. La gema provee códigos numéricos e identificadores de tipo string llamados slugs (Cuyo funcionamiento emula al de la gema friendlyId) y que puedes usar para enlazarlas con tus modelos. Es posible buscar tanto provincias como ciudades usando indiferentemente IDs o slugs. Los slugs se generan a partir de los nombres pasando todos los caracteres a minúscula, eliminando símbolos y caracteres no alfanuméricos y separando cada palabra con un guión. Por ejemplo: `"Iruña Oka/Iruña de Oca"` => `"iruna-oka-iruna-de-oca"`
 
 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(28) => #<Provincia: @id=28, @name="Madrid", @slug="madrid">
+    Provincias.find("madrid") => #<Provincia: @id=28, @name="Madrid", @slug="madrid">
+    Provincias.find_by_name('Palmas, Las') => #<Provincia: @id=35, @name="Palmas, Las", @slug="palmas-las">
     Provincias.find_by_name('wombat') => nil
     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.find(35017) => #<Ciudad: @id=35017, @name="Puerto del Rosario", @slug="puerto-del-rosario"...>
+    Provincias::Ciudades.find("puerto-del-rosario") => #<Ciudad: @id=35017, @name="Puerto del Rosario", @slug="puerto-del-rosario"...>
+    Provincias::Ciudades.find_by_name("Puerto del Rosario") => #<Ciudad: @id=35017, @name="Puerto del Rosario", @slug="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">
@@ -42,7 +44,8 @@ Gestión de ciudades de forma relativa a una provincia (Esta es la parte que no
 
     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" ...>
+    Provincias.find(28).find_ciudad(28006) => #<Ciudad: @id=28006, @name="Alcobendas", @slug="alcobendas" ...>
+    Provincias.find(28).find_ciudad("alcobendas") => #<Ciudad: @id=28006, @name="Alcobendas", @slug="alcobendas" ...>
+    Provincias.find(28).find_ciudad_by_name("Alcobendas") => #<Ciudad: @id=28006, @name="Alcobendas", @slug="alcobendas" ...>
 
 Todas las búsquedas retornan nil si no encuentran coincidencias con lo que estás buscando.

data/lib/provincias.rb

@@ -1,11 +1,16 @@
 # -*- encoding: utf-8 -*-
 require "provincias/version"
 require 'csv'
+require 'i18n'
 
 module Provincias
 
   def self.find(id)
-    @@provincias[id]
+    @@provincias[id] || self.find_by_slug(id)
+  end
+
+  def self.find_by_slug(slug)
+    @@provincias.values.select { |p| p.slug == slug }.first
   end
 
   def self.find_by_name(name)
@@ -21,9 +26,10 @@ module Provincias
   end
 
   class Provincia
-    attr_reader :id, :name
+    attr_reader :id, :name, :slug
     def initialize(row)
       id, @name = row
+      @slug = I18n.transliterate(@name).downcase.scan(/\w+/).join('-')
       @id = id.to_i
     end
 
@@ -36,7 +42,11 @@ module Provincias
     end
 
     def find_ciudad(id)
-      ciudades.select { |c| c.id == id }.first
+      ciudades.select { |c| c.id == id }.first || self.find_ciudad_by_slug(id)
+    end
+
+    def find_ciudad_by_slug(slug)
+      ciudades.select { |c| c.slug == slug }.first
     end
 
     def find_ciudad_by_name(name)
@@ -55,7 +65,11 @@ module Provincias
   module Ciudades
 
     def self.find(id)
-      @@ciudades[id]
+      @@ciudades[id] || self.find_by_slug(id)
+    end
+
+    def self.find_by_slug(slug)
+      @@ciudades.values.select { |c| c.slug == slug }.first
     end
 
     def self.find_by_name(name)
@@ -75,9 +89,10 @@ module Provincias
     end
 
     class Ciudad
-      attr_reader :provincia_id, :id, :dc, :name
+      attr_reader :provincia_id, :id, :dc, :name, :slug
       def initialize(row)
         provincia_id, number, @dc, @name = row
+        @slug = I18n.transliterate(@name).downcase.scan(/\w+/).join('-')
         @provincia_id = provincia_id.to_i
         @id = (provincia_id+number).to_i
       end

data/lib/provincias/version.rb

@@ -1,4 +1,4 @@
 # -*- encoding: utf-8 -*-
 module Provincias
-  VERSION = "0.0.4"
+  VERSION = "0.1.0"
 end

data/test/test_api.rb

@@ -10,8 +10,12 @@ class TestApi < Test::Unit::TestCase
     assert_nil Provincias.find(100000)
     assert_equal Provincias.find(28).id, 28
     assert_equal Provincias.find(28).name, "Madrid"
+    assert_equal Provincias.find(28).slug, "madrid"
+    assert_equal Provincias.find('madrid').name, "Madrid"
+    assert_equal Provincias.find('palmas-las').name, "Palmas, Las"
     assert_equal Provincias.find_by_name('Palmas, Las').id, 35
     assert_equal Provincias.find_by_name('Palmas, Las').name, 'Palmas, Las'
+    assert_equal Provincias.find_by_name('Palmas, Las').slug, 'palmas-las'
     assert_nil Provincias.find_by_name('wombat')
     assert_instance_of Array, Provincias.all
     assert_instance_of Provincias::Provincia, Provincias.all.first
@@ -27,10 +31,15 @@ class TestApi < Test::Unit::TestCase
     assert_not_nil Provincias::Ciudades.find(35017)
     assert_equal Provincias::Ciudades.find(35017).id, 35017
     assert_equal Provincias::Ciudades.find(35017).name, 'Puerto del Rosario'
+    assert_equal Provincias::Ciudades.find(35017).slug, 'puerto-del-rosario'
+    assert_equal Provincias::Ciudades.find('puerto-del-rosario').id, 35017
+    assert_equal Provincias::Ciudades.find('puerto-del-rosario').name, 'Puerto del Rosario'
+    assert_equal Provincias::Ciudades.find('puerto-del-rosario').slug, 'puerto-del-rosario'
     assert_nil Provincias::Ciudades.find_by_name('wombat')
     assert_instance_of Provincias::Ciudades::Ciudad, Provincias::Ciudades.find_by_name('Palmas de Gran Canaria, Las')
     assert_equal Provincias::Ciudades.find_by_name('Palmas de Gran Canaria, Las').id, 35016
     assert_equal Provincias::Ciudades.find_by_name('Palmas de Gran Canaria, Las').name, 'Palmas de Gran Canaria, Las'
+    assert_equal Provincias::Ciudades.find_by_name('Palmas de Gran Canaria, Las').slug, 'palmas-de-gran-canaria-las'
     assert_instance_of Array, Provincias.find(28).ciudades
     assert_instance_of Provincias::Ciudades::Ciudad, Provincias.find(28).ciudades.first
     assert Provincias.find(28).ciudades.map { |c| c.name }.include?("Madrid")
@@ -38,7 +47,9 @@ class TestApi < Test::Unit::TestCase
     assert_nil Provincias.find(28).find_ciudad(999999999)
     assert_instance_of Provincias::Ciudades::Ciudad, Provincias.find(28).find_ciudad(28001)
     assert_equal "Acebeda, La", Provincias.find(28).find_ciudad(28001).name
+    assert_equal "Acebeda, La", Provincias.find(28).find_ciudad("acebeda-la").name
     assert_equal 28001, Provincias.find(28).find_ciudad(28001).id
+    assert_equal 28001, Provincias.find(28).find_ciudad("acebeda-la").id
     assert_instance_of Provincias::Ciudades::Ciudad, Provincias.find(28).find_ciudad_by_name("Alcobendas")
     assert_nil Provincias.find(28).find_ciudad_by_name("wombat")
     assert_equal "Alcobendas", Provincias.find(28).find_ciudad_by_name("Alcobendas").name

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: provincias
 version: !ruby/object:Gem::Version
-  version: 0.0.4
-  prerelease: 
+  version: 0.1.0
 platform: ruby
 authors:
 - Javier Toledo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-07-16 00:00:00.000000000 Z
+date: 2013-12-12 00:00:00.000000000 Z
 dependencies: []
 description: Provides a way to easily manage spanish provinces in your apps without
   creating additional tables in your database.
@@ -33,29 +32,27 @@ files:
 - test/test_api.rb
 homepage: https://github.com/agilemonkeys/provincias
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 2.0.6
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Stop storing spanish provinces in a static table in your database. Use this
   gem and reclaim a few bytes of your storage quota.
 test_files:
 - test/test_api.rb
-has_rdoc: