cotton-tail 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5a7811e3b76243326ce0e462653bc5f4a7d4b02c98c6a5cf6bf3fdaef747708e
+  data.tar.gz: 46ab061026f8c152f0ef767538f61281bb65c12959a9e59b7fee4eab280fd01e
+SHA512:
+  metadata.gz: 41d5d78a2bea2832dbd0df1bc2c2f194ed48af0b267727a382d5bb2f23336ca9d2cebfbedee750cdbbd4e97f653945f3ea07d4300a4a36b02ea08f89fefb203d
+  data.tar.gz: 0657e3f6a68e9e8ac54251b1088081f3dd44d445a8846cf0ed7adbb1438c52d5a180b4583f849dca12fdc48ec735dd1ac648b3b482b35f00796def4843f4201f

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+.env

data/.rspec

@@ -0,0 +1,4 @@
+--format documentation
+--color
+--require spec_helper
+-I integration

data/.rubocop.yml

@@ -0,0 +1,24 @@
+Metrics/LineLength:
+  Max: 120
+  Exclude:
+    - 'lib/tasks/**/*'
+
+Metrics/MethodLength:
+  Max: 20
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+    - 'integration/**/*'
+    - '*.gemspec'
+    - 'examples/app.rb'
+
+Style/Documentation:
+  Exclude:
+    - 'spec/**/*'
+    - 'integration/**/*'
+
+Metrics/ModuleLength:
+  Exclude:
+    - 'spec/**/*'
+    - 'integration/**/*'

data/.ruby-version

@@ -0,0 +1 @@
+2.5.1@cotton

data/Dockerfile

@@ -0,0 +1,21 @@
+FROM ruby:alpine
+
+# Use most recent versions of available packages
+RUN sed -i -e 's/v[[:digit:]]\.[[:digit:]]/edge/g' /etc/apk/repositories
+
+RUN apk update && apk add git yarn build-base
+
+# create directory
+WORKDIR /usr/src/cotton_tail
+
+# copy Gemfile and lock
+COPY Gemfile* ./
+COPY cotton-tail.gemspec ./
+COPY ./lib/cotton_tail/version.rb ./lib/cotton_tail/
+
+RUN bundle install
+
+# copy the contents to working directory
+COPY . /usr/src/cotton_tail
+
+CMD ash

