cyberweb 0.4.174 → 0.5.225

data/lib/cyberweb/REST/main.rb

@@ -0,0 +1,109 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This was sinatra/main.rb
+# =========================================================================== #
+# require 'cyberweb/REST/main.rb'
+# =========================================================================== #
+module Cyberweb
+
+module REST
+
+  require 'cyberweb/REST/base/base.rb'
+  require 'cyberweb/REST/base/delegator.rb'
+
+  # ========================================================================= #
+  # === Cyberweb::REST.new
+  #
+  # Create a new Sinatra application; the block is evaluated in the
+  # class scope.
+  # ========================================================================= #
+  def self.new(base = Base, &block)
+    base = Class.new(base)
+    base.class_eval(&block) if block_given?
+    base
+  end
+
+  # ========================================================================= #
+  # === Cyberweb::REST.register
+  #
+  # Extend the top-level DSL with the modules provided.
+  # ========================================================================= #
+  def self.register(*extensions, &block)
+    Delegator.target.register(*extensions, &block)
+  end
+
+  # ========================================================================= #
+  # Include the helper modules provided in Sinatra's request context.
+  # ========================================================================= #
+  def self.helpers(*extensions, &block)
+    Delegator.target.helpers(*extensions, &block)
+  end
+
+  # ========================================================================= #
+  # Use the middleware for classic applications.
+  # ========================================================================= #
+  def self.use(*args, &block)
+    Delegator.target.use(*args, &block)
+  end
+
+  # ========================================================================= #
+  # === PARAMS_CONFIG
+  # ========================================================================= #
+  PARAMS_CONFIG = {}
+
+  if ARGV.any?
+    require 'optparse'
+    parser = OptionParser.new { |op|
+      op.on('-p port',   'set the port (default is 4567)')               { |val| PARAMS_CONFIG[:port] = Integer(val) }
+      op.on('-s server', 'specify rack server/handler')                  { |val| PARAMS_CONFIG[:server] = val }
+      op.on('-q',        'turn on quiet mode (default is off)')          {       PARAMS_CONFIG[:quiet] = true }
+      op.on('-x',        'turn on the mutex lock (default is off)')      {       PARAMS_CONFIG[:lock] = true }
+      op.on('-e env',    'set the environment (default is development)') { |val|
+        ENV['RACK_ENV'] = val
+        PARAMS_CONFIG[:environment] = val.to_sym
+      }
+      op.on('-o addr', "set the host (default is (env == 'development' ? 'localhost' : '0.0.0.0'))") { |val|
+        PARAMS_CONFIG[:bind] = val
+      }
+    }
+    begin
+      parser.parse!(ARGV.dup)
+    rescue StandardError => e
+      PARAMS_CONFIG[:optparse_error] = e
+    end
+  end
+
+  class Application < ::Cyberweb::REST::Base
+
+    # ======================================================================= #
+    # we assume that the first file that requires 'sinatra' is the
+    # app_file. all other path related options are calculated based
+    # on this path by default.
+    # ======================================================================= #
+    set :app_file, caller_files.first || $0
+
+    set :run, proc { File.expand_path($0) == File.expand_path(app_file) }
+
+    if run? && ARGV.any?
+      error = PARAMS_CONFIG.delete(:optparse_error)
+      raise error if error
+
+      PARAMS_CONFIG.each { |key, v| set(key, v) }
+    end
+  end
+
+  remove_const(:PARAMS_CONFIG)
+  at_exit { Application.run! if $!.nil? && Application.run? }
+
+end; end
+
+# include would include the module in Object
+# extend only extends the `main` object
+extend ::Cyberweb::REST::Delegator # Sinatra::Delegator
+
+class Rack::Builder
+  # include Sinatra::Delegator
+  include ::Cyberweb::REST::Delegator
+end

data/lib/cyberweb/REST/show_exceptions.rb

