decanter 1.1.10 → 2.1.0

data/lib/generators/decanter/templates/initializer.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 Decanter.config do |config|
   # Possible values are :with_exception, true or false
   config.strict = :with_exception

data/lib/generators/rails/decanter_generator.rb

@@ -1,13 +1,15 @@
+# frozen_string_literal: true
+
 module Rails
   module Generators
     class DecanterGenerator < NamedBase
-      source_root File.expand_path('../templates', __FILE__)
-      check_class_collision :suffix => 'Decanter'
-      ASSOCIATION_TYPES = [:has_many, :has_one, :belongs_to]
+      source_root File.expand_path('templates', __dir__)
+      check_class_collision suffix: 'Decanter'
+      ASSOCIATION_TYPES = %i(has_many has_one belongs_to).freeze
 
-      argument :attributes, :type => :array, :default => [], :banner => 'field:type field:type'
+      argument :attributes, type: :array, default: [], banner: 'field:type field:type'
 
-      class_option :parent, :type => :string, :desc => 'The parent class for the generated decanter'
+      class_option :parent, type: :string, desc: 'The parent class for the generated decanter'
 
       def create_decanter_file
         template 'decanter.rb.erb', File.join('app/decanters', class_path, "#{file_name}_decanter.rb")

data/lib/generators/rails/parser_generator.rb

@@ -1,10 +1,12 @@
+# frozen_string_literal: true
+
 module Rails
   module Generators
     class ParserGenerator < NamedBase
-      source_root File.expand_path('../templates', __FILE__)
-      check_class_collision :suffix => 'Parser'
+      source_root File.expand_path('templates', __dir__)
+      check_class_collision suffix: 'Parser'
 
-      class_option :parent, :type => :string, :desc => 'The parent class for the generated parser'
+      class_option :parent, type: :string, desc: 'The parent class for the generated parser'
 
       def create_parser_file
         template 'parser.rb.erb', File.join('lib/decanter/parsers', class_path, "#{file_name}_parser.rb")

data/lib/generators/rails/resource_override.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'rails/generators'
 require 'rails/generators/rails/resource/resource_generator'
 

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: decanter
 version: !ruby/object:Gem::Version
-  version: 1.1.10
+  version: 2.1.0
 platform: ruby
 authors:
 - Ryan Francis
 - David Corwin
 autorequire: 
-bindir: exe
+bindir: bin
 cert_chain: []
-date: 2020-01-27 00:00:00.000000000 Z
+date: 2019-01-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -55,20 +55,6 @@ dependencies:
         version: 1.0.4
 - !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: dotenv
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -85,16 +71,16 @@ dependencies:
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec-rails
   requirement: !ruby/object:Gem::Requirement
@@ -113,40 +99,33 @@ dependencies:
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.15.1
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.15.1
+        version: '0'
 description: Decanter aims to reduce complexity in Rails controllers by creating a
   place for transforming data before it hits the model and database.
 email:
 - ryan@launchpadlab.com
-executables: []
+executables:
+- console
+- setup
 extensions: []
 extra_rdoc_files: []
 files:
-- ".codeclimate.yml"
-- ".gitignore"
-- ".rspec"
-- ".ruby-version"
-- Gemfile
-- Gemfile.lock
-- LICENSE.txt
-- README.md
-- Rakefile
 - bin/console
 - bin/setup
-- decanter.gemspec
 - lib/decanter.rb
 - lib/decanter/base.rb
 - lib/decanter/configuration.rb
 - lib/decanter/core.rb
+- lib/decanter/decant.rb
 - lib/decanter/exceptions.rb
 - lib/decanter/extensions.rb
 - lib/decanter/parser.rb
@@ -154,7 +133,7 @@ files:
 - lib/decanter/parser/boolean_parser.rb
 - lib/decanter/parser/core.rb
 - lib/decanter/parser/date_parser.rb
-- lib/decanter/parser/datetime_parser.rb
+- lib/decanter/parser/date_time_parser.rb
 - lib/decanter/parser/float_parser.rb
 - lib/decanter/parser/hash_parser.rb
 - lib/decanter/parser/integer_parser.rb
