otto 1.5.0 → 2.0.0.pre1

data/examples/advanced_routes/app/logic/admin/panel.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Admin
+  class Panel
+    attr_reader :context, :params, :locale
+
+    def initialize(context, params, locale)
+      @context = context
+      @params = params
+      @locale = locale
+    end
+
+    def process
+      {
+        admin_panel: 'Logic processed',
+        namespace: 'Admin',
+        access_level: 'admin',
+        authenticated: @context.authenticated?,
+        has_admin_role: @context.has_role?('admin'),
+      }
+    end
+
+    def response_data
+      { admin_panel_logic: process }
+    end
+  end
+end

data/examples/advanced_routes/app/logic/analytics_processor.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Analytics
+  class Processor
+    attr_reader :context, :params, :locale
+
+    def initialize(context, params, locale)
+      @context = context
+      @params = params
+      @locale = locale
+    end
+
+    def process
+      {
+        analytics: 'Processed',
+        metrics: { users: 123, events: 456 },
+        period: @params['period'] || 'today',
+      }
+    end
+
+    def response_data
+      { analytics_processor: process }
+    end
+  end
+end

data/examples/advanced_routes/app/logic/complex/business/handler.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Complex
+  module Business
+    class Handler
+      attr_reader :context, :params, :locale
+
+      def initialize(context, params, locale)
+        @context = context
+        @params = params
+        @locale = locale
+      end
+
+      def process
+        {
+          complex_business: 'Handled',
+          namespace: 'Complex::Business',
+          business_logic: 'executed',
+        }
+      end
+
+      def response_data
+        { complex_business_handler: process }
+      end
+    end
+  end
+end

data/examples/advanced_routes/app/logic/data_logic.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+class DataLogic
+  attr_reader :context, :params, :locale
+
+  def initialize(context, params, locale)
+    @context = context
+    @params = params
+    @locale = locale
+  end
+
+  def process
+    {
+      data_logic: 'Processed',
+      response_format: 'json',
+      input_data: @params,
+    }
+  end
+
+  def response_data
+    { data_logic_result: process }
+  end
+end

data/examples/advanced_routes/app/logic/data_processor.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+class DataProcessor
+  attr_reader :context, :params, :locale
+
+  def initialize(context, params, locale)
+    @context = context
+    @params = params
+    @locale = locale
+  end
+
+  def process
+    {
+      processed: 'Data processing complete',
+      input_params: @params.keys,
+      timestamp: Time.now.iso8601,
+      authenticated: @context.authenticated?,
+      user_id: @context.user_id,
+    }
+  end
+
+  def response_data
+    { data_processor: process }
+  end
+end

data/examples/advanced_routes/app/logic/input_validator.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+class InputValidator
+  attr_reader :context, :params, :locale
+
+  def initialize(context, params, locale)
+    @context = context
+    @params = params
+    @locale = locale
+  end
+
+  def process
+    {
+      validation: 'Input validated successfully',
+      validated_fields: @params.keys,
+      locale: @locale,
+      authenticated: @context.authenticated?,
+    }
+  end
+
+  def response_data
+    { validator: process }
+  end
+end

data/examples/advanced_routes/app/logic/nested/feature/logic.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Nested
+  module Feature
+    class Logic
+      attr_reader :context, :params, :locale
+
+      def initialize(context, params, locale)
+        @context = context
+        @params = params
+        @locale = locale
+      end
+
+      def process
+        {
+          nested_feature: 'Processed',
+          depth: 3,
+          namespace: 'Nested::Feature',
+        }
+      end
+
+      def response_data
+        { nested_feature_logic: process }
+      end
+    end
+  end
+end

data/examples/advanced_routes/app/logic/reports_generator.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Reports
+  class Generator
+    attr_reader :context, :params, :locale
+
+    def initialize(context, params, locale)
+      @context = context
+      @params = params
+      @locale = locale
+    end
+
+    def process
+      {
+        report_generation: 'Complete',
+        namespace: 'Reports',
+        data_points: 100,
+        authenticated: @context.authenticated?,
+        user_permissions: @context.permissions,
+      }
+    end
+
+    def response_data
+      { report_generator: process }
+    end
+  end
+end

