leanweb 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: da54199f1863128e9bb23baf728dff6be60123b9cf44947370293222816da122
-  data.tar.gz: 60e11d76704347858cdffbde24d17b5d0edf1061ea91ef158dd5a6928e48bc4c
+  metadata.gz: 9c2c8b263119a2bfb7a4a812f4ffeb66bc9444bfc65a5ea0ab99d627d227e307
+  data.tar.gz: bbb016308a12268ee78694e378e931c016475ca8cf9ff4264d017f79664911f3
 SHA512:
-  metadata.gz: a3b3abccd00de5d76a06513c021b409d19073c911f3d236b7c7412c42e723bad9e616514a02e278e55271d5faf5709f94fb283af6fa93aa873e2144ff0d3211b
-  data.tar.gz: a366dce05e7a8108e7b3ca4096112a3567e8082a0934e64d323401a938dceb24bfdc6c03dd53193827800b04a05c1c4c9ab53189cc45453e7925422dfb58535b
+  metadata.gz: 52c6e7bdd02a5c2797d20cd6979574cec8a4d8333ab659f3332fa6b4e3bce906a69f950124453621e12dee38c0c585ac3abace0a8041c54d444524c0a21bbba3
+  data.tar.gz: 64ec617d144264edce4922fa2258173f6cc139a20102a9ba4c4290adb6ec06d13be4b5f265af715fdcd82005ae03c66ac447c7dd79bc30dce0c3235d4a4f8e22

data/bin/leanweb

@@ -3,10 +3,10 @@
 
 # Copyright 2022 Felix Freeman <libsys@hacktivista.org>
 #
-# This file is part of "LeanWeb" and licensed under the terms of the Hacktivista
-# General Public License version 0.1 or (at your option) any later version. You
-# should have received a copy of this license along with the software. If not,
-# see <https://hacktivista.org/licenses/>.
+# This file is part of "LeanWeb" and licensed under the terms of the GNU Affero
+# General Public License version 3 with permissions for compatibility with the
+# Hacktivista General Public License. You should have received a copy of this
+# license along with the software. If not, see <https://gnu.org/licenses/>.
 
 require 'fileutils'
 require 'leanweb'
