RubyGems - runo - Versions diffs - 0.1.0 - Mend

runo 0.1.0

Files changed (149) hide show

data/LICENSE +19 -0
data/README.rdoc +120 -0
data/bin/runo +35 -0
data/lib/_error.rb +14 -0
data/lib/_field.rb +260 -0
data/lib/_i18n.rb +141 -0
data/lib/_parser.rb +243 -0
data/lib/_path.rb +86 -0
data/lib/_storage/_storage.rb +213 -0
data/lib/_storage/file.rb +200 -0
data/lib/_storage/sequel.rb +174 -0
data/lib/_storage/temp.rb +73 -0
data/lib/_widget/action_create.rb +23 -0
data/lib/_widget/action_login.rb +22 -0
data/lib/_widget/action_signup.rb +16 -0
data/lib/_widget/action_update.rb +16 -0
data/lib/_widget/crumb.rb +24 -0
data/lib/_widget/done.rb +16 -0
data/lib/_widget/login.rb +25 -0
data/lib/_widget/me.rb +31 -0
data/lib/_widget/message.rb +51 -0
data/lib/_widget/navi.rb +88 -0
data/lib/_widget/submit.rb +49 -0
data/lib/_widget/view_ym.rb +77 -0
data/lib/_workflow/_workflow.rb +89 -0
data/lib/_workflow/attachment.rb +50 -0
data/lib/_workflow/blog.rb +28 -0
data/lib/_workflow/contact.rb +23 -0
data/lib/_workflow/forum.rb +26 -0
data/lib/_workflow/register.rb +39 -0
data/lib/meta/_meta.rb +20 -0
data/lib/meta/group.rb +19 -0
data/lib/meta/id.rb +59 -0
data/lib/meta/owner.rb +21 -0
data/lib/meta/timestamp.rb +118 -0
data/lib/runo.rb +396 -0
data/lib/scalar/checkbox.rb +68 -0
data/lib/scalar/file.rb +144 -0
data/lib/scalar/img.rb +112 -0
data/lib/scalar/password.rb +58 -0
data/lib/scalar/radio.rb +47 -0
data/lib/scalar/select.rb +47 -0
data/lib/scalar/text.rb +38 -0
data/lib/scalar/textarea.rb +35 -0
data/lib/scalar/textarea_pre.rb +14 -0
data/lib/scalar/textarea_wiki.rb +173 -0
data/lib/set/_set.rb +195 -0
data/lib/set/dynamic.rb +177 -0
data/lib/set/static.rb +102 -0
data/lib/set/static_folder.rb +96 -0
data/locale/en/index.po +242 -0
data/locale/index.pot +243 -0
data/locale/ja/index.po +242 -0
data/locale/lazy_parser.rb +54 -0
data/skel/config.ru +27 -0
data/skel/skin/_users/00000000_frank-avatar.jpg +0 -0
data/skel/skin/_users/00000000_frank-avatar_small.jpg +0 -0
data/skel/skin/_users/00000000_frank.yaml +12 -0
data/skel/skin/_users/00000000_root-avatar.jpg +0 -0
data/skel/skin/_users/00000000_root-avatar_small.jpg +0 -0
data/skel/skin/_users/00000000_root.yaml +11 -0
data/skel/skin/_users/css/users.css +21 -0
data/skel/skin/_users/css/users.less +25 -0
data/skel/skin/_users/done.html +42 -0
data/skel/skin/_users/index.html +46 -0
data/skel/skin/_users/index.yaml +3 -0
data/skel/skin/_users/summary.html +40 -0
data/skel/skin/css/base.css +93 -0
data/skel/skin/css/base.less +139 -0
data/skel/skin/css/coax.css +199 -0
data/skel/skin/css/coax.less +244 -0
data/skel/skin/examples/blog/20091214_0001.yaml +8 -0
data/skel/skin/examples/blog/20100630_0001.yaml +8 -0
data/skel/skin/examples/blog/20100630_0002.yaml +14 -0
data/skel/skin/examples/blog/20100701_0001.yaml +8 -0
data/skel/skin/examples/blog/20100701_0002-a-20100701_0001-f.jpg +0 -0
data/skel/skin/examples/blog/20100701_0002-a-20100701_0001-f_small.jpg +0 -0
data/skel/skin/examples/blog/20100701_0002.yaml +19 -0
data/skel/skin/examples/blog/frank/20100701_0001.yaml +10 -0
data/skel/skin/examples/blog/frank/index.yaml +4 -0
data/skel/skin/examples/blog/index.html +51 -0
data/skel/skin/examples/blog/rss.xml +18 -0
data/skel/skin/examples/contact/20100701_0001-file.txt +1 -0
data/skel/skin/examples/contact/20100701_0001.yaml +15 -0
data/skel/skin/examples/contact/20100701_0002.yaml +8 -0
data/skel/skin/examples/contact/20100701_0003.yaml +9 -0
data/skel/skin/examples/contact/index.html +47 -0
data/skel/skin/examples/contact/js/contact.js +13 -0
data/skel/skin/examples/contact/summary.html +54 -0
data/skel/skin/examples/forum/20100701_0001.yaml +41 -0
data/skel/skin/examples/forum/20100701_0002.yaml +25 -0
data/skel/skin/examples/forum/index.html +68 -0
data/skel/skin/examples/forum/summary.html +47 -0
data/skel/skin/examples/index.html +75 -0
data/skel/skin/index.html +41 -0
data/skel/skin/js/base.js +50 -0
data/t/locale/de/index.po +19 -0
data/t/locale/en-GB/index.po +25 -0
data/t/locale/ja/index.po +30 -0
data/t/skin/_users/00000000_test.yaml +3 -0
data/t/skin/_users/index.html +13 -0
data/t/skin/foo/20091120_0001.yaml +7 -0
data/t/skin/foo/bar/20091120_0001.yaml +5 -0
data/t/skin/foo/bar/index.yaml +5 -0
data/t/skin/foo/baz/css/baz.css +1 -0
data/t/skin/foo/css/foo.css +1 -0
data/t/skin/foo/index.html +14 -0
data/t/skin/foo/index.yaml +7 -0
data/t/skin/foo/not_css/foo.css +1 -0
data/t/skin/foo/sub-20100306_0001.yaml +3 -0
data/t/skin/index.yaml +3 -0
data/t/skin/t_attachment/index.html +13 -0
data/t/skin/t_contact/done.html +6 -0
data/t/skin/t_contact/index.html +9 -0
data/t/skin/t_file/index.html +16 -0
data/t/skin/t_img/index.html +14 -0
data/t/skin/t_img/test.jpg +0 -0
data/t/skin/t_select/index.html +9 -0
data/t/skin/t_store/index.html +9 -0
data/t/skin/t_summary/20100326_0001.yaml +3 -0
data/t/skin/t_summary/create.html +9 -0
data/t/skin/t_summary/index.html +9 -0
data/t/skin/t_summary/summary.html +9 -0
data/t/t.rb +27 -0
data/t/test_checkbox.rb +273 -0
data/t/test_field.rb +330 -0
data/t/test_file.rb +900 -0
data/t/test_id.rb +215 -0
data/t/test_img.rb +328 -0
data/t/test_meta.rb +57 -0
data/t/test_parser.rb +1266 -0
data/t/test_password.rb +188 -0
data/t/test_radio.rb +226 -0
data/t/test_role.rb +249 -0
data/t/test_runo.rb +742 -0
data/t/test_runo_call.rb +1286 -0
data/t/test_runo_i18n.rb +318 -0
data/t/test_select.rb +182 -0
data/t/test_set_complex.rb +527 -0
data/t/test_set_dynamic.rb +1504 -0
data/t/test_set_folder.rb +515 -0
data/t/test_set_permit.rb +246 -0
data/t/test_set_static.rb +445 -0
data/t/test_storage.rb +915 -0
data/t/test_text.rb +125 -0
data/t/test_textarea.rb +138 -0
data/t/test_timestamp.rb +473 -0
data/t/test_workflow.rb +367 -0
metadata +345 -0

