qrpc 0.4.0 → 0.9.0

data/lib/qrpc/locator/em-jack.rb

@@ -0,0 +1,160 @@
+# encoding: utf-8
+# (c) 2011 Martin Kozák (martinkozak@martinkozak.net)
+
+require "hash-utils/array"
+require "unified-queues"
+require "em-jack"
+
+##
+# General QRPC module.
+#
+
+module QRPC
+    
+    ##
+    # Resource locators.
+    #
+    
+    module Locator
+      
+        ##
+        # Locator for 'em-jack' (so EventMachine Beanstalk implementation) 
+        # queue type.
+        #
+        # @see https://github.com/dj2/em-jack
+        # @since 0.9.0
+        # 
+        
+        class EMJackLocator
+
+            ##
+            # Holds the input queue interface.
+            # @return [UnifiedQueues::Multi] input queue
+            #
+            
+            @input_queue
+
+            ##
+            # Holds the input queue interface.
+            # @return [UnifiedQueues::Multi] output queue
+            #
+            
+            @output_queue
+                        
+            ##
+            # Contains queue name.
+            # @return [String]
+            #
+    
+            attr_accessor :queue_name
+            @queue_name
+            
+            ##
+            # Contains host.
+            # @return [String]
+            #
+    
+            attr_accessor :host
+            @host
+            
+            ##
+            # Contains port.
+            # @return [Integer]
+            #
+    
+            attr_accessor :port
+            @port
+            
+            ##
+            # Parser.
+            #
+            
+            PARSER = /^(.+)@(.+)(?:\:(\d+))?$/
+            
+            ##
+            # Default port.
+            #
+            
+            DEFAULT_PORT = 11300
+            
+            ##
+            # Constructor.
+            #
+            # @param [String, Symbol] queue_name queue name
+            # @param [String] host host name
+            # @param [Integer] port port of the host
+            #
+            
+            def initialize(queue_name, host = "localhost", port = 11300)
+                @queue_name = queue_name.to_s
+                @host = host
+                @port = port
+            end
+            
+            ##
+            # Parses the locator.
+            # Excpects form +<queue>@<host>:<port>+. Port is optional.
+            #
+            # @param [String] string locator in string form
+            # @return [QRPC::Locator] new instance
+            #
+            
+            def self.parse(string)
+                match = string.match(self::PARSER)
+                
+                queue = match.first
+                host = match.second
+                
+                if match.length == 3
+                    port = match.third
+                else
+                    port = self::DEFAULT_PORT
+                end
+                
+                port = port.to_i
+                
+                ##
+                
+                return self::new(queue, host, port);
+            end
+            
+            ##
+            # Converts back to string.
+            # @return [String] locator in string form
+            #
+            
+            def to_s
+                @queue_name + "@" + @host + ":" + @port.to_s
+            end
+            
+            ##
+            # Returns universal queue interface for input queue.
+            # @return [UnifiedQueues::Multi] queue
+            #
+            
+            def input_queue
+                if @input_queue.nil?
+                    @input_queue = UnifiedQueues::Multi::new EMJack::Connection, :host => @host, :port => @port
+                else
+                    @input_queue
+                end
+            end
+
+            ##
+            # Returns universal queue interface for output queue.
+            # @return [UnifiedQueues::Multi] queue
+            #
+                        
+            def output_queue
+                if @output_queue.nil?
+                    @output_queue = UnifiedQueues::Multi::new EMJack::Connection, :host => @host, :port => @port
+                else
+                    @output_queue
+                end
+            end
+                
+        end
+        
+    end
+    
+end

data/lib/qrpc/locator/evented-queue.rb

@@ -0,0 +1,101 @@
+# encoding: utf-8
+# (c) 2011 Martin Kozák (martinkozak@martinkozak.net)
+
+require "priority_queue/c_priority_queue"
+require "hash-utils/array"
+require "unified-queues"
+require "evented-queue"
+require "em-wrapper"
+
+##
+# General QRPC module.
+#
+
+module QRPC
+    
+    ##
+    # Resource locators.
+    #
+    
+    module Locator
+      
+        ##
+        # Locator for 'evented-queue' queue type.
+        #
+        # @see https://github.com/martinkozak/evented-queue
+        # @since 0.9.0
+        # 
+        
+        class EventedQueueLocator
+            
+            ##
+            # Contains queue name.
+            # @return [String]
+            #
+    
+            attr_accessor :queue_name
+            @queue_name
+            
+            ##
+            # Contains queue instance.
+            # @return [EventedQueue::Recurring]
+            #
+    
+            attr_accessor :queue
+            @queue
+            
+            ##
+            # Constructor.
+            # @param [EventedQueue::Recurring] queue  recurring evented queue instance
+            #
+            
+            def initialize(queue_name, queue = self.default_queue)
+                @queue = queue
+                @queue_name = queue_name
+            end
+            
+            ##
+            # Returns the default evented queue type.
+            #
+            
+            def default_queue 
+                UnifiedQueues::Multi::new UnifiedQueues::Single, ::EM::Wrapper::new(REUQ),  UnifiedQueues::Single, CPriorityQueue
+            end
+            
+            alias :input_queue :queue
+            alias :output_queue :queue
+        
+            
+            ##
+            # Helper recurring evented queue with unified queues support.
+            # @since 0.9.0
+            #
+        
+            class REUQ < ::EventedQueue::Recurring
+              
+                ##
+                # Constructor.
+                #
+                
+                def initialize(*args)
+                    cls = args.first
+                    args.shift
+                    object = cls::new(*args)
+                    super(object)
+                end
+            end    
+        end
+    end
+end
+
+=begin
+q = QRPC::Locator::EventedQueue::new
+q.input_queue.use(:xyz)
+q.queue.push(:x, 2)
+q.queue.push(:y, 3)
+q.queue.subscribe(:xyz)
+q.queue.pop do |i|
+    p i
+end
+q.queue.push(:z, 1)
+=end

