riddl 0.99.105

data/lib/riddl/commonlogger.rb

@@ -0,0 +1,16 @@
+require 'logger'
+
+module Riddl
+
+  class CommonLogger
+    def initialize(appname="Riddl Server",logger=$stdout)
+      @logger = Logger.new(logger)
+      @appname = appname
+    end
+
+    def write(it)
+      @logger << @appname + ': ' + it
+    end
+  end
+
+end

data/lib/riddl/constants.rb

@@ -0,0 +1,5 @@
+module Riddl
+  BOUNDARY = "Time_is_an_illusion._Lunchtime_doubly_so.0xriddldata"
+  EOL = "\r\n"
+  D = '&;'
+end  

data/lib/riddl/error.rb

@@ -0,0 +1,8 @@
+module Riddl
+  class URIError < ::RuntimeError; end
+  class InputError < ::RuntimeError; end
+  class OutputError < ::RuntimeError; end
+  class PathError < ::RuntimeError; end
+  class BlockError < ::StandardError; end
+  class SpecificationError < ::StandardError; end
+end

data/lib/riddl/handlers.rb

@@ -0,0 +1,14 @@
+module Riddl
+  module Handlers
+    @@handlers = {}
+    def self::add(name,what)
+      @@handlers[name] = what
+    end
+    def self::handlers
+      @@handlers
+    end
+    class Implementation
+      def self::handle(content,arguments); end
+    end
+  end
+end  

data/lib/riddl/handlers/oauth.rb

@@ -0,0 +1,19 @@
+module Riddl
+  module Handlers
+    class OAuth
+      WANTED = [:oauth_token,:oauth_token_secret]
+
+      def self::handle(what,hinfo)
+        provided = []
+        qs = what.read
+        (qs || '').split(/[&] */n).each do |p|
+          k, v = Protocols::HTTP::Parser::unescape(p).split('=', 2)
+          provided << k.to_sym
+        end
+        WANTED.all?{ |e| provided.include?(e) }
+      end
+    end
+  end  
+end  
+
+Riddl::Handlers::add("http://riddl.org/ns/handlers/oauth",Riddl::Handlers::OAuth)

data/lib/riddl/handlers/plain-type.rb

@@ -0,0 +1,21 @@
+module Riddl
+  module Handlers
+    class PlainType
+      def self::handle(what,hinfo)
+        if what.class == Riddl::Parameter::Tempfile
+          w = what.read
+        else  
+          w = what
+        end  
+        begin
+          re = Regexp.new(hinfo)
+        rescue  
+          return false
+        end
+        w =~ re
+      end
+    end
+  end  
+end  
+
+Riddl::Handlers::add("http://riddl.org/ns/handlers/plain-type",Riddl::Handlers::PlainType)

data/lib/riddl/handlers/relaxng.rb

@@ -0,0 +1,16 @@
+module Riddl
+  module Handlers
+    class RelaxNG < Riddl::Handlers::Implementation
+      def self::handle(what,hinfo)
+        w = if what.class == Riddl::Parameter::Tempfile || what.class == File
+          XML::Smart.open_unprotected(what)
+        else  
+          XML::Smart.string(what)
+        end  
+        w.validate_against(XML::Smart.string(hinfo)) rescue false
+      end
+    end
+  end  
+end  
+
+Riddl::Handlers::add("http://riddl.org/ns/handlers/relaxng",Riddl::Handlers::RelaxNG)

data/lib/riddl/handlers/xmlschema.rb

@@ -0,0 +1,16 @@
+module Riddl
+  module Handlers
+    class XMLSchema < Riddl::Handlers::Implementation
+      def self::handle(what,hinfo)
+        w = if what.class == Riddl::Parameter::Tempfile || what.class == File
+          XML::Smart.open_unprotected(what)
+        else  
+          XML::Smart.string(what)
+        end  
+        w.validate_against(XML::Smart.string(hinfo)) rescue false
+      end
+    end
+  end  
+end  
+
+Riddl::Handlers::add("http://riddl.org/ns/handlers/xmlschema",Riddl::Handlers::XMLSchema)

data/lib/riddl/header.rb

@@ -0,0 +1,9 @@
+module Riddl
+  class Header
+    attr_reader :name, :value
+    def initialize(name,value)
+      @name = name
+      @value = value
+    end
+  end
+end  

data/lib/riddl/implementation.rb