data/LICENSE ADDED

@@ -0,0 +1,19 @@
+Copyright (c) 2010 Akira FUNAI <akira -at- funai -dot- com>
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.

data/README.rdoc ADDED

@@ -0,0 +1,120 @@
+= Runo
+Runo is the easiest web application framework ever.
+You can make various apps such like blog, forum, contact form by putting single (or several) HTML file with a bit of special markups. The view rules. There is no model definition, no server restart, and no coding at all.
+== Features
+* Model / View / Controller defined dynamically by good old HTML.
+* Any block tags (<ul>, <table> etc.) can be an "app", by adding a workflow class like "runo-blog".
+* The contents inside the app tag will be the "model".
+* The model is defined by special tags, like "$(foo = text 1..32)" or "$(bar = select a,b,c)".
+* You can make nested apps inside an app (e.g. blog comments inside a blog entry).
+* Authentication / Authorization / User admin are built in by default.
+* Storage can be plain YAML files (default), or any RDB via Sequel.
+* Runo itself is a Rack application.
+== Quick Start
+This is a quick tutorial for making a simple web application using Runo.
+=== Step 1 - Install Runo
+Open a command line terminal. Type:
+  gem install runo
+If you want to make thumbnails for submitted images, you have to install QuickMagick as well.
+http://rubyforge.org/projects/quickmagick/
+=== Step 2 - Initialize a Runo Directory
+In a command line terminal, go to an empty directory where you want to build Runo projects.
+Then type:
+  runo init
+This will create a "runo" directory, which includes:
+  runo/
+    config.ru
+    skin/
+=== Step 3 - Start a Test Server
+In the terminal, change to the newly created "runo" directory.
+Type:
+  runo run
+=== Step 4 - Try some examples
+Now open this URL with your browser.
+  http://localhost:9292/
+You will see the default homepage of Runo.
+There is some links to examples such like Blog, Contact Form, Forum, etc. Just see what can be done by plain HTML files.
+=== Step 5 - Create Your Own App
+Let's call our app "fab".
+It is a web-based forum where logged in users can submit their own articles, and everybody can read them.
+We put links to signup / login at bottom of the app.
+Create a new directory under runo/skin/:
+  mkdir skin/fab/
+Then create a new HTML file with your favorite editor:
+  edit skin/fab/index.html
+The content is: (You can just copy & paste, of course)
+  <html>
+    <head>
+      <title>fab forum</title>
+      <link rel="stylesheet" href="/css/base.css" type="text/css" media="screen" />
+    </head>
+    <body>
+      <h1><a href=".">fab forum</a></h1>
+      <ul id="main" class="runo-forum">
+        <!-- 1..5 desc may_preview -->
+        <li>
+          <h2>$(title = text 32 1..32)</h2>
+          <div>
+            $(content = textarea-pre 60*10 1..)
+            <div>by $(_owner) @ $(_timestamp)</div>
+          </div>
+        </li>
+      </ul>
+      <p>$(.action_signup)$(.me)</p>
+    </body>
+  </html>
+=== Step 6 - That's it!
+See the URL:
+  http://localhost:9292/fab/
+You have just created your first app. Open a bottle of your favorite drink and make yourself comfortable.
+When you need more complicated tricks, HTMLs under skin/examples/ will be your help. More detailed documents are on the way.
+== Note on Patches/Pull Requests
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+== Copyright
+Copyright (c) 2010 Akira FUNAI <akira -at- funai -dot- com>. See LICENSE for details.

