cuca 0.07 → 0.12

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2642f8b68bb957ae09ac2c04c73533bb3812d15a
+  data.tar.gz: 13ddcc6f74af2fc5efb19c513caabc89eb9256c1
+SHA512:
+  metadata.gz: 5d2e104a1abbb3a428c34c20cf10b5fe6618c159fd855829466f84123e6b63211536acc4e081d2892aa60552651346f00330cded2c37121ac9fd8e592289eccb
+  data.tar.gz: 4b4e8e0d019ffd3290805571faef4bbe3f34af5494972bde6f4d5fc12cfb123d22390f70c6d0e5dd825ac9b80feaeae037dabce54bd9ba430be4f8f8572462f7

data/CHANGELOG

@@ -1,3 +1,13 @@
+* 2014/12/31 - 0.11
+   - Few fixes & cleanup
+   - Ruby 2.1.0 support
+
+* 2013/xx/xx - 0.10
+   - Ruby 1.9 support
+   - functional tests
+
+* 2009 - 2013 ... big gap of changes done without publishing anything... ;)
+
 * 2009/xx/xx - 0.07
    - 'stop' option :cancel_execution added. This can be raised in before filters
      and will avoid that the run/get/post... methods are called.

data/README.md

@@ -0,0 +1,51 @@
+# Cuca - a web application framework
+
+Cuca is another web application framework written in Ruby. It's made to
+build applications with focus on functionality - less design. You can
+create and application without writing HTML. Once written Widgets
+(a smart screen element) can be reused thorough your project with 
+minimum effort allowing to build fast and secure web applications.
+
+It implements the following concepts:
+* A Widget is a screen element. Can be a full page or part of it.
+   The Controller and the Layout are Widgets, too.
+* A Controller deals with one request URI (get, post or both) and can set variables
+   other widgets can make use of. It can also define a Layout and filters.
+* A Layout wraps the output of a controller and finally return the
+   built web page.
+* A Generator (NOT "code generator") can be used within any Widget to help building the web content.
+   Cuca comes with a Markaby and eruby Generator.
+* A Session can used optionally to keep stateful data.
+
+Cuca was written for internal use in 2008 and as per 2013 we keep using and improving it.
+
+### It implements the following concepts:
+* A Widget is a screen element. Can be a full page or part of it.
+  The Controller and the Layout are Widgets, too.
+* A Controller deals with one request URI (get, post or both) and can set variables
+  other widgets can make use of. It can also define a Layout and filters.
+* A Layout wraps the output of a controller and finally return the
+  built web page.
+* A Generator (NOT "code generator") can be used within any Widget to help building the web content.
+ Cuca comes with a Markaby and eruby Generator.
+* A Session can used optionally to keep stateful data.
+
+## Installation & Getting started
+
+ Download and install from the internet:
+
+    gem install --remote cuca
+
+## Create an application skeleton:
+
+    cuca my_project		# this will create a new project
+    cd my_project
+    ruby ./script/server-webrick.rb
+
+  Open http://localhost:2000/
+
+
+## Read on
+
+  Check the rdoc once installed
+

data/application_skeleton/app/test.rb

@@ -0,0 +1,16 @@
+
+
+class TestController < ApplicationController
+
+def get
+  @_content = 'GET: '
+  @_content << query_parameters.inspect
+end
+
+def post
+  @_content = "POST: "
+  @_content << request_parameters.inspect
+end
+
+end
+

data/application_skeleton/conf/config.rb

@@ -24,6 +24,9 @@ Cuca::App.configure do |config|
   ### in lower levels of your directory layout.
   config.include_directories = %w{_controllers _layouts _models _widgets}
 
+  # How to name the controller class in a file (make sure this matches include_directories if you want autoload
+  # config.controller_naming = lambda { |f| f.capitalize+"Controller" }  # <= the default
+
   ### This would be an autoload configuration
   # config.include_directories = [
   #    { :dir => '_controllers', :class_naming => lambda { |f| f.capitalize+'Controller' } },
@@ -42,7 +45,11 @@ Cuca::App.configure do |config|
 
   ### the view generator will look for external templates here:
   # config.view_directory = 'app/_views'	
-
+  
+  ### Force encoding of views to this one, if undefined default external
+  ### encoding will be used. Encoding name must be accepted by Ruby Encoding class
+  # config.view_encoding = 'UTF-8'
+  
   ### 404 (file not found) and 500 system error page (relative to the public folder)
   # config.http_404 = '404.html'
   # config.http_500 = '500.html'

data/application_skeleton/public/dispatch-fwdev.cgi

@@ -1,5 +1,7 @@
-#!/usr/bin/ruby1.9.1
+#!/usr/bin/env ruby
 
