web_pipe 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 846bd7956d65605edaad299346280d7ae4b426d8cf4160e47ebac7375135b4e7
-  data.tar.gz: 41923761b8227c956f6b554bf8dc49fdc6323dc97e08399b5f8b4bc043552fdf
+  metadata.gz: 17cb26c4876d3063751dd001c823d57f3ada911be264407078b76bd8cfc684b5
+  data.tar.gz: 251591e61a0f30661a09ca507f28231e418fa9a626856613c8e171a67a107f37
 SHA512:
-  metadata.gz: b2de9d0a5e7f172e9c42fcf2e97b6ff22046552670c9cf096d270438aab9d572fb4bd915fba282e578f48b39c412ba867d8359881426073b936c9734b3e8a693
-  data.tar.gz: b72848b3ad1e98f18dea9da6b8dc19eef99c61ffb3f71115fd041b1fe699b5ca22bf0395f80e4fd16621d1b72ba8970a1555577126f148ffadf4768ed4a417b4
+  metadata.gz: 8ae7586e3ed9a3969d540609bad29257f0d7c5eb06c244ad954e7a10cce44507ce5b247a7f7a18ece6d3713969108e8c172aac85442f01d41824bd477270bbe1
+  data.tar.gz: d3a4900f7daf79377aaf7dd9ad3df397b5b55d16eb53d1ac025a029f9feb28e392819b969f9a64e5573216252db257f9e6f4ef359960c246b45321ed3708d6c7

data/.gitignore

@@ -9,3 +9,5 @@
 
 # rspec failure tracking
 .rspec_status
+
+Gemfile.lock

data/CHANGELOG.md