data/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in cotton.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,83 @@
+PATH
+  remote: .
+  specs:
+    cotton-tail (0.1.1)
+      bunny (~> 2.12)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    amq-protocol (2.3.0)
+    ast (2.4.0)
+    benchmark-perf (0.4.0)
+    benchmark-trend (0.2.0)
+    bunny (2.12.0)
+      amq-protocol (~> 2.3, >= 2.3.0)
+    diff-lcs (1.3)
+    effin_utf8 (1.0)
+    faraday (0.13.1)
+      multipart-post (>= 1.2, < 3)
+    faraday_middleware (0.12.2)
+      faraday (>= 0.7.4, < 1.0)
+    hashie (3.6.0)
+    jaro_winkler (1.5.1)
+    multi_json (1.13.1)
+    multipart-post (2.0.0)
+    parallel (1.12.1)
+    parser (2.5.3.0)
+      ast (~> 2.4.0)
+    powerpack (0.1.2)
+    rabbitmq_http_api_client (1.9.1)
+      effin_utf8 (~> 1.0.0)
+      faraday (~> 0.13.0)
+      faraday_middleware (~> 0.12.0)
+      hashie (~> 3.5)
+      multi_json (~> 1.12)
+    rainbow (3.0.0)
+    rake (10.5.0)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-benchmark (0.4.0)
+      benchmark-perf (~> 0.4.0)
+      benchmark-trend (~> 0.2.0)
+      rspec (>= 3.0.0, < 4.0.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-its (1.2.0)
+      rspec-core (>= 3.0.0)
+      rspec-expectations (>= 3.0.0)
+    rspec-mocks (3.8.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.0)
+    rubocop (0.60.0)
+      jaro_winkler (~> 1.5.1)
+      parallel (~> 1.10)
+      parser (>= 2.5, != 2.5.1.1)
+      powerpack (~> 0.1)
+      rainbow (>= 2.2.2, < 4.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (~> 1.4.0)
+    ruby-progressbar (1.10.0)
+    unicode-display_width (1.4.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.16)
+  cotton-tail!
+  rabbitmq_http_api_client (~> 1.9)
+  rake (~> 10.0)
+  rspec (~> 3.0)
+  rspec-benchmark (~> 0.4)
+  rspec-its (~> 1.2)
+  rubocop (~> 0.60)
+
+BUNDLED WITH
+   1.17.1

data/README.md

@@ -0,0 +1,57 @@
+# CottonTail
+
+CottonTail provides a simple DSL for consuming messages from a RabbitMQ server
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'cotton-tail'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install cotton-tail
+
+## Usage
+
+### Quick Start
+
+You can look at the file `examples/app.rb` to see an example of what a CottonTail
+App definition looks like.
+
+To run the example locally you need to have a rabbitmq instance running. The
+included `docker-compose` file can be used to start up a local instance of
+rabbitmq.
+
+`docker-compose up`
+
+Once the rabbitmq service has completed startup (takes a few seconds) you can
+start the example app.
+
+`bundle exec examples/app.rb`
+
+You should see
+
+`Waiting for messages ...`
+
+We've included bash scripts to publish messages for the example app. Execute them
+in another terminal window to see output in the app window.
+
+`examples/messages/say.hello`, `examples/messages/say.goodbye`, etc...
+
+## Development
+
+After checking out the repo, install docker. Then, run `docker-compose` up to 
+spin up a local instance of rabbitmq. Run `rake spec:all` to run the tests.
+You can also run `bin/console` for an interactive prompt that will allow you 
+to experiment.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/jamesBrennan/cotton-tail.

data/Rakefile

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec
+
+namespace :spec do
+  desc 'Run integration specs'
+  task :integration do
+    puts `docker-compose exec cotton-tail bundle exec rspec integration`
+  end
+
+  desc 'Run all specs'
+  task all: %w[spec spec:integration]
+end

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'cotton_tail'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/entrypoint.sh

@@ -0,0 +1,3 @@
+#!/bin/sh
+trap : TERM INT
+tail -f /dev/null & wait

data/certs/jamesbrennan.pem

@@ -0,0 +1,21 @@
+-----BEGIN CERTIFICATE-----
+MIIDgDCCAmigAwIBAgIBATANBgkqhkiG9w0BAQUFADBDMRUwEwYDVQQDDAxicmVu
+bmFubXVzaWMxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkW
+A2NvbTAeFw0xODA3MDYwMDA2MzRaFw0xOTA3MDYwMDA2MzRaMEMxFTATBgNVBAMM
+DGJyZW5uYW5tdXNpYzEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPy
+LGQBGRYDY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAyxykNKqp
+jD5gnQd2YHuRDNsLN5limGMDjSb38lMZAfJJugoWbSSeQM3+iVl26YWE5JeJpqDu
+Rr/GOQ54bsev4IxCfPl8yIkhAao0i96+k1EeEb/i3pgZOfjXgGSTM71baCZzbqBH
+A5ivcb0wqoHWyqrxNtc4XhSs5RtvtNl3IEe/bs5qqixt6PwsCorD6kAoUUNHNM9W
+MLexivfiJooHOvVRmf1DQuJ2fDccKNHf7ZR4PuiguT4Z73bT2njCBm2o86o/clvR
+WV0jasBOKvsgcg65U10klngBEG56nWSdIE9PrXGPqwBwA6jXttAwFLUNvuam5nGQ
+V3MbCFDeHUUrtwIDAQABo38wfTAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNV
+HQ4EFgQUPJGTSMevbRtDlY9WBrs21ae/+5YwIQYDVR0RBBowGIEWYnJlbm5hbm11
+c2ljQGdtYWlsLmNvbTAhBgNVHRIEGjAYgRZicmVubmFubXVzaWNAZ21haWwuY29t
+MA0GCSqGSIb3DQEBBQUAA4IBAQBr5Fm1ULBbLUYvX85iXI1Q7L7BZp53p9Q4TXrd
+0n0dE0qHJELwJQkErwZwMhOzaLqcctCwdzLkc9/VZSpLLuzv5bfEWP4EyTET5a+i
+4dn/Wko+6aNPVonmlHDhNYOPl3edxgxoD0WW08U7NJ4tGxJJURVv4yrCayT3xLCA
+yzUUQaHKkLaXHSfH0yhha+pFpUlTsLeg9hrZ0jqSk4FzUrKbiieLY/f/p5Xr5QDg
+fXe/xr/Sc+2wCjHPVE2J+auN5hk3KCp1I4s2fKqyLIwyhTEF3shuYfCpC8rt/YdN
+cy9/lg5LCI3OvakzxL4Xt1Sq4h/xJZ06ydTVJ1wxfk6BXHrg
+-----END CERTIFICATE-----

data/cotton-tail.gemspec

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'cotton_tail/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'cotton-tail'
+  spec.version       = CottonTail::VERSION
+  spec.authors       = ['James Brennan']
+  spec.email         = ['brennanmusic@gmail.com']
+  spec.homepage      = 'https://github.com/jamesBrennan/cotton-tail'
+
+  spec.summary       = 'A simple multi-threaded amqp server'
+  spec.description   = 'Simply and easily add AMQP messaging capabilities to
+                          your services'
+
+  spec.license       = 'MIT'
+
+  spec.cert_chain  = ['certs/jamesbrennan.pem']
+  spec.signing_key = File.expand_path('~/.ssh/gem-private_key.pem') if $0 =~ /gem\z/
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features|integration)/})
+  end
+
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'bunny', '~> 2.12'
+
+  spec.add_development_dependency 'bundler', '~> 1.16'
+  spec.add_development_dependency 'rabbitmq_http_api_client', '~> 1.9'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'rspec-benchmark', '~> 0.4'
+  spec.add_development_dependency 'rspec-its', '~> 1.2'
+  spec.add_development_dependency 'rubocop', '~> 0.60'
+end

