ca postal code

Código capostal

Una caja de herramientas para códigos postales canadienses: validar, normalizar y adivinar su región.

 CAPostalCode . valid? ( "h1b2p3" )
# => true

CAPostalCode . normalize ( "e3b.4k5 " )
# => "E3B 4K5"

CAPostalCode . guess_region ( "K1A 0B3" )
# => "ON"

CAPostalCode . guess_region ( "X0C 1A1" )
# => "NU" 

Uso

Validez

Después de normalizar la cadena, verifica si se ajusta al formato para un código postal.

Las cadenas que contienen letras D, F, I, O, Q y las que comienzan con W o Z no son válidas.

 CAPostalCode . valid? ( "h1b2p3" )
# => true

CAPostalCode . valid? ( "F8G 1A1" )
# => false

CAPostalCode . valid? ( "potato" )
# => false

CAPostalCode . valid? ( "P0T 4T0" )
# => true

Normalización

Normalice la cadena para que se vea como un código postal.

No verifica la validez. Más bien, ¿el .valid? El método se basa en este para facilitar su trabajo.

 CAPostalCode . normalize ( "e3b.4k5 " )
# => "E3B 4K5"

CAPostalCode . normalize ( "g1c 4z9" )
# => "G1C 4Z9"

CAPostalCode . normalize ( "potato" )
# => "POT ATO"

Adivinación de la región

Adivina la provincia o territorio canadiense ( región ) basado en el código postal.

Para provincias y Yukon, se adivinará en base a la primera carta. Para los Territorios del Noroeste y Nunavut, verificará los primeros dos o tres personajes.

 CAPostalCode . guess_region ( "G1A 1A1" )
# => "QC"

CAPostalCode . guess_region ( "X0C 1A1" )
# => "NU"

CAPostalCode . guess_region ( "B6A 1A1" )
# => "NS" 

Instalación

En tu gemfile:

 gem "ca_postal_code"

O instálelo usted mismo:

 gem install ca_postal_code

Desarrollo

Después de revisar el repositorio, ejecute bin/setup para instalar dependencias. Luego, ejecute rake spec para ejecutar las pruebas. También puede ejecutar bin/console para un mensaje interactivo que le permitirá experimentar.

Para instalar esta gema en su máquina local, ejecute bundle exec rake install . Para lanzar una nueva versión, actualice el número de versión en version.rb y luego ejecute bundle exec rake release , que creará una etiqueta GIT para la versión, Push Git Commits and Tags, y empuje el archivo .gem a rubygems.org.

Que contribuye

Los informes de errores y las solicitudes de extracción son bienvenidas en GitHub en https://github.com/jolard/ca-postal-code.