lennarb 1.3.0 → 1.4.1

data/lib/lennarb.rb

@@ -1,158 +1,20 @@
-# frozen_string_literal: true
-
-# Released under the MIT License.
-# Copyright, 2023-2024, by Aristóteles Coutinho.
-
 # Core extensions
 #
-require 'pathname'
-require 'rack'
-
-require_relative 'lennarb/plugin'
-require_relative 'lennarb/request'
-require_relative 'lennarb/response'
-require_relative 'lennarb/route_node'
-require_relative 'lennarb/version'
-
-class Lennarb
-  class LennarbError < StandardError; end
-
-  attr_reader :_root, :_plugins, :_loaded_plugins, :_middlewares, :_app
-
-  def self.use(middleware, *args, &block)
-    @_middlewares ||= []
-    @_middlewares << [middleware, args, block]
-  end
-
-  def self.get(path, &block)     = add_route(path, :GET, block)
-  def self.put(path, &block)     = add_route(path, :PUT, block)
-  def self.post(path, &block)    = add_route(path, :POST, block)
-  def self.head(path, &block)    = add_route(path, :HEAD, block)
-  def self.patch(path, &block)   = add_route(path, :PATCH, block)
-  def self.delete(path, &block)  = add_route(path, :DELETE, block)
-  def self.options(path, &block) = add_route(path, :OPTIONS, block)
-
-  def self.inherited(subclass)
-    super
-    subclass.instance_variable_set(:@_root, RouteNode.new)
-    subclass.instance_variable_set(:@_plugins, [])
-    subclass.instance_variable_set(:@_middlewares, @_middlewares&.dup || [])
-
-    Plugin.load_defaults! if Plugin.load_defaults?
-  end
-
-  def self.plugin(plugin_name, *, &)
-    @_loaded_plugins ||= {}
-    @_plugins        ||= []
-
-    return if @_loaded_plugins.key?(plugin_name)
-
-    plugin_module = Plugin.load(plugin_name)
-    plugin_module.configure(self, *, &) if plugin_module.respond_to?(:configure)
-
-    @_loaded_plugins[plugin_name] = plugin_module
-    @_plugins << plugin_name
-  end
-
-  def self.freeze!
-    app = new
-    app.freeze!
-    app
-  end
-
-  def self.add_route(path, http_method, block)
-    @_root ||= RouteNode.new
-    parts = path.split('/').reject(&:empty?)
-    @_root.add_route(parts, http_method, block)
-  end
-
-  private_class_method :add_route
-
-  def initialize
-    @_mutex = Mutex.new
-    @_root             = self.class.instance_variable_get(:@_root)&.dup           || RouteNode.new
-    @_plugins          = self.class.instance_variable_get(:@_plugins)&.dup        || []
-    @_loaded_plugins   = self.class.instance_variable_get(:@_loaded_plugins)&.dup || {}
-    @_middlewares      = self.class.instance_variable_get(:@_middlewares)&.dup    || []
-
-    build_app
-
-    yield self if block_given?
-  end
-
-  def call(env) = @_mutex.synchronize { @_app.call(env) }
-
-  def freeze!
-    return self if @_mounted
-
-    @_root.freeze
-    @_plugins.freeze
-    @_loaded_plugins.freeze
-    @_middlewares.freeze
-    @_app.freeze if @_app.respond_to?(:freeze)
-    self
-  end
-
-  def get(path, &block)     = add_route(path, :GET, block)
-  def put(path, &block)     = add_route(path, :PUT, block)
-  def post(path, &block)    = add_route(path, :POST, block)
-  def head(path, &block)    = add_route(path, :HEAD, block)
-  def patch(path, &block)   = add_route(path, :PATCH, block)
-  def delete(path, &block)  = add_route(path, :DELETE, block)
-  def options(path, &block) = add_route(path, :OPTIONS, block)
-
-  def plugin(plugin_name, *, &)
-    return if @_loaded_plugins.key?(plugin_name)
-
-    plugin_module = Plugin.load(plugin_name)
-    self.class.extend plugin_module::ClassMethods     if plugin_module.const_defined?(:ClassMethods)
-    self.class.include plugin_module::InstanceMethods if plugin_module.const_defined?(:InstanceMethods)
-    plugin_module.configure(self, *, &)               if plugin_module.respond_to?(:configure)
-    @_loaded_plugins[plugin_name] = plugin_module
-    @_plugins << plugin_name
-  end
-
-  private
-
-  def build_app
-    @_app = method(:process_request)
-
-    @_middlewares.reverse_each do |middleware, args, block|
-      @_app = middleware.new(@_app, *args, &block)
-    end
-  end
-
-  def process_request(env)
-    http_method = env[Rack::REQUEST_METHOD].to_sym
-    parts       = env[Rack::PATH_INFO].split('/').reject(&:empty?)
-
-    block, params = @_root.match_route(parts, http_method)
-    return not_found unless block
-
-    res = Response.new
-    req = Request.new(env, params)
-
-    catch(:halt) do
-      instance_exec(req, res, &block)
-      res.finish
-    end
-  rescue StandardError => e
-    handle_error(e)
-  end
-
-  def handle_error(error)
-    case error
-    when ArgumentError
-      [400, { 'content-type' => 'text/plain' }, ["Bad Request: #{error.message}"]]
-    else
-      [500, { 'content-type' => 'text/plain' }, ["Internal Server Error: #{error.message}"]]
-    end
-  end
-
-  def not_found = [404, { 'content-type' => 'text/plain' }, ['Not Found']]
-
-  def add_route(path, http_method, block)
-    parts = path.split('/').reject(&:empty?)
-    @_root.add_route(parts, http_method, block)
-  end
+require "bundler"
+require "rack"
+require "json"
+require "pathname"
+require "superconfig"
+
+module Lennarb
+  require_relative "lennarb/constansts"
+  require_relative "lennarb/environment"
+  require_relative "lennarb/version"
+  require_relative "lennarb/request_handler"
+  require_relative "lennarb/request"
+  require_relative "lennarb/response"
+  require_relative "lennarb/route_node"
+  require_relative "lennarb/routes"
+  require_relative "lennarb/config"
+  require_relative "lennarb/app"
 end

