web_pipe 0.10.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb774cbbdd90831e9ffcd5dba76265c37585b65f56618aff8cfa311b78d2bea8
-  data.tar.gz: c456b68f6995308a740dacf97bb7177f140c51757fa6f680ecc7e515036d37a0
+  metadata.gz: 248232882dde49a235e15080f2c9c2abb1188e29e10f228f43d0c30c6c5f116f
+  data.tar.gz: ad6afa0399cdb99d80ef46fb1bcdde037e987e8fe01756f2c667301a9f622d5e
 SHA512:
-  metadata.gz: 118d6af2b98c082fa174b33e092744d82a5e2667e20bc717ef996fa9da1b934d44a618331527d2c328d02ce2ea0dc62b3649800f326cfc7516f9ba3ba23c8797
-  data.tar.gz: 32cb91bec0de9aaab6f48d48f4c68334a64fc3c5e944be4f6c20fccaacf1dab928b59809b0e50c129306d43951f0ef028812ab6196503cfff1d830cf8b5e658a
+  metadata.gz: 399f912c144ac66bd1bfeaf58708a8e52ed7e296f5e592c9f9422fd3fd6553a4e3c16c0fec2986cf4fd278857d5acd1078d7b1a7e9e0e07ad9f18824303953ba
+  data.tar.gz: 41c539bee15aa9d3f8ae23bc88cd02ba5dc113ad9245290c330a269917716d12da5637852153d2f9bd7b324e8101f2a1329b267e5ebc409ae0c5cb419cd932f8

data/.gitignore

@@ -10,4 +10,8 @@
 # rspec failure tracking
 .rspec_status
 
-Gemfile.lock
+Gemfile.lock
+
+Dockerfile
+docker-compose.yml
+.dockerignore

data/.rubocop.yml

@@ -0,0 +1,18 @@
+AllCops:
+  TargetRubyVersion: 2.7.2
+  NewCops: enable
+  SuggestExtensions: false
+  Exclude:
+    - "*.gemspec"
+    - vendor/**/*
+    - Gemfile
+
+Metrics/BlockLength:
+  Exclude:
+    - spec/**/*
+
+Naming/AccessorMethodName:
+  Enabled: false
+
+Style/HashConversion:
+  Enabled: false

data/.travis.yml

@@ -1,10 +1,11 @@
-sudo: false
 language: ruby
+cache: bundler
 rvm:
-  - 2.4
-  - 2.5
   - 2.6
+  - 2.7
+  - 3.0
 before_install:
   - gem update --system --no-doc
 script:
-  - bundle exec rspec
+  - bundle exec rspec
+  - bundle exec rubocop

data/CHANGELOG.md

