metaruby 1.0.0.rc1

data/lib/metaruby/gui/html/jquery.selectfilter.js

@@ -0,0 +1,65 @@
+/*
+ * 
+ * Plugin created by Andras Zoltan-Gyarfas -  azolee [at] gmail [dot] com
+ * License: GNU License - http://www.gnu.org/licenses/gpl.html
+ * Demo & latest release: http://realizare-site-web.ro/works/codes/jquery/HTML-Select-List-Filter/index.html
+ * Last modification date: 04/20/2011
+ * 
+ */
+
+;(function($) {
+    $.fn.selectFilter = function() {
+        var name = $(this).attr("name").replace(/\]/g, '').replace(/\[/g, '');
+        $(this).addClass(name+"_select");
+        var iname = name;
+        $(this).before("<input class='"+iname+"' style='display: block;' type='text' />");
+        $(this).css("display", "block");
+        $("input."+name).live("keyup", function(){
+            var txt = $(this).val().toLowerCase();
+
+            var fields=txt.split(' ');
+            var text = new Array();
+            var tags = new Array();
+            var tag_matcher = new RegExp("^tag:");
+            for (var i = 0; i < fields.length; ++i) {
+                var el = fields[i];
+                if (tag_matcher.test(el)) {
+                    el = el.split(':');
+                    tags.push(new RegExp(el[1]));
+                }
+                else if (el.length != 0) {
+                    text.push(new RegExp(el));
+                }
+            }
+
+            if (text.length == 0 && tags.length == 0) {
+                $("."+name+"_select").children('div').show();
+            }
+            else {
+                $("."+name+"_select").children('div').hide();
+                $("."+name+"_select").children('div').each(function(i, selected){
+                    var value = $(this).text().toLowerCase();
+                    var show = true;
+                    for (var i = 0; show && i < text.length; ++i) {
+                        if (!text[i].test(value)) {
+                            show = false;
+                        }
+                    }
+                    var value = $(this).attr('tags');
+                    if (value) {
+                        value = value.toLowerCase();
+                        for (var i = 0; show && i < tags.length; ++i) {
+                            if (!tags[i].test(value)) {
+                                show = false;
+                            }
+                        }
+                    }
+                    if (show) {
+                        $(selected).show();
+                    }
+                });
+            }
+        });
+    return this;
+    };
+})(jQuery);

data/lib/metaruby/gui/html/jquery.tagcloud.min.js

