RubyGems - ramaze - Versions diffs - 0.0.6 - Mend

ramaze 0.0.6

Files changed (174) hide show

data/Rakefile +360 -0
data/bin/ramaze +152 -0
data/doc/CHANGELOG +2021 -0
data/doc/COPYING +56 -0
data/doc/COPYING.ja +51 -0
data/doc/README +275 -0
data/doc/TODO +33 -0
data/doc/allison/LICENSE +184 -0
data/doc/allison/README +37 -0
data/doc/allison/allison.css +300 -0
data/doc/allison/allison.gif +0 -0
data/doc/allison/allison.js +307 -0
data/doc/allison/allison.rb +287 -0
data/doc/allison/cache/BODY +588 -0
data/doc/allison/cache/CLASS_INDEX +4 -0
data/doc/allison/cache/CLASS_PAGE +1 -0
data/doc/allison/cache/FILE_INDEX +4 -0
data/doc/allison/cache/FILE_PAGE +1 -0
data/doc/allison/cache/FONTS +1 -0
data/doc/allison/cache/FR_INDEX_BODY +1 -0
data/doc/allison/cache/IMGPATH +1 -0
data/doc/allison/cache/INDEX +1 -0
data/doc/allison/cache/JAVASCRIPT +307 -0
data/doc/allison/cache/METHOD_INDEX +4 -0
data/doc/allison/cache/METHOD_LIST +1 -0
data/doc/allison/cache/SRC_PAGE +1 -0
data/doc/allison/cache/STYLE +322 -0
data/doc/allison/cache/URL +1 -0
data/examples/blog/main.rb +16 -0
data/examples/blog/public/screen.css +106 -0
data/examples/blog/src/controller.rb +50 -0
data/examples/blog/src/element.rb +53 -0
data/examples/blog/src/model.rb +29 -0
data/examples/blog/template/edit.xhtml +6 -0
data/examples/blog/template/index.xhtml +24 -0
data/examples/blog/template/new.xhtml +5 -0
data/examples/blog/template/view.xhtml +15 -0
data/examples/blog/test/tc_entry.rb +18 -0
data/examples/caching.rb +23 -0
data/examples/element.rb +40 -0
data/examples/hello.rb +23 -0
data/examples/simple.rb +60 -0
data/examples/templates/template/external.haml +21 -0
data/examples/templates/template/external.liquid +28 -0
data/examples/templates/template/external.mab +27 -0
data/examples/templates/template/external.rhtml +29 -0
data/examples/templates/template/external.rmze +24 -0
data/examples/templates/template_erubis.rb +50 -0
data/examples/templates/template_haml.rb +48 -0
data/examples/templates/template_liquid.rb +64 -0
data/examples/templates/template_markaby.rb +52 -0
data/examples/templates/template_ramaze.rb +49 -0
data/examples/whywiki/main.rb +56 -0
data/examples/whywiki/template/edit.xhtml +14 -0
data/examples/whywiki/template/show.xhtml +17 -0
data/lib/proto/conf/benchmark.yaml +35 -0
data/lib/proto/conf/debug.yaml +34 -0
data/lib/proto/conf/live.yaml +33 -0
data/lib/proto/conf/silent.yaml +31 -0
data/lib/proto/conf/stage.yaml +33 -0
data/lib/proto/main.rb +18 -0
data/lib/proto/public/404.jpg +0 -0
data/lib/proto/public/css/coderay.css +105 -0
data/lib/proto/public/css/ramaze_error.css +42 -0
data/lib/proto/public/error.xhtml +74 -0
data/lib/proto/public/favicon.ico +0 -0
data/lib/proto/public/js/jquery.js +1923 -0
data/lib/proto/public/ramaze.png +0 -0
data/lib/proto/src/controller/main.rb +7 -0
data/lib/proto/src/element/page.rb +16 -0
data/lib/proto/src/model.rb +5 -0
data/lib/proto/template/index.xhtml +6 -0
data/lib/ramaze.rb +317 -0
data/lib/ramaze/adapter/mongrel.rb +111 -0
data/lib/ramaze/adapter/webrick.rb +161 -0
data/lib/ramaze/cache.rb +11 -0
data/lib/ramaze/cache/memcached.rb +52 -0
data/lib/ramaze/cache/memory.rb +6 -0
data/lib/ramaze/cache/yaml_store.rb +37 -0
data/lib/ramaze/controller.rb +10 -0
data/lib/ramaze/dispatcher.rb +315 -0
data/lib/ramaze/error.rb +11 -0
data/lib/ramaze/gestalt.rb +108 -0
data/lib/ramaze/global.rb +120 -0
data/lib/ramaze/helper.rb +32 -0
data/lib/ramaze/helper/aspect.rb +189 -0
data/lib/ramaze/helper/auth.rb +120 -0
data/lib/ramaze/helper/cache.rb +52 -0
data/lib/ramaze/helper/feed.rb +135 -0
data/lib/ramaze/helper/form.rb +204 -0
data/lib/ramaze/helper/link.rb +80 -0
data/lib/ramaze/helper/redirect.rb +48 -0
data/lib/ramaze/helper/stack.rb +67 -0
data/lib/ramaze/http_status.rb +66 -0
data/lib/ramaze/inform.rb +166 -0
data/lib/ramaze/snippets.rb +5 -0
data/lib/ramaze/snippets/hash/keys_to_sym.rb +19 -0
data/lib/ramaze/snippets/kernel/aquire.rb +22 -0
data/lib/ramaze/snippets/kernel/autoreload.rb +79 -0
data/lib/ramaze/snippets/kernel/caller_lines.rb +58 -0
data/lib/ramaze/snippets/kernel/constant.rb +24 -0
data/lib/ramaze/snippets/kernel/rescue_require.rb +12 -0
data/lib/ramaze/snippets/kernel/self_method.rb +41 -0
data/lib/ramaze/snippets/kernel/silently.rb +13 -0
data/lib/ramaze/snippets/object/traits.rb +60 -0
data/lib/ramaze/snippets/openstruct/temp.rb +10 -0
data/lib/ramaze/snippets/string/DIVIDE.rb +16 -0
data/lib/ramaze/snippets/string/camel_case.rb +14 -0
data/lib/ramaze/snippets/string/snake_case.rb +12 -0
data/lib/ramaze/snippets/symbol/to_proc.rb +14 -0
data/lib/ramaze/snippets/thread/deadQUESTIONMARK.rb +11 -0
data/lib/ramaze/store/default.rb +48 -0
data/lib/ramaze/template.rb +102 -0
data/lib/ramaze/template/amrita2.rb +40 -0
data/lib/ramaze/template/erubis.rb +58 -0
data/lib/ramaze/template/haml.rb +65 -0
data/lib/ramaze/template/haml/actionview_stub.rb +20 -0
data/lib/ramaze/template/liquid.rb +74 -0
data/lib/ramaze/template/markaby.rb +68 -0
data/lib/ramaze/template/ramaze.rb +177 -0
data/lib/ramaze/template/ramaze/element.rb +166 -0
data/lib/ramaze/template/ramaze/morpher.rb +156 -0
data/lib/ramaze/tool/create.rb +70 -0
data/lib/ramaze/tool/tidy.rb +71 -0
data/lib/ramaze/trinity.rb +38 -0
data/lib/ramaze/trinity/request.rb +244 -0
data/lib/ramaze/trinity/response.rb +41 -0
data/lib/ramaze/trinity/session.rb +129 -0
data/lib/ramaze/version.rb +14 -0
data/spec/spec_all.rb +73 -0
data/spec/spec_helper.rb +215 -0
data/spec/tc_adapter_mongrel.rb +24 -0
data/spec/tc_adapter_webrick.rb +22 -0
data/spec/tc_cache.rb +79 -0
data/spec/tc_controller.rb +39 -0
data/spec/tc_element.rb +100 -0
data/spec/tc_error.rb +23 -0
data/spec/tc_gestalt.rb +90 -0
data/spec/tc_global.rb +46 -0
data/spec/tc_helper_aspect.rb +65 -0
data/spec/tc_helper_auth.rb +61 -0
data/spec/tc_helper_cache.rb +81 -0
data/spec/tc_helper_feed.rb +129 -0
data/spec/tc_helper_form.rb +146 -0
data/spec/tc_helper_link.rb +58 -0
data/spec/tc_helper_redirect.rb +51 -0
data/spec/tc_helper_stack.rb +55 -0
data/spec/tc_morpher.rb +90 -0
data/spec/tc_params.rb +84 -0
data/spec/tc_request.rb +111 -0
data/spec/tc_session.rb +56 -0
data/spec/tc_store.rb +25 -0
data/spec/tc_template_amrita2.rb +34 -0
data/spec/tc_template_erubis.rb +41 -0
data/spec/tc_template_haml.rb +44 -0
data/spec/tc_template_liquid.rb +98 -0
data/spec/tc_template_markaby.rb +74 -0
data/spec/tc_template_ramaze.rb +54 -0
data/spec/tc_tidy.rb +14 -0
data/spec/template/amrita2/data.html +6 -0
data/spec/template/amrita2/index.html +1 -0
data/spec/template/amrita2/sum.html +1 -0
data/spec/template/erubis/sum.rhtml +1 -0
data/spec/template/haml/index.haml +5 -0
data/spec/template/haml/with_vars.haml +4 -0
data/spec/template/liquid/index.liquid +1 -0
data/spec/template/liquid/products.liquid +45 -0
data/spec/template/markaby/external.mab +8 -0
data/spec/template/markaby/sum.mab +1 -0
data/spec/template/ramaze/file_only.rmze +1 -0
data/spec/template/ramaze/index.rmze +1 -0
data/spec/template/ramaze/nested.rmze +1 -0
data/spec/template/ramaze/sum.rmze +1 -0
metadata +317 -0

