RubyGems - Capcode - Versions diffs - 0.1.0 - Mend

Capcode 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (25) hide show

data/AUTHORS +1 -0
data/COPYING +340 -0
data/README +53 -0
data/doc/rdoc/classes/Capcode.html +434 -0
data/doc/rdoc/classes/Capcode/HTTPError.html +125 -0
data/doc/rdoc/classes/Capcode/Helpers.html +214 -0
data/doc/rdoc/classes/Capcode/ParameterError.html +125 -0
data/doc/rdoc/created.rid +1 -0
data/doc/rdoc/files/AUTHORS.html +100 -0
data/doc/rdoc/files/COPYING.html +524 -0
data/doc/rdoc/files/README.html +164 -0
data/doc/rdoc/files/lib/capcode_rb.html +533 -0
data/doc/rdoc/index.html +10 -0
data/doc/rdoc/permalink.gif +0 -0
data/doc/rdoc/rdoc-style.css +106 -0
data/doc/rdoc/rubyfr.png +0 -0
data/examples/blog.log +16 -0
data/examples/blog.rb +62 -0
data/examples/index.html +5 -0
data/examples/sample.rb +61 -0
data/examples/session.rb +47 -0
data/lib/capcode.rb +293 -0
data/lib/capcode/core_ext.rb +15 -0
data/setup.rb +1585 -0
metadata +106 -0

data/doc/rdoc/index.html ADDED

@@ -0,0 +1,10 @@
+<HTML>
+<HEAD>
+<META HTTP-EQUIV="refresh" content="0;URL=files/README.html">
+<TITLE>Capcode, the Documentation</TITLE>
+</HEAD>
+<BODY>
+Click <a href="files/README.html">here</a> to open the docs.
+</BODY>
+</HTML>

data/doc/rdoc/permalink.gif ADDED

Binary file

data/doc/rdoc/rdoc-style.css ADDED

