split_dmy 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 31735b92deac70f49b3d910445e504f16d818a62
+  data.tar.gz: 19083a589f95add2d3e1610c1d8ea6ba8e60f4d0
+SHA512:
+  metadata.gz: 8b30f8b20a42374ddef4a4e3ca84bf7b8e93a373d24ef125df141463d0f0ef22a096f829975268dde58e5be1fbe2a781875fa26a89152a0ab9a877629bef575f
+  data.tar.gz: 98a9addb8fc1f2855c8595e5c20f586f60a5d577ac1aa3b46959e3a153696b1ca53f258bba06f5d24d8c60690198155d9efa8baa222e679cc07d95500f831b4a

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.rubocop.yml

@@ -0,0 +1,145 @@
+AllCops:
+  # Exclude anything that isn't really part of our code.
+  # rails_helper is excluded because it's full of solecisms, but it's mostly
+  # generated code and copy-and-pasted snipets from READMEs.
+  Exclude:
+    - 'Guardfile'
+    - 'vendor/**/*'
+    - 'db/**/*'
+    - 'bin/**/*'
+    - '**/*.gemspec'
+    - '**/Rakefile'
+    - '**/Vagrantfile'
+    - 'spec/rails_helper.rb'
+    - 'lib/tasks/cucumber.rake'
+    - 'features/support/env.rb'
+    - 'script/cucumber'
+    - 'lib/log_stuff.rb'
+
+  RunRailsCops: true
+
+# Allow long lines in specs, as it's almost impossible to fit RSpec's
+# expectations into 80 characters.
+Metrics/LineLength:
+  Max: 80
+  Exclude:
+    - 'spec/**/*'
+
+# Allow expect {}.to blocks in specs
+# but not in the code
+Style/BlockDelimiters:
+  Enabled: true
+  Exclude:
+    - 'spec/**/*'
+
+# Don't worry about long methods in specs.
+Metrics/MethodLength:
+  Exclude:
+    - 'spec/**/*'
+    - 'app/models/ability.rb'
+    - 'config/initializers/markdown_handler.rb'
+
+# No need to check for describe class param in support files.
+RSpec/DescribeClass:
+  Exclude:
+    - spec/support/**/*
+    - spec/views/**/*
+
+RSpec/FilePath:
+  Exclude:
+    - spec/routing/**/*
+
+# private/protected/public
+Style/AccessModifierIndentation:
+  EnforcedStyle: indent
+
+# Just indent parameters by two spaces. It's less volatile if methods change,
+# and there's less busy work lining things up.
+Style/AlignParameters:
+  EnforcedStyle: with_fixed_indentation
+
+Style/ClassAndModuleChildren:
+  EnforcedStyle: nested
+  Exclude:
+    - app/controllers/users/invitations_controller.rb
+
+Style/CollectionMethods:
+  PreferredMethods:
+    collect: 'map'
+    collect!: 'map!'
+    each_with_object: 'inject'
+    inject: 'inject'
+    reduce: 'inject'
+    detect: 'find'
+    find_all: 'select'
+
+# Chain methods with trailing dots.
+Style/DotPosition:
+  EnforcedStyle: trailing
+
+# No, we don't prefer each_with_object
+Style/EachWithObject:
+  Enabled: false
+
+# Prefer blank line after class/module start.
+Style/EmptyLinesAroundClassBody:
+  Enabled: false
+
+Style/EmptyLinesAroundModuleBody:
+  Enabled: false
+
+Style/EmptyLinesAroundBlockBody:
+  Enabled: false
+
+# We have a mixture at the moment, so don't enforce anything.
+Style/FormatString:
+  Enabled: false
+
+# It's not really clearer to replace every if with a return if.
+Style/GuardClause:
+  Enabled: false
+
+# Groups of three is not always the right thing for numeric literals
+Style/NumericLiterals:
+  Enabled: false
+
+# Percent-formatting and hash interpolation both have their place. Don't
+# enforce any particular one.
+Style/StringLiterals:
+  Enabled: false
+
+# I'm happy with raise, thanks.
+Style/SignalException:
+  Enabled: false
+
+# Let us use foo? methods
+Style/TrivialAccessors:
+  AllowPredicates: true
+
+# Prefer sensible naming to comments everywhere.
+Documentation:
+  Description: Document classes and non-namespace modules.
+  Enabled: false
+
+# Would enforce do_y if x over if x / do y / end. As with GuardClause above,
+# this enforces code organisation that doesn't necesarily make things clearer.
+IfUnlessModifier:
+  Enabled: false
+
+# Allow safe assignment in conditions.
+Lint/AssignmentInCondition:
+  AllowSafeAssignment: false
+
+# Just a preference to use %w[] over %w()
+Style/PercentLiteralDelimiters:
+  PreferredDelimiters:
+    '%w': '[]'
+    '%W': '[]'
+    '%i': '[]'
+
+# %w doesn't always make for clearer test data
+Style/WordArray:
+  Exclude:
+    - 'spec/**/*'
+
+require: rubocop-rspec

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+sudo: false
+rvm:
+- 2.2.1
+addons:
+  code_climate:
+    repo_token: 1e83d7ee8b8763f4fe70f376aba2c6857931a4373929796fa4093b2c8b3f5a93

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in split_dmy.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Colin Bruce
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,67 @@
+# SplitDmy
+[![Build Status](https://travis-ci.org/CeeBeeUK/split_dmy.svg?branch=master)](https://travis-ci.org/CeeBeeUK/split_dmy)
+[![Code Climate](https://codeclimate.com/github/CeeBeeUK/split_dmy/badges/gpa.svg)](https://codeclimate.com/github/CeeBeeUK/split_dmy)
+[![Test Coverage](https://codeclimate.com/github/CeeBeeUK/split_dmy/badges/coverage.svg)](https://codeclimate.com/github/CeeBeeUK/split_dmy/coverage)
+
+[![security](https://hakiri.io/github/CeeBeeUK/split_dmy/master.svg)](https://hakiri.io/github/CeeBeeUK/split_dmy/master)
+[![Stories in Ready](https://badge.waffle.io/CeeBeeUK/split_dmy.svg?label=ready&title=Ready)](http://waffle.io/CeeBeeUK/split_dmy) 
+
+Allow splitting a date field into constituent day, month and year parts.
+
+Splitting dates into constituent parts is recommended by the GOV.UK 
+[service manual](https://www.gov.uk/service-manual/user-centred-design/resources/patterns/dates.html#memorable-dates) 
+this gem is designed to allow a simple method of displaying the split date on a view, without having 
+to manually de and re-compose the date in the controller.
+
+This gem was inspired by [TimeSplitter](https://github.com/shekibobo/time_splitter) 
+by [shekibobo](https://github.com/shekibobo), in turn based on 
+[SplitDatetime](https://github.com/michihuber/split_datetime) 
+by [Michi Huber](https://github.com/michihuber).
+ 
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'split_dmy'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install split_dmy
+
+## Usage
+
+After bundling, assuming you have a person model with a date_of_birth attribute, add this to your model:
+```ruby
+class Person < ActiveRecord::Base
+  extend SplitDmy::Accessors
+  split_dmy_accessor :date_of_birth
+end
+```
+
+In your view (if using slim):
+```ruby
+= form_for(@person) do |f|
+  = f.text_field :date_of_birth_day
+  = f.text_field :date_of_birth_month
+  = f.text_field :date_of_birth_year
+```
+
+In your controller, add the new variables to the strong parameter list
+```ruby
+    params.require(:person).permit(:name, :date_of_birth_day, :date_of_birth_month, :date_of_birth_year)
+```
+
+
+## Contributing
+
+1. Fork it ( https://github.com/ceebeeuk/split-date-dmy/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require 'rubocop/rake_task'
+
+RuboCop::RakeTask.new
+RSpec::Core::RakeTask.new
+
+task :default => [:rubocop, :spec]

data/lib/split_dmy.rb

@@ -0,0 +1,3 @@
+require 'split_dmy/date_validator'
+require 'split_dmy/split_accessors'
+require 'split_dmy/version'

data/lib/split_dmy/date_validator.rb

@@ -0,0 +1,123 @@
+module SplitDmy
+  class DateValidator
+    def initialize(object, attribute)
+      @split_day = object.instance_variable_get("@#{attribute}_day")
+      @split_month = object.instance_variable_get("@#{attribute}_month")
+      @split_year = object.instance_variable_get("@#{attribute}_year").to_i
+      @object = object
+      @attr = attribute
+    end
+
+    def partial_updated
+      bd = build_date
+      partials_valid? && bd ? bd : nil
+    end
+
+    def parse_month(val)
+      if valid_fixnum?(val, 12) || valid_numeric_string?(val, 12)
+        result = val.to_i
+      else
+        mon_name = valid_month_name?(val)
+        result = mon_name.present? ? mon_name : val
+      end
+      result.to_i
+    end
+
+    def get_partial_error(part)
+      error = "#{part} must be completed" if "@split_#{part}".to_s.empty?
+      error = "is not a valid #{part}" unless send("valid_#{part}?")
+      error
+    end
+
+    def build_date
+      date = Date.new(
+        @split_year.to_i,
+        parse_month(@split_month),
+        @split_day.to_i
+      )
+      date if partials_match_date(date)
+    rescue
+      false
+    end
+
+    def generate_errors
+      %w[day month year].each do |part|
+        error = get_partial_error(part)
+        @object.errors.add("#{@attr}_#{part}".to_sym, error) if error.present?
+      end
+
+      err = []
+      err << 'you need to provide a valid date' if all_partials_empty?
+      err << combine_partials_error if partials_valid_date_fails?
+      err
+    end
+
+    private
+
+    def partials_valid?
+      { d: valid_day?, m: valid_month?, y: valid_year? }.values.all?
+    end
+
+    def partials_valid_date_fails?
+      partials_valid? && !build_date
+    end
+
+    def combine_partials_error
+      joined_date = [@split_day, @split_month, @split_year].join('-')
+      "'#{joined_date}' is not a valid date"
+    end
+
+    def all_partials_empty?
+      [@split_day.empty?, @split_month.empty?, @split_year.empty?].values.all?
+    rescue
+      false
+    end
+
+    def partials_match_date(date)
+      date.day == @split_day.to_i &&
+        date.month == parse_month(@split_month).to_i &&
+        date.year == @split_year.to_i
+    end
+
+    def valid_day?
+      (valid_fixnum?(@split_day, 31) || valid_numeric_string?(@split_day, 31))
+    end
+
+    def valid_month?
+      (
+        valid_fixnum?(@split_month, 12) ||
+        valid_numeric_string?(@split_month, 12) ||
+        valid_month_name?(@split_month)
+      )
+    end
+
+    def valid_year?
+      (
+        valid_fixnum?(@split_year, 3333) ||
+        valid_numeric_string_year?(@split_year)
+      )
+    end
+
+    def valid_fixnum?(x, max)
+      x.is_a?(Fixnum) && x > 0 && x <= max
+    end
+
+    def valid_numeric_string?(x, max)
+      x =~ /^[0-9]{1,2}$/ && x.to_i <= max
+    end
+
+    def valid_numeric_string_year?(x)
+      x =~ /^[0-9]{4}$/ && x.to_i <= 3333 && x.to_i > 0000
+    end
+
+    def valid_month_name?(month)
+      short_months = I18n.t('date.abbr_month_names')
+      full_months  = I18n.t('date.month_names')
+      if short_months.include?(month.to_s.capitalize)
+        short_months.index(month.capitalize)
+      elsif full_months.include?(month.to_s.capitalize)
+        full_months.index(month.capitalize)
+      end
+    end
+  end
+end

data/lib/split_dmy/split_accessors.rb

@@ -0,0 +1,67 @@
+module SplitDmy
+  module SplitAccessors
+    def split_dmy_accessor(*attrs)
+      require 'split_dmy/date_validator'
+
+      attrs.each do |attr|
+        validate "validate_#{attr}_partials".to_sym
+
+        override_builtin(attr)
+        add_attr_accessors(attr)
+        extend_validation(attr)
+      end
+      add_methods
+    end
+
+    private
+
+    def extend_validation(attr)
+      define_method("validate_#{attr}_partials") do
+        dv = DateValidator.new(self, attr)
+        new_errs = dv.generate_errors
+        unless new_errs.empty?
+          errors.delete(attr.to_sym)
+          errors.add(attr.to_sym, "is not valid, #{make_sentence_of(new_errs)}")
+        end
+      end
+    end
+
+    def override_builtin(attr)
+      after_initialize do
+        full_date = send("#{attr}")
+        split_into_parts(attr, full_date) unless full_date.nil?
+      end
+
+      define_method("#{attr}=") do |val|
+        super(val)
+        split_into_parts(attr, Date.parse(val.to_s)) unless val.nil?
+      end
+    end
+
+    def add_methods
+      define_method('split_into_parts') do |attr, full_date|
+        instance_variable_set("@#{attr}_day", full_date.day)
+        instance_variable_set("@#{attr}_month", full_date.month)
+        instance_variable_set("@#{attr}_year", full_date.year)
+      end
+
+      define_method('make_sentence_of') do |errors|
+        errors.to_sentence(last_word_connector: ' and ')
+      end
+    end
+
+    def add_attr_accessors(attr)
+      %w[day month year].each do |part|
+        define_method("#{attr}_#{part}=") do |val|
+          instance_variable_set("@#{attr}_#{part}", val)
+          new = DateValidator.new(self, attr).partial_updated
+          send("#{attr}=", new)
+        end
+
+        define_method("#{attr}_#{part}") do
+          instance_variable_get("@#{attr}_#{part}")
+        end
+      end
+    end
+  end
+end

data/lib/split_dmy/version.rb

@@ -0,0 +1,3 @@
+module SplitDmy
+  VERSION = "0.1.0"
+end

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+if ENV['CODECLIMATE_REPO_TOKEN']
+  # allow Code Climate Test coverage reports to be sent
+  require 'codeclimate-test-reporter'
+  CodeClimate::TestReporter.start
+end
+
+require 'active_record'
+
+ActiveRecord::Base.establish_connection adapter: "sqlite3", database: ":memory:"
+
+load File.dirname(__FILE__) + '/support/schema.rb'
+require File.dirname(__FILE__) + '/support/models.rb'

data/spec/split_dmy/split_accessors_spec.rb

@@ -0,0 +1,343 @@
+require 'spec_helper'
+require 'split_dmy/split_accessors'
+require_relative '../../spec/support/matchers/accessors_shared'
+
+describe SplitDmy::SplitAccessors do
+  let(:model) { User.new }
+
+  describe 'test model' do
+    it 'has a date of birth field to extend' do
+      expect(model).to respond_to :date_of_birth
+    end
+    it 'responds to date_of_birth' do
+      expect(model).to have_attr_accessor :date_of_birth
+    end
+  end
+
+  describe 'after adding our gem, a model' do
+    before do
+      User.extend(described_class)
+      User.split_dmy_accessor(:date_of_birth)
+    end
+
+    ['day', 'month', 'year'].each do |part|
+      it "responds to attribute_#{part}" do
+        expect(model).to respond_to "date_of_birth_#{part}".to_sym
+      end
+
+      it "has split accessor for attribute_#{part}" do
+        expect(model).to have_attr_accessor "date_of_birth_#{part}".to_sym
+      end
+    end
+
+    describe 'split dmy methods' do
+      describe 'handles pre-set dates' do
+        describe 'passes them to the new accessors' do
+          before(:each) { model.date_of_birth = '1991-1-21' }
+
+          it 'sets the _day' do
+            expect(model.date_of_birth_day).to eq 21
+          end
+        end
+
+        context 'when object created with date' do
+          let(:model) { User.new(date_of_birth: Date.new(1992, 1, 21)) }
+
+          it 'sets the date' do
+            expect(model.date_of_birth).to eq Date.new(1992, 1, 21)
+          end
+
+          describe 'splits the partials' do
+            it 'sets the day' do
+              expect(model.date_of_birth_day).to eq 21
+            end
+
+            it 'sets the month' do
+              expect(model.date_of_birth_month).to eq 1
+            end
+
+            it 'sets the year' do
+              expect(model.date_of_birth_year).to eq 1992
+            end
+          end
+        end
+
+        describe 'allows clearing of preset data' do
+          before(:each) { model.date_of_birth = '1991-1-21' }
+
+          it 'by setting all values to nil' do
+            model.date_of_birth_day = nil
+            model.date_of_birth_month = nil
+            model.date_of_birth_year = nil
+            expect(model.date_of_birth).to be_nil
+          end
+
+          describe 'by setting' do
+            it 'day to nil' do
+              model.date_of_birth_day = nil
+              expect(model.date_of_birth).to be_nil
+            end
+            it 'month to nil' do
+              model.date_of_birth_month = nil
+              expect(model.date_of_birth).to be_nil
+            end
+            it 'year to nil' do
+              model.date_of_birth_year = nil
+              expect(model.date_of_birth).to be_nil
+            end
+          end
+        end
+      end
+
+      describe '_day' do
+        describe 'when sent numbers' do
+          describe 'between 1 and 31 is valid' do
+            it 'sets the value' do
+              (1..31).each do |i|
+                model.date_of_birth_day = i
+                expect(model.date_of_birth_day).to eq i
+              end
+            end
+          end
+
+          describe 'above accepted range' do
+            before do
+              model.date_of_birth_day = 32
+              model.valid?
+            end
+
+            it 'sets the value' do
+              expect(model.date_of_birth_day).to eq 32
+            end
+
+            it 'adds an error message' do
+              err_msg = ['is not a valid day']
+              expect(model.errors[:date_of_birth_day]).to eq err_msg
+            end
+          end
+
+          describe 'below accepted range' do
+            before { model.date_of_birth_day = 0 }
+
+            it 'sets the value' do
+              expect(model.date_of_birth_day).to eq 0
+            end
+
+            it 'makes the model invalid' do
+              expect(model).to be_invalid
+            end
+          end
+        end
+
+        describe 'when sent text' do
+          before { model.date_of_birth_day = 'first' }
+
+          it 'returns nil' do
+            expect(model.date_of_birth_day).to eq 'first'
+          end
+
+          it 'makes the model invalid' do
+            expect(model).to be_invalid
+          end
+        end
+
+        describe 'when sent nil' do
+          it 'returns nil' do
+            model.date_of_birth_day = nil
+            expect(model.date_of_birth_day).to be_nil
+          end
+        end
+      end
+
+      describe '_month' do
+        describe 'when sent numbers' do
+          describe 'between 1 and 31 is valid' do
+            it 'sets the value' do
+              (1..12).each do |i|
+                model.date_of_birth_month = i
+                expect(model.date_of_birth_month).to eq i
+              end
+            end
+          end
+
+          describe 'above accepted range' do
+            before { model.date_of_birth_month = 13 }
+
+            it 'sets the value' do
+              expect(model.date_of_birth_month).to eq 13
+            end
+
+            it 'makes the model invalid' do
+              expect(model).to be_invalid
+            end
+          end
+
+          describe 'below accepted range' do
+            before { model.date_of_birth_month = 0 }
+
+            it 'sets the value' do
+              expect(model.date_of_birth_month).to eq 0
+            end
+
+            it 'makes the model invalid' do
+              expect(model).to be_invalid
+            end
+          end
+        end
+
+        describe 'when sent text' do
+          describe 'that is a valid long month' do
+            I18n.t('date.month_names').each_with_index do |month, _index|
+              it "sending #{month} sets the month to #{month}" do
+                model.date_of_birth_month = month
+                expect(model.date_of_birth_month).to eq month unless month.nil?
+              end
+            end
+          end
+          describe 'that is a valid short month' do
+            I18n.t('date.abbr_month_names').each_with_index do |month, _index|
+              it "sending #{month} sets the month to #{month}" do
+                model.date_of_birth_month = month
+                expect(model.date_of_birth_month).to eq month unless month.nil?
+              end
+            end
+          end
+          describe 'that is not a valid month' do
+            before { model.date_of_birth_month = 'first' }
+
+            it 'returns the text' do
+              expect(model.date_of_birth_month).to eq 'first'
+            end
+
+            it 'makes the model invalid' do
+              expect(model).to be_invalid
+            end
+          end
+        end
+
+        describe 'when sent nil' do
+          it 'returns nil' do
+            model.date_of_birth_month = nil
+            expect(model.date_of_birth_month).to be_nil
+          end
+        end
+      end
+
+      describe '_year' do
+        describe 'when sent numbers' do
+          describe 'numerically' do
+            describe 'in the acceptable range' do
+              it 'sets the value' do
+                model.date_of_birth_year = 1961
+                expect(model.date_of_birth_year).to eq 1961
+              end
+            end
+            describe 'outside the acceptable range' do
+              before { model.date_of_birth_year = 3334 }
+              it 'returns nil' do
+                expect(model.date_of_birth_year).to be 3334
+              end
+
+              it 'makes the model invalid' do
+                expect(model).to be_invalid
+              end
+            end
+          end
+          describe 'as text' do
+            it 'accepts and converts them' do
+              model.date_of_birth_year = '1961'
+              expect(model.date_of_birth_year).to eq '1961'
+            end
+          end
+        end
+
+        describe 'when sent text' do
+          before { model.date_of_birth_year = 'Nineteen Sixty One' }
+
+          it 'sets the value' do
+            expect(model.date_of_birth_year).to eq 'Nineteen Sixty One'
+          end
+
+          it 'makes the model invalid' do
+            expect(model).to be_invalid
+          end
+        end
+
+        describe 'when sent nil' do
+          it 'returns nil' do
+            model.date_of_birth_year = nil
+            expect(model.date_of_birth_year).to be_nil
+          end
+        end
+      end
+
+      describe 'when passed implausible dates' do
+        before do
+          model.date_of_birth_day = 30
+          model.date_of_birth_month = 2
+          model.date_of_birth_year = 2015
+          model.valid?
+        end
+
+        it 'returns an error' do
+          err_msg = ["is not valid, '30-2-2015' is not a valid date"]
+          expect(model.errors[:date_of_birth]).to eq err_msg
+        end
+      end
+
+      describe 'set themselves but do not set date' do
+        describe '#posted_day' do
+          it 'can be set and returned' do
+            model.date_of_birth_day = 1
+            expect(model.date_of_birth_day).to eq 1
+            expect(model.date_of_birth).to be nil
+          end
+        end
+
+        describe '#posted_month' do
+          it 'can be set and returned' do
+            model.date_of_birth_month = 10
+            expect(model.date_of_birth_month).to eq 10
+            expect(model.date_of_birth).to be nil
+          end
+        end
+
+        describe '#posted_year' do
+          it 'can be set and returned' do
+            model.date_of_birth_year = 10
+            expect(model.date_of_birth_year).to eq 10
+            expect(model.date_of_birth).to be nil
+          end
+        end
+      end
+
+      describe 'set the date field by calling validate_date' do
+        context 'when all are completed' do
+          before(:each) { model.date_of_birth = nil }
+
+          it 'with year last' do
+            model.date_of_birth_day = 21
+            model.date_of_birth_month = 1
+            model.date_of_birth_year = 1961
+            expect(model.date_of_birth).to eql Date.new(1961, 1, 21)
+          end
+
+          it 'with month last' do
+            model.date_of_birth_year = 1961
+            model.date_of_birth_day = 21
+            model.date_of_birth_month = 1
+            expect(model.date_of_birth).to eql Date.new(1961, 1, 21)
+          end
+
+          it 'with day last' do
+            model.date_of_birth_month = 1
+            model.date_of_birth_year = 1961
+            model.date_of_birth_day = 21
+            expect(model.date_of_birth).to eql Date.new(1961, 1, 21)
+          end
+        end
+      end
+    end
+
+  end
+end

data/spec/support/matchers/accessors_shared.rb

@@ -0,0 +1,18 @@
+RSpec::Matchers.define :have_attr_accessor do |field|
+  match do |object_instance|
+    object_instance.respond_to?(field) &&
+      object_instance.respond_to?("#{field}=")
+  end
+
+  failure_message do |object_instance|
+    "expected attr_accessor for #{field} on #{object_instance}"
+  end
+
+  failure_message_when_negated do |object_instance|
+    "expected attr_accessor for #{field} not to be defined on #{object_instance}"
+  end
+
+  description do
+    'assert there is an attr_accessor of the given name on the supplied object'
+  end
+end

data/spec/support/models.rb

@@ -0,0 +1,2 @@
+class User < ActiveRecord::Base
+end

data/spec/support/schema.rb

@@ -0,0 +1,9 @@
+ActiveRecord::Schema.define do
+  self.verbose = false
+
+  create_table :users, force: true do |t|
+    t.date :date_of_birth
+    t.timestamps null: false
+  end
+
+end

data/split_dmy.gemspec

@@ -0,0 +1,35 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'split_dmy/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'split_dmy'
+  spec.version       = SplitDmy::VERSION
+  spec.authors       = ['Colin Bruce']
+  spec.email         = ['colinbruce@gmail.com']
+  spec.summary       = 'Add split accessors for date fields /
+                        into day, month, year parts'
+  spec.description   = <<-EOF
+    Use `split_dmy_accessor :date_of_birth`to provide `date_of_birth_day`,
+    `date_of_birth_month`, `date_of_birth_year` accessors on the model.'
+  EOF
+  spec.homepage      = 'https://github.com/CeeBeeUK/split_dmy'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  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', '~> 1.7'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.2'
+  spec.add_development_dependency 'activesupport', '~> 4.0.0'
+  spec.add_development_dependency 'activemodel', '~> 4.0.0'
+  spec.add_development_dependency 'activerecord', '~> 4.0.0'
+  spec.add_development_dependency 'sqlite3'
+  spec.add_development_dependency 'codeclimate-test-reporter'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'rubocop-rspec'
+end

metadata

@@ -0,0 +1,203 @@
+--- !ruby/object:Gem::Specification
+name: split_dmy
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Colin Bruce
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-08-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: codeclimate-test-reporter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |2
+      Use `split_dmy_accessor :date_of_birth`to provide `date_of_birth_day`,
+      `date_of_birth_month`, `date_of_birth_year` accessors on the model.'
+email:
+- colinbruce@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/split_dmy.rb
+- lib/split_dmy/date_validator.rb
+- lib/split_dmy/split_accessors.rb
+- lib/split_dmy/version.rb
+- spec/spec_helper.rb
+- spec/split_dmy/split_accessors_spec.rb
+- spec/support/matchers/accessors_shared.rb
+- spec/support/models.rb
+- spec/support/schema.rb
+- split_dmy.gemspec
+homepage: https://github.com/CeeBeeUK/split_dmy
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.4
+signing_key: 
+specification_version: 4
+summary: Add split accessors for date fields / into day, month, year parts
+test_files: []