louche

Louche agrega validadores comunes para las clases ActiveModel/ActiveRecord.

---

Instalación

Agregue esta línea al Gemfile de su aplicación:

 gem 'louche' 

Uso

Louche proporciona algunos validadores para usar en sus clases ActiveModel/ActiveRecord. Puede utilizar todos los validadores con una versión simbolizada en minúsculas de su prefijo como clave y true como valor. Por ejemplo, para EmailValidator :

 class User < ApplicationRecord
  validates :email , email : true
end

Opcionalmente, si desea personalizar las opciones predeterminadas, puede pasar un hash como valor:

 class User < ApplicationRecord
  validates :email , email : { regex : /^.*@.*$/ , message : :blank }
end

Estos son los validadores que proporciona Louche junto con sus respectivas opciones:

EmailValidator

Ejemplo

 class User < ApplicationRecord
  validates :email , email : true
end

User . new ( email : '[email protected]' ) . valid? # => true
User . new ( email : 'foo@example' ) . valid? # => false 

Opciones

Opción	Descripción
:regex	La expresión regular utilizada para validar el correo electrónico (predeterminado: /A([^@s]+)@((?:[-a-z0-9]+.)+[az]{2,})z/i )
:message	El mensaje ActiveRecord agregado a los errores de registro (predeterminado: :invalid_email )

URLValidator

Ejemplo

 class User < ApplicationRecord
  validates :website , url : true
end

User . new ( website : 'http://example.com' ) . valid? # => true
User . new ( website : 'example.$$$' ) . valid? # => false 

Opciones

Opción	Descripción
:schemes	Los esquemas de URI que se permitirán (predeterminado: %w(http https) )
:message	El mensaje ActiveRecord agregado a los errores de registro (predeterminado: :invalid_url )

PhoneNumberValidator

Ejemplo

 class User < ApplicationRecord
  validates :phone_number , phone_number : true
end

user = User . new ( phone_number : '514 555-2525' )
user . valid? # => true
user . phone_number # => '5145552525'

user = User . new ( phone_number : '555-2525' )
user . valid? # => false
user . phone_number # '5552525' 

Opciones

Opción	Descripción
:regex	La expresión regular utilizada para validar el número (predeterminado: /Ad{10,}z/ )
:cleanup_regex	La expresión regular utilizada para validar limpia la entrada antes de validarla/guardarla (predeterminado: /[^d]/ )
:message	El mensaje ActiveRecord agregado a los errores de registro (predeterminado: :invalid_phone_number )

PostalCodeValidator

Ejemplo

 class User < ApplicationRecord
  validates :postal_code , postal_code : true
end

user = User . new ( postal_code : 'G0R 2T0' )
user . valid? # => true
user . postal_code # => 'G0R2T0'

user = User . new ( postal_code : 'L -0- L' )
user . valid? # => false
user . postal_code # => 'L0L' 

Opciones

Opción	Descripción
:regex	La expresión regular utilizada para validar el código (predeterminada: /A[az]d[az]d[az]dz/i )
:cleanup_regex	La expresión regular utilizada para validar limpia la entrada antes de validarla/guardarla (predeterminado: /[^a-z0-9]/i )
:message	El mensaje ActiveRecord agregado a los errores de registro (predeterminado: :invalid_postal_code )

ArrayValidator

Ejemplo

 class Tag < Struct . new ( :name )
  def valid?
    name . present?
  end
end

class User < ApplicationRecord
  validates :tags , array : true

  def tags = ( tags )
    super tags . map { | tag | Tag . new ( tag ) }
  end
end

User . new ( tags : [ 'food' , 'beer' , 'code' ] ) . valid? # => true
User . new ( tags : [ 'food' , '' , 'code' ] ) . valid? # => false 

Opciones

Opción	Descripción
:message	El mensaje ActiveRecord agregado a los errores de registro (predeterminado: :invalid_array )
:validity_method	El método que se enviará a cada elemento de la matriz (predeterminado:: :valid? )

RgbHexValidator

Ejemplo

 class Flag < ApplicationRecord
  validates :color , rgb_hex : true
end

flag = Flag . new ( color : '#ff0000' )
flag . valid? # => true
flag . color # => '#ff0000'

flag = Flag . new ( color : '#zzzzzz' )
flag . valid? # => false
flag . color # => '#' 

Opciones

Opción	Descripción
:regex	La expresión regular utilizada para validar el código (predeterminado: `/A#([a-f0-9]{6}
:cleanup_regex	La expresión regular utilizada para validar limpia la entrada antes de validarla/guardarla (predeterminado: /[^#a-f0-9]/i )
:message	El mensaje ActiveRecord agregado a los errores de registro (predeterminado: :invalid_rgb_hex )

Mensajes de error localizados

Louche utiliza mensajes estándar de ActiveRecord. Así es como podría verse su archivo config/locales/activerecord.en.yml :

 en :
  errors :
    messages :
      invalid_email : is not a valid email address
      invalid_url : is not a valid URL
      invalid_phone_number : is not a valid phone number
      invalid_postal_code : is not a valid postal code
      invalid_array : contains invalid items
      invalid_rgb_hex : is not a valid color 

Licencia

Louche es © 2014-2015 Mirego y puede distribuirse libremente bajo la nueva licencia BSD. Consulte el archivo LICENSE.md .

Acerca de Mirego

Mirego es un equipo de personas apasionadas que creen que el trabajo es un lugar donde puedes innovar y divertirte. Somos un equipo de personas talentosas que imaginan y crean hermosas aplicaciones web y móviles. Nos reunimos para compartir ideas y cambiar el mundo.

También nos encanta el software de código abierto e intentamos devolver a la comunidad todo lo que podemos.