data/docker-compose.yml

@@ -0,0 +1,20 @@
+version: '3.4'
+services:
+  cotton-tail:
+    build: .
+    volumes:
+      - .:/usr/src/cotton-tail
+    entrypoint: bin/entrypoint.sh
+    links:
+      - rabbitmq
+    environment:
+      - AMQP_ADDRESS=amqp://rabbitmq:5672
+      - AMQP_MANAGER_URL=http://guest:guest@rabbitmq:15672
+    depends_on:
+      - rabbitmq
+
+  rabbitmq:
+    image: rabbitmq:3.7-management
+    ports:
+      - 5672:5672
+      - 15672:15672

data/examples/app.rb

@@ -0,0 +1,45 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'cotton_tail'
+
+app = CottonTail::App.new.define do
+  # Create the queue 'hello_world_queue' if it does not exists
+  queue 'hello_world_queue', exclusive: true do
+    # Create a binding from the default topic exchange ('amq.topic') to
+    # the queue 'hello_world_queue'. When a message is received with the
+    # routing key 'say.hello' the block is executed.
+    handle 'say.hello' do
+      puts 'Hello world!'
+    end
+
+    handle 'say.goodbye' do
+      puts 'Goodbye cruel world!'
+    end
+
+    handle 'inspect.message' do |delivery_info, properties, message|
+      puts delivery_info: delivery_info
+      puts properties: properties
+      puts message: message
+    end
+  end
+
+  queue 'require_ack_queue', exclusive: true, manual_ack: true do
+    handle 'get.acked' do |delivery_info, _props, _msg, opts|
+      conn = opts[:conn]
+      delivery_tag = delivery_info[:delivery_tag]
+      puts "acking with #{delivery_tag}"
+      conn.ack(delivery_tag)
+    end
+
+    handle 'get.nacked' do |delivery_info, _props, _msg, opts|
+      conn = opts[:conn]
+      delivery_tag = delivery_info[:delivery_tag]
+      puts "nacking with #{delivery_tag}"
+      conn.nack(delivery_tag)
+    end
+  end
+end
+
+app.start

