web_pipe 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 17cb26c4876d3063751dd001c823d57f3ada911be264407078b76bd8cfc684b5
-  data.tar.gz: 251591e61a0f30661a09ca507f28231e418fa9a626856613c8e171a67a107f37
+  metadata.gz: da7aa2093465c5b9b0b2fa4653f28580657989498aff26dfe9e52c3241b7efb9
+  data.tar.gz: 80562491db7789419a49030d2ab239330b98ad40310e428806dfed8f0381259e
 SHA512:
-  metadata.gz: 8ae7586e3ed9a3969d540609bad29257f0d7c5eb06c244ad954e7a10cce44507ce5b247a7f7a18ece6d3713969108e8c172aac85442f01d41824bd477270bbe1
-  data.tar.gz: d3a4900f7daf79377aaf7dd9ad3df397b5b55d16eb53d1ac025a029f9feb28e392819b969f9a64e5573216252db257f9e6f4ef359960c246b45321ed3708d6c7
+  metadata.gz: 2dad49f899b9c25a18fba6b8caebaa8898de0afab6ba124f3618d3080f1ccbdb4c98c2805298eea29d02ed3fdaef06cb0c29f228283e230832729884c533cb12
+  data.tar.gz: 3bf25d5a0c73b45263bd5ae3a8718f57412f5513da33313c9600163b17e116834dbff3ab55df26cfc61b06226727e2700849a77ee8f4daf45a9f7064d1f4058a

data/CHANGELOG.md

@@ -1,200 +1,117 @@
 # Change Log
 All notable changes to this project will be documented in this file.
 
