lotus-router 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b3fcb5db6c1bdb046aeb93c5d0950301d5ed551d
-  data.tar.gz: 577b5c170f3d469369ce4c43c11782f6f9d6ea3c
+  metadata.gz: fe3bedc422dfc753499bc3b622eae9991fbb5f6d
+  data.tar.gz: 04092313d4a1f9c19f83e4f555b4da56394b33ba
 SHA512:
-  metadata.gz: 189025ab49239109b74a6f939585d2cdc56b7568a9864c0a82af39fc166a36b8f4f4ae7e5335a53b5ca3bcadd2120b75705ca6dc8d12a1b9bf05501aaa45f652
-  data.tar.gz: 339c1ac13cb39971e7594675646b2c7f2a0baafa96a5bd7b44c16be0ce291d089857abbd797ab6fa6be44fa1b7a279c1d159562acd1d46c60ba97c43779d102f
+  metadata.gz: e0481beec0347d4f748fddd153eefa13b7e6460bf9ce16901179d7930fcecd2a6f2196e954d84a37a8c7b3f9355da2eb3b3ba6ad46ca404534759ca7fbbabd81
+  data.tar.gz: cf5c52860e529475867d0f4df858df214acd206054912fa82849b2d973ecf5a46d84292609599d0496fb04270f11f0b01bfb5784fabd0d625ef7348dee0ea69d

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 # Lotus::Router
 Rack compatible HTTP router for Ruby
 
+## v0.4.1 - 2015-06-23
+### Added
+- [Alfonso Uceda Pompa] Force SSL (eg `Lotus::Router.new(force_ssl: true`).
+- [Alfonso Uceda Pompa] Allow router to accept a `:prefix` option, in order to generate prefixed routes.
+
 ## v0.4.0 - 2015-05-15
 ### Added
 - [Alfonso Uceda Pompa] Nested RESTful resource(s)

data/lib/lotus/router.rb

@@ -13,12 +13,11 @@ module Lotus
   #
   #   endpoint = ->(env) { [200, {}, ['Welcome to Lotus::Router!']] }
   #   router = Lotus::Router.new do
-  #     get     '/', to: endpoint
+  #     get     '/', to: endpoint # => get and head requests
   #     post    '/', to: endpoint
   #     put     '/', to: endpoint
   #     patch   '/', to: endpoint
   #     delete  '/', to: endpoint
-  #     head    '/', to: endpoint
   #     options '/', to: endpoint
   #     trace   '/', to: endpoint
   #   end

data/lib/lotus/router/version.rb

@@ -1,6 +1,6 @@
 module Lotus
   class Router
     # @since 0.1.0
-    VERSION = '0.4.0'.freeze
+    VERSION = '0.4.1'.freeze
   end
 end

data/lib/lotus/routing/force_ssl.rb