@@ -0,0 +1,8 @@
+/*
+* jQuery TagCloud 0.5.0
+* Copyright (c) 2008 Ron Valstar
+* Dual licensed under the MIT and GPL licenses:
+*   http://www.opensource.org/licenses/mit-license.php
+*   http://www.gnu.org/licenses/gpl.html
+*/
+(function(F){var C;var A={};var G={};var L=2.399963;F.tagcloud={id:"TagCloud",version:"0.5.0",defaults:{height:null,type:"cloud",sizemax:20,sizemin:10,colormax:"00F",colormin:"B4D2FF",seed:null,power:0.5}};F.fn.extend({tagcloud:function(M){C=F.extend({},F.tagcloud.defaults,M);if(C.seed===null){C.seed=Math.ceil(Math.random()*45309714203)}switch(C.type){case"sphere":case"cloud":A={position:"relative"};G={position:"absolute",display:"block"};break;case"list":A={height:"auto"};G={position:"static",display:"inline"};break}B.setSeed(C.seed+123456);return this.each(function(f,a){var q=F(a);var R=q.find(">li");var S=R.length;var Z=q.width();var l=C.height===null?(0.004*Z*S):C.height;q.css({width:Z,height:l,listStyle:"none",margin:0,padding:0});q.css(A);var e=-2147483647;var r=2147483648;var T=-1;for(var d=0;d<S;d++){var p=F(R[d]);var n=p.attr("value")==-1?T++:p.attr("value");if(n>e){e=n}if(n<r){r=n}T=n}var b=e-r;var X=new Array();for(var d=0;d<S;d++){X[d]=d}for(var d,V,c=X.length;c;d=parseInt(B.rand(0,1000)/1000*c),V=X[--c],X[c]=X[d],X[d]=V){}T=-1;for(var d=0;d<S;d++){var p=F(R[d]);var n=p.attr("value")==-1?T++:p.attr("value");T=n;var g=((S-d-1)/(S-1));var g=(n-r)/b;var m=C.sizemin+g*(C.sizemax-C.sizemin);var N=D(C.colormin,C.colormax,g);p.css({fontSize:m,position:"absolute",color:"#"+N,margin:0,padding:0}).children().css({color:"#"+N});var Y=p.width();var h=p.height();var Q={};if(C.type!="list"){if(C.type=="cloud"){var s=B.rand(0,Z-Y);var W=X[d]*(l/S)-h/2}else{var P=Math.pow(d/S,C.power);var U=(d+Math.PI/2)*L;var s=Z/2-Y/2+0.5*Z*P*Math.sin(U);var W=l/2-h/2+0.5*l*P*Math.cos(U)}Q.left=s;Q.top=W}for(var O in G){Q[O]=G[O]}p.css(Q)}})}});var B=new function(){this.seed=23145678901;this.A=48271;this.M=2147483647;this.Q=this.M/this.A;this.R=this.M%this.A;this.oneOverM=1/this.M};B.setSeed=function(M){this.seed=M};B.next=function(){var M=this.seed/this.Q;var N=this.seed%this.Q;var O=this.A*N-this.R*M;this.seed=O+(O>0?0:this.M);return(this.seed*this.oneOverM)};B.rand=function(N,M){return Math.floor((M-N+1)*this.next()+N)};function I(M){return M.toString(16)}function K(M){return parseInt(M,16)}function H(Q){var M=Q.length==3;var O=[];for(var N=0;N<3;N++){var P=Q.substring(N*(M?1:2),(N+1)*(M?1:2));O.push(K(M?P+P:P))}return O}function J(M){var O="";for(var N=0;N<3;N++){var P=I(M[N]);if(P.length==1){P="0"+P}O+=P}return O}function D(R,S,P){var Q=H(R);var M=H(S);var O=[];for(var N=0;N<3;N++){O.push(Q[N]+Math.floor(P*(M[N]-Q[N])))}return J(O)}function E(M){if(window.console&&window.console.log){if(typeof (M)=="string"){window.console.log(M)}else{for(var N in M){window.console.log(N+": "+M[N])}}}}F.fn.TagCloud=F.fn.Tagcloud=F.fn.tagcloud})(jQuery);

data/lib/metaruby/gui/html/jquery.tinysort.min.js

@@ -0,0 +1,8 @@
+/*
+* jQuery TinySort 1.0.1
+* Copyright (c) 2008 Ron Valstar
+* Dual licensed under the MIT and GPL licenses:
+*   http://www.opensource.org/licenses/mit-license.php
+*   http://www.gnu.org/licenses/gpl.html
+*/
+(function(C){C.tinysort={id:"TinySort",version:"1.0.1",defaults:{order:"asc",attr:"",place:"start",returns:false}};C.fn.extend({tinysort:function(I,J){if(I&&typeof (I)!="string"){J=I;I=null}var F=C.extend({},C.tinysort.defaults,J);var P={};this.each(function(T){var V=(!I||I=="")?C(this):C(this).find(I);var U=F.order=="rand"?""+Math.random():(F.attr==""?V.text():V.attr(F.attr));var S=C(this).parent();if(!P[S]){P[S]={s:[],n:[]}}if(V.length>0){P[S].s.push({s:U,e:C(this),n:T})}else{P[S].n.push({e:C(this),n:T})}});for(var H in P){var E=P[H];E.s.sort(function K(U,T){var S=U.s.toLowerCase?U.s.toLowerCase():U.s;var V=T.s.toLowerCase?T.s.toLowerCase():T.s;if(D(U.s)&&D(T.s)){S=parseFloat(U.s);V=parseFloat(T.s)}return(F.order=="asc"?1:-1)*(S<V?-1:(S>V?1:0))})}var M=[];for(var H in P){var E=P[H];var N=[];var G=C(this).length;switch(F.place){case"first":C.each(E.s,function(S,T){G=Math.min(G,T.n)});break;case"org":C.each(E.s,function(S,T){N.push(T.n)});break;case"end":G=E.n.length;break;default:G=0}var Q=[0,0];for(var L=0;L<C(this).length;L++){var O=L>=G&&L<G+E.s.length;if(A(N,L)){O=true}var R=(O?E.s:E.n)[Q[O?0:1]].e;R.parent().append(R);if(O||!F.returns){M.push(R.get(0))}Q[O?0:1]++}}return this.setArray(M)}});function D(E){return(parseFloat(E)+"")==E}function A(F,G){var E=false;C.each(F,function(I,H){if(!E){E=H==G}});return E}function B(E){if(window.console&&window.console.log){if(typeof (E)=="string"){window.console.log(E)}else{for(var F in E){window.console.log(F+": "+E[F])}}}}C.fn.TinySort=C.fn.Tinysort=C.fn.tsort=C.fn.tinysort})(jQuery);

