missing_validators 0.6.3 → 0.7.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3a753662765a4f524c5b48aa7319306c92be6723
+  data.tar.gz: 6728c6fcfeeb1e4e10fe55170de856997f146064
+SHA512:
+  metadata.gz: f1bec22de6521794354b4e3eaba07352523045e948ad31525c69c4e638ca85e13273f3312d3ad56574b6c4bffdb4d30140ffcafd7dba0fe0c0736f756f1fa4a8
+  data.tar.gz: c63f5eab4501058232e58300fc81e8fded0443289bba356018ef0affe597cc8b705f575062c84fd96a1446bf954e50228e576cb8881464c48386c7c311227574

data/README.md

@@ -111,6 +111,38 @@ RSpec matcher is also available for your convenience:
       it { should ensure_inequality_of(:origin).to(:destination) }
     end
 
+### MacAddressValidator
+
+Ensures that MAC address is in one of the following formats:
+
+    '08:00:2b:01:02:03'
+    '08-00-2b-01-02-03'
+    '08002b:010203'
+    '08002b-010203'
+    '0800.2b01.0203'
+    '08002b010203'
+
+With an ActiveRecord model:
+
+    class Device < ActiveRecord::Base
+      attr_accessor :mac
+      validates :mac, mac_address: true
+    end
+
+Or any ruby class:
+
+    class Device
+      include ActiveModel::Validations
+      attr_accessor :mac
+      validates :mac, mac_address: true
+    end
+
+RSpec matcher is also available for your convenience:
+
+    describe Device do
+      it { should ensure_valid_mac_address_format_of }
+    end
+
 ## Contributing
 
 Your contribution is welcome.

data/config/locales/en.yml

@@ -4,6 +4,7 @@ en:
       inequality: "can't be equal to %{attr}"
       email: "isn't a valid email address"
       url: "isn't a valid URL"
+      mac_address: "isn't a valid MAC address"
   missing_validators:
     matchers:
       ensure_inequality_of:
@@ -15,3 +16,6 @@ en:
       ensure_valid_url_format_of:
         failure_message_for_should: "#{model} should ensure valid URL format of attribute #{attr}"
         failure_message_for_should_not: "#{model} should not ensure valid URL format of attribute #{attr}"
+      ensure_valid_mac_address_format_of:
+        failure_message_for_should: "#{model} should ensure valid MAC address format of attribute #{attr}"
+        failure_message_for_should_not: "#{model} should not ensure valid MAC address format of attribute #{attr}"

data/lib/missing_validators/matchers/ensure_valid_mac_address_format_of.rb

@@ -0,0 +1,20 @@
+RSpec::Matchers.define :ensure_valid_mac_address_format_of do |attribute|
+  match do |model|
+    model.send("#{attribute}=", "invalid.mac.address")
+    model.valid?
+
+    if model.errors.has_key?(attribute)
+      model.errors[attribute].include?(I18n.t('errors.messages.mac_address'))
+    end
+  end
+
+  failure_message_for_should do |model|
+    I18n.t 'missing_validators.matchers.ensure_valid_mac_address_format_of.failure_message_for_should',
+      model: model.class
+  end
+
+  failure_message_for_should_not do |model|
+    I18n.t 'missing_validators.matchers.ensure_valid_mac_address_format_of.failure_message_for_should_not',
+      model: model.class
+  end
+end

data/lib/missing_validators/validators/mac_address_validator.rb

@@ -0,0 +1,37 @@
+# Allows to check if the value of a specific attribute is a valid MAC address.
+#
+# @example Validate that the device MAC address is valid.
+#   class Device << ActiveRecord::Base
+#     attr_accessor :mac
+#     validates :mac, mac_address: true
+#   end
+class MacAddressValidator < ActiveModel::EachValidator
+  # Checks if an attribute value is a valid MAC address.
+  #
+  # @param [Object] record object to validate
+  # @param [String] attribute name of the object attribute to validate
+  # @param [Object] value attribute value
+  def validate_each(record, attribute, value)
+    allow_blank = options[:allow_blank] || false
+    return if allow_blank && value.blank?
+
+    unless valid?(value, options)
+      record.errors[attribute] << (options[:message] || I18n.t('errors.messages.mac_address'))
+    end
+  end
+
+  private
+
+  def valid?(mac_address, options)
+    validate_format(mac_address)
+  end
+
+  def validate_format(mac_address)
+    !!(mac_address =~ /^([A-Fa-f0-9]{2}[:]){5}[A-Fa-f0-9]{2}?$/i) ||    # 08:00:2b:01:02:03
+      !!(mac_address =~ /^([A-Fa-f0-9]{2}[-]){5}[A-Fa-f0-9]{2}?$/i) ||  # 08-00-2b-01-02-03
+      !!(mac_address =~ /^([A-Fa-f0-9]{6}):[A-Fa-f0-9]{6}?$/i) ||       # 08002b:010203
+      !!(mac_address =~ /^([A-Fa-f0-9]{6})-[A-Fa-f0-9]{6}?$/i) ||       # 08002b-010203
+      !!(mac_address =~ /^([A-Fa-f0-9]{4}[\.]){2}[A-Fa-f0-9]{4}?$/i) || # 0800.2b01.0203
+      !!(mac_address =~ /^[A-Fa-f0-9]{12}?$/i)                          # 08002b010203
+  end
+end

