web_pipe 0.6.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2e30728a57f73a570c6345efd53dc22d32006a3b6bd6eb666c15b3f079fd3f83
-  data.tar.gz: e85225c017e8ee7c23a65b7d5cda617cabc403d052c2196087542fc56c3d3636
+  metadata.gz: ce3123c1c702c02eaab09f4cb56209b512499d913fddaa55a95307e779748e15
+  data.tar.gz: f8fdcce1e652e37b719e3a621b19f9762ec3a47b74ff39ab4695f30f5ea0722c
 SHA512:
-  metadata.gz: 6b24b6829b5657403ce5ef161fc4c0fe265a091195fc0de5c878751aaf88041e169ad1628e448fbb6dd27412f3564b50e087cad782fab4c9ad39b6a0acbf4e18
-  data.tar.gz: a60f0297742a97ea66a2cf0b8629319a05881921c2589b6c493ded751dd27bfb29e64284e1048cb39981ea756a575e5b955a7f8a3efd6965c19ba395c3534353
+  metadata.gz: 117619501c7d97297266b8ac7cd89a6a2440c1cca7a1791da00e2b2a1935e790e4cd0d1877ea9ec5c9208cc9bac6ed8e07b981b04708102d67ca2760d1ed95e6
+  data.tar.gz: '08a391660d75a830e5e9e0bda97b62a4b299f5f543a86959d5fe86c8dda823b11438640d253400ec8a742a009c2a312cdeeb6a95c7a4cb4af4711589e5075fdd'

data/CHANGELOG.md

@@ -4,6 +4,33 @@ 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/).
 