@@ -0,0 +1,396 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'cyberweb/REST/show_exceptions.rb'
+# =========================================================================== #
+module Cyberweb
+
+module REST
+
+require 'rack/show_exceptions'
+
+# =========================================================================== #
+# REST::ShowExceptions catches all exceptions raised from the app it
+# wraps. It shows a useful backtrace with the sourcefile and clickable
+# context, the whole Rack environment and the request data.
+#
+# Be careful when you use this on public-facing sites as it could reveal
+# information helpful to attackers.
+# =========================================================================== #
+class ShowExceptions < Rack::ShowExceptions
+
+  @@eats_errors = Object.new
+  def @@eats_errors.flush(*) end
+  def @@eats_errors.puts(*) end
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(i)
+    @app = i
+  end
+
+  # ========================================================================= #
+  # === call
+  # ========================================================================= #
+  def call(env)
+    @app.call(env)
+  rescue Exception => e
+    errors = env['rack.errors']
+    env['rack.errors'] = @@eats_errors
+
+    if prefers_plain_text?(env)
+      content_type = 'text/plain'
+      body = dump_exception(e)
+    else
+      content_type = 'text/html'
+      body = pretty(env, e)
+    end
+
+    env['rack.errors'] = errors
+    [
+      500,
+      {
+        'Content-Type' => content_type,
+        'Content-Length' => body.bytesize.to_s
+      },
+      [body]
+    ]
+  end
+
+  # ========================================================================= #
+  # === template
+  # ========================================================================= #
+  def template
+    TEMPLATE
+  end
+
+  private
+
+  # ========================================================================= #
+  # === bad_request?
+  # ========================================================================= #
+  def bad_request?(exception)
+    REST::BadRequest === exception
+  end
+
+  # ========================================================================= #
+  # === prefers_plain_text?
+  # ========================================================================= #
+  def prefers_plain_text?(env)
+    Request.new(env).preferred_type('text/plain', 'text/html') != 'text/html' &&
+      [/curl/].index { |item| item =~ env['HTTP_USER_AGENT'] }
+  end
+
+  # ========================================================================= #
+  # === frame_class
+  # ========================================================================= #
+  def frame_class(frame)
+    if frame.filename =~ /lib\/REST.*\.rb/ # Check for a proper filename.
+      'framework'
+    elsif (defined?(Gem) && frame.filename.include?(Gem.dir)) ||
+          frame.filename =~ %r{/bin/(\w+)\z}
+      'system'
+    else
+      'app'
+    end
+  end
+
+  # ========================================================================= #
+  # === TEMPLATE
+  # ========================================================================= #
+  TEMPLATE = ERB.new <<-HTML
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+  <title><%=h exception.class %> at <%=h path %></title>
+
+  <script type="text/javascript">
+  //<!--
+  function toggle(id) {
+    var pre  = document.getElementById("pre-" + id);
+    var post = document.getElementById("post-" + id);
+    var context = document.getElementById("context-" + id);
+
+    if (pre.style.display == 'block') {
+      pre.style.display = 'none';
+      post.style.display = 'none';
+      context.style.background = "none";
+    } else {
+      pre.style.display = 'block';
+      post.style.display = 'block';
+      context.style.background = "#fffed9";
+    }
+  }
+
+  function toggleBacktrace(){
+    var bt = document.getElementById("backtrace");
+    var toggler = document.getElementById("expando");
+
+    if (bt.className == 'condensed') {
+      bt.className = 'expanded';
+      toggler.innerHTML = "(condense)";
+    } else {
+      bt.className = 'condensed';
+      toggler.innerHTML = "(expand)";
+    }
+  }
+  //-->
+  </script>
+
+<style type="text/css" media="screen">
+  *                   {margin: 0; padding: 0; border: 0; outline: 0;}
+  div.clear           {clear: both;}
+  body                {background: #EEEEEE; margin: 0; padding: 0;
+                       font-family: 'Lucida Grande', 'Lucida Sans Unicode',
+                       'Garuda';}
+  code                {font-family: 'Lucida Console', monospace;
+                       font-size: 12px;}
+  li                  {height: 18px;}
+  ul                  {list-style: none; margin: 0; padding: 0;}
+  ol:hover            {cursor: pointer;}
+  ol li               {white-space: pre;}
+  #explanation        {font-size: 12px; color: #666666;
+                       margin: 20px 0 0 100px;}
+/* WRAP */
+  #wrap               {width: 1000px; background: #FFFFFF; margin: 0 auto;
+                       padding: 30px 50px 20px 50px;
+                       border-left: 1px solid #DDDDDD;
+                       border-right: 1px solid #DDDDDD;}
+/* HEADER */
+  #header             {margin: 0 auto 25px auto;}
+  #header img         {float: left;}
+  #header #summary    {float: left; margin: 12px 0 0 20px; width:660px;
+                       font-family: 'Lucida Grande', 'Lucida Sans Unicode';}
+  h1                  {margin: 0; font-size: 36px; color: #981919;}
+  h2                  {margin: 0; font-size: 22px; color: #333333;}
+  #header ul          {margin: 0; font-size: 12px; color: #666666;}
+  #header ul li strong{color: #444444;}
+  #header ul li       {display: inline; padding: 0 10px;}
+  #header ul li.first {padding-left: 0;}
+  #header ul li.last  {border: 0; padding-right: 0;}
+/* BODY */
+  #backtrace,
+  #get,
+  #post,
+  #cookies,
+  #rack               {width: 980px; margin: 0 auto 10px auto;}
+  p#nav               {float: right; font-size: 14px;}
+/* BACKTRACE */
+  a#expando           {float: left; padding-left: 5px; color: #666666;
+                      font-size: 14px; text-decoration: none; cursor: pointer;}
+  a#expando:hover     {text-decoration: underline;}
+  h3                  {float: left; width: 100px; margin-bottom: 10px;
+                       color: #981919; font-size: 14px; font-weight: bold;}
+  #nav a              {color: #666666; text-decoration: none; padding: 0 5px;}
+  #backtrace li.frame-info {background: #f7f7f7; padding-left: 10px;
+                           font-size: 12px; color: #333333;}
+  #backtrace ul       {list-style-position: outside; border: 1px solid #E9E9E9;
+                       border-bottom: 0;}
+  #backtrace ol       {width: 920px; margin-left: 50px;
+                       font: 10px 'Lucida Console', monospace; color: #666666;}
+  #backtrace ol li    {border: 0; border-left: 1px solid #E9E9E9;
+                       padding: 2px 0;}
+  #backtrace ol code  {font-size: 10px; color: #555555; padding-left: 5px;}
+  #backtrace-ul li    {border-bottom: 1px solid #E9E9E9; height: auto;
+                       padding: 3px 0;}
+  #backtrace-ul .code {padding: 6px 0 4px 0;}
+  #backtrace.condensed .system,
+  #backtrace.condensed .framework {display:none;}
+/* REQUEST DATA */
+  p.no-data           {padding-top: 2px; font-size: 12px; color: #666666;}
+  table.req           {width: 980px; text-align: left; font-size: 12px;
+                       color: #666666; padding: 0; border-spacing: 0;
+                       border: 1px solid #EEEEEE; border-bottom: 0;
+                       border-left: 0;
+                       clear:both}
+  table.req tr th     {padding: 2px 10px; font-weight: bold;
+                       background: #F7F7F7; border-bottom: 1px solid #EEEEEE;
+                       border-left: 1px solid #EEEEEE;}
+  table.req tr td     {padding: 2px 20px 2px 10px;
+                       border-bottom: 1px solid #EEEEEE;
+                       border-left: 1px solid #EEEEEE;}
+/* HIDE PRE/POST CODE AT START */
+  .pre-context,
+  .post-context       {display: none;}
+
+  table td.code       {width:750px}
+  table td.code div   {width:750px;overflow:hidden}
+</style>
+</head>
+<body>
+  <div id="wrap">
+    <div id="header">
+      <img src="<%= env['SCRIPT_NAME'] %>/__sinatra__/500.png" alt="application error" height="161" width="313" />
+      <div id="summary">
+        <h1><strong><%=h exception.class %></strong> at <strong><%=h path %>
+          </strong></h1>
+        <h2><%=h exception.message %></h2>
+        <ul>
+          <li class="first"><strong>file:</strong> <code>
+            <%=h frames.first.filename.split("/").last %></code></li>
+          <li><strong>location:</strong> <code><%=h frames.first.function %>
+            </code></li>
+          <li class="last"><strong>line:
+            </strong> <%=h frames.first.lineno %></li>
+        </ul>
+      </div>
+      <div class="clear"></div>
+    </div>
+
+    <div id="backtrace" class='condensed'>
+      <h3>BACKTRACE</h3>
+      <p><a href="#" id="expando"
+            onclick="toggleBacktrace(); return false">(expand)</a></p>
+      <p id="nav"><strong>JUMP TO:</strong>
+         <% unless bad_request?(exception) %>
+            <a href="#get-info">GET</a>
+            <a href="#post-info">POST</a>
+         <% end %>
+         <a href="#cookie-info">COOKIES</a>
+         <a href="#env-info">ENV</a>
+      </p>
+      <div class="clear"></div>
+
+      <ul id="backtrace-ul">
+
+      <% id = 1 %>
+      <% frames.each do |frame| %>
+          <% if frame.context_line && frame.context_line != "#" %>
+
+            <li class="frame-info <%= frame_class(frame) %>">
+              <code><%=h frame.filename %></code> in
+                <code><strong><%=h frame.function %></strong></code>
+            </li>
+
+            <li class="code <%= frame_class(frame) %>">
+              <% if frame.pre_context %>
+              <ol start="<%=h frame.pre_context_lineno + 1 %>"
+                  class="pre-context" id="pre-<%= id %>"
+                  onclick="toggle(<%= id %>);">
+                <% frame.pre_context.each do |line| %>
+                <li class="pre-context-line"><code><%=h line %></code></li>
+                <% end %>
+              </ol>
+              <% end %>
+
+              <ol start="<%= frame.lineno %>" class="context" id="<%= id %>"
+                  onclick="toggle(<%= id %>);">
+                <li class="context-line" id="context-<%= id %>"><code><%=
+                  h frame.context_line %></code></li>
+              </ol>
+
+              <% if frame.post_context %>
+              <ol start="<%=h frame.lineno + 1 %>" class="post-context"
+                  id="post-<%= id %>" onclick="toggle(<%= id %>);">
+                <% frame.post_context.each do |line| %>
+                <li class="post-context-line"><code><%=h line %></code></li>
+                <% end %>
+              </ol>
+              <% end %>
+              <div class="clear"></div>
+            </li>
+
+          <% end %>
+
+        <% id += 1 %>
+      <% end %>
+
+      </ul>
+    </div> <!-- /BACKTRACE -->
+
+    <% unless bad_request?(exception) %>
+      <div id="get">
+        <h3 id="get-info">GET</h3>
+        <% if req.GET and not req.GET.empty? %>
+          <table class="req">
+            <tr>
+              <th>Variable</th>
+              <th>Value</th>
+            </tr>
+             <% req.GET.sort_by { |k, v| k.to_s }.each { |key, val| %>
+            <tr>
+              <td><%=h key %></td>
+              <td class="code"><div><%=h val.inspect %></div></td>
+            </tr>
+            <% } %>
+          </table>
+        <% else %>
+          <p class="no-data">No GET data.</p>
+        <% end %>
+        <div class="clear"></div>
+      </div> <!-- /GET -->
+
+      <div id="post">
+        <h3 id="post-info">POST</h3>
+        <% if req.POST and not req.POST.empty? %>
+          <table class="req">
+            <tr>
+              <th>Variable</th>
+              <th>Value</th>
+            </tr>
+            <% req.POST.sort_by { |k, v| k.to_s }.each { |key, val| %>
+            <tr>
+              <td><%=h key %></td>
+              <td class="code"><div><%=h val.inspect %></div></td>
+            </tr>
+            <% } %>
+          </table>
+        <% else %>
+          <p class="no-data">No POST data.</p>
+        <% end %>
+        <div class="clear"></div>
+      </div> <!-- /POST -->
+    <% end %>
+
+    <div id="cookies">
+      <h3 id="cookie-info">COOKIES</h3>
+      <% unless req.cookies.empty? %>
+        <table class="req">
+          <tr>
+            <th>Variable</th>
+            <th>Value</th>
+          </tr>
+          <% req.cookies.each { |key, val| %>
+            <tr>
+              <td><%=h key %></td>
+              <td class="code"><div><%=h val.inspect %></div></td>
+            </tr>
+          <% } %>
+        </table>
+      <% else %>
+        <p class="no-data">No cookie data.</p>
+      <% end %>
+      <div class="clear"></div>
+    </div> <!-- /COOKIES -->
+
+    <div id="rack">
+      <h3 id="env-info">Rack ENV</h3>
+      <table class="req">
+        <tr>
+          <th>Variable</th>
+          <th>Value</th>
+        </tr>
+         <% env.sort_by { |k, v| k.to_s }.each { |key, val| %>
+         <tr>
+           <td><%=h key %></td>
+           <td class="code"><div><%=h val %></div></td>
+         </tr>
+         <% } %>
+      </table>
+      <div class="clear"></div>
+    </div> <!-- /RACK ENV -->
+
+    <p id="explanation">
+    You aree seeing this error because you have enabled the
+    <code>show_exceptions</code> setting.
+    </p>
+  </div> <!-- /WRAP -->
+  </body>
+</html>
+    HTML
+  end
+
+end; end

data/lib/cyberweb/base/base.rb

@@ -14,11 +14,13 @@ class Base # === Cyberweb::Base
 
   require 'fileutils'
 
+  require 'cyberweb/base_module/base_module.rb'
+  include Cyberweb::BaseModule
+
   # ========================================================================= #
   # Pull in all constants next.
   # ========================================================================= #
   require 'cyberweb/base/constants.rb'
-
   require 'cyberweb/base/colours.rb'
   require 'cyberweb/base/encoding.rb'
   require 'cyberweb/base/misc.rb'
@@ -34,8 +36,13 @@ class Base # === Cyberweb::Base
   # ========================================================================= #
   # === initialize
   # ========================================================================= #
-  def initialize
+  def initialize(
+      commandline_arguments = ARGV
+    )
     reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
   end
 
 end; end

data/lib/cyberweb/base/colours.rb

@@ -19,11 +19,6 @@ class Base # === Cyberweb::Base
   # ========================================================================= #
   RED = Colours::RED
 
-  # ========================================================================= #
-  # === HOME_DIRECTORY_OF_THE_USER_X
-  # ========================================================================= #
-  HOME_DIRECTORY_OF_THE_USER_X = '/home/x/'
-
   # ========================================================================= #
   # === rev
   # ========================================================================= #
@@ -32,7 +27,7 @@ class Base # === Cyberweb::Base
   end
 
   # ========================================================================= #
-  # === rds
+  # === rds                                                         (rds tag)
   # ========================================================================= #
   def rds(i)
     ::Cyberweb.rds(i)
@@ -52,6 +47,13 @@ class Base # === Cyberweb::Base
     Colours.simp(i)
   end
 
+  # ========================================================================= #
+  # === sdir
+  # ========================================================================= #
+  def sdir(i = '')
+    Colours.sdir(i)
+  end
+
   # ========================================================================= #
   # === sfile
   # ========================================================================= #

data/lib/cyberweb/base/constants.rb

@@ -8,6 +8,9 @@ module Cyberweb
 
 class Base # === Cyberweb::Base
 
+  # ========================================================================= #
+  # Pull in all constants from the base level next:
+  # ========================================================================= #
   require 'cyberweb/constants/constants.rb'
 
   # ========================================================================= #
@@ -15,4 +18,9 @@ class Base # === Cyberweb::Base
   # ========================================================================= #
   NAMESPACE = inspect
 
+  # ========================================================================= #
+  # === HOME_DIRECTORY_OF_THE_USER_X
+  # ========================================================================= #
+  HOME_DIRECTORY_OF_THE_USER_X = '/home/x/'
+
 end; end