@@ -16,15 +16,15 @@ require 'leanweb'
 files = [
   {
     filename: 'Gemfile',
-    # TODO: Use {LeanWeb::VERSION} when v1 is reached.
     content: <<~RUBY
       # frozen_string_literal: true
 
       source 'https://rubygems.org'
 
-      gem 'leanweb', '~> 0.2'
-      gem 'haml'
+      gem 'leanweb', '~> #{LeanWeb::VERSION}'
+      gem 'haml', '~> 5.2.2'
       gem 'rake'
+      gem 'puma'
     RUBY
   }, {
     filename: 'config.ru',
@@ -55,7 +55,7 @@ files = [
 
       require 'leanweb'
 
-      task default: %w[build]
+      task default: %w[build_static]
 
       task :build_static do
         require_relative 'routes'
@@ -63,7 +63,7 @@ files = [
       end
     RUBY
   }, {
-    filename: 'src/controllers/main.rb',
+    filename: 'src/controllers/main_controller.rb',
     content: <<~RUBY
       # frozen_string_literal: true
 
@@ -88,6 +88,12 @@ files = [
         %body
           %h1 It works!
     HAML
+  }, {
+    filename: '.gitignore'
+    content: <<~GITIGNORE
+      /.bundle
+      /public/**/*.html
+    GITIGNORE
   }
 ]
 

data/contrib/lib/hawese.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+# Copyright 2022 Felix Freeman <libsys@hacktivista.org>
+#
+# This file is part of "LeanWeb" and licensed under the terms of the GNU Affero
+# General Public License version 3 with permissions for compatibility with the
+# Hacktivista General Public License. You should have received a copy of this
+# license along with the software. If not, see <https://gnu.org/licenses/>.
+
+require 'json'
+require 'net/http'
+require 'openssl'
+require 'tilt'
+require 'uri'
+
+# Hawese client.
+#
+# **Environment variables**
+#
+# - HAWESE_RETURN_URL defaults to `LEANWEB_ENDPOINT/checkout`.
+# - HAWESE_ENDPOINT
+# - HAWESE_ORIGIN
+class Hawese
+  class << self
+    ENDPOINT = ENV.fetch('HAWESE_ENDPOINT')
+    RETURN_URL = ENV.fetch('HAWESE_RETURN_URL') do
+      "#{ENV.fetch('LEANWEB_ENDPOINT')}/checkout"
+    end
+    ORIGIN = ENV.fetch('HAWESE_ORIGIN')
+
+    def payment_methods(country = '*', currency = nil)
+      endpoint = String.new(
+        "#{ENDPOINT}/gateways/payment-methods/purchase?country=#{country}"
+      )
+      endpoint << "&currency=#{currency}" if currency
+      uri = URI(endpoint)
+      JSON.parse(Net::HTTP.get(uri), symbolize_names: true)
+    end
+
+    def gateway_schema(gateway, query_params, schema = 'purchase')
+      uri = URI("#{ENDPOINT}/gateways/#{gateway}/schemas/#{schema}")
+      uri.query = URI.encode_www_form(query_params)
+      JSON.parse(Net::HTTP.get(uri), symbolize_names: true)
+    end
+
+    def purchase(gateway, fields)
+      fields[:origin] = ORIGIN
+      uri = URI("#{ENDPOINT}/gateways/#{gateway}/purchase")
+      uri.query = URI.encode_www_form(return_url: RETURN_URL)
+      response = Net::HTTP.post(
+        uri,
+        fields.to_json,
+        'Content-Type' => 'application/json'
+      )
+      JSON.parse(response.body, symbolize_names: true)
+    end
+
+    def purchase_from_schema(gateway, schema)
+      fields = {}
+      schema[:properties].each do |property, contents|
+        fields[property] = contents[:default] if contents.include?(:default)
+      end
+      purchase(gateway, fields)
+    end
+
+    def payment(uuid)
+      uri = URI("#{ENDPOINT}/payments/#{uuid}")
+      Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        req = Net::HTTP::Get.new(uri)
+        req['Authorization'] = "Bearer #{ENV.fetch('HAWESE_AUTH_TOKEN')}"
+        response = http.request(req)
+        JSON.parse(response.body, symbolize_names: true)
+      end
+    end
+  end
+end

data/contrib/lib/lean_mail.rb

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+# Copyright 2022 Felix Freeman <libsys@hacktivista.org>
+#
+# This file is part of "LeanWeb" and licensed under the terms of the GNU Affero
+# General Public License version 3 with permissions for compatibility with the
+# Hacktivista General Public License. You should have received a copy of this
+# license along with the software. If not, see <https://gnu.org/licenses/>.
+
+require 'net/smtp'
+require 'securerandom'
+require 'socket'
+require 'time'
+
+# Send an email with SMTP easily.
+#
+# Environment variables:
+#
+# - SMTP_HOST: Where to connect to.
+# - SMTP_PORT: Port, optional (default: 25).
+# - SMTP_SECURITY: `tls` or `starttls`, optional (default: `nil`).
+# - SMTP_USER: User, optional.
+# - SMTP_PASSWORD: Password, optional.
+# - SMTP_FROM: In the format `Name <user@mail>` or `user@mail`.
+#
+# @example Single address
+#   LeanMail.deliver('to@mail', 'subject', 'body')
+#
+# @example Multiple addresses
+#   LeanMail.deliver(['to@mail', 'to2@mail'], 'subject', 'body')
+module LeanMail
+  # RFC 2821 message data representation.
+  class Data
+    attr_reader :from, :to, :subject, :message
+
+    def initialize(from, to, subject, message)
+      @from = from
+      @to = to
+      @subject = subject
+      @message = message
+    end
+
+    def to_s
+      <<~MAIL
+        From: #{@from}
+        To: #{to.instance_of?(Array) ? to.join(', ') : to}
+        Subject: #{subject}
+        Date: #{Time.new.rfc2822}
+        Message-Id: <#{SecureRandom.uuid}@#{Socket.gethostname}>
+
+        #{@message}
+      MAIL
+    end
+  end
+
+  # Email deliverer.
+  class Deliver
+    attr_reader :data
+
+    def initialize
+      @user = ENV.fetch('SMTP_USER', nil)
+      @password = ENV.fetch('SMTP_PASSWORD', nil)
+      @from = ENV.fetch('SMTP_FROM')
+
+      @host = ENV.fetch('SMTP_HOST')
+      @port = ENV.fetch('SMTP_PORT', 25)
+      @security = ENV.fetch('SMTP_SECURITY', nil)
+
+      initialize_smtp
+    end
+
+    # Send email.
+    #
+    # @param to [Array, String] In the format `Name <user@mail>` or `user@mail`.
+    # @param subject [String]
+    # @param body [String]
+    # @return [Deliver]
+    def call(to, subject, body)
+      @data = Data.new(@from, to, subject, body)
+
+      @smtp.start(Socket.gethostname, @user, @password, :plain) do |smtp|
+        smtp.send_message(@data.to_s, extract_addr(@from), extract_addrs(to))
+      end
+
+      self
+    end
+
+    protected
+
+    def initialize_smtp
+      @smtp = Net::SMTP.new(@host, @port)
+      maybe_enable_security(@security)
+    end
+
+    def maybe_enable_security(security)
+      case security
+      when 'tls' then @smtp.enable_tls
+      when 'starttls' then @smtp.enable_starttls
+      end
+    end
+
+    def extract_addr(str)
+      match = str.match(%r{<([^/]+)>})
+      return match[1] if match
+
+      str
+    end
+
+    def extract_addrs(to)
+      return to.map{ |addr| extract_addr(addr) } if to.instance_of?(Array)
+
+      extract_addr(to)
+    end
+  end
+
+  # Deliver email.
+  #
+  # @param to [Array, String] In the format `Name <user@mail>` or `user@mail`.
+  # @param subject [String]
+  # @param body [String]
+  # @return [Deliver]
+  def self.deliver(to, subject, body)
+    LeanMail::Deliver.new.call(to, subject, body)
+  end
+end

data/contrib/lib/leanweb/controller_mixins/render_with_layout.rb

@@ -0,0 +1,205 @@
+# frozen_string_literal: true
+
+# Copyright 2022 Felix Freeman <libsys@hacktivista.org>
+#
+# This file is part of "LeanWeb" and licensed under the terms of the GNU Affero
+# General Public License version 3 with permissions for compatibility with the
+# Hacktivista General Public License. You should have received a copy of this
+# license along with the software. If not, see <https://gnu.org/licenses/>.
+
+
+module LeanWeb
+  module ControllerMixins
+    # {render_with_layout} for {Controller} with ERB, HAML, Tilt::EmacsOrg and
+    # Redcarpet Markdown support.
+    module RenderWithLayout # rubocop:disable Metrics/ModuleLength
+      # Render a response with a layout.
+      #
+      # Depending on the `path` file contents and options `@content_for` might
+      # be filled. These contents must be inserted on the `head` or `body` of
+      # your layout file.
+      #
+      # All paths used on parameters can be relative to {VIEW_PATH} or absolute.
+      #
+      # @param path [String] Path to file to rendered.
+      # @param title [String] `@content_for[:title]` content.
+      # @param head [Hash] Things to be inserted on `@content_for[:head]`.
+      # @option head [String|Array] :js Javascript file path(s).
+      # @option head [String|Array] :jsm Javascript module file path (s).
+      # @option head [String|Array] :css CSS file path(s).
+      # @option head [String|Array] :raw Raw headers in HTML format.
+      # @param layout [String] Layout file path.
+      # @param sub_layout [String] Layout file to be inserted within layout.
+      # @param options [Hash] Options hash, to be given to the template engine
+      #   based on file extension: `Tilt::EmacsOrg` for `.org` and `Redcarpet`
+      #   for `.md`.
+      # @option options [String] :setupfile For `.org`.
+      # @option options [true] :toc For `.md`. To fill `@content_for[:toc]`
+      #   render with option `:with_toc_data`.
+      # @yield On dynamic templates (such as Haml and ERB) you can yield.
+      def render_with_layout( # rubocop:disable Metrics/ParameterLists
+        path,
+        title: nil,
+        head: nil,
+        layout: 'layout.haml',
+        sub_layout: nil,
+        options: nil,
+        &block
+      )
+        @content_for[:title] = title unless title.nil?
+        content = render_by_extension(path, sub_layout, options, &block)
+        prepare_head(**head) unless head.nil?
+        render_response(layout, 'text/html'){ content }
+      end
+
+      # Render response for missing static action methods. Called from
+      # {Route#respond}.
+      def default_static_action(view_path)
+        render_with_layout(view_path)
+      end
+
+      protected
+
+      # @param path [String]
+      # @param layout [String]
+      # @param options [Hash] Check `Tilt::EmacsOrg` options.
+      # @option options [String] :setupfile can be absolute or relative to
+      #   {VIEW_PATH}.
+      def render_org(path, layout: nil, options: {})
+        options[:setupfile] = absolute_view_path(options[:setupfile]) \
+          if options.include?(:setupfile)
+
+        org_template = create_template(path, options)
+
+        @content_for[:title] = org_template.title \
+          unless @content_for.include?(:title)
+
+        if layout
+          create_template(layout).render(self){ org_template.render(self) }
+        else
+          org_template.render(self)
+        end
+      end
+
+      # @param path [String]
+      # @param layout [String]
+      # @param options [Hash] Check `RedCarpet` `render_options`.
+      # @option options [true] :toc To place an HTML based table of contents on
+      #   `@content_for[:toc]` and render with option `:with_toc_data`.
+      def render_markdown(path, layout: nil, options: {})
+        maybe_render_markdown_toc!(path, options)
+        markdown_template = create_template(path, options)
+
+        @content_for[:title] = find_title('md', path) \
+          unless @content_for.include?(:title)
+
+        if layout
+          create_template(layout).render(self){ markdown_template.render(self) }
+        else
+          markdown_template.render(self)
+        end
+      end
+
+      # If `options[:toc]` is set, deletes options `:toc` and adds
+      # `:with_toc_data`. Also adds `@content_for[:toc]`.
+      def maybe_render_markdown_toc!(path, options)
+        return unless options.include?(:toc)
+
+        require('redcarpet')
+        @content_for[:toc] = create_template(
+          path, { renderer: Redcarpet::Render::HTML_TOC }
+        ).render
+
+        options.delete(:toc)
+        options[:with_toc_data] = true
+      end
+
+      def find_title(ext, path)
+        regex = find_title_ext_regex(ext)
+        title = nil
+        File.foreach(absolute_view_path(path)) do |line|
+          matches = line.match(regex)
+          (title = matches[1]) && break if matches
+        end
+        title
+      end
+
+      def find_title_ext_regex(ext)
+        case ext
+        when 'md' then /#(?!#)\s?(.+)/
+        when 'haml' then /%h1[^\s]*\s(.+)/
+        end
+      end
+
+      # @param path [String]
+      # @param layout [String]
+      # @param options [Hash] Check `Haml` options.
+      # @yield If block given.
+      def render_other(path, layout: nil, options: {})
+        template = create_template(path, options)
+        if layout
+          create_template(layout).render(self) do
+            template.render(self){ yield if block_given? }
+          end
+        else
+          template.render(self){ yield if block_given? }
+        end
+      end
+
+      # rubocop:disable Metrics/MethodLength
+      def render_by_extension(path, layout, options, &block)
+        ext = File.extname(path)[1..]
+        options = options || template_defaults[ext] || {}
+
+        case ext
+        when 'org'
+          return render_org(path, layout: layout, options: options)
+        when 'md'
+          return render_markdown(path, layout: layout, options: options)
+        when 'haml'
+          @content_for[:title] = find_title('haml', path) \
+            unless @content_for.include?(:title)
+        end
+
+        render_other(path, layout: layout, options: options, &block)
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      def prepare_head(js: nil, jsm: nil, css: nil, raw: nil)
+        head = String.new
+        head << prepare_head_js(js) unless js.nil?
+        head << prepare_head_js(jsm, 'module') unless jsm.nil?
+        head << prepare_head_css(css) unless css.nil?
+        head << prepare_head_raw(raw) unless raw.nil?
+        @content_for[:head] = head
+      end
+
+      def prepare_head_js(js, type = 'application/javascript')
+        head = String.new
+        js = [js] if js.instance_of?(String)
+        js.each do |src|
+          head << "<script type='#{type}' src='#{src}'"
+          head << ' defer' if type != 'module'
+          head << "></script>\n"
+        end
+        head
+      end
+
+      def prepare_head_css(css)
+        head = String.new
+        css = [css] if css.instance_of?(String)
+        css.each do |src|
+          head << "<link rel='stylesheet' type='text/css' href='#{src}'>\n"
+        end
+        head
+      end
+
+      def prepare_head_raw(raw)
+        head = String.new
+        raw = [raw] if raw.instance_of?(String)
+        raw.each{ |src| head << "#{src}\n" }
+        head
+      end
+    end
+  end
+end

data/contrib/lib/rack/session/json_file.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+# Copyright 2022 Felix Freeman <libsys@hacktivista.org>
+#
+# This file is part of "LeanWeb" and licensed under the terms of the GNU Affero
+# General Public License version 3 with permissions for compatibility with the
+# Hacktivista General Public License. You should have received a copy of this
+# license along with the software. If not, see <https://gnu.org/licenses/>.
+
+require 'date'
+require 'fileutils'
+require 'json'
+require 'rack/session/abstract/id'
+
+module Rack
+  module Session
+    # A JSON File based session storage.
+    class JsonFile < Abstract::PersistedSecure
+      # Cleans session files that have not been used.
+      # @param to [Time|Date] Time from which file has not been accessed.
+      #   Defaults to 00:00 hrs 1 month ago.
+      # @param dir [String] Directory from which to clean files. Defaults to
+      #   `/tmp/rack.session`.
+      def self.clean(
+        to = Date.today.prev_month,
+        dir = "#{Dir.tmpdir}/rack.session"
+      )
+        to = to.to_time if to.instance_of?(Date)
+        Dir["#{dir}/*"].each do |file|
+          FileUtils.rm(file, force: true) if ::File.atime(file) < to
+        end
+      end
+
+      # @param options [Hash] Accepts a :session_dir path which defaults to
+      #   `/tmp/rack.session`.
+      def initialize(app, options = {})
+        super(
+          app,
+          {
+            secure: ENV['RACK_ENV'] != 'development', # HTTPS unless in dev env
+            same_site: 'Strict' # don't allow cross-site sessions
+          }.merge!(options)
+        )
+        @session_dir = "#{Dir.tmpdir}/#{@key}" || @default_options[:session_dir]
+      end
+
+      # @return [Array] [self, Hash].
+      def find_session(_req, sid)
+        sid = generate_sid if sid.nil?
+
+        [sid, JSON.parse(::File.read("#{@session_dir}/#{sid}"))]
+      rescue Errno::ENOENT
+        [generate_sid, {}]
+      rescue JSON::ParserError
+        [sid, {}]
+      end
+
+      # @param sid [String] Only known ids are allowed, to avoid session
+      #   fixation attacks.
+      # @return [self|false] session_id or false.
+      def write_session(_req, sid, session, _options)
+        return false unless ::File.exist?("#{@session_dir}/#{sid}")
+
+        ::File.open("#{@session_dir}/#{sid}", 'w', 0o600) do |f|
+          f << JSON.generate(session)
+        end
+        sid
+      end
+
+      # @return [self|nil] new session id or nil if options[:drop].
+      def delete_session(_req, sid, options)
+        FileUtils.rm("#{@session_dir}/#{sid}", force: true)
+        options&.include?(:drop) ? nil : generate_sid
+      end
+
+      def generate_sid(*)
+        sid = super
+        FileUtils.mkdir_p(@session_dir, mode: 0o700)
+        ::File.new("#{@session_dir}/#{sid}", 'w', 0o600).close
+        sid
+      end
+    end
+  end
+end

data/lib/leanweb/app.rb

@@ -2,10 +2,10 @@
 
 # Copyright 2022 Felix Freeman <libsys@hacktivista.org>
 #
-# This file is part of "LeanWeb" and licensed under the terms of the Hacktivista
-# General Public License version 0.1 or (at your option) any later version. You
-# should have received a copy of this license along with the software. If not,
-# see <https://hacktivista.org/licenses/>.
+# This file is part of "LeanWeb" and licensed under the terms of the GNU Affero
+# General Public License version 3 with permissions for compatibility with the
+# Hacktivista General Public License. You should have received a copy of this
+# license along with the software. If not, see <https://gnu.org/licenses/>.
 
 require 'rack'
 

data/lib/leanweb/controller.rb

@@ -2,10 +2,10 @@
 
 # Copyright 2022 Felix Freeman <libsys@hacktivista.org>
 #
-# This file is part of "LeanWeb" and licensed under the terms of the Hacktivista
-# General Public License version 0.1 or (at your option) any later version. You
-# should have received a copy of this license along with the software. If not,
-# see <https://hacktivista.org/licenses/>.
+# This file is part of "LeanWeb" and licensed under the terms of the GNU Affero
+# General Public License version 3 with permissions for compatibility with the
+# Hacktivista General Public License. You should have received a copy of this
+# license along with the software. If not, see <https://gnu.org/licenses/>.
 
 require 'rack'
 require 'tilt'
@@ -24,6 +24,7 @@ module LeanWeb
       @route = route
       @request = request
       @response = Rack::Response.new(nil, 200)
+      @content_for = {}
     end
 
     # Render magic. Supports every file extension that Tilt supports. Defaults
@@ -58,6 +59,12 @@ module LeanWeb
       Tilt[ext].new(path, 1, options || template_defaults[ext] || {})
     end
 
+    # Render response for missing static action methods. Called from
+    # {Route#respond}.
+    def default_static_action(view_path)
+      render_response(view_path)
+    end
+
     # Relative route to path from public directory considering current route.
     #
     # @param path [String] path from public directory, never begins with `/`.
@@ -69,9 +76,28 @@ module LeanWeb
       @base_url + path
     end
 
+    # Get absolute path for a file within {VIEW_PATH}.
+    # @param path [String] Can be:
+    # - A full path, starts with `/`.
+    # - A path relative to {VIEW_PATH}.
+    # - A path relative to current @route.path directory, starts with `./`.
+    # @return [String] Absolute path.
+    def absolute_view_path(path)
+      return path if path.start_with?('/')
+
+      view_path = String.new(LeanWeb::VIEW_PATH)
+
+      if path.start_with?('./')
+        view_path << @route.path.sub(%r{/[^/]*$}, '')
+        path = path[2..]
+      end
+
+      path == '' ? view_path : "#{view_path}/#{path}"
+    end
+
     # Request params.
     def params
-      @request.params
+      @request&.params
     end
 
     protected
@@ -80,11 +106,5 @@ module LeanWeb
     def template_defaults
       {}
     end
-
-    # @param path [String]
-    # @return [String] Full path.
-    def absolute_view_path(path)
-      path[0] == '/' ? path : "#{LeanWeb::VIEW_PATH}/#{path}"
-    end
   end
 end

data/lib/leanweb/helpers.rb

@@ -2,23 +2,33 @@
 
 # Copyright 2022 Felix Freeman <libsys@hacktivista.org>
 #
-# This file is part of "LeanWeb" and licensed under the terms of the Hacktivista
-# General Public License version 0.1 or (at your option) any later version. You
-# should have received a copy of this license along with the software. If not,
-# see <https://hacktivista.org/licenses/>.
+# This file is part of "LeanWeb" and licensed under the terms of the GNU Affero
+# General Public License version 3 with permissions for compatibility with the
+# Hacktivista General Public License. You should have received a copy of this
+# license along with the software. If not, see <https://gnu.org/licenses/>.
 
-# String helpers.
-class String
-  # String to PascalCase.
-  def pascalize
-    camelize(pascal: true)
-  end
 
-  # String to camelCase.
-  # @param pascal [Boolean] If true first letter is uppercase.
-  def camelize(pascal: false)
-    str = gsub(/[-_\s]+(.?)/){ |match| match[1].upcase }
-    str[0] = pascal ? str[0].upcase : str[0].downcase
-    str
+module LeanWeb
+  # String refinements.
+  module StringRefinements
+    refine ::String do
+      # String to PascalCase.
+      def pascalize
+        camelize(pascal: true)
+      end
+
+      # String to camelCase.
+      # @param pascal [Boolean] If true first letter is uppercase.
+      def camelize(pascal: false)
+        str = gsub(/[-_\s]+(.?)/){ |match| match[1].upcase }
+        str[0] = pascal ? str[0].upcase : str[0].downcase
+        str
+      end
+
+      # String to snake_case
+      def snakeize
+        gsub(/[[:upper:]]/){ |match| "_#{match.downcase}" }.delete_prefix('_')
+      end
+    end
   end
 end

data/lib/leanweb/route.rb

@@ -2,20 +2,22 @@
 
 # Copyright 2022 Felix Freeman <libsys@hacktivista.org>
 #
-# This file is part of "LeanWeb" and licensed under the terms of the Hacktivista
-# General Public License version 0.1 or (at your option) any later version. You
-# should have received a copy of this license along with the software. If not,
-# see <https://hacktivista.org/licenses/>.
+# This file is part of "LeanWeb" and licensed under the terms of the GNU Affero
+# General Public License version 3 with permissions for compatibility with the
+# Hacktivista General Public License. You should have received a copy of this
+# license along with the software. If not, see <https://gnu.org/licenses/>.
 
 require 'rack/mock'
 
 module LeanWeb
   # Action for {Route#action}.
-  Action = Struct.new(:file, :controller, :action, keyword_init: true)
+  Action = Struct.new(:controller, :action, keyword_init: true)
 
   # A single route which routes with the {#respond} method. It can also {#build}
   # an static file.
   class Route
+    using StringRefinements
+
     attr_reader :path, :method, :action, :static
 
     # A new instance of Route.
@@ -27,13 +29,13 @@ module LeanWeb
     # @param action [Proc, Hash, String, nil] References a Method/Proc to be
     #   triggered. It can be:
     #
-    #   - A full hash `{ file: 'val', controller: 'val', action: 'val' }`.
-    #   - A hash with `{ 'file' => 'action' }` only (which has a controller
-    #     class name `{File}Controller`).
-    #   - A simple string (which will consider file `main.rb` and controller
-    #     `MainController`). Defaults to "{#path_basename}_{#method}", (ex:
-    #     `index_get`).
-    #   - It can also be a `Proc`.
+    #   - Nothing, defaults to :"{#path_basename}_{#method}" (such as
+    #     `:index_get`) on `:MainController`.
+    #   - A full hash `{ controller: 'val', action: 'val' }`.
+    #   - A hash with `{ Controller: :action }` only.
+    #   - A simple string for an action on `:MainController`.
+    #   - It can also be a `Proc`. Will be executed in a `:MainController`
+    #     instance context.
     #
     # @param static [Boolean|Array] Defines a route as static. Defaults true for
     #   GET method, false otherwise. Set to `false` to say it can only work
@@ -61,12 +63,20 @@ module LeanWeb
       str_path[-1] == '/' ? 'index' : File.basename(str_path)
     end
 
+    # Respond with a proc, controller method, or in case of true static routes
+    # a rendering of {VIEW_PATH}/{path} with any file extension.
+    #
     # @param request [Rack::Request]
     # @return [Array] a valid rack response.
     def respond(request)
       return respond_proc(request) if @action.instance_of?(Proc)
 
       respond_method(request)
+    rescue NoMethodError
+      raise unless @static == true && (view_path = guess_view_path)
+
+      controller = default_controller_class.new(self)
+      controller.default_static_action(view_path)
     end
 
     # String path, independent if {#path} is Regexp or String.
@@ -108,42 +118,52 @@ module LeanWeb
 
     # Assign value to `@action`.
     def action=(value)
-      @action = if value.instance_of?(Proc)
-                  value
-                else
-                  Action.new(**prepare_action_hash(value))
-                end
+      @action =
+        if value.instance_of?(Proc)
+          value
+        else
+          Action.new(**prepare_action_hash(value))
+        end
     end
 
     # @param src_value [Hash, String, nil] Check {#initialize} action param for
     #   valid input.
     # @return [Hash] valid hash for {Action}.
-    def prepare_action_hash(src_value) # rubocop:disable Metrics/MethodLength
-      begin
-        if %i[file controller action].include?(src_value.keys.first)
-          value = src_value
-        else
-          value = {}
-          value[:file], value[:action] = src_value.first
-        end
-      rescue NoMethodError
-        value = { action: src_value }
-      end
-      value[:file] ||= 'main'
-      value[:controller] ||= "#{value[:file].pascalize}Controller"
-      value[:action] ||= default_action_name
+    def prepare_action_hash(src_value)
+      value = prepare_prepare_action_hash(src_value)
+      value[:controller] = value[:controller]&.to_sym || DEFAULT_CONTROLLER
+      value[:action] = value[:action]&.to_sym || default_action_action
       value
     end
 
-    def default_action_name
-      "#{path_basename.gsub('-', '_')}_#{@method.downcase}"
+    def prepare_prepare_action_hash(src_value)
+      if %i[controller action].include?(src_value.keys.first)
+        src_value
+      else
+        value = {}
+        value[:controller], value[:action] = src_value.first
+        value
+      end
+    rescue NoMethodError
+      { action: src_value }
+    end
+
+    def default_action_action
+      "#{path_basename.gsub(/[.-]/, '_')}_#{@method.downcase}".to_sym
+    end
+
+    def default_controller_class
+      require_relative("#{CONTROLLER_PATH}/#{DEFAULT_CONTROLLER.to_s.snakeize}")
+      Object.const_get(DEFAULT_CONTROLLER)
+    rescue LoadError
+      Controller
     end
 
     # @param request [Rack::Request]
     # @return [Array] a valid Rack response.
     def respond_method(request)
       params = action_params(request.path)
-      require_relative("#{LeanWeb::CONTROLLER_PATH}/#{@action.file}")
+      require_relative("#{CONTROLLER_PATH}/#{@action.controller.to_s.snakeize}")
       controller = Object.const_get(@action.controller).new(self, request)
       return controller.public_send(@action.action, **params) \
         if params.instance_of?(Hash)
@@ -155,9 +175,11 @@ module LeanWeb
     # @return [Array] a valid Rack response.
     def respond_proc(request)
       params = action_params(request.path)
-      return @action.call(**params) if params.instance_of?(Hash)
+      controller = default_controller_class.new(self, request)
+      return controller.instance_exec(**params, &@action) \
+        if params.instance_of?(Hash)
 
-      @action.call(*params)
+      controller.instance_exec(*params, &@action)
     end
 
     # @param request_path [String]
@@ -178,8 +200,28 @@ module LeanWeb
     # @param content_type [String]
     # @return [String] absolute route to path + extension based on content_type.
     def output_path(path, content_type)
-      path += 'index' if path[-1] == '/'
-      "#{LeanWeb::PUBLIC_PATH}#{path}#{LeanWeb::MEDIA_EXTENSIONS[content_type]}"
+      out_path =
+        if path[-1] == '/'
+          String.new("#{PUBLIC_PATH}#{path}index")
+        else
+          String.new("#{PUBLIC_PATH}#{path}")
+        end
+
+      unless path.end_with?(MEDIA_EXTENSIONS[content_type])
+        out_path << MEDIA_EXTENSIONS[content_type]
+      end
+
+      out_path
+    end
+
+    def guess_view_path
+      return if @path.instance_of?(Regexp)
+
+      view_path = String.new("#{LeanWeb::VIEW_PATH}#{@path}")
+      view_path << 'index' if @path[-1] == '/' # add index if is index
+      view_path.sub!(%r{\.[^/]+$}, '') # drop static file extension if set
+
+      Dir["#{view_path}.*"].first # return first file match or nil
     end
   end
 end

data/lib/leanweb/version.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# Copyright 2022 Felix Freeman <libsys@hacktivista.org>
+#
+# This file is part of "LeanWeb" and licensed under the terms of the GNU Affero
+# General Public License version 3 with permissions for compatibility with the
+# Hacktivista General Public License. You should have received a copy of this
+# license along with the software. If not, see <https://gnu.org/licenses/>.
+
+
+module LeanWeb
+  VERSION = '0.4.0'
+end

data/lib/leanweb.rb

@@ -2,14 +2,14 @@
 
 # Copyright 2022 Felix Freeman <libsys@hacktivista.org>
 #
-# This file is part of "LeanWeb" and licensed under the terms of the Hacktivista
-# General Public License version 0.1 or (at your option) any later version. You
-# should have received a copy of this license along with the software. If not,
-# see <https://hacktivista.org/licenses/>.
+# This file is part of "LeanWeb" and licensed under the terms of the GNU Affero
+# General Public License version 3 with permissions for compatibility with the
+# Hacktivista General Public License. You should have received a copy of this
+# license along with the software. If not, see <https://gnu.org/licenses/>.
 
 # LeanWeb is a minimal hybrid static / dynamic web framework.
 module LeanWeb
-  VERSION = '0.2.0'
+  require_relative 'leanweb/version'
 
   ROOT_PATH = ENV.fetch('LEANWEB_ROOT_PATH', Dir.pwd)
   CONTROLLER_PATH = "#{ROOT_PATH}/src/controllers"
@@ -26,13 +26,11 @@ module LeanWeb
     'text/csv' => '.csv'
   }.freeze
 
+  DEFAULT_CONTROLLER = :MainController
+
   autoload :Route, 'leanweb/route.rb'
   autoload :Controller, 'leanweb/controller.rb'
   autoload :App, 'leanweb/app.rb'
 end
 
 require_relative 'leanweb/helpers'
-
-# TODO: Remove if/when tilt-emacs_org gets merged on a Tilt release.
-require 'tilt'
-Tilt.register_lazy(:EmacsOrgTemplate, 'tilt/emacs_org', 'org')

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: leanweb
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Felix Freeman
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-08-01 00:00:00.000000000 Z
+date: 2022-11-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.10
+        version: 2.0.11
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.10
+        version: 2.0.11
 - !ruby/object:Gem::Dependency
   name: haml
   requirement: !ruby/object:Gem::Requirement
@@ -66,6 +66,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 5.16.2
+- !ruby/object:Gem::Dependency
+  name: minitest-sprint
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.2
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -122,6 +136,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.20.1
+- !ruby/object:Gem::Dependency
+  name: tilt-emacs_org
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.1
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -145,14 +187,19 @@ extensions: []
 extra_rdoc_files: []
 files:
 - bin/leanweb
+- contrib/lib/hawese.rb
+- contrib/lib/lean_mail.rb
+- contrib/lib/leanweb/controller_mixins/render_with_layout.rb
+- contrib/lib/rack/session/json_file.rb
 - lib/leanweb.rb
 - lib/leanweb/app.rb
 - lib/leanweb/controller.rb
 - lib/leanweb/helpers.rb
 - lib/leanweb/route.rb
+- lib/leanweb/version.rb
 homepage: https://leanweb.hacktivista.org
 licenses:
-- LicenseRef-LICENSE
+- AGPL-3.0-only
 metadata:
   homepage_uri: https://leanweb.hacktivista.org
   source_code_uri: https://git.hacktivista.org/leanweb
@@ -163,6 +210,7 @@ post_install_message:
 rdoc_options: []
 require_paths:
 - lib
+- contrib/lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -174,7 +222,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
+rubygems_version: 3.3.23
 signing_key:
 specification_version: 4
 summary: LeanWeb is a minimal hybrid static / dynamic web framework