data/lib/missing_validators/version.rb

@@ -1,5 +1,5 @@
 # Provides a collection of custom validators that are often required in Rails applications.
 module MissingValidators
   # Gem version.
-  VERSION = "0.6.3"
+  VERSION = "0.7.0"
 end

data/lib/missing_validators.rb

@@ -6,3 +6,5 @@ require 'missing_validators/validators/email_validator'
 require 'missing_validators/matchers/ensure_valid_email_format_of' if defined?(RSpec)
 require 'missing_validators/validators/url_validator'
 require 'missing_validators/matchers/ensure_valid_url_format_of' if defined?(RSpec)
+require 'missing_validators/validators/mac_address_validator'
+require 'missing_validators/matchers/ensure_valid_mac_address_format_of' if defined?(RSpec)

data/missing_validators.gemspec

@@ -4,8 +4,8 @@ require File.expand_path('../lib/missing_validators/version', __FILE__)
 Gem::Specification.new do |gem|
   gem.authors       = ["Andrew Gridnev"]
   gem.email         = ["andrew.gridnev@gmail.com"]
-  gem.description   = %q{Validates email addresses, URLs, and inequality of attributes.}
   gem.summary       = %q{Adds some handy validators.}
+  gem.description   = %q{Validates email addresses, URLs, MAC addresses and inequality of attributes.}
   gem.homepage      = "https://github.com/andrewgr/missing_validators/"
   gem.license = 'MIT'
 

data/spec/validators/mac_address_spec.rb

@@ -0,0 +1,33 @@
+require 'spec_helper'
+
+describe MacAddressValidator do
+  context "MAC address has valid format" do
+    let(:klass) do
+      Class.new do
+        include ActiveModel::Validations
+        attr_accessor :mac, :name
+        validates :mac, mac_address: true
+      end
+    end
+
+    subject { klass.new }
+
+    it { should ensure_valid_mac_address_format_of(:mac) }
+    it { should_not ensure_valid_mac_address_format_of(:name) }
+
+    it { should allow_value("08:00:2b:01:02:03").for(:mac) }
+    it { should allow_value("08-00-2b-01-02-03").for(:mac) }
+    it { should allow_value("08002b:010203").for(:mac) }
+    it { should allow_value("08002b-010203").for(:mac) }
+    it { should allow_value("0800.2b01.0203").for(:mac) }
+    it { should allow_value("08002b010203").for(:mac) }
+
+    it { should_not allow_value("08:00:2b:01:02").for(:mac) }
+    it { should_not allow_value("08:00:2b:01:02:03:04").for(:mac) }
+    it { should_not allow_value("qq:00:00:00:00:00").for(:mac) }
+
+    it { should_not allow_value("08-00-2b-01-02").for(:mac) }
+
+    it { should_not allow_value("invalid").for(:mac) }
+  end
+end

metadata

@@ -1,61 +1,72 @@
 --- !ruby/object:Gem::Specification
 name: missing_validators
 version: !ruby/object:Gem::Version
-  version: 0.6.3
-  prerelease: 
+  version: 0.7.0
 platform: ruby
 authors:
 - Andrew Gridnev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-13 00:00:00.000000000 Z
+date: 2013-12-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70244538802020 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70244538802020
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: shoulda-matchers
-  requirement: &70244538801180 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70244538801180
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: activemodel
-  requirement: &70244538800500 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 3.0.0
   type: :runtime
   prerelease: false
-  version_requirements: *70244538800500
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.0.0
 - !ruby/object:Gem::Dependency
   name: activesupport
-  requirement: &70244538799780 !ruby/object:Gem::Requirement
-    none: false
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 3.0.0
   type: :runtime
   prerelease: false
-  version_requirements: *70244538799780
-description: Validates email addresses, URLs, and inequality of attributes.
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+description: Validates email addresses, URLs, MAC addresses and inequality of attributes.
 email:
 - andrew.gridnev@gmail.com
 executables: []
@@ -73,43 +84,46 @@ files:
 - lib/missing_validators.rb
 - lib/missing_validators/matchers/ensure_inequality_of_matcher.rb
 - lib/missing_validators/matchers/ensure_valid_email_format_of.rb
+- lib/missing_validators/matchers/ensure_valid_mac_address_format_of.rb
 - lib/missing_validators/matchers/ensure_valid_url_format_of.rb
 - lib/missing_validators/validators/email_validator.rb
 - lib/missing_validators/validators/inequality_validator.rb
+- lib/missing_validators/validators/mac_address_validator.rb
 - lib/missing_validators/validators/url_validator.rb
 - lib/missing_validators/version.rb
 - missing_validators.gemspec
 - spec/spec_helper.rb
 - spec/validators/email_validator_spec.rb
 - spec/validators/inequality_validator_spec.rb
+- spec/validators/mac_address_spec.rb
 - spec/validators/url_validator_spec.rb
 homepage: https://github.com/andrewgr/missing_validators/
 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'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.15
+rubygems_version: 2.1.11
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Adds some handy validators.
 test_files:
 - spec/spec_helper.rb
 - spec/validators/email_validator_spec.rb
 - spec/validators/inequality_validator_spec.rb
+- spec/validators/mac_address_spec.rb
 - spec/validators/url_validator_spec.rb