otto 1.2.0 → 1.4.0

data/Gemfile.lock

@@ -1,8 +1,8 @@
 PATH
   remote: .
   specs:
-    otto (1.2.0)
-      addressable (~> 2.2, < 3)
+    otto (1.4.0)
+      ostruct
       rack (~> 3.1, < 4.0)
       rack-parser (~> 0.7)
       rexml (>= 3.3.6)
@@ -10,32 +10,46 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.7)
-      public_suffix (>= 2.0.2, < 7.0)
-    ast (2.4.2)
-    byebug (11.1.3)
+    ast (2.4.3)
+    byebug (12.0.0)
     coderay (1.1.3)
+    date (3.4.1)
     diff-lcs (1.6.2)
-    drydock (0.6.9)
-    json (2.7.2)
-    language_server-protocol (3.17.0.3)
+    erb (5.0.2)
+    io-console (0.8.1)
+    irb (1.15.2)
+      pp (>= 0.6.0)
+      rdoc (>= 4.0.0)
+      reline (>= 0.4.2)
+    json (2.13.2)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
     logger (1.7.0)
-    method_source (1.0.0)
-    parallel (1.24.0)
-    parser (3.3.0.5)
+    method_source (1.1.0)
+    minitest (5.25.5)
+    ostruct (0.6.3)
+    parallel (1.27.0)
+    parser (3.3.9.0)
       ast (~> 2.4.1)
       racc
+    pastel (0.8.0)
+      tty-color (~> 0.5)
+    pp (0.6.2)
+      prettyprint
     prettier_print (1.2.1)
+    prettyprint (0.2.0)
     prism (1.4.0)
-    pry (0.14.2)
+    pry (0.15.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    pry-byebug (3.10.1)
-      byebug (~> 11.0)
-      pry (>= 0.13, < 0.15)
-    public_suffix (6.0.1)
-    racc (1.7.3)
-    rack (3.1.16)
+    pry-byebug (3.11.0)
+      byebug (~> 12.0)
+      pry (>= 0.13, < 0.16)
+    psych (5.2.6)
+      date
+      stringio
+    racc (1.8.1)
+    rack (3.2.0)
     rack-parser (0.7.0)
       rack
     rack-test (2.2.0)
@@ -43,8 +57,13 @@ GEM
     rainbow (3.1.1)
     rbs (3.9.4)
       logger
-    regexp_parser (2.9.0)
-    rexml (3.3.7)
+    rdoc (6.14.2)
+      erb
+      psych (>= 4.0.0)
+    regexp_parser (2.11.0)
+    reline (0.6.2)
+      io-console (~> 0.5)
+    rexml (3.4.1)
     rspec (3.13.1)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
@@ -58,44 +77,57 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.4)
-    rubocop (1.62.1)
+    rubocop (1.79.1)
       json (~> 2.3)
