omnihooks 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 06339853f7ece3c68f11ba4915da17e824ccb27d
+  data.tar.gz: 2f4d22b89574c3415920c62daed2fb54c432e213
+SHA512:
+  metadata.gz: 52b3d2514746e528b4cf60b2adfa88fe2dc511b1c03eac56c15abfa224b19c88fe822daa024005d65cf020805ab3df569937413319ffb825559948bba285ac22
+  data.tar.gz: c51daa43fbc940543974b40c4d1568c4f62c7be1ab42ef0daa1c1201dfc8cc8e14dabdc3c242d1a1de3c66b53bd533bbbee9c970721768f20d2eae17ac602b62

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+/spec/examples.txt

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/.ruby-gemsets

@@ -0,0 +1 @@
+omnihooks

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.1.6

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in omnihooks.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Karl Falconer
+
+MIT License
+
+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,31 @@
+# OmniHooks
+
+TODO: Write a gem description
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'omnihooks'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install omnihooks
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/omnihooks/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/lib/omnihooks/builder.rb

@@ -0,0 +1,48 @@
+require "active_support/inflector"
+
+module OmniHooks
+  class Builder < ::Rack::Builder
+
+    def initialize(app, &block)
+      @options = nil
+      if rack14?
+        super
+      else
+        @app = app
+        super(&block)
+        @ins << @app
+      end
+    end
+
+    def rack14?
+      Rack.release.split('.')[1].to_i >= 4
+    end
+
+    def on_failure(&block)
+      OmniHooks.config.on_failure = block
+    end
+
+    def options(options = false)
+      return @options || {} if options == false
+      @options = options
+    end
+
+    def provider(klass, *args, &block)
+      if klass.is_a?(Class)
+        middleware = klass
+      else
+        begin
+          middleware = OmniHooks::Strategies.const_get(klass.to_s.camelize)
+        rescue NameError
+          raise(LoadError.new("Could not find matching strategy for #{klass.inspect}. You may need to install an additional gem (such as omnihooks-#{klass})."))
+        end
+      end
+      args.last.is_a?(Hash) ? args.push(options.merge(args.pop)) : args.push(options)
+      use middleware, *args, &block
+    end
+
+    def call(env)
+      to_app.call(env)
+    end
+  end
+end

data/lib/omnihooks/strategies/developer.rb

@@ -0,0 +1,43 @@
+module OmniHooks
+  module Strategies
+    # The Developer strategy is a very simple strategy that can be used as a
+    # placeholder in your application until a different authentication strategy
+    # is swapped in. It has zero security and should *never* be used in a
+    # production setting.
+    #
+    # ## Usage
+    #
+    # To use the Developer strategy, all you need to do is put it in like any
+    # other strategy:
+    #
+    # @example Basic Usage
+    #
+    #   use OmniAuth::Builder do
+    #     provider :developer
+    #   end
+    #
+    # @example Custom Fields
+    #
+    #   use OmniAuth::Builder do
+    #     provider :developer,
+    #       :fields => [:first_name, :last_name],
+    #       :uid_field => :last_name
+    #   end
+    #
+    # This will create a strategy that, when the user visits `/auth/developer`
+    # they will be presented a form that prompts for (by default) their name
+    # and email address. The auth hash will be populated with these fields and
+    # the `uid` will simply be set to the provided email.
+    class Developer
+      include OmniHooks::Strategy
+
+      event_type do
+        params[:type]
+      end
+
+      event do
+        params
+      end
+    end
+  end
+end

data/lib/omnihooks/strategy.rb