+
+### Define framework path
 FRAMEWORK_PATH = '/home/bones/workspace/cuca_svn/cuca/lib'
 
 $cuca_path = File.dirname(__FILE__)+"/../"

data/application_skeleton/public/dispatch.cgi

@@ -1,4 +1,4 @@
-#!/usr/bin/ruby1.9
+#!/usr/bin/env ruby
 
 $cuca_path = File.dirname(__FILE__)+"/../"
 

data/application_skeleton/public/dispatch.fcgi

@@ -1,4 +1,4 @@
-#!/usr/bin/ruby
+#!/usr/bin/env ruby
 
 
 $cuca_path = File.dirname(__FILE__)+"/../"

data/application_skeleton/scripts/server-lighttpd-fcgi.rb

@@ -1,13 +1,52 @@
-#!/usr/bin/ruby
+#!/usr/bin/env ruby
+#
+# This will create a simple FastCGI lighttpd config file and run against the cuca application
+#
+
+require 'ostruct'
+require 'optparse'
+
+options = OpenStruct.new
+options.dispatcher = 'dispatch.fcgi'
+options.port       = 2000
+options.lighttpd   = 'lighttpd'
+
+op = OptionParser.new do |opts|
+	opts.banner = "Usage: server-lighttpd-fcgi.rb [options]"
+	opts.on("-pPORT", "--port=NAME", "TCP Port to listen on (2000)") do |x|
+		options.port = x
+	end
+
+	opts.on("-lPROGRAM", "--lighttpd=PROGRAM", "The lighttpd binary (/usr/sbin/lighttpd)") do |d|
+		options.lighttpd = d
+	end
+
+	opts.on("-dDISPATCHER", "--dispatcher=DISPATCHER", "The cgi program in public/ directory (dispatch.cgi)") do |d|
+		options.dispatcher = d
+	end
+	opts.on("-h", "--help", "Help") do 
+		puts opts 
+		exit 0
+	end
+end.parse!(ARGV)
+
+
+cuca_path = File.expand_path(File.dirname(__FILE__))+"/../"
+
+if !File.exist?(cuca_path + "/public/" + options.dispatcher) then
+   STDERR.puts "Can't find dispatcher #{options.dispatcher} in public directory, use -d"
+   exit 1
+end
+
 
 cuca_path = File.expand_path(File.dirname(__FILE__)+"/../")
 document_root = "#{cuca_path}/public/"
 error_log = "#{cuca_path}/log/error.log"
 access_log = "#{cuca_path}/log/access.log"
 pid_file = '/tmp/lighttpd.pid'
-dispatcher = "dispatch.fcgi"
-server_port = 2000
-server_program = "/usr/sbin/lighttpd"
+dispatcher = options.dispatcher
+server_port = options.port
+server_program = options.lighttpd
 
 config = <<-EOF
 

data/application_skeleton/scripts/server-lighttpd.rb

@@ -1,12 +1,65 @@
-#!/usr/bin/ruby
+#!/usr/bin/env ruby
+#
+# This will create a simple CGI lighttpd config file and run against the cuca application
+#
+# Takes one optional argument the full path the the ruby interpreter to use
+#
+
+require 'ostruct'
+require 'optparse'
+
+options = OpenStruct.new
+options.ruby_interpreter = '/usr/bin/ruby'
+options.dispatcher = 'dispatch.cgi'
+options.port       = 2000
+options.lighttpd   = 'lighttpd'
+
+op = OptionParser.new do |opts|
+	opts.banner = "Usage: server-lighttpd.rb [options]"
+	opts.on("-pPORT", "--port=NAME", "TCP Port to listen on (2000)") do |x|
+		options.port = x
+	end
+	opts.on("-iRUBY", "--interpreter=RUBY", "The ruby binary (/usr/bin/ruby)") do |d|
+		options.ruby_interpreter = d
+	end
+	opts.on("-lPROGRAM", "--lighttpd=PROGRAM", "The lighttpd binary (/usr/sbin/lighttpd)") do |d|
+		options.lighttpd = d
+	end
+
+	opts.on("-dDISPATCHER", "--dispatcher=DISPATCHER", "The cgi program in public/ directory (dispatch.cgi)") do |d|
+		options.dispatcher = d
+	end
+	opts.on("-h", "--help", "Help") do 
+		puts opts 
+		exit 0
+	end
+end.parse!(ARGV)
+
+
+if !File.exist?(options.ruby_interpreter) then
+   STDERR.puts "Can't find ruby interpreter, use -i"
+   exit 1
+end
+
+#if !File.exist?(options.lighttpd) then
+#   STDERR.puts "Can't find lighttpd binary use -l"
+#   exit 1
+#end
 
 cuca_path = File.expand_path(File.dirname(__FILE__))+"/../"