data/lib/metaruby/gui/html/list.rhtml

@@ -0,0 +1,24 @@
+<% if options[:filter] %>
+<script type="text/javascript">
+  jQuery(document).ready(function(){
+  jQuery("div#<%= push_options[:id] %>-list").selectFilter();
+});
+</script>
+<% end %>
+
+<div name="index_filter" id="<%= push_options[:id] %>-list">
+<%
+items.each_with_index do |(data, attributes), index|
+    if attributes
+        div_attributes = attributes.map { |k, v| " \#{k}=\"\#{v}\"" }.join("")
+    end
+%>
+<div class="short_doc<%= " list_alt" if index % 2 == 0 %>"<%= div_attributes %>>
+<% if data.respond_to?(:to_ary) %>
+<%   data = data.join("\n") %>
+<% end %>
+<%= data %>
+</div>
+<% end %>
+</div>
+

data/lib/metaruby/gui/html/page.css

@@ -0,0 +1,55 @@
+body {font-family: arial, sans-serif; }
+h1 {margin: 40px 0px 10px 0px; padding: 0px 0px 2px 0px; color: rgb(88,144,168); font-weight: bold; -size: 200%;}
+h2 {width: 500px; margin: 40px 0px 10px 0px; padding: 0px 0px 2px 0px; border-bottom: solid 3px rgb(88,144,168); color: rgb(88,144,168); font-weight: bold; font-size: 160%;}
+table {clear: left; margin: 0.5em 0px 0.2em 30px; border: solid 1px rgb(150,150,150); empty-cells: show; border-collapse: collapse; background-color: rgb(233,232,244);}
+table tr {margin: 0px; padding: 0px;}
+table td {padding: 2px 7px 2px 7px; border: solid 1px rgb(150,150,150); text-align: left; }
+table th {margin: 0px; padding: 2px 7px 2px 7px; border: solid 1px rgb(150,150,150); empty-cells: show; text-align: left; }
+table-caption {margin: 0.5em 0px 1.0em 30px; padding: 0px; clear: both; text-align: left; }
+
+.button_bar {margin: 0px; padding: 0px; font-family: verdana, arial, sans serif; font-size: 1.0em;}
+.button_bar span {margin-left: .1em; padding: 2px 5px 2px 5px; background-color: rgb(255,255,255); font-weight: normal; font-size: .9em; }
+.button_bar span em {font-weight: bold; font-style: normal;}
+.button_bar a {color: rgb(115,162,182); text-decoration: none; font-size: .9em; font-weight: normal;}
+.button_bar a:hover {color: rgb(50,50,50); text-decoration: none;}
+
+.body-header-list {margin: 0em 2em 1em 0em; padding: 0 0 0 0; background-color: rgb(238,237,249); font-size: 1.0em;}
+.body-header-list ul {margin: 5px 0px 0px 0px; padding: 0px; border-bottom: solid 1px rgb(216,206,159); background-color: rgb(219,230,241);}
+.body-header-list li {list-style: none; margin: 0px; padding: 0px;display: block; min-height: 1.7em; height: auto !important; height: 1.7em; line-height: 1.7em; margin: 0px; padding: 0px 7px 0px 10px; border-top: solid 1px rgb(200,200,200); border-left: solid 7px rgb(219,230,241); color: rgb(75,75,75); font-weight: normal; font-size: 100%; text-decoration: none;}
+.body-header-list li.title {margin: 0px 0px 0px 0px; padding: 3px 5px 2px 15px; background-color: rgb(156,186,214); color: rgb(255,255,255); text-transform: uppercase; font-weight: bold;}
+
+.body-header-list li table {clear: left; margin: 0em 0px 0em 25px; empty-cells: show; border-collapse: collapse; }
+.body-header-list li table tr {margin: 0px; padding: 0px;}
+.body-header-list li table td {margin: 0px; padding: 0px 7px 0px 7px; border: none; text-align: left;}
+.body-header-list li table th {margin: 0px; padding: 0px; border: none; empty-cells: show; text-align: left; 	}
+
+code {
+padding:5px;
+background:#e4e4ff;
+color:#222;
+border:2px solid #ddd;
+margin-top: 1em;
+margin-bottom: 1em;
+margin-left: 0em;
+margin-right: 0em;
+font-family: monospace;
+white-space: pre;
+display: block;
+}
+/* Style for the main documentation block for a page */
+.doc-main { font-size: 130% }
+.doc-above { margin-bottom: -.3em; padding-bottom: 0em; font-style: italic; }
+.doc-above p { margin-top: .1em; margin-bottom: .1em; }
+
+div.short_doc {
+    margin-top: .2em;
+    background-color: rgb(238,237,249);
+    padding: .2em;
+    width: 100%;
+}
+div.short_doc td.short_doc {
+    font-style: italic;
+}
+div.list_alt {
+    background-color: rgb(230,228,249);
+}