data/bin/runo ADDED

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# Author::    Akira FUNAI
+# Copyright:: Copyright (c) 2009-2010 Akira FUNAI
+require 'rubygems'
+$LOAD_PATH.unshift(::File.expand_path('../lib',::File.dirname(__FILE__)))
+require 'runo'
+case ARGV.shift
+  when 'init'
+    runo_dir = ::File.expand_path './runo'
+    if ::File.exists? runo_dir
+      $stderr.puts "#{runo_dir} already exists."
+      exit 1
+    else
+      $stderr.puts "Setting up Runo files in #{runo_dir}..."
+      ::FileUtils.cp_r(
+        ::File.expand_path('../skel',Runo.libdir),
+        './runo',
+        :verbose => :true
+      )
+    end
+  when 'run'
+    ::Dir.chdir(File.exists?('./config.ru') ? '.' : './runo') {
+      $stderr.puts "Starting a server with Runo files in #{::File.expand_path '.'}..."
+      system('rackup',*ARGV)
+    }
+  else
+    $stderr.puts 'Usage: runo {init|run [Rack options]}'
+    exit 1
+end

data/lib/_error.rb ADDED

@@ -0,0 +1,14 @@
+# encoding: UTF-8
+# Author::    Akira FUNAI
+# Copyright:: Copyright (c) 2009 Akira FUNAI
+module Runo::Error
+  class Forbidden < StandardError
+  end
+  class NotFound < StandardError
+  end
+end