data/lib/qrpc/protocol/abstract.rb

@@ -0,0 +1,119 @@
+# encoding: utf-8
+# (c) 2011 Martin Kozák (martinkozak@martinkozak.net)
+
+require "hash-utils/object"
+require "hash-utils/module"
+require "qrpc/general"
+require "hashie/mash"
+require "abstract"
+
+##
+# General QRPC module.
+#
+
+module QRPC
+    
+    ##
+    # Protocols helper module.
+    # @since 0.9.0
+    #
+    
+    module Protocol
+
+        ##
+        # Abstract protocol implementation.
+        #
+        # @since 0.9.0
+        # @abstract
+        #
+        
+        class Abstract
+          
+            ##
+            # Holds general object options.
+            # @return [Hashie::Mash]  general options
+            #
+            
+            attr_accessor :options
+            @options
+            
+            ##
+            # Holds classes to modules assignment cache.
+            # 
+            
+            @module_cache
+                    
+            ##
+            # Constructor.
+            #
+            # @param [Hash] options general options for submodules
+            # @abstract
+            #
+            
+            def initialize(options = { })
+                @options = Hashie::Mash::new(options)
+                @module_cache = { }
+                
+                if self.instance_of? Abstract
+                    not_implemented
+                end
+            end
+            
+            ##
+            # Returns new request object.
+            # @return [Class]  class of the request object
+            #
+            
+            def request
+                __module(:Request)
+            end
+            
+            ##
+            # Returns new response object.
+            # @return [Class]  class of the response object
+            #
+            
+            def response
+                __module(:Response)
+            end
+            
+            ##
+            # Returns new error object.
+            # @return [Class]  class of the error object
+            #
+            
+            def error
+                __module(:Error)
+            end
+                        
+
+            private
+            
+            ##
+            # Returns class from module according to specific driver
+            def __module(name)
+                mod = Module.get_module(self.class.name + "::" + name.to_s)
+                
+                if not mod.in? @module_cache
+                    cls = Class::new(mod)
+                    opt = @options
+                    
+                    cls.class_eval do
+                        define_method :initialize do |options = { }, &block|
+                            super(opt.merge(options), &block)
+                        end
+                        
+                        define_singleton_method :options do 
+                            opt
+                        end
+                    end
+
+                    @module_cache[mod] = cls                    
+                end
+                    
+                @module_cache[mod]
+            end
+            
+        end       
+    end
+end

data/lib/qrpc/protocol/abstract/error.rb

@@ -0,0 +1,54 @@
+# encoding: utf-8
+# (c) 2011 Martin Kozák (martinkozak@martinkozak.net)
+
+require "abstract"
+require "qrpc/general"
+require "qrpc/protocol/abstract/object"
+
+##
+# General QRPC module.
+#
+
+module QRPC
+    
+    ##
+    # Protocols helper module.
+    # @since 0.9.0
+    #-
+    
+    module Protocol
+
+        ##
+        # Abstract protocol implementation.
+        # @since 0.9.0
+        #
+        
+        class Abstract
+        
+            ##
+            # Abstract error object implementation.
+            #
+            # @since 0.9.0
+            # @abstract
+            #
+            
+            class Error < Object
+              
+                ##
+                # Constructor.
+                #
+                # @param [Hash] init  initial options
+                # @abstract
+                #
+                
+                def initialize(init = { })
+                    super(init)
+                    if self.instance_of? Error
+                        not_implemented
+                    end
+                end
+ 
+            end
+        end
+    end
+end

data/lib/qrpc/protocol/abstract/object.rb

@@ -0,0 +1,81 @@
+# encoding: utf-8
+# (c) 2011 Martin Kozák (martinkozak@martinkozak.net)
+
+require "abstract"
+require "hashie/mash"
+require "qrpc/general"
+require "qrpc/protocol/abstract"
+
+##
+# General QRPC module.
+#
+
+module QRPC
+    
+    ##
+    # Protocols helper module.
+    # @since 0.9.0
+    #
+    
+    module Protocol
+
+        ##
+        # Abstract protocol implementation.
+        # @since 0.9.0
+        #
+        
+        class Abstract
+        
+            ##
+            # Abstract request implementation.
+            # @sice 0.9.0
+            #
+            
+            class Object
+              
+                ##
+                # Holds the object options.
+                # @return [Hashie::Mash]  options hash
+                #
+                
+                attr_accessor :options
+                @options
+                
+                ##
+                # Constructor.
+                #
+                # @param [Hash] init  initial options
+                # @abstract
+                #
+                
+                def initialize(init = { })
+                    @options = Hashie::Mash::new(init)
+                    if self.instance_of? Object
+                        not_implemented
+                    end
+                end
+                
+                ##
+                # Assigns options to the object.
+                # @param [Hash] options  hash with options
+                # 
+                
+                def assign_options(options = { })
+                    @options = @options.merge(options)
+                end
+                
+                ##
+                # Serializes object to the resultant form.
+                #
+                # @return [String]  serialized form
+                # @abstract
+                #
+                
+                def serialize
+                    not_implemented
+                end
+                
+            end
+        end
+    end
+end