langrove 0.0.4.5 → 0.0.5.3

data/lib/langrove/_base.rb

@@ -1,28 +0,0 @@
-#$LOAD_PATH.unshift 'langrove' unless $LOAD_PATH.include?( 'langrove' )
-
-#$LOAD_PATH.inspect
-
-#
-# For the implementation client
-#
-module Adaptor; end
-module Client; end
-module Daemon; end
-module Handler; end
-module Protocol; end
-module Job; end
-
-module LanGrove
-  
-  class DaemonConfigException < Exception; end
-  
-end
-
-require 'langrove/ext'
-
-require 'langrove/daemon/base'
-require 'langrove/adaptor/base'
-require 'langrove/handler/base'
-require 'langrove/protocol/base'
-require 'langrove/client/base'
-require 'langrove/job/base'

data/lib/langrove/adaptor_base.rb

@@ -1,116 +0,0 @@
-require 'eventmachine'
-
-require 'langrove'
-
-module LanGrove::Adaptor
-  
-  class Base
-  
-    def initialize( config, logger )
-    
-      @config = config
-      @logger = logger
-      
-      @transport = :tcp
-      @iface     = '127.0.0.1'
-      @port      = 12701
-      
-      @iface     = @config[ :iface ] if @config.has_key? :iface
-      @port      = @config[ :port ]  if @config.has_key? :port
-      @transport = @config[ :transport ].to_sym  if @config.has_key? :transport
-      
-      #
-      # Assign the call signature for the EventMachine server
-      #
-      @em_server_call = case @transport
-        
-        when :tcp
-          
-          :start_server
-          
-        when :udp
-          
-          :open_datagram_socket
-          
-        else
-          
-          :start_server
-        
-      end
-    
-    end
-  
-    def listen( client, protocol, handler )
-      
-      #
-      # <client> = {
-      # 
-      #    :class   => <loaded class constant>
-      #    :config  => <client's branch of config>
-      # 
-      # } 
-      # 
-      # <protocol> = {  ...the same, but protocolic }
-      #
-      #
-    
-      @logger.info "starting listen at UDP #{@iface}:#{@port}"
-      
-      EventMachine::send( @em_server_call, @iface, @port, 
-      
-        client[:class] ) do | client_connected |
-          
-          #
-          # @em_server_call as:
-          # 
-          # udp - EM::open_datagram_socket, yields an instance of 
-          #       client[:class] into here on bind to the port 
-          #
-          #       ie. at starting to listen
-          #       
-          #       unverified: ? If more than 1 datagram source is 
-          #                   transmitting to here - will there still
-          #                   still be only ONE EM:Connection instance?
-          # 
-          # tcp - EM::start_server yields an new instance of client[:class]
-          #       with every connecting socket pair.
-          #
-          #       ie. On socket pair binding - so each remote client will 
-          #           have it's own associated instance of a client[:class] 
-          #           running in the machine.
-          #
-          
-          
-          #
-          # Initialize the client with the (application layer) Protocol
-          #
-          
-          client_connected.logger = @logger
-          
-          client_connected.config = client[ :config ]
-          
-          client_connected.protocol = protocol[ :class ]\
-          
-            .new( protocol[ :config ], @logger )
-            
-          @logger.info( "TODO: make a reference to the Client on the Handler" )
-     
-          #
-          # Bi-Directionally bind the Client and Handler
-          #
-          handler.connect( client_connected )
-          client_connected.handler = handler
-          
-          #
-          # Client is ready and running inside the reactor
-          #
-          # EM::start_server will yield again on the next connect.
-          # 
-          
-      end
-    
-    end
-  
-  end
-  
-end

data/lib/langrove/client/base.rb

@@ -1,2 +0,0 @@
-module LanGrove::Client; end
-require 'langrove/client_base'

data/lib/langrove/client/datagram.rb

@@ -1,25 +0,0 @@
-module LanGrove
-  
-  module Client
-    
-    class Datagram < Base
-      
-      def receive( data )
-
-        #
-        # Quick hack, datagram client routes
-        # data back to the Handler - to get
-        # back to friday position.
-        # 
-        # But with the gem
-        #
-        
-        @handler.receive( data )
-        
-      end
-       
-    end
-    
-  end
-  
-end

data/lib/langrove/client_base.rb