data/lib/metaruby/gui/html/page.rb

@@ -0,0 +1,283 @@
+module MetaRuby::GUI
+    module HTML
+        RESSOURCES_DIR = File.expand_path(File.dirname(__FILE__))
+
+        # A class that can be used as the webpage container for the Page class
+        class HTMLPage
+            attr_accessor :html
+
+            def main_frame; self end
+        end
+
+        # A helper class that gives us easy-to-use page elements on a
+        # Qt::WebView
+        class Page < Qt::Object
+            attr_reader :fragments
+            attr_reader :view
+            attr_accessor :object_uris
+
+            class Fragment
+                attr_accessor :title
+                attr_accessor :html
+                attr_accessor :id
+                attr_reader :buttons
+
+                def initialize(title, html, view_options = Hash.new)
+                    view_options = Kernel.validate_options view_options,
+                        :id => nil, :buttons => []
+                    @title = title
+                    @html = html
+                    @id = view_options[:id]
+                    @buttons = view_options[:buttons]
+                end
+            end
+
+            def link_to(object, text = nil)
+                text = HTML.escape_html(text || object.name)
+                if uri = uri_for(object)
+                    if uri[0, 1] != '/'
+                        uri = "/#{uri}"
+                    end
+                    "<a href=\"link://metaruby#{uri}\">#{text}</a>"
+                else text
+                end
+            end
+
+            # Converts the given text from markdown to HTML and generates the
+            # necessary <div> context.
+            #
+            # @return [String] the HTML snippet that should be used to render
+            #   the given text as main documentation
+            def self.main_doc(text)
+                "<div class=\"doc-main\">#{Kramdown::Document.new(text).to_html}</div>"
+            end
+
+            def main_doc(text)
+                self.class.main_doc(text)
+            end
+
+            PAGE_TEMPLATE = File.join(RESSOURCES_DIR, "page.rhtml")
+            PAGE_BODY_TEMPLATE = File.join(RESSOURCES_DIR, "page_body.rhtml")
+            LIST_TEMPLATE = File.join(RESSOURCES_DIR, "list.rhtml")
+            ASSETS = %w{page.css jquery.min.js jquery.selectfilter.js}
+
+            def self.copy_assets_to(target_dir, assets = ASSETS)
+                FileUtils.mkdir_p target_dir
+                assets.each do |file|
+                    FileUtils.cp File.join(RESSOURCES_DIR, file), target_dir
+                end
+            end
+
+            def load_template(*path)
+                path = File.join(*path)
+                @templates[path] ||= ERB.new(File.read(path))
+                @templates[path].filename = path
+                @templates[path]
+            end
+
+            attr_reader :page
+
+            attr_accessor :page_name
+            attr_accessor :title
+
+            def initialize(page)
+                super()
+                @page = page
+                @fragments = []
+                @templates = Hash.new
+                @auto_id = 0
+
+                if page.kind_of?(Qt::WebPage)
+                    page.link_delegation_policy = Qt::WebPage::DelegateAllLinks
+                    Qt::Object.connect(page, SIGNAL('linkClicked(const QUrl&)'), self, SLOT('pageLinkClicked(const QUrl&)'))
+                end
+                @object_uris = Hash.new
+            end
+
+            def uri_for(object)
+                object_uris[object]
+            end
+
+            # Removes all existing displays
+            def clear
+                page.main_frame.html = ""
+                fragments.clear
+            end
+
+            def scale_attribute(node, name, scale)
+                node.attributes[name] = node.attributes[name].gsub /[\d\.]+/ do |n|
+                    (Float(n) * scale).to_s
+                end
+            end
+
+            def update_html
+                page.main_frame.html = html
+            end
+
+            def html(options = Hash.new)
+                options = Kernel.validate_options options, :ressource_dir => RESSOURCES_DIR
+                ressource_dir = options[:ressource_dir]
+                load_template(PAGE_TEMPLATE).result(binding)
+            end
+
+            def html_body(options = Hash.new)
+                options = Kernel.validate_options options, :ressource_dir => RESSOURCES_DIR
+                ressource_dir = options[:ressource_dir]
+                load_template(PAGE_BODY_TEMPLATE).result(binding)
+            end
+
+            def find_button_by_url(url)
+                id = url.path
+                fragments.each do |fragment|
+                    if result = fragment.buttons.find { |b| b.id == id }
+                        return result
+                    end
+                end
+                nil
+            end
+
+            def find_first_element(selector)
+                page.main_frame.find_first_element(selector)
+            end
+
+            def pageLinkClicked(url)
+                return if url.host != 'metaruby'
+
+                if url.scheme == 'btn'
+                    if btn = find_button_by_url(url)
+                        new_state = if url.fragment == 'on' then true
+                                    else false
+                                    end
+
+                        btn.state = new_state
+                        new_text = btn.text
+                        element = find_first_element("a##{btn.html_id}")
+                        element.replace(btn.render)
+
+                        emit buttonClicked(btn.id, new_state)
+                    else
+                        MetaRuby.warn "invalid button URI #{url}: could not find corresponding handler"
+                    end
+                elsif url.scheme == 'link'
+                    emit linkClicked(url)
+                end
+            end
+            slots 'pageLinkClicked(const QUrl&)'
+            signals 'linkClicked(const QUrl&)', 'buttonClicked(const QString&,bool)'
+
+            # Save the current state of the page, so that it can be restored by
+            # calling {restore}
+            def save
+                @saved_state = fragments.map(&:dup)
+            end
+
+            # Restore the page at the state it was at the last call to {save}
+            def restore
+                return if !@saved_state
+
+                fragments_by_id = Hash.new
+                @saved_state.each do |fragment|
+                    fragments_by_id[fragment.id] = fragment
+                end
+
+                # Delete all fragments that are not in the saved state
+                fragments.delete_if do |fragment|
+                    element = find_first_element("div##{fragment.id}")
+                    if old_fragment = fragments_by_id[fragment.id]
+                        if old_fragment.html != fragment.html
+                            element.replace(old_fragment.html)
+                        end
+                    else
+                        element.replace("")
+                        true
+                    end
+                end
+            end
+
+            # Adds a fragment to this page, with the given title and HTML
+            # content
+            #
+            # The added fragment is enclosed in a div block to allow for dynamic
+            # replacement
+            # 
+            # @option view_options [String] id the ID of the fragment. If given,
+            #   and if an existing fragment with the same ID exists, the new
+            #   fragment replaces the existing one, and the view is updated
+            #   accordingly.
+            #
+            def push(title, html, view_options = Hash.new)
+                if id = view_options[:id]
+                    # Check whether we should replace the existing content or
+                    # push it new
+                    fragment = fragments.find do |fragment|
+                        fragment.id == id
+                    end
+                    if fragment
+                        fragment.html = html
+                        element = find_first_element("div##{fragment.id}")
+                        element.replace("<div id=\"#{id}\">#{html}</div>")
+                        return
+                    end
+                end
+
+                fragments << Fragment.new(title, html, Hash[:id => auto_id].merge(view_options))
+                update_html
+            end
+
+            def auto_id
+                "metaruby-html-page-fragment-#{@auto_id += 1}"
+            end
+
+            # Create an item for the rendering in tables
+            def render_item(name, value = nil)
+                if value
+                    "<li><b>#{name}</b>: #{value}</li>"
+                else
+                    "<li>#{name}</li>"
+                end
+            end
+
+            # Render a list of objects into HTML and push it to this page
+            #
+            # @param [String,nil] title the section's title. If nil, no new
+            #   section is created
+            # @param [Array<Object>,Array<(Object,Hash)>] items the list
+            #   items, one item per line. If a hash is provided, it is used as
+            #   HTML attributes for the lines
+            # @param [Hash] options
+            # @option options [Boolean] filter (false) if true, a filter is
+            #   added at the top of the page. You must provide a :id option for
+            #   the list for this to work
+            # @option (see #push)
+            def render_list(title, items, options = Hash.new)
+                options, push_options = Kernel.filter_options options, :filter => false, :id => nil
+                if options[:filter] && !options[:id]
+                    raise ArgumentError, ":filter is true, but no :id has been given"
+                end
+                html = load_template(LIST_TEMPLATE).result(binding)
+                push(title, html, push_options.merge(:id => options[:id]))
+            end
+
+            signals 'updated()'
+
+            def self.to_html_page(object, renderer, options = Hash.new)
+                webpage = HTMLPage.new
+                page = new(webpage)
+                renderer.new(page).render(object, options)
+                page
+            end
+
+            # Renders an object to HTML using a given rendering class
+            def self.to_html(object, renderer, options = Hash.new)
+                html_options, options = Kernel.filter_options options, :ressource_dir => RESSOURCES_DIR
+                to_html_page(object, renderer, options).html(html_options)
+            end
+
+            def self.to_html_body(object, renderer, options = Hash.new)
+                html_options, options = Kernel.filter_options options, :ressource_dir => RESSOURCES_DIR
+                to_html_page(object, renderer, options).html_body(html_options)
+            end
+        end
+    end
+end
+

