web_pipe 0.9.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fc647eb09c8b7eb1d3bcfb910cc55e840285c6b1ab9bd9c69ea9b630f7a116fd
-  data.tar.gz: 6b667b8e71f1fac8d7c46a8160cbff273c70042bf1cc9b06da60c82a83fea5b2
+  metadata.gz: 1a993e68cff01cb6b0ef493b6bdf3207e62a7baca650302c9f65024f3981c18a
+  data.tar.gz: dc94f7dfabc97ad712a058f725e85831c38fe2658f42adeca3243b29f10273f9
 SHA512:
-  metadata.gz: f52d9d4c5b381d13de8f27ae03e8fc8bfb2cfe7e020d507f934341c9823f7c2cb2d94ebddc500d9337a59c2437c8ae3899e1b7ef942ed5e1cfc073591f8ac56f
-  data.tar.gz: 0be15319332d738f2b8ff07d7cb9d73583d00bf907e8787a2b8ab0fadc88d235f441b08e546bf162a6fb6fca8953ab68c34077cf300c0d6c1bb26aa37fe8f964
+  metadata.gz: 2e5925278ef21f20b3c9b8ae25f7bd614c7e17b278693f3521f018cefe1acd1ef63116aba61a9722bc1f4d5b98bfbeb56a6e03d0d246ac359aa595e4c451f6eb
+  data.tar.gz: baf191023d9a19ed7facfc77f3107db45e2adb1949a25e4fc306b0a9f85e061e474fc557848beb469aaf0c5ad0446918b9c285b63cc5501bf21d31c19229878c

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,15 @@
+AllCops:
+  TargetRubyVersion: 2.7.2
+  NewCops: enable
+  SuggestExtensions: false
+  Exclude:
+    - "*.gemspec"
+    - vendor/**/*
+    - Gemfile
+
+Metrics/BlockLength:
+  Exclude:
+    - spec/**/*
+
+Naming/AccessorMethodName:
+  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,39 @@ 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.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.
+  [[#36]](https://github.com/waiting-for-dev/web_pipe/pull/36)
+
 ## [0.9.0] - 2019-08-31
 ### Added
 - Comprehensive documentation.

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

@@ -10,40 +10,44 @@ In order to use in conjunction with [dry-rb](https://dry-rb.org/)
 ecosystem, see also
 [`dry-web-web_pipe`](https://github.com/waiting-for-dev/dry-web-web_pipe).
 
-1. [Introduction](/docs/introduction.md)
-1. [Design model](/docs/design_model.md)
-1. [Building a rack application](/docs/building_a_rack_application.md)
-1. [Plugging operations](/docs/plugging_operations.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. [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. [Composing applications](/docs/composing_applications.md)
-1. [Connection struct](/docs/connection_struct.md)
-   1. [Sharing data downstream](/docs/connection_struct/sharing_data_downstream.md)
-   1. [Halting the pipe](/docs/connection_struct/halting_the_pipe.md)
-   1. [Configuring the connection struct](/docs/connection_struct/configuring_the_connection_struct.md)
-1. [DSL free usage](/docs/dsl_free_usage.md)
-1. [Plugs](/docs/plugs.md)
-   1. [Config](/docs/plugs/config.md)
-   1. [ContentType](/docs/plugs/content_type.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. [Params](/docs/extensions/params.md)
-   1. [Redirect](/docs/extensions/redirect.md)
-   1. [Router params](/docs/extensions/router_params.md)
-   1. [Session](/docs/extensions/session.md)
-   1. [URL](/docs/extensions/url.md)
+If you want to use it with a Rails project, don't miss docs for the [rails
+extension](docs/extensions/rails.md).
+
+1. [Introduction](docs/introduction.md)
+1. [Design model](docs/design_model.md)
+1. [Building a rack application](docs/building_a_rack_application.md)
+1. [Plugging operations](docs/plugging_operations.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. [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. [Composing applications](docs/composing_applications.md)
+1. [Connection struct](docs/connection_struct.md)
+   1. [Sharing data downstream](docs/connection_struct/sharing_data_downstream.md)
+   1. [Halting the pipe](docs/connection_struct/halting_the_pipe.md)
+   1. [Configuring the connection struct](docs/connection_struct/configuring_the_connection_struct.md)
+1. [DSL free usage](docs/dsl_free_usage.md)
+1. [Plugs](docs/plugs.md)
+   1. [Config](docs/plugs/config.md)
+   1. [ContentType](docs/plugs/content_type.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. [Params](docs/extensions/params.md)
+   1. [Rails](docs/extensions/rails.md)
+   1. [Redirect](docs/extensions/redirect.md)
+   1. [Router params](docs/extensions/router_params.md)
+   1. [Session](docs/extensions/session.md)
+   1. [URL](docs/extensions/url.md)
 1. Recipes
-   1. [dry-rb integration](/docs/recipes/dry_rb_integration.md)
-   1. [hanami-router integration](/docs/recipes/hanami_router_integration.md)
-   1. [Using all RESTful methods](/docs/recipes/using_all_restful_methods.mb)
+   1. [dry-rb integration](docs/recipes/dry_rb_integration.md)
+   1. [hanami-router integration](docs/recipes/hanami_router_integration.md)
+   1. [Using all RESTful methods](docs/recipes/using_all_restful_methods.md)
 
 ```ruby
 # config.ru
@@ -88,10 +92,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/composing_applications.md

@@ -1,8 +1,8 @@
 # Composing applications
 
 Previously, we have seen how to [compose plugged
-operations](/docs/plugging_operations/composing_operations.md) and how to [compose
-rack middlewares](/docs/using_rack_middlewares/composing_middlewares.md). The logical
+operations](plugging_operations/composing_operations.md) and how to [compose
+rack middlewares](using_rack_middlewares/composing_middlewares.md). The logical
 next step is thinking about composing `web_pipe` applications, which is exactly
 the same as composing both operations and middlewares at the same time.
 

data/docs/connection_struct.md

@@ -69,9 +69,20 @@ run DummyApp.new
 
 As you can see, default available features are the very minimal to read from a
 request and to write a response. However, you can pick from several
-(extensions)[/docs/extensions.md] which will make your life much easier.
+(extensions)[extensions.md] which will make your life much easier.
 
 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/connection_struct/configuring_the_connection_struct.md

@@ -1,6 +1,6 @@
 # Configuring the connection struct
 
-[Extensions](/docs/extensions.md) add extra behaviour to the connection struct.
+[Extensions](../extensions.md) add extra behaviour to the connection struct.
 Sometimes they need some user provided value to work properly or they may allow
 some tweak depending on user needs.
 
@@ -10,7 +10,7 @@ what they need is `#config` attribute, which is very similar to `#bag` except
 for its more private intention.
 
 In order to interact with `#config`, you can use the method `#add_config(key,
-value)` or [`Config` plug](/docs/plugs/config.md).
+value)` or [`Config` plug](../plugs/config.md).
 
 ```ruby
 class MyApp

data/docs/extensions/dry_schema.md

@@ -9,7 +9,7 @@ pipe of operations. It takes as arguments a `dry-schema` schema and a handler.
 On success, it makes output available at `WebPipe::Conn#sanitized_params`. On
 error, it calls given handler with the connection struct and validation result.
 
-This extension automatically loads [`:params` extension](/docs/extensions/params.md),
+This extension automatically loads [`:params` extension](params.md),
 as it takes `WebPipe::Conn#params` as input for the validation schema.
 
 Instead of providing an error handler as the second argument for the plug, you

data/docs/extensions/dry_view.md

@@ -37,7 +37,7 @@ end
 ```
 
 However, you can resolve a view from a container if you also use (`:container`
-extension)[/docs/extensions/container.md]:
+extension)[container.md]:
 
 ```ruby
 require 'dry_view'

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

@@ -0,0 +1,116 @@
+# Rails
+
+The first two things to keep in mind in order to integrate with Rails is
+that `WebPipe` instances are Rack applications and that rails router can
+perfectly [dispatch to a rack application](https://guides.rubyonrails.org/routing.html#routing-to-rack-applications). For example:
+
+```ruby
+# config/routes.rb
+get '/my_route', to: MyRoute.new
+
+# app/controllers/my_route.rb
+class MyRoute
+  include WebPipe
+
+  plug :set_response_body
+
+  private
+
+  def set_response_body(conn)
+    conn.set_response_body('Hello, World!')
+  end
+end
+```
+
+In order to do something like the previous example you don't need to enable
+this extension. Notice that rails took care of dispatching the request to our
+`WebPipe` rack application, which was then responsible for generating the
+response. In this case, it used a simple call to `#set_response_body`.
+
+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).
+
+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.
+- You want to use controller helpers from your `WebPipe` application.
+
+Rails responsibilities for controlling the request/response cycle and the
+rendering process are a little bit tangled. For this reason, even if you
+want to use `WebPipe` applications instead of Rails controller actions you
+still have to use the typical top `ApplicationController` in order to define
+some behaviour for the view layer:
+
+- Which layout is applied to the template.
+- Which helpers will become available to the templates.
+
+By default, the controller in use is `ActionController::Base`, which means that
+no layout is applied and only built-in helpers (for example,
+`number_as_currency`) are available. You can change it via the
+`:rails_controller` configuration option.
+
+The main method that this extension adds to `WebPipe::Conn` is `#render`,
+which just delegates to the [Rails
+implementation](https://api.rubyonrails.org/v6.0.1/classes/ActionController/Renderer.html)
+as you'd do in a typical rails controller. Remember that you can provide
+template instance variables through the keyword `:assigns`.
+
+```ruby
+# config/routes.rb
+get '/articles', to: ArticlesIndex.new
+
+# app/controllers/application_controller.rb
+class ApplicationController < ActionController::Base
+  # By default uses the layout in `layouts/application`
+end
+
+# app/controllers/articles_index.rb
+require 'web_pipe/plugs/config'
+
+WebPipe.load_extensions(:rails) # You can put it in an initializer
+
+class ArticlesIndex
+  include WebPipe
+
+  plug :config, WebPipe::Plugs::Config.(
+    rails_controller: ApplicationController
+  )
+
+  def render(conn)
+    conn.render(
+      template: 'articles/index',
+      assigns: { articles: Article.all }
+    )
+  end
+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. 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:
+
+- `url_helpers` returns Rails router [url
+  helpers](https://api.rubyonrails.org/v6.0.1/classes/ActionView/Helpers/UrlHelper.html).
+- `helpers` returns the associated [controller
+  helpers](https://api.rubyonrails.org/classes/ActionController/Helpers.html).
+
+In all the examples we have supposed that we are putting `WebPipe` applications
+within `app/controllers/` directory. However, remember you can put them
+wherever you like as long as you respect rails [`autoload_paths`](https://guides.rubyonrails.org/autoloading_and_reloading_constants.html#autoload-paths).
+
+Here you have a link to a very simple and contrived example of a rails
+application integrating `web_pipe`:
+
+https://github.com/waiting-for-dev/rails-web_pipe
+

data/docs/extensions/router_params.md

@@ -2,7 +2,7 @@
 
 This extension can be used in order to merge placeholder parameters
 that usually routers support (like `get /users/:id`) to the parameters hash
-added through [`:params` extension](/docs/extensions/params.md) (which is
+added through [`:params` extension](params.md) (which is
 automatically loaded).
 
 What this extension does is adding a transformation function to the registry

data/docs/introduction.md

@@ -12,17 +12,17 @@ with [dry-rb](https://dry-rb.org/) ecosystem. If it helps, you can think of it
 as a decoupled web controller (as the C in MVC).
 
 `web_pipe` applications are built as a [pipe of
-operations](/docs/design_model.md) on an [immutable
-struct](/docs/connection_struct.md). The struct is automatically created
+operations](design_model.md) on an [immutable
+struct](connection_struct.md). The struct is automatically created
 with data from an HTTP request, and it contains methods to
 incrementally add data to generate an HTTP response. The pipe can
-be [halted](/docs/connection_struct/halting_the_pipe.md) at any moment,
+be [halted](connection_struct/halting_the_pipe.md) at any moment,
 taking away from all operations downstream any chance to modify the
 response.
 
 `web_pipe` has a modular design, with only the minimal functionalities needed
 to build a web application enabled by default. However, it ships with several
-[extensions](/docs/extensions.md) to make your life easier.
+[extensions](extensions.md) to make your life easier.
 
 Following there is a simple example. It is a web application that will check
 the value of a `user` parameter. When it is `Alice` or `Joe`, it will kindly
@@ -70,4 +70,4 @@ class HelloApp
 end
 
 run HelloApp.new
-``
+```

data/docs/plugging_operations.md

@@ -3,7 +3,7 @@
 You can plug operations to your application with the DSL method `plug`. The
 first argument it always takes is a symbol with the name you want
 to give to the operation (which is needed to allow
-[injection](/docs/plugging_operations/injecting_operations.md) on
+[injection](plugging_operations/injecting_operations.md) on
 initialization).
 
 ```ruby

data/docs/recipes/dry_rb_integration.md

@@ -4,8 +4,8 @@
 [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`](/docs/extensions/dry_view.md) or
-[`:dry-schema`](/docs/extensions/dry_schema.md) extensions).
+[`:dry-view`](../extensions/dry_view.md) or
+[`:dry-schema`](../extensions/dry_schema.md) extensions).
 
 If you want to use `web_pipe` with the rest of dry-rb libraries,
 your best bet is to use

data/docs/recipes/hanami_router_integration.md

@@ -22,4 +22,4 @@ end
 run router
 ```
 
-In order to perform [string matching with variables](https://github.com/hanami/router#string-matching-with-variables) you just need to load [`:router_params` extension](/docs/extensions/router_params.md).
+In order to perform [string matching with variables](https://github.com/hanami/router#string-matching-with-variables) you just need to load [`:router_params` extension](../extensions/router_params.md).

data/docs/recipes/using_all_restful_methods.md

@@ -9,7 +9,7 @@ request method in rack's env if a magical `_method` parameter or
 
 You have to be aware that if you use this middleware within a
 `web_pipe` application (through [`use` DSL
-method](docs/using_rack_middlewares.md)) it will have no effect.
+method](../using_rack_middlewares.md)) it will have no effect.
 When your `web_pipe` application takes control of the request it
 has already gone through the router, which is the one who should
 read the request method set by rack.

data/docs/using_rack_middlewares.md

@@ -9,7 +9,7 @@ encapsulate them in your application definition.
 In order to add rack middlewares to the stack, you have to use the DSL method
 `use`. The first argument it takes is a `Symbol` with the name you want to
 assign to it (which is needed to allow
-[injection](/docs/using_rack_middlewares/injecting_middlewares.md) on
+[injection](using_rack_middlewares/injecting_middlewares.md) on
 initialization). Then, it must follow the middleware class and any option it
 may need:
 

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
@@ -51,6 +51,10 @@ module WebPipe
     require 'web_pipe/extensions/params/params'
   end
 
+  register_extension :rails do
+    require 'web_pipe/extensions/rails/rails'
+  end
+
   register_extension :session do
     require 'web_pipe/extensions/session/session'
   end

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

@@ -48,6 +48,7 @@ module WebPipe
       # @return [Array<RackSupport::Middlewares>]
       attr_reader :middlewares
 
+      # rubocop:disable Metrics/AbcSize
       def initialize(injects = EMPTY_INJECTIONS)
         @injections = Injections[injects]
         container = self.class.container
@@ -60,6 +61,7 @@ module WebPipe
         app = App.new(operations)
         @rack_app = RackSupport::AppWithMiddlewares.new(middlewares, app)
       end
+      # rubocop:enable Metrics/AbcSize
 
       # Expected interface for rack.
       #

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

@@ -0,0 +1,154 @@
+# frozen_string_literal: true
+
+require 'web_pipe/conn'
+
+#:nodoc:
+module WebPipe
+  # Integrates with Rails framework.
+  #
+  # The first two things to keep in mind in order to integrate with Rails is
+  # that {WebPipe} instances are Rack applications and that rails router can
+  # perfectly dispatch to a rack application. For example:
+  #
+  # ```ruby
+  # # config/routes.rb
+  # get '/my_route', to: MyRoute.new
+  #
+  # # app/controllers/my_route.rb
+  # class MyRoute
+  #   include WebPipe
+  #
+  #   plug :set_response_body
+  #
+  #   private
+  #
+  #   def set_response_body(conn)
+  #     conn.set_response_body('Hello, World!')
+  #   end
+  # end
+  # ```
+  #
+  # In order to do something like the previous example you don't need to enable
+  # this extension. Notice that rails took care of dispatching the request to
+  # our {WebPipe} rack application, which was then responsible for generating the
+  # response. In this case, it used a simple call to
+  # {WebPipe::Conn#set_response_body}.
+  #
+  # 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.
+  #
+  # 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.
+  # - You want to use controller helpers from your {WebPipe} application.
+  #
+  # Rails responsibilities for controlling the request/response cycle and the
+  # rendering process are a little bit tangled. For this reason, even if you
+  # want to use {WebPipe} applications instead of Rails controller actions you
+  # still have to use the typical top `ApplicationController` in order to define
+  # some behaviour for the view layer:
+  #
+  # - Which layout is applied to the template.
+  # - Which helpers will become available to the templates.
+  #
+  # By default, the controller in use is `ActionController::Base`, which means
+  # that no layout is applied and only built-in helpers (for example,
+  # `number_as_currency`) are available. You can change it via the
+  # `:rails_controller` configuration option.
+  #
+  # The main method that this extension adds to {WebPipe::Conn} is `#render`,
+  # which just delegates to the Rails implementation as you'd do in a typical
+  # rails controller. Remember that you can provide template instance variables
+  # through the keyword `:assigns`.
+  #
+  # ```ruby
+  # # config/routes.rb
+  # get '/articles', to: ArticlesIndex.new
+  #
+  # # app/controllers/application_controller.rb
+  # class ApplicationController < ActionController::Base
+  #   # By default uses the layout in `layouts/application`
+  # end
+  #
+  # # app/controllers/articles_index.rb
+  # require 'web_pipe/plugs/config'
+  #
+  #
+  # WebPipe.load_extensions(:rails) # You can put it in an initializer
+  #
+  # class ArticlesIndex
+  #   include WebPipe
+  #
+  #   plug :config, WebPipe::Plugs::Config.(
+  #     rails_controller: ApplicationController
+  #   )
+  #
+  #   def render(conn)
+  #     conn.render(
+  #       template: 'articles/index',
+  #       assigns: { articles: Article.all }
+  #     )
+  #   end
+  # 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. 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:
+  #
+  # - `url_helpers` returns Rails router url helpers.
+  # - `helpers` returns the associated controller helpers.
+  #
+  # In all the examples we have supposed that we are putting {WebPipe}
+  # applications within `app/controllers/` directory. However, remember you can
+  # put them wherever you like as long as you respect rails `autoload_paths`.
+  #
+  # Here you have a link to a very simple and contrived example of a rails
+  # application integrating `web_pipe`:
+  #
+  # 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
+  # @see https://api.rubyonrails.org/classes/ActionController/Helpers.html
+  # @see https://guides.rubyonrails.org/autoloading_and_reloading_constants.html#autoload-paths
+  module Rails
+    def render(*args)
+      set_response_body(
+        rails_controller.renderer.render(*args)
+      )
+    end
+
+    # @see https://devdocs.io/rails~6.0/actioncontroller/helpers
+    def helpers
+      rails_controller.helpers
+    end
+
+    # @see https://api.rubyonrails.org/v6.0.1/classes/ActionView/Helpers/UrlHelper.html
+    def url_helpers
+      ::Rails.application.routes.url_helpers
+    end
+
+    private
+
+    def rails_controller
+      config.fetch(:rails_controller, ActionController::Base)
+    end
+  end
+
+  Conn.include(Rails)
+end

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

data/lib/web_pipe/rack_support/middleware_specification.rb

@@ -60,10 +60,11 @@ module WebPipe
       # @return [Array<RackSupport::Middleware>]
       def call
         klass = spec[0]
-        options = spec[1..-1] || Types::EMPTY_ARRAY
-        if klass.is_a?(WebPipe)
+        options = spec[1..] || Types::EMPTY_ARRAY
+        case klass
+        when WebPipe
           klass.middlewares
-        elsif klass.is_a?(Class)
+        when Class
           [Middleware.new(middleware: klass, options: options)]
         end
       end

data/lib/web_pipe/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module WebPipe
-  VERSION = '0.9.0'
+  VERSION = '0.13.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.9.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Marc Busqué
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-08-31 00:00:00.000000000 Z
+date: 2021-01-15 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
@@ -244,7 +265,6 @@ files:
 - _config.yml
 - bin/console
 - bin/setup
-- docs/_config.yml
 - docs/building_a_rack_application.md
 - docs/composing_applications.md
 - docs/connection_struct.md
@@ -260,6 +280,7 @@ files:
 - docs/extensions/dry_view.md
 - docs/extensions/flash.md
 - docs/extensions/params.md
+- docs/extensions/rails.md
 - docs/extensions/redirect.md
 - docs/extensions/router_params.md
 - docs/extensions/session.md
@@ -298,6 +319,7 @@ files:
 - lib/web_pipe/extensions/flash/flash.rb
 - lib/web_pipe/extensions/params/params.rb
 - lib/web_pipe/extensions/params/params/transf.rb
+- lib/web_pipe/extensions/rails/rails.rb
 - lib/web_pipe/extensions/redirect/redirect.rb
 - lib/web_pipe/extensions/router_params/router_params.rb
 - lib/web_pipe/extensions/session/session.rb
@@ -334,8 +356,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.2.3
 signing_key: 
 specification_version: 4
 summary: Rack application builder through a pipe of operations on an immutable struct.

data/docs/_config.yml

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