+
+if !File.exist?(cuca_path + "/public/" + options.dispatcher) then
+   STDERR.puts "Can't find dispatcher #{options.dispatcher} in public directory, use -d"
+   exit 1
+end
+
+
 document_root = "#{cuca_path}/public/"
 error_log = "#{cuca_path}/log/error.log"
 access_log = "#{cuca_path}/log/access.log"
 pid_file = '/tmp/lighttpd.pid'
-server_program = "/usr/sbin/lighttpd"
-server_port = 2000
+server_program = options.lighttpd
+server_port = options.port
 
 config = <<-EOF
 
@@ -17,7 +70,7 @@ server.modules              = (
 	    "mod_cgi"
  )
 
-cgi.assign = ( ".cgi" => "/usr/bin/ruby" )
+cgi.assign = ( ".cgi" => "#{options.ruby_interpreter}" )
 
 server.document-root       = "#{document_root}"
 
@@ -25,7 +78,7 @@ server.port = #{server_port}
 
 server.errorlog            = "#{error_log}"
 
-server.error-handler-404 = "/dispatch.cgi"
+server.error-handler-404 = "/#{options.dispatcher}"
 # server.error-handler-404 = "/error-404.html"
 
 index-file.names           = ( "index.html" )

data/application_skeleton/scripts/server-webrick.rb

@@ -20,7 +20,7 @@ class CucaHandler < WEBrick::HTTPServlet::CGIHandler
 end
 
 server = WEBrick::HTTPServer.new(:Port => 2000)
-server.mount("/", CucaHandler, File.expand_path(File.dirname(__FILE__))+"/../public/dispatch-fwdev.cgi")
+server.mount("/", CucaHandler, File.expand_path(File.dirname(__FILE__))+"/../public/dispatch.cgi")
 
 trap("INT"){ server.shutdown }
 server.start

data/application_skeleton/tests/functional/basic.rb

@@ -0,0 +1,32 @@
+require 'rubygems'
+
+$cuca_path = File.dirname(__FILE__)+"/../../"
+
+require 'cuca'
+require 'cuca/test/helpers'
+
+class TC_TestWidget  < Test::Unit::TestCase
+ 
+ include Cuca::Test::Helpers
+
+ def test_index
+#   x = get('/index', { :test => 'me' })
+#   puts x.inspect
+   
+#   x = get('/test')
+#   puts x.inspect
+   
+   x = post('/test')
+   puts x.inspect
+   puts
+   puts
+   x = post('/test', { :post_var => 'post_value' } )
+   puts x.inspect
+   puts
+   puts
+   
+
+ end
+
+end
+

data/bin/cuca

@@ -3,7 +3,11 @@
 # This is a simple script to install the cuca application skeleton
 # provided by the cuca gems.
 #
-require 'ftools'
+begin 
+  require 'ftools'
+rescue LoadError
+end
+
 require 'fileutils'
 
 if ARGV.size == 0 then
@@ -29,12 +33,12 @@ Dir.glob("#{framework_path}/**/*").each do |file|
 
  if File.directory?(file) then
    puts "(mkdir)   #{fname}"
-   File.makedirs(dname)
+   FileUtils.mkdir_p(dname)
    next
  end
 
  puts "(install) #{fname}"
- File.install(file, dname)
+ FileUtils.install(file, dname)
 
  if fname.include?('/scripts/server') || fname.include?('/public/dispatch') || fname.include?('/scripts/console') then
   puts "(chmod)    #{fname} (755)"

data/lib/cuca.rb

@@ -19,7 +19,7 @@ end
 def init_save_require(filename)
  begin 
    require filename
- rescue  => e
+ rescue  LoadError => e
    title = "INIT Error [#{filename}]: #{e}"
    $stderr.puts title
    err = ''

data/lib/cuca/app.rb

@@ -5,7 +5,7 @@ require 'cuca/config'
 def cuca_register_autoload(object, file)
  autoload(object, file)
 end
- 
+
 
 module Cuca
 
@@ -21,16 +21,24 @@ class Sandbox
    controller_class = mod::const_get(controller_class_name)
    controller = controller_class.send(:new, :assigns=>assigns)
    $controller_object = controller
-   
-   controller.run_before_filters
 
+   controller.run_before_filters
 
-   controller.send('_do'.intern, 'run', subcall)
    case request_method
-       when 'POST' 
+       when 'POST'
+            controller.send('_do'.intern, 'run', subcall)
             controller.send('_do'.intern, 'post', subcall)
-       when 'GET' 
+       when 'GET'
+            controller.send('_do'.intern, 'run', subcall)
             controller.send('_do'.intern, 'get', subcall)
