demux 0.1.0.beta

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 24735d1c05b065cef6a590c511594ad2e4aee7c51218debb1eb1cfbc859fa50b
+  data.tar.gz: 65d933eb7a814ed3da0125d0c313f90b4dc4994ff743c4b8b3b2f434fdc50941
+SHA512:
+  metadata.gz: 922f311246e08d28291199fc61955a710a9d5f5fa6c7fa4f979bfa946f947569933c5bbd152690af011df311d29f156d7138be2db814e31ce9fecd261c1d03d5
+  data.tar.gz: e40331c445703f6dfc8753bb8399084ef5f694e92e194761b283bd91d45587df0dcb0e94e80969035cf9f5a50fcab602ac63940518b000e5e46d7c814da53400

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2020 Ross Reinhardt
+
+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,36 @@
+[![Build Status](https://travis-ci.com/rreinhardt9/demux.svg?branch=master)](https://travis-ci.com/rreinhardt9/demux)
+
+# Demux
+Short description and motivation.
+
+## Usage
+How to use my plugin.
+
+## Installation
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'demux'
+```
+
+And then execute:
+```bash
+$ bundle
+```
+
+Or install it yourself as:
+```bash
+$ gem install demux
+```
+
+## Contributing
+After cloning repo:
+
+- install gems `bundle install`
+- set up the databases `bundle exec rake db:setup`
+- If you run into trouble setting up databases because of a missing postgres role, you can create one by running `psql` and then running `ALTER ROLE postgres LOGIN CREATEDB;`
+- If you cannot start `psql` because you are missing a database named after your local user, you can create one using `createdb`
+- You should not be able to run the tests `bundle exec rake`
+
+## License
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,32 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rdoc/task'
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Demux'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.md')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+APP_RAKEFILE = File.expand_path("test/dummy/Rakefile", __dir__)
+load 'rails/tasks/engine.rake'
+
+load 'rails/tasks/statistics.rake'
+
+require 'bundler/gem_tasks'
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+task default: :test

data/app/assets/config/demux_manifest.js

@@ -0,0 +1 @@
+//= link_directory ../stylesheets/demux .css

data/app/assets/stylesheets/demux/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/app/controllers/demux/application_controller.rb

@@ -0,0 +1,5 @@
+module Demux
+  class ApplicationController < ActionController::Base
+    protect_from_forgery with: :exception
+  end
+end

data/app/helpers/demux/application_helper.rb

@@ -0,0 +1,4 @@
+module Demux
+  module ApplicationHelper
+  end
+end

data/app/jobs/demux/application_job.rb

@@ -0,0 +1,4 @@
+module Demux
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/mailers/demux/application_mailer.rb

@@ -0,0 +1,6 @@
+module Demux
+  class ApplicationMailer < ActionMailer::Base
+    default from: 'from@example.com'
+    layout 'mailer'
+  end
+end

data/app/models/demux/app.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require "jwt"
+
+module Demux
+  # Demux::App represents an external app that can be connected to an account
+  # in the parent application.
+  class App < ApplicationRecord
+    URL_REGEX = %r{\A(http(s?)\://.+)?\z}i.freeze
+
+    has_many :connections
+    has_many :transmissions
+    has_secure_token :secret
+
+    validates :entry_url, :signal_url, format: { with: URL_REGEX }
+
+    validates :name, presence: true
+
+    class << self
+      def listening_for(signal_name:, account_id:)
+        connections = Demux::Connection.listening_for(
+          signal_name: signal_name,
+          account_id: account_id
+        )
+
+        joins(:connections)
+          .merge(connections)
+          .where.not(signal_url: nil)
+      end
+
+      def without_queued_transmissions_for(signal_hash)
+        joins(
+          <<~SQL
+          LEFT OUTER JOIN demux_transmissions
+          ON demux_transmissions.app_id = demux_apps.id
+          AND demux_transmissions.status = 0
+          AND demux_transmissions.uniqueness_hash = '#{signal_hash}'
+          SQL
+        )
+          .where(demux_transmissions: { id: nil })
+      end
+
+      def transmission_requested_all(signal_attributes)
+        without_queued_transmissions_for(signal_attributes.hashed).each do |app|
+          app.transmission_requested(signal_attributes)
+        end
+      end
+    end
+
+    def transmission_requested(signal_attributes)
+      transmissions.queue(signal_attributes)
+    end
+
+    # Return an entry url with JWT payload for authorization
+    #
+    # @param data [Hash] data to sign and include in token payload
+    # @param exp [Integer] expiration of token in seconds since the epoch
+    #
+    # @return [String] the entry url with signed token appended
+
+    def signed_entry_url(data: {}, exp: 1.minute.from_now.to_i)
+      token = JWT.encode({ data: data, exp: exp }, secret, "HS256")
+      "#{entry_url}?token=#{token}"
+    end
+  end
+end

data/app/models/demux/application_record.rb

@@ -0,0 +1,5 @@
+module Demux
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/models/demux/connection.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Demux
+  class Connection < ApplicationRecord
+    belongs_to :app
+
+    class << self
+      def listening_for(signal_name:, account_id:)
+        where(account_id: account_id)
+          .signal(signal_name)
+          .or(wildcard_signal)
+      end
+
+      def signal(signal)
+        where("demux_connections.signals @> ?", "{#{signal}}")
+      end
+
+      private
+
+      def wildcard_signal
+        where("demux_connections.signals @> ?", "{*}")
+      end
+    end
+
+    # Return an entry url for this specific connection
+    #
+    # @return [String] the entry url with account_id in signed token
+
+    def entry_url
+      app.signed_entry_url(data: { account_id: account_id })
+    end
+  end
+end

data/app/models/demux/transmission.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module Demux
+  # Demux::Transmission represents a signal being sent to an app
+  class Transmission < ApplicationRecord
+    belongs_to :app
+
+    before_save :update_uniqueness_hash
+
+    enum status: %i[queued sending success failure]
+
+    class << self
+      def for_app(app_relation)
+        joins(:app).merge(app_relation)
+      end
+
+      def queue(signal_attributes)
+        create(signal_attributes.to_hash)
+      rescue ActiveRecord::RecordNotUnique
+        # Unique index by status/uniqueness_hash
+      end
+    end
+
+    def transmit
+      return self unless attributes_required_to_transmit_present?
+
+      update(
+        request_url: app.signal_url,
+        request_body: payload.to_json,
+        status: :sending
+      )
+
+      save_receipt(Transmitter.new(self).transmit.receipt)
+
+      self
+    end
+
+    def save_receipt(receipt)
+      update(
+        status: receipt.success? ? :success : :failure,
+        response_code: receipt.http_code,
+        response_body: receipt.response_body,
+        request_headers: receipt.request_headers
+      )
+    end
+
+    def signal_name
+      signal.signal_name
+    end
+
+    def signature
+      OpenSSL::HMAC.hexdigest("SHA256", app.secret, request_body)
+    end
+
+    private
+
+    def signal_url
+      app.signal_url
+    end
+
+    def payload
+      @payload ||= { action: action }.merge(signal.payload_for(action))
+    end
+
+    def signal
+      @signal ||= signal_class.constantize.new(
+        object_id, account_id: account_id
+      )
+    end
+
+    def update_uniqueness_hash
+      return unless attributes_required_to_transmit_present?
+
+      self.uniqueness_hash = SignalAttributes.from_object(self).hashed
+    end
+
+    def attributes_required_to_transmit_present?
+      account_id? && action? && object_id? && signal_class?
+    end
+  end
+end

data/app/views/layouts/demux/application.html.erb

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Demux</title>
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+
+  <%= stylesheet_link_tag    "demux/application", media: "all" %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>

data/config/routes.rb

@@ -0,0 +1,2 @@
+Demux::Engine.routes.draw do
+end

data/db/migrate/20200423143645_create_demux_apps.rb

@@ -0,0 +1,16 @@
+class CreateDemuxApps < ActiveRecord::Migration[5.1]
+  def change
+    create_table :demux_apps do |t|
+      t.string :name
+      t.text :description
+      t.string :secret
+      t.string :entry_url
+      t.string :signal_url
+      t.text :signals, array:true, default: []
+
+      t.timestamps
+    end
+    add_index :demux_apps, :signals, using: "gin"
+    add_index :demux_apps, :secret, unique: true
+  end
+end

data/db/migrate/20200423144102_create_demux_connections.rb

@@ -0,0 +1,14 @@
+class CreateDemuxConnections < ActiveRecord::Migration[5.1]
+  def change
+    create_table :demux_connections do |t|
+      t.integer :account_id
+      t.integer :app_id
+      t.text :signals, array:true, default: []
+
+      t.timestamps
+    end
+    add_index :demux_connections, :signals, using: "gin"
+    add_index :demux_connections, :account_id
+    add_index :demux_connections, :app_id
+  end
+end

data/db/migrate/20200505201706_create_demux_transmissions.rb

@@ -0,0 +1,23 @@
+class CreateDemuxTransmissions < ActiveRecord::Migration[5.2]
+  def change
+    create_table :demux_transmissions do |t|
+      t.string :signal_class
+      t.string :action
+      t.integer :object_id
+      t.integer :app_id
+      t.integer :account_id
+      t.integer :status, default: 0
+      t.string :response_code
+      t.jsonb :response_headers
+      t.text :response_body
+      t.jsonb :request_headers
+      t.text :request_body
+      t.string :request_url
+      t.string :uniqueness_hash
+
+      t.timestamps
+    end
+    add_index :demux_transmissions, :app_id
+    add_index :demux_transmissions, [:uniqueness_hash, :app_id], unique: true, where: "status = 0"
+  end
+end

data/lib/demux.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require "demux/engine"
+require "demux/demuxer"
+require "demux/signal"
+require "demux/signal_attributes"
+require "demux/transmitter"
+
+# Demux toplevel namespace
+module Demux
+  # Access the current configuration
+
+  module_function
+
+  def configuration
+    @configuration ||= Configuration.new
+  end
+
+  # Alias so that we can refer to configuration as config
+
+  def config
+    configuration
+  end
+
+  # Configure the library
+  #
+  # @yieldparam [Demux::Configuration] current_configuration
+  #
+  # @example
+  #   Demux.configure do |config|
+  #     config.default_demuxer = "Demux::Demuxer"
+  #   end
+  #
+  # @yieldreturn [Demux::Configuration]
+
+  def configure
+    yield configuration
+  end
+
+  # Configuration holds the current configuration for the SeisimicAPI
+  # and provides defaults
+  class Configuration
+    attr_accessor :default_demuxer
+
+    def initialize(args = {})
+      @default_demuxer = args.fetch(:default_demuxer) { Demux::Demuxer }
+    end
+  end
+end

data/lib/demux/demuxer.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Demux
+  # Demux::Demuxer is the heart of pairing signals to apps.
+  # It's a base implementation of what needs to happen, but apps can
+  # provide their own custom demuxer that calls out to this one.
+  #
+  # For example a host application will likely want to process signals in a
+  # background queue and can supply their own demuxer with details on how that
+  # should happen.
+  class Demuxer
+    def initialize(signal_attributes)
+      @signal_attributes = signal_attributes
+      @account_id = @signal_attributes.account_id
+      @signal_class = @signal_attributes.signal_class
+    end
+
+    def send_to_apps
+      queue_transmissions
+
+      queued_transmissions.each(&:transmit)
+
+      self
+    end
+
+    def queued_transmissions
+      Transmission
+        .queued
+        .for_app(listening_apps)
+        .where(uniqueness_hash: @signal_attributes.hashed)
+    end
+
+    def listening_apps
+      Demux::App.listening_for(
+        signal_name: @signal_class.constantize.signal_name,
+        account_id: @account_id
+      )
+    end
+
+    def queue_transmissions
+      listening_apps.transmission_requested_all(@signal_attributes)
+
+      self
+    end
+  end
+end

data/lib/demux/engine.rb

@@ -0,0 +1,5 @@
+module Demux
+  class Engine < ::Rails::Engine
+    isolate_namespace Demux
+  end
+end

data/lib/demux/signal.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Demux
+  # All signals will inherit from Demux::Signal. A signal represent a message
+  # to be demuxed and sent to apps.
+  class Signal
+    attr_reader :account_id
+
+    class << self
+      attr_reader :object_class, :signal_name
+
+      def attributes(attr)
+        @object_class = attr.fetch(:object_class)
+        @signal_name = attr.fetch(:signal_name)
+      end
+    end
+
+    def signal_name
+      self.class.signal_name
+    end
+
+    def initialize(object_id,
+                   account_id:,
+                   demuxer: Demux.config.default_demuxer)
+      @object_id = Integer(object_id)
+      @account_id = account_id
+      @demuxer = demuxer
+    end
+
+    def object
+      @object ||= self.class.object_class.find(@object_id)
+    end
+
+    def payload_for(action)
+      if respond_to?("#{action}_payload")
+        public_send("#{action}_payload")
+      else
+        payload
+      end
+    end
+
+    def send(action)
+      @demuxer.new(
+        SignalAttributes.new(
+          account_id: @account_id,
+          action: String(action),
+          object_id: @object_id,
+          signal_class: self.class.name
+        )
+      ).send_to_apps
+
+      self
+    end
+  end
+end

data/lib/demux/signal_attributes.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Demux
+  # Attributes that are commonly used to identify a signal
+  class SignalAttributes
+    attr_reader :account_id, :action, :object_id, :signal_class
+
+    class << self
+      def from_object(object)
+        new(
+          account_id: object.account_id,
+          action: object.action,
+          object_id: object.object_id,
+          signal_class: object.signal_class
+        )
+      end
+    end
+
+    def initialize(account_id:, action:, object_id:, signal_class:)
+      @account_id = account_id
+      @action = action
+      @object_id = object_id
+      @signal_class = String(signal_class)
+    end
+
+    def to_hash
+      {
+        account_id: @account_id,
+        action: @action,
+        object_id: @object_id,
+        signal_class: @signal_class
+      }
+    end
+
+    def hashed
+      Base64.strict_encode64({
+        account_id: account_id,
+        action: action,
+        object_id: object_id,
+        signal_class: signal_class
+      }.to_json)
+    end
+  end
+end

data/lib/demux/transmitter.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+require "net/http"
+
+module Demux
+  # Transmit a Transmission
+  class Transmitter
+    attr_reader :receipt
+    # Constructor
+    #
+    # @param transmission [Demux::Transmission] the transmission to be sent
+    #
+    # @return [self] the initialized Demux::Transmitter
+
+    def initialize(transmission)
+      @transmission = transmission
+      @uri = URI(@transmission.request_url)
+      @receipt = NullTransmissionReceipt.new
+    end
+
+    # Use the transmitter to send it's transmission
+    #
+    # @return [self]
+
+    def transmit
+      build_request
+
+      send_request
+
+      @receipt = TransmissionReceipt.new(@request, @response)
+
+      log_transmission
+
+      self
+    end
+
+    private
+
+    def build_request
+      @request = Net::HTTP::Post.new(@uri).tap do |request|
+        request["X-Demux-Signal"] = @transmission.signal_name
+        request["X-Demux-Signature"] = @transmission.signature
+        request["Content-Type"] = "application/json"
+        request["User-Agent"] = "Demux"
+        request.body = @transmission.request_body
+      end
+    end
+
+    def send_request
+      @response =
+        Net::HTTP.start(@uri.hostname, @uri.port, use_ssl: true) do |http|
+          http.request(@request)
+        end
+    end
+
+    def log_transmission
+      Rails.logger.debug(
+        "Send #{@transmission.signal_name}/#{@transmission.action} signal \
+            to #{@uri} \
+            with payload #{@transmission.request_body}"
+      )
+    end
+  end
+
+  # Null object to represent having no receipt
+  class NullTransmissionReceipt
+    def success?
+      nil
+    end
+
+    def http_code
+      nil
+    end
+
+    def request_headers
+      {}
+    end
+
+    def request_body
+      ""
+    end
+
+    def response_body
+      ""
+    end
+  end
+
+  # Returned when the Transmitter transmits
+  # @see Demux::Transmitter
+  class TransmissionReceipt
+    def initialize(request, response)
+      @raw_request = request
+      @raw_response = response
+    end
+
+    # Was the response code 2xx
+    #
+    # @return [Boolean]
+
+    def success?
+      @raw_response.is_a?(Net::HTTPSuccess)
+    end
+
+    # HTTP code of response
+    #
+    # @return [Integer] http code
+
+    def http_code
+      Integer(@raw_response.code)
+    end
+
+    # Headers that were sent with request
+    #
+    # @return [Hash] Hash of headers
+
+    def request_headers
+      @raw_request.each_header.to_h
+    end
+
+    # Body of the request
+    #
+    # @return [String] request body
+
+    def request_body
+      @raw_request.body
+    end
+
+    # Body of the response
+    #
+    # @return [String] response body
+
+    def response_body
+      @raw_response.body
+    end
+  end
+end

data/lib/demux/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Demux
+  VERSION = "0.1.0.beta"
+end

data/lib/tasks/demux_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :demux do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,139 @@
+--- !ruby/object:Gem::Specification
+name: demux
+version: !ruby/object:Gem::Version
+  version: 0.1.0.beta
+platform: ruby
+authors:
+- Ross Reinhardt
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-05-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: jwt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.5'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.5'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
+- !ruby/object:Gem::Dependency
+  name: pg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Configure your application to send signals to a constellation of other
+  'apps'
+email:
+- rreinhardt9@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/assets/config/demux_manifest.js
+- app/assets/stylesheets/demux/application.css
+- app/controllers/demux/application_controller.rb
+- app/helpers/demux/application_helper.rb
+- app/jobs/demux/application_job.rb
+- app/mailers/demux/application_mailer.rb
+- app/models/demux/app.rb
+- app/models/demux/application_record.rb
+- app/models/demux/connection.rb
+- app/models/demux/transmission.rb
+- app/views/layouts/demux/application.html.erb
+- config/environment.rb
+- config/routes.rb
+- db/migrate/20200423143645_create_demux_apps.rb
+- db/migrate/20200423144102_create_demux_connections.rb
+- db/migrate/20200505201706_create_demux_transmissions.rb
+- lib/demux.rb
+- lib/demux/demuxer.rb
+- lib/demux/engine.rb
+- lib/demux/signal.rb
+- lib/demux/signal_attributes.rb
+- lib/demux/transmitter.rb
+- lib/demux/version.rb
+- lib/tasks/demux_tasks.rake
+homepage: https://github.com/rreinhardt9/demux
+licenses:
+- MIT
+metadata: {}
+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: 1.3.1
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: Configure your application to send signals to a constellation of other 'apps'
+test_files: []