hash_validator 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 204abb59a31b60ea1e62d18d370ff1140f6190e83aa35a989f771fcd4986d5d8
-  data.tar.gz: 8369e8089adfe5d612bca0596d95594816fc8923216a58a50302ad8cc11a1c51
+  metadata.gz: 30fa62bd65cac6823fc1de4b4039397e3926d9a141d758523db6cec2c6837042
+  data.tar.gz: 444275199c9e1a25cc7966ea32776923b2d988d1a881dcfb1f2d7bebea62641c
 SHA512:
-  metadata.gz: 0663b18d2799515a852b71ef70c69f8153d80c521afbb5fd88904ce8b6d3502fa903c4cb598251eed41e0a287fd69915de535ab49f71c11b04827073625b2e37
-  data.tar.gz: 23d774f32abb66ad78a6bf63e26dc7533935884792146f6d29cfff50adf7517a8fe5d8d3b20922c4f23c45767a87de42dba2ca9cc56b14477d1302ec5f63ba62
+  metadata.gz: 937942a775e75724c7e04eeecabd15ce1fb796ce25838de469508120e0fc78d7890d3bb3210f4bfa7c2ee74a528cb7a1b501e02b587a5b35a565b510b9d1072b
+  data.tar.gz: 1a894031114c6a2a72bc6ca4f03e33190e6466355b053a08b0728a28d89ceda98ceb65c77d948a148bef99bf55cbf8025a554d90a1cc3e691d24417a8c176301

data/.github/workflows/ruby.yml

@@ -0,0 +1,27 @@
+name: Test
+
+on:
+  push:
+    branches: [ "master" ]
+  pull_request:
+    branches: [ "master" ]
+
+permissions:
+  contents: read
+
+jobs:
+  spec:
+    name: "RSpec / Ruby ${{ matrix.ruby }}"
+    runs-on: ubuntu-24.04
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ["3.0", "3.1", "3.2", "3.3", "3.4"]
+    steps:
+      - run: sudo apt-get install libcurl4-openssl-dev
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - run: bundle exec rake spec

data/.ruby-version

@@ -1 +1 @@
-2.7.1
+3.0.7

data/Plan.md