data/examples/messages/get.acked

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+
+read -r -d '' MESSAGE << EOM
+{
+  "properties":{},
+  "routing_key":"get.acked",
+  "payload": "ignored",
+  "payload_encoding": "string"
+}
+EOM
+
+curl -i -XPOST -d"${MESSAGE}" http://guest:guest@localhost:15672/api/exchanges/%2f/amq.topic/publish

data/examples/messages/get.nacked

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+
+read -r -d '' MESSAGE << EOM
+{
+  "properties":{},
+  "routing_key":"get.nacked",
+  "payload": "ignored",
+  "payload_encoding": "string"
+}
+EOM
+
+curl -i -XPOST -d"${MESSAGE}" http://guest:guest@localhost:15672/api/exchanges/%2f/amq.topic/publish

data/examples/messages/inspect.message

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+
+read -r -d '' MESSAGE << EOM
+{
+  "properties":{},
+  "routing_key":"inspect.message",
+  "payload": "this is the message message body",
+  "payload_encoding": "string"
+}
+EOM
+
+curl -i -XPOST -d"${MESSAGE}" http://guest:guest@localhost:15672/api/exchanges/%2f/amq.topic/publish

data/examples/messages/say.goodbye

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+
+read -r -d '' MESSAGE << EOM
+{
+  "properties":{},
+  "routing_key":"say.goodbye",
+  "payload": "ignored",
+  "payload_encoding": "string"
+}
+EOM
+
+curl -i -XPOST -d"${MESSAGE}" http://guest:guest@localhost:15672/api/exchanges/%2f/amq.topic/publish

data/examples/messages/say.hello

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+
+read -r -d '' MESSAGE << EOM
+{
+  "properties":{},
+  "routing_key":"say.hello",
+  "payload": "ignored",
+  "payload_encoding": "string"
+}
+EOM
+
+curl -i -XPOST -d"${MESSAGE}" http://guest:guest@localhost:15672/api/exchanges/%2f/amq.topic/publish

data/lib/cotton_tail/app.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module CottonTail
+  # App is the main class for a CottonTail server
+  class App
+    def initialize(queue_strategy: Queue::Bunny, routing_strategy: Router)
+      @dependencies = {
+        queue_strategy: queue_strategy,
+        routing_strategy: routing_strategy
+      }
+    end
+
+    # Define message routing
+    def define(&block)
+      @definition = DSL::App.new(**@dependencies)
+      @definition.instance_eval(&block)
+      self
+    end
+
+    def queues
+      @definition.queues
+    end
+
+    # Get a single message queue
+    def queue(name)
+      queues[name]
+    end
+
+    # Start the app, process all pending messages, and then shutdown
+    def run
+      supervisors.map(&:run).each(&:join)
+    end
+
+    def start
+      supervisors.map(&:start)
+      puts 'Waiting for messages ...'
+
+      sleep 0.1 while running?
+    end
+
+    private
+
+    def supervisors
+      @supervisors ||= queues.map do |_name, queue|
+        Queue::Supervisor.new(queue, on_message: @definition.router)
+      end
+    end
+
+    def running?
+      supervisors.any?(&:running?)
+    end
+  end
+end

