Validación de la Cédula de Identidad Uruguaya en Ruby

El otro día comprando entradas para el cine por Internet tuve que llenar un campo “Cédula”. La cédula de identidad uruguaya tiene el formato: 0.000.000-0

Me molestó que en el sitio pidieran escribir la cédula con un formato específico. “¿Quién programó esto?” pensé, quitarle puntos y guiones al número es una estupidez en cualquier lenguaje de programación. Tendría que ser indiferente si la persona escribe “0.000.000/0” o “0000000”.

El dígito después del guión es el “dígito verificador” de la cédula. Pueden leer sobre el algoritmo de validación en Wikipedia. Uno de mis primeros proyectos hace años cuando trabajaba con .net fue un verificador de cédulas. Era una aplicación de escritorio con el diseño de la cédula, donde podíamos ingresar los números y nos decía si una cédula era válida. También generaba números de cédula al azar para una aplicación en la que estábamos trabajando que usaba validación de cédulas. Si alguna vez encuentro ese código prometo ponerlo en algún lado 😛

El tema es que aburridos en el trabajo nos pusimos a hacer el algoritmo de validación de la cédula en Ruby en una sola línea. Estuvimos un rato con eso viendo distintas formas de hacerlo. Esa noche pensé en alguna manera de compartir ese código, porque es algo que no cambia y varias personas la pueden usar. Hace tiempo que venía buscando una excusa para crear una gema en Ruby, y esto me vino al pelo para hacerlo.

ci_uy en RubyGems

Fue así que creé mi primera gema: ci_uy, una gema para validar números de cédula uruguayas. La instalación es muy sencilla:

gem install ci_uy

Su uso:

fernando@hoth ~ $ irb
1.9.3p194 :001 > require 'ci_uy'
=> true 
1.9.3p194 :002 > CiUY.validate_ci("1.111.111-1")
 => true 
1.9.3p194 :003 > CiUY.get_validation_digit("2222222")
 => "2"

Pueden ver el código en GitHub. El código es bastante sencillo, pero ya me sirvió para leer un poco más sobre RubyGems y tener la experiencia de crear una gema desde cero. Había trabajado sobre otras gemas, pero esta es la primera que creé.