@@ -0,0 +1,309 @@
+# Hash Validator Enhancement Plan - Living Document
+
+## Document Instructions
+**This is a living plan document.** It should be updated throughout the implementation process to track:
+- Current progress and completion status
+- Any deviations or improvements discovered during implementation
+- Lessons learned that may benefit subsequent phases
+- Test results and quality check outcomes
+
+**Update Protocol:**
+1. Mark tasks as `[x]` when completed
+2. Add notes in **Implementation Notes** sections for important discoveries
+3. Update status indicators for each phase
+4. Document any blockers or changes in approach
+
+## Overall Objective
+Add 11 new validators to the hash_validator gem to expand its validation capabilities for common use cases.
+
+## Phase Structure
+Between each major phase:
+1. Run full test suite: `rake spec`
+2. Verify no breaking changes to existing functionality
+3. Provide summary to user
+4. Request approval before proceeding to next phase
+
+---
+
+## Phase 1: Simple String Pattern Validators
+**Status:** [ ] Not Started | [ ] In Progress | [x] Completed
+**Validators:** URL, JSON, Hex Color, Alphanumeric, Alpha, Digits
+
+### Tasks:
+- [x] Create URL validator (`lib/hash_validator/validators/url_validator.rb`)
+  - Validation: Use `URI.parse` and check for valid scheme
+  - Error message: "is not a valid URL"
+  - Accept: http, https, ftp schemes
+  
+- [x] Create JSON validator (`lib/hash_validator/validators/json_validator.rb`)
+  - Validation: `JSON.parse(value)` with rescue
+  - Error message: "is not valid JSON"
+  - Must be string type first
+  
+- [x] Create Hex Color validator (`lib/hash_validator/validators/hex_color_validator.rb`)
+  - Validation: Regex `/\A#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})\z/`
+  - Error message: "is not a valid hex color"
+  - Accept: #RGB and #RRGGBB formats
+  
+- [x] Create Alphanumeric validator (`lib/hash_validator/validators/alphanumeric_validator.rb`)
+  - Validation: Regex `/\A[a-zA-Z0-9]+\z/`
+  - Error message: "must contain only letters and numbers"
+  
+- [x] Create Alpha validator (`lib/hash_validator/validators/alpha_validator.rb`)
+  - Validation: Regex `/\A[a-zA-Z]+\z/`
+  - Error message: "must contain only letters"
+  
+- [x] Create Digits validator (`lib/hash_validator/validators/digits_validator.rb`)
+  - Validation: Regex `/\A\d+\z/`
+  - Error message: "must contain only digits"
+
+### Tests:
+- [x] Write specs for each validator in `spec/validators/[validator_name]_spec.rb`
+- [x] Test valid inputs, invalid inputs, nil values, wrong types
+- [x] Run test suite and ensure all pass
+
+### Registration:
+- [x] Add requires to `lib/hash_validator/validators.rb`
+- [x] Ensure validators auto-register via `HashValidator.append_validator`
+
+**Implementation Notes:**
+- **Ruby Version Updated:** Changed minimum Ruby requirement from 2.0.0 to 3.0.0 in gemspec
+- **URI Library:** Confirmed URI standard library is available in Ruby 3.0+ and works perfectly for URL validation
+- **JSON Library:** Confirmed JSON standard library is available in Ruby 3.0+ and works perfectly for JSON validation
+- **All Tests Pass:** 74 new tests added (70 validator tests + 4 Rails integration tests), all passing (451 total)
+- **Regex Patterns:** All regex patterns use `\A` and `\z` anchors for exact string matching
+- **Error Messages:** Follow established pattern ("is not a valid [type]" vs "must contain only [constraint]")
+- **Performance:** All validators use simple regex patterns for optimal performance
+- **Rails Integration:** Added ActionController::Parameters support - no more need for `.to_unsafe_h`
+- **README Updated:** Comprehensive table format with validation configs and example payloads, Rails controller example
+- **Documentation:** Added Requirements section, Quick Start, better Examples section structure
+
+---
+
+## Additional Improvements (Beyond Original Plan)
+**Status:** [x] Completed
+**Description:** Enhancements made during Phase 1 implementation
+
+### Rails Integration Enhancement:
+- [x] **ActionController::Parameters Support**: Modified hash validator to automatically detect and handle Rails params
+- [x] **Seamless Conversion**: Internally calls `.to_unsafe_h` when `ActionController::Parameters` detected
+- [x] **Backward Compatibility**: Regular Hash validation continues to work unchanged
+- [x] **Integration Tests**: Added 4 comprehensive tests for Rails params support
+
+### Documentation Improvements:
+- [x] **README Restructuring**: Better flow from Installation → Quick Start → Examples → Usage Table → Advanced Features
+- [x] **Usage Table Enhancement**: Three-column table with Validator, Configuration, and Example Payload
+- [x] **Rails Controller Example**: Practical example showing API parameter validation
+- [x] **Requirements Section**: Added Ruby 3.0+ requirement documentation
+- [x] **Quick Start Guide**: Simple 4-line example to get users started immediately
+
+### Quality Improvements:
+- [x] **Test Coverage**: Increased from 447 to 451 total tests
+- [x] **Error Handling**: Verified all new validators provide clear, consistent error messages
+- [x] **Performance**: All new validators use efficient regex patterns
+- [x] **Integration**: Full compatibility testing with existing codebase
+
+**Implementation Notes:**
+- **Rails Support**: Uses `defined?(ActionController::Parameters)` for safe detection without requiring Rails
+- **User Experience**: Rails developers can now use `HashValidator.validate(params, validations)` directly
+- **Maintenance**: No breaking changes introduced, all existing APIs remain unchanged
+
+---
+
+## Phase 2: IP Address Validators
+**Status:** [ ] Not Started | [ ] In Progress | [ ] Completed
+**Validators:** IP (generic), IPv4, IPv6
+
+### Tasks:
+- [ ] Create IPv4 validator (`lib/hash_validator/validators/ipv4_validator.rb`)
+  - Validation: Check 4 octets, each 0-255
+  - Regex: `/\A(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\z/`
+  - Error message: "is not a valid IPv4 address"
+  
+- [ ] Create IPv6 validator (`lib/hash_validator/validators/ipv6_validator.rb`)
+  - Validation: Standard IPv6 format including compressed notation
+  - Consider using `IPAddr` class for validation
+  - Error message: "is not a valid IPv6 address"
+  
+- [ ] Create IP validator (`lib/hash_validator/validators/ip_validator.rb`)
+  - Validation: Accept either IPv4 or IPv6
+  - Can leverage IPv4 and IPv6 validators
+  - Error message: "is not a valid IP address"
+
+### Tests:
+- [ ] Test standard IPv4 addresses (192.168.1.1)
+- [ ] Test IPv6 addresses (standard and compressed)
+- [ ] Test edge cases (0.0.0.0, 255.255.255.255, ::1)
+- [ ] Test invalid formats
+
+### Registration:
+- [ ] Add requires to `lib/hash_validator/validators.rb`
+
+**Implementation Notes:**
+<!-- Add discoveries and changes here during implementation -->
+
+---
+
+## Phase 3: Parameterized Validators - Length
+**Status:** [ ] Not Started | [ ] In Progress | [ ] Completed
+**Validators:** Length with min/max/exactly options
+
+### Tasks:
+- [ ] Create Length validation class (`lib/hash_validator/validations/length.rb`)
+  - Similar structure to `Optional`, `Many`, `Multiple` classes
+  - Store min, max, exactly options
+  
+- [ ] Create Length validator (`lib/hash_validator/validators/length_validator.rb`)
+  - Handle strings, arrays, hashes
+  - Support options: `min`, `max`, `exactly`
+  - Dynamic error messages based on constraints
+  
+- [ ] Add factory method to `lib/hash_validator.rb`:
+  ```ruby
+  def self.length(options)
+    Validations::Length.new(options)
+  end
+  ```
+
+### Usage Examples:
+```ruby
+HashValidator.length(min: 5, max: 10)
+HashValidator.length(exactly: 8)
+HashValidator.length(min: 5)
+```
+
+### Tests:
+- [ ] Test all option combinations
+- [ ] Test with strings, arrays, hashes
+- [ ] Test boundary conditions
+- [ ] Test invalid option combinations
+
+**Implementation Notes:**
+<!-- Add discoveries and changes here during implementation -->
+
+---
+
+## Phase 4: Parameterized Validators - Numeric Ranges
+**Status:** [ ] Not Started | [ ] In Progress | [ ] Completed
+**Validators:** Between, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual
+
+### Tasks:
+- [ ] Create Range validation classes in `lib/hash_validator/validations/`:
+  - `between.rb` - Between two values (inclusive)
+  - `greater_than.rb` - Greater than value
+  - `less_than.rb` - Less than value
+  - `greater_than_or_equal.rb` - Greater than or equal
+  - `less_than_or_equal.rb` - Less than or equal
+  
+- [ ] Create corresponding validators in `lib/hash_validator/validators/`
+  
+- [ ] Add factory methods to `lib/hash_validator.rb`:
+  ```ruby
+  def self.between(min, max)
+    Validations::Between.new(min, max)
+  end
+  
+  def self.greater_than(value)
+    Validations::GreaterThan.new(value)
+  end
+  # ... etc
+  ```
+
+### Usage Examples:
+```ruby
+HashValidator.between(1, 100)
+HashValidator.greater_than(0)
+HashValidator.less_than_or_equal(100)
+```
+
+### Tests:
+- [ ] Test numeric types (Integer, Float, Rational)
+- [ ] Test boundary values
+- [ ] Test with non-numeric types
+- [ ] Test with nil
+
+**Implementation Notes:**
+<!-- Add discoveries and changes here during implementation -->
+
+---
+
+## Phase 5: Documentation and Final Testing
+**Status:** [ ] Not Started | [ ] In Progress | [ ] Completed
+
+### Tasks:
+- [ ] Update README.md with all new validators
+  - Add to simple types list
+  - Add to "Additional validations" section
+  - Provide usage examples for each
+  
+- [ ] Update CLAUDE.md if needed
+  
+- [ ] Run full test suite
+  
+- [ ] Check for any performance impacts
+  
+- [ ] Verify backward compatibility
+
+### Documentation Sections to Update:
+- [ ] Usage section - add new simple validators
+- [ ] Additional validations - add parameterized validators
+- [ ] Examples section - comprehensive examples
+
+**Implementation Notes:**
+<!-- Add discoveries and changes here during implementation -->
+
+---
+
+## Quality Checklist (Run after each phase)
+- [ ] All new tests pass
+- [ ] All existing tests still pass
+- [ ] No rubocop/style violations (if configured)
+- [ ] Documentation is updated
+- [ ] Code follows existing patterns
+
+## Technical Decisions & Rationale
+
+### Pattern Consistency
+All validators follow the existing pattern:
+1. Inherit from `HashValidator::Validator::Base`
+2. Initialize with validator name
+3. Implement `validate` method
+4. Auto-register using `HashValidator.append_validator`
+
+### Error Message Style
+Consistent with existing validators:
+- Simple validators: "is not a valid [type]"
+- Constraint validators: "must be [constraint]"
+- Type validators: "[type] required"
+
+### Validation Approach
+- **URL**: Use Ruby's built-in `URI.parse` for robustness
+- **IP Addresses**: Regex for IPv4, consider `IPAddr` for IPv6
+- **JSON**: Use `JSON.parse` with exception handling
+- **Patterns**: Simple regex patterns for performance
+
+### File Organization
+- Simple validators: `lib/hash_validator/validators/[name]_validator.rb`
+- Parameterized validations: `lib/hash_validator/validations/[name].rb`
+- Tests mirror structure: `spec/validators/[name]_spec.rb`
+
+## Notes for Future Sessions
+When resuming work on this plan:
+1. Check this document's status indicators
+2. Review Implementation Notes for each completed phase
+3. Run test suite to verify current state
+4. Continue from the next uncompleted task
+
+## Completion Criteria
+- [x] Phase 1: All 6 string pattern validators implemented and tested
+- [ ] Phase 2: All 3 IP address validators implemented and tested  
+- [ ] Phase 3: Length validator implemented and tested
+- [ ] Phase 4: All 5 numeric range validators implemented and tested
+- [x] README fully updated with new validators and Rails integration
+- [x] All tests passing (451/451)
+- [x] Rails ActionController::Parameters support added
+- [x] Ruby 3.0+ minimum version requirement updated
+- [ ] Gem builds successfully
+- [ ] Version bump considered
+
+**Progress: Phase 1 Complete (6/11 validators) + Major Rails Integration Enhancement**