data/lib/metaruby/gui/html/page.rhtml

@@ -0,0 +1,13 @@
+<% prefix = if ressource_dir[0, 1] == "/" then "file://"
+            end
+%>
+<html>
+    <link rel="stylesheet" href="<%= prefix %><%= File.join(ressource_dir, 'page.css') %>" type="text/css" />
+    <script type="text/javascript" src="<%= prefix %><%= File.join(ressource_dir, 'jquery.min.js') %>"></script>
+    <script type="text/javascript" src="<%= prefix %><%= File.join(ressource_dir, 'jquery.selectfilter.js') %>"></script>
+    <title><%= page_name %></title>
+</html>
+<body>
+    <%= html_body(:ressource_dir => ressource_dir) %>
+</body>
+

data/lib/metaruby/gui/html/page_body.rhtml

@@ -0,0 +1,17 @@
+<% if title %>
+<h1><%= title %></h1>
+<% end %>
+<% fragments.each do |fragment| %>
+    <% if fragment.title %>
+<h2><%= fragment.title %></h2>
+    <% end %>
+<%= HTML.render_button_bar(fragment.buttons) %>
+    <% if fragment.id %>
+<div id="<%= fragment.id %>">
+    <% end %>
+<%= fragment.html %>
+    <% if fragment.id %>
+</div>
+    <% end %>
+<% end %>
+