@@ -0,0 +1,303 @@
+require "active_support/notifications"
+
+module OmniHooks
+  # The Strategy is the base unit of OmniHooks's ability to
+  # wrangle multiple providers. Each strategy provided by
+  # OmniHooks includes this mixin to gain the default functionality
+  # necessary to be compatible with the OmniHooks library.
+  module Strategy # rubocop:disable ModuleLength
+    def self.included(base)
+      OmniHooks.strategies << base
+
+      base.extend ClassMethods
+      base.class_eval do
+        option :backend, ActiveSupport::Notifications
+        option :adapter, OmniHooks::Strategy::NotificationAdapter
+        option :namespace_delimiter, '.'
+      end
+    end
+
+    module ClassMethods
+      attr_accessor :namespace
+      # Returns an inherited set of default options set at the class-level
+      # for each strategy.
+      def default_options
+        return @default_options if instance_variable_defined?(:@default_options) && @default_options
+        existing = superclass.respond_to?(:default_options) ? superclass.default_options : {}
+        @default_options = OmniHooks::Strategy::Options.new(existing)
+      end
+
+      # Directly declare a default option for your class. This is a useful from
+      # a documentation perspective as it provides a simple line-by-line analysis
+      # of the kinds of options your strategy provides by default.
+      #
+      # @param name [Symbol] The key of the default option in your configuration hash.
+      # @param value [Object] The value your object defaults to. Nil if not provided.
+      #
+      # @example
+      #
+      #   class MyStrategy
+      #     include OmniAuth::Strategy
+      #
+      #     option :foo, 'bar'
+      #     option
+      #   end
+      def option(name, value = nil)
+        default_options[name] = value
+      end
+
+      # Sets (and retrieves) option key names for initializer arguments to be
+      # recorded as. This takes care of 90% of the use cases for overriding
+      # the initializer in OmniAuth Strategies.
+      def args(args = nil)
+        if args
+          @args = Array(args)
+          return
+        end
+        existing = superclass.respond_to?(:args) ? superclass.args : []
+        (instance_variable_defined?(:@args) && @args) || existing
+      end
+      # This allows for more declarative subclassing of strategies by allowing
+      # default options to be set using a simple configure call.
+      #
+      # @param options [Hash] If supplied, these will be the default options (deep-merged into the superclass's default options).
+      # @yield [Options] The options Mash that allows you to set your defaults as you'd like.
+      #
+      # @example Using a yield to configure the default options.
+      #
+      #   class MyStrategy
+      #     include OmniHooks::Strategy
+      #
+      #     configure_options do |c|
+      #       c.foo = 'bar'
+      #     end
+      #   end
+      #
+      # @example Using a hash to configure the default options.
+      #
+      #   class MyStrategy
+      #     include OmniHooks::Strategy
+      #     configure_options foo: 'bar'
+      #   end
+      def configure_options(options = nil)
+        if block_given?
+          yield default_options
+        else
+          default_options.deep_merge!(options)
+        end
+      end
+
+      def configure(&block)
+        raise ArgumentError, "must provide a block" unless block_given?
+        block.arity.zero? ? instance_eval(&block) : yield(self)
+      end
+      alias :setup :configure
+
+      def subscribe(name, callable = Proc.new)
+        backend.subscribe(namespace.to_regexp(name), adapter.call(callable))
+      end
+
+      def all(callable = Proc.new)
+        backend.subscribe(nil, callable)
+      end
+
+      def listening?(name)
+        namespaced_name = namespace.call(name)
+        backend.notifier.listening?(namespaced_name)
+      end
+      #protected
+      %w(event_type event).each do |fetcher|
+        class_eval <<-RUBY
+          def #{fetcher}(&block)
+            @#{fetcher}_proc = nil unless defined?(@#{fetcher}_proc)
+
+            return @#{fetcher}_proc unless block_given?
+            @#{fetcher}_proc = block
+          end
+          def #{fetcher}_stack(context)
+            compile_stack(self.ancestors, :#{fetcher}, context)
+          end
+        RUBY
+      end
+
+      def instrument(event_type, event_object)
+        backend.instrument(namespace.call(event_type), event_object)
+      end
+
+      private
+
+      def compile_stack(ancestors, method, context)
+        stack = ancestors.inject([]) do |a, ancestor|
+          a << context.instance_eval(&ancestor.send(method)) if ancestor.respond_to?(method) && ancestor.send(method)
+          a
+        end
+        stack.reverse!
+      end
+
+      def adapter
+        default_options.adapter
+      end
+
+      def backend
+        default_options.backend
+      end
+
+      def namespace
+        @namespace ||= OmniHooks::Strategy::Namespace.new(default_options.name, default_options.namespace_delimiter)
+      end
+    end
+
+    class Namespace < Struct.new(:prefix, :delimiter)
+      def call(name = nil)
+        "#{prefix}#{delimiter}#{name}"
+      end
+
+      def to_regexp(name = nil)
+        %r{^#{Regexp.escape(call(name))}}
+      end
+    end
+
+    class NotificationAdapter < Struct.new(:subscriber)
+      def self.call(callable)
+        new(callable)
+      end
+
+      def call(*args)
+        payload = args.last
+        subscriber.call(payload)
+      end
+    end
+
+    class Options < Hashie::Mash; end
+
+    attr_reader :options
+
+    # Initializes the strategy by passing in the Rack endpoint,
+    # the unique URL segment name for this strategy, and any
+    # additional arguments. An `options` hash is automatically
+    # created from the last argument if it is a hash.
+    #
+    # @param app [Rack application] The application on which this middleware is applied.
+    #
+    # @overload new(app, options = {})
+    #   If nothing but a hash is supplied, initialized with the supplied options
+    #   overriding the strategy's default options via a deep merge.
+    # @overload new(app, *args, options = {})
+    #   If the strategy has supplied custom arguments that it accepts, they may
+    #   will be passed through and set to the appropriate values.
+    #
+    # @yield [Class, Options] Yields Parent class and options to block for further configuration.
+    def initialize(app, *args, &block) # rubocop:disable UnusedMethodArgument
+      @app = app
+      @env = nil
+      @options = self.class.default_options.dup
+
+      options.deep_merge!(args.pop) if args.last.is_a?(Hash)
+
+      self.class.args.each do |arg|
+        break if args.empty?
+        options[arg] = args.shift
+      end
+
+      # Make sure that all of the args have been dealt with, otherwise error out.
+      fail(ArgumentError.new("Received wrong number of arguments. #{args.inspect}")) unless args.empty?
+
+      yield self.class, options if block_given?
+    end
+
+    def inspect
+      "#<#{self.class}>"
+    end
+
+    # Duplicates this instance and runs #call! on it.
+    # @param [Hash] The Rack environment.
+    def call(env)
+      dup.call!(env)
+    end
+    # The logic for dispatching any additional actions that need
+    # to be taken. For instance, calling the request phase if
+    # the request path is recognized.
+    #
+    # @param env [Hash] The Rack environment.
+    def call!(env) # rubocop:disable CyclomaticComplexity, PerceivedComplexity
+      @env = env
+
+      return instrument if on_request_path? && OmniHooks.config.allowed_request_methods.include?(request.request_method.downcase.to_sym)
+
+      @app.call(env)
+    end
+
+    def request
+      @request ||= Rack::Request.new(@env)
+    end
+
+    protected
+    attr_reader :app, :env
+
+    # Direct access to the OmniAuth logger, automatically prefixed
+    # with this strategy's name.
+    #
+    # @example
+    #   log :warn, "This is a warning."
+    def log(level, message)
+      OmniHooks.logger.send(level, "(#{name}) #{message}")
+    end
+
+    private
+
+    CURRENT_PATH_REGEX = %r{/$}
+    EMPTY_STRING       = ''.freeze
+
+    def instrument
+      # instance needs to lookup and from the paylook the event type
+      begin
+        evt = get_event
+        evt_type = get_event_type
+        self.class.instrument(evt_type, evt) if evt
+      rescue => e
+        log(:error, e.message)
+        [500, {}, [nil]]
+      else
+        # Send a 200 response back to
+        [200, {}, [nil]]
+      end
+    end
+
+    def path_prefix
+      options[:path_prefix] || OmniHooks.config.path_prefix
+    end
+
+    def name
+      options.name
+    end
+
+    def request_path
+      @request_path ||= options[:request_path].is_a?(String) ? options[:request_path] : "#{path_prefix}/#{name}"
+    end
+
+    def on_request_path?
+      if options.request_path.respond_to?(:call)
+        options.request_path.call(env)
+      else
+        on_path?(request_path)
+      end
+    end
+
+    def on_path?(path)
+      current_path.casecmp(path) == 0
+    end
+
+    def current_path
+      @current_path ||= request.path_info.downcase.sub(CURRENT_PATH_REGEX, EMPTY_STRING)
+    end
+
+    def get_event_type
+      self.class.event_type_stack(self).last
+    end
+
+    def get_event
+      self.class.event_stack(self).last
+    end
+
+  end
+end

data/lib/omnihooks/version.rb

@@ -0,0 +1,3 @@
+module OmniHooks
+  VERSION = "0.0.1"
+end

data/lib/omnihooks.rb

@@ -0,0 +1,76 @@
+require 'rack'
+require 'singleton'
+require 'logger'
+require 'hashie'
+require 'omnihooks/builder'
+require 'omnihooks/strategy'
+
+module OmniHooks
+
+  module Strategies
+  end
+
+  # 
+  # Collection of current strategies
+  # 
+  # @return [Array<Object>] strategy collection
+  def self.strategies
+    @strategies ||= []
+  end
+
+  class Configuration
+    include Singleton
+
+    attr_accessor :logger, :path_prefix, :allowed_request_methods
+
+    def self.default_logger
+      logger = Logger.new(STDOUT)
+      logger.progname = 'omnihooks'
+      logger
+    end
+
+    def self.defaults
+      @defaults ||= {
+        logger: default_logger,
+        path_prefix: '/hooks',
+        allowed_request_methods: [:post]
+      }
+    end
+
+    def initialize
+      self.class.defaults.each_pair { |k, v| send("#{k}=", v) }
+    end
+  end
+
+
+  def self.config
+    Configuration.instance
+  end
+
+  def self.configure
+    yield config
+  end
+
+  def self.logger
+    config.logger
+  end
+
+  module Utils
+    module_function
+
+    def deep_merge(hash, other_hash)
+      target = hash.dup
+
+      other_hash.keys.each do |key|
+        if other_hash[key].is_a?(::Hash) && hash[key].is_a?(::Hash)
+          target[key] = deep_merge(target[key], other_hash[key])
+          next
+        end
+
+        target[key] = other_hash[key]
+      end
+
+      target
+    end
+  end
+end

data/omnihooks.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'omnihooks/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "omnihooks"
+  spec.version       = OmniHooks::VERSION
+  spec.authors       = ["Karl Falconer"]
+  spec.email         = ["karl.falconer@falconerdevelopment.com"]
+  spec.summary       = 'A generalized framework for multiple-provider webhooks subscriptions.'
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "activesupport", ">= 3.1"
+  spec.add_dependency 'rack', '~> 1.0'
+  spec.add_dependency 'hashie', ['>= 1.2', '< 4']
+  
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency 'rspec', '~> 3.3.0'
+end

data/spec/omnihooks/builder_spec.rb

@@ -0,0 +1,48 @@
+require 'spec_helper'
+
+RSpec.describe OmniHooks::Builder do
+  describe '#provider' do
+    it 'translates a symbol to a constant' do
+      expect(OmniHooks::Strategies).to receive(:const_get).with('MyStrategy').and_return(Class.new)
+      OmniHooks::Builder.new(nil) do
+        provider :my_strategy
+      end
+    end
+
+    it 'accepts a class' do
+      class ExampleClass; end
+      expect do
+        OmniHooks::Builder.new(nil) do
+          provider ::ExampleClass
+        end
+      end.not_to raise_error
+    end
+
+    it "raises a helpful LoadError message if it can't find the class" do
+      expect do
+        OmniHooks::Builder.new(nil) do
+          provider :lorax
+        end
+      end.to raise_error(LoadError, 'Could not find matching strategy for :lorax. You may need to install an additional gem (such as omnihooks-lorax).')
+    end
+  end
+  describe '#options' do
+    it 'merges provided options in' do
+      k = Class.new
+      b = OmniHooks::Builder.new(nil)
+      expect(b).to receive(:use).with(k, :foo => 'bar', :baz => 'tik')
+
+      b.options :foo => 'bar'
+      b.provider k, :baz => 'tik'
+    end
+
+    it 'adds an argument if no options are provided' do
+      k = Class.new
+      b = OmniHooks::Builder.new(nil)
+      expect(b).to receive(:use).with(k, :foo => 'bar')
+
+      b.options :foo => 'bar'
+      b.provider k
+    end
+  end  
+end

data/spec/omnihooks/strategy_spec.rb

@@ -0,0 +1,302 @@
+require 'spec_helper'
+
+def make_env(path = '/hooks/test', props = {})
+  {
+    'REQUEST_METHOD' => 'POST',
+    'PATH_INFO' => path,
+    'rack.session' => {},
+    'rack.input' => StringIO.new('test=true'),
+  }.merge(props)
+end
+
+
+RSpec.describe OmniHooks::Strategy do
+  let(:app) do
+    lambda { |_env| [404, {}, ['Awesome']] }
+  end
+
+  let(:fresh_strategy) do
+    c = Class.new
+    c.send(:include, OmniHooks::Strategy)
+  end
+
+  describe '.default_options' do
+    it 'is inherited from a parent class' do
+      superklass = Class.new
+      superklass.send :include, OmniHooks::Strategy
+      superklass.configure_options do |c|
+        c.foo = 'bar'
+      end
+
+      klass = Class.new(superklass)
+      expect(klass.default_options.foo).to eq('bar')
+    end
+  end
+
+  describe '.configure_options' do
+    subject do
+      c = Class.new
+      c.send(:include, OmniHooks::Strategy)
+    end
+
+    context 'when block is passed' do
+      it 'allows for default options setting' do
+        subject.configure_options do |c|
+          c.wakka = 'doo'
+        end
+        expect(subject.new(nil).options['wakka']).to eq('doo')
+      end
+
+      it "works when block doesn't evaluate to true" do
+        environment_variable = nil
+        subject.configure_options do |c|
+          c.abc = '123'
+          c.hgi = environment_variable
+        end
+        expect(subject.new(nil).options['abc']).to eq('123')
+      end
+    end
+
+    it 'takes a hash and deep merge it' do
+      subject.configure_options :abc => {:def => 123}
+      subject.configure_options :abc => {:hgi => 456}
+      expect(subject.new(nil).options['abc']).to eq('def' => 123, 'hgi' => 456)
+    end
+  end
+
+  describe '.option' do
+    subject do
+      c = Class.new
+      c.send(:include, OmniHooks::Strategy)
+    end
+    it 'sets a default value' do
+      subject.option :abc, 123
+      expect(subject.new(nil).options.abc).to eq(123)
+    end
+
+    it 'sets the default value to nil if none is provided' do
+      subject.option :abc
+      expect(subject.new(nil).options.abc).to be_nil
+    end
+  end
+
+  describe '.args' do
+    subject do
+      c = Class.new
+      c.send(:include, OmniHooks::Strategy)
+    end
+
+    it 'sets args to the specified argument if there is one' do
+      subject.args [:abc, :def]
+      expect(subject.args).to eq([:abc, :def])
+    end
+
+    it 'is inheritable' do
+      subject.args [:abc, :def]
+      c = Class.new(subject)
+      expect(c.args).to eq([:abc, :def])
+    end
+
+    it 'accepts corresponding options as default arg values' do
+      subject.args [:a, :b]
+      subject.option :a, '1'
+      subject.option :b, '2'
+
+      expect(subject.new(nil).options.a).to eq '1'
+      expect(subject.new(nil).options.b).to eq '2'
+      expect(subject.new(nil, '3', '4').options.b).to eq '4'
+      expect(subject.new(nil, nil, '4').options.a).to eq nil
+    end
+  end
+
+  describe '.instrument' do
+    subject do
+      c = Class.new
+      c.send(:include, OmniHooks::Strategy)
+      c.option :name, 'class'
+      c
+    end
+
+    it 'should forward event publication to backend' do
+      expect(ActiveSupport::Notifications).to receive(:instrument).with('class.foo', 'bar')
+      subject.instrument('foo', 'bar')
+    end
+
+  end
+
+  context 'fetcher procs' do
+    subject { fresh_strategy }
+    %w(event event_type).each do |fetcher|
+      describe ".#{fetcher}" do
+        it 'sets and retrieve a proc' do
+          proc = lambda { 'Hello' }
+          subject.send(fetcher, &proc)
+          expect(subject.send(fetcher)).to eq(proc)
+        end
+      end
+    end
+  end
+
+  context 'fetcher stacks' do
+    subject { fresh_strategy }
+    %w(event event_type).each do |fetcher|
+      describe ".#{fetcher}_stack" do
+        it 'is an array of called ancestral procs' do
+          fetchy = proc { 'Hello' }
+          subject.send(fetcher, &fetchy)
+          expect(subject.send("#{fetcher}_stack", subject.new(app))).to eq(['Hello'])
+        end
+      end
+    end
+  end
+
+  describe '#initialize' do
+    context 'options extraction' do
+      it 'is the last argument if the last argument is a Hash' do
+        expect(ExampleStrategy.new(app, :abc => 123).options[:abc]).to eq(123)
+      end
+
+      it 'is the default options if any are provided' do
+        allow(ExampleStrategy).to receive(:default_options).and_return(OmniHooks::Strategy::Options.new(:abc => 123))
+        expect(ExampleStrategy.new(app).options.abc).to eq(123)
+      end
+    end
+
+    context 'custom args' do
+      subject do
+        c = Class.new
+        c.send(:include, OmniHooks::Strategy)
+      end
+
+      it 'sets options based on the arguments if they are supplied' do
+        subject.args [:abc, :def]
+        s = subject.new app, 123, 456
+        expect(s.options[:abc]).to eq(123)
+        expect(s.options[:def]).to eq(456)
+      end
+    end
+  end
+
+  describe '#call' do
+    before(:all) do
+      @options = nil
+    end
+
+    let(:strategy) { ExampleStrategy.new(app, @options || {}) }
+
+    it 'duplicates and calls' do
+      klass = Class.new
+      klass.send :include, OmniHooks::Strategy
+      instance = klass.new(app)
+      expect(instance).to receive(:dup).and_return(instance)
+      instance.call('rack.session' => {})
+    end
+
+    context 'without a subscriber' do
+      it 'should return a sucess response' do
+        klass = Class.new
+        klass.send :include, OmniHooks::Strategy
+        klass.option :name, 'class'
+        klass.event { 'Foo' }
+        klass.event_type { 'bar' }
+        instance = klass.new(app)
+
+        expect(ActiveSupport::Notifications).to receive(:instrument).with('class.bar', 'Foo')
+
+        expect(instance.call(make_env('/hooks/class'))).to eq([200, {}, [nil]])
+      end
+
+      context 'with exception in event callback' do
+        let(:klass) { Class.new }
+        before(:each) do
+          
+          klass.send :include, OmniHooks::Strategy
+          klass.option :name, 'class'
+          klass.event { raise 'Foo' }
+        end
+
+        it 'should not raise an error' do
+          instance = klass.new(app)
+          expect { instance.call(make_env('/hooks/class')) }.not_to raise_error
+        end
+        
+        it 'should return a non 200 response' do
+          instance = klass.new(app)
+          expect(instance.call(make_env('/hooks/class'))).to eq([500, {}, [nil]])
+        end
+      end
+    end
+
+    context 'with an explicit subscriber' do
+      let(:subscriber) { Proc.new { nil } }
+      before(:each) do
+
+        ExampleStrategy.event { 'Foo' }
+        ExampleStrategy.event_type { request.params['type'] }
+        ExampleStrategy.configure do |events|
+          events.subscribe('foo.bar', subscriber)
+        end
+      end
+
+      context 'with matched event type' do
+        it 'should return a success response' do
+          expect(subscriber).to receive(:call).with('Foo')
+
+          expect(strategy.call(make_env('/hooks/test', {'rack.input' => StringIO.new('type=foo.bar&payload=test')}))).to eq([200, {}, [nil]])
+        end
+      end
+
+      context 'with unmatched event' do
+        it 'should return a success response' do
+          expect(subscriber).not_to receive(:call)
+
+          expect(strategy.call(make_env('/hooks/test', {'rack.input' => StringIO.new('type=foo.sam&payload=test')}))).to eq([200, {}, [nil]])
+        end
+      end
+
+      context 'with an exception in the subscriber' do
+        before(:each) do
+          expect(subscriber).to receive(:call).and_raise(RuntimeError)
+        end
+
+        it 'should return an error response' do
+          expect(strategy.call(make_env('/hooks/test', {'rack.input' => StringIO.new('type=foo.bar&payload=test')}))).to eq([500, {}, [nil]])
+        end
+      end
+
+      after(:each) do
+        # reset the handlers
+        ExampleStrategy.event
+        ExampleStrategy.event_type
+      end
+    end
+
+    context 'request method restriction' do
+      before do
+        OmniHooks.config.allowed_request_methods = [:put]
+      end
+
+      it 'does not allow a request method of the wrong type' do
+        expect { strategy.call(make_env) }.not_to raise_error
+      end
+
+      it 'forwards request method of the wrong type to application' do
+        expect(strategy.call(make_env)).to eq([404, {}, ['Awesome']])
+      end
+
+      it 'allows a request method of the correct type' do
+        expect(strategy.call(make_env('/hooks/test', 'REQUEST_METHOD' => 'PUT'))).to eq([200, {}, [nil]])
+      end
+
+      after do
+        OmniHooks.config.allowed_request_methods = [:post]
+      end
+    end
+  end
+
+  describe '#inspect' do
+    it 'returns the class name' do
+      expect(ExampleStrategy.new(app).inspect).to eq('#<ExampleStrategy>')
+    end
+  end
+end

data/spec/omnihooks_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+
+RSpec.describe OmniHooks do
+  describe '.strategies' do
+    it 'increases when a new strategy is made' do
+      expect {
+        class ExampleStrategy
+          include OmniHooks::Strategy
+        end
+      }.to change(OmniHooks.strategies, :size).by(1)
+      expect(OmniHooks.strategies.last).to eq(ExampleStrategy)
+    end
+  end
+
+  context 'configuration' do
+    describe '.defaults' do
+      it 'is a hash of default configuration' do
+        expect(OmniHooks::Configuration.defaults).to be_kind_of(Hash)
+      end
+    end
+
+    it 'is callable from .configure' do
+      OmniHooks.configure do |c|
+        expect(c).to be_kind_of(OmniHooks::Configuration)
+      end
+    end
+  end
+
+  describe '.logger' do
+    it 'calls through to the configured logger' do
+      allow(OmniHooks).to receive(:config).and_return(double(:logger => 'foo'))
+      expect(OmniHooks.logger).to eq('foo')
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,115 @@
+require 'rspec'
+require 'omnihooks'
+
+
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause
+# this file to always be loaded, without a need to explicitly require it in any
+# files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need
+# it.
+#
+# The `.rspec` file also contains a few flags that are not defaults but that
+# users commonly want.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    #     be_bigger_than(2).and_smaller_than(4).description
+    #     # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #     # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+# The settings below are suggested to provide a good initial experience
+# with RSpec, but feel free to customize to your heart's content.
+
+  # These two settings work together to allow you to limit a spec run
+  # to individual examples or groups you care about by tagging them with
+  # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  # get run.
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  # Allows RSpec to persist some state between runs in order to support
+  # the `--only-failures` and `--next-failure` CLI options. We recommend
+  # you configure your source control system to ignore this file.
+  config.example_status_persistence_file_path = "spec/examples.txt"
+
+  # Limits the available syntax to the non-monkey patched syntax that is
+  # recommended. For more details, see:
+  #   - http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax
+  #   - http://www.teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://myronmars.to/n/dev-blog/2014/05/notable-changes-in-rspec-3#new__config_option_to_disable_rspeccore_monkey_patching
+  config.disable_monkey_patching!
+
+  # This setting enables warnings. It's recommended, but in some cases may
+  # be too noisy due to issues in dependencies.
+  config.warnings = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = 'doc'
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+
+end
+
+class ExampleStrategy
+  include OmniHooks::Strategy
+  attr_reader :last_env
+  option :name, 'test'
+
+  def call(env)
+    self.call!(env)
+  end
+
+  def initialize(*args, &block)
+    super
+    @fail = nil
+  end
+end

metadata

@@ -0,0 +1,156 @@
+--- !ruby/object:Gem::Specification
+name: omnihooks
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Karl Falconer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-09-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.3.0
+description: 
+email:
+- karl.falconer@falconerdevelopment.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".ruby-gemsets"
+- ".ruby-version"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/omnihooks.rb
+- lib/omnihooks/builder.rb
+- lib/omnihooks/strategies/developer.rb
+- lib/omnihooks/strategy.rb
+- lib/omnihooks/version.rb
+- omnihooks.gemspec
+- spec/omnihooks/builder_spec.rb
+- spec/omnihooks/strategy_spec.rb
+- spec/omnihooks_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+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: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: A generalized framework for multiple-provider webhooks subscriptions.
+test_files:
+- spec/omnihooks/builder_spec.rb
+- spec/omnihooks/strategy_spec.rb
+- spec/omnihooks_spec.rb
+- spec/spec_helper.rb