@@ -4,33 +4,86 @@ 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.5.0] - 2019-07-26
+### Added
+- **BREAKING**: `container` is now an extension
+  ([16](https://github.com/waiting-for-dev/web_pipe/pull/16)):
+ 
+It adds a `Conn#container` method, while the plug while being the same than before it has been moved to `web_pipe/extensions/container/plugs/container`.
+
+- Extension providing Integration with `dry-schema` [([18](https://github.com/waiting-for-dev/web_pipe/pull/18))]. See [`extensions/dry_schema.rb`](lib/web_pipe/extensions/dry_schema/dry_schema.rb).
+
+- No need to manually call `#to_proc` when composing plugs. This makes both of
+  the following valid
+  ([13](https://github.com/waiting-for-dev/web_pipe/pull/13)):
+
+```ruby
+plug :app, &App.new
+plug :app, App.new
+```
+
+- Extension adding flash functionality to conn ([15](https://github.com/waiting-for-dev/web_pipe/pull/15)).
+
+For this extension to work,
+[`Rack::Flash`](https://github.com/treeder/rack-flash) and `Rack::Session`
+middlewares must be used:
+
+```ruby
+require 'rack-flash'
+require 'rack/session/cookie'
+
+class App
+  include WebPipe
+  
+  use :session, Rack::Session::Cookie, secret: 'secret'
+  use :flash, Rack::Flash
+  
+  plug :put_in_flash, ->(conn) { conn.put_flash(:error, 'Error') }
+  plug :put_in_flash_now, ->(conn) { conn.put_flash_now(:error_now, 'Error now') }
+end
+```
+
+Usually you will expose `conn.flash` to your views.
+
+- Extension automatically require their associated plugs, so there is no need
+  to require them manually anymore. 
+
+### Fixed
+- Fixed bug not allowing middlewares to modify responses initially set with
+  default values ([14](https://github.com/waiting-for-dev/web_pipe/pull/14))
+
 ## [0.4.0] - 2019-07-17
 ### Added
-- **BREAKING**: Middlewares have to be named when used ([11](https://github.com/waiting-for-dev/web_pipe/pull/11)):
+- **BREAKING**: Middlewares have to be named when used
+  ([11](https://github.com/waiting-for-dev/web_pipe/pull/11)):
 
 ```ruby
 use :cookies, Rack::Session:Cookie, secret: 'my_secret', key: 'foo'
 ```
 
-- **BREAKING**: Middlewares have to be initialized when composed ([11](https://github.com/waiting-for-dev/web_pipe/pull/11)):
+- **BREAKING**: Middlewares have to be initialized when composed
+  ([11](https://github.com/waiting-for-dev/web_pipe/pull/11)):
 
 ```ruby
 use :pipe, PipeWithMiddlewares.new
 ```
 
-- **BREAKING**: The array of injected plugs is now scoped within a `plugs:` kwarg ([11](https://github.com/waiting-for-dev/web_pipe/pull/11)):
+- **BREAKING**: The array of injected plugs is now scoped within a `plugs:`
+  kwarg ([11](https://github.com/waiting-for-dev/web_pipe/pull/11)):
 
 ```ruby
 App.new(plugs: { nothing: ->(conn) { conn } })
 ```
 
-- Middlewares can be injected ([11](https://github.com/waiting-for-dev/web_pipe/pull/11)):
+- Middlewares can be injected
+  ([11](https://github.com/waiting-for-dev/web_pipe/pull/11)):
 
 ```ruby
 App.new(middlewares: { cache: [MyMiddleware, my_options] })
 ```
 
-- DSL helper method `compose` to add middlewares and plugs in order and in a single shot ([12](https://github.com/waiting-for-dev/web_pipe/pull/11)):
+- DSL helper method `compose` to add middlewares and plugs in order and in a
+  single shot ([12](https://github.com/waiting-for-dev/web_pipe/pull/11)):
 
 ```ruby
 class App
@@ -57,18 +110,23 @@ end
 
 ## [0.3.0] - 2019-07-12
 ### Added
-- **BREAKING**: When plugging with `plug:`, the operation is no longer specified through `with:`. Now it is just the second positional argument ([9](https://github.com/waiting-for-dev/web_pipe/pull/9)):
+- **BREAKING**: When plugging with `plug:`, the operation is no longer
+  specified through `with:`. Now it is just the second positional argument
+  ([9](https://github.com/waiting-for-dev/web_pipe/pull/9)):
 
 ```ruby
 plug :from_container, 'container'
 plug :inline, ->(conn) { conn.set_response_body('Hello world') }
 ```
-- It is possible to plug a block ([9](https://github.com/waiting-for-dev/web_pipe/pull/9)):
+- It is possible to plug a block
+  ([9](https://github.com/waiting-for-dev/web_pipe/pull/9)):
 ```ruby
   plug(:content_type) { |conn| conn.add_response_header('Content-Type', 'text/html') }
 ```
 
-- WebPipe plug's can be composed. A WebPipe proc representation is the composition of all its operations, which is an operation itself ([9](https://github.com/waiting-for-dev/web_pipe/pull/9)):
+- WebPipe plug's can be composed. A WebPipe proc representation is the
+  composition of all its operations, which is an operation itself
+  ([9](https://github.com/waiting-for-dev/web_pipe/pull/9)):
 
 ```ruby
 class HtmlApp
@@ -102,7 +160,8 @@ class App
 end
 ```
 
-- WebPipe's middlewares can be composed into another WebPipe class, also through `:use` ([10](https://github.com/waiting-for-dev/web_pipe/pull/10)):
+- WebPipe's middlewares can be composed into another WebPipe class, also
+  through `:use` ([10](https://github.com/waiting-for-dev/web_pipe/pull/10)):
 
 ```ruby
 class HtmlApp
@@ -121,12 +180,21 @@ end
 
 ## [0.2.0] - 2019-07-05
 ### Added
-- dry-view integration ([#1](https://github.com/waiting-for-dev/web_pipe/pull/1), [#3](https://github.com/waiting-for-dev/web_pipe/pull/3), [#4](https://github.com/waiting-for-dev/web_pipe/pull/4), [#5](https://github.com/waiting-for-dev/web_pipe/pull/5) and  [#6](https://github.com/waiting-for-dev/web_pipe/pull/6))
-- Configuring a container in `WebPipe::Conn` ([#2](https://github.com/waiting-for-dev/web_pipe/pull/2) and [#5](https://github.com/waiting-for-dev/web_pipe/pull/5))
-- Plug to set `Content-Type` response header ([#7](https://github.com/waiting-for-dev/web_pipe/pull/7))
+- dry-view integration
+  ([#1](https://github.com/waiting-for-dev/web_pipe/pull/1),
+  [#3](https://github.com/waiting-for-dev/web_pipe/pull/3),
+  [#4](https://github.com/waiting-for-dev/web_pipe/pull/4),
+  [#5](https://github.com/waiting-for-dev/web_pipe/pull/5) and
+  [#6](https://github.com/waiting-for-dev/web_pipe/pull/6))
+- Configuring a container in `WebPipe::Conn`
+  ([#2](https://github.com/waiting-for-dev/web_pipe/pull/2) and
+  [#5](https://github.com/waiting-for-dev/web_pipe/pull/5))
+- Plug to set `Content-Type` response header
+  ([#7](https://github.com/waiting-for-dev/web_pipe/pull/7))
 
 ### Fixed
-- Fix key interpolation in `KeyNotFoundInBagError` ([#8](https://github.com/waiting-for-dev/web_pipe/pull/8))
+- Fix key interpolation in `KeyNotFoundInBagError`
+  ([#8](https://github.com/waiting-for-dev/web_pipe/pull/8))
 
 ## [0.1.0] - 2019-05-07
 ### Added

data/README.md

@@ -212,7 +212,7 @@ end
 class App
   include WebPipe
 
-  plug :html, &HtmlApp.new
+  plug :html, HtmlApp.new
   plug :body
 
   private
@@ -321,8 +321,6 @@ WebPipe::App.new([op_1, op_2])
 `web_pipe` ships with a series of common operations you can take
 advantage in order to build your application:
 
-- [container](lib/web_pipe/plugs/container.rb): Allows
-  configuring a container to resolve dependencies.
 - [content_type](lib/web_pipe/plugs/content_type.rb): Sets
   `Content-Type` response header.
 
@@ -332,6 +330,8 @@ By default, `web_pipe` behavior is the very minimal you need to build
 a web application. However, you can extend it with the following
 extensions (click on each name for details on the usage):
 
+- [container](lib/web_pipe/plugs/container.rb): Allows
+  configuring a container to resolve dependencies.
 - [dry-view](lib/web_pipe/extensions/dry_view/dry_view.rb):
   Integration with [`dry-view`](https://dry-rb.org/gems/dry-view/)
   rendering system.

data/lib/web_pipe/app.rb

@@ -1,4 +1,3 @@
-require 'dry/initializer'
 require 'web_pipe/types'
 require 'web_pipe/conn'
 require 'web_pipe/conn_support/builder'
@@ -28,12 +27,14 @@ module WebPipe
 
     include Dry::Monads::Result::Mixin
 
-    include Dry::Initializer.define -> do
-      # @!attribute [r] operations
-      #   @return [Array<Operation[]>]
-      param :operations, type: Types.Array(
-              ConnSupport::Composition::Operation
-            )
+    # @!attribute [r] operations
+    #   @return [Array<Operation[]>]
+    attr_reader :operations
+
+    def initialize(operations)
+      @operations = Types.Array(
+        ConnSupport::Composition::Operation
+      )[operations]
     end
 
     # @param env [Hash] Rack env

data/lib/web_pipe/conn_support/composition.rb

@@ -1,4 +1,3 @@
-require 'dry/initializer'
 require 'dry/monads/result'
 require 'web_pipe/types'
 require 'web_pipe/conn'
@@ -41,10 +40,12 @@ module WebPipe
 
       include Dry::Monads::Result::Mixin
 
-      include Dry::Initializer.define -> do
-        # @!attribute [r] operations
-        #   @return [Array<Operation[]>]
-        param :operations, type: Types.Array(Operation)
+      # @!attribute [r] operations
+      #   @return [Array<Operation[]>]
+      attr_reader :operations
+
+      def initialize(operations)
+        @operations = Types.Array(Operation)[operations]
       end
 
       # @param conn [Conn]

data/lib/web_pipe/conn_support/errors.rb

@@ -12,5 +12,21 @@ module WebPipe
         )
       end
     end
+
+    # Error raised when trying to use a conn's feature which requires
+    # a rack middleware which is not present
+    class MissingMiddlewareError < RuntimeError
+      # @param feature [String] Name of the feature intended to be used
+      # @param middleware [String] Name of the missing middleware
+      # @param gem [String] Gem name for the middleware
+      def initialize(feature, middleware, gem)
+        super(
+          <<~eos
+            In order to use #{feature} you must use #{middleware} middleware:
+            https://rubygems.org/gems/#{gem}
+          eos
+        )
+      end
+    end
   end
 end

data/lib/web_pipe/conn_support/types.rb

@@ -34,15 +34,15 @@ module WebPipe
       Status = Strict::Integer.
                  default(200).
                  constrained(gteq: 100, lteq: 599)
-      ResponseBody = Interface(:each).default([''].freeze)
+      ResponseBody = Interface(:each).default { [''] }
 
       Headers = Strict::Hash.
                   map(Strict::String, Strict::String).
-                  default({}.freeze)
+                  default { {} }
 
       Bag = Strict::Hash.
               map(Strict::Symbol, Strict::Any).
-              default({}.freeze)
+              default { {} }
     end
   end
 end

data/lib/web_pipe/dsl/builder.rb

@@ -1,4 +1,3 @@
-require 'dry/initializer'
 require 'web_pipe/types'
 require 'web_pipe/dsl/class_context'
 require 'web_pipe/dsl/instance_methods'
@@ -16,17 +15,13 @@ module WebPipe
       
       # @!attribute [r] container
       # @return [Types::Container[]]
-
-
-      include Dry::Initializer.define -> do
-        option :container, type: Types::Container, default: proc { EMPTY_CONTAINER }
-      end
+      attr_reader :container
 
       # @return [ClassContext]
       attr_reader :class_context
 
-      def initialize(*args)
-        super
+      def initialize(container: EMPTY_CONTAINER)
+        @container = Types::Container[container]
         @class_context = ClassContext.new(container: container)
       end
       

data/lib/web_pipe/dsl/class_context.rb

@@ -1,4 +1,3 @@
-require 'dry-initializer'
 require 'web_pipe/types'
 require 'web_pipe/dsl/dsl_context'
 
@@ -22,17 +21,13 @@ module WebPipe
 
       # @!attribute [r] container
       # @return [Types::Container[]]
-
-
-      include Dry::Initializer.define -> do
-        option :container, type: Types::Container
-      end
+      attr_reader :container
 
       # @return [DSLContext]
       attr_reader :dsl_context
 
-      def initialize(*args)
-        super
+      def initialize(container:)
+        @container = Types::Container[container]
         @dsl_context = DSLContext.new([], [])
         define_container
         define_dsl

data/lib/web_pipe/dsl/dsl_context.rb

@@ -1,4 +1,4 @@
-require 'dry/initializer'
+require 'web_pipe'
 require 'web_pipe/types'
 require 'web_pipe/plug'
 require 'web_pipe/rack/middleware_specification'
@@ -14,17 +14,17 @@ module WebPipe
     class DSLContext
       # @!attribute middleware_specifications
       # @return [Array<Rack::MiddlewareSpecifications>]
+      attr_reader :middleware_specifications
 
       # @!attribute plugs
       # @return [Array<Plug>]
+      attr_reader :plugs
 
-
-      include Dry::Initializer.define -> do
-        param :middleware_specifications,
-              type: Types.Array(Rack::MiddlewareSpecification)
-
-        param :plugs,
-              type: Types.Array(Plug::Instance)
+      def initialize(middleware_specifications, plugs)
+        @middleware_specifications = Types.Array(
+          Rack::MiddlewareSpecification
+        )[middleware_specifications]
+        @plugs = Types.Array(Plug::Instance)[plugs]
       end
 
       # Creates and add rack middleware specifications to the stack.
@@ -42,22 +42,31 @@ module WebPipe
       #
       # @return [Array<Rack::Middleware>]
       def use(name, *spec)
-        middleware_specifications << Rack::MiddlewareSpecification.new(name, spec)
+        middleware_specifications << Rack::MiddlewareSpecification.new(name: name, spec: spec)
       end
 
       # Creates and adds a plug to the stack.
       #
-      # The spec can be given as a {Plug::Spec} or as a block, which
-      # is captured into a {Proc} (one of the options for a
-      # {Plug::Spec}.
+      # The spec can be given as a {Plug::Spec}, as a block (which
+      # is captured into a {Proc}, one of the options for a
+      # {Plug::Spec} or as a {WebPipe} (in which case all its plugs
+      # will be composed).
       #
       # @param name [Plug::Name[]]
-      # @param spec [Plug::Spec[]]
+      # @param spec [Plug::Spec[], WebPipe]
       # @param block_spec [Proc]
       #
       # @return [Array<Plug>]
       def plug(name, spec = nil, &block_spec)
-        plugs << Plug.new(name, spec || block_spec)
+        plug_spec = if spec.is_a?(WebPipe)
+                 spec.to_proc
+               elsif spec
+                 spec
+               else
+                 block_spec
+               end
+
+        plugs << Plug.new(name: name, spec: plug_spec)
       end
 
       # Adds middlewares and plugs from a WebPipe to respective
@@ -67,7 +76,7 @@ module WebPipe
       # @param spec [WebPipe]
       def compose(name, spec)
         use(name, spec)
-        plug(name, &spec)
+        plug(name, spec)
       end
     end
   end

data/lib/web_pipe/dsl/instance_methods.rb

@@ -1,4 +1,3 @@
-require 'dry/initializer'
 require 'web_pipe/types'
 require 'web_pipe/conn'
 require 'web_pipe/app'
@@ -36,13 +35,7 @@ module WebPipe
       # @!attribute [r] injections [Injections[]]
       #   Injected plugs and middlewares that allow overriding what
       # has been configured.
-
-
-      include Dry::Initializer.define -> do
-        param :injections,
-              default: proc { EMPTY_INJECTIONS },
-              type: Injections
-      end
+      attr_reader :injections
 
       # @return [Rack::AppWithMiddlewares[]]
       attr_reader :rack_app
@@ -53,8 +46,8 @@ module WebPipe
       # @return [Array<Rack::Middlewares>]
       attr_reader :middlewares
 
-      def initialize(*args)
-        super
+      def initialize(injects = EMPTY_INJECTIONS)
+        @injections = Injections[injects]
         container = self.class.container
         @middlewares = Rack::MiddlewareSpecification.inject_and_resolve(
           self.class.middleware_specifications, injections[:middlewares]

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

@@ -0,0 +1,30 @@
+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}.
+  #
+  # @example
+  #   require 'web_pipe'
+  #
+  #   WebPipe.load_extensions(:container)
+  #
+  #   class App
+  #     include WebPipe
+  #
+  #     plug :container, WebPipe::Plugs::Container[MyContainer]
+  #     plug :render, ->(conn) { conn.set_response_body(conn.container['view']) }
+  #   end
+  module Container
+    # Returns bag `:container` value
+    #
+    # @return [Any]
+    def container
+      fetch(:container)
+    end
+  end
+
+  Conn.include(Container)
+end

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

@@ -0,0 +1,78 @@
+require 'web_pipe'
+
+module WebPipe
+  # Integration with `dry-schema` validation library.
+  #
+  # This extension provides a simple integration with `dry-schema`
+  # library to streamline param sanitization.
+  #
+  # 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.
+  #
+  # 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`:
+  #
+  # @example
+  #  require 'web_pipe'
+  #
+  #  WebPipe.load_extensions(:dry_schema)
+  #
+  #  class App
+  #    include WebPipe
+  #
+  #    Schema = Dry::Schema.Params do
+  #      required(:name).filled(:string)
+  #    end
+  #
+  #    plug :sanitize_params, WebPipe::Plugs::SanitizeParams[Schema]
+  #    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 tainted 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:
+  #
+  # @example
+  #  class App
+  #    plug :sanitization_handler, WebPipe::Plugs::ParamSanitizationHandler[
+  #                                  ->(conn, result) { ... }
+  #                                ]
+  #  end
+  #
+  #  class Subapp
+  #    Schema = Dry::Schema.Params { ... }
+  #
+  #    plug :app, App.new
+  #    plug :sanitize_params, WebPipe::Plugs::SanitizeParams[Schema]
+  #  end
+  #
+  # @see https://dry-rb.org/gems/dry-schema/
+  module DrySchema
+    SANITIZED_PARAMS_KEY = :sanitized_params
+
+    def sanitized_params
+      fetch(SANITIZED_PARAMS_KEY)
+    end
+  end
+
+  Conn.include(DrySchema)
+end

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

@@ -0,0 +1,27 @@
+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.put(PARAM_SANITIZATION_HANDLER_KEY, Handler[handler])
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,46 @@
+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
+    # Sanitize {Conn#params} with given `dry-schema` Schema.
+    #
+    # @see WebPipe::DrySchema
+    module SanitizeParams
+      # Default handler if none is configured nor injected.
+      #
+      # @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').
+          taint
+      end
+
+      # @param schema [Dry::Schema::Processor]
+      # @param handler [ParamSanitizationHandler::Handler[]]
+      #
+      # @return [ConnSupport::Composition::Operation[], Types::Undefined]
+      def self.[](schema, handler = Types::Undefined)
+        lambda do |conn|
+          result = schema.(conn.params)
+          if result.success?
+            conn.put(DrySchema::SANITIZED_PARAMS_KEY, result.output)
+          else
+            get_handler(conn, handler).(conn, result)
+          end
+        end
+      end
+
+      def self.get_handler(conn, handler)
+        return handler unless handler == Types::Undefined
+
+        conn.fetch(
+          Plugs::ParamSanitizationHandler::PARAM_SANITIZATION_HANDLER_KEY, DEFAULT_HANDLER
+        )
+      end
+      private_class_method :get_handler
+    end
+  end
+end

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

@@ -29,10 +29,12 @@ module WebPipe
   #   end
   #
   # If {WebPipe::Conn#bag} has a `:container` key, the view instance
-  # can be resolved from it. {WebPipe::Plugs::Container} can be used
-  # to streamline this integration.
+  # can be resolved from it. {WebPipe::Container} extension can be
+  # used to streamline this integration.
   #
   # @example
+  #   WebPipe.load_extensions(:dry_view, :container)
+  #
   #   class App
   #     include WebPipe
   #
@@ -100,7 +102,8 @@ module WebPipe
   #  # ...
   #   
   # @see https://dry-rb.org/gems/dry-view/
-  class Conn < Dry::Struct
+  # @see WebPipe::Container
+  module DryView
     # Where to find in {#bag} request's view context
     VIEW_CONTEXT_KEY = :view_context
 
@@ -153,4 +156,6 @@ module WebPipe
       kwargs.merge(context: context)
     end
   end
+
+  Conn.include(DryView)
 end

data/lib/web_pipe/extensions/flash/flash.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require 'web_pipe/conn'
+require 'web_pipe/conn_support/errors'
+
+module WebPipe
+  # Provides with a tipical flash messages functionality.
+  #
+  # @example
+  #   require 'web_pipe'
+  #   require 'rack/session/cookie'
+  #   require 'rack-flash'
+  #
+  #   WebPipe.load_extensions(:flash)
+  #   
+  #   class MyApp
+  #     include WebPipe
+  #
+  #     use :session, Rack::Session::Cookie, secret: 'secret'
+  #     use :flash, Rack::Flash
+  #
+  #     plug :put_in_flash, ->(conn) { conn.put_flash(:notice, 'Hello world') }
+  #     plug :put_in_flash_now, ->(conn) { conn.put_flash_now(:notice_now, 'Hello world now') }
+  #   end
+  #
+  # Usually, you will end up making `conn.flash` available to your view system:
+  #
+  # @example
+  #   <div class="notice"><%= flash[:notice] %></div>
+  #
+  # For this extension to be used, `Rack::Flash` middleware must be
+  # added to the stack (gem name is `rack-flash3`. This middleware in
+  # turns depend on `Rack::Session` middleware.
+  #
+  # This extension is a very simple wrapper around `Rack::Flash` API.
+  #
+  # @see https://github.com/nakajima/rack-flash
+  module Flash
+    RACK_FLASH_KEY = 'x-rack.flash'
+    
+    # Returns the flash bag.
+    #
+    # @return [Rack::Flash::FlashHash]
+    #
+    # @raises ConnSupport::MissingMiddlewareError when `Rack::Flash`
+    # is not being used as middleware
+    def flash
+      env.fetch(RACK_FLASH_KEY) do
+        raise ConnSupport::MissingMiddlewareError.new(
+                'flash', 'Rack::Flash', 'rack-flash3'
+              )
+      end
+    end
+
+    # Puts an item to the flash bag to be consumed by next request.
+    #
+    # @param key [String]
+    # @param value [String]
+    def put_flash(key, value)
+      flash[key] = value
+      self
+    end
+
+    # Puts an item to the flash bag to be consumed by the same request
+    # in process.
+    #
+    # @param key [String]
+    # @param value [String]
+    def put_flash_now(key, value)
+      flash.now[key] = value
+      self
+    end
+  end
+
+  Conn.include(Flash)
+end

data/lib/web_pipe/plug.rb

@@ -1,4 +1,4 @@
-require 'dry/initializer'
+require 'dry/struct'
 require 'web_pipe/types'
 require 'web_pipe/conn_support/composition'
 
@@ -17,7 +17,7 @@ module WebPipe
   # from the `container`.
   #
   # @api private
-  class Plug
+  class Plug < Dry::Struct
     # Error raised when no operation can be resolved from a {Spec}.
     class InvalidPlugError < ArgumentError
       # @param name [Any] Name for the plug that can't be resolved
@@ -55,23 +55,18 @@ module WebPipe
 
     # @!attribute [r] name
     #   @return [Name[]]
+    attribute :name, Name
 
     # @!attribute [r] spec
     #   @return [Spec[]]
-
-
-    include Dry::Initializer.define -> do
-      param :name, Name
-
-      param :spec, Spec
-    end
+    attribute :spec, Spec
 
     # Creates a new instance with given `spec` but keeping `name`.
     #
     # @param new_spec [Spec[]]
     # @return [self]
     def with(new_spec)
-      self.class.new(name, new_spec)
+      new(spec: new_spec)
     end
 
     # Resolves the operation.

data/lib/web_pipe/rack/app_with_middlewares.rb

@@ -1,4 +1,3 @@
-require 'dry/initializer'
 require 'web_pipe/types'
 require 'web_pipe/rack/middleware'
 require 'rack'
@@ -17,23 +16,18 @@ module WebPipe
 
       # @!attribute [r] rack_middlewares
       # @return [Array<RackMiddleware>]
+      attr_reader :rack_middlewares
 
       # @!attribute [r] app
       # @return [App[]]
-
-
-      include Dry::Initializer.define -> do
-        param :rack_middlewares,
-              type: Types.Array(Middleware)
-
-        param :app, type: App
-      end
+      attr_reader :app
 
       # @return [Rack::Builder]
       attr_reader :builder
       
-      def initialize(*args)
-        super
+      def initialize(rack_middlewares, app)
+        @rack_middlewares = Types.Array(Middleware)[rack_middlewares]
+        @app = App[app]
         @builder = build_rack_app(rack_middlewares, app)
       end
 

data/lib/web_pipe/rack/middleware.rb

@@ -1,4 +1,3 @@
-require 'dry/initializer'
 require 'web_pipe/types'
 require 'dry/struct'
 

data/lib/web_pipe/rack/middleware_specification.rb

@@ -1,3 +1,4 @@
+require 'dry/struct'
 require 'web_pipe/rack/middleware'
 require 'web_pipe/types'
 
@@ -14,7 +15,7 @@ module WebPipe
     # for that {WebPipe}.
     #
     # @api private
-    class MiddlewareSpecification
+    class MiddlewareSpecification < Dry::Struct
       # Type for the name given to a middleware.
       Name = Types::Strict::Symbol.constructor(&:to_sym)
 
@@ -30,16 +31,11 @@ module WebPipe
 
       # @!attribute [r] name
       #   @return [Name[]]
+      attribute :name, Name
 
       # @!attribute [r] spec
       #   @return [Spec[]]
-
-
-      include Dry::Initializer.define -> do
-        param :name, Name
-
-        param :spec, Spec
-      end
+      attribute :spec, Spec
 
       # Change spec's present in `injections` and resolves.
       #
@@ -76,7 +72,7 @@ module WebPipe
       # 
       # @return [MiddlewareSpecification]
       def with(new_spec)
-        self.class.new(name, new_spec)
+        new(spec: new_spec)
       end
     end
   end

data/lib/web_pipe/version.rb

@@ -1,3 +1,3 @@
 module WebPipe
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

data/lib/web_pipe.rb

@@ -16,7 +16,23 @@ module WebPipe
     DSL::Builder.new(*args)
   end
 
+  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
 end

data/web_pipe.gemspec

@@ -39,7 +39,6 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency "dry-monads", "~> 1.2"
   spec.add_runtime_dependency "dry-types", "~> 1.1"
   spec.add_runtime_dependency "dry-struct", "~> 1.0"
-  spec.add_runtime_dependency "dry-initializer", "~> 3.0"
 
   spec.add_development_dependency "bundler", "~> 1.17"
   spec.add_development_dependency "rake", "~> 10.0"
@@ -49,4 +48,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "redcarpet", "~> 3.4"
   spec.add_development_dependency "pry-byebug"
   spec.add_development_dependency "dry-view", "~> 0.7"
+  spec.add_development_dependency "rack-flash3", "~> 1.0"
+  spec.add_development_dependency "dry-schema", "~> 1.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: web_pipe
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Marc Busqué
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-07-17 00:00:00.000000000 Z
+date: 2019-07-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack
@@ -66,20 +66,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: dry-initializer
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -198,6 +184,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: rack-flash3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: dry-schema
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 description: 
 email:
 - marc@lamarciana.com
@@ -211,7 +225,6 @@ files:
 - ".yardopts"
 - CHANGELOG.md
 - Gemfile
-- Gemfile.lock
 - README.md
 - Rakefile
 - bin/console
@@ -229,11 +242,16 @@ files:
 - lib/web_pipe/dsl/class_context.rb
 - 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/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/plug.rb
 - lib/web_pipe/plugs.rb
-- lib/web_pipe/plugs/container.rb
 - lib/web_pipe/plugs/content_type.rb
 - lib/web_pipe/rack/app_with_middlewares.rb
 - lib/web_pipe/rack/middleware.rb

data/Gemfile.lock

@@ -1,99 +0,0 @@
-PATH
-  remote: .
-  specs:
-    web_pipe (0.3.0)
-      dry-initializer (~> 3.0)
-      dry-monads (~> 1.2)
-      dry-struct (~> 1.0)
-      dry-types (~> 1.1)
-      rack (~> 2.0)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    byebug (11.0.0)
-    coderay (1.1.2)
-    concurrent-ruby (1.1.5)
-    diff-lcs (1.3)
-    dry-configurable (0.8.2)
-      concurrent-ruby (~> 1.0)
-      dry-core (~> 0.4, >= 0.4.7)
-    dry-container (0.7.1)
-      concurrent-ruby (~> 1.0)
-      dry-configurable (~> 0.1, >= 0.1.3)
-    dry-core (0.4.7)
-      concurrent-ruby (~> 1.0)
-    dry-equalizer (0.2.2)
-    dry-inflector (0.1.2)
-    dry-initializer (3.0.1)
-    dry-logic (1.0.2)
-      concurrent-ruby (~> 1.0)
-      dry-core (~> 0.2)
-      dry-equalizer (~> 0.2)
-    dry-monads (1.2.0)
-      concurrent-ruby (~> 1.0)
-      dry-core (~> 0.4, >= 0.4.4)
-      dry-equalizer
-    dry-struct (1.0.0)
-      dry-core (~> 0.4, >= 0.4.3)
-      dry-equalizer (~> 0.2)
-      dry-types (~> 1.0)
-      ice_nine (~> 0.11)
-    dry-types (1.1.0)
-      concurrent-ruby (~> 1.0)
-      dry-container (~> 0.3)
-      dry-core (~> 0.4, >= 0.4.4)
-      dry-equalizer (~> 0.2, >= 0.2.2)
-      dry-inflector (~> 0.1, >= 0.1.2)
-      dry-logic (~> 1.0, >= 1.0.2)
-    dry-view (0.7.0)
-      dry-configurable (~> 0.1)
-      dry-core (~> 0.2)
-      dry-equalizer (~> 0.2)
-      dry-inflector (~> 0.1)
-      tilt (~> 2.0, >= 2.0.6)
-    ice_nine (0.11.2)
-    method_source (0.9.2)
-    pry (0.12.2)
-      coderay (~> 1.1.0)
-      method_source (~> 0.9.0)
-    pry-byebug (3.7.0)
-      byebug (~> 11.0)
-      pry (~> 0.10)
-    rack (2.0.6)
-    rack-test (1.1.0)
-      rack (>= 1.0, < 3)
-    rake (10.5.0)
-    redcarpet (3.4.0)
-    rspec (3.8.0)
-      rspec-core (~> 3.8.0)
-      rspec-expectations (~> 3.8.0)
-      rspec-mocks (~> 3.8.0)
-    rspec-core (3.8.0)
-      rspec-support (~> 3.8.0)
-    rspec-expectations (3.8.2)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-mocks (3.8.0)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-support (3.8.0)
-    tilt (2.0.9)
-    yard (0.9.20)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  bundler (~> 1.17)
-  dry-view (~> 0.7)
-  pry-byebug
-  rack-test (~> 1.1)
-  rake (~> 10.0)
-  redcarpet (~> 3.4)
-  rspec (~> 3.0)
-  web_pipe!
-  yard (~> 0.9, >= 0.9.20)
-
-BUNDLED WITH
-   1.17.2