bps 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5de5e6e993f0b96c93224163f85fc0cd3ef5a9ecf7d03487df35315ee3bd153b
+  data.tar.gz: cfaa3b821549d70bee5094321553123493d9e66fca4cf15fa50ccdb0f4c5a04d
+SHA512:
+  metadata.gz: c4d068aa91b285af2a124a258a13207298c3c0f9202fe39f197e21a9fd49a53f433de12cf4817b78b265b2920deeaa402a014cba0fe74da3b258570688b8fb1e
+  data.tar.gz: 4b7f0fa9bf89e079e05312e4d202af107b102c51079166704ca4641146942a0b3a692a0605d52bf0e46bbb8d8847b0969a8c8c20e763308d160988cff1c7d9c5

data/bps.gemspec

@@ -0,0 +1,19 @@
+Gem::Specification.new do |s|
+  s.name        = 'bps'
+  s.version     = File.read(File.expand_path('../../.version', __dir__)).strip
+  s.platform    = Gem::Platform::RUBY
+
+  s.licenses    = ['Apache-2.0']
+  s.summary     = 'Multi-platform pubsub adapter'
+  s.description = 'Minimalist abstraction for publish-subscribe'
+
+  s.authors     = ['Black Square Media']
+  s.email       = 'info@blacksquaremedia.com'
+  s.homepage    = 'https://github.com/bsm/bps'
+
+  s.executables   = []
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- spec/*`.split("\n")
+  s.require_paths = ['lib']
+  s.required_ruby_version = '>= 2.6.0'
+end

data/lib/bps.rb

@@ -0,0 +1,52 @@
+require 'uri'
+require 'cgi'
+
+module BPS
+  autoload :Coercer, 'bps/coercer'
+
+  module Publisher
+    autoload :Abstract, 'bps/publisher/abstract'
+
+    def self.register(*schemes, &resolver)
+      @registry ||= {}
+      schemes.each do |scheme|
+        @registry[scheme] = resolver
+      end
+    end
+
+    def self.resolve(url)
+      url = url.is_a?(::URI) ? url.dup : URI.parse(url)
+      rsl = @registry[url.scheme]
+      raise ArgumentError, "Unable to resolve publisher #{url}, scheme #{url.scheme} is not registered" unless rsl
+
+      opts = {}
+      CGI.parse(url.query.to_s).each do |key, values|
+        opts[key.to_sym] = values.first
+      end
+      rsl.call(url, opts)
+    end
+  end
+
+  module Subscriber
+    autoload :Abstract, 'bps/subscriber/abstract'
+
+    def self.register(*schemes, &resolver)
+      @registry ||= {}
+      schemes.each do |scheme|
+        @registry[scheme] = resolver
+      end
+    end
+
+    def self.resolve(url)
+      url = url.is_a?(::URI) ? url.dup : URI.parse(url)
+      rsl = @registry[url.scheme]
+      raise ArgumentError, "Unable to resolve subscriber #{url}, scheme #{url.scheme} is not registered" unless rsl
+
+      opts = {}
+      CGI.parse(url.query.to_s).each do |key, values|
+        opts[key.to_sym] = values.first
+      end
+      rsl.call(url, opts)
+    end
+  end
+end

data/lib/bps/coercer.rb

@@ -0,0 +1,64 @@
+require 'set'
+
+module BPS
+  class Coercer
+    TRUE_VALUES = [true, 'TRUE', 'true', 'T', 't', 1, '1'].to_set
+
+    attr_reader :schema
+
+    def initialize(schema)
+      validate!(schema)
+      @schema = schema
+    end
+
+    def coerce(hash)
+      coerce_with(@schema, hash)
+    end
+
+    private
+
+    def validate!(schema)
+      schema.each do |key, type|
+        case type
+        when :string, :symbol, :int, :float, :bool
+          # OK
+        when Hash
+          validate!(type)
+        when Array
+          raise ArgumentError, "Array types must have exactly one entry, but was (#{key} => #{type.inspect})" unless type.size == 1
+        else
+          raise ArgumentError, "Unknown type #{type.inspect}"
+        end
+      end
+    end
+
+    def coerce_with(schema, hash)
+      clone = {}
+      schema.each do |key, type|
+        next unless hash.key?(key)
+
+        clone[key] = coerce_value(type, hash[key])
+      end
+      clone
+    end
+
+    def coerce_value(type, val)
+      case type
+      when :string
+        val&.to_s
+      when :symbol
+        val&.to_sym
+      when :int
+        val&.to_i
+      when :float
+        val&.to_f
+      when :bool
+        val.nil? ? nil : TRUE_VALUES.include?(val)
+      when Hash
+        val.is_a?(Hash) ? coerce_with(type, val) : nil
+      when Array
+        Array(val).map {|v| coerce_value(type[0], v) }
+      end
+    end
+  end
+end

data/lib/bps/publisher/abstract.rb

@@ -0,0 +1,24 @@
+module BPS
+  module Publisher
+    class Abstract
+      class Topic
+        # Publish a message.
+        def publish(_message, **_opts)
+          raise 'not implemented'
+        end
+
+        # Flush any remaining buffer.
+        def flush(**); end
+      end
+
+      # Retrieve a topic handle.
+      # @params [String] name the topic name.
+      def topic(_name)
+        raise 'not implemented'
+      end
+
+      # Close the publisher.
+      def close; end
+    end
+  end
+end

data/lib/bps/subscriber/abstract.rb

@@ -0,0 +1,14 @@
+module BPS
+  module Subscriber
+    class Abstract
+      # Subscribe to a topic
+      # @params [String] topic the topic name.
+      def subscribe(_topic, **)
+        raise 'not implemented'
+      end
+
+      # Close the subscriber.
+      def close; end
+    end
+  end
+end

data/spec/bps/coercer_spec.rb

@@ -0,0 +1,42 @@
+require 'spec_helper'
+
+RSpec.describe BPS::Coercer do
+  subject do
+    described_class.new(
+      name: :string,
+      codec: :symbol,
+      retries: :int,
+      backoff: :float,
+      idempotent: :bool,
+      tags: [:string],
+    )
+  end
+
+  let :options do
+    {
+      name: 123,
+      codec: 'snappy',
+      retries: '4',
+      backoff: '10',
+      idempotent: '1',
+      tags: [:foo, 33],
+      extra: 'foo',
+    }
+  end
+
+  it 'should validate' do
+    expect { described_class.new(name: :unknown) }.to raise_error(ArgumentError, /Unknown type :unknown/)
+    expect { described_class.new(bad: []) }.to raise_error(ArgumentError, /Array types must have exactly one entry/)
+  end
+
+  it 'should coerce options' do
+    expect(subject.coerce(options)).to eq(
+      name: '123',
+      codec: :snappy,
+      retries: 4,
+      backoff: 10.0,
+      idempotent: true,
+      tags: %w[foo 33],
+    )
+  end
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: bps
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Black Square Media
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-07-01 00:00:00.000000000 Z
+dependencies: []
+description: Minimalist abstraction for publish-subscribe
+email: info@blacksquaremedia.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- bps.gemspec
+- lib/bps.rb
+- lib/bps/coercer.rb
+- lib/bps/publisher/abstract.rb
+- lib/bps/subscriber/abstract.rb
+- spec/bps/coercer_spec.rb
+homepage: https://github.com/bsm/bps
+licenses:
+- Apache-2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.4
+signing_key: 
+specification_version: 4
+summary: Multi-platform pubsub adapter
+test_files:
+- spec/bps/coercer_spec.rb