riddl 0.99.105

data/lib/riddl/ns/description/1.0/description.rng

@@ -0,0 +1,302 @@
+<?xml version="1.0"?>
+<grammar xmlns="http://relaxng.org/ns/structure/1.0" datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes" ns="http://riddl.org/ns/description/1.0">
+  <include href="../../common/relaxng-modular.rng"/>
+  <include href="../../common/datatypes-1_0.rng"/>
+
+  <start>
+    <element name="description">
+      <ref name="riddl-description"/>
+   	</element>
+  </start>
+
+  <define name="riddl-description">
+    <attribute name="datatypeLibrary">
+      <data type="anyURI"/>
+    </attribute>
+    <ref name="riddl-description-other-atts"/>
+    <zeroOrMore>
+      <choice>
+        <element name="message">
+          <ref name="riddl-description-other-atts"/>
+          <ref name="riddl-message"/>
+        </element>
+        <element name="transformation">
+          <ref name="riddl-description-other-atts"/>
+          <ref name="riddl-transformation"/>
+        </element>
+      </choice>  
+    </zeroOrMore>
+    <element name="resource">  
+      <ref name="riddl-resource-dynamic"/>
+    </element>
+  </define>
+  
+  <define name="riddl-message">
+    <ref name="riddl-att-name"/>
+    <zeroOrMore>
+      <ref name="riddl-header"/>
+    </zeroOrMore>
+    <zeroOrMore>
+      <ref name="riddl-message-other"/>
+    </zeroOrMore>
+  </define>
+
+  <define name="riddl-transformation">
+    <ref name="riddl-att-name"/>
+    <oneOrMore>
+      <choice>
+        <element name="add_header">
+          <oneOrMore>
+            <ref name="riddl-header"/>
+          </oneOrMore>  
+        </element>  
+        <element name="add_as_first">
+          <oneOrMore>
+            <ref name="riddl-parameter"/>
+          </oneOrMore>  
+        </element>  
+        <element name="add_as_last">
+          <oneOrMore>
+            <ref name="riddl-parameter"/>
+          </oneOrMore>  
+        </element>  
+        <element name="add_before">
+          <ref name="riddl-att-name-star"/>
+          <oneOrMore>
+            <ref name="riddl-parameter"/>
+          </oneOrMore>  
+        </element>
+        <element name="add_after">
+          <ref name="riddl-att-name-star"/>
+          <oneOrMore>
+            <ref name="riddl-parameter"/>
+          </oneOrMore>  
+        </element>
+        <element name="remove_each">
+          <ref name="riddl-att-col-remove"/>
+        </element>
+        <element name="remove_first">
+          <ref name="riddl-att-col-remove"/>
+        </element>
+        <element name="remove_last">
+          <ref name="riddl-att-col-remove"/>
+        </element>
+      </choice>
+    </oneOrMore>
+  </define>
+      
+  <define name="riddl-header">
+    <element name="header">
+      <ref name="riddl-att-name"/>
+      <choice>
+        <ref name="riddl-fixed"/>
+        <ref name="data"/>
+      </choice>  
+    </element>  
+  </define>
+
+  <define name="riddl-message-other">
+    <choice>
+      <ref name="riddl-zeroOrMore"/>
+      <ref name="riddl-oneOrMore"/>
+      <ref name="riddl-optional"/>
+      <ref name="riddl-choice"/>
+      <ref name="riddl-parameter"/>
+    </choice>  
+  </define>
+  <define name="riddl-message-other-trimmed">
+    <choice>
+      <ref name="riddl-zeroOrMore"/>
+      <ref name="riddl-oneOrMore"/>
+      <ref name="riddl-choice"/>
+      <ref name="riddl-group"/>
+      <ref name="riddl-parameter"/>
+    </choice>  
+  </define>
+
+  <define name="riddl-zeroOrMore">
+    <element name="zeroOrMore">
+      <oneOrMore>
+        <ref name="riddl-message-other"/>
+      </oneOrMore>  
+    </element>  
+  </define>
+  <define name="riddl-oneOrMore">
+    <element name="oneOrMore">
+      <oneOrMore>
+        <ref name="riddl-message-other"/>
+      </oneOrMore>
+    </element>  
+  </define>
+  <define name="riddl-optional">
+    <element name="optional">
+      <oneOrMore>
+        <ref name="riddl-message-other"/>
+      </oneOrMore>  
+    </element>  
+  </define>
+  <define name="riddl-choice">
+    <element name="choice">
+      <oneOrMore>
+        <ref name="riddl-message-other-trimmed"/>
+      </oneOrMore>
+    </element>
+  </define>
+  <define name="riddl-group">
+    <element name="group">
+      <oneOrMore>
+        <ref name="riddl-message-other"/>
+      </oneOrMore>
+    </element>  
+  </define>
+  <define name="riddl-parameter">
+    <element name="parameter">
+      <ref name="riddl-att-name-star"/>
+      <ref name="riddl-description-other-atts"/>
+      <choice>
+        <ref name="riddl-fixed"/>
+        <ref name="data"/>
+        <group>
+          <attribute name="mimetype">
+            <data type="string">
+              <param name="pattern">(([\c]+|\*)/[\c\+]+)|([\c]+/([\c\+]+|\*))|\*</param>
+            </data>
+          </attribute>  
+          <optional>
+            <attribute name="handler">
+              <data type="anyURI"/>
+            </attribute>  
+          </optional>
+          <optional>
+            <ref name="any"/>
+          </optional>  
+        </group>  
+      </choice>
+    </element>
+  </define>   
+
+  <define name="riddl-fixed">
+    <optional>
+      <attribute name="fixed">
+        <data type="string"/>
+      </attribute>
+    </optional>  
+  </define>
+
+  <define name="riddl-resource-attributes">
+    <optional>
+      <attribute name="pattern">
+        <data type="anyURI"/>
+      </attribute>  
+    </optional>
+    <optional>
+      <attribute name="role">
+        <data type="anyURI"/>
+      </attribute>  
+    </optional>
+    <ref name="riddl-description-other-atts"/>
+  </define>
+    
+  <define name="riddl-resource-recursive-choice">
+    <choice>
+      <attribute name="recursive">
+        <data type="boolean"/>
+      </attribute>  
+      <group>
+        <ref name="riddl-resource-sub"/>
+      </group>  
+    </choice>  
+  </define>  
+
+  <define name="riddl-resource-dynamic">
+    <ref name="riddl-resource-attributes"/>
+    <ref name="riddl-resource-content"/>
+    <ref name="riddl-resource-recursive-choice"/>
+  </define>
+  <define name="riddl-resource-named">
+    <ref name="riddl-resource-attributes"/>
+    <attribute name="relative">
+      <ref name="riddl-datatype-relpath"/>
+    </attribute>
+    <ref name="riddl-resource-content"/>
+    <ref name="riddl-resource-recursive-choice"/>
+  </define>
+    
+  <define name="riddl-resource-sub">
+    <!-- One dynamic resources, multiple named ones, before or after the dynamic -->
+    <zeroOrMore>
+      <element name="resource">
+        <ref name="riddl-resource-named"/>
+      </element>
+    </zeroOrMore>
+    <optional>
+      <element name="resource">
+        <ref name="riddl-resource-dynamic"/>
+      </element>
+    </optional>
+    <zeroOrMore>
+      <element name="resource">
+        <ref name="riddl-resource-named"/>
+      </element>
+    </zeroOrMore>
+  </define>  
+
+  <define name="riddl-resource-content">
+    <zeroOrMore>
+      <choice>
+        <element name="post">
+          <ref name="riddl-atts-request"/>
+          <ref name="riddl-description-others"/>
+        </element>
+        <element name="get">
+          <ref name="riddl-atts-request"/>
+          <ref name="riddl-description-others"/>
+        </element>
+        <element name="put">
+          <ref name="riddl-atts-request"/>
+          <ref name="riddl-description-others"/>
+        </element>
+        <element name="delete">
+          <ref name="riddl-atts-request"/>
+          <ref name="riddl-description-others"/>
+        </element>
+        <element name="request">
+          <ref name="riddl-att-method"/>
+          <ref name="riddl-atts-request"/>
+          <ref name="riddl-description-others"/>
+        </element>  
+        <element name="websocket">
+          <empty/>
+        </element>  
+      </choice>  
+    </zeroOrMore>
+  </define>
+
+  <define name="riddl-description-others">
+    <ref name="other"/>
+    <zeroOrMore>
+      <attribute>
+        <anyName>
+          <except>
+            <nsName/>
+            <nsName ns=""/>
+          </except>
+        </anyName>
+      </attribute>
+    </zeroOrMore>
+  </define>  
+
+  <define name="riddl-description-other-atts">
+    <zeroOrMore>
+      <attribute>
+        <anyName>
+          <except>
+            <nsName/>
+            <nsName ns=""/>
+          </except>
+        </anyName>
+      </attribute>
+    </zeroOrMore>
+  </define>  
+   
+</grammar>