+## [0.7.0] - 2019-08-27
+### Added
+- **BREAKING**. `Conn#config` instead of `Conn#bag` for extension configuration.
+  [[#29]](https://github.com/waiting-for-dev/web_pipe/pull/29)
+  
+- **BREAKING**. `:params` extension extracted from `:url` extension.
+  [[#30]](https://github.com/waiting-for-dev/web_pipe/pull/30)
+  
+- **BREAKING**. Router params are extracted as a param transformation.
+  [[#30]](https://github.com/waiting-for-dev/web_pipe/pull/30)
+  
+- **BREAKING**. Plugs now respond to `.call` instead of `.[]`.
+  [[#31]](https://github.com/waiting-for-dev/web_pipe/pull/31)
+  
+- **BREAKING**. `:dry-schema` extension has not a default handler.
+  [[#32]](https://github.com/waiting-for-dev/web_pipe/pull/32)
+  
+- **BREAKING**. `:dry-schema` extension stores output in `#config`.
+  [[#32]](https://github.com/waiting-for-dev/web_pipe/pull/32)
+  
+- Integration with `transproc` gem to provide any number of params
+  transformations.
+  [[#30]](https://github.com/waiting-for-dev/web_pipe/pull/30)
+  
+- `:dry-schema` extension automatically loads `:params` extension.
+  [[#32]](https://github.com/waiting-for-dev/web_pipe/pull/32)
+
 ## [0.6.1] - 2019-08-02
 ### Fixed
 - Fixed support for ruby 2.4.

data/_config.yml

@@ -0,0 +1 @@
+theme: jekyll-theme-slate

data/lib/web_pipe.rb

@@ -23,27 +23,32 @@ module WebPipe
   register_extension :dry_schema do
     require 'web_pipe/extensions/dry_schema/dry_schema'
     require 'web_pipe/extensions/dry_schema/plugs/sanitize_params'
-    require 'web_pipe/extensions/dry_schema/plugs/param_sanitization_handler'
   end
   
   register_extension :dry_view do
     require 'web_pipe/extensions/dry_view/dry_view'
-    require 'web_pipe/extensions/dry_view/plugs/view_context'
   end
 
   register_extension :container do
     require 'web_pipe/extensions/container/container'
-    require 'web_pipe/extensions/container/plugs/container'
   end
 
   register_extension :flash do
     require 'web_pipe/extensions/flash/flash'
   end
 
+  register_extension :router_params do
+    require 'web_pipe/extensions/router_params/router_params'
+  end
+
   register_extension :redirect do
     require 'web_pipe/extensions/redirect/redirect'
   end
 
+  register_extension :params do
+    require 'web_pipe/extensions/params/params'
+  end
+
   register_extension :session do
     require 'web_pipe/extensions/session/session'
   end

data/lib/web_pipe/conn.rb

@@ -210,6 +210,18 @@ module WebPipe
     # @return [Bag[]]
     attribute :bag, Bag
 
+    # @!attribute [r] config
+    #
+    # Instance level configuration.
+    #
+    # It is a hash where anything can be stored. Keys must be symbols.
+    #
+    # The idea of it is for extensions to have somewhere to store user
+    # provided values they may need at some point.
+    #
+    # @return [Bag[]]
+    attribute :config, Bag
+
     # Sets response status code.
     #
     # @param code [StatusCode]
@@ -320,6 +332,34 @@ module WebPipe
       )
     end
 
+    # Reads an item from {#config}.
+    #
+    # @param key [Symbol]
+    #
+    # @return [Object]
+    #
+    # @raise ConnSupport::KeyNotFoundInConfigError when key is not
+    # present in {#config}.
+    def fetch_config(key, default = Types::Undefined)
+      return config.fetch(key, default) unless default == Types::Undefined
+
+      config.fetch(key) { raise ConnSupport::KeyNotFoundInConfigError.new(key) }
+    end
+
+    # Writes an item to {#config}.
+    #
+    # If it already exists, it is overwritten.
+    #
+    # @param key [Symbol]
+    # @param value [Object]
+    #
+    # @return [Conn]
+    def add_config(key, value)
+      new(
+        config: config.merge(key => value)
+      )
+    end
+
     # Builds response in the way rack expects.
     #
     # It is useful to finish a rack application built with a

data/lib/web_pipe/conn_support/composition.rb

@@ -1,9 +1,6 @@
 require 'dry/monads/result'
 require 'web_pipe/types'
 require 'web_pipe/conn'
-require 'dry/monads/result/extensions/either'
-
-Dry::Monads::Result.load_extensions(:either)
 
 module WebPipe
   module ConnSupport

data/lib/web_pipe/conn_support/errors.rb

@@ -1,7 +1,7 @@
 module WebPipe
   module ConnSupport
-    # Error raised when trying to fetch an entry in {Conn}'s bag for
-    # an unknown key.
+    # Error raised when trying to fetch an entry in {Conn#bag} for an
+    # unknown key.
     class KeyNotFoundInBagError < KeyError
       # @param key [Any] Key not found in the bag
       def initialize(key)
@@ -13,6 +13,19 @@ module WebPipe
       end
     end
 
+    # Error raised when trying to fetch an entry in {Conn#config} for
+    # an unknown key.
+    class KeyNotFoundInConfigError < KeyError
+      # @param key [Any] Key not found in config
+      def initialize(key)
+        super(
+          <<~eos
+            Config does not contain a key with name +#{key}+.
+          eos
+        )
+      end
+    end
+
     # Error raised when trying to use a conn's feature which requires
     # a rack middleware which is not present
     class MissingMiddlewareError < RuntimeError

data/lib/web_pipe/extensions/container/container.rb

@@ -1,10 +1,8 @@
 require 'web_pipe'
 
 module WebPipe
-  # Extension adding a `#container` method to fetch bag's `:container`
-  # key.
-  #
-  # Usually, the container is set with {WebPipe::Plugs::Container}.
+  # Extension adding a `#container` method which returns {Conn#config}
+  # `:container` key.
   #
   # @example
   #   require 'web_pipe'
@@ -14,15 +12,15 @@ module WebPipe
   #   class App
   #     include WebPipe
   #
-  #     plug :container, WebPipe::Plugs::Container[MyContainer]
+  #     plug :container, ->(conn) { conn.add_config(:container, MyContainer) }
   #     plug :render, ->(conn) { conn.set_response_body(conn.container['view']) }
   #   end
   module Container
-    # Returns bag `:container` value
+    # Returns {Conn#config} `:container` value
     #
     # @return [Any]
     def container
-      fetch(:container)
+      fetch_config(:container)
     end
   end
 

data/lib/web_pipe/extensions/dry_schema/dry_schema.rb

@@ -1,5 +1,7 @@
 require 'web_pipe'
 
+WebPipe.load_extensions(:params)
+
 module WebPipe
   # Integration with `dry-schema` validation library.
   #
@@ -8,11 +10,12 @@ module WebPipe
   #
   # On its own, the library just provides with a
   # `Conn#sanitized_params` method, which will return what is set into
-  # bag's `:sanitized_params` key.
+  # config's `:sanitized_params` key.
   #
-  # This key in the bag is what will be populated by `SanitizeParams`
-  # plug, which accepts a `dry-validation` schema that will be applied
-  # to `Conn#params`:
+  # This key in config is what will be populated by `SanitizeParams` plug. It
+  # takes as arguments the `dry-schema` schema that will be applied to
+  # `Conn#params` and an error handler taking `Conn` instance and the validation
+  # result:
   #
   # @example
   #  require 'web_pipe'
@@ -26,43 +29,32 @@ module WebPipe
   #      required(:name).filled(:string)
   #    end
   #
-  #    plug :sanitize_params, WebPipe::Plugs::SanitizeParams[Schema]
+  #    plug :sanitize_params, WebPipe::Plugs::SanitizeParams.(
+  #      Schema,
+  #      ->(conn, result) { ... }
+  #    )
   #    plug(:do_something_with_params) do |conn|
   #      DB.persist(:entity, conn.sanitized_params)
   #    end
   #  end
   #
-  # By default, when the result of applying the schema is a failure,
-  # {Conn} is halted with a 500 as status code. However, you can
-  # specify your own handler for the unhappy path. It will take the
-  # {Conn} and {Dry::Schema::Result} instances as arguments:
-  #
-  # @example
-  #   plug :sanitize_params, WebPipe::Plugs::SanitizeParams[
-  #                            Schema,
-  #                            ->(conn, result) { ... }
-  #                          ]
-  #
   # A common workflow is applying the same handler for all param
-  # sanitization across your application. This can be achieved setting
-  # a `:param_sanitization_handler` bag key in a upstream operation
-  # which can be composed downstream for any number of
-  # pipes. `SanitizeParams` will used configured handler if none is
-  # injected as argument. Another plug `ParamSanitizationHandler`
-  # exists to help with this process:
+  # sanitization across your application. This can be achieved configuring
+  # a `:param_sanitization_handler` in a upstream operation which can
+  # be composed downstream from any number of pipes. `SanitizeParams`
+  # will used configured handler if none is injected as
+  # argument.
   #
   # @example
   #  class App
-  #    plug :sanitization_handler, WebPipe::Plugs::ParamSanitizationHandler[
-  #                                  ->(conn, result) { ... }
-  #                                ]
+  #    plug :sanitization_handler, ->(conn, result) { ... }
   #  end
   #
   #  class Subapp
   #    Schema = Dry::Schema.Params { ... }
   #
   #    plug :app, App.new
-  #    plug :sanitize_params, WebPipe::Plugs::SanitizeParams[Schema]
+  #    plug :sanitize_params, WebPipe::Plugs::SanitizeParams.call(Schema)
   #  end
   #
   # @see https://dry-rb.org/gems/dry-schema/
@@ -70,9 +62,9 @@ module WebPipe
     SANITIZED_PARAMS_KEY = :sanitized_params
 
     def sanitized_params
-      fetch(SANITIZED_PARAMS_KEY)
+      fetch_config(SANITIZED_PARAMS_KEY)
     end
   end
 
   Conn.include(DrySchema)
-end
+end

data/lib/web_pipe/extensions/dry_schema/plugs/sanitize_params.rb

@@ -1,6 +1,5 @@
 require 'web_pipe/types'
 require 'web_pipe/extensions/dry_schema/dry_schema'
-require 'web_pipe/extensions/dry_schema/plugs/param_sanitization_handler'
 
 module WebPipe
   module Plugs
@@ -8,25 +7,20 @@ module WebPipe
     #
     # @see WebPipe::DrySchema
     module SanitizeParams
-      # Default handler if none is configured nor injected.
+      # {Conn#config} key to store the handler.
       #
-      # @return [ParamSanitizationHandler::Handler[]]
-      DEFAULT_HANDLER = lambda do |conn, _result|
-        conn.
-          set_status(500).
-          set_response_body('Given params do not conform with the expected schema').
-          halt
-      end
+      # @return [Symbol]
+      PARAM_SANITIZATION_HANDLER_KEY = :param_sanitization_handler
 
       # @param schema [Dry::Schema::Processor]
       # @param handler [ParamSanitizationHandler::Handler[]]
       #
       # @return [ConnSupport::Composition::Operation[], Types::Undefined]
-      def self.[](schema, handler = Types::Undefined)
+      def self.call(schema, handler = Types::Undefined)
         lambda do |conn|
           result = schema.(conn.params)
           if result.success?
-            conn.add(DrySchema::SANITIZED_PARAMS_KEY, result.output)
+            conn.add_config(DrySchema::SANITIZED_PARAMS_KEY, result.output)
           else
             get_handler(conn, handler).(conn, result)
           end
@@ -36,11 +30,9 @@ module WebPipe
       def self.get_handler(conn, handler)
         return handler unless handler == Types::Undefined
 
-        conn.fetch(
-          Plugs::ParamSanitizationHandler::PARAM_SANITIZATION_HANDLER_KEY, DEFAULT_HANDLER
-        )
+        conn.fetch_config(PARAM_SANITIZATION_HANDLER_KEY)
       end
       private_class_method :get_handler
     end
   end
-end
+end

data/lib/web_pipe/extensions/dry_view/dry_view.rb

@@ -28,9 +28,8 @@ module WebPipe
   #     end
   #   end
   #
-  # If {WebPipe::Conn#bag} has a `:container` key, the view instance
-  # can be resolved from it. {WebPipe::Container} extension can be
-  # used to streamline this integration.
+  # If there is a `:container` configured (in {Conn#config}), the view
+  # instance can be resolved from it.
   #
   # @example
   #   WebPipe.load_extensions(:dry_view, :container)
@@ -40,7 +39,7 @@ module WebPipe
   #
   #     Container = { 'views.say_hello' => SayHelloView.new }.freeze
   #
-  #     plug :container, WebPipe::Plugs::Container[Container]
+  #     plug :config_container, ->(conn) { conn.add_config(:container, Container[Container]) }
   #     plug :render
   #
   #     def render(conn)
@@ -52,9 +51,11 @@ module WebPipe
   # through the `context:` argument, as in a standard call to
   # {Dry::View#call}. However, it is possible to leverage configured
   # default context while still being able to inject request specific
-  # context. For that to work, a key `:view_context` should be present
-  # in {WebPipe::Conn#bag}. It must be equal to a hash which will be
-  # passed to {Dry::View::Context#with} to create the final context:
+  # context. For that to work, `:view_context` should be present in
+  # {WebPipe::Conn#config}. Its value must be a lambda accepting the
+  # {Conn} instance and returning a hash, which will be passed to
+  # {Dry::View::Context#with} to create the final context at the
+  # moment {#view} is called.
   #
   # @example
   #   class MyContext < Dry::View::Context
@@ -77,11 +78,11 @@ module WebPipe
   #   class App
   #     include WebPipe
   #
-  #     plug :set_view_context
+  #     plug :config_view_context
   #     plug :render
   #
-  #     def set_view_context(conn)
-  #       conn.put(:view_context, { current_path: conn.full_path })
+  #     def config_view_context(conn)
+  #       conn.add_config(:view_context, ->(conn) {  { current_path: conn.full_path } })
   #     end
   #
   #     def render(conn)
@@ -90,25 +91,14 @@ module WebPipe
   #     end
   #   end
   #
-  # It can be streamline using {WebPipe::Plugs::ViewContext} plug,
-  # which accepts a callable object which should return the request
-  # context from given {WebPipe::Conn}:
-  #
-  # @example
-  #  # ...
-  #    plug :set_view_context, WebPipe::Plugs::ViewContext[
-  #                              ->(conn) { { current_path: conn.full_path } }
-  #                            ]
-  #  # ...
-  #   
   # @see https://dry-rb.org/gems/dry-view/
   # @see WebPipe::Container
   module DryView
-    # Where to find in {#bag} request's view context
+    # Where to find in {#config} request's view context generator.
     VIEW_CONTEXT_KEY = :view_context
 
     # Default request's view context
-    DEFAULT_VIEW_CONTEXT = Types::EMPTY_HASH
+    DEFAULT_VIEW_CONTEXT = ->(_conn) { Types::EMPTY_HASH }
 
     # Sets string output of a view as response body.
     #
@@ -117,8 +107,8 @@ module WebPipe
     #
     # `kwargs` is used as the input for the view (the arguments that
     # {Dry::View#call} receives). If they doesn't contain an explicit
-    # `context:` key, it can be added through the injection injection
-    # of what is present in bag's `:view_context`.(see
+    # `context:` key, it can be added through the injection of the
+    # result of a lambda present in context's `:view_context`.(see
     # {Dry::View::Context#with}).
     #
     # @param view_spec [Dry::View, Any]
@@ -141,7 +131,7 @@ module WebPipe
     def view_instance(view_spec)
       return view_spec if view_spec.is_a?(Dry::View)
 
-      fetch(:container)[view_spec]
+      fetch_config(:container)[view_spec]
     end
 
     def view_input(kwargs, view_instance)
@@ -151,7 +141,7 @@ module WebPipe
                    config.
                    default_context.
                    with(
-                     fetch(VIEW_CONTEXT_KEY, DEFAULT_VIEW_CONTEXT)
+                     fetch_config(VIEW_CONTEXT_KEY, DEFAULT_VIEW_CONTEXT).(self)
                    )
       kwargs.merge(context: context)
     end

data/lib/web_pipe/extensions/params/params.rb

@@ -0,0 +1,99 @@
+require 'web_pipe/types'
+require 'web_pipe/extensions/params/params/transf'
+
+module WebPipe
+  # Adds a {Conn#params} method which can perform any number of
+  # transformations to the request parameters.
+  #
+  # When no transformations are given, {#params} just returns request
+  # parameters (both GET and POST) as a hash:
+  #
+  # @example
+  #   # http://www.example.com?foo=bar
+  #   conn.params #=> { 'foo' => 'bar' }
+  #
+  # Further processing can be specified thanks to `transproc` gem (you
+  # need to add it yourself to the Gemfile). All hash transformations
+  # in `transproc` are available:
+  #
+  # @example
+  #   # http://www.example.com?foo=bar
+  #   conn.params([:deep_symbolize_keys]) #=> { foo: 'bar' }
+  #
+  # Extra needed arguments can be provided as an array:
+  #
+  # @example
+  #   # http://www.example.com?foo=bar&zoo=zoo
+  #   conn.params([:deep_symbolize_keys, [:reject_keys, [:zoo]]) #=> { foo: 'bar' }
+  #
+  # Instead of injecting transformations at the moment `#params` is
+  # called, you can configure them to be automatically used.
+  #
+  # @example
+  #   # http://www.example.com?foo=bar
+  #   conn.
+  #     add_config(:param_transformation, [:deep_symbolize_keys]).
+  #     params #=> { foo: 'bar' }
+  #
+  # You can register your own transformation functions:
+  #
+  # @example
+  #   # http://www.example.com?foo=bar
+  #   fake = ->(_params) { { fake: :params } }
+  #   WebPipe::Params::Transf.register(:fake, fake)
+  #   conn.params([:fake]) #=> { fake: :params }
+  #
+  # Your own transformation functions can depend on the {Conn}
+  # instance at the moment of execution. For that, just place it as the
+  # last argument of the function and it will be curried automatically:
+  #
+  # @example
+  #   # http://www.example.com?foo=bar
+  #   add_name = ->(params, conn) { params.merge(name: conn.fetch(:name)) }
+  #   WebPipe::Params::Transf.register(:add_name, add_name)
+  #   conn.
+  #     add(:name, 'Joe').
+  #     params([:deep_symbolize_keys, :add_name]) #=> { foo: 'bar', name: 'Joe' }
+  #
+  # Inline transformations can also be provided:
+  #
+  # @example
+  #   # http://www.example.com?foo=bar
+  #   fake = ->(_params) { { fake: :params } }
+  #   conn.
+  #     params(fake) #=> { fake: :params } 
+  #
+  # @see https://github.com/solnic/transproc
+  module Params
+    # Key where configured transformations are set
+    PARAM_TRANSFORMATION_KEY = :param_transformations
+
+    # @param transformation_specs [Array<Symbol, Array>, Types::Undefined]
+    # @return [Any]
+    def params(transformation_specs = Types::Undefined)
+      specs = if transformation_specs == Types::Undefined
+                fetch_config(PARAM_TRANSFORMATION_KEY, [])
+              else
+                transformation_specs
+              end
+      transformations = specs.reduce(Transf[:id]) do |acc, t|
+        acc.>>transformation(t)
+      end
+
+      Transf[transformations].(request.params)
+    end
+
+    private
+
+    def transformation(spec)
+      transformation = Transf[*spec]
+      if (transformation.fn.arity - transformation.args.count) == 1
+        transformation
+      else
+        Transf[*[spec, self]]
+      end
+    end
+  end
+
+  Conn.include(Params)
+end

data/lib/web_pipe/extensions/params/params/transf.rb

@@ -0,0 +1,15 @@
+require 'transproc'
+
+module WebPipe
+  module Params
+    module Transf
+      extend Transproc::Registry
+
+      import Transproc::HashTransformations
+
+      def self.id(params)
+        params
+      end
+    end
+  end
+end

data/lib/web_pipe/extensions/router_params/router_params.rb

@@ -0,0 +1,59 @@
+require 'web_pipe'
+require 'web_pipe/types'
+
+WebPipe.load_extensions(:params)
+
+module WebPipe
+  # Adds a transformation to merge router params into {Conn#params}.
+  #
+  # This extension gives an opportunity for rack routers to modify
+  # {Conn#params} hash. This is useful so that they can provide *route
+  # parameters*, which are typically rendered as variables in routes
+  # definitions (e.g.: `/user/:id/edit`).
+  #
+  # It adds a `:router_params` transformation that, when used, will
+  # merged env's `router.params` in {Conn#params} hash. Choosing this
+  # name automatically integrates with `hanami-router`.
+  #
+  # When using this extension, `:params` extension is automatically enabled.
+  #
+  # @example
+  #   require 'web_pipe'
+  #
+  #   WebPipe.load_extensions(:router_params)
+  #
+  #   class MyApp
+  #     include WebPipe
+  #
+  #     plug :config
+  #     plug :get_params
+  #
+  #     private
+  #
+  #     def config(conn)
+  #       conn.add_config(:param_transformation, [:router_params])
+  #     end
+  #
+  #     def get_params(conn)
+  #       # http://example.com/users/1/edit
+  #       conn.params #=> { id: 1 }
+  #       conn
+  #     end
+  #  end
+  #
+  # @see WebPipe::Params
+  # @see https://github.com/hanami/router#string-matching-with-variables
+  module RouterParams
+    ROUTER_PARAM_KEY = 'router.params'
+    
+    # @param params [Hash]
+    # @param conn [WebPipe::Conn]
+    #
+    # @return [Hash]
+    def self.call(params, conn)
+      params.merge(conn.env.fetch(ROUTER_PARAM_KEY, Types::EMPTY_HASH))
+    end
+
+    WebPipe::Params::Transf.register(:router_params, method(:call))
+  end
+end

data/lib/web_pipe/extensions/url/url.rb

@@ -4,11 +4,6 @@ module WebPipe
   # This methods are in fact redundant with the information already
   # present in {Conn} struct but, of course, they are very useful.
   module Url
-    # Env's key used to retrieve params set by the router.
-    #
-    # @see #router_params
-    ROUTER_PARAMS_KEY = 'router.params'
-
     # Base part of the URL.
     #
     # This is {#scheme} and {#host}, adding {#port} unless it is the
@@ -58,37 +53,6 @@ module WebPipe
     def url
       request.url
     end
-
-    # *Params* in rack env's 'router.params' key.
-    #
-    # Routers used to map routes to applications build with
-    # {WebPipe} have the option to introduce extra params through
-    # setting env's 'router.params' key. These parameters will be
-    # merged with GET and POST ones when calling {#params}.
-    #
-    # This kind of functionality is usually implemented from the
-    # router side allowing the addition of variables in the route
-    # definition, e.g.:
-    #
-    # @example
-    #   /user/:id/update
-    #
-    # @return [Hash]
-    def router_params
-      env.fetch(ROUTER_PARAMS_KEY, Types::EMPTY_HASH)
-    end
-
-    # GET, POST and {#router_params} merged in a hash.
-    #
-    # @return [Params]
-    #
-    # @example
-    #   { 'id' => '1', 'name' => 'Joe' }
-    #
-    # @return Hash
-    def params
-      request.params.merge(router_params)
-    end
   end
 
   Conn.include(Url)

data/lib/web_pipe/plugs/config.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'web_pipe/types'
+
+module WebPipe
+  module Plugs
+    # Adds given pairs to {Conn#config}.
+    #
+    # @example
+    #   class App
+    #     include WebPipe
+    #
+    #     plug :config, WebPipe::Plugs::Config.(foo: :bar)
+    #   end
+    module Config
+      def self.call(pairs)
+        lambda do |conn|
+          conn.new(
+            config: conn.config.merge(pairs)
+          )
+        end
+      end
+    end
+  end
+end

data/lib/web_pipe/plugs/content_type.rb

@@ -10,13 +10,13 @@ module WebPipe
     #   class App
     #     include WebPipe
     #
-    #     plug :html, WebPipe::Plugs::ContentType['text/html']
+    #     plug :html, WebPipe::Plugs::ContentType.call('text/html')
     #   end
     module ContentType
       # Content-Type header
       HEADER = 'Content-Type'
 
-      def self.[](content_type)
+      def self.call(content_type)
         ->(conn) { conn.add_response_header(HEADER, content_type) }
       end
     end

data/lib/web_pipe/version.rb

@@ -1,3 +1,3 @@
 module WebPipe
-  VERSION = "0.6.1"
+  VERSION = "0.7.0"
 end

data/web_pipe.gemspec

@@ -36,9 +36,10 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_runtime_dependency "rack", "~> 2.0"
-  spec.add_runtime_dependency "dry-monads", "~> 1.2"
+  spec.add_runtime_dependency "dry-monads", "~> 1.3"
   spec.add_runtime_dependency "dry-types", "~> 1.1"
   spec.add_runtime_dependency "dry-struct", "~> 1.0"
+  spec.add_runtime_dependency "transproc", "~> 1.1"
 
   spec.add_development_dependency "bundler", "~> 1.17"
   spec.add_development_dependency "rake", "~> 10.0"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: web_pipe
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Marc Busqué
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-08-02 00:00:00.000000000 Z
+date: 2019-08-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: dry-types
   requirement: !ruby/object:Gem::Requirement
@@ -66,6 +66,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: transproc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -227,9 +241,9 @@ files:
 - Gemfile
 - README.md
 - Rakefile
+- _config.yml
 - bin/console
 - bin/setup
-- lib/dry/monads/result/extensions/either.rb
 - lib/web_pipe.rb
 - lib/web_pipe/app.rb
 - lib/web_pipe/conn.rb
@@ -243,19 +257,20 @@ files:
 - lib/web_pipe/dsl/dsl_context.rb
 - lib/web_pipe/dsl/instance_methods.rb
 - lib/web_pipe/extensions/container/container.rb
-- lib/web_pipe/extensions/container/plugs/container.rb
 - lib/web_pipe/extensions/cookies/cookies.rb
 - lib/web_pipe/extensions/dry_schema/dry_schema.rb
-- lib/web_pipe/extensions/dry_schema/plugs/param_sanitization_handler.rb
 - lib/web_pipe/extensions/dry_schema/plugs/sanitize_params.rb
 - lib/web_pipe/extensions/dry_view/dry_view.rb
-- lib/web_pipe/extensions/dry_view/plugs/view_context.rb
 - lib/web_pipe/extensions/flash/flash.rb
+- lib/web_pipe/extensions/params/params.rb
+- lib/web_pipe/extensions/params/params/transf.rb
 - lib/web_pipe/extensions/redirect/redirect.rb
+- lib/web_pipe/extensions/router_params/router_params.rb
 - lib/web_pipe/extensions/session/session.rb
 - lib/web_pipe/extensions/url/url.rb
 - lib/web_pipe/plug.rb
 - lib/web_pipe/plugs.rb
+- lib/web_pipe/plugs/config.rb
 - lib/web_pipe/plugs/content_type.rb
 - lib/web_pipe/rack/app_with_middlewares.rb
 - lib/web_pipe/rack/middleware.rb

data/lib/dry/monads/result/extensions/either.rb

@@ -1,42 +0,0 @@
-require "dry/core/extensions"
-
-module Dry
-  module Monads
-    # This is currently a PR in dry-monads:
-    #
-    # https://github.com/dry-rb/dry-monads/pull/84
-    class Result
-      extend Dry::Core::Extensions
-
-      register_extension(:either) do
-        class Success
-          # Returns result of applying first function to the internal value.
-          #
-          # @example
-          #   Dry::Monads.Success(1).either(-> x { x + 1 }, -> x { x + 2 }) # => 2
-          #
-          # @param f [#call] Function to apply
-          # @param g [#call] Ignored
-          # @return [Any] Return value of `f`
-          def either(f, _g)
-            f.(success)
-          end
-        end
-
-        class Failure
-          # Returns result of applying second function to the internal value.
-          #
-          # @example
-          #   Dry::Monads.Failure(1).either(-> x { x + 1 }, -> x { x + 2 }) # => 3
-          #
-          # @param f [#call] Ignored
-          # @param g [#call] Function to call
-          # @return [Any] Return value of `g`
-          def either(_f, g)
-            g.(failure)
-          end
-        end
-      end
-    end
-  end
-end

data/lib/web_pipe/extensions/container/plugs/container.rb

@@ -1,31 +0,0 @@
-require 'web_pipe/types'
-
-module WebPipe
-  module Plugs
-    # Sets a container into bag's `:container` key.
-    #
-    # Given container is check to respond to `#[]` method, which is
-    # meant to be used to resolve dependencies.
-    #
-    # @example
-    #   class App
-    #     include WebPipe
-    #
-    #     Cont = { name: SomeDependency.new }.freeze
-    #
-    #     plug :container, WebPipe::Plugs::Container[Cont]
-    #     plug :resolve
-    #
-    #     private
-    #
-    #     def resolve(conn)
-    #       conn.add(:dependency, conn.fetch(:container)[:name])
-    #     end
-    #   end
-    module Container
-      def self.[](container)
-        ->(conn) { conn.add(:container, Types::Container[container]) }
-      end
-    end
-  end
-end

data/lib/web_pipe/extensions/dry_schema/plugs/param_sanitization_handler.rb

@@ -1,27 +0,0 @@
-require 'web_pipe/types'
-
-module WebPipe
-  module Plugs
-    # Sets `:param_sanitization_handler` bag key.
-    #
-    # @see WebPipe::DrySchema
-    module ParamSanitizationHandler
-      # Bag key to store the handler.
-      #
-      # @return [Symbol]
-      PARAM_SANITIZATION_HANDLER_KEY = :param_sanitization_handler
-
-      # Type constructor for the handler.
-      Handler = Types.Interface(:call)
-
-      # @param handler [Handler[]]
-      #
-      # @return [ConnSupport::Composition::Operation[]]
-      def self.[](handler)
-        lambda do |conn|
-          conn.add(PARAM_SANITIZATION_HANDLER_KEY, Handler[handler])
-        end
-      end
-    end
-  end
-end

data/lib/web_pipe/extensions/dry_view/plugs/view_context.rb

@@ -1,38 +0,0 @@
-require 'web_pipe/types'
-require 'web_pipe/extensions/dry_view/dry_view'
-
-module WebPipe
-  module Plugs
-    # Calls object with conn and add the result into bag's `:view_context`.
-    #
-    # This is meant to contain a Proc which will be called with the same
-    # {WebPipe::Conn} instance of the operation. It must return
-    # request specific view context as a hash. Ultimately, this will
-    # be provided to {Dry::View::Context#with} before passing the
-    # result along to the view instance.
-    #
-    # @example
-    #   class App
-    #     include WebPipe
-    #
-    #     ViewContext = (conn) -> { { current_path: conn.full_path } }
-    #
-    #     plug :view_context, WebPipe::Plugs::ViewContext[ViewContext]
-    #     plug :render
-    #
-    #     def render
-    #       view(MyView.new)
-    #     end
-    #   end
-    #
-    # @see WebPipe::Conn#view
-    module ViewContext
-      def self.[](view_context_proc)
-        Types.Interface(:call)[view_context_proc]
-        lambda do |conn|
-          conn.add(Conn::VIEW_CONTEXT_KEY, view_context_proc.(conn))
-        end
-      end
-    end
-  end
-end