data/examples/advanced_routes/app/logic/simple_logic.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+class SimpleLogic
+  attr_reader :context, :params, :locale
+
+  def initialize(context, params, locale)
+    @context = context
+    @params = params
+    @locale = locale
+  end
+
+  def process
+    {
+      message: 'Simple logic processed',
+      params: @params,
+      locale: @locale,
+      authenticated: @context.authenticated?,
+      user: @context.user_name,
+    }
+  end
+
+  def response_data
+    { simple_logic: process }
+  end
+end

data/examples/advanced_routes/app/logic/system/config/manager.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module System
+  module Config
+    class Manager
+      attr_reader :context, :params, :locale
+
+      def initialize(context, params, locale)
+        @context = context
+        @params = params
+        @locale = locale
+      end
+
+      def process
+        {
+          system_config: 'Updated',
+          namespace: 'System::Config',
+          csrf_exempt: true,
+        }
+      end
+
+      def response_data
+        { system_config_manager: process }
+      end
+    end
+  end
+end

data/examples/advanced_routes/app/logic/test_logic.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+class TestLogic
+  attr_reader :context, :params, :locale
+
+  def initialize(context, params, locale)
+    @context = context
+    @params = params
+    @locale = locale
+  end
+
+  def process
+    {
+      test: 'Logic class test',
+      params_received: @params,
+      processing_complete: true,
+    }
+  end
+
+  def response_data
+    { test_logic: process }
+  end
+end

data/examples/advanced_routes/app/logic/transform_logic.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+class TransformLogic
+  attr_reader :context, :params, :locale
+
+  def initialize(context, params, locale)
+    @context = context
+    @params = params
+    @locale = locale
+  end
+
+  def process
+    {
+      transformation: 'Complete',
+      input_size: @params.to_s.length,
+      output_format: 'json',
+    }
+  end
+
+  def response_data
+    { transform_result: process }
+  end
+end

data/examples/advanced_routes/app/logic/upload_logic.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+class UploadLogic
+  attr_reader :context, :params, :locale
+
+  def initialize(context, params, locale)
+    @context = context
+    @params = params
+    @locale = locale
+  end
+
+  def process
+    {
+      upload: 'Processing complete',
+      csrf_exempt: true,
+      files_processed: @params.keys.count,
+    }
+  end
+
+  def response_data
+    { upload_result: process }
+  end
+end

data/examples/advanced_routes/app/logic/v2/logic/dashboard.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module V2
+  module Logic
+    class Dashboard
+      attr_reader :context, :params, :locale
+
+      def initialize(context, params, locale)
+        @context = context
+        @params = params
+        @locale = locale
+      end
+
+      def process
+        {
+          v2_dashboard: 'Rendered',
+          version: '2.0',
+          features: ['metrics', 'charts', 'reports'],
+        }
+      end
+
+      def response_data
+        { v2_dashboard: process }
+      end
+    end
+  end
+end

data/examples/advanced_routes/app/logic/v2/logic/processor.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module V2
+  module Logic
+    class Processor
+      attr_reader :context, :params, :locale
+
+      def initialize(context, params, locale)
+        @context = context
+        @params = params
+        @locale = locale
+      end
+
+      def process
+        {
+          v2_processor: 'Complete',
+          csrf_exempt: true,
+          processing_time: 0.05,
+        }
+      end
+
+      def response_data
+        { v2_processor: process }
+      end
+    end
+  end
+end

data/examples/advanced_routes/app.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+# Application Loader
+
+# Controllers
+require_relative 'app/controllers/routes_app'
+require_relative 'app/controllers/handlers/async'
+require_relative 'app/controllers/handlers/dynamic'
+require_relative 'app/controllers/handlers/static'
+require_relative 'app/controllers/modules/auth'
+require_relative 'app/controllers/modules/transformer'
+require_relative 'app/controllers/modules/validator'
+require_relative 'app/controllers/v2/admin'
+require_relative 'app/controllers/v2/config'
+require_relative 'app/controllers/v2/settings'
+
+# Logic Classes
+require_relative 'app/logic/admin/logic/manager'
+require_relative 'app/logic/admin/panel'
+require_relative 'app/logic/analytics_processor'
+require_relative 'app/logic/complex/business/handler'
+require_relative 'app/logic/data_logic'
+require_relative 'app/logic/data_processor'
+require_relative 'app/logic/input_validator'
+require_relative 'app/logic/nested/feature/logic'
+require_relative 'app/logic/reports_generator'
+require_relative 'app/logic/simple_logic'
+require_relative 'app/logic/system/config/manager'
+require_relative 'app/logic/test_logic'
+require_relative 'app/logic/transform_logic'
+require_relative 'app/logic/upload_logic'
+require_relative 'app/logic/v2/logic/dashboard'
+require_relative 'app/logic/v2/logic/processor'