@@ -163,6 +142,7 @@ files:
 - lib/decanter/parser/pass_parser.rb
 - lib/decanter/parser/phone_parser.rb
 - lib/decanter/parser/string_parser.rb
+- lib/decanter/parser/time_parser.rb
 - lib/decanter/parser/utils.rb
 - lib/decanter/parser/value_parser.rb
 - lib/decanter/railtie.rb
@@ -194,7 +174,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubyforge_project: 
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
 summary: Form Parser for Rails

data/.codeclimate.yml

@@ -1,38 +0,0 @@
-engines:
-  rubocop:
-    enabled: true
-    checks:
-      Rubocop/Style/Documentation:
-        enabled: false
-      Rubocop/Metrics/LineLength:
-        enabled: false
-      Rubocop/Rails/Validation:
-        enabled: false
-      Rubocop/Style/IndentationConsistency:
-        enabled: false
-      Rubocop/Style/EmptyLines:
-        enabled: false
-      Rubocop/Style/ClassAndModuleChildren:
-        enabled: false
-      Rubocop/Style/AccessorMethodName:
-        enabled: false
-  golint:
-    enabled: true
-  gofmt:
-    enabled: true
-  eslint:
-    enabled: true
-  csslint:
-    enabled: true
-  brakeman:
-    enabled: false
-  bundler-audit:
-    enabled: true
-ratings:
-   paths:
-   - lib/**
-   - "**.rb"
-exclude_paths:
-- bin/**/*
-- spec/**/*
-- coverage/**/*

data/.gitignore

@@ -1,3 +0,0 @@
-/coverage
-.env
-.DS_Store

data/.rspec

@@ -1,2 +0,0 @@
---color
---format documentation

data/.ruby-version

@@ -1 +0,0 @@
-2.6.5

data/Gemfile

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

data/Gemfile.lock

@@ -1,102 +0,0 @@
-PATH
-  remote: .
-  specs:
-    decanter (1.1.10)
-      actionpack (>= 4.2.10)
-      activesupport
-      rails-html-sanitizer (>= 1.0.4)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    actionpack (5.1.4)
-      actionview (= 5.1.4)
-      activesupport (= 5.1.4)
-      rack (~> 2.0)
-      rack-test (>= 0.6.3)
-      rails-dom-testing (~> 2.0)
-      rails-html-sanitizer (~> 1.0, >= 1.0.2)
-    actionview (5.1.4)
-      activesupport (= 5.1.4)
-      builder (~> 3.1)
-      erubi (~> 1.4)
-      rails-dom-testing (~> 2.0)
-      rails-html-sanitizer (~> 1.0, >= 1.0.3)
-    activesupport (5.1.4)
-      concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (~> 0.7)
-      minitest (~> 5.1)
-      tzinfo (~> 1.1)
-    builder (3.2.3)
-    concurrent-ruby (1.0.5)
-    crass (1.0.4)
-    diff-lcs (1.3)
-    docile (1.1.5)
-    dotenv (2.2.1)
-    erubi (1.7.0)
-    i18n (0.9.3)
-      concurrent-ruby (~> 1.0)
-    json (2.1.0)
-    loofah (2.2.2)
-      crass (~> 1.0.2)
-      nokogiri (>= 1.5.9)
-    method_source (0.9.0)
-    mini_portile2 (2.3.0)
-    minitest (5.11.3)
-    nokogiri (1.8.5)
-      mini_portile2 (~> 2.3.0)
-    rack (2.0.4)
-    rack-test (0.8.2)
-      rack (>= 1.0, < 3)
-    rails-dom-testing (2.0.3)
-      activesupport (>= 4.2.0)
-      nokogiri (>= 1.6)
-    rails-html-sanitizer (1.0.4)
-      loofah (~> 2.2, >= 2.2.2)
-    railties (5.1.4)
-      actionpack (= 5.1.4)
-      activesupport (= 5.1.4)
-      method_source
-      rake (>= 0.8.7)
-      thor (>= 0.18.1, < 2.0)
-    rake (10.5.0)
-    rspec-core (3.7.1)
-      rspec-support (~> 3.7.0)
-    rspec-expectations (3.7.0)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.7.0)
-    rspec-mocks (3.7.0)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.7.0)
-    rspec-rails (3.7.2)
-      actionpack (>= 3.0)
-      activesupport (>= 3.0)
-      railties (>= 3.0)
-      rspec-core (~> 3.7.0)
-      rspec-expectations (~> 3.7.0)
-      rspec-mocks (~> 3.7.0)
-      rspec-support (~> 3.7.0)
-    rspec-support (3.7.1)
-    simplecov (0.15.1)
-      docile (~> 1.1.0)
-      json (>= 1.8, < 3)
-      simplecov-html (~> 0.10.0)
-    simplecov-html (0.10.2)
-    thor (0.20.0)
-    thread_safe (0.3.6)
-    tzinfo (1.2.5)
-      thread_safe (~> 0.1)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  bundler (~> 1.9)
-  decanter!
-  dotenv
-  rake (~> 10.0)
-  rspec-rails
-  simplecov (~> 0.15.1)
-
-BUNDLED WITH
-   1.17.2

