id_ecuador 0.0.1 → 0.0.2.alpha

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: fa902ade828ff98a419b8f8bddcfb92e1668bc96
+  data.tar.gz: e921f72a4b6171d04320f7b1e5d4b0f653a78e36
+SHA512:
+  metadata.gz: 105b7d73e406cf77acb4c1b16b5e76445bf9e6e80337106660c19db01bbd06e1081313217bb5587d70b4ebf8401363066602e5c279284804b5826daa1abf1009
+  data.tar.gz: 85f799b2911ee6bd47fb9d71c471c2e6aa69b2e5fa2614c30abbd925452a8ca55ee460cbe81946c8686a3e6a2b6d1a43ab8482885fa667a6819af4e394254281

data/CHANGELOG.md

@@ -12,7 +12,14 @@
 * Verificando que cuando un modelo en rails utiliza el validador, no se vuelva a instanciar otro validador a menos que la identificación (atributo) del mismo cambie.
 * Agregado `factory_girl` para testing
 * Tests refactored
+* Modificado *Railtie*. Había un error de sintaxis. Reemplazado `intializer` por `initializer`
 
-## v0.0.1.beta.2
+## v0.0.1
 
-* Modificado *Railtie*. Había un error de sintaxis. Reemplazado `intializer` por `initializer`
+* Primera versión estable
+* Pequeños arreglos de bugs en la implementación para Rails
+
+## v0.0.2.alpha
+
+* Agregados los métodos `id` y `id=` a la clase `IdEcuador::Id`
+* Refactorizado el método `initialize` y `id=` para que ambos utilicen un nuevo método `evaluate!` y evitar duplicación de código

data/README.md

@@ -2,43 +2,41 @@
 
 Gema para validar la cédula o ruc de Ecuador
 
