Bump v3.1.0

CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## [3.1.0] [2018-02-12]
+- support `ActiveRecord::Relation` in models (nepalez)
+
+  ```ruby
+  param :user, model: User.where(active: true)
+  ```
+
 ## [3.0.0] [2018-02-01]
 
 ### Changed
@@ -38,3 +45,4 @@ First public release
 [1.0.0]: https://github.com/nepalez/dry-initializer-rails/compare/v0.0.3...v1.0.0
 [2.0.0]: https://github.com/nepalez/dry-initializer-rails/compare/v1.0.0...v2.0.0
 [3.0.0]: https://github.com/nepalez/dry-initializer-rails/compare/v2.0.0...v3.0.0
+[3.1.0]: https://github.com/nepalez/dry-initializer-rails/compare/v3.0.0...v3.1.0

README.md

@@ -52,41 +52,43 @@ class CreateOrder
   extend Dry::Initializer
 
   # Params and options
-  param  :customer, model: 'Customer' # use either a name
-  option :product,  model: Product    # or a class
+  param  :customer, model: 'Customer'                 # use either a name
+  option :product,  model: Product                    # or a class
+  option :coupon,   model: Coupon.where(active: true) # or relation
 
   def call
-    Order.create customer: customer, product: product
+    Order.create customer: customer, product: product, coupon: coupon
   end
 end
 ```
 
 Now you can assign values as pre-initialized model instances:
 
 ```ruby
-customer = Customer.find(1)
-product  = Product.find(2)
-
-order = CreateOrder.new(customer, product: product).call
-order.customer # => <Customer @id=1 ...>
-order.product  # => <Product @id=2 ...>
+customer = Customer.create(id: 1)
+product  = Product.create(id: 2)
+coupon   = Coupon.create(id: 3, active: true)
+
+order = CreateOrder.new(customer, product: product, coupon: coupon).call
+order.customer # => #<Customer @id=1 ...>
+order.product  # => #<Product @id=2 ...>
+order.coupon   # => #<Coupon @id=3 ...>
 ```
 
 ...or their ids:
 
 ```ruby
-order = CreateOrder.new(1, product: 2).call
-order.customer # => <Customer @id=1 ...>
-order.product  # => <Product @id=2 ...>
+order = CreateOrder.new(1, product: 2, coupon: 3).call
+order.customer # => #<Customer @id=1 ...>
+order.product  # => #<Product @id=2 ...>
+order.coupon   # => #<Coupon @id=3 ...>
 ```
 
-The instance is envoked using method `find_by(id: ...)`.
-With wrong ids `nil` values are assigned to a corresponding params and options:
+The instance is envoked using method `find_by!(id: ...)`.
 
 ```ruby
-order = CreateOrder.new(0, product: 0).call
-order.customer # => nil
-order.product  # => nil
+order = CreateOrder.new(1, product: 2, coupon: 4).call
+# raises #<ActiveRecord::RecordNotFound>
 ```
 
 You can specify custom `key` for searching model instance:

dry-initializer-rails.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |gem|
   gem.name     = "dry-initializer-rails"
-  gem.version  = "3.0.0"
+  gem.version  = "3.1.0"
   gem.author   = ["Vladimir Kochnev (marshall-lee)", "Andrew Kozin (nepalez)"]
   gem.email    = ["andrew.kozin@gmail.com"]
   gem.homepage = "https://github.com/nepalez/dry-initializer-rails"