event-pub-sub 1.1.6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 73f22c5c6e9637d5795f7d8730690d760eaca0a9
+  data.tar.gz: dfb2258f9b8981dacc99a8d295c6e2ac4c8a65d3
+SHA512:
+  metadata.gz: faab525873900f49e3d36ef61d949a4c0c8fe742bd30d6e5d7592425816d2299797b26f2b8130e3dba643f8101a84115e14b2b66395d9be6e1c19da2f1765dac
+  data.tar.gz: 5f2051b5550451e5b5ead0c7a01b2da6bf5f0e91a5f528f6cd8b622226dd9f0b6d9d4c40965397dc0daa8a1ad038d65076af020bdc980d1be6e09be57426cdf2

data/.gitignore

@@ -0,0 +1,64 @@
+*.rbc
+capybara-*.html
+/log
+/tmp
+/db/*.sqlite3
+/public/system
+/coverage/
+/spec/tmp
+run_test.sh
+**.orig
+rerun.txt
+pickle-email-*.html
+
+# TODO Comment out these rules if you are OK with secrets being uploaded to the repo
+config/initializers/secret_token.rb
+config/secrets.yml
+
+## Environment normalisation:
+/.bundle
+/vendor/bundle
+
+# these should all be checked in to normalise the environment:
+# Gemfile.lock, .ruby-version, .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+# if using bower-rails ignore default bower_components path bower.json files
+/vendor/assets/bower_components
+*.bowerrc
+bower.json
+# See https://help.github.com/articles/ignoring-files for more about ignoring files.
+#
+# If you find yourself ignoring temporary files generated by your text editor
+# or operating system, you probably want to add a global ignore instead:
+#   git config --global core.excludesfile '~/.gitignore_global'
+
+# Ignore bundler config.
+/.bundle
+
+# Ignore the default SQLite database.
+/db/*.sqlite3
+/db/*.sqlite3-journal
+
+# Ignore all logfiles and tempfiles.
+/log/*
+!/log/.keep
+/tmp
+
+*.swp
+*.swo
+*.swn
+
+# Ignore redis dump file
+dump.rdb
+
+# .ruby-gemset e .ruby-version nas engines
+engines/**/.ruby-*
+
+.editorconfig
+tags
+.byebug_history
+
+.idea

data/.rspec