+La clase `Id` dentro del módulo `IdEcuador` permite, a partir de un número de identificación, saber:
+
+- Si el número de identificación es válido
+- El tipo de identificación, que puede ser:
+    - Cédula
+    - RUC personas naturales
+    - RUC empresa sector público
+    - RUC empresa privada o extranjera
+
 ## Status
 
 [![Build Status](https://travis-ci.org/macool/id_ecuador.png?branch=master)](https://travis-ci.org/macool/id_ecuador)
 [![Gem Version](https://badge.fury.io/rb/id_ecuador.png)](http://badge.fury.io/rb/id_ecuador)
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-    gem 'id_ecuador'
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install id_ecuador
+[![Code Climate](https://codeclimate.com/github/macool/id_ecuador.png)](https://codeclimate.com/github/macool/id_ecuador)
 
 ## Usage
 
 ```ruby
 require "id_ecuador"
 
-cedula = IdEcuador::Id.new "1104680135"
+cedula = IdEcuador.new "1104680135"
+cedula.id               # => "1104680135"
 cedula.valid?           # => true
 cedula.tipo_id          # => "Cédula Persona natural"
+cedula.tipo_id_sym      # => :cedula
 cedula.codigo_provincia # => 11
 
-cedula_invalida = IdEcuador::Id.new "1105680134"
+cedula_invalida = IdEcuador.new "1105680134"
 cedula_invalida.errors # => ["ID inválida"]
 ```
 
 No validar automáticamente:
 
 ```ruby
-cedula = IdEcuador::Id.new "1104680135", auto_validate: false
+cedula = IdEcuador.new "1104680135", auto_validate: false
 cedula.validate!.valid?
 ```
 
@@ -50,7 +48,17 @@ class User < ActiveRecord::Base
 end
 ```
 
-Con opciones:
+### Con opciones:
+
+Las opciones por defecto son:
+
+```ruby
+{
+  :allow_blank => true,   # No levanta error si el atributo es nil o ""
+  :message => nil,        # Utilizar mensajes por defecto de la gema
+  :only => []             # Permitir todos los tipos de ID
+}
+```
 
 ```ruby
 class User < ActiveRecord::Base
@@ -62,12 +70,27 @@ Ejemplo API Rails:
 
 ```ruby
 user = User.new identificacion: "110468135001"
+user.idenfiticacion                    # => "110468135001"
 user.identificacion_id_validator.class # => IdEcuador::Id
 user.identificacion_tipo_id            # => "RUC Persona natural"
 user.identificacion_tipo_id_sym        # => :ruc
 user.identificacion_codigo_provincia   # => 11
 ```
 
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'id_ecuador'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install id_ecuador
+
 ## Documentación
 
 [rubydoc](http://rubydoc.info/github/macool/id_ecuador/master/frames)

data/id_ecuador.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
   spec.email         = ["a@macool.me"]
   spec.description   = %q{Validate Ecuador's CI and RUC}
   spec.summary       = %q{Gem to validate Ecuador's CI and RUC}
-  spec.homepage      = ""
+  spec.homepage      = "https://github.com/macool/id_ecuador"
   spec.license       = "MIT"
 
   spec.files         = `git ls-files`.split($/)

data/lib/id_ecuador.rb

@@ -20,6 +20,6 @@ module IdEcuador
   # @example Instanciar ID
   #   IdEcuador.new("1104680135").class #=> IdEcuador::Id
   def self.new(*args)
-    IdEcuador::Id.new(*args)
+    Id.new(*args)
   end
 end

data/lib/id_ecuador/id.rb

@@ -2,6 +2,7 @@
 
 module IdEcuador
   # Clase que va a analizar la cédula. Recibe un id y unas opciones
+  # @attr_reader [String] id Número de ID
   # @attr_reader [Array] errors Los errores que tiene el ID. Array vacío si es un ID válido
   #
   # @attr_reader [String] tipo_id El tipo de identificación. Puede ser:
@@ -10,30 +11,37 @@ module IdEcuador
   #   - "Sociedad pública"
   #   - "Sociedad privada o extranjera"
   #
-  # @attr_reader [Fixnum] codigo_provincia El código de la provincia del ID ingresado
-  #
   # @attr_reader [Symbol] tipo_id_sym El tipo de identificación en símbolo. Puede ser:
   #   - :ruc
   #   - :cedula
   #   - :sociedad_publica
   #   - :sociedad_privada
   #
+  # @attr_reader [Fixnum] codigo_provincia El código de la provincia del ID ingresado
   class Id
     
-    attr_reader :errors, :tipo_id, :codigo_provincia, :tipo_id_sym
+    attr_reader :id, :errors, :tipo_id, :tipo_id_sym, :codigo_provincia
     
     # @param [String] id El ID que se va a analizar
     # @param [Hash] options Las opciones
     # @option options [Boolean] :auto_validate Validar automáticamente el ID al instanciar. <tt>true</tt> por defecto
     def initialize(id="", options={})
       @id = id.to_s
-      @errors = []
       
       defaults = {
         auto_validate: true
       }
       @options = defaults.merge options
-      validate! if @options[:auto_validate]
+      evaluate!
+    end
+
+    # Setter para el ID
+    # @param [String] new_id Nuevo ID que se va a analizar
+    # @return [String] Nuevo ID
+    def id=(new_id)
+      @id = new_id.to_s
+      evaluate!
+      new_id
     end
 
     # @return [Boolean] Si es un ID válido o no
@@ -55,6 +63,13 @@ module IdEcuador
     end
     
   protected
+    # Método llamado después de #initialize y #id=
+    # Se encarga de correr la validación si options[:auto_validate] es true
+    def evaluate!
+      @errors = []
+      validate! if @options[:auto_validate]
+      self
+    end
     def validate_length
       if [10, 13].include?(@id.length)
         true

data/lib/id_ecuador/model_additions.rb

@@ -22,9 +22,7 @@ module IdEcuador
       options = defaults.merge options
 
       # transform options[:only] to array if it's not:
-      unless options[:only].class == Array
-        options[:only] = [options[:only]]
-      end
+      options[:only] = Array options[:only]
 
 
       # poner métodos:

data/lib/id_ecuador/version.rb

@@ -1,3 +1,3 @@
 module IdEcuador
-  VERSION = "0.0.1"
+  VERSION = "0.0.2.alpha"
 end

data/spec/id_ecuador/id_spec.rb

@@ -9,10 +9,26 @@ describe IdEcuador::Id do
       id.send(:already_validated).should be_true
     end
     it "no debe llamar automáticamente al método validate!" do
-      IdEcuador::Id.any_instance.stub(:validate!)
-      id = IdEcuador::Id.new CEDULA_VALIDA, validate: false
+      id = IdEcuador::Id.new CEDULA_VALIDA, auto_validate: false
       id.send(:already_validated).should be_false
     end
+    it "debe volver a correr la validación si cambia el ID con el método #id= y options[:auto_validate] está puesto" do
+      id = IdEcuador::Id.new
+      id.id = CEDULA_VALIDA
+      id.send(:already_validated).should be_true
+    end
+    it "no debe correr la validación si cambia el ID y options[:auto_validate] es false" do
+      id = IdEcuador::Id.new "", auto_validate: false
+      id.id = CEDULA_VALIDA
+      id.send(:already_validated).should be_false
+    end
+    it "el método #id= no debe dañar el resto de la funcionalidad" do
+      id = IdEcuador::Id.new ""
+      id.id = CEDULA_VALIDA
+      id.valid?.should be_true
+      id.id = CEDULA_INVALIDA
+      id.valid?.should be_false
+    end
   end
   
   describe "funcionalidad de la clase" do

data/spec/id_ecuador_spec.rb

@@ -5,5 +5,6 @@ describe IdEcuador do
   it "should alias IdEcuador#new to IdEcuador::Id#new" do
     id = IdEcuador.new CEDULA_VALIDA
     id.class.should eq(IdEcuador::Id)
+    id.id.should eq(CEDULA_VALIDA)
   end
 end

metadata

@@ -1,20 +1,18 @@
 --- !ruby/object:Gem::Specification
 name: id_ecuador
 version: !ruby/object:Gem::Version
-  version: 0.0.1
-  prerelease: 
+  version: 0.0.2.alpha
 platform: ruby
 authors:
 - Mario Andrés Correa
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-09-08 00:00:00.000000000 Z
+date: 2013-10-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -22,7 +20,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -30,65 +27,57 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: supermodel
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: factory_girl
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 description: Validate Ecuador's CI and RUC
@@ -116,30 +105,29 @@ files:
 - spec/id_ecuador/model_additions_spec.rb
 - spec/id_ecuador_spec.rb
 - spec/spec_helper.rb
-homepage: ''
+homepage: https://github.com/macool/id_ecuador
 licenses:
 - MIT
+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'
+      version: 1.3.1
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 2.0.5
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Gem to validate Ecuador's CI and RUC
 test_files:
 - spec/factories.rb
@@ -147,4 +135,3 @@ test_files:
 - spec/id_ecuador/model_additions_spec.rb
 - spec/id_ecuador_spec.rb
 - spec/spec_helper.rb
-has_rdoc: