slow_blink 0.0.6 → 0.0.7

data/ext/slow_blink/message/ext_compact_encoder/compact_encoder.h

@@ -1,92 +0,0 @@
-/* Copyright (c) 2016 Cameron Harper
- * 
- * 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.
- *
- * 
- * */
-
-#ifndef COMPACT_ENCODER_H
-#define COMPACT_ENCODER_H
-
-
-/* includes ***********************************************************/
-
-#include <stdint.h>
-#include <stdbool.h>
-
-/* functions **********************************************************/
-
-/**
- * Encode a VLC null
- *
- * @param[out] out output buffer
- * @param[in] outMax maximum byte length of `out`
- *
- * @return bytes successfully written to `out`
- * 
- * */
-uint8_t BLINK_putNull(uint8_t *out, uint32_t outMax);
-
-/**
- * Return minimum number of bytes required to VLC encode unsigned integer value
- *
- * @param[in] value value to encode as VLC
- *
- * @return minimum bytes to VLC encode value
- * 
- * */
-uint8_t BLINK_getSizeUnsigned(uint64_t value);
-
-/**
- * Return minimum number of bytes required to VLC encode signed integer value
- *
- * @param[in] value value to encode as VLC
- *
- * @return minimum bytes to VLC encode value
- * 
- * */
-uint8_t BLINK_getSizeSigned(int64_t value);
-
-/**
- * Encode signed/unsigned integer as VLC
- *
- * @param[in] value signed or unsigned value to encode
- * @param[in] isSigned `true` to indicated `value` is a signed integer
- * @param[out] out output buffer
- * @param[in] outMax maximum byte lenght of `out`
- *
- * @return bytes successfully written to `out`
- *
- * */
-uint8_t BLINK_putVLC(uint64_t in, bool isSigned, uint8_t *out, uint32_t outMax);
-
-/**
- * Decode signed/unsigned integer as VLC
- *
- * @param[in] in input buffer
- * @param[in] inLen byte length of `in`
- * @param[in] isSigned integer shall be intepreted as 2s complement
- * @param[out] out output integer buffer
- * @param[out] isNull set `true` if `in` decodes to NULL
- *
- * @return bytes successfully read from `in`
- *
- * */
-uint8_t BLINK_getVLC(const uint8_t *in, uint32_t inLen, bool isSigned, uint64_t *out, bool *isNull);
- 
-#endif

data/lib/slow_blink/annotatable.rb

@@ -1,48 +0,0 @@
-# @license
-#   
-#   Copyright (c) 2016 Cameron Harper
-#     
-#   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.
-
-
-module SlowBlink
-
-    module Annotatable
-
-        # @return [Array<Annotation>]
-        attr_reader :annotes
-
-        # @param annotes [Array<Annotation,Integer>]
-        def annote(annotes)
-            annotes.each do |a|
-                if a.is_a? Annotation
-                    if @annotes[a.id]
-                        puts "#{a.location}: warning: overriding previous annotation for id '#{a.id}'"
-                    end
-                    @annotes[a.id] = a                    
-                else
-                    if @nameWithID.id
-                        puts "#{a.location}: warning: overriding previous id"
-                    end
-                    @nameWithID.id = a.to_i             
-                end
-            end
-        end
-
-    end
-end

data/lib/slow_blink/annotation.rb

@@ -1,47 +0,0 @@
-# @license
-#   
-#   Copyright (c) 2016 Cameron Harper
-#     
-#   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.
-
-
-module SlowBlink
-
-    class Annotation
-
-        # @macro location
-        attr_reader :location
-
-        # @return [String]
-        attr_reader :id
-
-        # @return [Integer]
-        attr_reader :value
-
-        # @param id [String] any string
-        # @param value [String] any string
-        # @param location [String]
-        def initialize(id,value,location)
-            @id = id
-            @value = value
-            @location = value
-        end
-
-    end
-end
-

data/lib/slow_blink/enumeration.rb

@@ -1,90 +0,0 @@
-# @license 
-#   
-#   Copyright (c) 2016 Cameron Harper
-#     
-#   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.
-
-module SlowBlink
-
-    class ENUMERATION
-
-        include Annotatable
-
-        attr_reader :symbols
-
-        def self.===(other)
-            self == other                
-        end
-
-        # @param syms [Array<Sym>] symbol list
-        def initialize(syms)
-            @annotes = {}
-            @rawSyms = syms
-            @symbols = {}
-            @schema = nil       
-        end
-
-        # @api private
-        #
-        # Resolve references, enforce constraints, and detect cycles
-        #
-        # @param schema [Schema] schema this definition belongs to
-        # @param ns [Namespace] namespace this definition belongs to
-        # @param stack [nil, Array] objects that depend on this object
-        # @return [true,false] linked?
-        def link(schema, ns, stack=[])
-            if @schema.nil?
-                value = 0
-                @symbols = {}
-                @schema = schema
-                @rawSyms.each do |s|
-                    if @symbols[s.name]
-                        Log.error "#{s.location}: error: symbols within an enumeration must have unique names ('#{s.name}' first appears at #{@symbols[s.name].location})"
-                        @schema = nil
-                    else
-                        if s.val
-                            if @symbols.values.include? s.val
-                                Log.error "#{s.location}: error: values of symbols must be distinct ('#{s.val}' first appears at #{@symbols[s.val].location})"
-                                @schema = nil
-                            else
-                                value = s.val + 1
-                            end                        
-                        else
-                            s.val = value                            
-                            value += 1
-                        end
-                        @symbols[s.name] = s
-                    end
-                end                
-            end
-            @schema            
-        end
-
-        # @param nameOrVal [String,Integer]
-        # @return [Sym]
-        # @return [nil]
-        def symbol(nameOrVal)
-            if nameOrVal.kind_of? String
-                @symbols[nameOrVal]
-            else
-                @symbols.values.detect{|s|s.val == nameOrVal.to_i}
-            end
-        end
-
-    end
-end

data/lib/slow_blink/incremental_annotation.rb

@@ -1,151 +0,0 @@
-# @license
-#   
-#   Copyright (c) 2016 Cameron Harper
-#     
-#   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.
-
-
-module SlowBlink
-
-    # Blink Specification 7.3
-    class IncrementalAnnotation
-
-        # @return [SchemaRef, DefinitionRef, DefinitionTypeRef, FieldRef, FieldTypeRef]
-        attr_reader :componentReference
-
-        # @return [Array<Integer,Annotation>]
-        attr_reader :annotes
-
-        # @macro location
-        attr_reader :location
-
-        # @param componentReference [SchemaRef, DefinitionRef, DefinitionTypeRef, FieldRef, FieldTypeRef] annotation target
-        # @param annotes [Array<Integer,Annotation>]
-        # @param location [String]    
-        def initialize(componentReference, annotes, location)
-            @componentReference = componentReference
-            @annotes = annotes
-            @location = location
-            @schema = nil
-        end
-
-        # @api private
-        #
-        # Apply annotes to targets
-        #
-        # @param schema [Schema]
-        # @param namespace [Namespace] the namespace this annotation was defined in
-        #
-        def apply(schema, namespace)
-            if @schema.nil?
-                case @componentReference.class
-                when SchemaRef # this actually refers to the Namespace
-                    namespace.annote(@annotes)
-                    @schema = schema
-                when DefinitionRef
-                    object = schema.resolve(@componentReference.namespace, @componentReference.name)
-                    if object
-                        object.annote(@annotes)
-                        @schema = schema
-                    end
-                when DefinitionTypeRef
-                    object = schema.resolve(@componentReference.namespace, @componentReference.name)
-                    if object
-                        object.type.annote(@annotes)
-                        @schema = schema
-                    end
-                when FieldRef
-                    object = schema.resolve(@componentReference.namespace, @componentReference.name)
-                    if object
-                        field = object.field(@componentReference.subname)
-                        if field
-                            field.annote(@annotes)
-                            @schema = schema
-                        end                    
-                    end                
-                when FieldTypeRef
-                    object = schema.resolve(@componentReference.namespace, @componentReference.name)
-                    if object
-                        field = object.field(@componentReference.subname)
-                        if field
-                            field.type.annote(@annotes)
-                            @schema = schema
-                        end                    
-                    end                
-                else
-                    raise ParseError.new "unknown component reference #{@componentReference.class}".freeze
-                end                    
-            end
-            @schema                
-        end        
-        
-    end
-
-    # SCHEMA
-    class SchemaRef
-        def self.===(other)
-            self == other
-        end
-    end
-
-    # qName
-    class DefinitionRef < SchemaRef
-        attr_reader :namespace
-        attr_reader :name
-        attr_reader :qname
-        # @param qName [String] name of the definition to annotate
-        def initialize(qname)
-            @qname = qname
-            if qname.split(":").size == 1
-                @namespace = nil
-                @name = qname                
-            else                
-                @namespace = qname.split(":").first
-                @name = qName.split(":").last
-            end
-        end
-    end
-
-    # qName.TYPE
-    class DefinitionTypeRef < DefinitionRef
-    end
-
-    # qName.name
-    class FieldRef < SchemaRef
-        attr_reader :namespace
-        attr_reader :name
-        attr_reader :qname
-        attr_reader :subname
-        def initialize(qname, name)
-            @qname = qname
-            if qname.split(":").size == 1
-                @namespace = nil
-                @name = qname                
-            else                
-                @namespace = qname.split(":").first
-                @name = qName.split(":").last
-            end
-            @subname = name
-        end
-    end
-
-    # qName.name.TYPE
-    class FieldTypeRef < FieldRef
-    end
-    
-end

data/lib/slow_blink/log.rb

@@ -1,51 +0,0 @@
-# @license
-#   
-#   Copyright (c) 2016 Cameron Harper
-#     
-#   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.
-
-
-module SlowBlink
-
-    class Log
-
-        @file = STDERR
-    
-        def self.file=(file)
-            @file = file
-        end
-
-        def self.file
-            @file
-        end
-
-        def self.error(msg)
-            if @file
-                @file.puts(msg)
-            end
-        end
-
-        def self.info(msg)
-            if @file
-                @file.puts(msg)
-            end
-        end
-    
-    end
-
-end

data/lib/slow_blink/message/sequence.rb

@@ -1,98 +0,0 @@
-# @license
-#   
-#   Copyright (c) 2016 Cameron Harper
-#    
-#   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.
-
-module SlowBlink::Message
-
-    # @abstract
-    class SEQUENCE
-
-        # @return the type that repeats in this SEQUENCE
-        def self.type
-            @type
-        end
-
-        # @private
-        def self.from_compact!(input, stack)
-
-            if stack.size < @maxRecursion
-                stack << self
-            else
-                raise RecursionLimit
-            end
-        
-            value = []
-            size = input.getU32!
-            if size
-                while value.size < size do
-                    value << @type.from_compact!(input, stack)
-                end
-                result = self.new(value)
-            else
-                result = nil
-            end
-
-            stack.pop
-
-            result
-                
-        end
-
-        # @return [Array]
-        def get
-            @value.map{|v|v.get}
-        end
-
-        # Set value of a SEQUENCE
-        #
-        # @param value [Array]
-        # @raise [TypeError]
-        # @raise [RangeError]
-        def set(value)
-            @value = []
-            if value.kind_of? Array
-                value.each do |v|
-                    if v.kind_of? self.class.type
-                        @value << v
-                    else
-                        @value << self.class.type.new(v)
-                    end
-                end
-            else
-                raise TypeError.new "expecting an array"
-            end
-        end
-
-        # @note calls {#set}(value)
-        def initialize(value)       
-            set(value)            
-        end
-
-        # @private
-        def to_compact(out)
-            out.putU32(@value.size)
-            @value.each do |value|                                
-                value.to_compact(out)
-            end            
-        end
-
-    end
-
-end

data/lib/slow_blink/name_with_id.rb

@@ -1,49 +0,0 @@
-# @license
-#   
-#   Copyright (c) 2016 Cameron Harper
-#     
-#   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.
-
-
-module SlowBlink
-    class NameWithID
-
-        include Annotatable
-
-        # @return [String]
-        attr_reader :name
-
-        # @return [Integer,nil]
-        attr_reader :id
-
-        # @param name [String]
-        # @param id [nil,Integer]
-        def initialize(name, id)
-            @annotes = {}
-            @name = name
-            @id = id            
-        end
-
-        # @api private
-        # @param value [Integer]        
-        def id=(value)
-            @id = id
-        end
-        
-    end
-end