@@ -0,0 +1,4 @@
+--color
+--require spec_helper
+--drb
+--format doc

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,94 @@
+PATH
+  remote: .
+  specs:
+    event-pub-sub (1.1.6)
+      activesupport (= 4.2.5.2)
+      bunny (= 2.3.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (4.2.5.2)
+      i18n (~> 0.7)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.3, >= 0.3.4)
+      tzinfo (~> 1.1)
+    amq-protocol (2.0.1)
+    bunny (2.3.0)
+      amq-protocol (>= 2.0.1)
+    byebug (8.2.1)
+    celluloid (0.16.0)
+      timers (~> 4.0.0)
+    coderay (1.1.0)
+    diff-lcs (1.2.5)
+    ffi (1.9.6)
+    formatador (0.2.5)
+    guard (2.11.1)
+      formatador (>= 0.2.4)
+      listen (~> 2.7)
+      lumberjack (~> 1.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
+      pry (>= 0.9.12)
+      shellany (~> 0.0)
+      thor (>= 0.18.1)
+    guard-compat (1.2.1)
+    guard-rspec (4.5.0)
+      guard (~> 2.1)
+      guard-compat (~> 1.1)
+      rspec (>= 2.99.0, < 4.0)
+    hitimes (1.2.2)
+    i18n (0.7.0)
+    json (1.8.3)
+    listen (2.8.5)
+      celluloid (>= 0.15.2)
+      rb-fsevent (>= 0.9.3)
+      rb-inotify (>= 0.9)
+    lumberjack (1.0.9)
+    method_source (0.8.2)
+    minitest (5.8.4)
+    nenv (0.2.0)
+    notiffany (0.0.3)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
+    pry (0.10.1)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    rake (10.4.2)
+    rb-fsevent (0.9.4)
+    rb-inotify (0.9.5)
+      ffi (>= 0.5.0)
+    rspec (3.2.0)
+      rspec-core (~> 3.2.0)
+      rspec-expectations (~> 3.2.0)
+      rspec-mocks (~> 3.2.0)
+    rspec-core (3.2.0)
+      rspec-support (~> 3.2.0)
+    rspec-expectations (3.2.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-mocks (3.2.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-support (3.2.1)
+    shellany (0.0.1)
+    slop (3.6.0)
+    thor (0.19.1)
+    thread_safe (0.3.5)
+    timers (4.0.1)
+      hitimes
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.7)
+  byebug (= 8.2.1)
+  event-pub-sub!
+  guard-rspec (= 4.5.0)
+  rake (~> 10.0)
+  rspec (= 3.2.0)

data/Guardfile

@@ -0,0 +1,51 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+## Uncomment and set this to only include directories you want to watch
+#directories %w(lib config spec)
+
+## Uncomment to clear the screen before every task
+# clearing :on
+
+## Guard internally checks for changes in the Guardfile and exits.
+## If you want Guard to automatically start up again, run guard in a
+## shell loop, e.g.:
+##
+##  $ while bundle exec guard; do echo "Restarting Guard..."; done
+##
+## Note: if you are using the `directories` clause above and you are not
+## watching the project directory ('.'), the you will want to move the Guardfile
+## to a watched dir and symlink it back, e.g.
+#
+#  $ mkdir config
+#  $ mv Guardfile config/
+#  $ ln -s config/Guardfile .
+#
+# and, you'll have to watch "config/Guardfile" instead of "Guardfile"
+
+# Note: The cmd option is now required due to the increasing number of ways
+#       rspec may be run, below are examples of the most common uses.
+#  * bundler: 'bundle exec rspec'
+#  * bundler binstubs: 'bin/rspec'
+#  * spring: 'bin/rspec' (This will use spring if running and you have
+#                          installed the spring binstubs per the docs)
+#  * zeus: 'zeus rspec' (requires the server to be started separately)
+#  * 'just' rspec: 'rspec'
+
+guard :rspec, cmd: "bundle exec rspec" do
+  watch(%r{^lib/(.+)\.rb$}) do |m|
+    [
+      "spec/unit/#{m[1]}_spec.rb",
+      "spec/integration/#{m[1]}_spec.rb"
+    ]
+  end
+ #models
+  watch(%r{^lib/event/(.+)\.rb$}) do |m|
+    [
+      "spec/unit/#{m[1]}_spec.rb",
+      "spec/integration/#{m[1]}_spec.rb"
+    ]
+  end
+
+  watch(%r{^spec/.+_spec\.rb$})
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Sergio Azevedo
+
+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,167 @@
+[![Build Status](https://semaphoreapp.com/api/v1/projects/3b801a94-a652-4c1d-b347-ff6006adaf43/364951/shields_badge.svg)](https://semaphoreapp.com/darkseid/event)
+# Event
+
+O objetivo desta GEM é permitir que as Engines que compõem a nova Plataforma da Estante Virutal possam se comunicar sem que estas precisem "se conhecer", garantindo assim um baixo acoplamento entre as Engines.
+
+A solução é baseada no pattern Publish-Subscribe Channel descrito pelo Fowler em seu livro Enterprise Integration Patterns. No caso, o papel do MessageChannel será exercido pelo RabbitMQ.
+
+## Instalação
+
+Como dito anteriormente, esta gem utiliza o RabbitMQ. Por isso precisamos ter esta dependência instalada. Para realizar a instalação basta seguir o passo a passo descrito neste [link](https://www.rabbitmq.com/download.html)
+
+Depois, você precisa adicionar um novo source ao seu Gemfile. Este novo source deve ser a primeira linha do seu Gemfile:
+
+```ruby
+source 'https://repo.fury.io/sergioazevedo'
+source 'https://rubygems.org'
+```
+
+Se vc estiver instalando em uma Engine deve alterar o arquivo 'suaengine.gemspec' e adicionar a dependencia
+
+```ruby
+s.add_dependency "event","~>1.0.0"
+```
+
+Caso seja um projeto Ruby normal ou uma Rails app adicione a linha abaixo no seu Gemfile:
+
+```ruby
+gem "event","~>1.0.0"
+```
+
+E executar:
+    $ bundle 
+
+## Configuração
+Os arquivos abaixo são necessários para se configurar esta gem.
+```
+config/event.yml
+config/initializes/setup_event.rb
+```
+
+Para gerá-los basta rodar a rake task: ```rake app:event:install```.  
+
+####config/event.yml
+Neste arquivo você deve fornecer as configuracoes para conexão com o Broker RabbitMQ.
+Mas este arquivo contém uma configuração muito importante, e está na chave: **base_routing_key**. Você **precisa** usar nesta chave o nome da sua engine _(ou algo semelhante, que identifique o módulo)_.
+Exemplo:
+Imagine o modulo de Ecommerce
+
+```yaml
+development:
+  base_routing_key: ecommerce
+  broker:
+    ip: localhost
+    port: 5672
+    username: guest
+    password: guest
+```
+
+####config/initializers/setup_event.rb
+Você só vai precisar alterar este arquivo no caso de querer "assinar" algum evento.
+
+## Utilização
+
+### Publicando Eventos / Enviando mensagens
+Publicar eventos é muito fácil, basta usar Event.pubish.
+
+```ruby
+  Event.publish(:sku_added, name: 'Caneta Azul', price: 1.99, qty: 10 )
+```
+No exempo acima o nome do evento é **:sku_added** e os dados do evento estão no hash: **{name: 'Caneta Azul', price: 1.99, qty: 10}**
+
+###Sobre os Eventos 
+Eventos são sempre coisas que já aconteceram, por este motivo é de boa prática que os nomes dos eventos descrevam claramente que fato ocorreu e com quem. Exemplos abaixo:
+ - Um produto novo sku foi adicionado - :new_product_added
+ - Um sku novo foi adicionado - :new_sku_added
+ - Um sku foi vendido - :sku_saled
+ - Produto teve seu preço alterado - product_price_updated
+ 
+Sobre os dados do evento, isto fica a cargo de quem publica o evento. Mas em geral é bacana enviar informações sobre o contexto do evento. 
+
+Exemplo:
+
+- Um sku foi vendido
+```ruby
+Event.publish(:sku_saled, sku_id: 10 )
+```
+- Preço de um sku foi alterado  
+```ruby
+Event.publish(:sku_price_changed, sku_id: 10, old_price: 1.99, new_price: 2.87 )
+```
+  
+### Assinando os Eventos / Recebendo mensagens
+
+Assinar eventos é um processo de duas etapas:  
+
+1. Escrever uma classe Listener para o evento desejado  
+2. Registrar o Listener para o evento desejado em config/initializes/setup_event.rb
+
+####1. Escrever uma classe Listener para o evento desejado
+Como dito antes você vai precisar escrever uma classe para cada listener que desejar.
+Esta classe não precisa herdar de nada, basta que ela tenha os métodos **#initialize** e **notify**. O Listener é como um [Observer _GoF_](http://en.wikipedia.org/wiki/Observer_pattern).
+
+Atenção, o listener deve receber toda a informação necessária para sua excução no método de inicialização (new), ou seja, os dados do evento/mensagem.
+
+Exemplo de Listener:
+
+Considere a mensagem abaixo:
+
+```ruby
+Event.publish(:sku_price_changed, sku_id: 10, old_price: 1.99, new_price: 2.87 )
+```
+
+
+```ruby
+class SkuPriceChangedListener
+  def initialize(data={})
+    @sku_id = data[:sku_id]
+    @old_price = data[:old_price]
+    @new_price = data[:new_price]
+  end
+
+  def notify
+    #aqui vai o seu código.
+    #vc pode, e em geral vai acontecer isso, instanciar um UseCase e executa-lo.
+  end
+end
+````
+
+##### As Operações executadas por um listener devem ser Idempotentes sempre!!!
+Por razões de segurança, e para garantia da consistencia dos nossos dados, as operações realizadas por um Listener deve ser idempontentes.
+
+>Idempotente quer dizer que múltiplas requisições ao mesmo recurso usando o método devem ter o mesmo resultado que teria uma requisição apenas. A título de curiosidade, idempotente é a propriedade de um número que, multiplicado por ele mesmo, tem ele mesmo como resultado (n x n = n), em termos de números reais, apenas 0 e 1 têm essa propriedade. Em termos de métodos de requisição HTTP, os métodos GET, HEAD, PUT e DELETE são os que possuem a propriedade de ser idempotentes
+- <cite>[Dicionario Informal](http://www.dicionarioinformal.com.br/idempotente/)</cite>
+
+##### Onde colocar meus listeners
+Em geral, costuma-se criar dentro de app/ uma pasta chamada listeners ou event_listeners.
+
+####2. Registrar o Listener para o evento 
+No arquivo setup_events.rb existe uma seção dedicada ao registro dos listeners.
+Esta seção vem toda comentada por padrão, veja:
+```ruby
+  # Register your listeners Here!!!! Example:
+  # Event.register_listeners do |config|
+  #   config.add_listeners(:event_name, ['EventNameListener'])
+  #   config.add_listeners(:another_event_name, ['AnotherEventListener1', 'Listner2'])
+  # end
+```
+Basta descomentar e seguir como no exemplo. Imaginando que queremos registrar o nosso SkuPriceChangedListener, esta configuracao ficaria assim:
+
+```ruby
+  # Register your listeners Here!!!! Example:
+  Event.register_listeners do |config|
+    config.add_listeners(:sku_price_changed, ['SkuPriceChanged'])
+  end
+```
+
+**Note que você sempre deve fornecer o nome do Listener com uma String dentro de um Array.**
+
+**Observação:** Como este arquivo setup_events.rb é carregado na inicialização da aplicação, toda vez que você registrar um evento novo vai precisar reinicar a app.
+
+
+## Contributing
+1. Fork it ( https://github.com/[my-github-username]/event/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/event_pub_sub.gemspec

@@ -0,0 +1,30 @@
+# encoding: utf-8
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'event_pub_sub/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'event-pub-sub'
+  spec.version       = EventPubSub::VERSION
+  spec.authors       = ['Estante Virutal']
+  spec.email         = ['equipe_ti@estantevirtual.com.br']
+  spec.summary       = %q{Pub/Sub de Eventos baseado em RabbitMQ.}
+  spec.description   = %q{Pub/Sub de Eventos baseado em RabbitMQ.}
+  spec.homepage      = 'http://www.estantevirtual.com.br'
+
+  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 'bunny', '2.3.0'
+  spec.add_dependency 'activesupport', '4.2.5.2'
+
+  spec.add_development_dependency 'bundler', '~> 1.7'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '3.2.0'
+  spec.add_development_dependency 'guard-rspec', '4.5.0'
+  spec.add_development_dependency 'byebug', '8.2.1'
+
+end

data/lib/config/event.yml

@@ -0,0 +1,31 @@
+development:
+  base_routing_key: module_name
+  broker:
+    ip: localhost
+    port: 5672
+    username: guest
+    password: guest
+
+test:
+  base_routing_key: module_name
+  broker:
+    ip: localhost
+    port: 5672
+    username: guest
+    password: guest
+
+staging:
+  base_routing_key: module_name
+  broker:
+    ip: <%=ENV['BROKER_IP'] %>
+    port: <%=ENV['BROKER_PORT'] %>
+    username: <%=ENV['BROKER_USERNAME'] %>
+    password: <%=ENV['BROKER_PASSWORD'] %>
+
+production:
+  base_routing_key: module_name
+  broker:
+    ip: <%=ENV['BROKER_IP'] %>
+    port: <%=ENV['BROKER_PORT'] %>
+    username: <%=ENV['BROKER_USERNAME'] %>
+    password: <%=ENV['BROKER_PASSWORD'] %>

data/lib/config/initializers/setup_event.rb

@@ -0,0 +1,26 @@
+# require 'event'
+# require 'yaml'
+
+# module YourModuleNameHere
+#   class Event
+#     broker_data = File.read( File.expand_path('../../event.yml',__FILE__) )
+#     broker_config = YAML.load(ERB.new(broker_data).result).with_indifferent_access
+#     @@message_producer = ::Event::MessageProducer.new(broker_config[Rails.env], Rails.logger)
+
+#     if !Rails.env.test?
+#       listener_data = File.read( File.expand_path('../../listeners.yml',__FILE__) )
+#       listeners = YAML.load(listener_data).with_indifferent_access
+
+#       if listeners.any?
+#         Thread.new do
+#           consumer = ::Event::MessageConsumer.new(broker_config[Rails.env], Rails.logger)
+#           consumer.execute(listeners)
+#         end
+#       end
+#     end
+
+#     def self.publish(event_name, data={})
+#       @@message_producer.publish(event_name.to_sym, data)
+#     end
+#   end
+# end

data/lib/config/listeners.yml

@@ -0,0 +1,7 @@
+#event: ['ClassName']
+#event: ['Module::ClassName']
+### - Se vc tiver um caso onde um ou mais listeners precisam ser executados para qualquer evento,
+### ou seja, se indepentende do evento que aconteceu vc quer que aquele listener rode use a sintaxe abaixo:
+#any_event: [ClassName]
+
+##PS: as sintaxes acimma nao são excludentes, vc pode usar as duas em conjunto

data/lib/event_pub_sub.rb

@@ -0,0 +1,14 @@
+require 'time'
+require 'bunny'
+require 'logger'
+require "event_pub_sub/version"
+require 'event_pub_sub/broker_handler'
+require 'event_pub_sub/message_producer'
+require 'event_pub_sub/message_consumer'
+require 'event_pub_sub/listener'
+require 'json'
+require 'securerandom'
+
+module EventPubSub
+
+end

data/lib/event_pub_sub/broker_handler.rb

@@ -0,0 +1,65 @@
+module EventPubSub
+  class BrokerHandler
+
+    def initialize(config, logger)
+      raise ArgumentError, "missing broker ip" unless config[:ip]
+      raise ArgumentError, "missing broker port" unless config[:port]
+      raise ArgumentError, "missing broker username" unless config[:username]
+      raise ArgumentError, "missing broker password" unless config[:password]
+      @config = config
+      @logger = logger
+    end
+
+    def start_connection
+      @connection = build_connection
+      @connection.start
+      rescue => e
+        @logger.error "#{e.message} - #{e.class}\n #{e.backtrace.join("\n")}"
+    end
+
+    def close_connection
+      @connection.close
+    end
+
+    def publish(message, routing_key)
+      topic.publish( message, persistent: true, routing_key: routing_key )
+    end
+
+    def setup_queue(queue_name)
+      @queue = channel.queue(queue_name, durable: true, auto_delete: false)
+      @queue.bind(topic, routing_key: '#')
+    end
+
+    def subscribe(consumer_name, params={ack: true, block: true}, &block)
+      params[:consumer_tag] = consumer_name
+      @queue.subscribe(params) do |delivery_info, properties, payload|
+        begin
+          block.call(delivery_info, properties, payload)
+          channel.ack(delivery_info.delivery_tag)
+        rescue => e
+          channel.nack(delivery_info.delivery_tag, false, true)
+          raise e
+        end
+      end
+    end
+
+    private
+    def build_connection
+      Bunny.new(
+        host: @config[:ip],
+        port: @config[:port],
+        user: @config[:username],
+        pass: @config[:password]
+      )
+    end
+
+    def topic
+      @topic ||= channel.topic('topic_events', durable: true)
+    end
+
+
+    def channel
+      @channel ||= @connection.create_channel
+    end
+  end
+end

data/lib/event_pub_sub/listener.rb

@@ -0,0 +1,7 @@
+module EventPubSub
+  class Listener
+    def notify
+      fail NotImplementedError, "You must implement notify method in #{self.class}"
+    end
+  end
+end

data/lib/event_pub_sub/message_consumer.rb

@@ -0,0 +1,65 @@
+module EventPubSub
+  class MessageConsumer
+    def initialize(config, logger)
+      raise ArgumentError, "missing module base_routing_key " unless config[:base_routing_key]
+      @queue_name = config[:base_routing_key]
+      @logger = logger
+      @broker_handler = BrokerHandler.new(config[:broker], @logger)
+      @logger.info '[MessageConsumer] - Starting Connection'
+      @broker_handler.start_connection
+      @broker_handler.setup_queue(@queue_name)
+    end
+
+    def execute(all_listeners)
+      @logger.info '[MessageConsumer] - Waiting Messages...'
+      consumer_name = "#{@queue_name}_event_consumer"
+      @broker_handler.subscribe(consumer_name) do |delivery_info, properties, payload|
+        message = JSON.parse(payload).with_indifferent_access
+        event_name = message['event_name']
+        @logger.debug "[MessageConsumer] - Message Received: #{event_name}"
+        listeners_to_execute = get_listeners_of(event_name, all_listeners)
+        fire_listeners(listeners_to_execute, message)
+      end
+    end
+
+    def close_connection
+      @logger.info '[MessageConsumer] - Closing Connection'
+      @broker_handler.close_conection
+    end
+
+    def get_listeners_of(event_name, listeners_definitions)
+      listeners = listeners_definitions[event_name.to_sym] || []
+      if has_mappings_for_any_event?(listeners_definitions)
+        listeners.concat get_listeners_for_any_event(listeners_definitions)
+      end
+
+      listeners
+    end
+
+    private
+    def fire_listeners(listeners_to_execute, data)
+      if listeners_to_execute
+        listeners_to_execute.each do |listener_klass_name|
+          @logger.info "[Event Handling] - using listener class '#{listener_klass_name}'"
+          @logger.debug "[Event Handling] - notify event '#{@event_name}' using listener class '#{listener_klass_name}' with args '#{data}'"
+          begin
+            listener_klass = Object.const_get(listener_klass_name)
+            listener_klass.new(data).notify
+          rescue => e
+            @logger.error "[Event Handling] - #{e} \n #{e.backtrace.join("\n")}"
+            raise e
+          end
+        end
+      end
+    end
+
+    def has_mappings_for_any_event?(listeners_definitions)
+      listeners_definitions[:any_event] && listeners_definitions[:any_event].any?
+    end
+
+    def get_listeners_for_any_event(listeners_definitions)
+      listeners_definitions[:any_event]
+    end
+
+  end
+end

data/lib/event_pub_sub/message_producer.rb

@@ -0,0 +1,36 @@
+module EventPubSub
+  class MessageProducer
+    def initialize(config, logger)
+      raise ArgumentError, "missing module base_routing_key " unless config[:base_routing_key]
+      @base_routing_key = config[:base_routing_key]
+      @logger = logger
+
+      @broker_handler = BrokerHandler.new(config[:broker], @logger)
+      @logger.info '[MessageProducer] - Starting Connection'
+      @broker_handler.start_connection
+    end
+
+    def publish(event_name, msg={})
+      key = routing_key(event_name)
+      enrich_message(event_name, msg)
+      @logger.info "[MessageProducer] - Sending event: #{event_name}"
+      @logger.debug "[MessageProducer] - Sending event: #{event_name} with data: #{msg.inspect} using as routing_key: #{key}"
+      @broker_handler.publish( JSON.generate(msg), key )
+    end
+
+    private
+    def routing_key(event_name)
+      "#{@base_routing_key}.#{event_name}"
+    end
+
+    def enrich_message(event_name, msg)
+      msg[:event_id] = SecureRandom.uuid
+      msg[:event_name] = event_name
+      if defined?(Rails)
+        msg[:event_date] = Time.zone.now
+      else
+        msg[:event_date] = Time.now.utc
+      end
+    end
+  end
+end

data/lib/event_pub_sub/railtie.rb

@@ -0,0 +1,11 @@
+require 'event'
+require 'rails'
+module EventPubSub
+  class Railtie < Rails::Railtie
+    railtie_name :event_bus
+
+    rake_tasks do
+      load "tasks/event_tasks.rake"
+    end
+  end
+end

data/lib/event_pub_sub/version.rb

@@ -0,0 +1,3 @@
+module EventPubSub
+  VERSION = "1.1.6"
+end

data/lib/tasks/event_tasks.rake

@@ -0,0 +1,21 @@
+require 'fileutils'
+namespace :event do
+  desc "Installs required stuff to event"
+  task :install do
+    Rails.logger = Logger.new(STDOUT)
+    source = File.join(Gem.loaded_specs["event"].full_gem_path, "lib/config", "event.yml")
+    target = File.join("config", "event.yml")
+    Rails.logger.info "Creating file #{target}"
+    FileUtils.cp_r(source, target)
+
+    source = File.join(Gem.loaded_specs["event"].full_gem_path, "lib/config", "listeners.yml")
+    target = File.join("config", "listeners.yml")
+    Rails.logger.info "Creating file #{target}"
+    FileUtils.cp_r(source, target)
+
+    source = File.join(Gem.loaded_specs["event"].full_gem_path, "lib/config/initializers", "setup_event.rb")
+    target = File.join("config/initializers", "setup_event.rb")
+    Rails.logger.info "Creating file #{target}"
+    FileUtils.cp_r(source, target)
+  end
+end

data/spec/integration/broker_handler_spec.rb

@@ -0,0 +1,72 @@
+require 'spec_helper'
+module EventPubSub
+describe BrokerHandler do
+  let(:logger){ double('logger', debug: true)}
+  let(:running_server_config) do
+    {
+      ip: "localhost",
+      port: "5672",
+      username: "guest",
+      password: "guest",
+    }
+  end
+
+  let(:stopped_server_config) do
+    {
+      ip: "localhost",
+      port: "4000",
+      username: "guest",
+      password: "guest",
+    }
+  end
+
+  describe "#start_connection" do
+    context "given a up and running RabbitMQ server at localhost:5672" do
+      subject{ BrokerHandler.new(running_server_config, logger) }
+      it "stabilish connection" do
+        expect{subject.start_connection}.to_not raise_error
+      end
+    end
+
+    context "given a stoped RabbitMQ server" do
+      subject{ BrokerHandler.new(stopped_server_config, logger) }
+      it "raise error" do
+        expect{ subject.start_connection }.to raise_error
+      end
+    end
+  end
+
+  describe "#close_connection" do
+    context "given a up and running RabbitMQ server at localhost:5672" do
+      subject{ BrokerHandler.new(running_server_config, logger) }
+
+      it "closes connection" do
+        subject.start_connection
+        expect{subject.close_connection}.to_not raise_error
+      end
+
+      it "closes the channel" do
+        channel = subject.start_connection
+        expect(channel).to receive(:close).once
+        subject.close_connection
+      end
+    end
+  end
+
+  describe "#publish" do
+    context "given a up and running RabbitMQ server at localhost:5672" do
+      subject do
+        bus = BrokerHandler.new(running_server_config, logger)
+        bus.start_connection
+
+        bus
+      end
+      it "publish the event using base_routing_key" do
+        expect{ subject.publish( "'data': 'sample data'", 'routing.key') }.to_not raise_error
+      end
+    end
+  end
+
+end
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+$LOAD_PATH.unshift File.expand_path("../lib", __FILE__)
+require 'bundler'
+Bundler.setup(:default, :test)
+require 'event_pub_sub'
+require 'pry'
+require 'byebug'

data/spec/unit/broker_handler_spec.rb

@@ -0,0 +1,102 @@
+require 'spec_helper'
+
+module EventPubSub
+describe BrokerHandler do
+  let(:logger) { double(:log, debug: true) }
+  let(:config) do
+    {
+      ip: "localhost",
+      port: "5672",
+      username: "guest",
+      password: "guest"
+    }
+  end
+
+  describe "API" do
+    subject{ BrokerHandler.new(config, logger)}
+    it { should respond_to :start_connection }
+    it { should respond_to :publish }
+    it { should respond_to :close_connection }
+  end
+
+  describe "initialize" do
+    it "raise Argument Error when no config is given" do
+      expect{BrokerHandler.new}.to raise_error ArgumentError
+    end
+
+    it "raise ArgumentError error with a invalid config" do
+      expect{BrokerHandler.new('aaaaa')}.to raise_error ArgumentError
+    end
+
+    it "raise ArgumentError error with a incomplete config" do
+      expect{BrokerHandler.new({})}.to raise_error ArgumentError
+      expect{BrokerHandler.new({ip: 1})}.to raise_error ArgumentError
+      expect{BrokerHandler.new({ip: 1, port: 2})}.to raise_error ArgumentError
+      expect{BrokerHandler.new({ip: 1, port: 2, username: 'a'})}.to raise_error ArgumentError
+    end
+
+    it "not raise error with a valid config" do
+      expect{BrokerHandler.new(config, logger)}.to_not raise_error
+    end
+  end
+
+  describe "#start_connection" do
+    context "Given a RabbitMQ Broker and a BrokerHandler with valid configuration" do
+      let(:mocked_rabbitmq_lib){double}
+      let(:connection){ double }
+      subject{ BrokerHandler.new(config, logger) }
+
+      it "returns a RabbitMQ Connection" do
+        expect(subject).to receive(:build_connection).once.and_return(mocked_rabbitmq_lib)
+        expect(mocked_rabbitmq_lib).to receive(:start).once.and_return(connection)
+        expect(subject.start_connection).to be connection
+      end
+    end
+  end
+
+  describe "#close_connection" do
+    context "Given BrokerHandler with a open connection" do
+      let(:mocked_rabbitmq_lib){double}
+      let(:connection){ double }
+
+      before do
+        allow(subject).to receive(:build_connection).and_return(mocked_rabbitmq_lib)
+        allow(mocked_rabbitmq_lib).to receive(:start).once.and_return(connection)
+      end
+
+      subject{ BrokerHandler.new(config, logger) }
+
+      it "closes a RabbitMQ Connection" do
+        subject.start_connection
+        expect(mocked_rabbitmq_lib).to receive(:close).once
+        subject.close_connection
+      end
+    end
+  end
+
+    describe "#publish" do
+    context "given a up and running RabbitMQ server at localhost:5672" do
+      let(:mocked_rabbitmq_lib){double(:bunny_mock)}
+      let(:channel){double(:channel, topic: true)}
+      let(:connection){double(:connection_mock)}
+      let(:topic){double(:topic_mock)}
+      before do
+        allow(subject).to receive(:build_connection).and_return(mocked_rabbitmq_lib)
+        allow(mocked_rabbitmq_lib).to receive(:start).once.and_return(connection)
+        allow(mocked_rabbitmq_lib).to receive(:create_channel).and_return(channel)
+        allow(channel).to receive(:topic).and_return(topic)
+      end
+      subject{ BrokerHandler.new(config, logger) }
+
+      it "publish the event using base_routing_key" do
+        subject.start_connection
+        expect(topic).to receive(:publish).once
+        subject.publish('message', 'routing.key')
+      end
+    end
+  end
+
+
+end
+end
+

data/spec/unit/listener_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+
+module EventPubSub
+  describe Listener do
+    describe "api" do
+      it { is_expected.to respond_to :notify }
+    end
+
+    describe "#notify" do
+      it "raises NotImplementedError in order to remember the developer to override this operation on subclasses" do
+        expect{suject.notify}.to raise_error
+      end
+    end
+  end
+end
+

data/spec/unit/message_consumer_spec.rb

@@ -0,0 +1,85 @@
+require 'spec_helper'
+
+module EventPubSub
+
+describe MessageConsumer do
+  let(:logger) { double(:log, debug: true, info: true) }
+  let(:config) do
+    { broker: {
+        ip: "localhost",
+        port: "5672",
+        username: "guest",
+        password: "guest"
+      },
+      base_routing_key: "module_name"
+    }
+  end
+
+  describe "API" do
+    subject{ MessageConsumer.new(config, logger) }
+    it { should respond_to(:execute) }
+    it { should respond_to(:get_listeners_of) }
+  end
+
+  describe ".initialize" do
+    it "raise ArgumentError when no config was given" do
+      expect{ MessageConsumer.new }.to raise_error(ArgumentError)
+    end
+
+    it "raise ArgumentError if invalid config was given" do
+      expect{ MessageConsumer.new({}) }.to raise_error(ArgumentError)
+    end
+
+    it "no raise error if a valid config was given" do
+      expect{ MessageConsumer.new(config, logger) }.to_not raise_error
+    end
+  end
+
+  describe "#get_listeners_of" do
+    context "Given a event called new_sku_added with ExampleListener class associated" do
+      let(:listener_definitions) do
+        { new_sku_added: ["ExampleListenerClass"] }
+      end
+
+      subject{ MessageConsumer.new(config, logger) }
+
+      it "returns [ExampleListenerClass]" do
+        result = subject.get_listeners_of('new_sku_added', listener_definitions)
+        expect(result).to eql ['ExampleListenerClass']
+      end
+    end
+
+    context "Given a listener called AllEventsListener mapped for any event" do
+      let(:listener_definitions) do
+        { any_event: ["AllEventListenerClass"] }
+      end
+
+      subject{ MessageConsumer.new(config, logger) }
+
+      it "returns [AllEventListenerClass]" do
+        result = subject.get_listeners_of('foo_bar_updated', listener_definitions)
+        expect(result).to eql ['AllEventListenerClass']
+      end
+    end
+
+    context "Given a listener called AllEventsListener mapped for any event and new_sku_added mapped to ExampleListener" do
+      let(:listener_definitions) do
+        { new_sku_added: ["ExampleListenerClass"], any_event: ["AllEventListenerClass"] }
+      end
+
+      subject{ MessageConsumer.new(config, logger) }
+
+      it "for 'new_sku_added' event returns [ExampleListenerClass, AllEventListenerClass]" do
+        result = subject.get_listeners_of('new_sku_added', listener_definitions)
+        expect(result).to eql ['ExampleListenerClass', 'AllEventListenerClass']
+      end
+
+      it "for 'product_selled' event returns [AllEventListenerClass]" do
+        result = subject.get_listeners_of('product_selled', listener_definitions)
+        expect(result).to eql ['AllEventListenerClass']
+      end
+    end
+  end
+end
+end
+

data/spec/unit/message_producer_spec.rb

@@ -0,0 +1,65 @@
+require 'spec_helper'
+module EventPubSub
+describe MessageProducer do
+  let(:logger) { double(:log, debug: true, info: true) }
+  let(:config) do
+    {
+      broker: {
+        ip: "localhost",
+        port: "5672",
+        username: "guest",
+        password: "guest"
+      },
+      base_routing_key: "module_name"
+    }
+  end
+
+  describe "API" do
+    subject{ MessageProducer.new(config, logger)}
+    it { should respond_to :publish }
+  end
+
+  describe "initialize" do
+    it "raise Argument Error when no config is given" do
+      expect{MessageProducer.new}.to raise_error ArgumentError
+    end
+
+    it "raise ArgumentError error with a invalid config" do
+      expect{MessageProducer.new('aaaaa')}.to raise_error ArgumentError
+    end
+
+    it "raise ArgumentError error with a incomplete config" do
+      expect{MessageProducer.new({})}.to raise_error ArgumentError
+      expect{MessageProducer.new({ip: 1})}.to raise_error ArgumentError
+      expect{MessageProducer.new({ip: 1, port: 2})}.to raise_error ArgumentError
+      expect{MessageProducer.new({ip: 1, port: 2, username: 'a'})}.to raise_error ArgumentError
+      expect{MessageProducer.new({ip: 1, port: 2, username: 'a', password: "123"})}.to raise_error ArgumentError
+    end
+
+    it "not raise error with a valid config" do
+      expect{MessageProducer.new(config, logger)}.to_not raise_error
+    end
+  end
+
+  describe "#publish" do
+    context "Given a event named 'sku_created' with data => {code: 10, price: 20.87, product_id: 2}" do
+      let(:event_name){ :sku_created }
+      let(:event_data) do
+        { code: 10, price: 20.87, product_id: 2, event_name: 'sku_created' }
+      end
+      let(:expected_message){ JSON.generate(event_data) }
+      let(:fake_broker){double('broker', start_connection: true )}
+
+      subject{ MessageProducer.new(config, logger)}
+
+      it "calls BrokerHandler#publish with message => {code: 10, price: 20.87, product_id: 2} and routing_key => module_name.sku_created" do
+        allow(BrokerHandler).to receive(:new).and_return fake_broker
+        expect(fake_broker).to receive(:publish).once
+        subject.publish(event_name, event_data)
+      end
+    end
+  end
+
+end
+end
+

metadata

@@ -0,0 +1,173 @@
+--- !ruby/object:Gem::Specification
+name: event-pub-sub
+version: !ruby/object:Gem::Version
+  version: 1.1.6
+platform: ruby
+authors:
+- Estante Virutal
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-03-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bunny
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 4.2.5.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 4.2.5.2
+- !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.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 4.5.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 4.5.0
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 8.2.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 8.2.1
+description: Pub/Sub de Eventos baseado em RabbitMQ.
+email:
+- equipe_ti@estantevirtual.com.br
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- Gemfile.lock
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- event_pub_sub.gemspec
+- lib/config/event.yml
+- lib/config/initializers/setup_event.rb
+- lib/config/listeners.yml
+- lib/event_pub_sub.rb
+- lib/event_pub_sub/broker_handler.rb
+- lib/event_pub_sub/listener.rb
+- lib/event_pub_sub/message_consumer.rb
+- lib/event_pub_sub/message_producer.rb
+- lib/event_pub_sub/railtie.rb
+- lib/event_pub_sub/version.rb
+- lib/tasks/event_tasks.rake
+- spec/integration/broker_handler_spec.rb
+- spec/spec_helper.rb
+- spec/unit/broker_handler_spec.rb
+- spec/unit/listener_spec.rb
+- spec/unit/message_consumer_spec.rb
+- spec/unit/message_producer_spec.rb
+homepage: http://www.estantevirtual.com.br
+licenses: []
+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.6
+signing_key: 
+specification_version: 4
+summary: Pub/Sub de Eventos baseado em RabbitMQ.
+test_files:
+- spec/integration/broker_handler_spec.rb
+- spec/spec_helper.rb
+- spec/unit/broker_handler_spec.rb
+- spec/unit/listener_spec.rb
+- spec/unit/message_consumer_spec.rb
+- spec/unit/message_producer_spec.rb