wisper_next 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: '0459c713e32f3b3412978d72d812d8f4e9255aedf613b4ebfbee65df9f8a3c11'
+  data.tar.gz: 2f51f8cc5cab7bb02eb4f90f6259410133b740a074cf560be8ef853c3830c966
+SHA512:
+  metadata.gz: 05f51893bb546d9471f3de2537dbf9857d8649ea0170fef570fb00bd93184a67428e60a534a362dd04218ef554ae4d5ca2a5d7f78d2bc0192b6c399220b782a3
+  data.tar.gz: 0bfa67250f7b639f1c6d43d4ebc15bd1a863cef18e15c80c3c87b17c7f8e467c49a480f770911bc714f902a5ddb3afd9804065fb3723ff5f0fe279a33a570721

data.tar.gz.sig

@@ -0,0 +1,2 @@
+�ʇ:�L��l��xA֑�OyG/ ��֋������ҋk4o��^�=����v:г��h�d8u�`-��̽�6��o��#k6l����U��Z�V��j
+�Ê8	{x잱�������&U��*� �k~��SVU1�a@

data/.gitignore

@@ -0,0 +1,17 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/.pry_history
+
+# rspec failure tracking
+.rspec_status
+
+Gemfile.lock
+
+TODO
+REFACTORS

data/.gitlab-ci.yml

@@ -0,0 +1,14 @@
+image: "ruby:2.6"
+
+cache:
+  paths:
+    - vendor/ruby
+
+before_script:
+  - ruby -v
+  - gem install bundler
+  - bundle install -j $(nproc) --path vendor
+
+rspec:
+  script:
+    - bundle exec rspec spec

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.ruby-version

@@ -0,0 +1 @@
+2.6

data/CHANGELOG.md

@@ -0,0 +1,13 @@
+# CHANGELOG
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+- Added: Ability for an object to publish events
+- Added: Ability for an object to map from events to methods
+- Added: An Event object for creating global pub/sub
+

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at kris.leech@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+gemspec
+
+gem "bundler", "~> 2.0"
+gem "rake", "~> 10.0"
+gem "rspec", "~> 3.0"
+gem 'pry'

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 Kris Leech
+
+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.

data/README.md

@@ -0,0 +1,150 @@
+# WisperNext
+
+This is the next version of Wisper. Alpha only.
+
+## Installation
+
+```ruby
+gem 'wisper_next'
+```
+
+## Usage
+
+### Publishing
+
+```ruby
+class MyPublisher
+  include WisperNext.publisher
+
+  def call
+    broadcast(:wow, x: rand(10), y: rand(10), at: Time.now)
+  end
+end
+```
+
+A publisher can broadcast events, the first argument is the event name followed
+by an optional payload.
+
+### Listeners
+
+#### Objects
+
+```ruby
+class MyListener
+  def on_event(event_name, payload)
+    puts "#{event_name} received with #{payload.inspect}"
+  end
+end
+```
+
+We can then subscribe an instance of our listener to the publisher:
+
+```ruby
+publisher = MyPublisher.new
+publisher.subscribe(MyListener.new)
+publisher.call
+```
+
+#### Blocks
+
+Blocks can be subscribed to a specific event name.
+
+```ruby
+publisher = MyPublisher.new
+publisher.on(:wow) { |payload| puts(payload) }
+publisher.call
+```
+
+### Enhanced Listeners
+
+By including `Wisper.subscriber` you can get additional features.
+
+Firstly instead of `#on_event` you provide a method for every event the
+listener may receive. For example if our publisher broadcasts a "user_created"
+event then the listener would provide a `user_created` method which receives
+the payload.
+
+```ruby
+class MyListener
+  include Wisper.subscriber
+  
+  def user_created(payload)
+    #...
+  end
+end
+```
+
+If the listener receives an event for which there is no method an exception
+is raised.
+
+You can opt-out of this behaviour by setting the `strict` option to false:
+
+```ruby
+include Wisper.subscriber(strict: false)
+```
+
+#### Prefixing broadcast events
+
+The method called can be prefixed with `on_`:
+
+```ruby
+class MyListener
+  include Wisper.subscriber(prefix: true)
+  
+  def on_user_created(payload)
+    #...
+  end
+end
+```
+
+#### Handling Events Asynchronously
+
+WisperNext has adapters for asynchronous event handling, please refer to
+<TODO>.
+
+```ruby
+include Wisper.subscriber(async: :true)
+```
+
+If you are interested in building an async adapter and releasing it as a gem
+please get in touch.
+
+#### Passing options
+
+If the value for an option being passed to subscriber is `true` then you can
+use a symbol instead to mean the same thing.
+
+So `WisperNext.subscriber(async: true)` and `WisperNext.subscriber(:async)` are
+the same. You can pass multiple symbols with any key/values at the end,
+e.g. `WisperNext.subscriber(:async, :prefix, strict: false)`.
+
+### Global Subscriptions
+
+```ruby
+EVENTS = WisperNext::Events.new
+
+EVENTS.subscribe(MyListener.new)
+
+EVENTS.broadcast('user_promoted', user: user)
+```
+
+## Security
+
+* gem releases are [signed]()
+* commits are GPG [signed]()
+
+## Development
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/krisleech/wisper_next.
+
+This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the WisperNext project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/wisper_next/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "wisper_next"
+
+require "pry"
+Pry.start

data/bin/setup

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install

data/keys/gem-public_cert.pem

@@ -0,0 +1,20 @@
+-----BEGIN CERTIFICATE-----
+MIIDQDCCAiigAwIBAgIBATANBgkqhkiG9w0BAQsFADAlMSMwIQYDVQQDDBprcmlz
+LmxlZWNoL0RDPWdtYWlsL0RDPWNvbTAeFw0xOTEwMTYxNDEzNDVaFw0yMDEwMTUx
+NDEzNDVaMCUxIzAhBgNVBAMMGmtyaXMubGVlY2gvREM9Z21haWwvREM9Y29tMIIB
+IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA8gg/iZE6RFkl6GjisJJf9wQl
+5Tog+mrGqtylNpe9QKeyQS1fKLNR3Cqmv6sT3f3GlU8hhG+802MXmlJo7VyENs+s
+HdMy85fBnYwhS/szhTzBqduXw43RAAGqB0VaHAoHdufTZBkmFSXET5c0/jUqQrPL
+Zxsm2i0NV8cVpvrZlQcsW4Kf97DG1ZFNncS0IfCDqnluh21qMSgVAuiKHGoVKCYG
+Igey486VuuJ8j6axwW3ii8HoBOxjF8Ka/rJ/t4sB9Ql/p6RHR4RhxP5xIS9geCpI
+dsPGnCSleTW1EnXGHLdOdJpVmJXueYJEQJ1Rh/rR+9PeqAT3RA0D/dxSGIVtrQID
+AQABo3sweTAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUyupX2gb3
++isBRwf4/fhgLnh02sYwHwYDVR0RBBgwFoEUa3Jpcy5sZWVjaEBnbWFpbC5jb20w
+HwYDVR0SBBgwFoEUa3Jpcy5sZWVjaEBnbWFpbC5jb20wDQYJKoZIhvcNAQELBQAD
+ggEBAExirH+Py0Wm8+ZzNnx/oyFXSF7V9FClYhPUXwQ5FmvQG+gXRlonO9IR/HL+
+wGJNFh4B19fpughgQeJKjKJsG2zk2XnSK2yQyyNGdr/9dHXp/TS5sGvX9jFYVeAr
+0XCWXRBK+IfEqNnbFvPkwZEK62WLnrL50gMs3u2ILmLP5gkO3EoLyezJvIj33CLO
+HX0Plp0VwiSp8+gEELX5wtdrnJ/UjmrY1lg7szukE+jgOJ++1e7Rzr+woBewIWvF
+xn3z1ObkNQCnLZMRmzEcSa40T10/AuuuEv32emAgb50u9vz+s4y2lnE9i4mWW7+X
+5vdRgX7VnzYPA+Lc39kD+AcGIrQ=
+-----END CERTIFICATE-----

data/keys/kris.leech.gpg.public

@@ -0,0 +1,81 @@
+-----BEGIN PGP PUBLIC KEY BLOCK-----
+
+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
+=reHQ
+-----END PGP PUBLIC KEY BLOCK-----

data/lib/wisper_next.rb

@@ -0,0 +1,16 @@
+require "wisper_next/version"
+require 'wisper_next/publisher'
+require 'wisper_next/subscriber'
+require 'wisper_next/events'
+
+module WisperNext
+  class Error < StandardError; end
+
+  def self.publisher
+    Publisher.new
+  end
+
+  def self.subscriber(*args)
+    Subscriber.new(*args)
+  end
+end

data/lib/wisper_next/cast_to_options.rb

