web_pipe 0.12.1 → 0.15.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d7a3628fa20a1c650c63fc908cc7c9b4e503657414bf7b849e9ba60b61e02921
-  data.tar.gz: 59f50a884043943ccd93017bea7c27b8f488c5f31f3e76dba1ab20442526de13
+  metadata.gz: 8148f2a5701baf60d74d238ed32b6fcdaadaaf5006431322222a081d005caa01
+  data.tar.gz: 90a38228ba60cd9637584b85cffd06d0271df5bd2d3d9bc721b3d3cb7de61287
 SHA512:
-  metadata.gz: 9645c64a425650d254195f5b4fdd9ee80d8de6f05e410525fe47074a8f7aeccfe2ee6d73fc90cbd622eeb929e89d0439cc2f1d0af6a2f419d7ca011c6877caa9
-  data.tar.gz: f0123575ea916a8f7aafc67039dfb640c7d05806f01af6ad5101e2d9bd28b98bcb1ce8886b8959a4d9ff9db322f166670ed1d963dcb5d2447b289b14bd611c9f
+  metadata.gz: 4bd1b21978116a5743d53106cc4c2b8f042dba4cbe63804adbc370174bf08a9221f563561b123a10445e5cb3f87b7672d9cf0ef8c1161e53a9b54f83ae3aba13
+  data.tar.gz: a0028185e4bfe8858206fc90c8e355891d3e9a14db81fad7076fd8c05960f01abd1418fc05bece3c6fe73585a5732e2f13318a6529e9d6fef75f4e86181da376

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.5
   - 2.6
   - 2.7
+  - 3.0
 before_install:
   - gem update --system --no-doc
 script:
   - bundle exec rspec
+  - bundle exec rubocop

data/CHANGELOG.md