-      language_server-protocol (>= 3.17.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
       parallel (~> 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.46.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.31.2)
-      parser (>= 3.3.0.4)
-    rubocop-performance (1.23.1)
-      rubocop (>= 1.48.1, < 2.0)
-      rubocop-ast (>= 1.31.1, < 2.0)
-    rubocop-rspec (3.4.0)
-      rubocop (~> 1.61)
-    rubocop-thread_safety (0.6.0)
-      rubocop (>= 1.48.1)
-    ruby-lsp (0.26.0)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.46.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-performance (1.25.0)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+    rubocop-rspec (3.6.0)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
+    rubocop-thread_safety (0.7.3)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
+      rubocop-ast (>= 1.44.0, < 2.0)
+    ruby-lsp (0.26.1)
       language_server-protocol (~> 3.17.0)
       prism (>= 1.2, < 2.0)
       rbs (>= 3, < 5)
     ruby-progressbar (1.13.0)
     stackprof (0.2.27)
-    storable (0.10.0)
+    stringio (3.1.7)
     syntax_tree (6.3.0)
       prettier_print (>= 1.2.0)
-    sysinfo (0.10.0)
-      drydock (< 1.0)
-      storable (~> 0.10)
-    tryouts (2.2.0)
-      sysinfo (~> 0.10)
-    unicode-display_width (2.5.0)
+    tryouts (3.2.1)
+      irb
+      minitest (~> 5.0)
+      pastel (~> 0.8)
+      prism (~> 1.0)
+      rspec (~> 3.0)
+      tty-cursor (~> 0.7)
+      tty-screen (~> 0.8)
+    tty-color (0.6.0)
+    tty-cursor (0.7.1)
+    tty-screen (0.8.2)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
 
 PLATFORMS
-  arm64-darwin-22
+  arm64-darwin-24
   ruby
 
 DEPENDENCIES
@@ -113,4 +145,4 @@ DEPENDENCIES
   tryouts
 
 BUNDLED WITH
-   2.5.7
+   2.6.9

data/README.md

@@ -1,4 +1,4 @@
-# Otto - 1.2 (2025-08-18)
+# Otto - A Ruby Gem
 
 **Define your rack-apps in plain-text with built-in security.**
 
@@ -74,9 +74,65 @@ app = Otto.new("./routes", {
 
 Security features include CSRF protection, input validation, security headers, and trusted proxy configuration.
 
+## Internationalization Support
+
+Otto provides built-in locale detection and management:
+
+```ruby
+# Global configuration (affects all Otto instances)
+Otto.configure do |opts|
+  opts.available_locales = { 'en' => 'English', 'es' => 'Spanish', 'fr' => 'French' }
+  opts.default_locale = 'en'
+end
+
+# Or configure during initialization
+app = Otto.new("./routes", {
+  available_locales: { 'en' => 'English', 'es' => 'Spanish', 'fr' => 'French' },
+  default_locale: 'en'
+})
+
+# Or configure at runtime
+app.configure(
+  available_locales: { 'en' => 'English', 'es' => 'Spanish' },
+  default_locale: 'en'
+)
+
+# Legacy support (still works)
+app = Otto.new("./routes", {
+  locale_config: {
+    available_locales: { 'en' => 'English', 'es' => 'Spanish', 'fr' => 'French' },
+    default_locale: 'en'
+  }
+})
+```
+
+In your application, use the locale helper:
+
+```ruby
+class App
+  def initialize(req, res)
+    @req, @res = req, res
+  end
+
+  def show_product
+    # Automatically detects locale from:
+    # 1. URL parameter: ?locale=es
+    # 2. User preference (if provided)
+    # 3. Accept-Language header
+    # 4. Default locale
+    locale = req.check_locale!
+
+    # Use locale for localized content
+    res.body = localized_content(locale)
+  end
+end
+```
+
+The locale helper checks multiple sources in order of precedence and validates against your configured locales.
+
 ## Requirements
 
-- Ruby 3.4+
+- Ruby 3.2+
 - Rack 3.1+
 
 ## Installation

data/examples/basic/app.rb

@@ -8,8 +8,8 @@ class App
   attr_reader :req, :res
 
   def initialize(req, res)
-    @req = req
-    @res = res
+    @req                        = req
+    @res                        = res
     res.headers['content-type'] = 'text/html; charset=utf-8'
   end
 
@@ -21,15 +21,15 @@ class App
         <p>Minimal Ruby web framework with style</p>
       </div>
 
-      #{otto_card("Send Feedback") do
+      #{otto_card('Send Feedback') do
         otto_form_wrapper do
-          otto_input("msg", placeholder: "Your message...") +
-          otto_button("Send Feedback")
+          otto_input('msg', placeholder: 'Your message...') +
+          otto_button('Send Feedback')
         end
       end}
     HTML
 
-    res.send_cookie :sess, 1_234_567, 3600
+    res.send_secure_cookie :sess, 1_234_567, 3600
     res.body = otto_page(content)
   end
 
@@ -37,14 +37,14 @@ class App
     message = req.params['msg']&.strip
 
     content = if message.nil? || message.empty?
-      otto_alert("error", "Empty Message", "Please enter a message before submitting.")
+      otto_alert('error', 'Empty Message', 'Please enter a message before submitting.')
     else
-      otto_alert("success", "Feedback Received", "Thanks for your message!") +
-      otto_card("Your Message") { otto_code_block(message, 'text') }
+      otto_alert('success', 'Feedback Received', 'Thanks for your message!') +
+        otto_card('Your Message') { otto_code_block(message, 'text') }
     end
 
-    content += "<p>#{otto_link("← Back", "/")}</p>"
-    res.body = otto_page(content, "Feedback")
+    content += "<p>#{otto_link('← Back', '/')}</p>"
+    res.body = otto_page(content, 'Feedback')
   end
 
   def redirect
@@ -53,26 +53,26 @@ class App
 
   def robots_text
     res.headers['content-type'] = 'text/plain'
-    res.body = ['User-agent: *', 'Disallow: /private'].join($/)
+    res.body                    = ['User-agent: *', 'Disallow: /private'].join($/)
   end
 
   def display_product
     res.headers['content-type'] = 'application/json; charset=utf-8'
-    prodid = req.params[:prodid]
-    res.body = format('{"product":%s,"msg":"Hint: try another value"}', prodid)
+    prodid                      = req.params[:prodid]
+    res.body                    = format('{"product":%s,"msg":"Hint: try another value"}', prodid)
   end
 
   def not_found
     res.status = 404
-    content = otto_alert("error", "Not Found", "The requested page could not be found.")
-    content += "<p>#{otto_link("← Home", "/")}</p>"
-    res.body = otto_page(content, "404")
+    content    = otto_alert('error', 'Not Found', 'The requested page could not be found.')
+    content   += "<p>#{otto_link('← Home', '/')}</p>"
+    res.body   = otto_page(content, '404')
   end
 
   def server_error
     res.status = 500
-    content = otto_alert("error", "Server Error", "An internal server error occurred.")
-    content += "<p>#{otto_link("← Home", "/")}</p>"
-    res.body = otto_page(content, "500")
+    content    = otto_alert('error', 'Server Error', 'An internal server error occurred.')
+    content   += "<p>#{otto_link('← Home', '/')}</p>"
+    res.body   = otto_page(content, '500')
   end
 end

data/examples/basic/config.ru

@@ -11,7 +11,7 @@ public_path = File.expand_path('../../public', __dir__)
 require_relative '../../lib/otto'
 require_relative 'app'
 
-app = Otto.new("routes")
+app = Otto.new('routes')
 
 # DEV: Run web apps with extra logging and reloading
 if Otto.env?(:dev)

data/examples/dynamic_pages/app.rb

@@ -8,8 +8,8 @@ class App
   attr_reader :req, :res
 
   def initialize(req, res)
-    @req = req
-    @res = res
+    @req                        = req
+    @res                        = res
     res.headers['content-type'] = 'text/html; charset=utf-8'
   end
 
@@ -23,19 +23,19 @@ class App
         <p>Minimal Ruby web framework with style</p>
       </div>
 
-      #{otto_card("Dynamic Pages") do
+      #{otto_card('Dynamic Pages') do
         # This is a nested heredoc within the outer HTML heredoc
         # It uses a different delimiter (EXAMPLES) to avoid conflicts
         # The #{} interpolation allows the inner heredoc to be embedded
         <<~EXAMPLES
-          #{otto_link("Product #100", "/product/100")} - View product page<br>
-          #{otto_link("Product #42", "/product/42")} - Different product<br>
-          #{otto_link("API Data", "/product/100.json")} - JSON endpoint
+          #{otto_link('Product #100', '/product/100')} - View product page<br>
+          #{otto_link('Product #42', '/product/42')} - Different product<br>
+          #{otto_link('API Data', '/product/100.json')} - JSON endpoint
         EXAMPLES
       end}
     HTML
 
-    res.send_cookie :sess, 1_234_567, 3600
+    res.send_secure_cookie :sess, 1_234_567, 3600
     res.body = otto_page(content)
   end
 
@@ -43,14 +43,14 @@ class App
     message = req.params['msg']&.strip
 
     content = if message.nil? || message.empty?
-      otto_alert("error", "Empty Message", "Please enter a message before submitting.")
+      otto_alert('error', 'Empty Message', 'Please enter a message before submitting.')
     else
-      otto_alert("success", "Feedback Received", "Thanks for your message!") +
-      otto_card("Your Message") { otto_code_block(message, 'text') }
+      otto_alert('success', 'Feedback Received', 'Thanks for your message!') +
+        otto_card('Your Message') { otto_code_block(message, 'text') }
     end
 
-    content += "<p>#{otto_link("← Back", "/")}</p>"
-    res.body = otto_page(content, "Feedback")
+    content += "<p>#{otto_link('← Back', '/')}</p>"
+    res.body = otto_page(content, 'Feedback')
   end
 
   def redirect
@@ -59,7 +59,7 @@ class App
 
   def robots_text
     res.headers['content-type'] = 'text/plain'
-    res.body = ['User-agent: *', 'Disallow: /private'].join($/)
+    res.body                    = ['User-agent: *', 'Disallow: /private'].join($/)
   end
 
   def display_product
@@ -71,27 +71,27 @@ class App
 
     if wants_json
       res.headers['content-type'] = 'application/json; charset=utf-8'
-      res.body = format('{"product":%s,"msg":"Hint: try another value"}', prodid)
+      res.body                    = format('{"product":%s,"msg":"Hint: try another value"}', prodid)
     else
       # Return HTML product page
       product_data = {
-        "Product ID" => prodid,
-        "Name" => "Sample Product ##{prodid}",
-        "Price" => "$#{rand(10..999)}.99",
-        "Description" => "This is a demonstration product showing dynamic routing with parameter :prodid",
-        "Stock" => rand(0..50) > 5 ? "In Stock" : "Out of Stock"
+        'Product ID' => prodid,
+        'Name' => "Sample Product ##{prodid}",
+        'Price' => "$#{rand(10..999)}.99",
+        'Description' => 'This is a demonstration product showing dynamic routing with parameter :prodid',
+        'Stock' => rand(0..50) > 5 ? 'In Stock' : 'Out of Stock',
       }
 
-      product_html = product_data.map { |key, value|
+      product_html = product_data.map do |key, value|
         "<p><strong>#{key}:</strong> #{escape_html(value.to_s)}</p>"
-      }.join
+      end.join
 
       content = <<~HTML
-        #{otto_card("Product Details") { product_html }}
+        #{otto_card('Product Details') { product_html }}
 
         <p>
-          #{otto_link("← Back to Home", "/")} |
-          #{otto_link("View as JSON", "/product/#{prodid}.json")}
+          #{otto_link('← Back to Home', '/')} |
+          #{otto_link('View as JSON', "/product/#{prodid}.json")}
         </p>
       HTML
 
@@ -101,15 +101,15 @@ class App
 
   def not_found
     res.status = 404
-    content = otto_alert("error", "Not Found", "The requested page could not be found.")
-    content += "<p>#{otto_link("← Home", "/")}</p>"
-    res.body = otto_page(content, "404")
+    content    = otto_alert('error', 'Not Found', 'The requested page could not be found.')
+    content   += "<p>#{otto_link('← Home', '/')}</p>"
+    res.body   = otto_page(content, '404')
   end
 
   def server_error
     res.status = 500
-    content = otto_alert("error", "Server Error", "An internal server error occurred.")
-    content += "<p>#{otto_link("← Home", "/")}</p>"
-    res.body = otto_page(content, "500")
+    content    = otto_alert('error', 'Server Error', 'An internal server error occurred.')
+    content   += "<p>#{otto_link('← Home', '/')}</p>"
+    res.body   = otto_page(content, '500')
   end
 end

data/examples/dynamic_pages/config.ru

@@ -11,7 +11,7 @@ public_path = File.expand_path('../../public', __dir__)
 require_relative '../../lib/otto'
 require_relative 'app'
 
-app = Otto.new("routes")
+app = Otto.new('routes')
 
 # DEV: Run web apps with extra logging and reloading
 if Otto.env?(:dev)