polist 1.1.1 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5a65368a827c99be9dbeca560968d9d924630435a62cc4b887c196d9c4ffcc4a
-  data.tar.gz: 651d41439429735882ed8f53f316e94b384fb8f09b9a74c1e32f8353e3845526
+  metadata.gz: d41a9ea7c84cd858fc92d79160ea448ed78fd36cfcf164195a7afe9cc5dbd59e
+  data.tar.gz: 2d2e676fd05d9b57f3b3159955a473933e95500de4f4e80f63b708a1cdc04f83
 SHA512:
-  metadata.gz: 946a3ff3e0d93822f90c6d27b0801588db165033454cf8d14b459c81b1f6ceef3313c5a528faf4bab3ebbec3037512bbabdfbdf3be6534a7ec9b61b459e66e4d
-  data.tar.gz: 5e3d0453b3f9a9ea152250192b3627cb7daf0d5f9db2f4ee2ae50ae0ffc18b24fe1442edb7ce4f204bc285f2d3f6afdfb87a86182ef4033323776efb9167f8bb
+  metadata.gz: f447ab40d832e15136acbf2b312f2941d2d18b0c8a046f40a4a3e26a76aa4e8be4df313e30962c665e3cc0f755ed1989f3ea8c6df050d0a4c28555fffd457558
+  data.tar.gz: 7e02ad12d1e8a13669a9e657c8ed7a181d19707c85c754c227c2fb006ba84e2b411ed4fe226001e8aeb2a3fa2a0aaee198eba1ef04d0432752f2353a8ce0f9fa

data/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [1.2.0] - 2019-03-15
+
+### Added
+
+- Block support for `#call` and `#run` ([@VanyaZ158]) [#5]
+
 ## [1.1.1] - 2019-02-09
 
 ### Fixed
@@ -28,11 +34,14 @@
 [1.0.0]: https://github.com/umbrellio/polist/compare/v0.4.0...v1.0.0
 [1.1.0]: https://github.com/umbrellio/polist/compare/v1.0.0...v1.1.0
 [1.1.1]: https://github.com/umbrellio/polist/compare/v1.1.0...v1.1.1
-[Unreleased]: https://github.com/umbrellio/polist/compare/v1.1.1...HEAD
+[1.2.0]: https://github.com/umbrellio/polist/compare/v1.1.1...v1.2.0
+[Unreleased]: https://github.com/umbrellio/polist/compare/v1.2.0...HEAD
 
 [@nesaulov]: https://github.com/nesaulov
+[@VanyaZ158]: https://github.com/VanyaZ158
 [@tycooon]: https://github.com/tycooon
 
 [#2]: https://github.com/umbrellio/polist/pull/2
 [#3]: https://github.com/umbrellio/polist/pull/3
 [#4]: https://github.com/umbrellio/polist/pull/4
+[#5]: https://github.com/umbrellio/polist/pull/5

data/README.md

@@ -56,6 +56,43 @@ end
 
 Note that `.run` and `.call` are just shortcuts for `MyService.new(...).run` and `MyService.new(...).call` with the only difference that they always return the service instance instead of the result of `#run` or `#call`. Unlike `#call` though, `#run` is not intended to be overwritten in subclasses.
 
+### Using blocks in #call and #run methods.
+
+You can use yield in `#call`. And then call `::run` or `::call` class methods with block. For example, we have the class:
+```ruby
+class BlockFun < Polist::Service
+  def call
+    success!(yield(1, 2))
+  end
+end
+```
+
+Then we can use it like this:
+```ruby
+service = BlockFun.call { |a, b| a + b }
+
+p service.response # => 3
+```
+
+Behind the scenes it just catches passed block in class methods `::run` and `::call`, converts it to proc and then passes proc to instance method `#call` and `#run` by converting it back to block. So, for example, if you want to pass this block to private methods, you can write code like this:
+```ruby
+class AnotherBlockFun < Polist::Service
+  def call(&block)
+    success!(block_caller(&block))
+  end
+
+  private
+
+  def block_caller
+    yield 1, 2
+  end
+end
+
+service = AnotherBlockFun.call { |a, b| a + b }
+
+p service.response # => 3
+```
+
 ### Using Form objects
 
 Sometimes you want to use some kind of params parsing and/or validation, and you can do that with the help of `Polist::Service::Form` class. It uses [tainbox](https://github.com/enthrops/tainbox) gem under the hood.
@@ -192,10 +229,10 @@ class MyService < Polist::Service
   def call
     success!(code: :cool)
   end
-  
+
   def fail_on_middleware?
     true
-  end  
+  end
 end
 
 service = MyService.run

data/lib/polist/service.rb

@@ -45,12 +45,12 @@ module Polist
       new(*args)
     end
 
-    def self.call(*args)
-      build(*args).tap(&:call)
+    def self.call(*args, &block)
+      build(*args).tap { |service| service.call(&block) }
     end
 
-    def self.run(*args)
-      build(*args).tap(&:run)
+    def self.run(*args, &block)
+      build(*args).tap { |service| service.run(&block) }
     end
 
     def self.param(*names)
@@ -83,8 +83,8 @@ module Polist
     # Should be implemented in subclasses
     def call; end
 
-    def run
-      call
+    def run(&block)
+      call(&block)
     rescue self.class::Failure => error
       @response = error.response
       @failure = true

data/lib/polist/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Polist
-  VERSION = "1.1.1"
+  VERSION = "1.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: polist
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.2.0
 platform: ruby
 authors:
 - Yuri Smirnov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-02-09 00:00:00.000000000 Z
+date: 2019-03-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -192,7 +192,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.2
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: A gem for creating simple service classes and more.