data/README.md

@@ -1,12 +1,15 @@
 # Hash Validator
 
 [![Gem](https://img.shields.io/gem/v/hash_validator.svg)](https://rubygems.org/gems/hash_validator)
-[![Travis](https://travis-ci.org/jamesbrooks/hash_validator.svg)](https://travis-ci.org/jamesbrooks/hash_validator)
-[![Coveralls](https://img.shields.io/coveralls/jamesbrooks/hash_validator.svg)](https://coveralls.io/r/jamesbrooks/hash_validator)
+![Unit Tests](https://github.com/jamesbrooks/hash_validator/actions/workflows/ruby.yml/badge.svg)
 [![Maintainability](https://api.codeclimate.com/v1/badges/dc6edc1b240860c5f5d9/maintainability)](https://codeclimate.com/github/JamesBrooks/hash_validator/maintainability)
 
 Ruby library to validate hashes (Hash) against user-defined requirements
 
+## Requirements
+
+* Ruby 3.0+
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -21,76 +24,183 @@ Or install it yourself as:
 
     $ gem install hash_validator
 
-## Example
+## Quick Start
 
 ```ruby
-# Validations hash
-validations = {
+require 'hash_validator'
+
+# Define validation rules
+validations = { name: 'string', age: 'integer', email: 'email' }
+
+# Validate a hash
+validator = HashValidator.validate(
+  { name: 'John', age: 30, email: 'john@example.com' },
+  validations
+)
+
+validator.valid?  # => true
+```
+
+## Examples
+
+### Successful Validation
+```ruby
+validations = { name: 'string', active: 'boolean', tags: 'array' }
+hash = { name: 'Product', active: true, tags: ['new', 'featured'] }
+
+validator = HashValidator.validate(hash, validations)
+validator.valid?  # => true
+validator.errors  # => {}
+```
+
+### Failed Validation
+```ruby
+validations = { 
   user: {
-    first_name: String,
-    last_name:  'string',
-    age:        'numeric',
-    likes:      'array'
+    first_name: 'string',
+    age: 'integer',
+    email: 'email'
   }
 }
 
-# Hash to validate
-hash = {
-  foo: 1,
-  bar: 'baz',
+hash = { 
   user: {
     first_name: 'James',
-    last_name:  12345
+    age: 'thirty',  # Should be integer
+    # email missing
   }
 }
 
 validator = HashValidator.validate(hash, validations)
+validator.valid?  # => false
+validator.errors  # => { user: { age: "integer required", email: "email required" } }
+```
 
-validator.valid?
-  # => false
-
-validator.errors
-  # {
-      :user => {
-          :last_name => "string required",
-                :age => "numeric required",
-              :likes => "array required"
+### Rails Controller Example
+```ruby
+class UsersController < ApplicationController
+  def create
+    validations = {
+      user: {
+        name: 'string',
+        email: 'email',
+        age: 'integer',
+        website: 'url',
+        preferences: {
+          theme: ['light', 'dark'],
+          notifications: 'boolean'
+        }
       }
     }
+    
+    validator = HashValidator.validate(params, validations)
+    
+    if validator.valid?
+      user = User.create(params[:user])
+      render json: { user: user }, status: :created
+    else
+      render json: { errors: validator.errors }, status: :unprocessable_entity
+    end
+  end
+end
+
+# Example request that would pass validation:
+# POST /users
+# {
+#   "user": {
+#     "name": "John Doe",
+#     "email": "john@example.com", 
+#     "age": 30,
+#     "website": "https://johndoe.com",
+#     "preferences": {
+#       "theme": "dark",
+#       "notifications": true
+#     }
+#   }
+# }
 ```
 
 ## Usage
 
-Define a validation hash which will be used to validate. This has can be nested as deeply as required using the following values to validate specific value types:
+Define a validation hash which will be used to validate. This hash can be nested as deeply as required using the following validators:
+
+| Validator | Validation Configuration | Example Valid Payload |
+|-----------|-------------------------|----------------------|
+| `alpha` | `{ name: 'alpha' }` | `{ name: 'James' }` |
+| `alphanumeric` | `{ username: 'alphanumeric' }` | `{ username: 'user123' }` |
+| `array` | `{ tags: 'array' }` | `{ tags: ['ruby', 'rails'] }` |
+| `boolean` | `{ active: 'boolean' }` | `{ active: true }` |
+| `complex` | `{ number: 'complex' }` | `{ number: Complex(1, 2) }` |
+| `digits` | `{ zip_code: 'digits' }` | `{ zip_code: '12345' }` |
+| `email` | `{ contact: 'email' }` | `{ contact: 'user@example.com' }` |
+| `enumerable` | `{ status: ['active', 'inactive'] }` | `{ status: 'active' }` |
+| `float` | `{ price: 'float' }` | `{ price: 19.99 }` |
+| `hex_color` | `{ color: 'hex_color' }` | `{ color: '#ff0000' }` |
+| `integer` | `{ age: 'integer' }` | `{ age: 25 }` |
+| `json` | `{ config: 'json' }` | `{ config: '{"theme": "dark"}' }` |
+| `numeric` | `{ score: 'numeric' }` | `{ score: 95.5 }` |
+| `range` | `{ priority: 1..10 }` | `{ priority: 5 }` |
+| `rational` | `{ ratio: 'rational' }` | `{ ratio: Rational(3, 4) }` |
+| `regexp` | `{ code: /^[A-Z]{3}$/ }` | `{ code: 'ABC' }` |
+| `required` | `{ id: 'required' }` | `{ id: 'any_value' }` |
+| `string` | `{ title: 'string' }` | `{ title: 'Hello World' }` |
+| `symbol` | `{ type: 'symbol' }` | `{ type: :user }` |
+| `time` | `{ created_at: 'time' }` | `{ created_at: Time.now }` |
+| `url` | `{ website: 'url' }` | `{ website: 'https://example.com' }` |
+
+For hash validation, use nested validations or `{}` to just require a hash to be present.
+
+## Advanced Features
+
+### Class Validation
+On top of the pre-defined validators, classes can be used directly to validate the presence of a value of a specific class:
 
-* `array`
-* `boolean`
-* `complex`
-* `enumerable`
-* `float`
-* `integer`
-* `numeric`
-* `range`
-* `rational`
-* `regexp`
-* `string`
-* `symbol`
-* `time`
-* `required`: just requires any value to be present for the designated key.
-* hashes are validates by nesting validations, or if just the presence of a hash is required `{}` can be used.
+```ruby
+validations = { created_at: Time, user_id: Integer }
+hash = { created_at: Time.now, user_id: 123 }
+HashValidator.validate(hash, validations).valid?  # => true
+```
+
+### Enumerable Validation
+Validate that a value is contained within a supplied enumerable:
+
+```ruby
+validations = { status: ['active', 'inactive', 'pending'] }
+hash = { status: 'active' }
+HashValidator.validate(hash, validations).valid?  # => true
+```
 
-On top of the pre-defined simple types, classes can be used directly (e.g. String) to validate the presence of a value of a desired class.
+### Lambda/Proc Validation
+Use custom logic with lambdas or procs (must accept only one argument):
+
+```ruby
+validations = { age: ->(value) { value.is_a?(Integer) && value >= 18 } }
+hash = { age: 25 }
+HashValidator.validate(hash, validations).valid?  # => true
+```
+
+### Regular Expression Validation
+Validate that a string matches a regex pattern:
+
+```ruby
+validations = { product_code: /^[A-Z]{2}\d{4}$/ }
+hash = { product_code: 'AB1234' }
+HashValidator.validate(hash, validations).valid?  # => true
+```
 
-Additional validations exist to validate beyond simple typing, such as:
+### Multiple Validators
+Apply multiple validators to a single key:
 
-* An Enumerable instance: validates that the value is contained within the supplied enumerable.
-* A lambda/Proc instance: validates that the lambda/proc returns true when the value is supplied (lambdas must accept only one argument).
-* A regexp instance: validates that the regex returns a match when the value is supplied (Regexp#match(value) is not nil).
-* `email`: email address validation (string + email address).
+```ruby
+HashValidator.validate(
+  { score: 85 },
+  { score: HashValidator.multiple('numeric', 1..100) }
+).valid?  # => true
+```
 
-Example use-cases include Ruby APIs (I'm currently using it in a Rails API that I'm building for better error responses to developers).
+This is particularly useful when combining built-in validators with custom validation logic.
 
-## Custom validations
+## Custom Validations
 
 Allows custom defined validations (must inherit from `HashValidator::Validator::Base`). Example:
 
@@ -117,19 +227,6 @@ validator.valid?  # => true
 validator.errors  # => {}
 ```
 
-## Multiple validators
-
-Multiple validators can be applied to a single key, e.g.
-
-```ruby
-HashValidator.validate(
-  { foo: 73 },
-  { foo: HashValidator.multiple('numeric', 1..100) }
-)
-```
-
-This is particularly useful when defining custom validators.
-
 ## Contributing
 
 1. Fork it

data/hash_validator.gemspec

@@ -13,13 +13,13 @@ Gem::Specification.new do |spec|
   spec.homepage      = "https://github.com/JamesBrooks/hash_validator"
   spec.license       = "MIT"
 
-  spec.files         = `git ls-files`.split($/)
-  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-  spec.require_paths = ["lib"]
+  spec.required_ruby_version = ">= 3.0.0"
+  spec.files                 = `git ls-files`.split($/)
+  spec.executables           = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files            = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths         = ["lib"]
 
   spec.add_development_dependency 'bundler', '~> 2.1'
   spec.add_development_dependency 'rake'
   spec.add_development_dependency 'rspec', '~> 3.10'
-  spec.add_development_dependency 'coveralls'
 end

data/lib/hash_validator/validators/alpha_validator.rb

@@ -0,0 +1,23 @@
+class HashValidator::Validator::AlphaValidator < HashValidator::Validator::Base
+  def initialize
+    super('alpha')  # The name of the validator
+  end
+
+  def presence_error_message
+    'must contain only letters'
+  end
+
+  def validate(key, value, _validations, errors)
+    unless value.is_a?(String) && valid_alpha?(value)
+      errors[key] = presence_error_message
+    end
+  end
+
+  private
+
+  def valid_alpha?(value)
+    /\A[a-zA-Z]+\z/.match?(value)
+  end
+end
+
+HashValidator.append_validator(HashValidator::Validator::AlphaValidator.new)

data/lib/hash_validator/validators/alphanumeric_validator.rb

@@ -0,0 +1,23 @@
+class HashValidator::Validator::AlphanumericValidator < HashValidator::Validator::Base
+  def initialize
+    super('alphanumeric')  # The name of the validator
+  end
+
+  def presence_error_message
+    'must contain only letters and numbers'
+  end
+
+  def validate(key, value, _validations, errors)
+    unless value.is_a?(String) && valid_alphanumeric?(value)
+      errors[key] = presence_error_message
+    end
+  end
+
+  private
+
+  def valid_alphanumeric?(value)
+    /\A[a-zA-Z0-9]+\z/.match?(value)
+  end
+end
+
+HashValidator.append_validator(HashValidator::Validator::AlphanumericValidator.new)