@@ -4,6 +4,32 @@ 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.15.1] - 2021-09-19
+### Added
+- `:not_found` extension
+  [#46](https://github.com/waiting-for-dev/web_pipe/pull/46)
+
+## [0.15.0] - 2021-09-12
+### Added
+- **BREAKING**. Switch `dry_view` extension with `hanami_view`.
+  [#45](https://github.com/waiting-for-dev/web_pipe/pull/45)
+
+## [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

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
+
+group :development do
+  # TODO: Move to gemspec when hanami-view 2.0 is available
+  gem 'hanami-view', github: 'hanami/view', tag: 'v2.0.0.alpha2'
+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,12 +34,14 @@ 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)
    1. [Flash](docs/extensions/flash.md)
    1. [Dry Schema](docs/extensions/dry_schema.md)
-   1. [Dry View](docs/extensions/dry_view.md)
+   1. [Hanami View](docs/extensions/hanami_view.md)
+   1. [Not found](docs/extensions/not_found.md)
    1. [Params](docs/extensions/params.md)
    1. [Rails](docs/extensions/rails.md)
    1. [Redirect](docs/extensions/redirect.md)

data/docs/extensions/{dry_view.md → hanami_view.md}

@@ -1,8 +1,10 @@
-# Dry View
+# Hanami View
 
-This extensions integrates with
-[dry-view](https://dry-rb.org/gems/dry-view/) rendering system to
-set a dry-view output as response body.
+> This extension currently works with `hanami-view` v2.0.0.alpha2, which is not
+still released but it's available on the gem repository.
+
+This extensions integrates with [hanami-view](https://github.com/hanami/view)
+rendering system to set a hanami-view output as response body.
 
 `WebPipe::Conn#view` method is at the core of this extension. In its basic
 behaviour, you provide to it a view instance you want to render and any
@@ -10,12 +12,12 @@ exposures or options it may need:
 
 ```ruby
 require 'web_pipe'
-require 'dry/view'
+require 'hanami/view'
 require 'my_context'
 
-WebPipe.load_extensions(:dry_view)
+WebPipe.load_extensions(:hanami_view)
 
-class SayHelloView < Dry::View
+class SayHelloView < Hanami::View
   config.paths = [File.join(__dir__, '..', 'templates')]
   config.template = 'say_hello'
   config.default_context = MyContext
@@ -40,12 +42,12 @@ However, you can resolve a view from a container if you also use (`:container`
 extension)[container.md]:
 
 ```ruby
-require 'dry_view'
+require 'hanami_view'
 require 'my_container'
 require 'web_pipe'
 require 'web_pipe/plugs/config'
 
-WebPipe.load_extensions(:dry_view, :container)
+WebPipe.load_extensions(:hanami_view, :container)
 
 class MyApp
  include WebPipe
@@ -61,20 +63,20 @@ class MyApp
 end
 ```
 
-As in a standard call to `Dry::View#call`, you can override the context
-(`Dry::View::Context`) to use through `context:` option. However, it is still
+As in a standard call to `Hanami::View#call`, you can override the context
+(`Hanami::View::Context`) to use through `context:` option. However, it is still
 possible to leverage configured default context while being able to inject
 request specific data to it.
 
 For that to work, you have to specify required dependencies (in this case,
-request specific data) to your dry-view's context. A very convenient way to do
+request specific data) to your hanami-view's context. A very convenient way to do
 that is with [`dry-auto_inject`](https://dry-rb.org/gems/dry-auto_inject):
 
 ```ruby
-require 'dry/view/context'
+require 'hanami/view/context'
 require 'my_import'
 
-class MyContext < Dry::View::Context
+class MyContext < Hanami::View::Context
  include MyImport::Import[:current_path]
  
  # Without `dry-auto_inject` you have to manually specify dependencies and

data/docs/extensions/not_found.md

@@ -0,0 +1,40 @@
+# Not found
+
+This extension helps to build a not-found response in a single method
+invocation. The `WebPipe::Conn#not_found` method will:
+
+- Set 404 as response status.
+- Set 'Not found' as the response body, or instead run a step configured in
+`:not_found_body_step` config key.
+- Halt the connection struct.
+
+```ruby
+require 'web_pipe'
+require 'web_pipe/plugs/config'
+
+WebPipe.load_extensions(:params, :not_found)
+
+class ShowItem
+  include 'web_pipe'
+
+  plug :config, WebPipe::Plugs::Config.(
+    not_found_body_step: ->(conn) { conn.set_response_body('Nothing') }
+  )
+
+  plug :fetch_item do |conn|
+    conn.add(:item, Item[params['id']])
+  end
+
+  plug :check_item do |conn|
+    if conn.fetch(:item)
+      conn
+    else
+      conn.not_found
+    end
+  end
+
+  plug :render do |conn|
+    conn.set_response_body(conn.fetch(:item).name)
+  end
+end
+```

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

@@ -31,10 +31,9 @@ It's quite possible that you don't need more than that in terms of rails
 integration. Of course, surely you want something more elaborate to generate
 responses. For that, you can use the view or template system you like. One
 option that will play specially well here is
-[`dry-view`](https://dry-rb.org/gems/dry-view/), which
-[integrates](https://github.com/dry-rb/dry-view/tree/master/examples/rails)
-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).
+[`hanami-view`](https://github.com/hanami/view). Furthermore, we have a
+tailored `hanami_view`
+[extension](https://waiting-for-dev.github.io/web_pipe/docs/extensions/hanami_view.html).
 
 You need to use `:rails` extension if:
 

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/recipes/dry_rb_integration.md

@@ -3,9 +3,8 @@
 `web_pipe` has been designed to integrate smoothly with
 [dry-rb](https://dry-rb.org/) ecosystem. It shares same design
 principles and it ships with some extensions which even make this
-integration tighter (like
-[`:dry-view`](../extensions/dry_view.md) or
-[`:dry-schema`](../extensions/dry_schema.md) extensions).
+integration tighter (like [`:dry-schema`](../extensions/dry_schema.md)
+extension).
 
 If you want to use `web_pipe` with the rest of dry-rb libraries,
 your best bet is to use

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/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/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/{dry_view/dry_view.rb → hanami_view/hanami_view.rb}

@@ -2,18 +2,19 @@
 
 require 'web_pipe/types'
 require 'web_pipe/conn'
-require 'dry/view'
+require 'hanami/view'
 
+#:nodoc:
 module WebPipe
-  # Integration with `dry-view` rendering system.
+  # Integration with `hanami-view` rendering system.
   #
   # This extensions adds a {#view} method to {WebPipe::Conn} which
-  # sets the string output of a `dry-view` view as response body.
+  # sets the string output of a `hanami-view` view as response body.
   #
   # @example
-  #   WebPipe.load_extensions(:dry_view)
+  #   WebPipe.load_extensions(:hanami_view)
   #
-  #   class SayHelloView < Dry::View
+  #   class SayHelloView < Hanami::View
   #     config.paths = [File.join(__dir__, '..', 'templates')]
   #     config.template = 'say_hello'
   #
@@ -34,7 +35,7 @@ module WebPipe
   # instance can be resolved from it.
   #
   # @example
-  #   WebPipe.load_extensions(:dry_view, :container)
+  #   WebPipe.load_extensions(:hanami_view, :container)
   #
   #   class App
   #     include WebPipe
@@ -49,18 +50,18 @@ module WebPipe
   #     end
   #  end
   #
-  # Context ({Dry::View::Context}) for the view can be set explicetly
+  # Context ({Hanami::View::Context}) for the view can be set explicetly
   # through the `context:` argument, as in a standard call to
-  # {Dry::View#call}. However, it is possible to leverage configured
+  # {Hanami::View#call}. However, it is possible to leverage configured
   # default context while still being able to inject request specific
   # 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
+  # {Hanami::View::Context#with} to create the final context at the
   # moment {#view} is called.
   #
   # @example
-  #   class MyContext < Dry::View::Context
+  #   class MyContext < Hanami::View::Context
   #     attr_reader :current_path
   #
   #     def initialize(current_path: nil, **options)
@@ -69,7 +70,7 @@ module WebPipe
   #     end
   #   end
   #
-  #   class SayHelloView < Dry::View
+  #   class SayHelloView < Hanami::View
   #     config.paths = [File.join(__dir__, '..', 'templates')]
   #     config.template = 'say_hello'
   #     config.default_context = MyContext.new
@@ -95,7 +96,7 @@ module WebPipe
   #     end
   #   end
   #
-  # @see https://dry-rb.org/gems/dry-view/
+  # @see https://github.com/hanami/view
   # @see WebPipe::Container
   module DryView
     # Where to find in {#config} request's view context generator.
@@ -106,17 +107,17 @@ module WebPipe
 
     # Sets string output of a view as response body.
     #
-    # If the view is not a {Dry::View} instance, it is resolved from
+    # If the view is not a {Hanami::View} instance, it is resolved from
     # the configured container.
     #
     # `kwargs` is used as the input for the view (the arguments that
-    # {Dry::View#call} receives). If they doesn't contain an explicit
+    # {Hanami::View#call} receives). If they doesn't contain an explicit
     # `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}).
+    # {Hanami::View::Context#with}).
     #
-    # @param view_spec [Dry::View, Any]
-    # @param kwargs [Hash] Arguments to pass along to `Dry::View#call`
+    # @param view_spec [Hanami::View, Any]
+    # @param kwargs [Hash] Arguments to pass along to `Hanami::View#call`
     #
     # @return WebPipe::Conn
     def view(view_spec, **kwargs)
@@ -133,7 +134,7 @@ module WebPipe
     private
 
     def view_instance(view_spec)
-      return view_spec if view_spec.is_a?(Dry::View)
+      return view_spec if view_spec.is_a?(Hanami::View)
 
       fetch_config(:container)[view_spec]
     end

data/lib/web_pipe/extensions/not_found/not_found.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+#:nodoc:
+module WebPipe
+  # Generates a not-found response
+  #
+  # This extension helps to build a not-found response in a single method
+  # invocation. The {#not_found} method will:
+  #
+  # - Set 404 as response status.
+  # - Set 'Not found' as the response body, or instead run a step configured in
+  # a `:not_found_body_step` config key.
+  # - Halt the connection struct.
+  #
+  # @example
+  #   require 'web_pipe'
+  #   require 'web_pipe/plugs/config'
+  #
+  #   WebPipe.load_extensions(:params, :not_found)
+  #
+  #   class ShowItem
+  #     include 'web_pipe'
+  #
+  #     plug :config, WebPipe::Plugs::Config.(
+  #       not_found_body_step: ->(conn) { conn.set_response_body('Nothing') }
+  #     )
+  #
+  #     plug :fetch_item do |conn|
+  #       conn.add(:item, Item[params['id']])
+  #     end
+  #
+  #     plug :check_item do |conn|
+  #       if conn.fetch(:item)
+  #         conn
+  #       else
+  #         conn.not_found
+  #       end
+  #     end
+  #
+  #     plug :render do |conn|
+  #       conn.set_response_body(conn.fetch(:item).name)
+  #     end
+  #   end
+  module NotFound
+    # @api private
+    RESPONSE_BODY_STEP_CONFIG_KEY = :not_found_body_step
+
+    # Generates the not-found response
+    #
+    # @return [WebPipe::Conn::Halted]
+    # @see NotFound
+    def not_found
+      set_status(404)
+        .then do |conn|
+          response_body_step = conn.fetch_config(RESPONSE_BODY_STEP_CONFIG_KEY,
+                                                 ->(c) { c.set_response_body('Not found') })
+
+          response_body_step.call(conn)
+        end.halt
+    end
+
+    Conn.include(NotFound)
+  end
+end

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

@@ -4,6 +4,7 @@ require 'dry/transformer'
 
 module WebPipe
   module Params
+    # Parameter transformations from dry-transformer.
     module Transf
       extend Dry::Transformer::Registry
 

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.

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

@@ -2,6 +2,7 @@
 
 require 'web_pipe/conn'
 
+#:nodoc:
 module WebPipe
   # Integrates with Rails framework.
   #
@@ -36,9 +37,8 @@ module WebPipe
   # It's quite possible that you don't need more than that in terms of rails
   # integration. Of course, surely you want something more elaborate to generate
   # responses. For that, you can use the view or template system you like. One
-  # option that will play specially well here is `dry-view`, which integrates
-  # itself easily with Rails. Furthermore, we have a tailored `dry_view`
-  # extension.
+  # option that will play specially well here is `hanami-view`. Furthermore, we
+  # have a tailored `hanami_view` extension.
   #
   # You need to use `:rails` extension if:
   #
@@ -73,7 +73,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'
   #
@@ -117,9 +117,6 @@ module WebPipe
   # https://github.com/waiting-for-dev/rails-web_pipe
   #
   # @see https://guides.rubyonrails.org/routing.html#routing-to-rack-applications
-  # @see https://dry-rb.org/gems/dry-view/
-  # @see https://github.com/dry-rb/dry-view/tree/master/examples/rails
-  # @see https://waiting-for-dev.github.io/web_pipe/docs/extensions/dry_view.html
   # @see https://api.rubyonrails.org/v6.0.1/classes/ActionController/Renderer.html
   # @see https://api.rubyonrails.org/v6.0.1/classes/ActionController/Renderer.html
   # @see https://api.rubyonrails.org/v6.0.1/classes/ActionView/Helpers/UrlHelper.html

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.12.1'
+  VERSION = '0.15.1'
 end

data/lib/web_pipe.rb

@@ -27,8 +27,8 @@ module WebPipe
     require 'web_pipe/extensions/dry_schema/plugs/sanitize_params'
   end
 
-  register_extension :dry_view do
-    require 'web_pipe/extensions/dry_view/dry_view'
+  register_extension :hanami_view do
+    require 'web_pipe/extensions/hanami_view/hanami_view'
   end
 
   register_extension :container do
@@ -62,4 +62,8 @@ module WebPipe
   register_extension :url do
     require 'web_pipe/extensions/url/url'
   end
+
+  register_extension :not_found do
+    require 'web_pipe/extensions/not_found/not_found'
+  end
 end

data/web_pipe.gemspec

@@ -43,7 +43,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'dry-schema', '~> 1.0'
   spec.add_development_dependency 'dry-transformer', '~> 0.1'
-  spec.add_development_dependency 'dry-view', '~> 0.7'
   spec.add_development_dependency 'pry-byebug'
   spec.add_development_dependency 'rack-flash3', '~> 1.0'
   spec.add_development_dependency 'rack-test', '~> 1.1'
@@ -51,4 +50,6 @@ Gem::Specification.new do |spec|
   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.12.1
+  version: 0.15.1
 platform: ruby
 authors:
 - Marc Busqué
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 1970-01-01 00:00:00.000000000 Z
+date: 2021-09-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-monads
@@ -108,20 +108,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.1'
-- !ruby/object:Gem::Dependency
-  name: dry-view
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.7'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.7'
 - !ruby/object:Gem::Dependency
   name: pry-byebug
   requirement: !ruby/object:Gem::Requirement
@@ -232,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
@@ -241,6 +255,7 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rspec"
+- ".rubocop.yml"
 - ".travis.yml"
 - ".yardopts"
 - CHANGELOG.md
@@ -262,8 +277,9 @@ files:
 - docs/extensions/container.md
 - docs/extensions/cookies.md
 - docs/extensions/dry_schema.md
-- docs/extensions/dry_view.md
 - docs/extensions/flash.md
+- docs/extensions/hanami_view.md
+- docs/extensions/not_found.md
 - docs/extensions/params.md
 - docs/extensions/rails.md
 - docs/extensions/redirect.md
@@ -274,6 +290,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
@@ -281,9 +298,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
@@ -300,8 +319,9 @@ files:
 - lib/web_pipe/extensions/cookies/cookies.rb
 - lib/web_pipe/extensions/dry_schema/dry_schema.rb
 - lib/web_pipe/extensions/dry_schema/plugs/sanitize_params.rb
-- lib/web_pipe/extensions/dry_view/dry_view.rb
 - lib/web_pipe/extensions/flash/flash.rb
+- lib/web_pipe/extensions/hanami_view/hanami_view.rb
+- lib/web_pipe/extensions/not_found/not_found.rb
 - lib/web_pipe/extensions/params/params.rb
 - lib/web_pipe/extensions/params/params/transf.rb
 - lib/web_pipe/extensions/rails/rails.rb
@@ -316,6 +336,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