@@ -1,92 +0,0 @@
-require 'eventmachine'
-require 'langrove'
-
-module LanGrove
-  
-  module Client 
-    
-    class Base < EventMachine::Connection
-    
-      #
-      # Misnomer.
-      #
-      # 
-      # This is not the client,
-      # 
-      # 
-      # It is the server's perspective of the client,
-      # 
-      # These are generally stored in the daemon's
-      # handler collection, 
-      # 
-      # Which contains this and all similar clients,
-      # 
-      # Each bonded through the daemon's connection
-      # adaptor to the socket that couples them to 
-      # their actual client..
-      # 
-     
-      attr_accessor :handler
-      attr_accessor :protocol
-      attr_accessor :config
-      attr_accessor :logger
-      
-      
-      #
-      # Data arriving through the Adaptor is passed
-      # through the config assigned protocol and 
-      # then arrives here in whatever format the 
-      # <Protocol>.decode() method returned.
-      #
-      # 
-      def receive( decoded_data ) 
-
-        #
-        # OVERRIDE
-        # 
-        #   - Inbound data arrived at the adaptor
-        #
-        #   - It has passed through the protocol as
-        #     defined in config.
-        #
-        #     The protocol should have arranged the data 
-        #     into a Hash of: 
-        #  
-        #       - key and value pairs
-        # 
-        #       - key and more_complicated_thing pairs.
-        # 
-        #   - The decoded data was then passed into
-        #     this function.
-        #
-        # 
-
-      end
-
-      def receive_data( data )
-        
-        #
-        # Event machine writes into here at receiving data 
-        # from the client. 
-        # 
-        
-        receive( @protocol.decode( data ) )
-        
-        # 
-        # ?Multi-message protocol? 
-        # 
-        # @protocol.accumulate( multi_message_part, self )
-        #
-        #   ---- With protocol responding directly to source
-        # 
-        #   ---- With protocol then calling receive_decoded()
-        #        via the self being passed in. 
-        #   
-        
-      end
-      
-    end
-
-  end
-
-end

data/lib/langrove/daemon_base.rb