@@ -0,0 +1,106 @@
+    body {
+        font: normal 14px verdana,arial,'Bitstream Vera Sans',helvetica,sans-serif;
+        line-height: 160%;
+        padding: 0; margin: 0;
+        margin-bottom: 30px;
+        /* background-color: #402; */
+        background-color: #CCCC99;
+    }
+    h1, h2, h3, h4 {
+        font-family: Utopia, Georgia, serif;
+        font-weight: bold;
+        letter-spacing: -0.018em;
+    }
+    h1 { font-size: 24px; margin: .15em 1em 0 0 }
+    h2 { font-size: 24px }
+    h3 { font-size: 19px }
+    h4 { font-size: 17px; font-weight: normal; }
+    h4.ruled { border-bottom: solid 1px #CC9; }
+    h2.ruled { padding-top: 35px; border-top: solid 1px #AA5; }
+    /* Link styles */
+    :link, :visited {
+    }
+    :link:hover, :visited:hover {
+    }
+    #fullpage {
+        width: 720px;
+        padding-top: 20px;
+        margin: 0 auto;
+    }
+    .page_shade, .page {
+        border-left: 1px solid black;
+        border-right: 1px solid black;
+        border-bottom: 1px solid black;
+        background-color: #FFFFFF;
+    }
+    .page {
+        padding: 20px 35px;
+    }
+    .page .header {
+        float: right;
+        color: #777;
+        font-size: 10px;
+    }
+    .page h1, .page h2, .page h3 {
+        clear: both;
+        text-align: center;
+    }
+    #pager {
+        background-color: #EEEEAE;
+        border-top: 2px solid black;
+        border-left: 2px solid black;
+        border-right: 2px solid black;
+        border-bottom: 1px dashed #999966;
+        padding: 20px 0 20px 20px;
+        color: #666633;
+        font-size: 11px;
+    }
+    #pager :link, #pager :visited {
+        color: #8E2400;
+        padding: 0px 5px;
+    }
+    #pager :link:hover, #pager :visited:hover {
+        color: #8E2400;
+    }
+    #pagertd {
+      font-size: 11px;
+    }
+    #logo { float: left; }
+    #menu {
+      padding: 4px 12px;
+      margin: 0;
+    }
+    #menu h3 { padding: 0; margin: 0; }
+    #menu #links { float: right; }
+    pre { font-weight: bold; color: black; }
+    tt { color: #703; font-size: 12pt; }
+    .dyn-source {
+      background-color: #EEEEEE;
+      border: 1px solid #CCCCCC;
+      padding: 4px 8px;
+      margin: 0;
+    display: none; }
+    .dyn-source pre  {
+      color: #000000;
+      font-size: 8pt;
+      font-familly: monospace;
+    }
+    .source-link     { text-align: right; font-size: 8pt; }
+    .ruby-comment    { color: black; font-style: italic }
+    .ruby-constant   { color: #123456; font-weight: bold; }
+    .ruby-identifier { color: #005599;  }
+    .ruby-ivar       { color: orange; }
+    .ruby-keyword    { color: red; font-weight: bold }
+    .ruby-node       { color: #FFFFFF; }
+    .ruby-operator   { color: #055005;  }
+    .ruby-regexp     { color: #DDFFDD; }
+    .ruby-value      { color: #FFAAAA; font-style: italic }
+    .kw { color: red; font-weight: bold }
+    .cmt { color: green; font-style: italic }
+    .str { color: #EECCCC; font-style: italic }
+    .re  { color: #EECCCC; }

data/doc/rdoc/rubyfr.png ADDED

Binary file

data/examples/blog.log ADDED

@@ -0,0 +1,16 @@
+# Logfile created on Thu Mar 05 14:37:14 +0100 2009 by /
+::1 - - [05/Mar/2009 14:37:17] "GET / HTTP/1.1" 200 424 0.0134
+::1 - - [05/Mar/2009 14:37:17] "GET /favicon.ico HTTP/1.1" 200 424 0.0076
+::1 - - [05/Mar/2009 14:37:19] "GET /8650ac90-ebb8-012b-4e10-002332b2a7fc/2808417976 HTTP/1.1" 302 - 0.0083
+::1 - - [05/Mar/2009 14:37:19] "GET / HTTP/1.1" 200 246 0.0077
+::1 - - [05/Mar/2009 14:37:20] "GET  HTTP/1.1" 200 280 0.0015
+::1 - - [05/Mar/2009 14:37:45] "POST  HTTP/1.1" 500 101939 0.2057
+::1 - - [05/Mar/2009 14:37:56] "POST  HTTP/1.1" 500 102076 0.1473
+::1 - - [05/Mar/2009 14:37:56] "GET /favicon.ico HTTP/1.1" 200 246 0.0068
+::1 - - [05/Mar/2009 14:37:59] "GET / HTTP/1.1" 200 246 0.0064
+::1 - - [05/Mar/2009 14:38:00] "GET  HTTP/1.1" 200 280 0.0019
+::1 - - [05/Mar/2009 14:38:08] "POST  HTTP/1.1" 302 - 0.0093
+::1 - - [05/Mar/2009 14:38:08] "GET / HTTP/1.1" 200 416 0.0110
+::1 - - [05/Mar/2009 14:38:45] "GET  HTTP/1.1" 200 280 0.0030
+::1 - - [05/Mar/2009 14:39:23] "POST  HTTP/1.1" 500 102140 0.1681
+::1 - - [05/Mar/2009 14:41:01] "GET / HTTP/1.1" 200 416 0.0081

data/examples/blog.rb ADDED

@@ -0,0 +1,62 @@
+$:.unshift( "../lib" )
+require 'rubygems'
+require 'capcode'
+require 'couch_foo'
+CouchFoo::Base.set_database(:host => "http://localhost:5984", :database => "my_blog")
+class Story < CouchFoo::Base
+  property :title, String
+  property :body, String
+  property :date, String
+end
+module Capcode
+  class HTTPError
+    def r404(f)
+      "Pas glop !!! #{f} est inconnu !!!"
+    end
+  end
+  class Index < Route '/'
+    def get
+      r = "<html><body>"
+      story = Story.find( :all )
+      story.each do |s|
+        r += "<h2>#{s.title}</h2><small>#{s.date} - <a href='#{URL( Remove, s.id, s.rev )}'>Delete this entry</a></small><p>#{s.body}</p>"
+      end
+      r+"<hr /><a href='#{URL(Add)}'>Add a new entry</a></body></html>"
+    end
+  end
+  class Remove < Route '/remove/([^\/]*)/(.*)'
+    def get( id, rev )
+      Story.delete(id, rev)
+      redirect( Index )
+    end
+  end
+  class Add < Route '/add'
+    def get
+      '
+        <html><body>
+          <h1>Add a new entry</h1>
+          <form method="POST">
+            Titre : <input type="text" name="title"><br />
+            <textarea name="body"></textarea><br />
+            <input type="submit">
+          </form>
+        </body></html>
+      '
+    end
+    def post
+      Story.create( :title => params['title'], :body => params['body'], :date => Time.now.to_s )
+      redirect( Index )
+    end
+  end
+end
+Capcode.run( :port => 3001, :host => "localhost", :log => "blog.log" )

data/examples/index.html ADDED

@@ -0,0 +1,5 @@
+<html>
+<body>
+<h1>Capcode hello !</h1>
+</body>
+</html>

data/examples/sample.rb ADDED

@@ -0,0 +1,61 @@
+$:.unshift( "../lib" )
+require 'capcode'
+module Capcode
+  module Helpers
+    def bold( &b )
+      "<b>"+yield+"</b>"
+    end
+  end
+end
+module Capcode
+  class HTTPError
+    def r404(f)
+      "Pas glop !!! #{f} est inconnu !!!"
+    end
+  end
+  class Hello < Route '/hello/(.*)'
+    def get( you )
+      you = "you" if you.nil?
+      session = { :user => you }
+      "Hello " + bold { you } + " it's '#{Time.now} !"
+    end
+  end
+  class Redir < Route '/r'
+    def get
+      redirect( Hello, "Greg" )
+    end
+  end
+  class Glop < Route '/glop/(.*)', '/glop/code/([^\/]*)/(.*)'
+    def get( r, v )
+      "Glop receive #{r}, type #{r.class} and #{v}, type #{v.class} from #{URL(Glop)}"
+    end
+  end
+  class Js < Route '/toto'
+    def get
+      json( { :some => 'json', :stuff => ['here'] } )
+    end
+  end
+  class Env < Route '/env'
+    def get
+      x = env.map do |k,v|
+        "#{k} => #{v}"
+      end.join( "<br />\n" )
+      x
+    end
+  end
+end
+Capcode.map( "/file" ) do
+  Rack::File.new( "." )
+end
+Capcode.run( :port => 3001, :host => "localhost" )

data/examples/session.rb ADDED

@@ -0,0 +1,47 @@
+$:.unshift( "../lib" )
+require 'capcode'
+module Capcode
+  class HTTPError
+    def r404(f)
+      "#{f} not found !!!"
+    end
+  end
+  class Index < Route '/'
+    def get
+      redirect( Hello, session[:user] )
+    end
+  end
+  class Hello < Route '/hello/(.*)'
+    def get( you )
+      if you.nil?
+        redirect( WhoAreYou )
+      else
+        "
+          Hello #{you}<br />
+          Clic <a href='#{URL(Hello)}'>here</a> if hou want to change your name
+        "
+      end
+    end
+  end
+  class WhoAreYou < Route '/who_are_you'
+    def get
+      '
+        Please, enter your name :<br />
+        <form method="POST">
+          <input type="text", name="user"><br />
+          <input type="submit">
+        </form>
+      '
+    end
+    def post
+      session[:user] = params['user']
+      redirect( Index )
+    end
+  end
+end
+Capcode.run( :port => 3000, :host => "localhost" )

data/lib/capcode.rb ADDED

@@ -0,0 +1,293 @@
+require 'rubygems'
+require 'rack'
+require 'json'
+require 'logger'
+require 'capcode/core_ext'
+module Capcode
+  CAPCOD_VERION="0.2.0"
+  @@__ROUTES = {}
+  class ParameterError < ArgumentError
+  end
+  # Helpers contains methods available in your controllers
+  module Helpers
+    # Help you to return a JSON response
+    #
+    #   module Capcode
+    #     class JsonResponse < Route '/json/([^\/]*)/(.*)'
+    #       def get( arg1, arg2 )
+    #         json( { :1 => arg1, :2 => arg2 })
+    #       end
+    #     end
+    #   end
+    def json( d )
+      @response['Content-Type'] = 'application/json'
+      d.to_json
+    end
+    # Send a redirect response
+    #
+    #   module Capcode
+    #     class Hello < Route '/hello/(.*)'
+    #       def get( you )
+    #         if you.nil?
+    #           redirect( WhoAreYou )
+    #         else
+    #           ...
+    #         end
+    #       end
+    #     end
+    #   end
+    def redirect( klass, *a )
+      [302, {'Location' => URL(klass, *a)}, '']
+    end
+    # Builds an URL route to a controller or a path
+    #
+    # if you declare the controller Hello :
+    #
+    #   module Capcode
+    #     class Hello < Route '/hello/(.*)'
+    #       ...
+    #     end
+    #   end
+    #
+    # then
+    #
+    #   URL( Hello, "you" ) # => /hello/you
+    def URL( klass, *a )
+      path = nil
+      a = a.delete_if{ |x| x.nil? }
+      if klass.class == Class
+        Capcode.routes.each do |p, k|
+          path = p if k.class == klass
+        end
+      else
+        path = klass
+      end
+      path+((a.size>0)?("/"+a.join("/")):(""))
+    end
+  end
+  include Rack
+  # HTTPError help you to create your own 404, 500 and/or 501 response
+  #
+  # To create a custom 404 reponse, create a fonction HTTPError.r404 in
+  # your application :
+  #
+  #   module Capcode
+  #     class HTTPError
+  #       def r404(f)
+  #         "#{f} not found :("
+  #       end
+  #     end
+  #   end
+  #
+  # Do the same (r500 and r501) to customize 500 and 501 errors
+  class HTTPError
+    def initialize(app)#:nodoc:
+      @app = app
+    end
+    def call(env) #:nodoc:
+      status, headers, body = @app.call(env)
+      if self.methods.include? "r#{status}"
+        body = self.call "r#{status}", env['REQUEST_PATH']
+        headers['Content-Length'] = body.length.to_s
+      end
+      [status, headers, body]
+    end
+  end
+  class << self
+    # Add routes to a controller class
+    #
+    #   module Capcode
+    #     class Hello < Route '/hello/(.*)', '/hello/([^#]*)#(.*)'
+    #       def get( arg1, arg2 )
+    #         ...
+    #       end
+    #     end
+    #   end
+    #
+    # In the <tt>get</tt> method, you will receive the maximum of parameters declared
+    # by the routes. In this example, you will receive 2 parameters. So if you
+    # go to <tt>/hello/world#friend</tt> then <tt>arg1</tt> will be set to <tt>world</tt> and <tt>arg2</tt>
+    # will be set to <tt>friend</tt>. Now if you go to <tt>/hello/you</tt>, then <tt>arg1</tt> will
+    # be set to <tt>you</tt> and <tt>arg2</tt> will be set to <tt>nil</tt>
+    #
+    # If the regexp in the route does not match, all arguments will be <tt>nil</tt>
+    def Route *u
+      Class.new {
+        meta_def(:__urls__){
+          # < Route '/hello/world/([^\/]*)/id(\d*)', '/hello/(.*)'
+          # # => [ {'/hello/world' => '([^\/]*)/id(\d*)', '/hello' => '(.*)'}, 2, <Capcode::Klass> ]
+          h = {}
+          max = 0
+          u.each do |_u|
+            m = /\/([^\/]*\(.*)/.match( _u )
+            if m.nil?
+              h[_u] = ''
+            else
+              h[m.pre_match] = m.captures[0]
+              max = Regexp.new(m.captures[0]).number_of_captures if max < Regexp.new(m.captures[0]).number_of_captures
+            end
+          end
+          [h, max, self]
+        }
+        # Hash containing all the request parameters (GET or POST)
+        def params
+          @request.params
+        end
+        # Hash containing all the environment variables
+        def env
+          @env
+        end
+        # Hash session
+        def session
+          @env['rack.session']
+        end
+        # Return the Rack::Request object
+        def request
+          @request
+        end
+        # Return the Rack::Response object
+        def response
+          @response
+        end
+        def call( e ) #:nodoc:
+          @env = e
+          @response = Rack::Response.new
+          @request = Rack::Request.new(@env)
+          r = case @env["REQUEST_METHOD"]
+            when "GET"
+              sc = @request.script_name
+              sc = "/" if sc.size == 0
+              regexp = Regexp.new( self.class.__urls__[0][sc] )
+              nargs = self.class.__urls__[1]
+              args = regexp.match( Rack::Utils.unescape(@request.path_info).gsub( /^\//, "" ) )
+              if args.nil?
+                raise Capcode::ParameterError, "Path info `#{@request.path_info}' does not match route regexp `#{regexp.source}'"
+              else
+                args = args.captures
+              end
+              while args.size < nargs
+                args << nil
+              end
+              get( *args )
+            when "POST"
+              post
+          end
+          if r.respond_to?(:to_ary)
+            @response.status = r[0]
+            r[1].each do |k,v|
+              @response[k] = v
+            end
+            @response.body = r[2]
+          else
+            @response.write r
+          end
+          @response.finish
+        end
+        include Capcode::Helpers
+      }
+    end
+    # This method help you to map and URL to a Rack or What you want Helper
+    #
+    #   Capcode.map( "/file" ) do
+    #     Rack::File.new( "." )
+    #   end
+    def map( r, &b )
+      @@__ROUTES[r] = yield
+    end
+    # Start your application.
+    #
+    # Options :
+    # * <tt>:port</tt> = Listen port
+    # * <tt>:host</tt> = Listen host
+    # * <tt>:server</tt> = Server type (webrick or mongrel)
+    # * <tt>:log</tt> = Output logfile (default: STDOUT)
+    # * <tt>:session</tt> = Session parameters. See Rack::Session for more informations
+    def run( args = {} )
+      conf = {
+        :port => args[:port]||3000,
+        :host => args[:host]||"localhost",
+        :server => args[:server]||nil,
+        :log => args[:log]||$stdout,
+        :session => args[:session]||{}
+      }
+      # Check that mongrel exists
+      if conf[:server].nil? || conf[:server] == "mongrel"
+        begin
+          require 'mongrel'
+          conf[:server] = "mongrel"
+        rescue LoadError
+          puts "!! could not load mongrel. Falling back to webrick."
+          conf[:server] = "webrick"
+        end
+      end
+      Capcode.constants.each do |k|
+        begin
+          if eval "Capcode::#{k}.public_methods(true).include?( '__urls__' )"
+            u, m, c = eval "Capcode::#{k}.__urls__"
+            u.keys.each do |_u|
+              @@__ROUTES[_u] = c.new
+            end
+          end
+        rescue => e
+          raise e.message
+        end
+      end
+      app = Rack::URLMap.new(@@__ROUTES)
+      app = Rack::Session::Cookie.new( app, conf[:session] )
+      app = Capcode::HTTPError.new(app)
+      app = Rack::ContentLength.new(app)
+      app = Rack::Lint.new(app)
+      app = Rack::ShowExceptions.new(app)
+#      app = Rack::Reloader.new(app) ## -- NE RELOAD QUE capcode.rb -- So !!!
+      app = Rack::CommonLogger.new( app, Logger.new(conf[:log]) )
+      case conf[:server]
+      when "mongrel"
+        puts "** Starting Mongrel on #{conf[:host]}:#{conf[:port]}"
+        Rack::Handler::Mongrel.run( app, {:Port => conf[:port], :Host => conf[:host]} ) { |server|
+          trap "SIGINT", proc { server.stop }
+        }
+      when "webrick"
+        puts "** Starting WEBrick on #{conf[:host]}:#{conf[:port]}"
+        Rack::Handler::WEBrick.run( app, {:Port => conf[:port], :BindAddress => conf[:host]} ) { |server|
+          trap "SIGINT", proc { server.shutdown }
+        }
+      end
+    end
+    def routes #:nodoc:
+      @@__ROUTES
+    end
+  end
+end