data/lib/cotton_tail/dsl/app.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module CottonTail
+  module DSL
+    # This is the top level DSL for defining the bindings and message routing of
+    # a cotton App
+    class App
+      attr_reader :queues
+
+      def initialize(queue_strategy:, routing_strategy:)
+        @queue_strategy = queue_strategy
+        @routing_strategy = routing_strategy
+        @queues = {}
+      end
+
+      # Define a new queue
+      def queue(name, **opts, &block)
+        @queue_strategy.call(name: name, **opts).tap do |queue_instance|
+          @queues[name] = queue_instance
+          queue_dsl = Queue.new(name, queue_instance, self)
+          queue_dsl.instance_eval(&block) if block_given?
+        end
+      end
+
+      # Creates a scope for nested bindings
+      #
+      # @example
+      #   topic 'some.resource' do
+      #     handle 'event.updated', lambda do
+      #       puts "I'm bound to some.resource.event.updated"
+      #     end
+      #   end
+      #
+      # @param [String] routing_prefix The first part of the routing_key
+      def topic(routing_prefix, &block)
+        topic = Topic.new(routing_prefix, self)
+        topic.instance_eval(&block)
+      end
+
+      def handle(key, handler = nil, &block)
+        handler ||= block
+        router.route key, handler
+      end
+
+      def router
+        @router ||= @routing_strategy.call
+      end
+    end
+  end
+end

data/lib/cotton_tail/dsl/queue.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module CottonTail
+  module DSL
+    # Queue DSL
+    class Queue
+      def initialize(name, queue, context)
+        @name = name
+        @queue = queue
+        @context = context
+      end
+
+      def handle(key, handler = nil, &block)
+        bind(key)
+        @context.handle(key, handler, &block)
+      end
+
+      def topic(routing_prefix, &block)
+        topic = Topic.new(routing_prefix, self)
+        topic.instance_eval(&block)
+      end
+
+      private
+
+      def bind(key)
+        return unless @queue.respond_to?(:bind)
+
+        @queue.bind key
+      end
+    end
+  end
+end

data/lib/cotton_tail/dsl/topic.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module CottonTail
+  module DSL
+    # Topic DSL
+    class Topic
+      def initialize(routing_prefix, context)
+        @routing_prefix = routing_prefix
+        @context = context
+      end
+
+      def handle(routing_suffix, klass)
+        key = routing_key(routing_suffix)
+        @context.instance_eval { handle key, klass }
+      end
+
+      private
+
+      def routing_key(suffix)
+        [@routing_prefix, suffix].join('.')
+      end
+    end
+  end
+end

data/lib/cotton_tail/dsl.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module CottonTail
+  # DSL namespace
+  module DSL
+    autoload :App, 'cotton_tail/dsl/app'
+    autoload :Queue, 'cotton_tail/dsl/queue'
+    autoload :Topic, 'cotton_tail/dsl/topic'
+  end
+end

data/lib/cotton_tail/queue/bunny.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module CottonTail
+  module Queue
+    # A wrapper around a ::Bunny::Queue that makes it interchangeable with a
+    # standard Ruby::Queue
+    class Bunny
+      def self.call(name:, **opts)
+        new(name, **opts)
+      end
+
+      def initialize(name, conn: Connection.new, prefetch: 1, manual_ack: false, **opts)
+        @name = name
+        @prefetch = prefetch
+        @manual_ack = manual_ack
+        @conn = conn
+        @closed = false
+        @queue = conn.queue(@name, **opts)
+      end
+
+      def bind(routing_key)
+        @queue.bind('amq.topic', routing_key: routing_key)
+      end
+
+      def push(args)
+        routing_key, message = args
+        @conn.publish message, routing_key: routing_key
+      end
+
+      def close
+        @closed = true
+      end
+
+      def closed?
+        @closed
+      end
+
+      def empty?
+        @queue.message_count.zero?
+      end
+
+      def pop
+        return if empty?
+
+        delivery_info, *tail = @queue.pop(manual_ack: @manual_ack)
+        [delivery_info[:routing_key], delivery_info, *tail, conn: @conn]
+      end
+    end
+  end
+end