@@ -0,0 +1,27 @@
+module WisperNext
+  # @api private
+  class CastToOptions
+    # @example
+    #
+    #   def call(*args)
+    #     CastToOptions.call(args)
+    #   end
+    #
+    #   call(:strict, :async: false) # => { strict: true, async: false }
+    #
+    def self.call(arguments)
+      arguments.reduce({}) do |memo, item|
+        case item
+        when Symbol
+          memo[item] = true
+        when Hash
+          memo.merge!(item)
+        else
+          raise(ArgumentError, "Unsupported option: #{item.inspect} (#{item.class.name})")
+        end
+
+        memo
+      end
+    end
+  end
+end

data/lib/wisper_next/events.rb

@@ -0,0 +1,33 @@
+# Global events bus
+#
+# @example
+#
+# # In application boot/initialization
+# #
+# EVENTS = WisperNext::Events.new
+#
+# EVENTS.subscribe(MyListener.new)
+#
+# # Domain model
+# #
+# class MyCommand
+#   def initialize(dependencies = {})
+#     @events = dependencies.fetch(:events) { EVENTS }
+#   end
+#
+#   def call(id)
+#     user = User.find(id)
+#
+#     if user.promote!
+#       @events.broadcast('user_promoted', user: user)
+#     end
+#   end
+# end
+#
+# @api public
+module WisperNext
+  class Events
+    include ::WisperNext::Publisher.new
+    public :broadcast
+  end
+end

data/lib/wisper_next/publisher.rb

@@ -0,0 +1,129 @@
+module WisperNext
+
+  # Extension to provide objects with subscription and publishing capabilties
+  #
+  # @example
+  #
+  # class PromoteUser
+  #   include Wisper.publisher
+  #
+  #   def call
+  #     # ...
+  #     broadcast(:user_promoted, user_id: user.id, ts: Time.now)
+  #   end
+  # end
+  #
+  # class NotifyUserOfPromotion
+  #   def on_event(name, payload)
+  #     puts "#{name} => #{payload.inspect}"
+  #   end
+  # end
+  #
+  # command = PromoteUser.new
+  # command.subscribe(NotifyUserOfPromotion.new)
+  # command.call
+  #
+  class Publisher < Module
+    def included(descendant)
+      super
+      descendant.send(:include, Methods)
+    end
+
+    # Exception raised when a listener is already subscribed
+    #
+    # @api public
+    #
+    ListenerAlreadyRegisteredError = Class.new(StandardError) do
+      # @api private
+      def initialize(listener)
+        super("listener #{listener.inspect} is already subscribed")
+      end
+    end
+
+    # Exception raised when a listener does not have an #on_event method
+    #
+    # @api public
+    #
+    NoEventHandlerError = Class.new(ArgumentError) do
+      # @api private
+      def initialize(listener)
+        super("listener #{listener.inspect} does not have an #on_event method")
+      end
+    end
+
+    module Methods
+      # returns true when given listener is already subscribed
+      #
+      # @param [Object] listener
+      #
+      # @return [Boolean]
+      #
+      # @api public
+      #
+      def subscribed?(listener)
+        subscribers.include?(listener)
+      end
+
+      # subscribes given listener
+      #
+      # @param [Object] listener
+      #
+      # @return [Object] self
+      #
+      # @api public
+      #
+      def subscribe(listener)
+        raise ListenerAlreadyRegisteredError.new(listener) if subscribed?(listener)
+        raise NoEventHandlerError.new(listener) unless listener.respond_to?(:on_event)
+        subscribers.push(listener)
+        self
+      end
+
+      # subscribes the given block to an event
+      #
+      # @param [String, Symbol] event name
+      #
+      # @return [Object] self
+      #
+      # @api public
+      #
+      def on(name, &block)
+        raise ArgumentError, 'must pass a block' unless block_given?
+        subscribe(CallableAdapter.new(name, block))
+        self
+      end
+
+      private
+
+      # Broadcast event to all subscribed listeners
+      #
+      # @param [String,Symbol] event name
+      #
+      # @param [Object] optional payload
+      #
+      # @return [Object] self
+      #
+      # @api public
+      #
+      def broadcast(name, payload = nil)
+        subscribers.each do |s|
+          s.public_send(:on_event, name, payload)
+        end
+
+        self
+      end
+
+      # Returns subscribed listeners
+      #
+      # @return [Array<Object>] collection of subscribers
+      #
+      # @api private
+      #
+      def subscribers
+        @subscribers ||= []
+      end
+    end
+  end
+end
+
+require_relative 'publisher/callable_adapter'