data/LICENSE.txt

@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2015 TODO: Write your name
-
-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

@@ -1,516 +0,0 @@
-Decanter
-===
-
-[![Code Climate](https://codeclimate.com/github/LaunchPadLab/decanter/badges/gpa.svg?ignore=me)](https://codeclimate.com/github/LaunchPadLab/decanter) [![Test Coverage](https://codeclimate.com/github/LaunchPadLab/decanter/badges/coverage.svg?ignore=me)](https://codeclimate.com/github/LaunchPadLab/decanter/coverage)
----
-
-
-What is Decanter?
----
-
-Decanter is a Rails gem that makes it easy to transform incoming data before it hits the model. The basic idea is that form data entered by a user often needs to be processed before it is stored into the database. A typical example of this is a datepicker. A user selects January 15th, 2015 as the date, but this is going to come into our controller as a string like "01/15/2015", so we need to convert this string to a Ruby Date object before it is stored in our database. Many developers perform this conversion right in the controller, which results in errors and unnecessary complexity, especially as the application grows.
-
-You can think of Decanter as the opposite of Active Model Serializer. Whereas AMS transforms your outbound data into a format that your frontend consumes, Decanter transforms your incoming data into a format that your backend consumes.
-
-Installation
----
-
-```ruby
-gem "decanter"
-```
-
-```
-bundle
-```
-
-Basic Usage
----
-
-```
-rails g decanter Trip name:string start_date:date end_date:date
-```
-
-**app/decanters/trip_decanter.rb**
-
-```ruby
-class TripDecanter < Decanter::Base
-  input :name, :string
-  input :start_date, :date
-  input :end_date, :date
-end
-```
-
-By default, Decanter will use the [default parser](https://github.com/LaunchPadLab/decanter#default-parsers) that matches your input data type.
-
-```ruby
-  input :name, :string #=> StringParser
-```
-
-To reference a custom or modified parser,
-
-```ruby
-  input :name, :string, :custom_string_parser
-```
-
-In your controller:
-
-```ruby
-  def create
-    @trip = Trip.decant_new(params[:trip])
-
-    if @trip.save
-      redirect_to trips_path
-    else
-      render "new"
-    end
-  end
-
-  def update
-    @trip = Trip.find(params[:id])
-
-    if @trip.decant_update(params[:trip])
-      redirect_to trips_path
-    else
-      render "new"
-    end
-  end
-```
-
-Or, if you would prefer to get the parsed hash and then do your own logic, you can do the following:
-
-```ruby
-def create
-  parsed_params = Trip.decant(params[:trip])
-  @trip = Trip.new(parsed_params)
-
-  # save logic here
-end
-```
-
-Basic Example
----
-
-We have a form where users can create a new Trip, which has the following attributes: name, start_date, and end_date
-
-Without Decanter, here is what our create action may look like:
-
-```ruby
-class TripsController < ApplicationController
-  def create
-    @trip = Trip.new(params[:trip])
-    start_date = Date.strptime(params[:trip][:start_date], '%m/%d/%Y')
-    end_date = Date.strptime(params[:trip][:end_date], '%m/%d/%Y')
-    @trip.start_date = start_date
-    @trip.end_date = end_date
-
-    if @trip.save
-      redirect_to trips_path
-    else
-      render 'new'
-    end
-  end
-end
-```
-
-We can see here that converting start_date and end_date to a Ruby date is creating complexity. Could you imagine the complexity involved with performing similar parsing with a nested resource? If you're curious how ugly it would get, we took the liberty of implementing an example here: [Nested Example (Without Decanter)](https://github.com/LaunchPadLab/decanter_demo/blob/master/app/controllers/nested_example/trips_no_decanter_controller.rb)
-
-With Decanter installed, here is what the same controller action would look like:
-
-```ruby
-class TripsController < ApplicationController
-  def create
-    @trip = Trip.decant_new(params[:trip])
-
-    if @trip.save
-      redirect_to trips_path
-    else
-      render 'new'
-    end
-  end
-end
-```
-
-As you can see, we no longer need to parse the start and end date. Let's take a look at how we accomplished that.
-
-From terminal we ran:
-
-```
-rails g decanter Trip name:string start_date:date end_date:date
-```
-
-Which generates app/decanters/trip_decanter.rb:
-
-```ruby
-class TripDecanter < Decanter::Base
-  input :name, :string
-  input :start_date, :date
-  input :end_date, :date
-end
-```
-
-You'll also notice that instead of ```@trip = Trip.new(params[:trip])``` we do ```@trip = Trip.decant_new(params[:trip])```. ```decant_new``` is where the magic happens. It is converting the params from this:
-
-```ruby
-{
-  name: "My Trip",
-  start_date: "01/15/2015",
-  end_date: "01/20/2015"
-}
-```
-
-to this:
-
-```ruby
-{
-  name: "My Trip",
-  start_date: Mon, 15 Jan 2015,
-  end_date: Mon, 20 Jan 2015
-}
-```
-
-As you can see, the converted params hash has converted start_date and end_date to a Ruby Date object that is ready to be stored in our database.
-
-Adding Custom Parsers
----
-
-In the above example, start_date and end_date are ran through a DateParser that lives in Decanter. Let's take a look at the DateParser:
-
-** Note this changed in version 0.7.2. Now parser must inherit from Decanter::Parser::ValueParser or Decanter::Parser::HashParser instead of Decanter::Parser::Base **
-
-```ruby
-class DateParser < Decanter::Parser::ValueParser
-
-  allow Date
-
-  parser do |value, options|
-    parse_format = options.fetch(:parse_format, '%m/%d/%Y')
-    ::Date.strptime(value, parse_format)
-  end
-end
-```
-
-```allow Date``` basically tells Decanter that if the value comes in as a Date object, we don't need to parse it at all. Other than that, the parser is really just doing ```Date.strptime("01/15/2015", '%m/%d/%Y')```, which is just a vanilla date parse.
-
-You'll notice that the above ```parser do``` block takes a ```:parse_format``` option. This allows you to specify the format your date string will come in. For example, if you expect "2016-01-15" instead of "01/15/2016", you can adjust the TripDecanter like so:
-
-```ruby
-# app/decanters/trip_decanter.rb
-
-class TripDecanter < Decanter::Base
-  input :name, :string
-  input :start_date, :date, parse_format: '%Y-%m-%d'
-  input :end_date, :date, parse_format: '%Y-%m-%d'
-end
-```
-
-You can add your own parser if you want more control over the logic, or if you have a peculiar format type we don't support.
-
-```
-rails g parser Date
-```
-
-**lib/decanter/parsers/date_parser**
-
-```ruby
-class DateParser < Decanter::Parser::ValueParser
-  parser do |value, options|
-    # your parsing logic here
-  end
-end
-```
-
-
-By inheriting from Decanter::Parser::ValueParser, the assumption is that the value returned from the parser will be the value associated with the provided key. If you need more control over the result, for example, you want a parser that returns multiple key value pairs, you should instead inherit from Decanter::Parser::HashParser. This requires that the value returned is a hash. For example:
-
-```ruby
-class KeyValueSplitterParser < Decanter::Parser::HashParser
-  ITEM_DELIM = ','
-  PAIR_DELIM = ':'
-
-  parser do |name, val, options|
-    # val = 'color:blue,price:45.31'
-
-    item_delimiter = options.fetch(:item_delimiter, ITEM_DELIM)
-    pair_delimiter = options.fetch(:pair_delimiter, PAIR_DELIM)
-
-    pairs = val.split(item_delimiter) # ['color:blue', 'price:45.31']
-
-    hash = {}
-    pairs.each do |pair|
-      key, value = pair.split(pair_delimiter) # 'color', 'blue'
-      hash[key] = value
-    end
-    return hash
-  end
-end
-```
-
-The ```parser``` block takes the 'name' as an additional argument and must return a hash.
-
-Nested Example
----
-
-Let's say we have two models in our app: a Trip and a Destination. A trip has many destinations, and is prepared to accept nested attributes from the form.
-
-```ruby
-# app/models/trip.rb
-
-class Trip < ActiveRecord::Base
-  has_many :destinations
-  accepts_nested_attributes_for :destinations
-end
-```
-
-```ruby
-# app/models/destination.rb
-
-class Destination < ActiveRecord::Base
-  belongs_to :trip
-end
-```
-
-First, let's create our decanters for Trip and Destination. Note: decanters are automatically created whenever you run ```rails g resource```.
-
-```
-rails g decanter Trip name destinations:has_many
-rails g decanter Destination city state arrival_date:date departure_date:date
-```
-
-Which produces app/decanters/trip and app/decanters/destination:
-
-```ruby
-class TripDecanter < Decanter::Base
-  input :name, :string
-  has_many :destinations
-end
-```
-
-```ruby
-class DestinationDecanter < Decanter::Base
-  input :city, :string
-  input :state, :string
-  input :arrival_date, :date
-  input :departure_date, :date
-end
-```
-
-With that, we can use the same vanilla create action syntax you saw in the basic example above:
-
-```ruby
-class TripsController < ApplicationController
-  def create
-    @trip = Trip.decant_new(params[:trip])
-
-    if @trip.save
-      redirect_to trips_path
-    else
-      render 'new'
-    end
-  end
-end
-```
-
-Each of the destinations in our params[:trip] are automatically parsed according to the DestinationDecanter inputs set above. This means that ```arrival_date``` and ```departure_date``` are converted to Ruby Date objects for each of the destinations passed through the nested params. Yeehaw!
-
-Non Database-Backed Objects
----
-
-Decanter will work for your non database-backed objects as well. We just need to call ```decant``` to parse our params according to our decanter logic.
-
-Let's say we have a search filtering object called ```SearchFilter```. We start by generating our decanter:
-
-```
-rails g decanter SearchFilter start_date:date end_date:date city:string state:string
-```
-
-```ruby
-# app/decanters/search_filter_decanter.rb
-
-class SearchFilterDecanter < Decanter::Base
-
-end
-```
-
-```ruby
-# app/controllers/search_controller.rb
-
-def search
-  decanted_params = SearchFilterDecanter.decant(params[:search])
-  # decanted_params is now parsed according to the parsers defined
-  # in SearchFilterDecanter
-end
-```
-
-Default Parsers
----
-
-Decanter comes with the following parsers:
-- boolean
-- date
-- date_time
-- float
-- integer
-- join
-- key_value_splitter
-- pass
-- phone
-- string
-
-As an example as to how these parsers differ, let's consider ```float```. The float parser will perform a regex to find only characters that are digits or decimals. By doing that, your users can enter in commas and currency symbols without your backend throwing a hissy fit.
-
-We encourage you to create your own parsers for other needs in your app, or generate one of the above listed parsers to override its behavior.
-
-```
-rails g parser Zip
-```
-
-Squashing Inputs
----
-
-Sometimes, you may want to take several inputs and combine them into one finished input prior to sending to your model. For example, if day, month, and year come in as separate parameters, but your database really only cares about start_date.
-
-```ruby
-class TripDecanter < Decanter::Base
-  input [:day, :month, :year], :squash_date, key: :start_date
-end
-```
-
-```
-rails g parser SquashDate
-```
-
-```ruby
-# lib/decanter/parsers/squash_date_parser.rb
-
-class SquashDateParser < Decanter::Parser::ValueParser
-  parser do |values, options|
-    day, month, year = values.map(&:to_i)
-    Date.new(year, month, day)
-  end
-end
-```
-
-Chaining Parsers
----
-
-Parsers are composable! Suppose you want a parser that takes an incoming percentage like "50.3%" and converts it into a float for your database like .503. You could implement this with:
-
-```ruby
-class PercentParser < Decanter::Parser::ValueParser
-  REGEX = /(\d|[.])/
-
-  parser do |val, options|
-    my_float = val.scan(REGEX).join.try(:to_f)
-    my_float / 100 if my_float
-  end
-end
-```
-
-This works, but it duplicates logic that already exists in `FloatParser`. Instead, you can specify a parser that should always run before your parsing logic, then you can assume that your parser receives a float:
-
-```ruby
-class SmartPercentParser < Decanter::Parser::ValueParser
-
-  pre :float
-
-  parser do |val, options|
-    val / 100
-  end
-end
-```
-
-If a preparser returns nil or an empty string, subsequent parsers will not be called, just like normal!
-
-This can also be achieved by providing multiple parsers in your decanter:
-
-```ruby
-class SomeDecanter < Decanter::Base
-  input :some_percent, [:float, :percent]
-end
-```
-
-No Need for Strong Params
----
-
-Since you are already defining your expected inputs in Decanter, you really don't need strong params anymore.
-
-Note: starting with version 0.7.2, the default strict mode is ```:with_exception```. You can modify your default strict mode in your configuration file (see the "Configuration" section below).
-
-#### Mode: with_exception (default mode)
-
-To raise exceptions when parameters arrive in your Decanter that you didn't expect:
-
-```ruby
-class TripDecanter <  Decanter::Base
-  strict :with_exception
-
-  input :name
-end
-```
-
-#### Mode: strict
-
-In order to tell Decanter to ignore the params not defined in your Decanter, just add the ```strict``` flag to your Decanters:
-
-```ruby
-class TripDecanter <  Decanter::Base
-  strict true
-
-  input :name
-end
-```
-
-#### Requiring Params
-
-If you provide the option `:required` for an input in your decanter, an exception will be thrown if the parameters is nil or an empty string.
-
-```ruby
-class TripDecanter <  Decanter::Base
-  input :name, :string, required: true
-end
-```
-
-#### Ignoring Params
-
-If you anticipate your decanter will receive certain params that you simply want to ignore and therefore do not want Decanter to raise an exception, you can do so by calling the `ignore` method:
-
-```ruby
-class TripDecanter <  Decanter::Base
-  ignore :created_at, :updated_at
-
-  input :name, :string
-end
-```
-
-Configuration
----
-
-You can generate a local copy of the default configuration with ```rails generate decanter:install```. This will create the initializer ```../config/initializers/decanter.rb```.
-
-Starting with version 0.7.2, the default strict mode is ```:with_exception```. If this is what you prefer, you no longer have to set it in every decanter. You can still set this on individual decanters or you can configure it globally in the initializer:
-
-```ruby
-# ../config/initializers/decanter.rb
-
-Decanter.config do |config|
-  config.strict = true
-end
-
-# Or
-
-Decanter.configuration.strict = true
-```
-
-Likewise, you can put the above code in a specific environment configuration.
-
-Decanter Exceptions
----
-
- - MissingRequiredInputValue
-
-  Raised when required inputs have been enabled, but provided arguments to `decant()` do not contain values for those required inputs.
-
- - UnhandledKeysError
-
-  Raised when there are unhandled keys.
-