RailsWholeValues

Make it easier to wrap rich types in your rails models

Installation

Add this line to your application's Gemfile:

gem 'rails_values'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install rails_values

Usage

EmailAddress

class Person < ApplicationRecord
  attribute :email, :rv_email_address

  validates :email, value: true
end

p = Person.new(email: "person@email.com")
puts p.email.subdomain # "email.com"
puts p.email.another_with_same_domain("other") # "other@email.com"
puts p.email.free_email? # true
puts p.email.free_email? # true

PublicDomainSuffix

uses https://github.com/weppos/publicsuffix-ruby under the hood

class Company < ApplicationRecord
  attribute :domain_suffix, :rv_public_domain_suffix

  validates :domain_suffix, value: true
end

c = Company.new(domain: "www.example.com")
puts c.domain_suffix.local_email("test") # RailsValues::EmailAddress(test@example.com)
puts c.domain_suffix.tld # "com"
puts c.domain_suffix.sld # "example"
puts c.domain_suffix.trd # "www"
puts c.domain_suffix.free_email? # false
puts c.domain_suffix.domain # RailsValues::PublicDomainSuffix(example.com)
puts c.domain_suffix.subdomain # RailsValues::PublicDomainSuffix(www.example.com)

Subdomain

class Company < ApplicationRecord
  attribute :subdomain, :rv_subdomain

  validates :subdomain, value: true
end

c = Company.new(subdomain: "example.com")
puts c.subdomain.local_email("test") # "test@example.com"
puts c.subdomain.parts # ["example", "com"]
puts c.subdomain.free_email? # false

Development

Make sure following passing before committing

COVERAGE=1 bin/rspec
bin/rubocop -a

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/rails_whole_values.