fare 0.1.0

data/Rakefile

@@ -0,0 +1,28 @@
+require "bundler/gem_tasks"
+
+begin
+  require 'cucumber'
+  require 'cucumber/rake/task'
+
+  Cucumber::Rake::Task.new(:features)
+
+rescue LoadError
+  task :features do
+    puts "Cucumber not installed."
+    exit 1
+  end
+end
+
+begin
+  require 'rspec/core/rake_task'
+  RSpec::Core::RakeTask.new(:spec) do |t|
+    t.pattern = "spec"
+  end
+rescue LoadError
+  task :spec do
+    puts "RSpec not installed"
+    exit 1
+  end
+end
+
+task :default => [:spec, :features]

data/bin/fare

@@ -0,0 +1,48 @@
+#!/usr/bin/env ruby
+
+lib = File.expand_path("../../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require "fare"
+require "optparse"
+
+command = ARGV.shift
+
+def show_help
+  puts <<-HELP.gsub(/^ +/, '')
+    Usage: fare COMMAND [OPTIONS]
+
+    Available commands:
+
+    fare update       Parses your configuration file, creates topics, queus, subscriptions and caches it.
+    fare subscriber   Controls the subscribers.
+
+    You can run any command with the --help option.
+
+    Example: fare subscriber --help
+  HELP
+end
+
+case command
+when "update"
+  require "fare/update_cli"
+  Fare::UpdateCLI.new(ARGV).call
+when "subscriber"
+  require "fare/subscriber_cli"
+  Fare::SubscriberCLI.new(ARGV).call
+when "-v", "--version"
+  puts "Fare version #{Fare::VERSION}"
+  exit 0
+when "help", "--help", "-h"
+  show_help
+  exit 0
+when "", nil
+  show_help
+  exit 1
+else
+  puts "Unkown command: #{command}"
+  puts
+  show_help
+  exit 1
+end
+

data/fare.gemspec

@@ -0,0 +1,35 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'fare/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "fare"
+  spec.version       = Fare::VERSION
+  spec.authors       = ["iain"]
+  spec.email         = ["iain@iain.nl"]
+  spec.description   = %q{An event system built on Amazon SNS and SQS}
+  spec.summary       = %q{An event system built on Amazon SNS and SQS}
+  spec.homepage      = "https://github.com/yourkarma/fare"
+
+  spec.files         = `git ls-files`.split($/)
+  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 "aws-sdk"
+  spec.add_dependency "daemonic", "~> 0.1.2"
+  spec.add_dependency "virtus"
+
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "thin"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "fake_sqs", "~> 0.0.10"
+  spec.add_development_dependency "fake_sns", "~> 0.0.2"
+
+  spec.add_development_dependency "cucumber"
+  spec.add_development_dependency "aruba"
+  spec.add_development_dependency "json_expressions"
+
+end

data/features/multiqueue.feature

@@ -0,0 +1,60 @@
+Feature: Multiqueue
+
+  Scenario: Different subscribers for different queues
+
+    Given the Fare config:
+      """
+      app_name "my_app"
+
+      publishes subject: "user", action: "login",  version: "0.1"
+      publishes subject: "user", action: "signup", version: "0.1"
+
+      subscriber do
+
+        setup do
+          require File.expand_path("../../middleware", __FILE__)
+        end
+
+        stack do
+          listen_to subject: "user", action: "login"
+          run do
+            use RegisterEvent, name: "default-queue"
+          end
+        end
+
+      end
+
+      subscriber :other_queue do
+
+        setup do
+          require File.expand_path("../../middleware", __FILE__)
+        end
+
+        stack do
+          listen_to subject: "user", action: "login"
+          run do
+            use RegisterEvent, name: "other-queue"
+          end
+        end
+
+      end
+      """
+
+    And a file named "middleware.rb" with:
+      """
+      class RegisterEvent
+      def initialize(app, options = {})
+          @app = app
+          @options = options
+        end
+        def call(env)
+          puts "Registered event by #{@options[:name]}"
+          exit
+        end
+      end
+      """
+
+    When I publish an event with the subject "user" and action "login"
+    And I run `fare subscriber start --name other_queue`
+    Then the output should contain "Registered event by other-queue"
+    But the output should not contain "Registered event by default-queue"

data/features/multistack.feature

@@ -0,0 +1,65 @@
+Feature: Multistack
+
+  Scenario: Different stacks for different messages
+
+    Given the Fare config:
+      """
+      app_name "my_app"
+
+      publishes subject: "user", action: "login",  version: "0.1"
+      publishes subject: "user", action: "signup", version: "0.1"
+
+      subscriber do
+
+        setup do
+          require File.expand_path("../../middleware", __FILE__)
+        end
+
+        stack do
+          listen_to subject: "user", action: "login"
+          run do
+            use TestForLogin
+          end
+        end
+
+        stack do
+          listen_to subject: "user", action: "signup"
+          run do
+            use TestForSignup
+          end
+        end
+
+      end
+      """
+
+    And a file named "middleware.rb" with:
+      """
+      class TestForLogin
+        def initialize(app)
+          @app = app
+        end
+        def call(env)
+          puts "Received Login"
+          exit
+        end
+      end
+
+      class TestForSignup
+        def initialize(app)
+          @app = app
+        end
+        def call(env)
+          puts "Received Signup"
+          exit
+        end
+      end
+      """
+
+    When I publish an event with the subject "user" and action "login"
+    And I run `fare subscriber start`
+    Then the output should contain "Received Login"
+    But the output should not contain "Received Signup"
+
+    When I publish an event with the subject "user" and action "signup"
+    And I run `fare subscriber start`
+    Then the output should contain "Received Signup"

data/features/step_definitions/aruba.rb

@@ -0,0 +1 @@
+require "aruba/cucumber"

data/features/step_definitions/fare_steps.rb

@@ -0,0 +1,40 @@
+Given(/^the Fare config:$/) do |string|
+
+  extra = %Q|require File.expand_path("../../helper.rb", __FILE__)|
+
+  write_file "config/fare.rb", "#{extra}\n#{string}"
+
+  write_file "helper.rb", <<-HELPER
+
+    AWS.config(
+      use_ssl:            false,
+      sqs_endpoint:       "localhost",
+      sqs_port:           4568,
+      sns_endpoint:       "localhost",
+      sns_port:           9293,
+      access_key_id:      "fake access key",
+      secret_access_key:  "fake secret key",
+    )
+
+  HELPER
+
+  run_simple("fare update")
+end
+
+When(/^I give SNS time to propagate the messages$/) do
+  $fake_sns.drain
+end
+
+When(/^I publish an event with the subject "(.*?)" and action "(.*?)"$/) do |subject, action|
+  write_file "publisher.rb", <<-PUBLISHER
+    require "bundler/setup"
+    Bundler.require(:default, :test)
+    Fare.publish(subject: #{subject.inspect}, action: #{action.inspect}, payload: "payload")
+  PUBLISHER
+
+  run_simple "ruby publisher.rb"
+
+  $fake_sns.drain
+  $fake_sns.reset
+  run_simple("fare update --force")
+end

data/features/subscriber.feature

@@ -0,0 +1,95 @@
+Feature: Subscriber
+
+  Scenario: Running in the foreground
+
+    Given the Fare config:
+      """
+      app_name "my_app"
+
+      publishes subject: "user", action: "login", version: "0.1"
+
+      subscriber do
+
+        stack do
+          listen_to subject: "user", action: "login"
+
+          run do
+            use Class.new {
+
+              def initialize(app, options = {})
+                @app = app
+              end
+
+              def call(env)
+                event = env.fetch(:event)
+                puts "Event received: #{event.subject} - #{event.action}"
+                exit
+              end
+
+            }
+          end
+        end
+
+      end
+      """
+
+    When I publish an event with the subject "user" and action "login"
+
+    And I run `fare subscriber start`
+
+    Then the output should contain "Event received: user - login"
+
+  Scenario: Multiple Middleware
+
+    Given the Fare config:
+      """
+      app_name "my_app"
+
+      publishes subject: "user", action: "login", version: "0.1"
+
+      subscriber do
+
+        setup do
+          require File.expand_path("../../middleware", __FILE__)
+        end
+
+        stack do
+          listen_to subject: "user", action: "login"
+
+          run do
+            use TestMiddlewareOne
+            use TestMiddlewareTwo
+          end
+        end
+
+      end
+      """
+
+    And a file named "middleware.rb" with:
+      """
+      class TestMiddlewareOne
+        def initialize(app)
+          @app = app
+        end
+        def call(env)
+          env[:one] = "Extra Data"
+          @app.call(env)
+        end
+      end
+
+      class TestMiddlewareTwo
+        def initialize(app)
+          @app = app
+        end
+        def call(env)
+          puts "Received data: #{env[:one]}"
+          exit
+        end
+      end
+      """
+
+    When I publish an event with the subject "user" and action "login"
+
+    And I run `fare subscriber start`
+
+    Then the output should contain "Received data: Extra Data"

data/features/support/env.rb

@@ -0,0 +1,34 @@
+ENV["RACK_ENV"] = "test"
+require "bundler/setup"
+Bundler.require(:default, :test)
+
+require "fare"
+
+require "fake_sns/test_integration"
+require "fake_sqs/test_integration"
+
+AWS.config(
+  use_ssl:            false,
+  sqs_endpoint:       "localhost",
+  sqs_port:           4568,
+  sns_endpoint:       "localhost",
+  sns_port:           9293,
+  access_key_id:      "fake access key",
+  secret_access_key:  "fake secret key",
+)
+
+$fake_sns = FakeSNS::TestIntegration.new(database: ":memory:")
+$fake_sqs = FakeSQS::TestIntegration.new(database: ":memory:")
+
+$fake_sns.start
+$fake_sqs.start
+
+at_exit {
+  $fake_sns.stop
+  $fake_sqs.stop
+}
+
+Before do
+  $fake_sns.reset
+  $fake_sqs.reset
+end

data/lib/fare.rb

@@ -0,0 +1,96 @@
+require "aws-sdk"
+require "verbose_hash_fetch"
+require "base64"
+require "json"
+require "yaml"
+require "digest/md5"
+require "virtus"
+require "forwardable"
+
+require "fare/version"
+
+require "fare/load_configuration_file"
+require "fare/configuration_dsl"
+require "fare/configuration"
+require "fare/subscriber_stack"
+require "fare/generate_lock_file"
+require "fare/topic"
+
+require "fare/queue_adapter"
+require "fare/topic_adapter"
+
+require "fare/configuration_when_locked"
+require "fare/publisher"
+
+require "fare/subscriber"
+require "fare/event"
+
+require "fare/middleware/logging"
+require "fare/middleware/raven"
+
+module Fare
+  ConfigurationNotFoundError = Class.new(RuntimeError)
+  LockFileNotFoundError = Class.new(RuntimeError)
+  ChecksumNotMatchingError = Class.new(RuntimeError)
+  NoEnvironmentFoundError = Class.new(RuntimeError)
+
+  class << self
+    attr_accessor :queue_adapter, :topic_adapter
+  end
+  self.queue_adapter = QueueAdapter
+  self.topic_adapter = TopicAdapter
+
+  def self.test_mode!
+    require "fare/test_mode"
+    @message_list = TestMode::MessageList.new
+    self.queue_adapter = @message_list.queue_adapter
+    self.topic_adapter = @message_list.topic_adapter
+    update(force: true)
+    @configuration = nil
+  end
+
+  def self.stubbed_messages
+    if @message_list
+      @message_list
+    else
+      fail "Not in test mode. Enable it with: Fare.test_mode!"
+    end
+  end
+
+  def self.given_event(*args)
+    stubbed_messages.given_event(*args)
+  end
+
+  def self.run(*args)
+    stubbed_messages.run(*args)
+  end
+
+  def self.default_config_file
+    File.expand_path("config/fare.rb", Dir.pwd)
+  end
+
+  def self.default_environment
+    env = ENV["RACK_ENV"] || ENV["RAILS_ENV"]
+    if env.nil? && defined?(::Rails)
+      env = Rails.env
+    end
+    env
+  end
+
+  def self.update(options = {})
+    GenerateLockFile.new(options).call
+  end
+
+  def self.publish(options)
+    Publisher.new(configuration, options).call
+  end
+
+  def self.configuration
+    @configuration ||= config({})
+  end
+
+  def self.config(options)
+    @configuration = ConfigurationWhenLocked.new(options)
+  end
+
+end