data/examples/advanced_routes/config.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'rack'
+require_relative '../../lib/otto'
+require_relative 'app'
+
+# Simple Otto configuration demonstrating advanced routes syntax
+otto = Otto.new('routes')
+
+# Enable basic security features to demonstrate CSRF functionality
+otto.enable_csrf_protection!
+
+# Set error handlers
+otto.not_found = lambda do |_env|
+  RoutesApp.not_found
+end
+
+otto.server_error = lambda do |_env, _error|
+  RoutesApp.server_error
+end
+
+# Return the configured app. This allows runner scripts to use the same instance.
+otto

data/examples/advanced_routes/config.ru

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+# Load the app from our shared config file.
+# This returns a configured Otto instance.
+app = require_relative 'config'
+
+run app

data/examples/advanced_routes/puma.rb

@@ -0,0 +1,20 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'puma'
+
+# The shared config file returns the configured Otto app
+otto_app = require_relative 'config'
+
+# Configure Puma server
+Puma::Server.new(otto_app).tap do |server|
+  server.add_tcp_listener '127.0.0.1', 9292
+
+  puts "Otto Advanced Routes Example running on http://localhost:9292"
+  puts "Press Ctrl+C to stop"
+
+  # Handle Ctrl+C gracefully
+  trap('INT') { server.stop }
+
+  server.run
+end

data/examples/advanced_routes/routes