@@ -0,0 +1,57 @@
+module Riddl
+  class Implementation
+    def initialize(request)
+      @request = request
+
+      @h =     request[:h]     # incoming riddl headers
+      @p =     request[:p]     # incoming riddl parameters
+      @r =     request[:r]     # the matching resource path (fixed)
+      @s =     request[:s]     # the matching resource path schema (fixed)
+      @match = request[:match] # the matching resource path schema for current resource, important for recursive
+      @env =   request[:env]   # environment (all headers)
+      @a =     request[:a]     # args to run command
+      @m =     request[:m]     # get, put, post, ...
+
+      @headers = []
+    end
+    def response                      # riddl parameters to return
+      @response || []
+    end
+    def headers                       # riddl headers to return (additional headers not defined in description are okay too)
+      @headers
+    end
+    def status                        # return status
+      @status || 200
+    end
+  end
+
+  class WebSocketImplementation
+    def initialize(ws)
+      @ws    = ws
+      @r     = ws[:r]     # the matching resource path
+      @s     = ws[:s]     # the matching resource path schema
+      @match = ws[:match] # the path of the branch matching, important for recursive
+      @env   = ws[:env]   # environment (all headers)
+      @a     = ws[:a]     # args to run command
+    end
+
+    def onopen;end
+    def onclose;end
+    def onmessage;end
+    def onerror(err);end
+
+    def send(data)
+      self.io.send data
+    end
+
+    def io=(connection)
+      @ws[:io] = connection
+    end
+    def io
+      @ws[:io]
+    end
+    def closed?
+      @ws[:io].closed?
+    end  
+  end
+end

data/lib/riddl/ns/common-patterns/addon-security/request.xml

@@ -0,0 +1,25 @@
+<description datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes" xmlns="http://riddl.org/ns/description/1.0" xmlns:xi="http://www.w3.org/2001/XInclude">
+
+  <!-- RAS - Riddl Addon Security -->
+
+  <transformation name="ras_request">
+    <add_as_last>
+      <parameter name="ras_own-public-key" type="string"/>
+      <parameter name="ras_fingerprint" type="string"/>
+    </add_as_last>
+  </transformation>
+
+  <!--
+    * fingerprint: hash all parameters, sign with own private key
+    * Append own public key of sender to message
+    * Append fingerprint to message
+  -->
+
+  <resource>
+    <get transformation="ras_request"/>
+    <post transformation="ras_request"/>
+    <put transformation="ras_request"/>
+    <delete transformation="ras_request"/>
+  </resource>  
+
+</description>

data/lib/riddl/ns/common-patterns/addon-security/response.xml

@@ -0,0 +1,25 @@
+<description datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes" xmlns="http://riddl.org/ns/description/1.0" xmlns:xi="http://www.w3.org/2001/XInclude">
+  
+  <!-- RAS - Riddl Addon Security -->
+
+  <transformation name="ras_response">
+    <remove_each name="ras_remote-public-key"/>
+    <remove_each name="ras_fingerprint"/>
+  </transformation>
+
+  <!--
+    All other parameters are encryped with 1) remote private key, then 2) own public key
+    * Decrypt all parameters with own private key
+    * Decrypt all parameters with remote public key
+    * hash all decrypted parameters plus remote public key
+    * compare to fingerprint
+  -->
+
+  <resource>
+    <get transformation="ras_response"/>
+    <post transformation="ras_response"/>
+    <put transformation="ras_response"/>
+    <delete transformation="ras_response"/>
+  </resource>  
+
+</description>

data/lib/riddl/ns/common-patterns/downloadify/1.0/downloadify.xml

@@ -0,0 +1,18 @@
+<description datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes" xmlns="http://riddl.org/ns/description/1.0" xmlns:xi="http://www.w3.org/2001/XInclude">
+  
+  <message name="dfout">
+    <parameter name="content" mimetype="*"/>
+  </message>
+  <message name="dfin">
+    <parameter name="mimetype" type="string"/>
+    <parameter name="content" type="string"/>
+  </message>
+
+  <resource pattern="http://riddl.org/ns/common-patterns/downloadify/1.0">
+    <resource>
+      <get in="dfin" out="dfout"/>
+      <post in="dfin" out="dfout"/>
+    </resource>  
+  </resource>  
+
+</description>

data/lib/riddl/ns/common-patterns/notifications-consumer/1.0/consumer.xml