@@ -0,0 +1,209 @@
+require 'rack/request'
+
+module Lotus
+  module Routing
+    # Force ssl
+    #
+    # Redirect response to the secure equivalent resource (https)
+    #
+    # @since 0.4.1
+    # @api private
+    class ForceSsl
+      # Https scheme
+      #
+      # @since 0.4.1
+      # @api private
+      SSL_SCHEME = 'https'.freeze
+
+      # @since 0.4.1
+      # @api private
+      HTTPS = 'HTTPS'.freeze
+
+      # @since 0.4.1
+      # @api private
+      ON    = 'on'.freeze
+
+      # Location header
+      #
+      # @since 0.4.1
+      # @api private
+      LOCATION_HEADER = 'Location'.freeze
+
+      # Default http port
+      #
+      # @since 0.4.1
+      # @api private
+      DEFAULT_HTTP_PORT = 80
+
+      # Default ssl port
+      #
+      # @since 0.4.1
+      # @api private
+      DEFAULT_SSL_PORT = 443
+
+      # Moved Permanently http code
+      #
+      # @since 0.4.1
+      # @api private
+      MOVED_PERMANENTLY_HTTP_CODE = 301
+
+      # Temporary Redirect http code
+      #
+      # @since 0.4.1
+      # @api private
+      TEMPORARY_REDIRECT_HTTP_CODE = 307
+
+      # @since 0.4.1
+      # @api private
+      HTTP_X_FORWARDED_SSL = 'HTTP_X_FORWARDED_SSL'.freeze
+
+      # @since 0.4.1
+      # @api private
+      HTTP_X_FORWARDED_SCHEME = 'HTTP_X_FORWARDED_SCHEME'.freeze
+
+      # @since 0.4.1
+      # @api private
+      HTTP_X_FORWARDED_PROTO = 'HTTP_X_FORWARDED_PROTO'.freeze
+
+      # @since 0.4.1
+      # @api private
+      HTTP_X_FORWARDED_PROTO_SEPARATOR = ','.freeze
+
+      # @since 0.4.1
+      # @api private
+      RACK_URL_SCHEME = 'rack.url_scheme'.freeze
+
+      # @since 0.4.1
+      # @api private
+      REQUEST_METHOD = 'REQUEST_METHOD'.freeze
+
+      # @since 0.4.1
+      # @api private
+      IDEMPOTENT_METHODS = ['GET', 'HEAD'].freeze
+
+      EMPTY_BODY = ''.freeze
+
+      # Initialize ForceSsl.
+      #
+      # @param active [Boolean] activate redirection to SSL
+      # @param options [Hash] set of options
+      # @option options [String] :host
+      # @option options [Integer] :port
+      #
+      # @since 0.4.1
+      # @api private
+      def initialize(active, options = {})
+        @active = active
+        @host   = options[:host]
+        @port   = options[:port]
+
+        _redefine_call
+      end
+
+      # Set 301 status and Location header if this feature is activated.
+      #
+      # @param env [Hash] a Rack env instance
+      #
+      # @return [Array]
+      #
+      # @see Lotus::Routing::HttpRouter#call
+      #
+      # @since 0.4.1
+      # @api private
+      def call(env)
+      end
+
+      # Check if router has to force the response with ssl
+      #
+      # @return [Boolean]
+      #
+      # @since 0.4.1
+      # @api private
+      def force?(env)
+        !ssl?(env)
+      end
+
+      private
+
+      # @since 0.4.1
+      # @api private
+      attr_reader :host
+
+      # Return full url to redirect
+      #
+      # @param env [Hash] Rack env
+      #
+      # @return [String]
+      #
+      # @since 0.4.1
+      # @api private
+      def full_url(env)
+        "#{ SSL_SCHEME }://#{ host }:#{ port }#{ ::Rack::Request.new(env).fullpath }"
+      end
+
+      # Return redirect code
+      #
+      # @param env [Hash] Rack env
+      #
+      # @return [Integer]
+      #
+      # @since 0.4.1
+      # @api private
+      def redirect_code(env)
+        if IDEMPOTENT_METHODS.include?(env[REQUEST_METHOD])
+          MOVED_PERMANENTLY_HTTP_CODE
+        else
+          TEMPORARY_REDIRECT_HTTP_CODE
+        end
+      end
+
+      # Return correct default port for full url
+      #
+      # @return [Integer]
+      #
+      # @since 0.4.1
+      # @api private
+      def port
+        if @port == DEFAULT_HTTP_PORT
+          DEFAULT_SSL_PORT
+        else
+          @port
+        end
+      end
+
+      # @since 0.4.1
+      # @api private
+      def _redefine_call
+        return unless @active
+
+        define_singleton_method :call do |env|
+          [redirect_code(env), { LOCATION_HEADER => full_url(env) }, EMPTY_BODY] if force?(env)
+        end
+      end
+
+      # Adapted from Rack::Request#scheme
+      #
+      # @since 0.4.1
+      # @api private
+      def scheme(env)
+        if env[HTTPS] == ON
+          SSL_SCHEME
+        elsif env[HTTP_X_FORWARDED_SSL] == ON
+          SSL_SCHEME
+        elsif env[HTTP_X_FORWARDED_SCHEME]
+          env[HTTP_X_FORWARDED_SCHEME]
+        elsif env[HTTP_X_FORWARDED_PROTO]
+          env[HTTP_X_FORWARDED_PROTO].split(HTTP_X_FORWARDED_PROTO_SEPARATOR)[0]
+        else
+          env[RACK_URL_SCHEME]
+        end
+      end
+
+      # @since 0.4.1
+      # @api private
+      def ssl?(env)
+        scheme(env) == SSL_SCHEME
+      end
+    end
+  end
+end

data/lib/lotus/routing/http_router.rb

@@ -3,6 +3,8 @@ require 'lotus/utils/io'
 require 'lotus/routing/endpoint_resolver'
 require 'lotus/routing/route'
 require 'lotus/routing/parsers'
+require 'lotus/routing/force_ssl'
+require 'lotus/utils/path_prefix'
 
 Lotus::Utils::IO.silence_warnings do
   HttpRouter::Route::VALID_HTTP_VERBS = %w{GET POST PUT PATCH DELETE HEAD OPTIONS TRACE}
@@ -37,12 +39,14 @@ module Lotus
       def initialize(options = {}, &blk)
         super(options, &nil)
 