data/lib/cotton_tail/queue/connection.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require 'forwardable'
+require 'bunny'
+
+module CottonTail
+  module Queue
+    # Wrapper for Bunny::Session
+    class Connection
+      extend Forwardable
+
+      def initialize(url = ENV.fetch('AMQP_ADDRESS', 'amqp://localhost:5672'))
+        @url = url
+      end
+
+      def chan(prefetch = 1)
+        @channels ||= Hash.new do |h, key|
+          h[key] = session.create_channel.tap do |ch|
+            ch.prefetch(prefetch)
+          end
+        end
+        @channels[prefetch]
+      end
+
+      def exchange
+        @exchange ||= chan.exchange('amq.topic')
+      end
+
+      def session
+        @session ||= ::Bunny.new(@url).tap(&:start)
+      end
+
+      def_delegators :chan, :ack, :nack, :queue
+      def_delegators :exchange, :publish
+    end
+  end
+end

data/lib/cotton_tail/queue/memory.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module CottonTail
+  module Queue
+    # Simple in-memory queue
+    class Memory
+      def self.call(**_kwargs)
+        ::Queue.new
+      end
+    end
+  end
+end

data/lib/cotton_tail/queue/reader.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'fiber'
+
+module CottonTail
+  module Queue
+    # Queue Reader
+    class Reader
+      def self.spawn(queue, **kwargs)
+        Thread.new { new(queue, **kwargs).start }
+      end
+
+      def initialize(queue, on_message:)
+        @queue = queue
+        @on_message = on_message
+      end
+
+      def fiber
+        @fiber ||= Fiber.new do
+          Fiber.yield @queue.pop until @queue.empty? && @queue.closed?
+        end
+      end
+
+      def start
+        while fiber.alive?
+          args = fiber.resume
+          @on_message.call(*args) if args
+        end
+      end
+    end
+  end
+end

data/lib/cotton_tail/queue/supervisor.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'fiber'
+
+module CottonTail
+  module Queue
+    # A supervisor for a single queue
+    class Supervisor
+      def initialize(queue, on_message:)
+        @queue = queue
+        @on_message = on_message
+      end
+
+      def start
+        process
+      end
+
+      # Start the supervisor, process all pending messages, and then stop
+      def run
+        @queue.close
+        start.tap(&:join)
+      end
+
+      def running?
+        true & process.status
+      end
+
+      private
+
+      def process
+        @process ||= Reader.spawn(@queue, on_message: @on_message)
+      end
+    end
+  end
+end

data/lib/cotton_tail/queue.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module CottonTail
+  # Queue namespace
+  module Queue
+    autoload :Bunny, 'cotton_tail/queue/bunny'
+    autoload :Connection, 'cotton_tail/queue/connection'
+    autoload :Memory, 'cotton_tail/queue/memory'
+    autoload :Reader, 'cotton_tail/queue/reader'
+    autoload :Supervisor, 'cotton_tail/queue/supervisor'
+  end
+end

data/lib/cotton_tail/router.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module CottonTail
+  # Register message handlers and dispatch messages to them
+  class Router
+    def self.call
+      new
+    end
+
+    def initialize
+      @handlers = {}
+    end
+
+    def route(key, handler)
+      @handlers[key] = handler
+    end
+
+    def dispatch(key, *args)
+      @handlers[key].call(*args)
+    end
+
+    alias call dispatch
+  end
+end

data/lib/cotton_tail/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module CottonTail
+  VERSION = '0.1.1'
+end

data/lib/cotton_tail.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# Top level namespace for CottonTail
+module CottonTail
+  autoload :App, 'cotton_tail/app'
+  autoload :DSL, 'cotton_tail/dsl'
+  autoload :Queue, 'cotton_tail/queue'
+  autoload :Router, 'cotton_tail/router'
+  autoload :Version, 'cotton_tail/version'
+end

metadata

