range_component_attributes 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8620dd0c7969d1c9e208cda4752a2a1fa4cdb50df9d7682893bbcbff1e5f33fe
+  data.tar.gz: de34c8c1ab186210b728e9c38d4f1f3c2fe53731f578f2799a1aa607b664fd04
+SHA512:
+  metadata.gz: 6f46ce5122733699261f698af2a40275ab6f4774dbc95aa72676073a604f3fbb97d54ccd6a3166e2ddad9e5c4d2f73f1558063d5f7c71a84fc117143deb9a162
+  data.tar.gz: e0e13edf7e6e434acef25d2ca50b6ff5a6846a7c835fe3e7887e7d79598209e6c78da1ffb258c9be5ec9365e7fce7758218d87db73368a03f2a6884715215bef

data/.gitignore

@@ -0,0 +1,8 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.ruby-version

@@ -0,0 +1 @@
+2.5.1

data/.travis.yml

@@ -0,0 +1,13 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.5.1
+
+addons:
+  postgresql: "9.6"
+
+before_install: gem install bundler -v 1.16.1
+
+before_script:
+  - cp spec/database.yml.travis spec/database.yml
+  - bundle exec rake db:setup

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in range_component_attributes.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,59 @@
+PATH
+  remote: .
+  specs:
+    range_component_attributes (1.0.0)
+      activerecord (>= 5.2.0)
+      activesupport (>= 5.2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activemodel (5.2.0)
+      activesupport (= 5.2.0)
+    activerecord (5.2.0)
+      activemodel (= 5.2.0)
+      activesupport (= 5.2.0)
+      arel (>= 9.0)
+    activesupport (5.2.0)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+    ansi (1.5.0)
+    arel (9.0.0)
+    builder (3.2.3)
+    coderay (1.1.2)
+    concurrent-ruby (1.0.5)
+    i18n (1.0.1)
+      concurrent-ruby (~> 1.0)
+    method_source (0.9.0)
+    minitest (5.11.3)
+    minitest-reporters (1.2.0)
+      ansi
+      builder
+      minitest (>= 5.0)
+      ruby-progressbar
+    pg (1.0.0)
+    pry (0.11.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    rake (10.5.0)
+    ruby-progressbar (1.9.0)
+    thread_safe (0.3.6)
+    tzinfo (1.2.5)
+      thread_safe (~> 0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.16)
+  minitest (~> 5.0)
+  minitest-reporters
+  pg (~> 1.0)
+  pry
+  rake (~> 10.0)
+  range_component_attributes!
+
+BUNDLED WITH
+   1.16.1

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 CCSalesPro
+
+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,102 @@
+# Range Component Attributes
+
+This gem creates attributes for the lower and upper bounds of a range on an
+ActiveRecord object. These attributes are automatically populated when a record
+is loaded and they are written to the underlying range when a record is saved.
+This makes it easier to work with ActiveRecord validations and form helpers.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'range_component_attributes'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install range_component_attributes
+
+## Usage
+
+Include `RangeComponentAttributes` module in classes you want to work with range
+components. You can include it in `ActiveRecord::Base` or `ApplicationRecord` if
+you want it available in all models.
+
+Use class method `range_component_attributes` to create range component attributes.
+
+```ruby
+class Widget < ActiveRecord::Base
+  include RangeComponentAttributes
+
+  range_component_attributes :valid_dates,
+    lower_name: :valid_from,
+    upper_name: :valid_to,
+    type_converter: DateConverter.new,
+    crossed_bounds_message: "must be less than valid to"
+
+  range_component_attributes :valid_prices,
+    lower_name: :min_price,
+    upper_name: :max_price,
+    lower_type_converter: DecimalConverter.new,
+    upper_type_converter: DecimalConverter.new(blank_value: Float::INFINITY)
+end
+
+widget = Widget.new min_price: "10", max_price: "20"
+widget.valid_prices #=> 0.1e2...0.2e2
+```
+
+range_component_attributes creates attributes corresponding to the lower and
+upper bounds of `range_name`. `lower_name` and `upper_name` controls the names
+of these attributes.
+
+`type_converter` is a callable object that converts its argument to the proper
+type. There are builtin type converters `IntegerConverter`, `DecimalConverter`,
+`FloatConverter`, and `DateConverter`.
+
+In addition, `lower_type_converter` and `upper_type_converter` can be separately
+specified. This is especially useful when the attributeould behave differently
+for blank values. For example, the upper bound mant to consider a blank value as
+Float::INFINITY.
+
+`exclude_end` controls whether the end is exclusive or not. Ranges are
+automatically normalized to this type. This is useful because PostgreSQL
+automatically normalizes ranges of discrete values to exclusive endsg. `[1, 10]`
+becomes `[1,11)`. RangeComponentAttributes will handle this so the exact bound
+values persist even when PostgreSQL has changed them.
+
+Validations are automatically added that create an error if an assignment to
+bounds attribute fails due to a type conversion error. In addition, a validation
+checks that the lower bound is less than the upper bound. This error message can
+be customized by supplying `crossed_bounds_message`.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run
+`rake test` to run the tests. You can also run `bin/console` for an interactive
+prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To
+release a new version, update the version number in `version.rb`, and then run
+`bundle exec rake release`, which will create a git tag for the version, push
+git commits and tags, and push the `.gem` file to
+[rubygems.org](https://rubygems.org).
+
+To run the tests, first run `rake db:setup`. This creates a database called
+`range_component_attributes_test` and load `database_structure.sql` into it.
+Then run `rake`.
+
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at
+https://github.com/ccsalespro/range_component_attributes.
+
+## License
+
+The gem is available as open source under the terms of the [MIT
+License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,18 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+namespace :db do
+  desc 'bootstrap database'
+  task :setup do
+    sh "createdb range_component_attributes_test || true"
+    sh "psql -f test/database_structure.sql range_component_attributes_test"
+  end
+end
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "range_component_attributes"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/range_component_attributes.rb

@@ -0,0 +1,108 @@
+require "range_component_attributes/range_wrapper"
+require "range_component_attributes/type_conversion"
+require "range_component_attributes/version"
+
+require "active_support"
+
+module RangeComponentAttributes
+  extend ActiveSupport::Concern
+
+  class_methods do
+    # range_component_attributes creates attributes corresponding to the lower
+    # and upper bounds of `range_name`. `lower_name` and `upper_name` controls
+    # the names of these attributes.
+    #
+    # `type_converter` is a callable object that converts its argument to the
+    # proper type. There are builtin type converters `IntegerConverter`,
+    # `DecimalConverter`, `FloatConverter`, and `DateConverter`.
+    #
+    # In addition, `lower_type_converter` and `upper_type_converter` can be
+    # separately specified. This is especially useful when the attributes should
+    # behave differently for blank values. For example, the upper bound may want
+    # to consider a blank value as Float::INFINITY.
+    #
+    # `exclude_end` controls whether the end is exclusive or not. Ranges are
+    # automatically normalized to this type. This is useful because PostgreSQL
+    # automatically normalizes ranges of discrete values to exclusive ends. e.g.
+    # `[1, 10]` becomes `[1,11)`. RangeComponentAttributes will handle this so
+    # the exact bound values persist even when PostgreSQL has changed them.
+    #
+    # Validations are automatically added that create an error if an assignment
+    # to bounds attribute fails due to a type conversion error. In addition, a
+    # validation checks that the lower bound is less than the upper bound. This
+    # error message can be customized by supplying `crossed_bounds_message`.
+    def range_component_attributes(
+      range_name,
+      lower_name: "#{range_name}_lower",
+      upper_name: "#{range_name}_upper",
+      type_converter: nil,
+      lower_type_converter: nil,
+      upper_type_converter: nil,
+      exclude_end: true,
+      crossed_bounds_message: "must be less than upper bound"
+    )
+      range_wrapper_name = "#{range_name}_wrapper"
+      lower_type_converter ||= type_converter
+      upper_type_converter ||= type_converter
+      raise ArgumentError, "must provide lower_type_converter or type_converter" unless lower_type_converter
+      raise ArgumentError, "must provide upper_type_converter or type_converter" unless upper_type_converter
+
+      mod = Module.new do
+        define_method range_wrapper_name do
+          instance_variable_get("@#{range_wrapper_name}") ||
+            instance_variable_set("@#{range_wrapper_name}",
+              RangeWrapper.new(
+                lower_type_converter: lower_type_converter,
+                upper_type_converter: upper_type_converter,
+                exclude_end: exclude_end,
+                range: send(range_name),
+                crossed_bounds_message: crossed_bounds_message
+              )
+            )
+        end
+
+        define_method "#{lower_name}" do
+          send(range_wrapper_name).lower
+        end
+
+        define_method "#{lower_name}=" do |val|
+          range_wrapper = send(range_wrapper_name)
+          range_wrapper.lower = val
+          if range_wrapper.valid?
+            send("#{range_name}=", range_wrapper.range)
+          end
+        end
+
+        define_method "#{upper_name}" do
+          send(range_wrapper_name).upper
+        end
+
+        define_method "#{upper_name}=" do |val|
+          range_wrapper = send(range_wrapper_name)
+          range_wrapper.upper = val
+          if range_wrapper.valid?
+            send("#{range_name}=", range_wrapper.range)
+          end
+        end
+
+        define_method "#{range_name}=" do |val|
+          send(range_wrapper_name).range = val
+          super val
+        end
+
+        define_method "check_#{range_name}_errors" do
+          range_wrapper = send(range_wrapper_name)
+          unless range_wrapper.valid?
+            errors.add lower_name, range_wrapper.errors[:lower] if range_wrapper.errors[:lower]
+            errors.add upper_name, range_wrapper.errors[:upper] if range_wrapper.errors[:upper]
+            errors.add upper_name, range_wrapper.errors[:range] if range_wrapper.errors[:range]
+          end
+        end
+      end
+
+      validate "check_#{range_name}_errors".to_sym
+
+      self.include mod
+    end
+  end
+end

data/lib/range_component_attributes/range_wrapper.rb

@@ -0,0 +1,105 @@
+module RangeComponentAttributes
+  class InvalidRangeError < StandardError; end
+
+  class RangeWrapper
+    attr_reader :errors
+
+    def initialize(
+      # Range type
+      lower_type_converter:,
+      upper_type_converter:,
+      exclude_end: true,
+
+      # Initial values
+      lower: nil,
+      upper: nil,
+      range: nil,
+
+      crossed_bounds_message: "must be less than upper bound"
+    )
+      raise ArgumentError, "lower/upper and range are mutually exclusive" if (lower || upper) && range
+
+      @errors = {}
+      @lower_type_converter = lower_type_converter
+      @upper_type_converter = upper_type_converter
+      @exclude_end = exclude_end
+      @crossed_bounds_message = crossed_bounds_message
+
+      if range
+        self.range = range
+      else
+        self.lower = lower
+        self.upper = upper
+      end
+    end
+
+    def range
+      raise InvalidRangeError unless valid?
+      @range
+    end
+
+    def range=(x)
+      if x
+        @lower = x.begin
+        @upper = x.end
+        if x.exclude_end? != @exclude_end && @upper.respond_to?(:next)
+          @upper += x.exclude_end? ? -1 : 1
+        end
+        convert_lower_and_upper_to_range
+      else
+        @lower = nil
+        @upper = nil
+        @range = nil
+      end
+    end
+
+    def lower
+      @lower
+    end
+
+    def lower=(x)
+      @lower = begin
+        @lower_type_converter.(x).tap { errors.delete(:lower) }
+      rescue TypeConversionError => e
+        errors[:lower] = "is not a #{e.target_type}"
+        x
+      end
+      convert_lower_and_upper_to_range
+    end
+
+    def upper
+      @upper
+    end
+
+    def upper=(x)
+      @upper = begin
+        @upper_type_converter.(x).tap { errors.delete(:upper) }
+      rescue TypeConversionError => e
+        errors[:upper] = "is not a #{e.target_type}"
+        x
+      end
+      convert_lower_and_upper_to_range
+    end
+
+    def valid?
+      errors.empty?
+    end
+
+  private
+
+    def convert_lower_and_upper_to_range
+      return nil unless errors.keys.reject { |k| k == :range }.empty?
+      @range = if @lower != @lower_type_converter.blank_value || @upper != @upper_type_converter.blank_value
+        Range.new(@lower, @upper, @exclude_end)
+      else
+        nil
+      end
+      errors.clear
+
+      crossed_bounds = lower > upper rescue nil
+      errors[:lower] = @crossed_bounds_message if crossed_bounds
+    rescue ArgumentError => e
+      errors[:range] = e.to_s
+    end
+  end
+end

data/lib/range_component_attributes/type_conversion.rb

@@ -0,0 +1,64 @@
+module RangeComponentAttributes
+  class TypeConversionError < StandardError
+    attr_reader :original_error, :target_type
+
+    def initialize(original_error, target_type)
+      @original_error = original_error
+      @target_type = target_type
+    end
+  end
+
+  class BaseConverter
+    attr_reader :blank_value
+
+    def initialize blank_value: nil
+      @blank_value = blank_value
+    end
+  end
+
+  class IntegerConverter < BaseConverter
+    def call(value)
+      return @blank_value if value.blank?
+      return value if value == Float::INFINITY
+      Integer(value)
+    rescue StandardError => e
+      raise TypeConversionError.new(e, "integer")
+    end
+  end
+
+  class DecimalConverter < BaseConverter
+    def call(value)
+      return @blank_value if value.blank?
+      return value if value == Float::INFINITY
+      BigDecimal(value, 16)
+    rescue StandardError => e
+      raise TypeConversionError.new(e, "number")
+    end
+  end
+
+  class FloatConverter < BaseConverter
+    def call(value)
+      return @blank_value if value.blank?
+      return value if value == Float::INFINITY
+      Float(value)
+    rescue StandardError => e
+      raise TypeConversionError.new(e, "number")
+    end
+  end
+
+  class DateConverter < BaseConverter
+    def call(value)
+      return @blank_value if value.blank?
+      return value if value == Float::INFINITY
+      return value if value.kind_of? Date
+      value = value.to_s
+      if value =~ /\A(\d\d\d\d)-(\d\d)-(\d\d)\z/
+        ::Date.civil($1.to_i, $2.to_i, $3.to_i)
+      else
+        ::Date.strptime(value, "%m/%d/%Y")
+      end
+    rescue StandardError => e
+      raise TypeConversionError.new(e, "date")
+    end
+  end
+end

data/lib/range_component_attributes/version.rb

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

data/range_component_attributes.gemspec

@@ -0,0 +1,32 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "range_component_attributes/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "range_component_attributes"
+  spec.version       = RangeComponentAttributes::VERSION
+  spec.authors       = ["Jack Christensen"]
+  spec.email         = ["jack@jackchristensen.com"]
+
+  spec.summary       = %q{Splits database ranges into lower and upper attributes in ActiveRecord}
+  spec.homepage      = "https://github.com/ccsalespro/range_component_attributes"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency 'activerecord', ">= 5.2.0"
+  spec.add_dependency 'activesupport', ">= 5.2.0"
+
+  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "minitest-reporters"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency 'pg', "~> 1.0"
+  spec.add_development_dependency 'pry'
+end

metadata

@@ -0,0 +1,171 @@
+--- !ruby/object:Gem::Specification
+name: range_component_attributes
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Jack Christensen
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-06-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.2.0
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.2.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: minitest-reporters
+  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: 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: pg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !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: 
+email:
+- jack@jackchristensen.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".ruby-version"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/range_component_attributes.rb
+- lib/range_component_attributes/range_wrapper.rb
+- lib/range_component_attributes/type_conversion.rb
+- lib/range_component_attributes/version.rb
+- range_component_attributes.gemspec
+homepage: https://github.com/ccsalespro/range_component_attributes
+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.7.6
+signing_key: 
+specification_version: 4
+summary: Splits database ranges into lower and upper attributes in ActiveRecord
+test_files: []