datetime_helper 1.0.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    OTU5ZmUzODhlYmM0ZThmNjI0NGUxMTQ2YmIzZmZkZDY1NWQyZWViOA==
+  data.tar.gz: !binary |-
+    YTM0ZWE3MmEyZjljOTg2YzY4NTE0ODY1NWI3MTE5MWM5OWQyYWExNQ==
+SHA512:
+  metadata.gz: !binary |-
+    YjQ0NWIzNGE3ODk5MzA5ZTQ5NmE1M2I0NTJmNWE2YTM3OGVlOWMxNzU1ZDM1
+    MDc2YzQzZmI2YTdiNGQ2NzNjNWJiOGVjMTk4Mzg2MGMxNzM2YWJkZjFhZmY0
+    ZGMzMDk5NGViNmUyMmQzYzI5OWRlNTY0MmQ3Y2E0MzEyYWRjZjM=
+  data.tar.gz: !binary |-
+    ZjFhOTZjMzU5ZTA0N2Q2MGYzZmY3NTRmZmIxOTA1NTU0YjAwOTI2NzYxMjA4
+    ZGZkZmE1ZGMxYjllNTFlNzNhOWY3MzAwYzZiMDM4YWY1NzU2ODRhZGRiMWQ3
+    OWZkN2JjNTFmYWEwNmQzMjJiYmIwNGU2MzgxOGM5ODczZGY3ODE=

data/.gitignore

@@ -0,0 +1,43 @@
+*.gem
+*.rbc
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+.ruby-version
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+# We develop on Macs
+.DS_Store

data/.travis.yml

@@ -0,0 +1,19 @@
+language: ruby
+rvm:
+  - 2.0.0-p598
+  - 2.1.0
+  - 2.1.1
+  - 2.1.2
+  - 2.1.4
+  - 2.2.0
+  - 2.2.1
+  - 2.2.2
+before_install:
+- gem install bundler
+- export TZ=Australia/Canberra
+deploy:
+  provider: rubygems
+  api_key:
+    secure: FZVmAZ6QMTUCZU4Iogf3J+                                                                                                             DgVyqZMi353GaG1wecIejOgsZd5mcZu7j0AS2OFcU9gvoq28DG3v0aM70KoFqGIgcxPoP2Y84B6USK3rpVxGxudcj6yXuVLqvLWv2l47oUTVU5Z71GL42m6UchYub23eVkZoyVTuzKUzxQ3P9nMNg=
+  on:
+    tags: true

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) 2015 Westfield Labs
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/README.md