data/lib/_field.rb ADDED

@@ -0,0 +1,260 @@
+# encoding: UTF-8
+# Author::    Akira FUNAI
+# Copyright:: Copyright (c) 2009 Akira FUNAI
+require 'rubygems'
+require 'rack/utils'
+$KCODE = 'UTF8'
+class Runo::Field
+  include Runo::I18n
+  DEFAULT_META = {}
+  def self.instance(meta = {})
+    k = meta[:klass].to_s.split(/-/).inject(Runo) {|c, name|
+      name = name.capitalize
+      c.const_get(name)
+    }
+    k.new(meta) if k < self
+  end
+  def self.h(val)
+    Rack::Utils.escape_html val.to_s
+  end
+  attr_reader :action, :result
+  def initialize(meta = {})
+    @meta = self.class.const_get(:DEFAULT_META).merge meta
+    @val  = val_cast(nil)
+  end
+  def inspect
+    caller.grep(/`inspect'/).empty? ? super : "<#{self.class} name=\"#{my[:name]}\">"
+  end
+  def [](id, *arg)
+    respond_to?("meta_#{id}") ? __send__("meta_#{id}", *arg) : @meta[id]
+  end
+  def []=(id, v)
+    @meta[id] = v
+  end
+  def val
+    @val
+  end
+  def item(*item_steps)
+    item_steps = item_steps.first if item_steps.first.is_a? ::Array
+    item_steps.empty? ? self : nil # scalar has no item
+  end
+  def find_ancestor(&block)
+    f = self
+    block.call(f) ? (return f) : (f = f[:parent]) until f.nil?
+  end
+  def meta_name
+    my[:parent] && !my[:parent].is_a?(Runo::Set::Static::Folder) ?
+      "#{my[:parent][:name]}-#{my[:id]}" : my[:id]
+  end
+  def meta_full_name
+    my[:parent] ? "#{my[:parent][:full_name]}-#{my[:id]}" : my[:id]
+  end
+  def meta_short_name
+    return '' if Runo.base && my[:full_name] == Runo.base[:full_name]
+    my[:parent] && Runo.base && my[:parent][:full_name] != Runo.base[:full_name] ?
+      "#{my[:parent][:short_name]}-#{my[:id]}" : my[:id]
+  end
+  def meta_folder
+    find_ancestor {|f| f.is_a? Runo::Set::Static::Folder }
+  end
+  def meta_sd
+    find_ancestor {|f| f.is_a? Runo::Set::Dynamic }
+  end
+  def meta_client
+    Runo.client
+  end
+  def meta_owner
+    @meta[:owner] || (my[:parent] ? my[:parent][:owner] : 'root')
+  end
+  def meta_owners
+    (my[:parent] ? my[:parent][:owners] : ['root']) | @meta[:owner].to_a
+  end
+  def meta_admins
+    (my[:parent] ? my[:parent][:admins] : ['root']) | @meta[:admin].to_a
+  end
+  def meta_group
+    @meta[:group] || (my[:parent] ? my[:parent][:group] : [])
+  end
+  def meta_roles
+    roles  = 0
+    roles |= Runo::Workflow::ROLE_ADMIN if my[:admins].include? my[:client]
+    roles |= Runo::Workflow::ROLE_GROUP if my[:group].include? my[:client]
+    roles |= Runo::Workflow::ROLE_OWNER if my[:owner] == my[:client]
+    roles |= (Runo.client == 'nobody') ? Runo::Workflow::ROLE_NONE : Runo::Workflow::ROLE_USER
+    roles
+  end
+  def permit?(action)
+    return false if action == :create && @result == :load
+    return true unless my[:sd]
+    return true if my[:sd].workflow.permit?(my[:roles], action)
+    return true if find_ancestor {|f| f[:id] =~ Runo::REX::ID_NEW } # descendant of a new item
+  end
+  def default_action
+    return :read unless my[:sd]
+    actions = my[:sd].workflow.class.const_get(:PERM).keys - [:read, :create, :update]
+    ([:read, :create, :update] + actions).find {|action| permit? action }
+  end
+  def get(arg = {})
+    if permit_get? arg
+      _get(arg)
+    else
+      if arg[:action]
+        raise Runo::Error::Forbidden
+      else
+        arg[:action] = default_action
+      end
+      arg[:action] ? _get(arg) : 'xxx'
+    end
+  end
+  def load_default
+    post :load_default
+  end
+  def load(v = nil)
+    post :load, v
+  end
+  def create(v = nil)
+    post :create, v
+  end
+  def update(v = nil)
+    post :update, v
+  end
+  def delete
+    post :delete
+  end
+  def post(action, v = nil)
+    raise Runo::Error::Forbidden unless permit_post?(action, v)
+    if _post action, val_cast(v)
+      @result = (action == :load || action == :load_default) ? action : nil
+      @action = (action == :load || action == :load_default) ? nil : action
+    else
+      @result = nil
+    end
+    self
+  end
+  def commit(type = :temp)
+    if valid?
+      @result = @action
+      @action = nil if type == :persistent
+      self
+    end
+  end
+  def pending?
+    @action ? true : false
+  end
+  def valid?
+    errors.empty?
+  end
+  def empty?
+    val.to_s == ''
+  end
+  def errors
+    []
+  end
+  private
+  def my
+    self
+  end
+  def _get(arg)
+    _get_by_method arg
+  end
+  def _get_by_method(arg)
+    m = "_g_#{arg[:action]}"
+    respond_to?(m, true) ? __send__(m, arg) : _g_default(arg)
+  end
+  alias :_get_by_self_reference :_get_by_method
+  def _g_empty(arg)
+  end
+  alias :_g_login   :_g_empty
+  alias :_g_done    :_g_empty
+  alias :_g_message :_g_empty
+  def _g_default(arg)
+    Runo::Field.h val
+  end
+  def _g_errors(arg)
+    <<_html unless _g_valid? arg
+<span class="error_message">#{errors.join "<br/>\n"}</span>
+_html
+  end
+  def _g_class(arg)
+    c = self.class.to_s.sub('Runo::', '').gsub('::', '-').downcase
+    _g_valid?(arg) ? c : "#{c} error"
+  end
+  def _g_valid?(arg)
+    valid? || (arg[:action] == :create && !item.pending?)
+  end
+  def _post(action, v)
+    case action
+      when :load_default
+        @val = val_cast(my[:defaults] || my[:default])
+      when :load, :create, :update
+        @val = v if @val != v
+      when :delete
+        true
+    end
+  end
+  def permit_get?(arg)
+    permit? arg[:action]
+  end
+  def permit_post?(action, v)
+    action == :load || action == :load_default || permit?(action)
+  end
+  def val_cast(v)
+    v
+  end
+end