data/lib/riddl/option.rb

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

data/lib/riddl/parameter.rb

@@ -0,0 +1,54 @@
+require 'tempfile'
+
+module Riddl
+  module Parameter
+    class Array < ::Array
+      def value(index)
+        tmp = find_all{|e| e.name == index}
+        case tmp.length
+          when 0; nil
+          when 1; tmp[0].value
+          else tmp
+        end if tmp
+      end
+    end
+    class Simple
+      attr_accessor :name, :value, :type
+      def initialize(name,value,type=:body)
+        @name = name
+        @value = value
+        @type = (type == :query ? :query : :body)
+      end
+    end
+    class Complex
+      attr_reader :mimetype, :filename, :value, :type, :additional
+      attr_accessor :name
+      def initialize(name,mimetype,file=nil,filename=nil,additional=[])
+        @name = name
+        @mimetype = mimetype.gsub(/;.*/,'')
+        @filename = filename
+        @type = :body
+        @additional = additional
+
+        @value = block_given? ? yield : file
+        unless (@value && (@value.class == String || (file.respond_to?(:read) && file.respond_to?(:rewind))))
+          raise "ERROR input is not a stream or string"
+        end
+      end
+      def reopen
+        if @value.class == File || @value.class == Riddl::Parameter::Tempfile
+          pname = @value.path
+          @value.close
+          @value = File.open(pname,'r')
+        end  
+      end
+    end
+    class Tempfile < ::Tempfile
+      def _close
+        @tmpfile.close if @tmpfile
+        @data[1] = nil if @data
+        @tmpfile = nil
+      end
+    end
+  end  
+end

