protobuffy 3.1.0

data/lib/protobuf/rpc/servers/zmq_runner.rb

@@ -0,0 +1,51 @@
+require 'ostruct'
+
+module Protobuf
+  module Rpc
+    class ZmqRunner
+      include ::Protobuf::Logger::LogMethods
+
+      def initialize(options)
+        @options = case
+                   when options.is_a?(OpenStruct) then
+                     options.marshal_dump
+                   when options.respond_to?(:to_hash) then
+                     options.to_hash
+                   else
+                     raise "Cannot parser Zmq Server - server options"
+                   end
+
+      end
+
+      def run
+        @server = ::Protobuf::Rpc::Zmq::Server.new(@options)
+        register_signals
+        @server.run do
+          yield if block_given?
+        end
+      end
+
+      def running?
+        @server.try :running?
+      end
+
+      def stop
+        @server.try :stop
+      end
+
+      private
+
+      def register_signals
+        trap(:TTIN) do
+          @server.add_worker
+          log_info { "Increased worker size to: #{@server.total_workers}" }
+        end
+
+        trap(:TTOU) do
+          log_info { "Current worker size: #{@server.workers.size}" }
+          log_info { "Current worker size: #{@server.busy_worker_count}" }
+        end
+      end
+    end
+  end
+end

data/lib/protobuf/rpc/service.rb

@@ -0,0 +1,179 @@
+require 'protobuf/logger'
+require 'protobuf/rpc/client'
+require 'protobuf/rpc/error'
+require 'protobuf/rpc/service_filters'
+
+module Protobuf
+  module Rpc
+    # Object to encapsulate the request/response types for a given service method
+    #
+    RpcMethod = Struct.new("RpcMethod", :method, :request_type, :response_type)
+
+    class Service
+      include ::Protobuf::Logger::LogMethods
+      include ::Protobuf::Rpc::ServiceFilters
+
+      DEFAULT_HOST = '127.0.0.1'.freeze
+      DEFAULT_PORT = 9399
+
+      attr_reader :env, :request
+
+      ##
+      # Constructor!
+      #
+      # Initialize a service with the rpc endpoint name and the bytes
+      # for the request.
+      def initialize(env)
+        @env = env.dup # Dup the env so it doesn't change out from under us
+        @request = env.request
+      end
+
+      ##
+      # Class Methods
+      #
+      # Create a new client for the given service.
+      # See Client#initialize and ClientConnection::DEFAULT_OPTIONS
+      # for all available options.
+      #
+      def self.client(options = {})
+        ::Protobuf::Rpc::Client.new({ :service => self,
+                                      :host => host,
+                                      :port => port }.merge(options))
+      end
+
+      # Allows service-level configuration of location.
+      # Useful for system-startup configuration of a service
+      # so that any Clients using the Service.client sugar
+      # will not have to configure the location each time.
+      #
+      def self.configure(config = {})
+        self.host = config[:host] if config.key?(:host)
+        self.port = config[:port] if config.key?(:port)
+      end
+
+      # The host location of the service.
+      #
+      def self.host
+        @_host ||= DEFAULT_HOST
+      end
+
+      # The host location setter.
+      #
+      def self.host=(new_host)
+        @_host = new_host
+      end
+
+      # An array of defined service classes that contain implementation
+      # code
+      def self.implemented_services
+        classes = (self.subclasses || []).select do |subclass|
+          subclass.rpcs.any? do |(name, _)|
+            subclass.method_defined? name
+          end
+        end
+
+        classes.map(&:name)
+      end
+
+      # Shorthand call to configure, passing a string formatted as hostname:port
+      # e.g. 127.0.0.1:9933
+      # e.g. localhost:0
+      #
+      def self.located_at(location)
+        return if location.nil? || location.downcase.strip !~ /.+:\d+/
+        host, port = location.downcase.strip.split ':'
+        configure(:host => host, :port => port.to_i)
+      end
+
+      # The port of the service on the destination server.
+      #
+      def self.port
+        @_port ||= DEFAULT_PORT
+      end
+
+      # The port location setter.
+      #
+      def self.port=(new_port)
+        @_port = new_port
+      end
+
+      # Define an rpc method with the given request and response types.
+      # This methods is only used by the generated service definitions
+      # and not useful for user code.
+      #
+      def self.rpc(method, request_type, response_type)
+        rpcs[method] = RpcMethod.new(method, request_type, response_type)
+      end
+
+      # Hash containing the set of methods defined via `rpc`.
+      #
+      def self.rpcs
+        @_rpcs ||= {}
+      end
+
+      # Check if the given method name is a known rpc endpoint.
+      #
+      def self.rpc_method?(name)
+        rpcs.key?(name)
+      end
+
+      ##
+      # Instance Methods
+      #
+      # Get a callable object that will be used by the dispatcher
+      # to invoke the specified rpc method. Facilitates callback dispatch.
+      # The returned lambda is expected to be called at a later time (which
+      # is why we wrap the method call).
+      #
+      def callable_rpc_method(method_name)
+        lambda { run_filters(method_name) }
+      end
+
+      # Response object for this rpc cycle. Not assignable.
+      #
+      def response
+        @_response ||= response_type.new
+      end
+
+      # Convenience method to get back to class method.
+      #
+      def rpc_method?(name)
+        self.class.rpc_method?(name)
+      end
+
+      # Convenience method to get back to class rpcs hash.
+      #
+      def rpcs
+        self.class.rpcs
+      end
+
+    private
+
+      def request_type
+        @_request_type ||= env.request_type
+      end
+
+      # Sugar to make an rpc method feel like a controller method.
+      # If this method is not called, the response will be the memoized
+      # object returned by the response reader.
+      #
+      def respond_with(candidate)
+        @_response = candidate
+      end
+      alias_method :return_from_whence_you_came, :respond_with
+
+      def response_type
+        @_response_type ||= env.response_type
+      end
+
+      # Automatically fail a service method.
+      #
+      def rpc_failed(message)
+        message = message.message if message.respond_to?(:message)
+        raise RpcFailed.new(message)
+      end
+    end
+
+    ActiveSupport.run_load_hooks(:protobuf_rpc_service, Service)
+  end
+end