@@ -0,0 +1,100 @@
+<description datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes" xmlns="http://riddl.org/ns/description/1.0" xmlns:xi="http://www.w3.org/2001/XInclude">
+
+  <message name="notification">
+    <parameter name="key" type="string"/>
+    <parameter name="topic" type="string"/>
+    <choice>
+      <parameter name="event" type="string">
+        <param name="pattern">[\w_]+</param>
+      </parameter>
+      <parameter name="vote" type="string">
+        <param name="pattern">[\w_]+</param>
+      </parameter>
+    </choice>  
+    <parameter name="notification" mimetype="text/xml" handler="http://riddl.org/ns/handlers/relaxng">
+      <grammar xmlns="http://relaxng.org/ns/structure/1.0" datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes" ns="http://riddl.org/ns/common-patterns/notifications-consumer/1.0">
+        <start>
+          <element name="notification">
+            <zeroOrMore>
+              <ref name="header"/>
+            </zeroOrMore>  
+            <zeroOrMore>
+              <ref name="parameter"/>
+            </zeroOrMore>  
+          </element>
+        </start>
+
+        <define name="header">
+          <element name="header">
+            <attribute name="name">
+              <data type="string"/>
+            </attribute>
+            <optional>
+              <attribute name="type">
+                <data type="string"/>
+              </attribute>  
+            </optional>  
+            <data type="string"/>
+          </element>
+        </define>  
+        
+        <define name="parameter">
+          <element name="parameter">
+            <attribute name="name">
+              <data type="string"/>
+            </attribute>
+            <optional>
+              <choice>
+                <attribute name="type">
+                  <data type="string"/>
+                </attribute>  
+                <attribute name="mimetype">
+                  <data type="string">
+                    <param name="pattern">[\c]+/[\c\+]+|\*</param>
+                  </data>  
+                </attribute>  
+              </choice>  
+            </optional>
+            <ref name="any"/>
+          </element>
+        </define>  
+
+        <define name="any">
+            <mixed>
+          <zeroOrMore>
+              <element>
+                <anyName/>
+                <zeroOrMore>
+                  <choice>
+                    <attribute>
+                      <anyName/>
+                    </attribute>
+                    <text/>
+                    <ref name="any"/>
+                  </choice>
+                </zeroOrMore>
+              </element>
+          </zeroOrMore>  
+            </mixed>  
+        </define>
+
+      </grammar>
+    </parameter>
+    <parameter name="message-uid" type="string"/>
+    <parameter name="fingerprint-with-consumer-secret" type="string"/>
+  </message>
+
+  <message name="acknowledgment">
+    <header name="CPEE_CALLBACK" type="boolean"/>
+    <optional>
+      <parameter name="continue" type="boolean"/>
+    </optional>
+    <parameter name="message-uid" type="string"/>
+    <parameter name="fingerprint-with-consumer-secret" type="string"/>
+  </message>
+
+  <resource pattern="http://riddl.org/ns/common-patterns/notifications-consumer/1.0">
+    <post in="notification" out="acknowledgment"/>
+  </resource>  
+
+</description>

data/lib/riddl/ns/common-patterns/notifications-producer/1.0/producer.xml