@@ -0,0 +1,130 @@
+# The Datetime Helper
+
+A collection of useful utilities for projects that have to deal with dates, times, and time zones, with particular utility for Rails projects that enforce the use of Zulu Time.
+
+## Features
+
+1. A base method called `is_zulu_time?`, 
+2. An `rspec` matcher called `be_zulu_time`,
+3. An `ActiveModel` validator called `zulu_time`, and
+4. An `ActiveModel::Serializer` helper method called `in_zulu_time`.
+
+Each feature can be required individually so you can use the `rspec` matcher, `ActiveModel` validator, or `ActiveModel::Serializer` helper in isolation.
+
+[![Build Status](https://travis-ci.org/westfieldlabs/datetime_helper.svg?branch=master)](https://travis-ci.org/westfieldlabs/datetime_helper)
+
+## Requirements
+
+1. `Ruby`, `Bundler`, etc. The usual suspects. (Tested against Ruby 2.0.0 and up)
+2. `rspec` if you `require 'datetime_helper/rspec'`
+3. `active_model` if you `require 'datetime_helper/active_model'`
+4. `active_model_serializers` if you `require 'datetime_helper/active_model_serialiser'`
+
+## TL;DR
+
+Zulu Time is an ISO 8601 formatted string representing a `datetime` but in the time zone UTC+0. This makes it trivial for client applications to display dates and times correctly in their local, or other nominated time zones.
+
+Enforcing Zulu Time across a range of projects requires a common approach to validating incoming strings, representing the data internally, serialising the data back out into strings, and testing date and time fields.
+
+The `Datetime Helper` was developed to provide that common approach, and it is available as an open source project because we believe it is generically useful.
+
+## To use
+
+Put this in your `Gemfile`
+
+```ruby
+gem 'datetime_helper'
+```
+
+### Testing a string to see if it is a Zulu Time formatted string
+
+```ruby
+DatetimeHelper.is_zulu_time? "some_string"
+```
+
+### Using the `be_zulu_time` matcher in your `RSpec` tests
+
+Put this in your `spec_helper.rb` or equivalent
+
+```ruby
+require 'datetime_helper/rspec'
+
+RSpec.configure do |config|
+  config.include DatetimeHelper::Matchers
+end
+```
+
+And put this in your `rspec` tests.
+
+```ruby
+it {expect(subject[:deleted_at]).to be_zulu_time}
+```
+
+### Validating `ActiveModel` fields to ensure they hold UTC+0 `datetime` data
+
+First be sure you `require 'datetime_helper/active_model'`
+
+Then your model class can add:
+
+```ruby
+include DatetimeHelper::Validators
+
+validates :updated_at, zulu_time: true
+```
+
+This will verify that a `Time` is supplied at `UTC+0`, or that a `DateTime` has `.zone == "+00:00"`.
+
+### Enforcing `ActiveModel::Serializer`  Zulu Time string formats
+
+First be sure you `require 'datetime_helper/active_model_serialisers'`
+
+Then you can put this in your serialisers:
+
+```ruby
+extend DatetimeHelper::Serialisers
+
+in_zulu_time :updated_at
+```
+
+or if you have a bunch of 'em
+
+```ruby
+extend DatetimeHelper::Serialisers
+
+%w(updated_at deleted_at).each { |attribute| in_zulu_time attribute }
+```
+
+This will ensure that the serialised output is a proper Zulu Time formatted string.
+
+## To build
+
+```sh
+bundle install
+gem build datetime_helper.gemspec
+```
+
+## To test
+
+```sh
+bundle install
+rake
+```
+
+The tests offer insight into how to use these utilities.
+
+## To contribute
+
+Contributions are encouraged. See the [contribution instructions](contributing.md) for the preferred contribution process.
+
+## License
+
+The `Datetime Helper` is © 2015 Westfield Labs and is available for use under the [Apache 2.0](LICENSE) license.
+
+## Version history
+
+|Version| Comments                                   |
+|:------|:-------------------------------------------|
+|`0.0.1`| First draft — only the rspec matcher       |
+|`0.0.2`| Added the `ActiveModel` validator          |
+|`0.0.3`| Added the `ActiveModel::Serializer` helper |
+|`1.0.0`| Cleaned up for first official release      |

data/Rakefile

@@ -0,0 +1,12 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+task :default => [:spec]
+
+desc "Validate the gemspec"
+task :gemspec do
+  gemspec = eval(File.read(Dir["*.gemspec"].first))
+  gemspec.validate && puts('gemspec valid')
+end
+
+RSpec::Core::RakeTask.new(:spec)

data/contributing.md

@@ -0,0 +1,15 @@
+## Contributing
+
+"Brother I got a 12 step plan for you…" - The Alabama Three
+
+0. Raise an issue in this project outling the change you'd like to make. You'll need the `issue_number`
+1. Fork this project into your own Github account
+2. Create your feature branch (`git checkout -b {issue_number}_my-new-feature`)
+4. Push to the branch (`git push -u origin {issue_number}_my-new-feature`)
+5. Write rspec tests to formalise the outcomes of your change
+6. write the code to implement the changes, ensuring that the tests eventually pass
+7. Commit your changes (`git commit -am '{issue_number} Added some feature'`)
+8. Push to the branch (`git push -u origin my-new-feature`)
+9. Create a new Pull Request using Github's built-in mechanisms.
+10. Wait for a code review to come back, or an approval.
+11. Either go back and fix whatever the reviewers recommend, or watch and smile as your PR gets merged in and you become part of sotware development history.

data/datetime_helper.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'datetime_helper/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "datetime_helper"
+  spec.version       = DatetimeHelper::VERSION
+  spec.authors       = ["davesag"]
+  spec.email         = ["davesag@gmail.com"]
+  spec.summary       = "A collection of useful helpers for projects which have to deal with dates, times, and time zones."
+  spec.description   = "The `Datetime Helper` was developed to provide a common approach to validating incoming datetime data, representing that data internally, serialising it back out into strings, and testing of date and time fields."
+  spec.homepage      = "https://github.com/westfieldlabs/datetime_helper"
+  spec.license       = "Apache 2.0"
+
+  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_runtime_dependency 'rspec',       '~> 3'
+  spec.add_runtime_dependency 'activemodel', '~> 4'
+  spec.add_runtime_dependency 'active_model_serializers'
+
+  spec.add_development_dependency "bundler", "~> 1.9"
+  spec.add_development_dependency "rake", "~> 10.4"
+  spec.add_development_dependency "pry"
+  
+end

data/lib/datetime_helper/active_model.rb

@@ -0,0 +1,2 @@
+require_relative "../datetime_helper"
+require_relative "validators/zulu_time_active_model_validator"

data/lib/datetime_helper/active_model_serialiser.rb

@@ -0,0 +1,3 @@
+require 'active_model_serializers'
+require_relative "../datetime_helper"
+require_relative "serialisers/zulu_time_active_model_serialiser_helper"

data/lib/datetime_helper/matchers/zulu_time_rspec_matcher.rb

@@ -0,0 +1,8 @@
+module DatetimeHelper
+  module Matchers
+    
+    RSpec::Matchers.define :be_zulu_time do |expected|
+      match { |datetime| DatetimeHelper.is_zulu_time?(datetime) }
+    end
+  end
+end

data/lib/datetime_helper/rspec.rb

@@ -0,0 +1,2 @@
+require_relative "../datetime_helper"
+require_relative "matchers/zulu_time_rspec_matcher"

data/lib/datetime_helper/serialisers/zulu_time_active_model_serialiser_helper.rb

@@ -0,0 +1,13 @@
+# Enforces that a DateTime is serialised as zulu time
+
+module DatetimeHelper
+  module Serialisers
+
+    def enforce_zulu_time(attribute)
+      define_method(attribute) do
+        object.send(attribute).utc.iso8601 unless object.send(attribute).nil?
+      end
+    end
+
+  end
+end

data/lib/datetime_helper/validators/zulu_time_active_model_validator.rb

@@ -0,0 +1,29 @@
+# Validates that a supplied value is in fact
+# a DateTime, and is in timezone UTC+0
+require 'time'
+require 'active_model'
+
+module DatetimeHelper
+  module Validators
+    class ZuluTimeValidator < ActiveModel::EachValidator
+
+      def validate_each(record, attribute, value)
+        return if value.is_a? DateTime and utc_datetime? value
+        return if value.is_a? Time and utc_time? value
+
+        record.errors[attribute] << (options[:message] || 'is not in UTC+0 (Zulu Time)')
+      end
+
+      private
+
+      def utc_datetime?(value)
+        value.zone == "+00:00"
+      end
+
+      def utc_time?(value)
+        value.utc?
+      end
+
+    end
+  end
+end

data/lib/datetime_helper/version.rb

@@ -0,0 +1,3 @@
+module DatetimeHelper
+  VERSION = "1.0.0"
+end

data/lib/datetime_helper.rb

@@ -0,0 +1,11 @@
+require "datetime_helper/version"
+
+module DatetimeHelper
+
+  ZULU_TIME_PATTERN = /^\d{4}-[0-1][0-9]-[0-3]\d{1}T[0-2]\d{1}:[0-5]\d{1}:[0-5]\d{1}Z$/
+
+  def self.is_zulu_time?(time_string)
+    !(time_string =~ ZULU_TIME_PATTERN).nil?
+  end
+
+end

data/spec/datetime_helper_spec.rb

@@ -0,0 +1,23 @@
+require_relative 'spec_helper'
+
+describe DatetimeHelper do
+  describe '#is_zulu_time?' do
+    context "given a valid Zulu Time string" do
+      let(:valid_string) { Time.now.utc.iso8601 }
+      it { expect{ Time.parse(valid_string)}.to_not raise_error }
+      it { expect(DatetimeHelper.is_zulu_time?(valid_string)).to eq true }
+    end
+
+    context "given a valid ISO 8601 string that's not Zulu Time" do
+      let(:invalid_string) { Time.now.iso8601 }
+      it { expect{ Time.parse(invalid_string)}.to_not raise_error }
+      it { expect(DatetimeHelper.is_zulu_time?(invalid_string)).to eq false }
+    end
+
+    context "given nonsense" do
+      let(:nonsense) { "not really a zulu time string" }
+      it { expect{ Time.parse(nonsense)}.to raise_error }
+      it { expect(DatetimeHelper.is_zulu_time?(nonsense)).to eq false }
+    end
+  end
+end

data/spec/matchers/zulu_time_rspec_matcher_spec.rb

@@ -0,0 +1,13 @@
+require_relative '../spec_helper'
+
+describe 'be_zulu_time' do
+  context 'given a valid zulu time string' do
+    let(:valid_time_string) { Time.now.utc.iso8601 }
+    it { expect(valid_time_string).to be_zulu_time }
+  end
+
+  context 'given an invalid zulu time string' do
+    let(:invalid_time_string) { "This is not a zulu time string" }
+    it { expect(invalid_time_string).to_not be_zulu_time }
+  end
+end

data/spec/serialisers/zulu_time_active_model_serialiser_helper_spec.rb

@@ -0,0 +1,44 @@
+require_relative '../spec_helper'
+require "datetime_helper/active_model_serialiser"
+
+class TestSerialiser < ActiveModel::Serializer
+  extend DatetimeHelper::Serialisers
+  attributes :updated_at
+  
+  enforce_zulu_time :updated_at
+end
+
+class TestItemNoTime
+  include ActiveModel::SerializerSupport
+  attr_reader :updated_at
+  def initialize(options = {})
+    @updated_at = nil
+  end
+end
+
+class TestItem < TestItemNoTime
+  def initialize(options = {})
+    @updated_at = options[:updated_at] || Time.now.utc
+  end
+end
+
+describe DatetimeHelper::Serialisers do
+  let(:serialiser) { TestSerialiser.new(item) }
+  subject          { serialiser.attributes }
+
+  context 'with a UTC time' do
+    let(:item)     { TestItem.new }
+    it { expect(subject[:updated_at]).to be_zulu_time}
+  end
+
+  context 'with a local time' do
+    let(:item)     { TestItem.new updated_at:  Time.now.getlocal }
+    it { expect(subject[:updated_at]).to be_zulu_time}
+  end
+
+  context 'with a nil time' do
+    let(:item)     { TestItemNoTime.new }
+    it { expect(subject[:updated_at]).to be_nil}
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,26 @@
+require 'datetime_helper/rspec'
+require 'pry'  # for debugging
+require 'time' # used all over the place
+
+RSpec.configure do |config|
+
+  # If no example or groups contains the filter symbol below, then run all
+  config.run_all_when_everything_filtered = true
+  # If supplied, run only those examples and groups with the symbol below
+  # i.e. it "some text", :focus do
+  config.filter_run_including :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+
+  # Hi I'm Dave I like pretty colours.
+  config.color = true
+  config.tty = true
+  config.formatter = :documentation
+
+  config.include DatetimeHelper::Matchers
+
+end

data/spec/validators/zulu_time_active_model_validator_spec.rb

@@ -0,0 +1,60 @@
+require_relative '../spec_helper'
+require "datetime_helper/active_model"
+
+describe DatetimeHelper::Validators::ZuluTimeValidator do
+  let(:validator)      { described_class.new({attributes: [:updated_at]})}
+  let(:model)          { double('model') }
+
+  # if, by chance, you happen to be running these tests
+  # on a machine set to UTC+0 then the local time tests
+  # won't really be a valid test.
+  let(:already_in_utc) { Time.now.utc == Time.now.getlocal }
+  
+  before :each do
+    allow(model).to receive_message_chain('errors').and_return([])
+    allow(model.errors).to receive_message_chain('[]').and_return({})
+    allow(model.errors[]).to receive_message_chain('<<')
+  end
+  
+  context "given a UTC+0 Time" do
+    let(:valid_time) { Time.now.utc }
+    it "is accepted as valid" do
+      expect(model.errors[]).to_not receive('<<')
+      validator.validate_each(model, 'updated_at', valid_time)
+    end
+  end
+
+  context "given a local Time" do
+    let(:invalid_time) { Time.now.getlocal }
+    it "is not accepted as valid" do
+      pending "Local Time is UTC so skipping test" if already_in_utc
+      expect(model.errors[]).to receive('<<')
+      validator.validate_each(model, 'updated_at', invalid_time)
+    end
+  end
+
+  context "given a UTC+0 DateTime" do
+    let(:valid_time) { DateTime.now.new_offset(0) }
+    it "is accepted as valid" do
+      expect(model.errors[]).to_not receive('<<')
+      validator.validate_each(model, 'updated_at', valid_time)
+    end
+  end
+
+  context "given a local DateTime" do
+    let(:invalid_time) { DateTime.now }
+    it "is not accepted as valid" do
+      pending "Local Time is UTC so skipping test" if already_in_utc
+      expect(model.errors[]).to receive('<<')
+      validator.validate_each(model, 'updated_at', invalid_time)
+    end
+  end
+
+  context "given a String instead of a Time or DateTime" do
+    let(:nonsense) { "this makes no sense" }
+    it "is not accepted as valid" do
+      expect(model.errors[]).to receive('<<')
+      validator.validate_each(model, 'updated_at', nonsense)
+    end
+  end
+end

metadata

@@ -0,0 +1,157 @@
+--- !ruby/object:Gem::Specification
+name: datetime_helper
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- davesag
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4'
+- !ruby/object:Gem::Dependency
+  name: active_model_serializers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.9'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.4'
+- !ruby/object:Gem::Dependency
+  name: pry
+  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: The `Datetime Helper` was developed to provide a common approach to validating
+  incoming datetime data, representing that data internally, serialising it back out
+  into strings, and testing of date and time fields.
+email:
+- davesag@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- contributing.md
+- datetime_helper.gemspec
+- lib/datetime_helper.rb
+- lib/datetime_helper/active_model.rb
+- lib/datetime_helper/active_model_serialiser.rb
+- lib/datetime_helper/matchers/zulu_time_rspec_matcher.rb
+- lib/datetime_helper/rspec.rb
+- lib/datetime_helper/serialisers/zulu_time_active_model_serialiser_helper.rb
+- lib/datetime_helper/validators/zulu_time_active_model_validator.rb
+- lib/datetime_helper/version.rb
+- spec/datetime_helper_spec.rb
+- spec/matchers/zulu_time_rspec_matcher_spec.rb
+- spec/serialisers/zulu_time_active_model_serialiser_helper_spec.rb
+- spec/spec_helper.rb
+- spec/validators/zulu_time_active_model_validator_spec.rb
+homepage: https://github.com/westfieldlabs/datetime_helper
+licenses:
+- Apache 2.0
+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.5
+signing_key: 
+specification_version: 4
+summary: A collection of useful helpers for projects which have to deal with dates,
+  times, and time zones.
+test_files:
+- spec/datetime_helper_spec.rb
+- spec/matchers/zulu_time_rspec_matcher_spec.rb
+- spec/serialisers/zulu_time_active_model_serialiser_helper_spec.rb
+- spec/spec_helper.rb
+- spec/validators/zulu_time_active_model_validator_spec.rb