data/lib/protobuf/rpc/service_directory.rb

@@ -0,0 +1,245 @@
+require 'delegate'
+require 'singleton'
+require 'socket'
+require 'set'
+require 'thread'
+require 'timeout'
+
+require 'protobuf/rpc/dynamic_discovery.pb'
+
+module Protobuf
+  module Rpc
+    class ServiceDirectory
+      include ::Singleton
+      include ::Protobuf::Logger::LogMethods
+
+      DEFAULT_ADDRESS = "0.0.0.0"
+      DEFAULT_PORT = 53000
+      DEFAULT_TIMEOUT = 1
+
+      class Listing < Delegator
+        attr_reader :expires_at
+
+        def initialize(server)
+          update(server)
+        end
+
+        def current?
+          !expired?
+        end
+
+        def eql?(other)
+          uuid.eql?(other.uuid)
+        end
+
+        def expired?
+          Time.now.to_i >= @expires_at
+        end
+
+        def hash
+          uuid.hash
+        end
+
+        def ttl
+          [super.to_i, 1].max
+        end
+
+        def update(server)
+          @server = server
+          @expires_at = Time.now.to_i + ttl
+        end
+
+        def __getobj__
+          @server
+        end
+      end
+
+      # Class Methods
+      #
+      class << self
+        attr_writer :address, :port
+      end
+
+      def self.address
+        @address ||= DEFAULT_ADDRESS
+      end
+
+      def self.port
+        @port ||= DEFAULT_PORT
+      end
+
+      def self.start
+        yield(self) if block_given?
+        self.instance.start
+      end
+
+      def self.stop
+        self.instance.stop
+      end
+
+      #
+      # Instance Methods
+      #
+      def initialize
+        reset
+      end
+
+      def all_listings_for(service)
+        if running? && @listings_by_service.key?(service.to_s)
+          @listings_by_service[service.to_s].entries.shuffle
+        else
+          []
+        end
+      end
+
+      def each_listing(&block)
+        @listings_by_uuid.each_value(&block)
+      end
+
+      def lookup(service)
+        if running?
+          if @listings_by_service.key?(service.to_s)
+            @listings_by_service[service.to_s].entries.sample
+          end
+        end
+      end
+
+      def restart
+        stop
+        start
+      end
+
+      def running?
+        !!@thread.try(:alive?)
+      end
+
+      def start
+        unless running?
+          init_socket
+          log_info { sign_message("listening to udp://#{self.class.address}:#{self.class.port}") }
+          @thread = Thread.new { self.send(:run) }
+        end
+
+        self
+      end
+
+      def stop
+        log_info { sign_message("Stopping directory") }
+
+        @thread.try(:kill).try(:join)
+        @socket.try(:close)
+
+        reset
+      end
+
+      private
+
+      def add_or_update_listing(uuid, server)
+        listing = @listings_by_uuid[uuid]
+
+        if listing
+          action = :updated
+          listing.update(server)
+        else
+          action = :added
+          listing = Listing.new(server)
+          @listings_by_uuid[uuid] = listing
+        end
+
+        listing.services.each do |service|
+          @listings_by_service[service] << listing
+        end
+
+        trigger(action, listing)
+        log_debug { sign_message("#{action} server: #{server.inspect}") }
+      end
+
+      def init_socket
+        @socket = UDPSocket.new
+        @socket.setsockopt(::Socket::SOL_SOCKET, ::Socket::SO_REUSEADDR, true)
+
+        if defined?(::Socket::SO_REUSEPORT)
+          @socket.setsockopt(::Socket::SOL_SOCKET, ::Socket::SO_REUSEPORT, true)
+        end
+
+        @socket.bind(self.class.address, self.class.port.to_i)
+      end
+
+      def process_beacon(beacon)
+        server = beacon.server
+        uuid = server.try(:uuid)
+
+        if server && uuid
+          case beacon.beacon_type
+          when ::Protobuf::Rpc::DynamicDiscovery::BeaconType::HEARTBEAT
+            add_or_update_listing(uuid, server)
+          when ::Protobuf::Rpc::DynamicDiscovery::BeaconType::FLATLINE
+            remove_listing(uuid)
+          end
+        else
+          log_info { sign_message("Ignoring incomplete beacon: #{beacon.inspect}") }
+        end
+      end
+
+      def read_beacon
+        data, addr = @socket.recvfrom(2048)
+
+        beacon = ::Protobuf::Rpc::DynamicDiscovery::Beacon.decode(data)
+
+        # Favor the address captured by the socket
+        beacon.try(:server).try(:address=, addr[3])
+
+        beacon
+      end
+
+      def remove_expired_listings
+        log_debug { sign_message("Removing expired listings") }
+        @listings_by_uuid.each do |uuid, listing|
+          remove_listing(uuid) if listing.expired?
+        end
+      end
+
+      def remove_listing(uuid)
+        listing = @listings_by_uuid[uuid] or return
+
+        log_debug { sign_message("Removing listing: #{listing.inspect}") }
+
+        @listings_by_service.each do |service, listings|
+          listings.delete(listing)
+        end
+
+        trigger(:removed, @listings_by_uuid.delete(uuid))
+      end
+
+      def reset
+        @thread = nil
+        @socket = nil
+        @listings_by_uuid = {}
+        @listings_by_service = Hash.new { |h, k| h[k] = Set.new }
+      end
+
+      def run
+        sweep_interval = 1 # sweep expired listings every 1 second
+        next_sweep = Time.now.to_i + sweep_interval
+
+        loop do
+          timeout = [next_sweep - Time.now.to_i, 0.1].max
+          readable = IO.select([@socket], nil, nil, timeout)
+          process_beacon(read_beacon) if readable
+
+          if Time.now.to_i >= next_sweep
+            remove_expired_listings
+            next_sweep = Time.now.to_i + sweep_interval
+          end
+        end
+      rescue => e
+        log_debug { sign_message("ERROR: (#{e.class}) #{e.message}\n#{e.backtrace.join("\n")}") }
+        retry
+      end
+
+      def trigger(action, listing)
+        ::ActiveSupport::Notifications.instrument("directory.listing.#{action}", :listing => listing)
+      end
+    end
+  end
+end