@@ -0,0 +1,167 @@
+# Advanced Routes Syntax - Otto v1.5.0+ Features
+# This file demonstrates the advanced routing syntax without complex authentication
+
+# ========================================
+# BASIC ROUTES (Original Otto Syntax)
+# ========================================
+
+GET   /                         RoutesApp#index
+POST  /feedback                 RoutesApp#receive_feedback
+
+# ========================================
+# RESPONSE TYPE ROUTES
+# ========================================
+
+# JSON response routes
+GET   /api/users                RoutesApp#list_users response=json
+POST  /api/users                RoutesApp#create_user response=json
+GET   /api/health               RoutesApp#health_check response=json
+PUT   /api/users/:id            RoutesApp#update_user response=json
+DELETE /api/users/:id           RoutesApp#delete_user response=json
+
+# View/HTML response routes
+GET   /dashboard                RoutesApp#dashboard response=view
+GET   /reports                  RoutesApp#reports response=view
+GET   /admin                    RoutesApp#admin_panel response=view
+
+# Redirect response routes
+GET   /login                    RoutesApp#login_redirect response=redirect
+GET   /logout                   RoutesApp#logout_redirect response=redirect
+GET   /home                     RoutesApp#home_redirect response=redirect
+
+# Auto response type (content negotiation)
+GET   /data                     RoutesApp#flexible_data response=auto
+GET   /content                  RoutesApp#flexible_content response=auto
+
+# ========================================
+# CSRF PROTECTION ROUTES
+# ========================================
+
+# CSRF exempt routes (useful for APIs and webhooks)
+POST  /api/webhook              RoutesApp#webhook_handler csrf=exempt
+PUT   /api/external             RoutesApp#external_update csrf=exempt
+DELETE /api/cleanup             RoutesApp#cleanup_data csrf=exempt
+PATCH /api/sync                 RoutesApp#sync_data csrf=exempt
+
+# Standard CSRF protected routes (default behavior)
+POST  /settings                 RoutesApp#update_settings
+PUT   /password                 RoutesApp#change_password
+DELETE /profile                 RoutesApp#delete_profile
+
+# ========================================
+# MULTIPLE PARAMETER COMBINATIONS
+# ========================================
+
+# API routes with response type and CSRF exemption
+GET   /api/v1/data              RoutesApp#api_data response=json
+POST  /api/v1/submit            RoutesApp#api_submit response=json csrf=exempt
+PUT   /api/v1/update            RoutesApp#api_update response=json csrf=exempt
+
+# View routes with multiple parameters
+GET   /admin/dashboard          RoutesApp#admin_dashboard response=view
+POST  /admin/settings           RoutesApp#admin_settings response=view
+
+# Mixed content routes
+GET   /mixed/endpoint           RoutesApp#mixed_content response=auto csrf=exempt
+
+# ========================================
+# LOGIC CLASS ROUTES (New in v1.5.0+)
+# ========================================
+
+# Simple Logic class (no . or # in target)
+GET   /logic/simple             SimpleLogic
+POST  /logic/process            DataProcessor
+PUT   /logic/validate           InputValidator
+
+# Namespaced Logic classes
+GET   /logic/admin              Admin::Panel
+GET   /logic/reports            Reports::Generator
+POST  /logic/analytics          Analytics::Processor
+
+# Logic classes with parameters
+GET   /logic/data               DataLogic response=json
+POST  /logic/upload             UploadLogic response=json csrf=exempt
+PUT   /logic/transform          TransformLogic response=json
+
+# Complex namespaced Logic routes
+GET   /logic/v2/dashboard       V2::Logic::Dashboard response=view
+POST  /logic/v2/process         V2::Logic::Processor response=json csrf=exempt
+GET   /logic/admin/manager      Admin::Logic::Manager response=json
+
+# Deeply nested Logic classes
+GET   /logic/nested/feature     Nested::Feature::Logic
+POST  /logic/complex/handler    Complex::Business::Handler response=json
+PUT   /logic/system/config      System::Config::Manager response=json csrf=exempt
+
+# ========================================
+# NAMESPACED CLASS ROUTES
+# ========================================
+
+# Class method routes with namespaces
+GET   /v2/admin                 V2::Admin.show response=view
+POST  /v2/config                V2::Config.update response=json
+PUT   /v2/settings              V2::Settings.modify response=json csrf=exempt
+
+# Instance method routes with namespaces
+GET   /modules/auth             Modules::Auth#process
+POST  /modules/validator        Modules::Validator#validate response=json
+PUT   /modules/transformer      Modules::Transformer#transform response=json csrf=exempt
+
+# Mixed class and instance methods
+GET   /handlers/static          Handlers::Static.serve
+POST  /handlers/dynamic         Handlers::Dynamic#process response=json
+PUT   /handlers/async           Handlers::Async#execute response=json csrf=exempt
+
+# ========================================
+# CUSTOM PARAMETERS
+# ========================================
+
+# Routes with custom configuration parameters
+GET   /config/env               RoutesApp#show_config env=production
+GET   /config/debug             RoutesApp#debug_info env=development debug=true
+POST  /config/update            RoutesApp#update_config env=production response=json
+
+# Routes with multiple custom parameters
+GET   /feature/flags            RoutesApp#feature_flags feature=advanced mode=enabled
+POST  /feature/toggle           RoutesApp#toggle_feature feature=beta mode=test response=json csrf=exempt
+
+# ========================================
+# PARAMETER VALUE VARIATIONS
+# ========================================
+
+# Parameters with special values
+GET   /api/v1                   RoutesApp#api_v1 version=1.0 response=json
+GET   /api/v2                   RoutesApp#api_v2 version=2.0 response=json
+POST  /api/legacy               RoutesApp#api_legacy version=legacy response=json csrf=exempt
+
+# Parameters with equals in values (edge case)
+GET   /query/complex            RoutesApp#complex_query filter=key=value response=json
+POST  /config/connection        RoutesApp#config_db connection=host=localhost csrf=exempt
+
+# ========================================
+# ERROR HANDLERS
+# ========================================
+
+GET   /404                      RoutesApp#not_found response=view
+GET   /500                      RoutesApp#server_error response=view
+
+# ========================================
+# TESTING ROUTES
+# ========================================
+
+# Routes for testing different parameter combinations
+GET   /test/json                RoutesApp#test_json response=json
+GET   /test/view                RoutesApp#test_view response=view
+GET   /test/redirect            RoutesApp#test_redirect response=redirect
+GET   /test/auto                RoutesApp#test_auto response=auto
+
+POST  /test/csrf                RoutesApp#test_csrf
+POST  /test/no-csrf             RoutesApp#test_no_csrf csrf=exempt
+
+GET   /test/logic               TestLogic
+POST  /test/logic-json          TestLogic response=json
+PUT   /test/logic-exempt        TestLogic response=json csrf=exempt
+
+# Complex test routes
+GET   /test/complex             TestLogic response=auto
+POST  /test/everything          RoutesApp#test_everything response=json csrf=exempt custom=value