data/readme.md

@@ -1,16 +1,35 @@
-# Lennarb
+<div align="center">
+  <picture>
+    <img alt="Lennarb" src="logo/lennarb.png" width="250">
+  </picture>
 
-Lennarb is a lightweight, fast, and modular web framework for Ruby based on Rack. The **Lennarb** supports Ruby (MRI) 3.0+
+---
 
-**Basic Usage**
+A lightweight, fast, and modular web framework for Ruby based on Rack. The **Lennarb** supports Ruby (MRI) 3.4+
+
+[![Test](https://github.com/aristotelesbr/lennarb/actions/workflows/test.yaml/badge.svg)](https://github.com/aristotelesbr/lennarb/actions/workflows/test.yaml)
+[![Gem](https://img.shields.io/gem/v/lennarb.svg)](https://rubygems.org/gems/lennarb)
+[![Gem](https://img.shields.io/gem/dt/lennarb.svg)](https://rubygems.org/gems/lennarb)
+[![MIT License](https://img.shields.io/:License-MIT-blue.svg)](https://tldrlegal.com/license/mit-license)
+
+</div>
+
+## Basic Usage
 
 ```ruby
 require "lennarb"
 
-Lennarb.new do |router|
-  router.get("/hello/:name") do |req, res|
-    name = req.params[:name]
-    res.html("Hello, #{name}!")
+Lennarb::App.new do
+  config do
+    optional :env, string, "prodcution"
+    optional :port, int, 9292
+  end
+
+  routes do
+    get("/hello/:name") do |req, res|
+      name = req.params[:name]
+      res.html("Hello, #{name}!")
+    end
   end
 end
 ```
@@ -32,18 +51,18 @@ See all [graphs](https://github.com/aristotelesbr/lennarb/blob/main/benchmark)
 
 This table ranks the routers by the number of requests they can process per second. Higher numbers indicate better performance.
 
-Plese see [Performance](https://aristotelesbr.github.io/lennarb/guides/performance/index.html) for more information.
+Please see [Performance](https://aristotelesbr.github.io/lennarb/guides/performance/index.html) for more information.
 
 ## Usage
 
-  - [Getting Started](https://aristotelesbr.github.io/lennarb/guides/getting-started/index) - This guide covers getting up and running with **Lennarb**.
+- [Getting Started](https://aristotelesbr.github.io/lennarb/guides/getting-started/index) - This guide covers getting up and running with **Lennarb**.
 
-  - [Performance](https://aristotelesbr.github.io/lennarb/guides/performance/index.html) - The **Lennarb** is very fast. The following benchmarks were performed on a MacBook Pro (Retina, 13-inch, Early 2013) with 2,7 GHz Intel Core i7 and 8 GB 1867 MHz DDR3. Based on [jeremyevans/r10k](https://github.com/jeremyevans/r10k) using the following [template build](static/r10k/build/lennarb.rb).
+- [Performance](https://aristotelesbr.github.io/lennarb/guides/performance/index.html) - The **Lennarb** is very fast. The following benchmarks were performed on a MacBook Pro (Retina, 13-inch, Early 2013) with 2,7 GHz Intel Core i7 and 8 GB 1867 MHz DDR3. Based on [jeremyevans/r10k](https://github.com/jeremyevans/r10k) using the following [template build](static/r10k/build/lennarb.rb).
 
-  - [Plugin](https://aristotelesbr.github.io/lennarb/guides/plugin/index.html) - You can create your plugins to extend the functionality of the framework.
+- [Request]() - TODO
 
-  - [Response](https://aristotelesbr.github.io/lennarb/guides/response/index.html) - This is the response guide.
-    The `res` object is used to send a response to the client. The Lennarb use a custom response object to send responses to the client. The `res` object is an instance of `Lennarb::Response`.
+- [Response](https://aristotelesbr.github.io/lennarb/guides/response/index.html) - This is the response guide.
+  The `res` object is used to send a response to the client. The Lennarb use a custom response object to send responses to the client. The `res` object is an instance of `Lennarb::Response`.
 
 ### Developer Certificate of Origin
 

metadata

@@ -1,15 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: lennarb
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.1
 platform: ruby
 authors:
 - Aristóteles Coutinho
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-11-21 00:00:00.000000000 Z
+date: 2025-02-26 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: bigdecimal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: colorize
   requirement: !ruby/object:Gem::Requirement
@@ -30,164 +43,240 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.0.8
+        version: '3.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: superconfig
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.8
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: bake
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.18.2
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.18.2
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: covered
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.2'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: covered
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.25.1
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.25.1
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '5.20'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '5.20'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: puma
+  name: minitest-utils
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '6.4'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '6.4'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rack-test
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '13.1'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '13.1'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: standard
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.59'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.59'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rubocop-minitest
+  name: standard-custom
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.33.0
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: standard-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: m
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.33.0
-description:
-email:
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: debug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 executables:
 - lenna
 extensions: []
 extra_rdoc_files: []
 files:
+- ".devcontainer/Dockerfile"
+- ".devcontainer/devcontainer.json"
+- ".editorconfig"
+- ".github/workflows/coverage.yaml"
+- ".github/workflows/documentation.yaml"
+- ".github/workflows/main.yaml"
+- ".github/workflows/test.yaml"
+- ".gitignore"
+- ".standard.yml"
+- ".tool-versions"
+- LICENCE
+- Rakefile
+- benchmark/memory.png
+- benchmark/rps.png
+- benchmark/runtime_with_startup.png
+- bin/console
+- bin/release
+- bin/setup
 - changelog.md
 - exe/lenna
+- gems.rb
+- guides/getting-started/readme.md
+- guides/links.yaml
+- guides/performance/readme.md
+- guides/response/readme.md
+- lennarb.gemspec
 - lib/lennarb.rb
-- lib/lennarb/plugin.rb
-- lib/lennarb/plugins/hooks.rb
-- lib/lennarb/plugins/mount.rb
+- lib/lennarb/app.rb
+- lib/lennarb/config.rb
+- lib/lennarb/constansts.rb
+- lib/lennarb/environment.rb
 - lib/lennarb/request.rb
+- lib/lennarb/request_handler.rb
 - lib/lennarb/response.rb
 - lib/lennarb/route_node.rb
+- lib/lennarb/routes.rb
 - lib/lennarb/version.rb
 - license.md
+- logo/lennarb.png
 - readme.md
 homepage: https://aristotelesbr.github.io/lennarb
 licenses:
@@ -198,7 +287,6 @@ metadata:
   homepage_uri: https://aristotelesbr.github.io/lennarb
   rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/aristotelesbr/lennarb
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -206,15 +294,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.23
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Lennarb provides a lightweight yet robust solution for web routing in Ruby,
   focusing on performance and simplicity.

data/lib/lennarb/plugin.rb

@@ -1,49 +0,0 @@
-# frozen_string_literal: true
-
-class Lennarb
-  module Plugin
-    class Error < StandardError; end
-
-    @registry         = {}
-    @defaults_loaded  = false
-
-    class << self
-      attr_reader :registry
-
-      def register(name, mod)
-        registry[name.to_sym] = mod
-      end
-
-      def load(name)
-        registry[name.to_sym] || raise(Error, "Plugin #{name} not found")
-      end
-
-      def load_defaults!
-        return if @defaults_loaded
-
-        # 1. Register default plugins
-        plugins_path = File.expand_path('plugins', __dir__)
-        load_plugins_from_directory(plugins_path)
-
-        # # 2. Register custom plugins
-        ENV.fetch('LENNARB_PLUGINS_PATH', nil)&.split(File::PATH_SEPARATOR)&.each do |path|
-          load_plugins_from_directory(path)
-        end
-
-        @defaults_loaded = true
-      end
-
-      def load_defaults?
-        ENV.fetch('LENNARB_AUTO_LOAD_DEFAULTS', 'true') == 'true'
-      end
-
-      private
-
-      def load_plugins_from_directory(path)
-        raise Error, "Plugin directory '#{path}' does not exist" unless File.directory?(path)
-
-        Dir["#{path}/**/*.rb"].each { require _1 }
-      end
-    end
-  end
-end