data/lib/ramaze/template/ramaze/element.rb ADDED

@@ -0,0 +1,166 @@
+#          Copyright (c) 2006 Michael Fellinger m.fellinger@gmail.com
+# All files in this distribution are subject to the terms of the Ruby license.
+module Ramaze
+  # an Element is almost like an Controller, however, instead
+  # of connecting actions to templates it is only used in
+  # Ramaze::Template::Ramaze and can be used inside the
+  # templates of the Controller as a simple wrapper.
+  #
+  # Example:
+  #
+  # Your Element called Page:
+  #
+  #   class Page < Element
+  #     def render
+  #       %{
+  #        <html>
+  #          <h1>
+  #            #{@hash['title']}
+  #          </h1>
+  #          #{content}
+  #        </html>
+  #        }
+  #     end
+  #   end
+  #
+  # and one called SideBar
+  #
+  #   class SideBar < Element
+  #     def render
+  #       %{
+  #         <a href="http://something.com">something</a>
+  #        }
+  #      end
+  #    end
+  #
+  # and your template (any template for any action):
+  #
+  #   <Page title="Test">
+  #     <SideBar />
+  #     <p>
+  #       Hello, World!
+  #     </p>
+  #   </Page>
+  #
+  # would result in:
+  #
+  #   <html>
+  #     <h1>
+  #       Test
+  #     </h1>
+  #     <p>
+  #       Hello, World!
+  #     </p>
+  #   </html>
+  class Element
+    extend Ramaze::Helper
+    helper :link, :redirect
+    attr_accessor :content
+    # this will be called by #transform, passes along the
+    # stuff inside the tags for the element
+    def initialize(content)
+      @content = content
+    end
+    # The method that will be called upon to render the things
+    # inside the element, you can access #content from here, which
+    # contains the contents between the tags.
+    #
+    # It should answer with a String.
+    def render *args
+      @content
+    end
+    class << self
+      # transforms all <Element> tags within the string, takes also
+      # a binding to be compatible to the transform-pipeline, won't have
+      # any use for it though.
+      #
+      # It also sets a instance-variable for you called @hash, which
+      # contains the parameters you gave the <Element> tag.
+      # See above for an example of writing and using them.
+      def transform string = '', binding = nil
+        string = string.to_s
+        matches = string.scan(/<([A-Z][a-zA-Z0-9]*)(.*?)?>/)
+        matches.each do |(klass, params)|
+          transformer = (params[-1,1] == '/' ? :without : :with)
+          string = send("transform_#{transformer}_content", string, klass)
+        end
+        string
+      end
+      # transforms elements like:
+      #   <Page> some content </Page>
+      def transform_with_content(string, klass)
+        string.gsub(/<#{klass}( .*?)?>(.*?)<\/#{klass}>/m) do |m|
+          params, content = $1.to_s, $2.to_s
+          finish_transform(klass, params, content)
+        end
+      end
+      # transforms elements like:
+      #   <Page />
+      def transform_without_content(string, klass)
+        string.gsub(/<#{klass}( .*?)?\/>/) do |m|
+          params = $1.to_s
+          finish_transform(klass, params, content = '')
+        end
+      end
+      # find the element, create an instance, pass it the content
+      # check if it responds to :render and set an instance-variable
+      # called @hash to hold the parameters passed to the element.
+      #
+      # Parameters look like:
+      #   <Page foo="true"> bar </Page>
+      #   <Page foo="true" />
+      def finish_transform(klass, params, content)
+        instance = constant(klass).new(content) rescue nil
+        return unless instance and instance.respond_to?(:render)
+        hash = demunge_passed_variables(params)
+        instance.instance_variable_set("@hash", hash)
+        instance.render
+      end
+      # basically processes stuff like
+      #   'foo="bar" foobar="baz"'
+      # do NOT pass actual objects that cannot be simply read as a string
+      # here, the information will be lost.
+      #
+      # Exceptions are true, false, Integers and Floats. They will appear
+      # in their real form (this again is also valid for strings that contain
+      # these values in a way that makes Integer/Float possible to parse them)
+      #
+      # Just remember, walk like a duck, talk like a duck.
+      def demunge_passed_variables(string)
+        string.scan(/\s?(.*?)="(.*?)"/).inject({}) do |hash, (key, value)|
+          value =
+            case value
+            when 'true'  : true
+            when 'false' : false
+            else
+              Integer(value) rescue Float(value) rescue value
+            end
+          hash.merge key => value
+        end
+      end
+    end
+  end
+end

data/lib/ramaze/template/ramaze/morpher.rb ADDED

@@ -0,0 +1,156 @@
+#          Copyright (c) 2006 Michael Fellinger m.fellinger@gmail.com
+# All files in this distribution are subject to the terms of the Ruby license.
+module Ramaze
+  # This applies a morphing-replace for the template.
+  #
+  # To use the functionality of Morpher you will need to have hpricot
+  # installed, you will get one error in case you don't and the method
+  # will be replaced by a stub that simply returns the template.
+  #
+  # The method first checks if you use any morphers and just skips
+  # the step if you don't, this should give quite some speedup for
+  # smaller templates that don't use this functionality at all.
+  # the check works by searching the morphs with appended '='
+  # in the template. There may be a few cases where this won't work
+  # since we cannot make any assumptions on the format.
+  #
+  # If you want to turn this functionality off, either remove Morpher
+  # from:
+  #   Ramaze::Template::Ramaze.trait[:transform_pipeline]
+  # or do:
+  #   Ramaze::Morpher.trait[:morphs] = {}
+  #
+  # The latter is a tad slower, but i mention the possibility in case you
+  # find good use for it.
+  #
+  # You can add your own morphers in Ramaze::Morpher.trait[:morphs]
+  #
+  # For Example:
+  #
+  #   Morpher.trait[:morphs]['if'] = '<?r %morph %expression ?>%content<?r end ?>'
+  #
+  # Now, assuming that some tag in your template is '<a if="@foo">x</a>'
+  #
+  # %morph stands for the name of your morph: 'if'
+  # %expression is the stuff you write in the attribute: '@foo'
+  # %content is the tag without the attribute (and all inside): '<a>x</a>'
+  class Morpher
+    # Use this trait to define your custom morphs.
+    trait :morphs => {
+                      'if'     => '<?r %morph %expression ?>%content<?r end ?>',
+                      'unless' => '<?r %morph %expression ?>%content<?r end ?>',
+                      'for'    => '<?r %morph %expression ?>%content<?r end ?>',
+                      'each'   => '<?r %expression.%morph do |_e| ?>%content<?r end ?>',
+                      'times'  => '<?r %expression.%morph do |_t| ?>%content<?r end ?>',
+    }
+    # Since the functionality is best explained by examples, here they come.
+    #
+    # Example:
+    #
+    # if:
+    #   <div if="@name">#@name</div>
+    # morphs to:
+    #   <?r if @name ?>
+    #     <div>#@name</div>
+    #   <?r end ?>
+    #
+    # unless:
+    #   <div unless="@name">No Name</div>
+    # morphs to:
+    #   <?r unless @name ?>
+    #     <div>No Name</div>
+    #   <?r end ?>
+    #
+    # for:
+    #   <div for="name in @names">#{name}</div>
+    # morphs to:
+    #   <?r for name in @names ?>
+    #     <div>#{name}</div>
+    #   <?r end ?>
+    #
+    # times:
+    #   <div times="3">#{_t}<div>
+    # morphs to:
+    #   <?r 3.times do |_t| ?>
+    #     <div>#{_t}</div>
+    #   <?r end ?>
+    #
+    # each:
+    #   <div each="[1,2,3]">#{_e}</div>
+    # morphs to:
+    #   <?r [1,2,3].each do |_e| ?>
+    #     <div>#{_e}</div>
+    #   <?r end ?>
+    #
+    # The latter two examples show you also one standard introduced by a
+    # limitation of the replacement-system.
+    #
+    # When you yield a value, please name it by the first character(s) of
+    # the morphs name, with an underscore prefixed.
+    #
+    # for each an _e, for times a _t.
+    #
+    # This is by far not the best way to handle it and might lead to problems
+    # due to the lack of proper scoping in ruby (if you define an _e or _t
+    # before the block it will be overwritten).
+    #
+    # So please be careful, I tried to come up with something that is both easy
+    # to write and doesn't look outright awful while keeping an easy to remember
+    # mnemonic.
+    #
+    # TODO:
+    #   - Add pure Ruby implementation as a fall-back.
+    def self.transform template, bound = nil
+      morphs =
+        trait[:morphs].map{|k,v| [k.to_s, v.to_s]}.select do |(k,v)|
+        template.to_s.include?("#{k}=")
+        end
+      morphs = Hash[*morphs.flatten]
+      return template if morphs.empty?
+      require 'hpricot'
+      hp = Hpricot(template)
+      hp.each_child do |child|
+        if child.elem?
+          morphs.each_pair do |morph, replacement|
+            if expression = child[morph]
+              old = child.to_html
+              child.remove_attribute(morph)
+              replacement = replacement.dup.
+                gsub('%morph',      morph).
+                gsub('%expression', expression).
+                gsub('%content',    child.to_html)
+              template.gsub!(old, replacement)
+            end
+          end
+        end
+      end
+      template
+    rescue LoadError => ex
+      error "Please install hpricot (for example via `gem install hpricot`) to get morphing"
+      # replace this method with a stub that only returns the template.
+      self.class_eval do
+        def self.transform(template, bound = nil)
+          template
+        end
+      end
+      template
+    end
+  end
+end

data/lib/ramaze/tool/create.rb ADDED

@@ -0,0 +1,70 @@
+#          Copyright (c) 2006 Michael Fellinger m.fellinger@gmail.com
+# All files in this distribution are subject to the terms of the Ruby license.
+require 'fileutils'
+require 'yaml'
+module Ramaze
+  module Tool
+    # Create is a simple class used to create new projects based on the proto
+    # directory.
+    #
+    # It is primarly used for this command:
+    #
+    #   ramaze --create project
+    #
+    # where project is the directory you want the content put into.
+    class Create
+      class << self
+        # a method to create a new project by copying the contents of lib/proto
+        # to the position you specify (project)
+        #
+        # It is just a nice wrapper showing you what files/directories are put
+        # in place.
+        def create project
+          @basedir = ::Ramaze::BASEDIR / 'proto'
+          @destdir = Dir.pwd / project
+          puts "creating project: #{project}"
+          FileUtils.mkdir_p(project)
+          puts "copy proto to new project (#@destdir)..."
+          directories, files =
+            Dir[@basedir / '**' / '*'].partition{|f| File.directory?(f) }
+          create_dirs(*directories)
+          copy_files(*files)
+        end
+        # create the directories recursivly
+        def create_dirs(*dirs)
+          dirs.each do |dir|
+            dest = dir.gsub(@basedir, @destdir)
+            puts "create directory: '#{dest}'"
+            FileUtils.mkdir_p(dest)
+          end
+        end
+        # copy the files over
+        def copy_files(*files)
+          files.each do |file|
+            dest = file.gsub(@basedir, @destdir)
+            puts "copy file: '#{dest}'"
+            FileUtils.cp(file, dest)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ramaze/tool/tidy.rb ADDED

@@ -0,0 +1,71 @@
+#          Copyright (c) 2006 Michael Fellinger m.fellinger@gmail.com
+# All files in this distribution are subject to the terms of the Ruby license.
+module Ramaze
+  module Tool
+    # This is a simple tool to tidy up your html-output
+    # in general this is just used by setting Global.tidy = true
+    module Tidy
+      # set this to define a custom path to your tidy.so
+      trait[:path] ||= `locate libtidy.so`.strip
+      # dirty html in, tidy html out
+      # To activate Tidy for everything outgoing (given that it is of
+      # Content-Type text/html) set
+      #   Global.tidy = true
+      # there is almost no speed-tradeoff but makes debugging a much
+      # nicer experience ;)
+      #
+      # Example:
+      #
+      #  include Ramaze::Tool::Tidy
+      #  puts tidy('<html></html>')
+      #
+      #  # results in something like:
+      #
+      #   <html>
+      #     <head>
+      #       <meta name="generator" content="HTML Tidy for Linux/x86 (vers 1 September 2005), see www.w3.org" />
+      #       <title></title>
+      #     </head>
+      #     <body></body>
+      #   </html>
+      def self.tidy html, options = {}
+        require 'tidy'
+        ::Tidy.path = trait[:path]
+        defaults = {
+          :output_xml => true,
+          :input_encoding => :utf8,
+          :output_encoding => :utf8,
+          :indent_spaces => 2,
+          :indent => :auto,
+          :markup => :yes,
+          :wrap => 500
+        }
+        ::Tidy.open(:show_warnings => true) do |tidy|
+          defaults.merge(options).each do |key, value|
+            tidy.options.send("#{key}=", value.to_s)
+          end
+          tidy.clean(html)
+        end
+      rescue LoadError => ex
+        puts ex
+        puts "cannot load 'tidy', please `gem install tidy`"
+        puts "you can find it at http://tidy.rubyforge.org/"
+      end
+      # calls self#tidy
+      def tidy html, options = {}
+        Ramaze::Tool::Tidy.tidy(html, options)
+      end
+    end
+  end
+end