lennarb 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f3ac7cfbc2516f8bae7fd4e5d9fdbab7b02fc8c8545423bc434f7462e7e11b2
-  data.tar.gz: 00ada2a17115680425bc16d478f22419e769944b2919d5d2ab5ad266884aba94
+  metadata.gz: ef231d5c56c92f02c7b978419c3d51a54ec8fff36e3362a8f207ccd9c4a6d7f6
+  data.tar.gz: ab5d46ad9197d9016dae19f7c224e56f41157925e3fc6927de3aba8d0699304b
 SHA512:
-  metadata.gz: bbdef1cf8b5415106566aaa73dfe94ea99e56f5fe4bb808f57742bcf0d2e575952b1b4cb6cdbd0edcce102fbb8d6b9ec386ec7f60aa4d29e0edcce699f3950e7
-  data.tar.gz: 75f1097c8a992d9256f8faf3d5a967d9e7ab1926703e7228b87a75bc95d119ba1d52281726d8d6e8bd5e62ebf0bf693d5c9dab2de3cc4cb64f68e0a30024daa0
+  metadata.gz: d8e84bf114e914d51cdec74713def249cca76b76e839ed77d76d94a1bd40dd18bce4f13fec36d324d69cf468047044ec159d5442977b2178010414d2a8eb0510
+  data.tar.gz: acc76543c293b34bc8618894d69fff79b996bd2af6603e1c7c5c45dd4ca686d05cd60591483cdae91d2e3f5fb08de3174004a4c58f8fc73c0546c5598eaa0488

data/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.4] - 2023-25-11
+
+### Fixed
+
+- Internal docmentation methods
+- Fix `post_params` from Resquest router class
+
+### Added
+
+- Add basic documentation for usage. See [README.md](README.md) for more details.
+
+## [0.1.3] - 2023-24-11
+
 ## [0.1.2] - 2023-23-11
 
 ### Added

data/README.md

@@ -1,31 +1,229 @@
 # Lennarb
 