data/lib/wisper_next/publisher/callable_adapter.rb

@@ -0,0 +1,27 @@
+# Wraps a callable (typically a proc) so it conforms to the listener interface
+#
+# @api private
+#
+module WisperNext
+  class Publisher
+    class CallableAdapter
+      attr_reader :event_name, :callable
+
+      def initialize(event_name, callable)
+        @event_name  = event_name
+        @callable    = callable
+        freeze
+      end
+
+      def on_event(name, payload)
+        if name == @event_name
+          @callable.call(payload)
+        end
+      end
+
+      def ==(other)
+        other == callable
+      end
+    end
+  end
+end

data/lib/wisper_next/subscriber.rb

@@ -0,0 +1,68 @@
+require_relative 'cast_to_options'
+
+module WisperNext
+  class Subscriber < Module
+    EmptyHash = {}.freeze
+
+    def initialize(*args)
+      options = CastToOptions.(args)
+
+      strict      = options.fetch(:strict, true)
+      prefix      = options.fetch(:prefix, false)
+      broadcaster = resolve_broadcaster(options)
+
+      # maps event to another method
+      #
+      # @param [Symbol] event name
+      #
+      # @return [Object] payload
+      #
+      # @api public
+      #
+      define_method :on_event do |name, payload|
+        method_name = ResolveMethod.(name, prefix)
+
+        if respond_to?(method_name)
+          broadcaster.call(self, method_name, payload)
+        else
+          if strict
+            raise NoMethodError.new(name)
+          else
+            # no-op
+          end
+        end
+      end
+    end
+
+    NoMethodError = Class.new(StandardError) do
+      # @api private
+      def initialize(event_name)
+        super("No method found for #{event_name} event")
+      end
+    end
+
+    private
+
+    def resolve_broadcaster(options)
+      value = options[:async] || options[:broadcaster] || SendBroadcaster.new
+
+      case value
+      when Hash
+        broadcaster_for(:async, value)
+      when TrueClass
+        broadcaster_for(:async)
+      when Symbol, String
+        broadcaster_for(value)
+      else
+        value
+      end
+    end
+
+    def broadcaster_for(name, opts = EmptyHash)
+      self.class.const_get("#{name.to_s.capitalize}Broadcaster").new(opts)
+    end
+  end
+end
+
+require_relative 'subscriber/send_broadcaster'
+require_relative 'subscriber/resolve_method'

data/lib/wisper_next/subscriber/resolve_method.rb

@@ -0,0 +1,14 @@
+module WisperNext
+  class Subscriber
+    class ResolveMethod
+      def self.call(name, prefix)
+        if prefix
+          "on_#{name}"
+        else
+          name
+        end
+      end
+    end
+  end
+end
+

data/lib/wisper_next/subscriber/send_broadcaster.rb

@@ -0,0 +1,20 @@
+# Default synchronous broadcaster which sends event to subscriber
+#
+# @api private
+module WisperNext
+  class Subscriber
+    class SendBroadcaster
+      def initialize(options = {})
+        @public_send = options.fetch(:public_send, true)
+      end
+
+      def call(subscriber, event_name, payload)
+        if @public_send
+          subscriber.public_send(event_name, payload)
+        else
+          subscriber.send(event_name, payload)
+        end
+      end
+    end
+  end
+end

data/lib/wisper_next/version.rb

@@ -0,0 +1,3 @@
+module WisperNext
+  VERSION = "0.1.0"
+end

data/wisper_next.gemspec

