ruter 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c3af735d50b376a560325bd054bf4c6102db10476e7ad775e42f064b17473c4f
+  data.tar.gz: 5ef9e856f019be81b88356fb633bd6796dd2338af22f80717b10a12f4d9039b0
+SHA512:
+  metadata.gz: ca30469bc6740c48d41c4b4b865ed4521c85129262ab5460b1b8097f53a65c27bec99aebb78331d4caf7479a7a2cfc122ece02d1583151266d169748174c29d1
+  data.tar.gz: 37926e251e5a8bf557c4c9a4e734c0216b7663b1770a47e322b76ab82ae31d7eb07c983f4e3dbd4db016921cbceef95ab1b923e56a6132ff7bfc61801dcc7c02

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2021 Francesco Rodríguez and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,36 @@
+Ruter [![Build Status](https://app.travis-ci.com/frodsan/ruter.svg?branch=main)](https://app.travis-ci.com/frodsan/ruter)
+====
+
+"You must buy a ticket before entering the bus" - The Inspector 🕵🏻‍♂️
+
+Description
+-----------
+
+Ruter is yet another [Rack][rack] based framework, made for fun and ~~profit~~, and built on top of [Syro][syro].
+
+Usage
+-----
+
+Here's a minimal application:
+
+```ruby
+# config.ru
+require "ruter"
+
+Ruter.define do
+  get do
+    res.write("Hello World!")
+  end
+end
+
+run(Ruter) # run!
+```
+
+License
+-------
+
+Ruter is released under the [MIT License][mit].
+
+[mit]: http://www.opensource.org/licenses/MIT
+[rack]: https://github.com/rack/rack
+[syro]: http://soveran.github.io/syro/

data/lib/ruter/core/request.rb

@@ -0,0 +1,57 @@
+require "rack/request"
+
+class Ruter
+  module Core
+    # Public: It provides convenience methods for pulling out information
+    # from a request.
+    #
+    # Examples
+    #
+    #   env = {
+    #     "REQUEST_METHOD" => "GET"
+    #     "QUERY_STRING"   => "email=me@ruter.xyz"
+    #   }
+    #
+    #   req = Ruter::Core::Request.new(env)
+    #
+    #   req.get?  # => true
+    #   req.post? # => false
+    #
+    #   req.params  # => { "email" => "me@ruter.xyz" }
+    #   req[:email] # => "me@ruter.xyz"
+    #
+    class Request < Rack::Request
+      # Public: Returns the value of the +key+ param.
+      #
+      # key - Any object that responds to +to_s+.
+      #
+      # Examples
+      #
+      #   req.params
+      #   # => { "username" => "bob" }
+      #
+      #   req[:username]  # => "bob"
+      #   req["username"] # => "bob"
+      #
+      # Signature
+      #
+      #   [](key)
+      #
+      # Inherited by Rack::Request.
+
+      # Public: Returns a Hash of parameters. Includes data from the query
+      # string and the response body.
+      #
+      # Examples
+      #
+      #   req.params
+      #   # => { "user" => { "username" => "bob" } }
+      #
+      # Signature
+      #
+      #   params()
+      #
+      # Inherited by Rack::Request.
+    end
+  end
+end

data/lib/ruter/core/response.rb

@@ -0,0 +1,199 @@
+class Ruter
+  module Core
+    # Public: It provides convenience methods to construct a Rack response.
+    #
+    # Examples
+    #
+    #   res = Ruter::Core::Response.new
+    #
+    #   res.status = 200
+    #   res["Content-Type"] = "text/html"
+    #   res.write("foo")
+    #
+    #   res.finish
+    #   # => [200, { "Content-Type" => "text/html", "Content-Length" => 3 }, ["foo"]]
+    #
+    class Response < Syro::Response
+      # Public: Initializes a new response object.
+      #
+      # headers - A Hash of initial headers. Defaults to <tt>{}</tt>.
+      #
+      # Examples
+      #
+      #   Ruter::Core::Response.new.headers
+      #   # => {}
+      #
+      #   Ruter::Core::Response.new("Content-Type" => "text/plain").headers
+      #   # => { "Content-Type" => "text/plain" }
+      #
+      # Signature
+      #
+      #   new(headers = {})
+      #
+      # Inherited by Syro::Response.
+
+      # Public: Returns the response header corresponding to +key+.
+      #
+      # key - A String HTTP header field name.
+      #
+      # Examples
+      #
+      #     res["Content-Type"]   # => "text/html"
+      #     res["Content-Length"] # => "42"
+      #
+      # Signature
+      #
+      #   [](key)
+      #
+      # Inherited by Syro::Response.
+
+      # Public: Sets the given +value+ with the header corresponding to +key+.
+      #
+      # key   - A String HTTP header field name.
+      # value - A String HTTP header field value.
+      #
+      # Examples
+      #
+      #     res["Content-Type"] = "application/json"
+      #     res["Content-Type"] # => "application/json"
+      #
+      # Signature
+      #
+      #   []=(key, value)
+      #
+      # Inherited by Syro::Response.
+
+      # Public: Returns the body of the response.
+      #
+      # Examples
+      #
+      #   res.body
+      #   # => []
+      #
+      #   res.write("there is")
+      #   res.write("no try")
+      #
+      #   res.body
+      #   # => ["there is", "no try"]
+      #
+      # Signature
+      #
+      #   body()
+      #
+      # Inherited by Syro::Response.
+
+      # Public: Returns an Array with three elements: the status, headers
+      # and body. If the status is not set, the status is set to +404+ if
+      # empty body, otherwise the status is set to +200+ and updates the
+      # +Content-Type+ header to +text/html+.
+      #
+      # Examples
+      #
+      #   res.status = 200
+      #   res.finish
+      #   # => [200, {}, []]
+      #
+      #   res.status = nil
+      #   res.finish
+      #   # => [404, {}, []]
+      #
+      #   res.status = nil
+      #   res.write("yo")
+      #   res.finish
+      #   # => [200, { "Content-Type" => "text/html", "Content-Length" => 2 }, ["yo"]]
+      #
+      # Signature
+      #
+      #   finish()
+      #
+      # Inherited by Syro::Response.
+
+      # Public: Returns a Hash with the response headers.
+      #
+      # Examples
+      #
+      #   res.headers
+      #   # => { "Content-Type" => "text/html", "Content-Length" => "42" }
+      #
+      # Signature
+      #
+      #   headers()
+      #
+      # Inherited by Syro::Response.
+
+      # Public: Sets the +Location+ header to +url+ and updates the status
+      # to +status+.
+      #
+      # url    - A String URL (relative or absolute) to redirect to.
+      # status - An Integer status code. Defaults to +302+.
+      #
+      # Examples
+      #
+      #   res.redirect("/path")
+      #
+      #   res["Location"] # => "/path"
+      #   res.status      # => 302
+      #
+      #   res.redirect("http://ruter.xyz", 303)
+      #
+      #   res["Location"] # => "http://ruter.xyz"
+      #   res.status      # => 303
+      #
+      # Signature
+      #
+      #   redirect(url, status = 302)
+      #
+      # Inherited by Syro::Response.
+
+      # Public: Returns the status of the response.
+      #
+      # Examples
+      #
+      #     res.status # => 200
+      #
+      # Signature
+      #
+      #   status()
+      #
+      # Inherited by Syro::Response.
+
+      # Public: Sets the status of the response.
+      #
+      # status - An Integer HTTP status code.
+      #
+      # Examples
+      #
+      #   res.status = 200
+      #
+      # Signature
+      #
+      #   status=(status)
+      #
+      # Inherited by Syro::Response.
+
+      # Public: Appends +str+ to the response body and updates the
+      # +Content-Length+ header.
+      #
+      # str - Any object that responds to +to_s+.
+      #
+      # Examples
+      #
+      #   res.body # => []
+      #
+      #   res.write("foo")
+      #   res.write("bar")
+      #
+      #   res.body
+      #   # => ["foo", "bar"]
+      #
+      #   res["Content-Length"]
+      #   # => 6
+      #
+      # Signature
+      #
+      #   write(str)
+      #
+      # Inherited by Syro::Response.
+    end
+  end
+end

data/lib/ruter/core.rb

@@ -0,0 +1,75 @@
+require "rack"
+require "syro"
+require_relative "core/request"
+require_relative "core/response"
+
+class Ruter
+  # Include Syro's API directly instead of using the plugin
+  # system to be able to override any of its methods.
+  include Syro::Deck::API
+
+  # Internal: Handles Syro integration.
+  module Core
+    module ClassMethods
+      # Public: Sets the application handler.
+      #
+      # Examples
+      #
+      #   class Users < Ruter
+      #   end
+      #
+      #   Users.define do
+      #     on("/users") do
+      #       get do
+      #         res.write("GET /users")
+      #       end
+      #
+      #       post do
+      #         res.write("POST /users")
+      #       end
+      #     end
+      #   end
+      #
+      def define(&block)
+        build_app(Syro.new(self, &block))
+      end
+
+      private def build_app(syro)
+        @_app = syro
+      end
+
+      # Internal: Required by the Syro API.
+      def implement(&code) # :nodoc:
+        Class.new(self) do
+          define_method(:dispatch!, code)
+
+          private :dispatch!
+
+          define_method(:inspect) do
+            self.class.superclass.inspect
+          end
+        end
+      end
+
+      # Internal: Required by the Rack API.
+      def call(env) # :nodoc:
+        @_app.call(env)
+      end
+
+      # Internal: Used for internal testing.
+      def reset! # :nodoc:
+        @_app = nil
+      end
+    end
+
+    module InstanceMethods
+      def request_class # :nodoc:
+        Ruter::Core::Request
+      end
+
+      def response_class # :nodoc:
+        Ruter::Core::Response
+      end
+    end
+  end
+end

data/lib/ruter/middleware.rb

@@ -0,0 +1,40 @@
+class Ruter
+  # Public: Ruter's middleware system.
+  module Middleware
+    module ClassMethods
+      # Public: Adds given Rack +middleware+ to the stack.
+      #
+      # Examples
+      #
+      #   require "rack/common_logger"
+      #   require "rack/show_exceptions"
+      #
+      #   Ruter.use(Rack::CommonLogger)
+      #   Ruter.use(Rack::ShowExceptions)
+      #
+      def use(middleware, *args, &block)
+        self.middleware << proc { |app| middleware.new(app, *args, &block) }
+      end
+
+      # Internal: Returns middleware stack.
+      def middleware # :nodoc:
+        @_middleware ||= []
+      end
+
+      # Internal: Used for internal testing.
+      def reset! # :nodoc:
+        super
+        @_middleware = []
+      end
+
+      # Internal: Overrides app composition from core.
+      private def build_app(syro)
+        @_app = if middleware.empty?
+          syro
+        else
+          middleware.reverse.inject(syro) { |a, m| m.call(a) }
+        end
+      end
+    end
+  end
+end

data/lib/ruter/plugin.rb

@@ -0,0 +1,67 @@
+class Ruter
+  # Public: Ruter's plugin system.
+  module Plugin
+    # Public: Loads given +plugin+ into the application.
+    #
+    # Examples
+    #
+    #   require "ruter"
+    #   require "ruter/protection"
+    #   require "ruter/session"
+    #
+    #   # Use some standard plugins
+    #
+    #   Ruter.plugin(Ruter::Protection)
+    #   Ruter.plugin(Ruter::Session, secret: "__a_random_secret_key__")
+    #
+    #   # Make your own custom plugin:
+    #
+    #   require "redcarpet"
+    #
+    #   class MarkdownPlugin
+    #     def self.setup(app, options = {})
+    #       app.settings[:markdown_options] = options
+    #     end
+    #
+    #     module ClassMethods
+    #       def markdown_renderer
+    #         @_markdown_renderer ||= Redcarpet::Markdown.new(Redcarpet::Render::HTML, markdown_options)
+    #       end
+    #
+    #       def markdown_options
+    #         settings[:markdown_options]
+    #       end
+    #     end
+    #
+    #     module InstanceMethods
+    #       def markdown(text)
+    #         res.write(markdown_renderer.render(text))
+    #       end
+    #     end
+    #   end
+    #
+    #   Ruter.plugin(MarkdownPlugin, fenced_code_blocks: true)
+    #
+    #   Ruter.define do
+    #     root do
+    #       get do
+    #         markdown("This is *bongos*, indeed.")
+    #       end
+    #     end
+    #   end
+    #
+    def plugin(plugin, *args, &block)
+      if defined?(plugin::InstanceMethods)
+        include(plugin::InstanceMethods)
+      end
+
+      if defined?(plugin::ClassMethods)
+        extend(plugin::ClassMethods)
+      end
+
+      if plugin.respond_to?(:setup)
+        plugin.setup(self, *args, &block)
+      end
+    end
+  end
+end

data/lib/ruter/settings.rb

@@ -0,0 +1,90 @@
+class Ruter
+  # Public: It provides a settings API for Ruter applications.
+  #
+  # Examples
+  #
+  #   require "ruter"
+  #
+  #   module AppName
+  #     def self.setup(app, app_name)
+  #       app.settings[:app_name] = app_name
+  #     end
+  #
+  #     module ClassMethods
+  #       def app_name
+  #         return settings[:app_name]
+  #       end
+  #     end
+  #   end
+  #
+  #   Ruter.plugin(AppName, "MyApp")
+  #
+  #   Ruter.app_name
+  #   # => "MyApp"
+  #
+  module Settings
+    # Internal: Returns a deep copy of a Hash.
+    def self.deepclone(hash) # :nodoc:
+      default_proc, hash.default_proc = hash.default_proc, nil
+
+      Marshal.load(Marshal.dump(hash))
+    ensure
+      hash.default_proc = default_proc
+    end
+
+    module ClassMethods
+      # Internal: Copies settings into the subclass.
+      # If a setting is not found, checks parent's settings.
+      def inherited(subclass)
+        subclass.settings.replace(Ruter::Settings.deepclone(settings))
+        subclass.settings.default_proc = proc { |h, k| h[k] = settings[k] }
+      end
+
+      # Public: Sets an +option+ to the given +value+.
+      #
+      # Examples
+      #
+      #   Ruter.set(:environment, :staging)
+      #
+      #   Ruter.environment
+      #   # => :staging
+      #
+      def set(option, value)
+        settings[option] = value
+      end
+
+      # Returns a Hash with the application settings.
+      #
+      # Examples
+      #
+      #   Ruter.set(:environment, :development)
+      #
+      #   Ruter.settings
+      #   # => { :environment => :development }
+      #
+      def settings
+        @settings ||= {}
+      end
+    end
+
+    module InstanceMethods
+      # Returns a Hash with the application settings.
+      #
+      # Examples
+      #
+      #   Ruter.set(:environment, :development)
+      #
+      #   Ruter.define do
+      #     get do
+      #       res.write(settings[:environment])
+      #     end
+      #   end
+      #
+      #   GET / # => 200 "development"
+      #
+      def settings
+        self.class.settings
+      end
+    end
+  end
+end

data/lib/ruter/test.rb

@@ -0,0 +1,199 @@
+class Ruter
+  # Public: A simple helper class to simulate requests to your application.
+  #
+  # Examples
+  #
+  #   require "ruter"
+  #   require "ruter/test"
+  #
+  #   Ruter.define do
+  #     root do
+  #       res.write("hei")
+  #     end
+  #   end
+  #
+  #   app = Ruter::Test.new
+  #   app.get("/")
+  #
+  #   app.res.status # => 200
+  #   app.res.body   # => "hei"
+  #
+  class Test
+    # Public: Initializes a new Ruter::Test object.
+    #
+    # app - The application class to test (default: Ruter).
+    #
+    # Examples
+    #
+    #   class API < Ruter
+    #   end
+    #
+    #   app = Ruter::Test.new(API)
+    #   app.get("/json")
+    #
+    def initialize(app = Ruter)
+      @app = app
+    end
+
+    # Internal: Returns the application class that handles the
+    # mock requests. Required by Ruter::Test::InstanceMethods.
+    attr_reader :app
+
+    # Internal: This module provides the Ruter::Test API methods.
+    # If you don't like the stand-alone version, you can integrate
+    # this module to your preferred testing environment.
+    #
+    # The following example uses Minitest:
+    #
+    #   class HomeTest < Minitest::Test
+    #     include Ruter::Test::InstanceMethods
+    #
+    #     def app
+    #       return Ruter
+    #     end
+    #
+    #     def test_home
+    #       get("/")
+    #
+    #       assert_equal 200, res.status
+    #     end
+    #   end
+    #
+    module InstanceMethods
+      # Public: Returns the current request object or +nil+ if no requests
+      # have been issued yet.
+      #
+      # Examples
+      #
+      #   app = Ruter::Test.new
+      #   app.get("/", {}, { "HTTP_USER_AGENT" => "Ruter::Test" })
+      #
+      #   app.req.get?
+      #   # => true
+      #
+      #   app.req.env["HTTP_USER_AGENT"]
+      #   # => "Ruter::Test"
+      #
+      # The returned object is an instance of
+      # {Rack::Request}[http://www.rubydoc.info/gems/rack/Rack/Request].
+      #
+      def req
+        @__req
+      end
+
+      # Public: Returns the current response object or +nil+ if no requests
+      # have been issued yet.
+      #
+      # Examples
+      #
+      #   app = Ruter::Test.new
+      #   app.get("/", name: "alice")
+      #
+      #   app.res.status
+      #   # => 200
+      #
+      #   app.res.body
+      #   # => "Hello alice!"
+      #
+      # The returned object is an instance of
+      # {Rack::MockResponse}[http://www.rubydoc.info/gems/rack/Rack/MockResponse]
+      #
+      def res
+        @__res
+      end
+
+      # Public: Issues a GET request for the given +path+ with the given
+      # +params+ and Rack environment.
+      #
+      # Examples
+      #
+      #   app = Ruter::Test.new
+      #   app.get("/search", name: "alice")
+      #
+      def get(path, params = {}, env = {})
+        request(path, env.merge(method: Rack::GET, params: params))
+      end
+
+      # Public: Issues a POST request for the given +path+ with the given
+      # +params+ and Rack environment.
+      #
+      # Examples
+      #
+      #   app = Ruter::Test.new
+      #   app.post("/signup", username: "alice", password: "secret")
+      #
+      def post(path, params = {}, env = {})
+        request(path, env.merge(method: "POST".freeze, params: params))
+      end
+
+      # Public: Issues a PUT request for the given +path+ with the given
+      # +params+ and Rack environment.
+      #
+      # Examples
+      #
+      #   app = Ruter::Test.new
+      #   app.put("/users/1", username: "bob", name: "Bob")
+      #
+      def put(path, params = {}, env = {})
+        request(path, env.merge(method: "PUT".freeze, params: params))
+      end
+
+      # Public: Issues a PATCH request for the given +path+ with the given
+      # +params+ and Rack environment.
+      #
+      # Examples
+      #
+      #   app = Ruter::Test.new
+      #   app.patch("/users/1", username: "alice")
+      #
+      def patch(path, params = {}, env = {})
+        request(path, env.merge(method: "PATCH".freeze, params: params))
+      end
+
+      # Public: Issues a DELETE request for the given +path+ with the given
+      # +params+ and Rack environment.
+      #
+      # Examples
+      #
+      #   app = Ruter::Test.new
+      #   app.delete("/users/1")
+      #
+      def delete(path, params = {}, env = {})
+        request(path, env.merge(method: "DELETE".freeze, params: params))
+      end
+
+      # Public: Issues a HEAD request for the given +path+ with the given
+      # +params+ and Rack environment.
+      #
+      # Examples
+      #
+      #   app = Ruter::Test.new
+      #   app.head("/users/1")
+      #
+      def head(path, params = {}, env = {})
+        request(path, env.merge(method: Rack::HEAD, params: params))
+      end
+
+      # Public: Issues a OPTIONS request for the given +path+ with the given
+      # +params+ and Rack environment.
+      #
+      # Examples
+      #
+      #   app = Ruter::Test.new
+      #   app.options("/users")
+      #
+      def options(path, params = {}, env = {})
+        request(path, env.merge(method: "OPTIONS".freeze, params: params))
+      end
+
+      private
+
+      def request(path, opts = {})
+        @__req = Rack::Request.new(Rack::MockRequest.env_for(path, opts))
+        @__res = Rack::MockResponse.new(*app.call(@__req.env))
+      end
+    end
+
+    include InstanceMethods
+  end
+end

data/lib/ruter/version.rb

@@ -0,0 +1,8 @@
+class Ruter # :nodoc: all
+  VERSION = [
+    MAJOR_VERSION = 1,
+    MINOR_VERSION = 0,
+    PATCH_VERSION = 0,
+    PRE_VERSION = nil
+  ].compact.join(".")
+end

data/lib/ruter.rb

@@ -0,0 +1,14 @@
+require_relative "ruter/version"
+require_relative "ruter/plugin"
+require_relative "ruter/core"
+require_relative "ruter/middleware"
+require_relative "ruter/settings"
+
+class Ruter
+  extend Ruter::Plugin
+
+  # Internal: Core plugins.
+  plugin(Ruter::Core)
+  plugin(Ruter::Middleware)
+  plugin(Ruter::Settings)
+end

data/test/ruter/core_test.rb

@@ -0,0 +1,90 @@
+require_relative "../test_helper"
+
+class CoreTest < Minitest::Test
+  setup do
+    Ruter.reset!
+  end
+
+  test "hello" do
+    Ruter.define do
+      get do
+        res.write("hello")
+      end
+    end
+
+    app = Ruter::Test.new
+    app.get("/")
+
+    assert_equal 200, app.res.status
+    assert_equal "hello", app.res.body
+  end
+
+  test "methods" do
+    [:get, :post, :put, :patch, :delete].each do |method|
+      Ruter.define do
+        send(method) { res.write "" }
+      end
+
+      app = Ruter::Test.new
+      app.send(method, "/")
+
+      assert_equal 200, app.res.status
+    end
+  end
+
+  test "captures" do
+    Ruter.define do
+      on :foo do
+        on :bar do
+          get do
+            res.write(sprintf("%s:%s", inbox[:foo], inbox[:bar]))
+          end
+        end
+      end
+    end
+
+    app = Ruter::Test.new
+    app.get("/foo/bar")
+
+    assert_equal 200, app.res.status
+    assert_equal "foo:bar", app.res.body
+  end
+
+  test "composition" do
+    nested = Class.new(Ruter)
+
+    nested.define do
+      get do
+        res.write(inbox[:foo])
+      end
+    end
+
+    Ruter.define do
+      on "foo" do
+        run(nested, foo: 42)
+      end
+    end
+
+    app = Ruter::Test.new
+    app.get("/foo")
+
+    assert_equal 200, app.res.status
+    assert_equal "42", app.res.body
+  end
+
+  test "use own request and response classes" do
+    Ruter.define do
+      get do
+        res.write(request_class.name)
+        res.write(response_class.name)
+      end
+    end
+
+    app = Ruter::Test.new
+    app.get("/")
+
+    assert_equal 200, app.res.status
+    assert_match Ruter::Core::Request.name, app.res.body
+    assert_match Ruter::Core::Response.name, app.res.body
+  end
+end

data/test/ruter/middleware_test.rb

@@ -0,0 +1,95 @@
+require_relative "../test_helper"
+
+class MiddlewareTest < Minitest::Test
+  class ReverseBody
+    def initialize(app)
+      @app = app
+    end
+
+    def call(env)
+      status, headers, body = @app.call(env)
+
+      [status, headers, body.reverse]
+    end
+  end
+
+  setup do
+    Ruter.reset!
+  end
+
+  test "middleware in main application" do
+    Ruter.use(ReverseBody)
+
+    Ruter.define do
+      get do
+        res.write("1")
+        res.write("2")
+      end
+    end
+
+    app = Ruter::Test.new
+    app.get("/")
+
+    assert_equal 200, app.res.status
+    assert_equal "21", app.res.body
+  end
+
+  test "middleware with composition" do
+    Ruter.use(ReverseBody)
+
+    api = Class.new(Ruter) do
+      define do
+        get do
+          res.write("1")
+          res.write("2")
+        end
+      end
+    end
+
+    Ruter.define do
+      on "api" do
+        run(api)
+      end
+    end
+
+    app = Ruter::Test.new
+    app.get("/api")
+
+    assert_equal 200, app.res.status
+    assert_equal "21", app.res.body
+  end
+
+  test "middleware only in child application" do
+    api = Class.new(Ruter) do
+      use(ReverseBody)
+
+      define do
+        get do
+          res.write("1")
+          res.write("2")
+        end
+      end
+    end
+
+    Ruter.define do
+      on "api" do
+        run(api)
+      end
+
+      get do
+        res.write("not_reversed")
+      end
+    end
+
+    app = Ruter::Test.new
+    app.get("/api")
+
+    assert_equal 200, app.res.status
+    assert_equal "21", app.res.body
+
+    app.get("/")
+
+    assert_equal 200, app.res.status
+    assert_equal "not_reversed", app.res.body
+  end
+end

data/test/ruter/plugin_test.rb

@@ -0,0 +1,54 @@
+require_relative "../test_helper"
+require "redcarpet"
+
+class MarkdownPlugin
+  def self.setup(app, options = {})
+    app.settings[:markdown_options] = options
+  end
+
+  module ClassMethods
+    def markdown_renderer
+      @_markdown_renderer ||= Redcarpet::Markdown.new(Redcarpet::Render::HTML, markdown_options)
+    end
+
+    def markdown_options
+      settings[:markdown_options]
+    end
+  end
+
+  module InstanceMethods
+    def markdown(text)
+      res.write(self.class.markdown_renderer.render(text))
+    end
+  end
+end
+
+class MarkdownApp < Ruter
+  plugin(MarkdownPlugin, no_intra_emphasis: true)
+
+  define do
+    root do
+      get do
+        markdown("This is *bongos*, indeed.")
+      end
+    end
+  end
+end
+
+class PluginTest < Minitest::Test
+  test "setup" do
+    refute_nil(MarkdownApp.settings[:markdown_options])
+  end
+
+  test "class methods" do
+    assert_instance_of(Redcarpet::Markdown, MarkdownApp.markdown_renderer)
+  end
+
+  test "instance methods" do
+    app = Ruter::Test.new(MarkdownApp)
+    app.get("/")
+
+    assert_equal 200, app.res.status
+    assert_match "<p>This is <em>bongos</em>, indeed.</p>", app.res.body
+  end
+end

data/test/ruter/settings_test.rb

@@ -0,0 +1,47 @@
+require_relative "../test_helper"
+
+class SettingsTest < MiniTest::Test
+  setup do
+    Ruter.reset!
+    Ruter.settings.clear
+  end
+
+  test "set and get setting" do
+    Ruter.set(:environment, "development")
+
+    assert_equal "development", Ruter.settings[:environment]
+  end
+
+  test "get setting inside handler" do
+    Ruter.set(:environment, "development")
+
+    Ruter.define do
+      get do
+        res.write(settings[:environment])
+      end
+    end
+
+    app = Ruter::Test.new
+    app.get("/")
+
+    assert_equal 200, app.res.status
+    assert_equal "development", app.res.body
+  end
+
+  test "inheritance" do
+    Ruter.set(:foo, "foo")
+    Ruter.set(:bar, "bar")
+
+    inherited = Class.new(Ruter)
+    inherited.set(:bar, "rab")
+    inherited.set(:baz, "baz")
+
+    assert_equal "foo", Ruter.settings[:foo]
+    assert_equal "bar", Ruter.settings[:bar]
+    assert_nil Ruter.settings[:baz]
+
+    assert_equal "foo", inherited.settings[:foo]
+    assert_equal "rab", inherited.settings[:bar]
+    assert_equal "baz", inherited.settings[:baz]
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,8 @@
+$VERBOSE = true
+
+require "bundler/setup"
+require "minitest/autorun"
+require "minitest/pride"
+require "minitest/sugar"
+require_relative "../lib/ruter"
+require_relative "../lib/ruter/test"

metadata

@@ -0,0 +1,175 @@
+--- !ruby/object:Gem::Specification
+name: ruter
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Francesco Rodriguez
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2021-08-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: syro
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: tilt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: erubi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.8'
+- !ruby/object:Gem::Dependency
+  name: minitest-sugar
+  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'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: standard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+description: "Another Rack based web framework \U0001F937\U0001F3FD‍♂️"
+email: frodsan@me.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/ruter.rb
+- lib/ruter/core.rb
+- lib/ruter/core/request.rb
+- lib/ruter/core/response.rb
+- lib/ruter/middleware.rb
+- lib/ruter/plugin.rb
+- lib/ruter/settings.rb
+- lib/ruter/test.rb
+- lib/ruter/version.rb
+- test/ruter/core_test.rb
+- test/ruter/middleware_test.rb
+- test/ruter/plugin_test.rb
+- test/ruter/settings_test.rb
+- test/test_helper.rb
+homepage: https://github.com/frodsan/ruter
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.26
+signing_key:
+specification_version: 4
+summary: "Another Rack based web framework \U0001F937\U0001F3FD‍♂️"
+test_files:
+- test/ruter/core_test.rb
+- test/ruter/middleware_test.rb
+- test/ruter/plugin_test.rb
+- test/ruter/settings_test.rb
+- test/test_helper.rb