RubyGems - runo - Versions diffs - 0.1.0 - Mend

runo 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 (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