@@ -0,0 +1,34 @@
+lib = File.expand_path("lib", __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "wisper_next/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "wisper_next"
+  spec.version       = WisperNext::VERSION
+  spec.authors       = ["Kris Leech"]
+  spec.email         = ["kris.leech@gmail.com"]
+
+  spec.summary       = "A micro library providing Ruby objects with Publish-Subscribe capabilities"
+  spec.description   = "A micro library providing Ruby objects with Publish-Subscribe capabilities"
+  spec.homepage      = "https://gitlab.com/kris.leech/wisper_next"
+  spec.license       = "MIT"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "https://gitlab.com/kris.leech/wisper_next/blob/master/CHANGELOG.md"
+
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  signing_key = File.expand_path(ENV['HOME'].to_s + '/.ssh/gem-private_key.pem')
+
+  if File.exist?(signing_key)
+    spec.signing_key = signing_key
+    spec.cert_chain  = ['keys/gem-public_cert.pem']
+  end
+end

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification
+name: wisper_next
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kris Leech
+autorequire: 
+bindir: exe
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDQDCCAiigAwIBAgIBATANBgkqhkiG9w0BAQsFADAlMSMwIQYDVQQDDBprcmlz
+  LmxlZWNoL0RDPWdtYWlsL0RDPWNvbTAeFw0xOTEwMTYxNDEzNDVaFw0yMDEwMTUx
+  NDEzNDVaMCUxIzAhBgNVBAMMGmtyaXMubGVlY2gvREM9Z21haWwvREM9Y29tMIIB
+  IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA8gg/iZE6RFkl6GjisJJf9wQl
+  5Tog+mrGqtylNpe9QKeyQS1fKLNR3Cqmv6sT3f3GlU8hhG+802MXmlJo7VyENs+s
+  HdMy85fBnYwhS/szhTzBqduXw43RAAGqB0VaHAoHdufTZBkmFSXET5c0/jUqQrPL
+  Zxsm2i0NV8cVpvrZlQcsW4Kf97DG1ZFNncS0IfCDqnluh21qMSgVAuiKHGoVKCYG
+  Igey486VuuJ8j6axwW3ii8HoBOxjF8Ka/rJ/t4sB9Ql/p6RHR4RhxP5xIS9geCpI
+  dsPGnCSleTW1EnXGHLdOdJpVmJXueYJEQJ1Rh/rR+9PeqAT3RA0D/dxSGIVtrQID
+  AQABo3sweTAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUyupX2gb3
+  +isBRwf4/fhgLnh02sYwHwYDVR0RBBgwFoEUa3Jpcy5sZWVjaEBnbWFpbC5jb20w
+  HwYDVR0SBBgwFoEUa3Jpcy5sZWVjaEBnbWFpbC5jb20wDQYJKoZIhvcNAQELBQAD
+  ggEBAExirH+Py0Wm8+ZzNnx/oyFXSF7V9FClYhPUXwQ5FmvQG+gXRlonO9IR/HL+
+  wGJNFh4B19fpughgQeJKjKJsG2zk2XnSK2yQyyNGdr/9dHXp/TS5sGvX9jFYVeAr
+  0XCWXRBK+IfEqNnbFvPkwZEK62WLnrL50gMs3u2ILmLP5gkO3EoLyezJvIj33CLO
+  HX0Plp0VwiSp8+gEELX5wtdrnJ/UjmrY1lg7szukE+jgOJ++1e7Rzr+woBewIWvF
+  xn3z1ObkNQCnLZMRmzEcSa40T10/AuuuEv32emAgb50u9vz+s4y2lnE9i4mWW7+X
+  5vdRgX7VnzYPA+Lc39kD+AcGIrQ=
+  -----END CERTIFICATE-----
+date: 2019-11-01 00:00:00.000000000 Z
+dependencies: []
+description: A micro library providing Ruby objects with Publish-Subscribe capabilities
+email:
+- kris.leech@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".gitlab-ci.yml"
+- ".rspec"
+- ".ruby-version"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- keys/gem-public_cert.pem
+- keys/kris.leech.gpg.public
+- lib/wisper_next.rb
+- lib/wisper_next/cast_to_options.rb
+- lib/wisper_next/events.rb
+- lib/wisper_next/publisher.rb
+- lib/wisper_next/publisher/callable_adapter.rb
+- lib/wisper_next/subscriber.rb
+- lib/wisper_next/subscriber/resolve_method.rb
+- lib/wisper_next/subscriber/send_broadcaster.rb
+- lib/wisper_next/version.rb
+- wisper_next.gemspec
+homepage: https://gitlab.com/kris.leech/wisper_next
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://gitlab.com/kris.leech/wisper_next
+  source_code_uri: https://gitlab.com/kris.leech/wisper_next
+  changelog_uri: https://gitlab.com/kris.leech/wisper_next/blob/master/CHANGELOG.md
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.6
+signing_key: 
+specification_version: 4
+summary: A micro library providing Ruby objects with Publish-Subscribe capabilities
+test_files: []

metadata.gz.sig

@@ -0,0 +1,2 @@
+W�9qg`����{��dSK�C������n�E�
�g�ɘ����CBvVU�A�p�|ۺ�'Kzd�^H��yH�{�Uo!gƤ�[rx�qG�3�h4�}I$?G�şp=��%�2�z#H�c�ЏU��\<2߭ūC*"jN'�Y�v�!�K$��⥱�8��.������Z
+;