-The format is based on [Keep a Changelog](http://keepachangelog.com/) 
+The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
-## [0.5.0] - 2019-07-26
+## [0.6.0] - 2019-08-02
 ### Added
-- **BREAKING**: `container` is now an extension
-  ([16](https://github.com/waiting-for-dev/web_pipe/pull/16)):
- 
-It adds a `Conn#container` method, while the plug while being the same than before it has been moved to `web_pipe/extensions/container/plugs/container`.
-
-- Extension providing Integration with `dry-schema` [([18](https://github.com/waiting-for-dev/web_pipe/pull/18))]. See [`extensions/dry_schema.rb`](lib/web_pipe/extensions/dry_schema/dry_schema.rb).
+- **BREAKING**. Rename `put` methods as `add`.
+  [[#26]](https://github.com/waiting-for-dev/web_pipe/pull/26).
 
-- No need to manually call `#to_proc` when composing plugs. This makes both of
-  the following valid
-  ([13](https://github.com/waiting-for-dev/web_pipe/pull/13)):
+- **BREAKING**. Rename taint to halt, and clean/dirty to ongoing/halted.
+  [[#25](https://github.com/waiting-for-dev/web_pipe/pull/25)].
 
-```ruby
-plug :app, &App.new
-plug :app, App.new
-```
+- **BREAKING**. URL redundant methods need to be loaded from `:url` extension.
+  [[#24](https://github.com/waiting-for-dev/web_pipe/pull/24)].
 
-- Extension adding flash functionality to conn ([15](https://github.com/waiting-for-dev/web_pipe/pull/15)).
+- Merge router params with GET and POST params.
+  [[#23](https://github.com/waiting-for-dev/web_pipe/pull/23)].
 
-For this extension to work,
-[`Rack::Flash`](https://github.com/treeder/rack-flash) and `Rack::Session`
-middlewares must be used:
+- Extension integrating rack session.
+  [[#21](https://github.com/waiting-for-dev/web_pipe/pull/21)].
 
-```ruby
-require 'rack-flash'
-require 'rack/session/cookie'
+- Extension to add/delete cookies.
+  [[#20](https://github.com/waiting-for-dev/web_pipe/pull/20)] &
+  [[#22](https://github.com/waiting-for-dev/web_pipe/pull/22)].
 
-class App
-  include WebPipe
-  
-  use :session, Rack::Session::Cookie, secret: 'secret'
-  use :flash, Rack::Flash
-  
-  plug :put_in_flash, ->(conn) { conn.put_flash(:error, 'Error') }
-  plug :put_in_flash_now, ->(conn) { conn.put_flash_now(:error_now, 'Error now') }
-end
-```
+- Extension to easily create HTTP redirects.
+  [[#19](https://github.com/waiting-for-dev/web_pipe/pull/19)].
 
-Usually you will expose `conn.flash` to your views.
+- Added `Conn#set_response_headers` method.
+  [[#27](https://github.com/waiting-for-dev/web_pipe/pull/27)].
 
-- Extension automatically require their associated plugs, so there is no need
-  to require them manually anymore. 
-
-### Fixed
-- Fixed bug not allowing middlewares to modify responses initially set with
-  default values ([14](https://github.com/waiting-for-dev/web_pipe/pull/14))
 
-## [0.4.0] - 2019-07-17
+## [0.5.0] - 2019-07-26
 ### Added
-- **BREAKING**: Middlewares have to be named when used
-  ([11](https://github.com/waiting-for-dev/web_pipe/pull/11)):
-
-```ruby
-use :cookies, Rack::Session:Cookie, secret: 'my_secret', key: 'foo'
-```
+- **BREAKING**. `container` is now an extension.
+  [[#16](https://github.com/waiting-for-dev/web_pipe/pull/16)].
 
-- **BREAKING**: Middlewares have to be initialized when composed
-  ([11](https://github.com/waiting-for-dev/web_pipe/pull/11)):
+- Extension providing Integration with `dry-schema`.
+  [[#18](https://github.com/waiting-for-dev/web_pipe/pull/18)].
 
-```ruby
-use :pipe, PipeWithMiddlewares.new
-```
+- No need to manually call `#to_proc` when composing plugs.
+  [[#13](https://github.com/waiting-for-dev/web_pipe/pull/13)].
 
-- **BREAKING**: The array of injected plugs is now scoped within a `plugs:`
-  kwarg ([11](https://github.com/waiting-for-dev/web_pipe/pull/11)):
+- Extension adding flash functionality to conn.
+  [[#15](https://github.com/waiting-for-dev/web_pipe/pull/15)].
 
-```ruby
-App.new(plugs: { nothing: ->(conn) { conn } })
-```
+- Extensions automatically require their associated plugs, so there is no need
+  to require them manually anymore.
+  [[#17](https://github.com/waiting-for-dev/web_pipe/pull/17)].
 
-- Middlewares can be injected
-  ([11](https://github.com/waiting-for-dev/web_pipe/pull/11)):
-
-```ruby
-App.new(middlewares: { cache: [MyMiddleware, my_options] })
-```
-
-- DSL helper method `compose` to add middlewares and plugs in order and in a
-  single shot ([12](https://github.com/waiting-for-dev/web_pipe/pull/11)):
+### Fixed
+- Fixed bug not allowing middlewares to modify responses initially set with
+  default values.
+  [[#14](https://github.com/waiting-for-dev/web_pipe/pull/14)].
 
-```ruby
-class App
-  include WebPipe.(container: Container)
 
-  use :first, FirstMiddleware
+## [0.4.0] - 2019-07-17
+### Added
+- **BREAKING**. Middlewares have to be named when used.
+  [[#11](https://github.com/waiting-for-dev/web_pipe/pull/11)].
 
-  plug :first_plug, 'first_plug'
-end
+- **BREAKING**. Middlewares have to be initialized when composed.
+  [[#11](https://github.com/waiting-for-dev/web_pipe/pull/11)].
 
-class AnotherApp
-  include WebPipe.(container: Container)
+- **BREAKING**. The array of injected plugs is now scoped within a `plugs:`
+  kwarg.
+  [[#11](https://github.com/waiting-for-dev/web_pipe/pull/11)].
 
-  compose App
-  # Equivalent to:
-  # use App.new
-  # plug &App.new
+- Middlewares can be injected.
+  [[#11](https://github.com/waiting-for-dev/web_pipe/pull/11)].
 
-  use :second, SecondMiddleware
+- DSL helper method `compose` to add middlewares and plugs in order and in a
+  single shot-
+  [[#12](https://github.com/waiting-for-dev/web_pipe/pull/11)].
 
-  plug :second_plug, 'second_plug'
-end
-```
 
 ## [0.3.0] - 2019-07-12
 ### Added
-- **BREAKING**: When plugging with `plug:`, the operation is no longer
-  specified through `with:`. Now it is just the second positional argument
-  ([9](https://github.com/waiting-for-dev/web_pipe/pull/9)):
-
-```ruby
-plug :from_container, 'container'
-plug :inline, ->(conn) { conn.set_response_body('Hello world') }
-```
-- It is possible to plug a block
-  ([9](https://github.com/waiting-for-dev/web_pipe/pull/9)):
-```ruby
-  plug(:content_type) { |conn| conn.add_response_header('Content-Type', 'text/html') }
-```
+- **BREAKING**. When plugging with `plug:`, the operation is no longer
+  specified through `with:`. Now it is just the second positional argument-
+  [[#9](https://github.com/waiting-for-dev/web_pipe/pull/9)].
 
-- WebPipe plug's can be composed. A WebPipe proc representation is the
-  composition of all its operations, which is an operation itself
-  ([9](https://github.com/waiting-for-dev/web_pipe/pull/9)):
-
-```ruby
-class HtmlApp
-  include WebPipe
-
-  plug :content_type
-  plug :default_status
-
-  private
-
-  def content_type(conn)
-    conn.add_response_header('Content-Type', 'text/html')
-  end
-
-  def default_status(conn)
-    conn.set_status(404)
-  end
-end
-
-class App
-  include WebPipe
-
-  plug :html, &HtmlApp.new
-  plug :body
+- It is possible to plug a block-
+  [[#9](https://github.com/waiting-for-dev/web_pipe/pull/9)].
 
-  private
-
-  def body(conn)
-     conn.set_response_body('Hello, world!')
-  end
-end
-```
-
-- WebPipe's middlewares can be composed into another WebPipe class, also
-  through `:use` ([10](https://github.com/waiting-for-dev/web_pipe/pull/10)):
-
-```ruby
-class HtmlApp
-  include WebPipe
-
-  use Rack::Session::Cookie, key: 'key', secret: 'top_secret'
-  use Rack::MethodOverride
-end
+- WebPipe plug's can be composed. A WebPipe proc representation is the
+  composition of all its operations, which is an operation itself-
+  [[#9](https://github.com/waiting-for-dev/web_pipe/pull/9)].
 
-class App
-  include WebPipe
+- WebPipe's middlewares can be composed into another WebPipe class-
+  [[#10](https://github.com/waiting-for-dev/web_pipe/pull/10)].
 
-  use HtmlApp
-end
-```
 
 ## [0.2.0] - 2019-07-05
 ### Added
-- dry-view integration
-  ([#1](https://github.com/waiting-for-dev/web_pipe/pull/1),
-  [#3](https://github.com/waiting-for-dev/web_pipe/pull/3),
-  [#4](https://github.com/waiting-for-dev/web_pipe/pull/4),
-  [#5](https://github.com/waiting-for-dev/web_pipe/pull/5) and
-  [#6](https://github.com/waiting-for-dev/web_pipe/pull/6))
-- Configuring a container in `WebPipe::Conn`
-  ([#2](https://github.com/waiting-for-dev/web_pipe/pull/2) and
-  [#5](https://github.com/waiting-for-dev/web_pipe/pull/5))
-- Plug to set `Content-Type` response header
-  ([#7](https://github.com/waiting-for-dev/web_pipe/pull/7))
+- dry-view integration-
+  [[#1](https://github.com/waiting-for-dev/web_pipe/pull/1)],
+  [[#3](https://github.com/waiting-for-dev/web_pipe/pull/3)],
+  [[#4](https://github.com/waiting-for-dev/web_pipe/pull/4)],
+  [[#5](https://github.com/waiting-for-dev/web_pipe/pull/5)] &
+  [[#6](https://github.com/waiting-for-dev/web_pipe/pull/6)].
+
+- Configuring a container in `WebPipe::Conn`-
+  [[#2](https://github.com/waiting-for-dev/web_pipe/pull/2)] &
+  [[#5](https://github.com/waiting-for-dev/web_pipe/pull/5)].
+
+- Plug to set `Content-Type` response header-
+  [[#7](https://github.com/waiting-for-dev/web_pipe/pull/7)].
 
 ### Fixed
-- Fix key interpolation in `KeyNotFoundInBagError`
-  ([#8](https://github.com/waiting-for-dev/web_pipe/pull/8))
+- Fix key interpolation in `KeyNotFoundInBagError`-
+  [[#8](https://github.com/waiting-for-dev/web_pipe/pull/8)].
 
 ## [0.1.0] - 2019-05-07
 ### Added

data/README.md

@@ -100,12 +100,12 @@ class GreetingAdminApp
     user = UsersRepo[conn.params['id'].to_i]
     if user
       conn.
-        put(:user, user)
+        add(:user, user)
     else
       conn.
         set_status(404).
         set_response_body('<h1>Not foud</h1>').
-        taint
+        halt
     end
   end
 
@@ -116,7 +116,7 @@ class GreetingAdminApp
       conn.
         set_status(401).
         set_response_body('<h1>Unauthorized</h1>').
-        taint
+        halt
     end
   end
   
@@ -144,14 +144,14 @@ immutability and make method chaining possible.
 Each operation in the pipe must accept a single argument of a
 `WebPipe::Conn` instance and it must also return an instance of it.
 In fact, what the first operation in the pipe takes is a
-`WebPipe::Conn::Clean` subclass instance. When one of your operations
-calls `#taint` on it, a `WebPipe::Conn::Dirty` is returned and the pipe
-is halted. This one or the 'clean' instance that reaches the end of
+`WebPipe::Conn::Ongoing` subclass instance. When one of your operations
+calls `#halt` on it, a `WebPipe::Conn::Halted` is returned and the pipe
+is halted. This one or the 'ongoing' instance that reaches the end of
 the pipe will be in command of the web response.
 
 Operations have the chance to prepare data to be consumed by
 downstream operations. Data can be added to the struct through
-`#put(key, value)`, while it can be consumed with `#fetch(key)`.
+`#add(key, value)`, while it can be consumed with `#fetch(key)`.
 
 Attributes and methods in `WebPipe::Conn` are [fully
 documented](https://www.rubydoc.info/github/waiting-for-dev/web_pipe/master/WebPipe/Conn).

data/lib/web_pipe/app.rb

@@ -18,8 +18,8 @@ module WebPipe
   # return it.
   #
   # {Conn} can itself be of two different types (subclasses of it}:
-  # {Conn::Clean} and {Conn::Dirty}. The pipe is stopped
-  # whenever the stack is emptied or a {Conn::Dirty} is
+  # {Conn::Ongoing} and {Conn::Halted}. The pipe is stopped
+  # whenever the stack is emptied or a {Conn::Halted} is
   # returned in any of the steps.
   class App
     # Type for a rack environment.

data/lib/web_pipe/conn.rb

@@ -17,10 +17,10 @@ module WebPipe
   # calls.
   #
   # There are two subclasses (two types) for this:
-  # {Conn::Clean} and {Conn::Dirty}. {ConnSupport::Builder} constructs
-  # a {Conn::Clean} struct, while {#taint} copies the data to a
-  # {Conn::Dirty} instance. The intention of this is to halt
-  # operations on the web request/response cycle one a {Conn::Dirty}
+  # {Conn::Ongoing} and {Conn::Halted}. {ConnSupport::Builder} constructs
+  # a {Conn::Ongoing} struct, while {#halt} copies the data to a
+  # {Conn::Halted} instance. The intention of this is to halt
+  # operations on the web request/response cycle one a {Conn::Halted}
   # instance is detected.
   #
   # @example
@@ -28,7 +28,7 @@ module WebPipe
   #     set_status(404).
   #     add_response_header('Content-Type', 'text/plain').
   #     set_response_body('Not found').
-  #     taint
+  #     halt
   class Conn < Dry::Struct
     include ConnSupport::Types
 
@@ -210,71 +210,11 @@ module WebPipe
     # @return [Bag[]]
     attribute :bag, Bag
 
-    # Base part of the URL.
-    #
-    # This is {#scheme} and {#host}, adding {#port} unless it is the
-    # default one for the scheme.
-    #
-    # @return [BaseUrl]
-    #
-    # @example
-    #   'https://example.org'
-    #   'http://example.org:8000'
-    def base_url
-      request.base_url
-    end
-
-    # URL path.
-    #
-    # This is {#script_name} and {#path_info}.
-    #
-    # @return [Path]
-    #
-    # @example
-    #   'index.rb/users'
-    def path
-      request.path
-    end
-
-    # URL full path.
-    #
-    # This is {#path} with {#query_string} if present.
-    #
-    # @return [FullPath]
-    #
-    # @example
-    #   '/users?id=1'
-    def full_path
-      request.fullpath
-    end
-
-    # Request URL.
-    #
-    # This is the same as {#base_url} plus {#full_path}.
-    #
-    # @return [Url]
-    #
-    # @example
-    #   'http://www.example.org:8000/users?id=1'
-    def url
-      request.url
-    end
-
-    # GET and POST params merged in a hash.
-    #
-    # @return [Params]
-    #
-    # @example
-    #   { 'id' => 1, 'name' => 'Joe' }
-    def params
-      request.params
-    end
-
     # Sets response status code.
     #
     # @param code [StatusCode]
     #
-    # @return {Conn}
+    # @return [Conn]
     def set_status(code)
       new(
         status: code
@@ -290,7 +230,7 @@ module WebPipe
     #
     # @param content [#each, String]
     #
-    # @return {Conn}
+    # @return [Conn]
     #
     # @see https://www.rubydoc.info/github/rack/rack/master/file/SPEC#label-The+Body
     def set_response_body(content)
@@ -299,6 +239,24 @@ module WebPipe
       )
     end
 
+    # Sets response headers.
+    #
+    # Substitues everything that was present as response headers by
+    # the new given hash.
+    #
+    # Headers keys are normalized.
+    #
+    # @param headers [Hash]
+    #
+    # @return [Conn]
+    #
+    # @see ConnSupport::Headers.normalize_key
+    def set_response_headers(headers)
+      new(
+        response_headers: ConnSupport::Headers.normalize(headers)
+      )
+    end
+
     # Adds given pair to response headers.
     #
     # `key` is normalized.
@@ -306,7 +264,7 @@ module WebPipe
     # @param key [String]
     # @param value [String]
     #
-    # @return {Conn}
+    # @return [Conn]
     #
     # @see ConnSupport::Headers.normalize_key
     def add_response_header(key, value)
@@ -323,7 +281,7 @@ module WebPipe
     #
     # @param key [String]
     #
-    # @return {Conn}
+    # @return [Conn]
     #
     # @see ConnSupport::Headers.normalize_key
     def delete_response_header(key)
@@ -356,7 +314,7 @@ module WebPipe
     # @param value [Object]
     #
     # @return [Conn]
-    def put(key, value)
+    def add(key, value)
       new(
         bag: bag.merge(key => value)
       )
@@ -381,20 +339,27 @@ module WebPipe
       ]
     end
 
-    # Copies all the data to a {Dirty} instance and
+    # Copies all the data to a {Halted} instance and
     # returns it.
     #
-    # @return [Dirty]
-    def taint
-      Dirty.new(attributes)
+    # @return [Halted]
+    def halt
+      Halted.new(attributes)
+    end
+
+    # Returns whether the instance is {Halted}.
+    #
+    # @return [Bool]
+    def halted?
+      is_a?(Halted)
     end
 
     # Type of {Conn} representing an ongoing request/response
     # cycle.
-    class Clean < Conn; end
+    class Ongoing < Conn; end
 
     # Type of {Conn} representing a halted request/response
     # cycle.
-    class Dirty < Conn; end
+    class Halted < Conn; end
   end
 end

data/lib/web_pipe/conn_support/builder.rb

@@ -6,16 +6,16 @@ module WebPipe
   module ConnSupport
     # Helper module to build a {Conn} from a rack's env.
     #
-    # It always return a {Conn::Clean} subclass.
+    # It always return a {Conn::Ongoing} subclass.
     #
     # @api private
     module Builder
       # @param env [Types::Env] Rack's env
       #
-      # @return [Conn::Clean]
+      # @return [Conn::Ongoing]
       def self.call(env)
         rr = ::Rack::Request.new(env)
-        Conn::Clean.new(
+        Conn::Ongoing.new(
           request: rr,
           env: env,
 

data/lib/web_pipe/conn_support/composition.rb

@@ -13,9 +13,9 @@ module WebPipe
     # take a {Conn} as argument and return a {Conn}.
     #
     # However, {Conn} can itself be of two different types (subclasses
-    # of it): a {Conn::Clean} or a {Conn::Dirty}. On execution time,
+    # of it): a {Conn::Ongoing} or a {Conn::Halted}. On execution time,
     # the composition is stopped whenever the stack is emptied or a
-    # {Conn::Dirty} is returned in any of the steps.
+    # {Conn::Halted} is returned in any of the steps.
     class Composition
       # Type for an operation.
       #
@@ -32,7 +32,7 @@ module WebPipe
             <<~eos
             An operation returned +#{returned.inspect}+. To be valid,
             an operation must return whether a
-            WebPipe::Conn::Clean or a WebPipe::Conn::Dirty.
+            WebPipe::Conn::Ongoing or a WebPipe::Conn::Halted.
           eos
           )
         end
@@ -71,9 +71,9 @@ module WebPipe
       def apply_operation(conn, operation)
         result = operation.(conn)
         case result
-        when Conn::Clean
+        when Conn::Ongoing
           Success(result)
-        when Conn::Dirty
+        when Conn::Halted
           Failure(result)
         else
           raise InvalidOperationResult.new(result)

data/lib/web_pipe/conn_support/headers.rb

@@ -92,6 +92,13 @@ module WebPipe
       def self.normalize_key(key)
         key.downcase.gsub('_', '-').split('-').map(&:capitalize).join('-')
       end
+
+      # Returns a new hash with all keys normalized.
+      #
+      # @see #normalize_key
+      def self.normalize(headers)
+        headers.transform_keys(&method(:normalize_key))
+      end
     end
   end
 end

data/lib/web_pipe/conn_support/types.rb

@@ -25,12 +25,6 @@ module WebPipe
       QueryString = Strict::String
       RequestBody = Interface(:gets, :each, :read, :rewind)
 
-      BaseUrl = Strict::String
-      Path = Strict::String
-      FullPath = Strict::String
-      Url = Strict::String
-      Params = Strict::Hash
-
       Status = Strict::Integer.
                  default(200).
                  constrained(gteq: 100, lteq: 599)

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

@@ -19,12 +19,12 @@ module WebPipe
     #     private
     #
     #     def resolve(conn)
-    #       conn.put(:dependency, conn.fetch(:container)[:name])
+    #       conn.add(:dependency, conn.fetch(:container)[:name])
     #     end
     #   end
     module Container
       def self.[](container)
-        ->(conn) { conn.put(:container, Types::Container[container]) }
+        ->(conn) { conn.add(:container, Types::Container[container]) }
       end
     end
   end

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

@@ -0,0 +1,84 @@
+require 'web_pipe'
+require 'web_pipe/types'
+require 'rack/utils'
+
+module WebPipe
+  # Extension to help dealing with request and response cookies.
+  #
+  # This extension helps with the addition of the `Set-Cookie` header
+  # to the response, which is the way the server has to instruct the
+  # browser to keep a cookie. A cookie can be added with the
+  # {#add_cookie} method, while it can be marked for deletion with
+  # {#delete_cookie}. Remember that marking a cookie for deletion just
+  # means adding the same cookie name with an expiration time in the
+  # past.
+  #
+  # Besides, it also adds a {#request_cookies} method to get the
+  # cookies in the request.
+  #
+  # @example
+  #  require 'web_pipe'
+  #
+  #  WebPipe.load_extensions(:cookies)
+  #
+  #  class SetCookie
+  #    include WebPipe
+  #
+  #    plug :set_cookie, ->(conn) { conn.set_cookie('foo', 'bar', path: '/') }
+  #  end
+  #
+  #  class DeleteCookie
+  #    include WebPipe
+  #
+  #    plug :delete_cookie, ->(conn) { conn.delete_cookie('foo', path: '/') }
+  #  end
+  module Cookies
+    # Valid options for {#set_cookie}.
+    SET_COOKIE_OPTIONS = Types::Strict::Hash.schema(
+      domain?: Types::Strict::String.optional,
+      path?: Types::Strict::String.optional,
+      max_age?: Types::Strict::Integer.optional,
+      expires?: Types::Strict::Time.optional,
+      secure?: Types::Strict::Bool.optional,
+      http_only?: Types::Strict::Bool.optional,
+      same_site?: Types::Strict::Symbol.enum(:none, :lax, :strict).optional
+    )
+
+    # Valid options for {#delete_cookie}.
+    DELETE_COOKIE_OPTIONS = Types::Strict::Hash.schema(
+      domain?: Types::Strict::String.optional,
+      path?: Types::Strict::String.optional
+    )
+
+    # @return [Hash]
+    def request_cookies
+      request.cookies
+    end
+    
+    
+    # @param key [String]
+    # @param value [String]
+    # @param opts [SET_COOKIE_OPTIONS[]]
+    def set_cookie(key, value, opts = Types::EMPTY_HASH)
+      ::Rack::Utils.set_cookie_header!(
+        response_headers,
+        key,
+        { value: value }.merge(SET_COOKIE_OPTIONS[opts])
+      )
+      self
+    end
+
+    # @param key [String]
+    # @param opts [DELETE_COOKIE_OPTIONS[]]
+    def delete_cookie(key, opts = Types::EMPTY_HASH)
+      ::Rack::Utils.delete_cookie_header!(
+        response_headers,
+        key,
+        DELETE_COOKIE_OPTIONS[opts]
+      )
+      self
+    end
+  end
+
+  Conn.include(Cookies)
+end

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

@@ -33,7 +33,7 @@ module WebPipe
   #  end
   #
   # By default, when the result of applying the schema is a failure,
-  # {Conn} is tainted with a 500 as status code. However, you can
+  # {Conn} is halted with a 500 as status code. However, you can
   # specify your own handler for the unhappy path. It will take the
   # {Conn} and {Dry::Schema::Result} instances as arguments:
   #

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

@@ -19,7 +19,7 @@ module WebPipe
       # @return [ConnSupport::Composition::Operation[]]
       def self.[](handler)
         lambda do |conn|
-          conn.put(PARAM_SANITIZATION_HANDLER_KEY, Handler[handler])
+          conn.add(PARAM_SANITIZATION_HANDLER_KEY, Handler[handler])
         end
       end
     end

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

@@ -15,7 +15,7 @@ module WebPipe
         conn.
           set_status(500).
           set_response_body('Given params do not conform with the expected schema').
-          taint
+          halt
       end
 
       # @param schema [Dry::Schema::Processor]
@@ -26,7 +26,7 @@ module WebPipe
         lambda do |conn|
           result = schema.(conn.params)
           if result.success?
-            conn.put(DrySchema::SANITIZED_PARAMS_KEY, result.output)
+            conn.add(DrySchema::SANITIZED_PARAMS_KEY, result.output)
           else
             get_handler(conn, handler).(conn, result)
           end

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

@@ -3,7 +3,7 @@ require 'web_pipe/extensions/dry_view/dry_view'
 
 module WebPipe
   module Plugs
-    # Calls object with conn and puts the result into bag's `:view_context`.
+    # Calls object with conn and add the result into bag's `:view_context`.
     #
     # This is meant to contain a Proc which will be called with the same
     # {WebPipe::Conn} instance of the operation. It must return
@@ -30,7 +30,7 @@ module WebPipe
       def self.[](view_context_proc)
         Types.Interface(:call)[view_context_proc]
         lambda do |conn|
-          conn.put(Conn::VIEW_CONTEXT_KEY, view_context_proc.(conn))
+          conn.add(Conn::VIEW_CONTEXT_KEY, view_context_proc.(conn))
         end
       end
     end

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

@@ -19,8 +19,8 @@ module WebPipe
   #     use :session, Rack::Session::Cookie, secret: 'secret'
   #     use :flash, Rack::Flash
   #
-  #     plug :put_in_flash, ->(conn) { conn.put_flash(:notice, 'Hello world') }
-  #     plug :put_in_flash_now, ->(conn) { conn.put_flash_now(:notice_now, 'Hello world now') }
+  #     plug :add_in_flash, ->(conn) { conn.add_flash(:notice, 'Hello world') }
+  #     plug :add_in_flash_now, ->(conn) { conn.add_flash_now(:notice_now, 'Hello world now') }
   #   end
   #
   # Usually, you will end up making `conn.flash` available to your view system:
@@ -47,26 +47,26 @@ module WebPipe
     def flash
       env.fetch(RACK_FLASH_KEY) do
         raise ConnSupport::MissingMiddlewareError.new(
-                'flash', 'Rack::Flash', 'rack-flash3'
+                'flash', 'Rack::Flash', 'https://rubygems.org/gems/rack-flash3'
               )
       end
     end
 
-    # Puts an item to the flash bag to be consumed by next request.
+    # Adds an item to the flash bag to be consumed by next request.
     #
     # @param key [String]
     # @param value [String]
-    def put_flash(key, value)
+    def add_flash(key, value)
       flash[key] = value
       self
     end
 
-    # Puts an item to the flash bag to be consumed by the same request
+    # Adds an item to the flash bag to be consumed by the same request
     # in process.
     #
     # @param key [String]
     # @param value [String]
-    def put_flash_now(key, value)
+    def add_flash_now(key, value)
       flash.now[key] = value
       self
     end

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

@@ -0,0 +1,39 @@
+require 'web_pipe/types'
+
+module WebPipe
+  # Helper method to create redirect responses.
+  #
+  # This extensions adds a {#redirect} method to {Conn} which helps
+  # setting the `Location` header and the status code needed to
+  # instruct the browser to perform a redirect. By default, `302`
+  # status code is used.
+  #
+  # @example
+  #  require 'web_pipe'
+  #
+  #  WebPipe.load_extensions(:redirect)
+  #
+  #  class MyApp
+  #    include WebPipe
+  #
+  #    plug(:redirect) do |conn|
+  #      conn.redirect('/', 301)
+  #    end
+  #  end
+  module Redirect
+    # Location header
+    LOCATION_HEADER = 'Location'
+
+    # Valid type for a redirect status code
+    RedirectCode = Types::Strict::Integer.constrained(gteq: 300, lteq: 399)
+    
+    # @param path [String]
+    # @param code [Integer]
+    def redirect(path, code = 302)
+      add_response_header(LOCATION_HEADER, path).
+        set_status(RedirectCode[code])
+    end
+  end
+
+  Conn.include(Redirect)
+end

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

@@ -0,0 +1,86 @@
+require 'web_pipe/conn'
+require 'web_pipe/types'
+require 'rack'
+
+module WebPipe
+  # Wrapper around Rack::Session middlewares.
+  #
+  # This extension provides with helper methods to retrieve rack
+  # session and work with it while still being able to chain {Conn}
+  # method calls.
+  #
+  # It requires one of `Rack::Session` middlewares to be present.
+  #
+  # @example
+  #   require 'web_pipe'
+  #
+  #   WebPipe.load_extensions(:session)
+  #
+  #   class MyApp
+  #     include WebPipe
+  #
+  #     use Rack::Cookie, secret: 'top_secret'
+  #
+  #     plug :add_session, ->(conn) { conn.add_session('foo', 'bar') }
+  #     plug :fetch_session, ->(conn) { conn.add(:foo, conn.fetch_session('foo')) }
+  #     plug :delete_session, ->(conn) { conn.delete_session('foo') }
+  #     plug :clear_session, ->(conn) { conn.clear_session }
+  #   end
+  module Session
+    # Type for session keys.
+    SESSION_KEY = Types::Strict::String
+
+    # Returns Rack::Session's hash
+    #
+    # @return [Rack::Session::Abstract::SessionHash]
+    def session
+      env.fetch(::Rack::RACK_SESSION) do
+        raise ConnSupport::MissingMiddlewareError.new(
+                'session', 'Rack::Session', 'https://www.rubydoc.info/github/rack/rack/Rack/Session'
+              )
+      end
+    end
+
+    # Fetches given key from the session.
+    #
+    # @param key [SESSION_KEY[]] Session key to fetch
+    # @param default [Any] Default value if key is not found
+    # @yieldreturn Default value if key is not found and default is not given
+    # @raise KeyError When key is not found and not default nor block are given
+    # @return [Any]
+    def fetch_session(*args, &block)
+      SESSION_KEY[args[0]]
+      session.fetch(*args, &block)
+    end
+
+
+    # Adds given key/value pair to the session.
+    #
+    # @param key [SESSION_KEY[]] Session key
+    # @param value [Any] Value
+    # @return [Conn]
+    def add_session(key, value)
+      session[SESSION_KEY[key]] = value
+      self
+    end
+
+    # Deletes given key form the session.
+    #
+    # @param key [SESSION_KEY[]] Session key
+    # @return [Conn]
+    def delete_session(key)
+      session.delete(SESSION_KEY[key])
+      self
+    end
+
+    # Deletes everything from the session.
+    #
+    # @return [Conn]
+    def clear_session
+      session.clear
+      self
+    end
+  end
+
+  Conn.include(Session)
+end

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

@@ -0,0 +1,95 @@
+module WebPipe
+  # Adds helper methods related to the request URL.
+  #
+  # This methods are in fact redundant with the information already
+  # present in {Conn} struct but, of course, they are very useful.
+  module Url
+    # Env's key used to retrieve params set by the router.
+    #
+    # @see #router_params
+    ROUTER_PARAMS_KEY = 'router.params'
+
+    # Base part of the URL.
+    #
+    # This is {#scheme} and {#host}, adding {#port} unless it is the
+    # default one for the scheme.
+    #
+    # @return [String]
+    #
+    # @example
+    #   'https://example.org'
+    #   'http://example.org:8000'
+    def base_url
+      request.base_url
+    end
+
+    # URL path.
+    #
+    # This is {#script_name} and {#path_info}.
+    #
+    # @return [String]
+    #
+    # @example
+    #   'index.rb/users'
+    def path
+      request.path
+    end
+
+    # URL full path.
+    #
+    # This is {#path} with {#query_string} if present.
+    #
+    # @return [String]
+    #
+    # @example
+    #   '/users?id=1'
+    def full_path
+      request.fullpath
+    end
+
+    # Request URL.
+    #
+    # This is the same as {#base_url} plus {#full_path}.
+    #
+    # @return [String]
+    #
+    # @example
+    #   'http://www.example.org:8000/users?id=1'
+    def url
+      request.url
+    end
+
+    # *Params* in rack env's 'router.params' key.
+    #
+    # Routers used to map routes to applications build with
+    # {WebPipe} have the option to introduce extra params through
+    # setting env's 'router.params' key. These parameters will be
+    # merged with GET and POST ones when calling {#params}.
+    #
+    # This kind of functionality is usually implemented from the
+    # router side allowing the addition of variables in the route
+    # definition, e.g.:
+    #
+    # @example
+    #   /user/:id/update
+    #
+    # @return [Hash]
+    def router_params
+      env.fetch(ROUTER_PARAMS_KEY, Types::EMPTY_HASH)
+    end
+
+    # GET, POST and {#router_params} merged in a hash.
+    #
+    # @return [Params]
+    #
+    # @example
+    #   { 'id' => '1', 'name' => 'Joe' }
+    #
+    # @return Hash
+    def params
+      request.params.merge(router_params)
+    end
+  end
+
+  Conn.include(Url)
+end

data/lib/web_pipe/version.rb

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

data/lib/web_pipe.rb

@@ -16,6 +16,10 @@ module WebPipe
     DSL::Builder.new(*args)
   end
 
+  register_extension :cookies do
+    require 'web_pipe/extensions/cookies/cookies'
+  end
+
   register_extension :dry_schema do
     require 'web_pipe/extensions/dry_schema/dry_schema'
     require 'web_pipe/extensions/dry_schema/plugs/sanitize_params'
@@ -35,4 +39,16 @@ module WebPipe
   register_extension :flash do
     require 'web_pipe/extensions/flash/flash'
   end
+
+  register_extension :redirect do
+    require 'web_pipe/extensions/redirect/redirect'
+  end
+
+  register_extension :session do
+    require 'web_pipe/extensions/session/session'
+  end
+
+  register_extension :url do
+    require 'web_pipe/extensions/url/url'
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: web_pipe
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Marc Busqué
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-07-26 00:00:00.000000000 Z
+date: 2019-08-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack
@@ -244,12 +244,16 @@ files:
 - lib/web_pipe/dsl/instance_methods.rb
 - lib/web_pipe/extensions/container/container.rb
 - lib/web_pipe/extensions/container/plugs/container.rb
+- lib/web_pipe/extensions/cookies/cookies.rb
 - lib/web_pipe/extensions/dry_schema/dry_schema.rb
 - lib/web_pipe/extensions/dry_schema/plugs/param_sanitization_handler.rb
 - lib/web_pipe/extensions/dry_schema/plugs/sanitize_params.rb
 - lib/web_pipe/extensions/dry_view/dry_view.rb
 - lib/web_pipe/extensions/dry_view/plugs/view_context.rb
 - lib/web_pipe/extensions/flash/flash.rb
+- lib/web_pipe/extensions/redirect/redirect.rb
+- lib/web_pipe/extensions/session/session.rb
+- lib/web_pipe/extensions/url/url.rb
 - lib/web_pipe/plug.rb
 - lib/web_pipe/plugs.rb
 - lib/web_pipe/plugs/content_type.rb