decanter 2.1.2 → 3.0.0

data/lib/decanter/version.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 module Decanter
-  VERSION = '2.1.2'.freeze
+  VERSION = '3.0.0'.freeze
 end

data/lib/generators/decanter/install_generator.rb

@@ -1,14 +1,12 @@
-# frozen_string_literal: true
-
 module Decanter
   module Generators
     class InstallGenerator < Rails::Generators::Base
-      source_root File.expand_path('templates', __dir__)
+      source_root File.expand_path('../templates', __FILE__)
 
-      desc 'Creates a Decanter initializer in your application.'
+      desc "Creates a Decanter initializer in your application."
 
       def copy_initializer
-        copy_file 'initializer.rb', 'config/initializers/decanter.rb'
+        copy_file "initializer.rb", "config/initializers/decanter.rb"
       end
     end
   end

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

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

data/lib/generators/rails/decanter_generator.rb

@@ -1,15 +1,13 @@
-# frozen_string_literal: true
-
 module Rails
   module Generators
     class DecanterGenerator < NamedBase
-      source_root File.expand_path('templates', __dir__)
-      check_class_collision suffix: 'Decanter'
-      ASSOCIATION_TYPES = %i(has_many has_one belongs_to).freeze
+      source_root File.expand_path('../templates', __FILE__)
+      check_class_collision :suffix => 'Decanter'
+      ASSOCIATION_TYPES = [:has_many, :has_one, :belongs_to]
 
-      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,12 +1,10 @@
-# frozen_string_literal: true
-
 module Rails
   module Generators
     class ParserGenerator < NamedBase
-      source_root File.expand_path('templates', __dir__)
-      check_class_collision suffix: 'Parser'
+      source_root File.expand_path('../templates', __FILE__)
+      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,5 +1,3 @@
-# frozen_string_literal: true
-
 require 'rails/generators'
 require 'rails/generators/rails/resource/resource_generator'
 

data/migration-guides/v3.0.0.md

@@ -0,0 +1,21 @@
+# v3.0.0 Migration Guide
+
+_Note: this guide assumes you are upgrading from decanter v1 to v3. In order to migrate from v2, please downgrade to v1 first._
+
+This version contains the following breaking changes:
+
+1. `strict true` mode will now raise exceptions for unhandled keys.
+
+`strict true` previously displayed warnings rather than raising exceptions. To adapt to the new behavior, replace all instances of `strict true` in your app with `strict false`, and replace all instances of `strict :with_exception` to `strict true`.
+
+2. `JoinParser` and `KeyValueSplitterParser` default parsers have been removed.
+
+If you use these parsers in your project, you should include them as custom parsers. Their source code is available on the `v1` branch.
+
+3. All default parsers (except for `ArrayParser`) now strictly require a single value.
+
+Default parsers will now raise an exception when passed an array of values. For instance, an attribute declared with `input <name>, :string` will expect to receive a single string rather than an array of strings. Previously, default parsers handled arrays of values in unstable and undocumented ways. In the (unlikely) event that your project was relying on the previous behavior, you can include the legacy version(s) of the parsers as custom parsers in your project.
+
+4. Decanter exceptions have been renamed from `Decanter::Core::<Exception>` to `Decanter::<Exception>`.
+
+If your project relies on specific decanter exception names, make sure to rename those instances accordingly.

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: decanter
 version: !ruby/object:Gem::Version
-  version: 2.1.2
+  version: 3.0.0
 platform: ruby
 authors:
 - Ryan Francis
 - David Corwin
 autorequire: 
-bindir: bin
+bindir: exe
 cert_chain: []
-date: 2020-01-27 00:00:00.000000000 Z
+date: 2020-02-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -55,6 +55,20 @@ 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:
     - - ">="
@@ -71,16 +85,16 @@ dependencies:
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '10.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '10.0'
 - !ruby/object:Gem::Dependency
   name: rspec-rails
   requirement: !ruby/object:Gem::Requirement
@@ -99,50 +113,57 @@ dependencies:
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.15.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.15.1
 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:
-- console
-- setup
+executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".codeclimate.yml"
+- ".gitignore"
+- ".rspec"
+- ".ruby-version"
+- ".travis.yml"
+- 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
+- lib/decanter/parser/array_parser.rb
 - lib/decanter/parser/base.rb
 - lib/decanter/parser/boolean_parser.rb
+- lib/decanter/parser/compose_parser.rb
 - lib/decanter/parser/core.rb
 - lib/decanter/parser/date_parser.rb
-- lib/decanter/parser/date_time_parser.rb
+- lib/decanter/parser/datetime_parser.rb
 - lib/decanter/parser/float_parser.rb
 - lib/decanter/parser/hash_parser.rb
 - lib/decanter/parser/integer_parser.rb
-- lib/decanter/parser/join_parser.rb
-- lib/decanter/parser/key_value_splitter_parser.rb
 - 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
@@ -154,13 +175,13 @@ files:
 - lib/generators/rails/resource_override.rb
 - lib/generators/rails/templates/decanter.rb.erb
 - lib/generators/rails/templates/parser.rb.erb
+- migration-guides/v3.0.0.md
 homepage: https://github.com/launchpadlab/decanter
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-post_install_message: 'WARNING: Decanter 2.x is unstable and not recommended for production
-  use. Please use another major version of this gem.'
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -175,8 +196,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Form Parser for Rails

data/lib/decanter/decant.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-module Decanter
-  module Decant
-    extend ActiveSupport::Concern
-
-    def decant(decanter, params)
-      Decanter.decanter_for(decanter).decant(params)
-    end
-  end
-end

data/lib/decanter/parser/date_time_parser.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-module Decanter
-  module Parser
-    # rubocop:disable Style/DateTime
-    class DateTimeParser < ValueParser
-      allow DateTime
-
-      parser do |val, options|
-        if val.is_a?(Time)
-          val.to_datetime
-        elsif (parse_format = options[:parse_format])
-          ::DateTime.strptime(val, parse_format)
-        else
-          ::DateTime.parse(val)
-        end
-      end
-    end
-    # rubocop:enable Style/DateTime
-  end
-end

data/lib/decanter/parser/join_parser.rb

@@ -1,14 +0,0 @@
-# frozen_string_literal: true
-
-module Decanter
-  module Parser
-    class JoinParser < ValueParser
-      ITEM_DELIM = ','
-
-      parser do |val, options|
-        delimiter = options.fetch(:delimiter, ITEM_DELIM)
-        val.join(delimiter)
-      end
-    end
-  end
-end

data/lib/decanter/parser/key_value_splitter_parser.rb

@@ -1,18 +0,0 @@
-# frozen_string_literal: true
-
-module Decanter
-  module Parser
-    class KeyValueSplitterParser < HashParser
-      ITEM_DELIM = ','
-      PAIR_DELIM = ':'
-
-      parser do |val, options|
-        item_delimiter = options.fetch(:item_delimiter, ITEM_DELIM)
-        pair_delimiter = options.fetch(:pair_delimiter, PAIR_DELIM)
-        val.split(item_delimiter).reduce({}) do |memo, pair|
-          memo.merge(Hash[*pair.split(pair_delimiter)])
-        end
-      end
-    end
-  end
-end

data/lib/decanter/parser/time_parser.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-module Decanter
-  module Parser
-    class TimeParser < ValueParser
-      allow Time
-
-      parser do |val, options|
-        if val.is_a?(DateTime)
-          val.to_time
-        elsif (parse_format = options[:parse_format])
-          ::Time.strptime(val, parse_format)
-        else
-          ::Time.parse(val)
-        end
-      end
-    end
-  end
-end