+       when 'PUT'
+            controller.send('_do'.intern, 'put', subcall)
+       when 'PATCH'
+            controller.send('_do'.intern, 'patch', subcall)
+       when 'HEAD'
+            controller.send('_do'.intern, 'head', subcall)
+       when 'DELETE'
+             controller.send('_do'.intern, 'delete', subcall)
    end
 
    controller.run_after_filters
@@ -40,11 +48,11 @@ class Sandbox
 end
 
 # == Cuca Application
-# 
-# A Cuca::App object will be created directly by the dispatcher - which again is the 
+#
+# A Cuca::App object will be created directly by the dispatcher - which again is the
 # direct cgi or fastcgi script that get run by the webserver.
-# Normally you just create a Cuca::App object and run the cgicall method with optional with 
-# a cgi object as paramenter. 
+# Normally you just create a Cuca::App object and run the cgicall method with optional with
+# a cgi object as paramenter.
 # Before doing that you must set $cuca_path to the root of your application directory structure.
 class App
 
@@ -72,7 +80,7 @@ class App
    @public_path.freeze
    @log_path.freeze
    @logger      = Logger.new("#{@log_path}/messages")
-   @logger.level = App::config['logger_level'] || Logger::WARN
+   @logger.level = App.config['log_level'] || Logger::WARN
  end
 
 
@@ -82,7 +90,7 @@ class App
  private
  def init_call(path_info)
    require 'cuca/urlmap'
-   
+
    begin
      @urlmap = URLMap.new(@app_path, path_info)
 
@@ -91,7 +99,7 @@ class App
       return
    end
  end
- 
+
  # will do a 'require' on all .rb files in path
  private
  def include_files(path)
@@ -131,13 +139,13 @@ class App
  def all_support_directories(path_tree)
    path_tree.each do |t|
        (App::config['include_directories'] || []).each do |id|
-          if id.instance_of?(Hash) then 
+          if id.instance_of?(Hash) then
               yield "#{t}/#{id[:dir]}", id[:class_naming]
-          else 
+          else
 	      yield "#{t}/#{id}", nil
           end
        end
-   end  
+   end
  end
 
  public
@@ -147,7 +155,7 @@ class App
         autoload_files(dir, proc)
      else
         include_files(dir)
-     end   
+     end
    end
  end
 
@@ -176,7 +184,7 @@ class App
  public
  def cgicall(cgi = nil)
   @cgi = cgi || CGI.new
-  
+
   #
   # 1st priority: Serve a file if it exists in the 'public' folder
   #
@@ -224,8 +232,12 @@ class App
   load_support_files(@urlmap)
 
   # 4th: Now let's run the actual page script code
-  controller_class_name = @urlmap.action.capitalize+"Controller"
-  
+  if Cuca::App.config['controller_naming'] then
+    controller_class_name = Cuca::App.config['controller_naming'].call(@urlmap.action)
+  else
+    controller_class_name = @urlmap.action.capitalize+"Controller"
+  end
+
   # Clear all hints
   Widget::clear_hints()
 
@@ -237,13 +249,13 @@ class App
   begin
      # load controller
      begin
-        controller_module.module_eval(File.open(script).read, script)  unless \
+        controller_module.module_eval(File.read(script), script)  unless \
                     controller_module.const_defined?(controller_class_name.intern)
-     rescue SyntaxError => e
-          err = get_error("Load Error", e, 
+     rescue SyntaxError,LoadError => e
+          err = get_error("Can not load script", e,
           Cuca::App.config['display_errors'], Cuca::App.config['http_500'])
           @cgi.out('status' => 'SERVER_ERROR') { err }
-          return                    
+          return
      end
 
      # Catch a common user error
@@ -252,12 +264,13 @@ class App
 
 
      # run controller
-     (status, mime, content, headers) = Sandbox.run(controller_class_name, 
-                           @urlmap.action_module, @urlmap.assigns, 
+     (status, mime, content, headers) = Sandbox.run(controller_class_name,
+                           @urlmap.action_module, @urlmap.assigns,
                            @cgi.request_method, @urlmap.subcall)
 
      logger.debug "CGICall OK: #{status}/#{mime}"
-     
+
+
      @cgi.out(headers.merge( { 'type' => mime, 'status' => status} )) {content}
 
   rescue SyntaxError => e
@@ -267,7 +280,7 @@ class App
 
       logger.info "CGICall Syntax Error"
       return
-     
+
 
   rescue Cuca::ApplicationException => e
       err = get_error("Application Error", e,
@@ -278,13 +291,13 @@ class App
       return
 
   rescue => e
-      err = get_error("System Error", e, 
+      err = get_error("System Error", e,
               Cuca::App.config['display_errors'], Cuca::App.config['http_500'])
       @cgi.out('status' => 'SERVER_ERROR') { err }
 
       logger.info "CGICall System Error"
-      return 
- 
+      return
+
   end
  end