-        @default_scheme = options[:scheme]   if options[:scheme]
-        @default_host   = options[:host]     if options[:host]
-        @default_port   = options[:port]     if options[:port]
-        @route_class    = options[:route]    || Routing::Route
-        @resolver       = options[:resolver] || Routing::EndpointResolver.new(options)
-        @parsers        = Routing::Parsers.new(options[:parsers])
+        @default_scheme   = options[:scheme]   if options[:scheme]
+        @default_host     = options[:host]     if options[:host]
+        @default_port     = options[:port]     if options[:port]
+        @route_class      = options[:route]    || Routing::Route
+        @resolver         = options[:resolver] || Routing::EndpointResolver.new(options)
+        @parsers          = Routing::Parsers.new(options[:parsers])
+        @prefix           = Utils::PathPrefix.new(options[:prefix] || '')
+        @force_ssl        = Lotus::Routing::ForceSsl.new(!!options[:force_ssl], host: @default_host, port: @default_port)
       end
 
       # Separator between controller and action name.
@@ -85,6 +89,66 @@ module Lotus
         _rescue_url_recognition { super }
       end
 
+      # Support for GET HTTP verb
+      #
+      # @see Lotus::Router#options
+      #
+      # @since 0.4.1
+      # @api private
+      def get(path, options = {}, &blk)
+        super(@prefix.join(path), options, &blk)
+      end
+
+      # Support for POST HTTP verb
+      #
+      # @see Lotus::Router#post
+      #
+      # @since 0.4.1
+      # @api private
+      def post(path, options = {}, &blk)
+        super(@prefix.join(path), options, &blk)
+      end
+
+      # Support for PUT HTTP verb
+      #
+      # @see Lotus::Router#put
+      #
+      # @since 0.4.1
+      # @api private
+      def put(path, options = {}, &blk)
+        super(@prefix.join(path), options, &blk)
+      end
+
+      # Support for PATCH HTTP verb
+      #
+      # @see Lotus::Router#patch
+      #
+      # @since 0.4.1
+      # @api private
+      def patch(path, options = {}, &blk)
+        super(@prefix.join(path), options, &blk)
+      end
+
+      # Support for DELETE HTTP verb
+      #
+      # @see Lotus::Router#delete
+      #
+      # @since 0.4.1
+      # @api private
+      def delete(path, options = {}, &blk)
+        super(@prefix.join(path), options, &blk)
+      end
+
+      # Support for TRACE HTTP verb
+      #
+      # @see Lotus::Router#trace
+      #
+      # @since 0.4.1
+      # @api private
+      def trace(path, options = {}, &blk)
+        super(@prefix.join(path), options, &blk)
+      end
+
       # Support for OPTIONS HTTP verb
       #
       # @see Lotus::Router#options
@@ -92,7 +156,7 @@ module Lotus
       # @since 0.1.0
       # @api private
       def options(path, options = {}, &blk)
-        add_with_request_method(path, :options, options, &blk)
+        add_with_request_method(@prefix.join(path), :options, options, &blk)
       end
 
       # Allow to mount a Rack app
@@ -109,7 +173,11 @@ module Lotus
 
       # @api private
       def raw_call(env, &blk)
-        super(@parsers.call(env))
+        if response = @force_ssl.call(env)
+          response
+        else
+          super(@parsers.call(env))
+        end
       end
 
       # @api private

data/lib/lotus/routing/namespace.rb

@@ -57,6 +57,12 @@ module Lotus
         super(@name.join(path), options, &endpoint)
       end
 
+      # @api private
+      # @since 0.1.0
+      def options(path, options = {}, &endpoint)
+        super(@name.join(path), options, &endpoint)
+      end
+
       # @api private
       # @since 0.1.0
       def resource(name, options = {})

data/lotus-router.gemspec

@@ -20,7 +20,7 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = '>= 2.0.0'
 
   spec.add_dependency 'http_router', '~> 0.11'
-  spec.add_dependency 'lotus-utils', '~> 0.4', '>= 0.4.1'
+  spec.add_dependency 'lotus-utils', '~> 0.5'
 
   spec.add_development_dependency 'bundler',  '~> 1.5'
   spec.add_development_dependency 'minitest', '~> 5'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lotus-router
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Luca Guidi
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-05-15 00:00:00.000000000 Z
+date: 2015-06-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http_router
@@ -30,20 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.4'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.4.1
+        version: '0.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.4'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.4.1
+        version: '0.5'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -101,6 +95,7 @@ files:
 - lib/lotus/router/version.rb
 - lib/lotus/routing/endpoint.rb
 - lib/lotus/routing/endpoint_resolver.rb
+- lib/lotus/routing/force_ssl.rb
 - lib/lotus/routing/http_router.rb
 - lib/lotus/routing/namespace.rb
 - lib/lotus/routing/parsers.rb
@@ -135,7 +130,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
 summary: Rack compatible HTTP router for Ruby and Lotus