@@ -4,6 +4,43 @@ 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.14.0] - 2021-04-14
+### Added
+- Inspecting operations
+  [#42](https://github.com/waiting-for-dev/web_pipe/pull/42)
+- Inspecting middlewares
+  [#43](https://github.com/waiting-for-dev/web_pipe/pull/43)
+- Testing support
+  [#44](https://github.com/waiting-for-dev/web_pipe/pull/44)
+
+## [0.13.0] - 2021-01-15
+### Added
+- **BREAKING**. Ruby 2.5 deprecated.
+  [#40](https://github.com/waiting-for-dev/web_pipe/pull/40)
+-  Ruby 3.0 supported.
+  [#41](https://github.com/waiting-for-dev/web_pipe/pull/41)
+
+## [0.12.1] - 2019-03-18
+### Fixed
+- Update rake to fix security alert
+
+## [0.12.0] - 2019-12-30
+### Added
+- **BREAKING**. Ruby 2.4 deprecated.
+-  Ruby 2.7 supported.
+
+### Fixed
+- Ruby 2.7 argument warnings.
+  [[#38]](https://github.com/waiting-for-dev/web_pipe/pull/38)
+
+## [0.11.0] - 2019-12-28
+### Added
+- **BREAKING**. `dry-transformer` (former `transproc`) dependency is now
+  optional.
+  [[#37]](https://github.com/waiting-for-dev/web_pipe/pull/37)
+- Switch `transproc` dependency to `dry-transformer`.
+  [[#37]](https://github.com/waiting-for-dev/web_pipe/pull/37)
+
 ## [0.10.0] - 2019-11-15
 ### Added
 - `:rails` extension integrating with Ruby On Rails.

data/Gemfile

@@ -6,3 +6,8 @@ git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 
 # Specify your gem's dependencies in web_pipe.gemspec
 gemspec
+
+# TODO: Remove when dry-rb 0.8 is released (ruby 3.0 support)
+group :development do
+  gem 'dry-view', github: 'dry-rb/dry-view', ref: 'a048e32'
+end

data/README.md

@@ -20,9 +20,11 @@ extension](docs/extensions/rails.md).
    1. [Resolving operations](docs/plugging_operations/resolving_operations.md)
    1. [Injecting operations](docs/plugging_operations/injecting_operations.md)
    1. [Composing operations](docs/plugging_operations/composing_operations.md)
+   1. [Inspecting operations](docs/plugging_operations/inspecting_operations.md)
 1. [Using rack middlewares](docs/using_rack_middlewares.md)
    1. [Injecting middlewares](docs/using_rack_middlewares/injecting_middlewares.md)
    1. [Composing middlewares](docs/using_rack_middlewares/composing_middlewares.md)
+   1. [Inspecting middlewares](docs/using_rack_middlewares/inspecting_middlewares.md)
 1. [Composing applications](docs/composing_applications.md)
 1. [Connection struct](docs/connection_struct.md)
    1. [Sharing data downstream](docs/connection_struct/sharing_data_downstream.md)
@@ -32,6 +34,7 @@ extension](docs/extensions/rails.md).
 1. [Plugs](docs/plugs.md)
    1. [Config](docs/plugs/config.md)
    1. [ContentType](docs/plugs/content_type.md)
+1. [Testing](docs/testing.md)
 1. [Extensions](docs/extensions.md)
    1. [Container](docs/extensions/container.md)
    1. [Cookies](docs/extensions/cookies.md)
@@ -92,10 +95,9 @@ run HelloApp.new
 
 ## Current status
 
-`web_pipe` is in active development. The very basic features to build
-a rack application are all available. However, very necessary
-conveniences to build a production application, for example a session
-mechanism, are still missing.
+`web_pipe` is in active development but ready to be used in any environment.
+Common needs are covered and while you can expect some API changes, they won't
+be very important and everything will be properly documented.
 
 ## Contributing
 

data/docs/connection_struct.md

@@ -75,3 +75,14 @@ Immutability is a core design principle in `web_pipe`. All methods in
 `WebPipe::Conn` which are used to add data to it (both in core behaviour and
 extensions) return a fresh new instance. It also makes possible chaining
 methods in a very readable way.
+
+You can use ruby 2.7 pattern matching on a `WebPipe::Conn` struct, as in:
+
+```ruby
+# GET http://example.org
+conn in { request_method:, host: }
+request_method
+# :get
+host
+# 'example.org'
+```

data/docs/extensions/params.md

@@ -12,9 +12,10 @@ conn.params # => { 'foo' => 'bar' }
 ```
 
 You can configure a stack of transformations to be applied to the
-parameter hash. For that, we lean on [`transproc`
-gem](https://github.com/solnic/transproc) (you have to add it yourself to your
-Gemfile). All hash transformations in `transproc` are available by default.
+parameter hash. For that, we lean on [`dry-transformer`
+gem](https://github.com/dry-rb/dry-transformer) (you have to add it yourself to
+your Gemfile). All hash transformations in `dry-transformer` are available by
+default.
 
 Transformations must be configured under `:param_transformations`
 key:

data/docs/extensions/rails.md

@@ -36,7 +36,7 @@ option that will play specially well here is
 itself easily with Rails. Furthermore, we have a tailored `dry_view`
 [extension](https://waiting-for-dev.github.io/web_pipe/docs/extensions/dry_view.html).
 
-You need to use this extension if:
+You need to use `:rails` extension if:
 
 - You want to use `action_view` as rendering system.
 - You want to use rails url helpers from your `WebPipe` application.
@@ -50,7 +50,6 @@ some behaviour for the view layer:
 
 - Which layout is applied to the template.
 - Which helpers will become available to the templates.
-- Where within `app/views/` templates are looked up.
 
 By default, the controller in use is `ActionController::Base`, which means that
 no layout is applied and only built-in helpers (for example,
@@ -95,7 +94,9 @@ end
 
 Notice that we used the keyword `template:` instead of taking advantage of
 automatic template lookup. We did that way so that we don't have to create also
-an `ArticlesController`, but it's up to you.
+an `ArticlesController`, but it's up to you. In the case of having an
+`ArticlesController` we could just do `conn.render(:index, assigns: {
+articles: Article.all })`.
 
 Besides, this extension provides with two other methods:
 

data/docs/plugging_operations/inspecting_operations.md

@@ -0,0 +1,25 @@
+# Inspecting operations
+
+Once a `WebPipe` class is initialized all its operations get resolved. It
+happens because they are whether [resolved](resolving_operations.md) or
+[injected](injecting_operations.md). The final result can be accessed through
+the `#operations` method:
+
+
+```ruby
+require 'web_pipe'
+require 'web_pipe/conn_support/builder'
+
+class MyApp
+  include WebPipe
+
+  plug(:hello) do |conn|
+    conn.set_response_body('Hello world!')
+  end
+end
+
+app = MyApp.new
+conn = WebPipe::ConnSupport::Builder.call(Rack::MockRequest.env_for)
+new_conn = app.operations[:hello].call(con)
+conn.response_body #=> ['Hello world!']
+```

data/docs/testing.md

@@ -0,0 +1,64 @@
+# Testing
+
+## Testing the rack application
+
+A `WebPipe` instance is a just a rack application, so you can test it as such:
+
+```ruby
+require 'web_pipe'
+require 'rack/mock'
+require 'rspec'
+
+class MyApp
+  include WebPipe
+
+  plug :response
+
+  private
+
+  def response(conn)
+    conn
+      .set_response_body('Hello!')
+      .set_status(200)
+  end
+end
+
+RSpec.describe MyApp do
+  it 'responds with 200 status code' do
+    env = Rack::MockRequest.env_for
+
+    status, _headers, _body = described_class.new.call(env)
+
+    expect(status).to be(200)
+  end
+end
+```
+
+## Testing individual operations
+
+Each operation in a pipe is an isolated function that takes a connection struct
+as argument. You can leverage [the inspection of
+operations](docs/plugging_operations/inspecting_operations.md) to unit test them.
+
+There's also a `WebPipe::TestSupport` module that you can include to get a
+helper method `#build_conn` to easily create a connection struct.
+
+```ruby
+RSpec.describe MyApp do
+  include WebPipe::TestSupport
+
+  describe '#response' do
+    it 'responds with 200 status code' do
+      conn = build_conn
+      operation = described_class.new.operations[:response]
+
+      new_conn = operation.call(conn)
+
+      expect(new_conn.status).to be(200)
+    end
+  end
+end
+```
+
+Check the API documentation for the options you can provide to
+[`#build_conn`](https://www.rubydoc.info/github/waiting-for-dev/web_pipe/master/WebPipe/TestSupport#build_conn).

data/docs/using_rack_middlewares/inspecting_middlewares.md

@@ -0,0 +1,34 @@
+# Inspecting middlewares
+
+Once a `WebPipe` class is initialized all its middlewares get resolved. They
+can be accessed through the `#middlewares` method.
+
+Each middleware is represented by a
+`WebPipe::RackSupport::MiddlewareSpecification` instance, which contains two
+accessors: `middleware` returns the middleware class, while `options` returns
+an array with the arguments that are provided to the middleware on initialization.
+
+Kepp in mind that every middleware is resolved as an array. This is because it
+can in fact be composed by an chain of middlewares built through
+[composition](composing_middlewares.md).
+
+
+```ruby
+require 'web_pipe'
+require 'rack/session'
+
+class MyApp
+  include WebPipe
+  
+  use :session, Rack::Session::Cookie, key: 'my_app.session', secret: 'long'
+
+  plug(:hello) do |conn|
+    conn.set_response_body('Hello world!')
+  end
+end
+
+app = MyApp.new
+session_middleware = app.middlewares[:session][0]
+session_middleware.middleware # => Rack::Session::Cookie
+session_middleware.options # => [{ key: 'my_app.session', secret: 'long' }]
+```

data/lib/web_pipe.rb

@@ -14,8 +14,8 @@ module WebPipe
     klass.include(call)
   end
 
-  def self.call(*args)
-    DSL::Builder.new(*args)
+  def self.call(**opts)
+    DSL::Builder.new(**opts)
   end
 
   register_extension :cookies do

data/lib/web_pipe/conn_support/builder.rb

@@ -15,12 +15,12 @@ module WebPipe
       # @param env [Types::Env] Rack's env
       #
       # @return [Conn::Ongoing]
+      # rubocop:disable Metrics/MethodLength
       def self.call(env)
         rr = Rack::Request.new(env)
         Conn::Ongoing.new(
           request: rr,
           env: env,
-
           scheme: rr.scheme.to_sym,
           request_method: rr.request_method.downcase.to_sym,
           host: rr.host,
@@ -33,6 +33,7 @@ module WebPipe
           request_headers: Headers.extract(env)
         )
       end
+      # rubocop:enable Metrics/MethodLength
     end
   end
 end

data/lib/web_pipe/conn_support/composition.rb

@@ -28,11 +28,11 @@ module WebPipe
         # @param returned [Any] What was returned from the {Operation}
         def initialize(returned)
           super(
-            <<~eos
+            <<~MSG
               An operation returned +#{returned.inspect}+. To be valid,
               an operation must return whether a
               WebPipe::Conn::Ongoing or a WebPipe::Conn::Halted.
-            eos
+            MSG
           )
         end
       end

data/lib/web_pipe/conn_support/errors.rb

@@ -8,9 +8,9 @@ module WebPipe
       # @param key [Any] Key not found in the bag
       def initialize(key)
         super(
-          <<~eos
+          <<~MSG
             Bag does not contain a key with name +#{key}+.
-          eos
+          MSG
         )
       end
     end
@@ -21,9 +21,9 @@ module WebPipe
       # @param key [Any] Key not found in config
       def initialize(key)
         super(
-          <<~eos
+          <<~MSG
             Config does not contain a key with name +#{key}+.
-          eos
+          MSG
         )
       end
     end
@@ -36,10 +36,10 @@ module WebPipe
       # @param gem [String] Gem name for the middleware
       def initialize(feature, middleware, gem)
         super(
-          <<~eos
+          <<~MSG
             In order to use #{feature} you must use #{middleware} middleware:
             https://rubygems.org/gems/#{gem}
-          eos
+          MSG
         )
       end
     end

data/lib/web_pipe/conn_support/headers.rb

@@ -25,7 +25,7 @@ module WebPipe
         Hash[
           env
           .select { |k, _v| k.start_with?('HTTP_') }
-          .map { |k, v| pair(k[5..-1], v) }
+          .map { |k, v| pair(k[5..], v) }
           .concat(
             env
               .select { |k, _v| HEADERS_AS_CGI.include?(k) }
@@ -99,9 +99,7 @@ module WebPipe
       #
       # @see #normalize_key
       def self.normalize(headers)
-        Hash[
-          headers.map { |k, v| [normalize_key(k), v] }
-        ]
+        headers.transform_keys { |k| normalize_key(k) }
       end
     end
   end

data/lib/web_pipe/dsl/builder.rb

@@ -25,6 +25,7 @@ module WebPipe
       def initialize(container: EMPTY_CONTAINER)
         @container = Types::Container[container]
         @class_context = ClassContext.new(container: container)
+        super()
       end
 
       def included(klass)

data/lib/web_pipe/dsl/class_context.rb

@@ -33,6 +33,7 @@ module WebPipe
         @dsl_context = DSLContext.new([], [])
         define_container
         define_dsl
+        super()
       end
 
       private

data/lib/web_pipe/dsl/dsl_context.rb

@@ -66,7 +66,7 @@ module WebPipe
                       spec
                     else
                       block_spec
-               end
+                    end
 
         plugs << Plug.new(name: name, spec: plug_spec)
       end

data/lib/web_pipe/dsl/instance_methods.rb

@@ -42,12 +42,13 @@ module WebPipe
       # @return [RackSupport::AppWithMiddlewares[]]
       attr_reader :rack_app
 
-      # @return [ConnSupport::Composition::Operation[]]
+      # @return [Hash<Plug::Name[], ConnSupport::Composition::Operation[]>]
       attr_reader :operations
 
-      # @return [Array<RackSupport::Middlewares>]
+      # @return [Hash<RackSupport::MiddlewareSpecification::Name[], Array<RackSupport::Middlewares>]
       attr_reader :middlewares
 
+      # rubocop:disable Metrics/AbcSize
       def initialize(injects = EMPTY_INJECTIONS)
         @injections = Injections[injects]
         container = self.class.container
@@ -57,9 +58,10 @@ module WebPipe
         @operations = Plug.inject_and_resolve(
           self.class.plugs, injections[:plugs], container, self
         )
-        app = App.new(operations)
-        @rack_app = RackSupport::AppWithMiddlewares.new(middlewares, app)
+        app = App.new(operations.values)
+        @rack_app = RackSupport::AppWithMiddlewares.new(middlewares.values.flatten, app)
       end
+      # rubocop:enable Metrics/AbcSize
 
       # Expected interface for rack.
       #
@@ -103,7 +105,7 @@ module WebPipe
       # @see ConnSupport::Composition
       def to_proc
         ConnSupport::Composition
-          .new(operations)
+          .new(operations.values)
           .method(:call)
           .to_proc
       end

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

@@ -2,6 +2,7 @@
 
 require 'web_pipe'
 
+#:nodoc:
 module WebPipe
   # Extension adding a `#container` method which returns {Conn#config}
   # `:container` key.

data/lib/web_pipe/extensions/cookies/cookies.rb

@@ -4,6 +4,7 @@ require 'web_pipe'
 require 'web_pipe/types'
 require 'rack/utils'
 
+#:nodoc:
 module WebPipe
   # Extension to help dealing with request and response cookies.
   #

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

@@ -4,6 +4,7 @@ require 'web_pipe'
 
 WebPipe.load_extensions(:params)
 
+#:nodoc:
 module WebPipe
   # Integration with `dry-schema` validation library.
   #

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

@@ -4,6 +4,7 @@ require 'web_pipe/types'
 require 'web_pipe/conn'
 require 'dry/view'
 
+#:nodoc:
 module WebPipe
   # Integration with `dry-view` rendering system.
   #
@@ -125,7 +126,7 @@ module WebPipe
 
       set_response_body(
         view_instance.call(
-          view_input
+          **view_input
         ).to_str
       )
     end
@@ -145,7 +146,9 @@ module WebPipe
                 .config
                 .default_context
                 .with(
-                  fetch_config(VIEW_CONTEXT_KEY, DEFAULT_VIEW_CONTEXT).call(self)
+                  **fetch_config(
+                    VIEW_CONTEXT_KEY, DEFAULT_VIEW_CONTEXT
+                  ).call(self)
                 )
       kwargs.merge(context: context)
     end

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

@@ -3,6 +3,7 @@
 require 'web_pipe/conn'
 require 'web_pipe/conn_support/errors'
 
+#:nodoc:
 module WebPipe
   # Provides with a typical flash messages functionality.
   #

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

@@ -3,6 +3,7 @@
 require 'web_pipe/types'
 require 'web_pipe/extensions/params/params/transf'
 
+#:nodoc:
 module WebPipe
   # Adds a {Conn#params} method which can perform any number of
   # transformations to the request parameters.
@@ -14,9 +15,9 @@ module WebPipe
   #   # http://www.example.com?foo=bar
   #   conn.params #=> { 'foo' => 'bar' }
   #
-  # Further processing can be specified thanks to `transproc` gem (you
+  # Further processing can be specified thanks to `dry-transformer` gem (you
   # need to add it yourself to the Gemfile). All hash transformations
-  # in `transproc` are available:
+  # in `dry-transformer` are available:
   #
   # @example
   #   # http://www.example.com?foo=bar
@@ -65,7 +66,7 @@ module WebPipe
   #   conn.
   #     params(fake) #=> { fake: :params }
   #
-  # @see https://github.com/solnic/transproc
+  # @see https://github.com/dry-rb/dry-transformer
   module Params
     # Key where configured transformations are set
     PARAM_TRANSFORMATION_KEY = :param_transformations

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

@@ -1,13 +1,14 @@
 # frozen_string_literal: true
 
-require 'transproc'
+require 'dry/transformer'
 
 module WebPipe
   module Params
+    # Parameter transformations from dry-transformer.
     module Transf
-      extend Transproc::Registry
+      extend Dry::Transformer::Registry
 
-      import Transproc::HashTransformations
+      import Dry::Transformer::HashTransformations
 
       def self.id(params)
         params

data/lib/web_pipe/extensions/rails/rails.rb

@@ -2,6 +2,7 @@
 
 require 'web_pipe/conn'
 
+#:nodoc:
 module WebPipe
   # Integrates with Rails framework.
   #
@@ -40,7 +41,7 @@ module WebPipe
   # itself easily with Rails. Furthermore, we have a tailored `dry_view`
   # extension.
   #
-  # You need to use this extension if:
+  # You need to use `:rails` extension if:
   #
   # - You want to use `action_view` as rendering system.
   # - You want to use rails url helpers from your {WebPipe} application.
@@ -54,7 +55,6 @@ module WebPipe
   #
   # - Which layout is applied to the template.
   # - Which helpers will become available to the templates.
-  # - Where within `app/views/` templates are looked up.
   #
   # By default, the controller in use is `ActionController::Base`, which means
   # that no layout is applied and only built-in helpers (for example,
@@ -74,7 +74,7 @@ module WebPipe
   # class ApplicationController < ActionController::Base
   #   # By default uses the layout in `layouts/application`
   # end
-  # 
+  #
   # # app/controllers/articles_index.rb
   # require 'web_pipe/plugs/config'
   #
@@ -99,7 +99,9 @@ module WebPipe
   #
   # Notice that we used the keyword `template:` instead of taking advantage of
   # automatic template lookup. We did that way so that we don't have to create
-  # also an `ArticlesController`, but it's up to you.
+  # also an `ArticlesController`, but it's up to you. In the case of having an
+  # `ArticlesController` we could just do `conn.render(:index, assigns: {
+  # articles: Article.all })`.
   #
   # Besides, this extension provides with two other methods:
   #

data/lib/web_pipe/extensions/redirect/redirect.rb

@@ -2,6 +2,7 @@
 
 require 'web_pipe/types'
 
+#:nodoc:
 module WebPipe
   # Helper method to create redirect responses.
   #

data/lib/web_pipe/extensions/session/session.rb

@@ -4,6 +4,7 @@ require 'web_pipe/conn'
 require 'web_pipe/types'
 require 'rack'
 
+#:nodoc:
 module WebPipe
   # Wrapper around Rack::Session middlewares.
   #

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

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+#:nodoc:
 module WebPipe
   # Adds helper methods related to the request URL.
   #

data/lib/web_pipe/plug.rb

@@ -25,11 +25,11 @@ module WebPipe
       # @param name [Any] Name for the plug that can't be resolved
       def initialize(name)
         super(
-          <<~eos
+          <<~MSG
             Plug with name +#{name}+ is invalid. It must be something
             callable, an instance method when no operation is given,
             or something callable registered in the container."
-          eos
+          MSG
         )
       end
     end
@@ -83,7 +83,7 @@ module WebPipe
         spec
       elsif spec.nil?
         pipe.method(name)
-      elsif container[spec]&.respond_to?(:call)
+      elsif container[spec].respond_to?(:call)
         container[spec]
       else
         raise InvalidPlugError, name
@@ -97,15 +97,26 @@ module WebPipe
     # @container container [Types::Container[]]
     # @object [Object]
     #
-    # @return [Array<ConnSupport::Composition::Operation[]>]
+    # @return [Hash<Name[], ConnSupport::Composition::Operation[]>]
     def self.inject_and_resolve(plugs, injections, container, object)
-      plugs.map do |plug|
-        if injections.key?(plug.name)
-          plug.with(injections[plug.name])
+      Hash[
+        plugs.map do |plug|
+          inject_and_resolve_plug(plug, injections, container, object)
+        end
+      ]
+    end
+
+    def self.inject_and_resolve_plug(plug, injections, container, object)
+      name = plug.name
+      [
+        name,
+        if injections.key?(name)
+          plug.with(injections[name])
         else
           plug
         end.call(container, object)
-      end
+      ]
     end
+    private_class_method :inject_and_resolve_plug
   end
 end

data/lib/web_pipe/rack_support/middleware_specification.rb

@@ -15,8 +15,6 @@ module WebPipe
     # - A single element array where it is an instance of a class
     # including {WebPipe}. This specifies all {RackSupport::Middlewares} for
     # that {WebPipe}.
-    #
-    # @api private
     class MiddlewareSpecification < Dry::Struct
       # Type for the name given to a middleware.
       Name = Types::Strict::Symbol.constructor(&:to_sym)
@@ -44,26 +42,38 @@ module WebPipe
       # @param middleware_specifications [Array<MiddlewareSpecification>]
       # @param injections [Injections[]]
       #
-      # @return [Array<RackSupport::Middleware>]
+      # @return [Hash<Name[], Array<RackSupport::Middleware>]
       def self.inject_and_resolve(middleware_specifications, injections)
-        middleware_specifications.map do |spec|
-          if injections.key?(spec.name)
-            spec.with(injections[spec.name])
+        Hash[
+          middleware_specifications.map do |middleware_spec|
+            inject_and_resolve_middleware(middleware_spec, injections)
+          end
+        ]
+      end
+
+      def self.inject_and_resolve_middleware(middleware_spec, injections)
+        name = middleware_spec.name
+        [
+          name,
+          if injections.key?(name)
+            middleware_spec.with(injections[name])
           else
-            spec
+            middleware_spec
           end.call
-        end.flatten
+        ]
       end
+      private_class_method :inject_and_resolve_middleware
 
       # Resolves {RackSupport::Middlewares} from given specification.
       #
       # @return [Array<RackSupport::Middleware>]
       def call
         klass = spec[0]
-        options = spec[1..-1] || Types::EMPTY_ARRAY
-        if klass.is_a?(WebPipe)
-          klass.middlewares
-        elsif klass.is_a?(Class)
+        options = spec[1..] || Types::EMPTY_ARRAY
+        case klass
+        when WebPipe
+          klass.middlewares.values
+        when Class
           [Middleware.new(middleware: klass, options: options)]
         end
       end

data/lib/web_pipe/test_support.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'web_pipe/conn_support/builder'
+require 'rack/mock'
+
+module WebPipe
+  # Test helper methods.
+  #
+  # This module is meant to be included in a test file to provide helper
+  # methods.
+  module TestSupport
+    # Builds a {WebPipe::Conn}
+    #
+    # @param uri [String] URI that will be used to populate the request
+    # attributes
+    # @param attributes [Hash<Symbol, Any>] Manually set attributes for the
+    # struct. It overrides what is taken from the `uri` parameter
+    # @param env_opts [Hash] Options to be added to the `env` from which the
+    # connection struct is created. See {Rack::MockRequest.env_for}.
+    # @return [Conn]
+    def build_conn(uri = '', attributes: {}, env_opts: {})
+      env = Rack::MockRequest.env_for(uri, env_opts)
+      ConnSupport::Builder
+        .call(env)
+        .new(attributes)
+    end
+  end
+end

data/lib/web_pipe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module WebPipe
-  VERSION = '0.10.0'
+  VERSION = '0.14.0'
 end

data/web_pipe.gemspec

@@ -39,16 +39,19 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency 'dry-struct', '~> 1.0'
   spec.add_runtime_dependency 'dry-types', '~> 1.1'
   spec.add_runtime_dependency 'rack', '~> 2.0'
-  spec.add_runtime_dependency 'transproc', '~> 1.1'
 
-  spec.add_development_dependency 'bundler', '~> 1.17'
+  spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'dry-schema', '~> 1.0'
-  spec.add_development_dependency 'dry-view', '~> 0.7'
+  spec.add_development_dependency 'dry-transformer', '~> 0.1'
+  # TODO: Readd when dry-rb 0.8 is released (ruby 3.0 support)
+  # spec.add_development_dependency 'dry-view', '~> 0.8'
   spec.add_development_dependency 'pry-byebug'
   spec.add_development_dependency 'rack-flash3', '~> 1.0'
   spec.add_development_dependency 'rack-test', '~> 1.1'
-  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rake', '~> 12.3', '>= 12.3.3'
   spec.add_development_dependency 'redcarpet', '~> 3.4'
   spec.add_development_dependency 'rspec', '~> 3.0'
   spec.add_development_dependency 'yard', '~> 0.9', '>= 0.9.20'
+  spec.add_development_dependency 'rubocop', '~> 1.8'
+  spec.add_development_dependency 'rubocop-rspec', '~> 2.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: web_pipe
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.14.0
 platform: ruby
 authors:
 - Marc Busqué
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-11-15 00:00:00.000000000 Z
+date: 2021-04-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-monads
@@ -66,34 +66,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.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
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: dry-schema
   requirement: !ruby/object:Gem::Requirement
@@ -109,19 +95,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
-  name: dry-view
+  name: dry-transformer
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: pry-byebug
   requirement: !ruby/object:Gem::Requirement
@@ -170,14 +156,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '12.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 12.3.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '12.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 12.3.3
 - !ruby/object:Gem::Dependency
   name: redcarpet
   requirement: !ruby/object:Gem::Requirement
@@ -226,6 +218,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.9.20
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
 description: 
 email:
 - marc@lamarciana.com
@@ -235,6 +255,7 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rspec"
+- ".rubocop.yml"
 - ".travis.yml"
 - ".yardopts"
 - CHANGELOG.md
@@ -268,6 +289,7 @@ files:
 - docs/plugging_operations.md
 - docs/plugging_operations/composing_operations.md
 - docs/plugging_operations/injecting_operations.md
+- docs/plugging_operations/inspecting_operations.md
 - docs/plugging_operations/resolving_operations.md
 - docs/plugs.md
 - docs/plugs/config.md
@@ -275,9 +297,11 @@ files:
 - docs/recipes/dry_rb_integration.md
 - docs/recipes/hanami_router_integration.md
 - docs/recipes/using_all_restful_methods.md
+- docs/testing.md
 - docs/using_rack_middlewares.md
 - docs/using_rack_middlewares/composing_middlewares.md
 - docs/using_rack_middlewares/injecting_middlewares.md
+- docs/using_rack_middlewares/inspecting_middlewares.md
 - lib/web_pipe.rb
 - lib/web_pipe/app.rb
 - lib/web_pipe/conn.rb
@@ -310,6 +334,7 @@ files:
 - lib/web_pipe/rack_support/app_with_middlewares.rb
 - lib/web_pipe/rack_support/middleware.rb
 - lib/web_pipe/rack_support/middleware_specification.rb
+- lib/web_pipe/test_support.rb
 - lib/web_pipe/types.rb
 - lib/web_pipe/version.rb
 - web_pipe.gemspec
@@ -335,8 +360,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.8
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: Rack application builder through a pipe of operations on an immutable struct.