data/lib/riddl/protocols/http/generator.rb

@@ -0,0 +1,121 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../constants')
+require 'stringio'
+
+module Riddl
+  module Protocols
+    module HTTP
+      class Generator
+        def initialize(params,headers)
+          @params = params
+          @headers = headers
+        end
+
+        # Performs URI escaping so that you can construct proper
+        # query strings faster.  Use this rather than the cgi.rb
+        # version since it's faster. (%20 instead of + for improved standards conformance).
+        def self.escape(s)
+          s.to_s.gsub(/([^a-zA-Z0-9_.-]+)/n) {
+            '%'+$1.unpack('H2'*$1.size).join('%').upcase
+          }
+        end
+
+        def generate(mode=:output)
+          if @params.is_a?(Array) && @params.length == 1
+            body(@params[0],mode)
+          elsif @params.class == Riddl::Parameter::Simple || @params.class == Riddl::Parameter::Complex
+            body(@params,mode)
+          elsif @params.is_a?(Array) && @params.length > 1
+            multipart(mode)
+          else
+            StringIO.new('','r+b')
+          end  
+        end
+
+        def body(r,mode)
+          tmp = StringIO.new('','r+b')
+          case r
+            when Riddl::Parameter::Simple
+              if mode == :output
+                tmp.write r.value
+                @headers['Content-Type'] = 'text/plain'
+                @headers['Content-ID'] = r.name
+                @headers['RIDDL-TYPE'] = 'simple'
+              end
+              if mode == :input
+                @headers['Content-Type'] = 'application/x-www-form-urlencoded'
+                tmp.write self.class::escape(r.name) + '=' + self.class::escape(r.value)
+              end
+            when Riddl::Parameter::Complex
+              tmp.write(r.value.respond_to?(:read) ? r.value.read : r.value)
+              @headers['Content-Type'] = r.mimetype
+              @headers['RIDDL-TYPE'] = 'complex'
+              if r.filename.nil?
+                @headers['Content-ID'] = r.name
+              else
+                @headers['Content-Disposition'] = "riddl-data; name=\"#{r.name}\"; filename=\"#{r.filename}\""
+              end  
+          end
+          tmp.flush
+          tmp.rewind
+          tmp
+        end
+        private :body
+
+        def multipart(mode)
+          tmp = StringIO.new('','r+b')
+          scount = ccount = 0
+          @params.each do |r|
+            case r
+              when Riddl::Parameter::Simple
+                scount += 1
+              when Riddl::Parameter::Complex
+                ccount += 1
+            end   
+          end
+          if scount > 0 && ccount == 0
+            @headers['Content-Type'] = 'application/x-www-form-urlencoded'
+            res = []
+            @params.each do |r|
+              case r
+                when Riddl::Parameter::Simple
+                  res << self.class::escape(r.name) + '=' + self.class::escape(r.value)
+              end   
+            end
+            tmp.write res.join('&')
+          else
+            if scount + ccount > 0
+              @headers['Content-Type'] = "multipart/#{mode == :input ? 'form-data' : 'mixed'}; boundary=\"#{BOUNDARY}\""
+              @params.each do |r|
+                case r
+                  when Riddl::Parameter::Simple
+                    tmp.write "--" + BOUNDARY + EOL
+                    tmp.write "RIDDL-TYPE: simple" + EOL
+                    tmp.write "Content-Disposition: #{mode == :input ? 'form-data' : 'riddl-data'}; name=\"#{r.name}\"" + EOL
+                    tmp.write EOL
+                    tmp.write r.value
+                    tmp.write EOL
+                  when Riddl::Parameter::Complex
+                    tmp.write "--" +  BOUNDARY + EOL
+                    tmp.write "RIDDL-TYPE: complex" + EOL
+                    tmp.write "Content-Disposition: #{mode == :input ? 'form-data' : 'riddl-data'}; name=\"#{r.name}\""
+                    tmp.write r.filename.nil? ? EOL : "; filename=\"#{r.filename}\"" + EOL
+                    tmp.write "Content-Transfer-Encoding: binary" + EOL
+                    tmp.write "Content-Type: " + r.mimetype + EOL
+                    tmp.write EOL
+                    tmp.write(r.value.respond_to?(:read) ? r.value.read : r.value)
+                    tmp.write EOL
+                end   
+              end
+              tmp.write "--" + BOUNDARY + EOL
+            end
+          end
+          tmp.flush
+          tmp.rewind
+          tmp
+        end
+        private :multipart
+      
+      end
+    end
+  end
+end