-TODO: Delete this and the text below, and describe your gem
+Lennarb is a experimental lightweight, fast, and modular web framework for Ruby based on Rack.
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/lennarb`. To experiment with that code, run `bin/console` for an interactive prompt.
+image
+
+## Table of Contents
+
+- [About](#about)
+- [Installation](#installation)
+- [Usage](#usage)
+    - [Routing](#routing)
+        - [Parameters](#parameters)
+        - [Namespaces](#namespaces)
+        - [Middlewares](#middlewares)
+    - [Render HTML templates](#render-html-templates)
+    - [Render JSON](#render-json)
+    - [TODO](#todo)
+- [Development](#development)
+- [Contributing](#contributing)
+
+## About
+
+Lennarb is designed to be simple and easy to use, while still providing the power and flexibility of a full-featured web framework. Also, that's how I affectionately call my wife.
 
 ## Installation
 
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_PRIOR_TO_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
+Add this line to your application's Gemfile:
 
-Install the gem and add to the application's Gemfile by executing:
+```rb
+gem 'lennarb'
+```
 
-    $ bundle add UPDATE_WITH_YOUR_GEM_NAME_PRIOR_TO_RELEASE_TO_RUBYGEMS_ORG
+And then execute:
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+```bash
+$ bundle install
+```
 
-    $ gem install UPDATE_WITH_YOUR_GEM_NAME_PRIOR_TO_RELEASE_TO_RUBYGEMS_ORG
+Or install it yourself as:
+
+```bash
+$ gem install lennarb
+```
 
 ## Usage
 
-TODO: Write usage instructions here
+After installing, you can begin using Lennarb to build your modular web applications with Ruby. Here is an example of how to get started:
+
+```rb
+app = Lenna::Base.new
+
+app.get('/hello/:name') do |req, res|
+    name = req.params[:name]
+
+    res.html("Hello #{name}!")
+end
+
+app.listen(8000)
+```
+
+This example creates a new Lennarb application, defines a route for the `/hello/:name` path, and then starts the application on port 8000. When a request is made to the `/hello/:name` path, the application will respond with `Hello <name>!`, where `<name>` is the value of the `:name` parameter in the request path.
+
+### Routing
+
+Lennarb uses a simple routing system that allows you to define routes for your application. Routes are defined using the `get`, `post`, `put`, `patch`, `delete`. These methods take three arguments: the path to match, an Array of the middlewares that can be apply on the current route and a block to execute when a request is made to the path. The block is passed two arguments: the [`request`](https://github.com/aristotelesbr/lennarb/blob/main/lib/lenna/router/request.rb) object and the [`response`](https://github.com/aristotelesbr/lennarb/blob/main/lib/lenna/router/response.rb) object. The request object contains information about the request, such as the request method, headers, and body. The response object contains methods for setting the response status code, headers, and body. Ex.
+
+```rb
+app.get('/hello') do |_req, res|
+    res.html('Hello World!')
+end
+```
+
+The example above defines a route for the `/hello` path. When a request is made to the `/hello` path, the application will respond with `Hello World!`.
+
+#### Parameters
+
+Lennarb allows you to define parameters in your routes. Parameters are defined using the `:` character, followed by the name of the parameter. Parameters are passed to the route block as a hash in the request object's `params` property.
+
+```rb
+app.get('/hello/:name') do |req, res|
+    name = req.params[:name]
+
+    res.html("Hello #{name}!")
+end
+```
+
+The example above defines a route for the `/hello/:name` path. When a request is made to the `/hello/:name` path, the application will respond with `Hello <name>!`, where `<name>` is the value of the `:name` parameter in the request path.
+
+#### namespaces
+
+Lennarb allows you to define namespaces in your routes. Namespaces are defined using the `namespace` method on the application object. Namespaces are passed to the route block as a hash in the request object's `params` property.
+
+```rb
+app.namespace('/api') do |router|
+    roter.get('/hello') do |_req, res|
+        res.html('Hello World!')
+    end
+end
+```
+
+The example above defines a namespace for the `/api` path. When a request is made to the `/api/hello` path, the application will respond with `Hello World!`.
+
+#### Middlewares
+
+The Lennarb application object has a `use` method that allows you to add middleware to your application. Middleware is defined using the `use` method on the application object. Ex.
+
+```rb
+app.get('/hello') do |_req, res|
+    res.html('Hello World!')
+end
+
+app.use(Lenna::Middleware::Logger)
+```
+
+You can also define middleware for specific route.
+
+```rb
+app.get('/hello', TimeMiddleware) do |_req, res|
+    res.html('Hello World!')
+end
+```
+
+You can create your own middleware by creating a class that implements the `call` method. This methods receive three
+
+```rb
+class TimeMiddleware
+    def call(req, res, next_middleware)
+        puts Time.now
+
+        req.headers['X-Time'] = Time.now
+
+        next_middleware.call
+    end
+end
+```
+
+Or using a lambda functions.
+
+```rb
+TimeMiddleware = ->(req, res, next_middleware) do
+    puts Time.now
+
+    req.headers['X-Time'] = Time.now
+
+    next_middleware.call
+end
+```
+
+So you can use it like this:
+
+```rb
+app.get('/hello', TimeMiddleware) do |_req, res|
+    res.html('Hello World!')
+end
+```
+
+And you can use multiple middlewares on the same route.
+
+```rb
+app.get('/hello', [TimeMiddleware, LoggerMiddleware]) do |_req, res|
+    res.html('Hello World!')
+end
+```
+
+### Render HTML templates
+
+Lennarb allows you to render HTML templates using the `render` method on the response object. The `render` method takes two arguments: the name of the template file, and a hash of variables to pass to the template.
+
+```rb
+app.get('/hello') do |_req, res|
+    res.render('hello', locals: { name: 'World' })
+end
+```
+
+The example above renders the `hello.html.erb` template, passing the `name` variable to the template.
+By default, Lennarb looks for templates in the `views` directory in root path. You can change this specifying the path for `views` in render method. Ex.
+
+```rb
+app.get('/hello') do |_req, res|
+    res.render('hello', path: 'app/web/templates', locals: { name: 'World' })
+end
+```
+
+### Render JSON
+
+Lennarb allows you to render JSON using the `json` method on the response object. The `json` method takes one argument: the object to render as JSON.
+
+```rb
+app.get('/hello') do |_req, res|
+    res.json(data: { message: 'Hello World!' })
+end
+```
+
+The example above renders the `{ message: 'Hello World!' }` object as JSON.
+
+
+
+### TODO
+
+- [ ] Add support for mime types
+- [ ] Add support for sessions
+- [ ] Add support for websockets
+- [ ] Add support for streaming
+- [ ] Add support for CORS
+- [ ] Add support for CSRF
+- [ ] Add support for caching
+- [ ] Add support for gzip compression
+- [ ] Add support for SSL
+- [ ] Add support for HTTP/2
+- [ ] Add support for HTTP/3
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+To set up the development environment after cloning the repo, run:
+    
+```bash
+$ bin/setup
+```
+
+To run the tests, run:
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+```bash
+$ rake test
+```
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/lennarb.
+Bug reports and pull requests are welcome on GitHub at https://github.com/aristotelesbr/lennarb.

data/lib/lenna/base.rb

@@ -39,7 +39,7 @@ module Lenna
     #
     # @since 0.1.0
     def listen(port = DEFAULT_PORT, host: DEFAULT_HOST, **)
-      puts "⚡ Listening on #{host}:#{port}"
+      puts "⚡ Listening on #{host}:#{port}. \n Use Ctrl-C to stop the server."
 
       # Add the logging middleware to the stack
       use(Middleware::Default::Logging, Middleware::Default::ErrorHandler)

data/lib/lenna/router/request.rb

@@ -40,7 +40,7 @@ module Lenna
         content_type = env['CONTENT_TYPE']
         @headers ||= env.select { |k, _| k.start_with?('HTTP_') }
                         .transform_keys { |k| format_header_name(k) }
-      
+
         @headers['Content-Type'] = content_type if content_type
         @headers
       end
@@ -62,6 +62,11 @@ module Lenna
         {}
       end
 
+      # This method parses the body params.
+      #
+      # @return [Hash] the request body params
+      #
+      # @api private
       def parse_body_params
         case media_type
         when 'application/json'
@@ -73,6 +78,27 @@ module Lenna
         end
       end
 
+      # This method parses the post params.
+      #
+      # @return [Hash] the request post params
+      #
+      # @api private
+      def post_params
+        @post_params ||=
+          if body_content.empty?
+            {}
+          else
+            ::Rack::Utils.parse_nested_query(body_content)
+          end
+      end
+
+      # This method formats the header name.
+      #
+      # @param name [String] the header name
+      #
+      # @return [String] the formatted header name
+      #
+      # @api private
       def format_header_name(name)
         name.sub(/^HTTP_/, '').split('_').map(&:capitalize).join('-')
       end

data/lib/lennarb/version.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Lennarb
-  VERSION = '0.1.3'
+  VERSION = '0.1.4'
 
   public_constant :VERSION
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lennarb
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Aristóteles Coutinho
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-11-24 00:00:00.000000000 Z
+date: 2023-11-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: colorize