@@ -0,0 +1,204 @@
+<description datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes" xmlns="http://riddl.org/ns/description/1.0" xmlns:xi="http://www.w3.org/2001/XInclude">
+
+  <message name="topics">
+    <parameter name="topics" mimetype="text/xml" handler="http://riddl.org/ns/handlers/relaxng">
+      <grammar xmlns="http://relaxng.org/ns/structure/1.0" datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes" ns="http://riddl.org/ns/common-patterns/notifications-producer/1.0">
+        <start>
+          <element name="topics">
+            <zeroOrMore>
+              <ref name="topic"/>
+            </zeroOrMore>  
+          </element>
+        </start>
+
+        <define name="topic">
+          <element name="topic">
+            <attribute name="id">
+              <data type="string"/>
+            </attribute>  
+            <zeroOrMore>
+              <element>
+                <choice>
+                  <name>event</name>
+                  <name>vote</name>
+                </choice>
+                <data type="string">
+                  <param name="pattern">[\w-_]+</param>
+                </data>
+              </element>  
+            </zeroOrMore>
+          </element>
+        </define>  
+
+      </grammar>
+    </parameter>
+  </message>
+  
+  <message name="subscriptions">
+    <parameter name="subscriptions" mimetype="text/xml" handler="http://riddl.org/ns/handlers/relaxng">
+      <grammar xmlns="http://relaxng.org/ns/structure/1.0" datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes" ns="http://riddl.org/ns/common-patterns/notifications-producer/1.0">
+        <start>
+          <element name="subscriptions">
+            <attribute name="details">
+              <choice>
+                <value>debug</value>
+                <value>production</value>
+              </choice>  
+            </attribute>
+            <zeroOrMore>
+              <ref name="subscription"/>
+            </zeroOrMore>  
+          </element>
+        </start>
+
+        <define name="subscription">
+          <element name="subscription">
+            <attribute name="id">
+              <data type="string"/>
+            </attribute>
+            <optional>
+              <attribute name="url">
+                <data type="string"/>
+              </attribute>
+            </optional>  
+          </element>
+        </define>
+
+      </grammar>
+    </parameter>
+  </message>
+  
+  <message name="subscription">
+    <parameter name="subscription" mimetype="text/xml" handler="http://riddl.org/ns/handlers/relaxng">
+      <grammar xmlns="http://relaxng.org/ns/structure/1.0" datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes" ns="http://riddl.org/ns/common-patterns/notifications-producer/1.0">
+        <start>
+          <element name="subscription">
+            <optional>
+              <attribute name="url">
+                <data type="string"/>
+              </attribute>
+            </optional>  
+            <oneOrMore>
+              <element name="topic">
+                <attribute name="id">
+                  <data type="string"/>
+                </attribute>  
+                <oneOrMore>
+                  <element>
+                    <choice>
+                      <name>event</name>
+                      <name>vote</name>
+                    </choice>
+                    <data type="string">
+                      <param name="pattern">[\w_]+</param>
+                    </data>
+                  </element>  
+                </oneOrMore>
+              </element>
+            </oneOrMore>
+          </element>
+        </start>
+      </grammar>
+    </parameter>
+    <optional>
+      <parameter name="message-uid" type="string"/>
+      <parameter name="fingerprint-with-producer-secret" type="string"/>
+    </optional>  
+  </message>
+  
+  <message name="delete">
+    <optional>
+      <parameter name="message-uid" type="string"/>
+      <parameter name="fingerprint-with-producer-secret" type="string"/>
+    </optional>
+  </message>
+  <message name="request">
+    <optional>
+      <parameter name="message-uid" type="string"/>
+      <parameter name="fingerprint-with-producer-secret" type="string"/>
+    </optional>  
+  </message>
+
+  <message name="subscribe">
+    <optional>
+      <parameter name="url" type="string"/>
+      <optional>
+        <parameter name="onbehalf" type="string"/>
+      </optional>  
+    </optional>  
+    <oneOrMore>
+      <parameter name="topic" type="string"/>
+      <choice>
+        <parameter name="votes" type="string">
+          <param name="pattern">([\w-_]+,)*([\w-_]+)</param>
+        </parameter>
+        <parameter name="events" type="string">
+          <param name="pattern">([\w-_]+,)*([\w-_]+)</param>
+        </parameter>
+      </choice>
+    </oneOrMore>
+  </message>  
+  <message name="acknowledgment">
+    <parameter name="key" type="string"/>
+    <parameter name="producer-secret" type="string"/>
+    <parameter name="consumer-secret" type="string"/>
+  </message>
+
+  <message name="details">
+    <parameter name="message-uid" type="string"/>
+    <optional>
+      <parameter name="url" type="string"/>
+    </optional>  
+    <oneOrMore>
+      <parameter name="topic" type="string"/>
+      <choice>
+        <parameter name="votes" type="string">
+           <param name="pattern">([\w-_]+,)*([\w-_]+)</param>
+        </parameter>
+        <parameter name="events" type="string">
+           <param name="pattern">([\w-_]+,)*([\w-_]+)</param>
+        </parameter>
+      </choice>
+    </oneOrMore>
+    <parameter name="fingerprint-with-producer-secret" type="string"/>
+  </message>
+
+  <message name="overview">
+    <parameter name="overview" mimetype="text/xml" handler="http://riddl.org/ns/handlers/relaxng">
+      <grammar xmlns="http://relaxng.org/ns/structure/1.0" datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes" ns="http://riddl.org/ns/common-patterns/notifications-producer/1.0">
+        <start>
+          <element name="overview">
+            <element name="topics">
+              <empty/>
+            </element>
+            <element name="subscriptions">
+              <empty/>
+            </element>
+          </element>
+        </start>
+      </grammar>
+    </parameter>
+  </message>
+
+  <resource pattern="http://riddl.org/ns/common-patterns/notifications-producer/1.0">
+    <resource relative="notifications">
+      <get in="*" out="overview"/>
+      <resource relative="topics">
+        <get in="*" out="topics"/>
+      </resource>
+      <resource relative="subscriptions">
+        <get in="*" out="subscriptions"/>
+        <post in="subscribe" out="acknowledgment"/>
+        <resource>
+          <get    in="request" out="subscription"/>
+          <put    in="details"/>
+          <delete in="delete"/>
+          <resource relative="ws">
+            <websocket/>
+          </resource>
+        </resource>
+      </resource>
+    </resource>
+  </resource>  
+
+</description>