@@ -0,0 +1,214 @@
+--- !ruby/object:Gem::Specification
+name: cotton-tail
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- James Brennan
+autorequire: 
+bindir: exe
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDgDCCAmigAwIBAgIBATANBgkqhkiG9w0BAQUFADBDMRUwEwYDVQQDDAxicmVu
+  bmFubXVzaWMxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkW
+  A2NvbTAeFw0xODA3MDYwMDA2MzRaFw0xOTA3MDYwMDA2MzRaMEMxFTATBgNVBAMM
+  DGJyZW5uYW5tdXNpYzEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPy
+  LGQBGRYDY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAyxykNKqp
+  jD5gnQd2YHuRDNsLN5limGMDjSb38lMZAfJJugoWbSSeQM3+iVl26YWE5JeJpqDu
+  Rr/GOQ54bsev4IxCfPl8yIkhAao0i96+k1EeEb/i3pgZOfjXgGSTM71baCZzbqBH
+  A5ivcb0wqoHWyqrxNtc4XhSs5RtvtNl3IEe/bs5qqixt6PwsCorD6kAoUUNHNM9W
+  MLexivfiJooHOvVRmf1DQuJ2fDccKNHf7ZR4PuiguT4Z73bT2njCBm2o86o/clvR
+  WV0jasBOKvsgcg65U10klngBEG56nWSdIE9PrXGPqwBwA6jXttAwFLUNvuam5nGQ
+  V3MbCFDeHUUrtwIDAQABo38wfTAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNV
+  HQ4EFgQUPJGTSMevbRtDlY9WBrs21ae/+5YwIQYDVR0RBBowGIEWYnJlbm5hbm11
+  c2ljQGdtYWlsLmNvbTAhBgNVHRIEGjAYgRZicmVubmFubXVzaWNAZ21haWwuY29t
+  MA0GCSqGSIb3DQEBBQUAA4IBAQBr5Fm1ULBbLUYvX85iXI1Q7L7BZp53p9Q4TXrd
+  0n0dE0qHJELwJQkErwZwMhOzaLqcctCwdzLkc9/VZSpLLuzv5bfEWP4EyTET5a+i
+  4dn/Wko+6aNPVonmlHDhNYOPl3edxgxoD0WW08U7NJ4tGxJJURVv4yrCayT3xLCA
+  yzUUQaHKkLaXHSfH0yhha+pFpUlTsLeg9hrZ0jqSk4FzUrKbiieLY/f/p5Xr5QDg
+  fXe/xr/Sc+2wCjHPVE2J+auN5hk3KCp1I4s2fKqyLIwyhTEF3shuYfCpC8rt/YdN
+  cy9/lg5LCI3OvakzxL4Xt1Sq4h/xJZ06ydTVJ1wxfk6BXHrg
+  -----END CERTIFICATE-----
+date: 2018-10-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bunny
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.12'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.12'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rabbitmq_http_api_client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+- !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.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rspec-benchmark
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: rspec-its
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.60'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.60'
+description: |-
+  Simply and easily add AMQP messaging capabilities to
+                            your services
+email:
+- brennanmusic@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-version"
+- Dockerfile
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/console
+- bin/entrypoint.sh
+- certs/jamesbrennan.pem
+- cotton-tail.gemspec
+- docker-compose.yml
+- examples/app.rb
+- examples/messages/get.acked
+- examples/messages/get.nacked
+- examples/messages/inspect.message
+- examples/messages/say.goodbye
+- examples/messages/say.hello
+- lib/cotton_tail.rb
+- lib/cotton_tail/app.rb
+- lib/cotton_tail/dsl.rb
+- lib/cotton_tail/dsl/app.rb
+- lib/cotton_tail/dsl/queue.rb
+- lib/cotton_tail/dsl/topic.rb
+- lib/cotton_tail/queue.rb
+- lib/cotton_tail/queue/bunny.rb
+- lib/cotton_tail/queue/connection.rb
+- lib/cotton_tail/queue/memory.rb
+- lib/cotton_tail/queue/reader.rb
+- lib/cotton_tail/queue/supervisor.rb
+- lib/cotton_tail/router.rb
+- lib/cotton_tail/version.rb
+homepage: https://github.com/jamesBrennan/cotton-tail
+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.7.6
+signing_key: 
+specification_version: 4
+summary: A simple multi-threaded amqp server
+test_files: []