@@ -1,281 +0,0 @@
-require 'eventmachine'
-
-require 'langrove'
-
-module LanGrove::Daemon class Base
-  
-  def listen
-    
-    #
-    # <Client> and <Protocol> are passed into 
-    # the Adaptor.listen for binding onto the 
-    # sockets at connect.
-    #
-    @adaptor.listen( 
-    
-      #
-      # pass Client, Protocol and Handler to 'listener'
-      #
-      
-      { :class => @client, :config => @my_config[ :client ] }, 
-      
-      { :class => @protocol, :config => @my_config[ :protocol ] },
-      
-      @handler
-      
-    )
-    
-  end
-  
-  def stop_daemon
-    
-    #
-    # Handle stopping daemon
-    #
-    @logger.info "#{self} received stop_daemon"
-    @handler.stop_daemon
-    
-  end
-  
-  def reload_daemon
-    
-    #
-    # TODO: Handle reloading daemon properly
-    # 
-    # [ !!complexities abound around reloading config!! ]
-    #
-    
-    @logger.info "#{self} received reload_daemon"
-    @handler.reload_daemon
-    
-  end
-  
-  def schedule
-    
-    @logger.info "#{self} Scheduling periodic ...TODO..."
-    
-    EM::add_periodic_timer( @my_config[ :periodic ] ) do 
-      
-      #
-      # TODO: This can be a lot more usefull than
-      #       then one ticker to one function call
-      #
-      
-      @handler.periodic
-      
-    end if @my_config.has_key? :periodic
-    
-  end
-  
-  def run
-    
-    EventMachine::run do
-      
-      # 
-      # https://github.com/eventmachine/eventmachine/wiki/Protocol-Implementations
-      # 
-      
-      schedule
-      
-      listen if @server
-      
-    end
-    
-  end
-  
-  def initialize( config_hash, daemon_name, logger )
-    
-    @config      = config_hash
-    @daemon_name = daemon_name
-    @logger      = logger
-    @server      = true
-    
-    #
-    # A network connection.
-    #
-    @adaptor = nil
-    
-    #
-    # The client collection class.
-    #
-    @handler = nil
-    
-    #
-    # The client type
-    #
-    @client = nil
-    
-    #
-    # The protocol type
-    #
-    @protocol = nil
-    
-    
-    begin
-      
-      @logger.info "Starting daemon: #{@daemon_name}"
-      
-    rescue
-      
-      #
-      # you shall not pass
-      #
-      raise LanGrove::DaemonConfigException.new( "Requires a logger" )
-      
-    end
-
-    begin
-
-      @my_config = @config[ :daemons ][ @daemon_name ]
-      
-      @server    = @my_config[ :server ] if @my_config.has_key? :server
-      
-      
-      
-      if @my_config[ :adaptor ].has_key? :class
-        
-        adaptor    = @my_config[ :adaptor ][ :class ]
-        
-      else
-      
-        @logger.warn( "Defaulting to Adaptor::Base" )
-        adaptor    = 'Base'
-      
-      end
-      
-      
-      
-      @logger.info "TODO: fall back to default Handler::Base"
-      
-      handler    = @my_config[ :handler ][ :collection ]
-      
-      client     = @my_config[ :client ][ :class ]
-      
-      protocol   = @my_config[ :protocol ][ :class ]
-      
-      @logger.info "TODO: Warn instead of raise and allow nil into ClassLoader -> load default"
-         
-    rescue
-      
-      error = "Missing config item for daemon: #{@daemon_name}" 
-      
-      @logger.error "EXIT: #{error}"
-      
-      raise LanGrove::DaemonConfigException.new( 
-      
-        "Missing config item for daemon: #{@daemon_name}" 
-        
-      )
-        
-    end
-    
-    
-    #
-    # initialize the connection adaptor specified in config
-    # 
-    # daemons:
-    #   name_of_daemon:
-    #     adaptor:
-    #       class: MySocket  <----------( optional )
-    #       transport: tcp|udp
-    #       iface: N.N.n.n
-    #       port: nNn
-    #     handler:
-    #       collection: CollectionOfClients 
-    #
-
-    @logger.info "CREATE: Adaptor::#{adaptor}.new( @my_config[ :adaptor ], logger )"
-    
-    @adaptor = LanGrove::ClassLoader.create( {
-      
-      :module => 'Adaptor',
-      :class  => adaptor
-      
-    } ).new( @my_config[ :adaptor ], logger )
-    
-    
-    #
-    # bind to the handler collection specified in config
-    # 
-    # daemons:
-    #   name_of_daemon:
-    #     adaptor:
-    #       connection: TcpServer
-    #     handler:
-    #       collection: CollectionOfClients  <---------- 
-    #    
-    #  CollectionOfClients ---> is the handler passed into listen()                       
-    #
-
-    @logger.info "CREATE: Handler::#{handler}.new( config_hash, '#{daemon_name}', logger )"
-    
-    @handler = LanGrove::ClassLoader.create( {
-      
-      :module => 'Handler',
-      :class  => handler
-      
-    } ).new( @config, @daemon_name, @logger )
-    
-    
-    #
-    # initialize the client specified in config
-    # 
-    # daemons:
-    #   name_of_daemon:
-    #     client:
-    #       class: Client <---------
-    #     adaptor:
-    #       connection: TcpServer
-    #     handler:
-    #       collection: CollectionOfClients 
-    #
-    #
-    
-    @logger.info "DEFINE: Client::#{client}"
-
-    @client = LanGrove::ClassLoader.create( {
-
-      :module => 'Client',
-      :class  => client
-
-    } )
-    
-    
-    #
-    # initialize the client specified in config
-    # 
-    # daemons:
-    #   name_of_daemon:
-    #     protocol:
-    #       class: Protocol <---------
-    #       more: config
-    #     client:
-    #       class: Client
-    #     adaptor:
-    #       connection: TcpServer
-    #     handler:
-    #       collection: CollectionOfClients 
-    #
-    #
-    
-    @logger.info "DEFINE: Protocol::#{protocol}"
-
-    @protocol = LanGrove::ClassLoader.create( {
-
-      :module => 'Protocol',
-      :class  => protocol
-
-    } )
-    
-    
-    #
-    # Notifiy the handler
-    # 
-    # About to go to listen... 
-    #
-    
-    @handler.start_daemon
- 
-  end
-  
-end; end

data/lib/langrove/ext/find.rb

@@ -1,90 +0,0 @@
-module LanGrove
-  
-  class Find
-    
-    def self.with( arg_hash , &block )
-      
-      type = :file
-      @path = '.'
-      
-      #
-      # TODO: filter 
-      #
-      
-      @incl = nil
-      
-      @relative = false
-      
-      
-        arg_hash.each do |key, value|
-          
-          case key
-            
-            when :type
-            
-              type = value
-              
-            when :path
-              
-              @path = value
-              
-            when :include
-              
-              @incl = value
-              
-            when :relative
-              
-              @relative = value
-              
-          end
- 
-        
-      end
-      
-      self.send( :"find_#{type}", @path,  &block )
-      
-    end
-    
-    def self.find_file( path, &block )
-      
-      puts "in #{path}"
-      
-      Dir.entries( path ).each do | sub |
-        
-        next if sub == '.'
-        next if sub == '..'
-        
-        subdir = "#{path}/#{sub}"
-        
-        begin
-          
-          if @incl.nil? then
-            
-           yield relative(subdir) if block
-            
-          else
-          
-            yield relative(subdir) unless /#{@incl}/.match( subdir ).nil?
-            
-          end
-          
-          next
-          
-        end if File.file?( subdir ) and block
-        
-        find_file( subdir, &block )
-        
-      end
-      
-    end
-    
-    def self.relative( file_path )
-      
-      return file_path.gsub( "#{@path}/",'' ) if @relative
-      return file_path
-      
-    end
-    
-  end
-  
-end