event_people 1.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2b1e5ca203068a90528dffe028e28ff159fea2be235a8cb7124a27d65d9e994a
+  data.tar.gz: '06552910da1f09062cd1a0056c9a048a05ced2fe48e8f29759c2d41dce1ea847'
+SHA512:
+  metadata.gz: 81234ed5232c88a4231c49d1bc0675ae9c637f99acc53e917d6fb193ddf8a6bbd0e0a9db1980009aad8abf16dc32be24d62afb455de8fd0bcfab2cdc0018c425
+  data.tar.gz: d529f3a44d8a53f05c81a024a73ca8217e42cac3b338b58ed8015322b4c3dbe49788730560e044380fe46d2ad7e8cca42bbee36a67ad0b94e058cf62ee37f471

data/.circleci/config.yml

@@ -0,0 +1,49 @@
+# Ruby CircleCI 2.0 configuration file
+#
+# Check https://circleci.com/docs/2.1/language-ruby/ for more details
+#
+version: 2.1
+jobs:
+  validate:
+    docker:
+      # specify the version you desire here
+      - image: cimg/ruby:3.1
+
+    steps:
+      - checkout
+
+      # Download and cache dependencies
+      - restore_cache:
+          keys:
+          - pin-people-event-people-deps-{{ checksum "Gemfile.lock" }}
+          - pin-people-event-people-deps-
+
+      - run:
+          name: install dependencies
+          command: |
+            gem install bundler
+            bundle config set path 'vendor/bundle'
+            bundle config set jobs '4'
+            bundle config set retry '3'
+            bundle install
+
+      - save_cache:
+          paths:
+            - ./vendor/bundle
+          key: pin-people-event-people-deps-{{ checksum "Gemfile.lock" }}
+
+      # run tests!
+      - run:
+          name: run tests
+          environment:
+            DATABASE_URL: "postgres://ubuntu@localhost:5432/core_test"
+          command: |
+            cp .env.example .env
+
+            RUBYOPT='-W:no-deprecated -W:no-experimental' bundle exec rspec --format progress
+
+workflows:
+  version: 2.1
+  validate:
+    jobs:
+      - validate

data/.env.example

@@ -0,0 +1,4 @@
+RABBIT_URL=amqp://guest:guest@localhost:5672
+RABBIT_EVENT_PEOPLE_APP_NAME=app_name
+RABBIT_EVENT_PEOPLE_VHOST=event_people
+RABBIT_EVENT_PEOPLE_TOPIC_NAME=event_people

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+.env*
+!.env.example

data/.rspec

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

data/.ruby-version

@@ -0,0 +1 @@
+3.1.1

data/Gemfile

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

data/Gemfile.lock

@@ -0,0 +1,65 @@
+PATH
+  remote: .
+  specs:
+    event_people (1.0.1)
+      bunny (~> 2.7)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    amq-protocol (2.3.2)
+    awesome_print (1.9.2)
+    bunny (2.19.0)
+      amq-protocol (~> 2.3, >= 2.3.1)
+      sorted_set (~> 1, >= 1.0.2)
+    byebug (11.1.3)
+    coderay (1.1.3)
+    diff-lcs (1.5.0)
+    method_source (1.0.0)
+    pry (0.13.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    pry-byebug (3.9.0)
+      byebug (~> 11.0)
+      pry (~> 0.13.0)
+    pry-meta (0.0.10)
+      awesome_print
+      pry
+      pry-byebug
+      pry-remote
+    pry-remote (0.1.8)
+      pry (~> 0.9)
+      slop (~> 3.0)
+    rake (13.0.6)
+    rbtree (0.4.5)
+    rspec (3.11.0)
+      rspec-core (~> 3.11.0)
+      rspec-expectations (~> 3.11.0)
+      rspec-mocks (~> 3.11.0)
+    rspec-core (3.11.0)
+      rspec-support (~> 3.11.0)
+    rspec-expectations (3.11.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-mocks (3.11.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-support (3.11.0)
+    set (1.0.2)
+    slop (3.6.0)
+    sorted_set (1.0.3)
+      rbtree
+      set (~> 1.0)
+
+PLATFORMS
+  arm64-darwin-21
+
+DEPENDENCIES
+  bundler
+  event_people!
+  pry-meta
+  rake
+  rspec
+
+BUNDLED WITH
+   2.3.15

data/LICENSE.txt

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

data/README.md

@@ -0,0 +1,239 @@
+# EventPeople
+
+[![CircleCI](https://dl.circleci.com/status-badge/img/gh/pin-people/event_people_ruby/tree/main.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/pin-people/event_people_ruby/tree/main)
+
+EventPeople is a tool to simplify the communication of services based on events. It is an extension of the [EventBus](https://github.com/EmpregoLigado/event_bus_rb) gem.
+
+The main idea is to provide a tool that can emit or consume events based on its names, the event name has 4 words (`resource.origin.action.destiny`) which defines some important info about what kind of event it is, where it comes from and who is eligible to consume it:
+
+- **resource:** Defines which resource this event is related like a `user`, a `product`, `company` or anything that you want;
+- **origin:** Defines the name of the system which emitted the event;
+- **action:** What action is made on the resource like `create`, `delete`, `update`, etc. PS: *It is recommended to use the Semple Present tense for actions*;
+- **destiny (Optional):** This word is optional and if not provided EventPeople will add a `.all` to the end of the event name. It defines which service should consume the event being emitted, so if it is defined and there is a service whith the given name only this service will receive it. It is very helpful when you need to re-emit some events. Also if it is `.all` all services will receive it.
+
+As of today EventPeople uses RabbitMQ as its datasource, but there are plans to add support for other Brokers in the future.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'event_people'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install event_people
+
+And set env vars:
+```ruby
+ENV['RABBIT_URL'] = 'amqp://guest:guest@localhost:5672'
+ENV['RABBIT_EVENT_PEOPLE_APP_NAME'] = 'service_name'
+ENV['RABBIT_EVENT_PEOPLE_VHOST'] = 'event_people'
+ENV['RABBIT_EVENT_PEOPLE_TOPIC_NAME'] = 'event_people'
+````
+
+## Usage
+
+### Events
+
+The main component of `EventPeople` is the `EventPeople::Event` class which wraps all the logic of an event and whenever you receive or want to send an event you will use it.
+
+It has 2 attributes `name` and `payload`:
+
+- **name:** The name must follow our conventions, being it 3 (`resource.origin.action`) or 4 words (`resource.origin.action.destiny`);
+- **payload:** It is the body of the massage, it should be a Hash object for simplicity and flexibility.
+
+```ruby
+require 'event_people'
+
+event_name = 'user.users.create'
+body = { id: 42, name: 'John Doe', age: 35 }
+event = EventPeople::Event.new(event_name, body)
+```
+
+There are 3 main interfaces to use `EventPeople` on your project:
+
+- Calling `EventPeople::Emitter.trigger(event)` inside your project;
+- Calling `EventPeople::Listener.on(event_name)` inside your project;
+- Or extending `EventPeople::Listeners::Base` and use it as a daemon.
+
+### Using the Emitter
+You can emit events on your project passing an `EventPeople::Event` instance to the `EventPeople::Emitter.trigger` method. Doing this other services that are subscribed to these events will receive it.
+
+```ruby
+require 'event_people'
+
+event_name = 'receipt.payments.pay.users'
+body = { amount: 350.76 }
+event = EventPeople::Event.new(event_name, body)
+
+EventPeople::Emitter.trigger(event)
+
+# Don't forget to close the connection!!!
+EventPeople::Config.broker.close_connection
+```
+[See more details](https://github.com/pin-people/event_people_ruby/blob/master/examples/emitter.rb)
+
+### Listeners
+
+You can subscribe to events based on patterns for the event names you want to consume or you can use the full name of the event to consume single events.
+
+We follow the RabbitMQ pattern matching model, so given each word of the event name is separated by a dot (`.`), you can use the following symbols:
+
+- `* (star):` to match exactly one word. Example `resource.*.*.all`;
+- `# (hash):` to match zero or more words. Example `resource.#.all`.
+
+Other important aspect of event consumming is the result of the processing we provide 3 methods so you can inform the Broker what to do with the event next:
+
+- `success!:` should be called when the event was processed successfuly and the can be discarded;
+- `fail!:` should be called when an error ocurred processing the event and the message should be requeued;
+- `reject!:` should be called whenever a message should be discarded without being processed.
+
+Given you want to consume a single event inside your project you can use the `EventPeople::Listener.on` method. It consumes a single event, given there are events available to be consumed with the given name pattern.
+
+```ruby
+require 'event_people'
+
+# 3 words event names will be replaced by its 4 word wildcard
+# counterpart: 'payment.payments.pay.all'
+event_name = 'payment.payments.pay'
+
+EventPeople::Listener.on(event_name) do |event, _delivery_info|
+  puts ""
+  puts "  - Received the "#{event.name}" message from #{event.origin}:"
+  puts "     Message: #{event.body}"
+  puts ""
+  success!
+end
+
+EventPeople::Config.broker.close_connection
+```
+
+You can also receive all available messages using a loop:
+
+```ruby
+require 'event_people'
+
+event_name = 'payment.payments.pay.all'
+has_events = true
+
+while has_events do
+  has_events = false
+
+  EventPeople::Listener.on(event_name) do |event, _delivery_info|
+    has_events = true
+    puts ""
+    puts "  - Received the "#{event.name}" message from #{event.origin}:"
+    puts "     Message: #{event.body}"
+    puts ""
+    success!
+  end
+end
+
+EventPeople::Config.broker.close_connection
+```
+[See more details](https://github.com/pin-people/event_people_ruby/blob/master/examples/listener.rb)
+
+#### Multiple events routing
+
+If your project needs to handle lots of events you can extend `EventPeople::Listeners::Base` class to bind how many events you need to instance methods, so whenever an event is received the method will be called automatically.
+
+```ruby
+require 'event_people'
+
+class CustomEventListener < EventPeople::Listeners::Base
+  bind :pay, 'resource.custom.pay'
+  bind :receive, 'resource.custom.receive'
+  bind :private_channel, 'resource.custom.private.service'
+
+  def pay(event)
+    puts "Paid #{event.body['amount']} for #{event.body['name']} ~> #{event.name}"
+
+    success!
+  end
+
+  def receive(event)
+    if event.body['amount'] > 500
+      puts "Received #{event.body['amount']} from #{event.body['name']} ~> #{event.name}"
+    else
+      puts '[consumer] Got SKIPPED message'
+      return reject!
+    end
+
+    success!
+  end
+
+  def private_channel(event)
+    puts "[consumer] Got a private message: \"#{event.body['message']}\" ~> #{event.name}"
+
+    success!
+  end
+end
+```
+[See more details](https://github.com/pin-people/event_people_ruby/blob/master/examples/daemon.rb)
+
+#### Creating a Daemon
+
+If you have the need to create a deamon to consume messages on background you can use the `EventPeople::Daemon.start` to do so with ease. Just remember to define or import all the event bindings before starting the daemon.
+
+```ruby
+require 'event_people'
+
+class CustomEventListener < EventPeople::Listeners::Base
+  bind :pay, 'resource.custom.pay'
+  bind :receive, 'resource.custom.receive'
+  bind :private_channel, 'resource.custom.private.service'
+
+  def pay(event)
+    puts "Paid #{event.body['amount']} for #{event.body['name']} ~> #{event.name}"
+
+    success!
+  end
+
+  def receive(event)
+    if event.body['amount'] > 500
+      puts "Received #{event.body['amount']} from #{event.body['name']} ~> #{event.name}"
+    else
+      puts '[consumer] Got SKIPPED message'
+
+      return reject!
+    end
+
+    success!
+  end
+
+  def private_channel(event)
+    puts "[consumer] Got a private message: \"#{event.body['message']}\" ~> #{event.name}"
+
+    success!
+  end
+end
+
+puts '****************** Daemon Ready ******************'
+
+EventPeople::Daemon.start
+```
+[See more details](https://github.com/pin-people/event_people_ruby/blob/master/examples/daemon.rb)
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rspec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+- Fork it
+- Create your feature branch (`git checkout -b my-new-feature`)
+- Commit your changes (`git commit -am 'Add some feature'`)
+- Push to the branch (`git push origin my-new-feature`)
+- Create new Pull Request
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/event_people.gemspec

@@ -0,0 +1,34 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'event_people/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'event_people'
+  spec.version       = EventPeople::VERSION
+  spec.authors       = ['Pin People']
+  spec.email         = ['contato@pinpeople.com.br']
+
+  spec.summary       = 'Expose an api to produce and consume events.'
+  spec.description   = 'Tool to produce and consume events to a distributed and async architecture'
+  spec.homepage      = 'https://github.com/pin-people/event_people_ruby'
+  spec.license       = 'GNU LESSER GENERAL PUBLIC LICENSE V3'
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  raise 'RubyGems 2.0 or newer is required to protect against public gem pushes.' unless spec.respond_to?(:metadata)
+
+  spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'pry-meta'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec'
+
+  spec.add_dependency 'bunny', '~> 2.7'
+end

data/examples/daemon.rb

@@ -0,0 +1,48 @@
+#!/usr/bin/env ruby
+
+ENV['RABBIT_URL'] = 'amqp://guest:guest@localhost:5672'
+ENV['RABBIT_EVENT_PEOPLE_APP_NAME'] = 'EventPeopleExampleApp'
+ENV['RABBIT_EVENT_PEOPLE_VHOST'] = 'event_people'
+ENV['RABBIT_EVENT_PEOPLE_TOPIC_NAME'] = 'event_people'
+
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+
+require 'rubygems'
+require 'bundler'
+Bundler.require(:default, 'development')
+
+require_relative '../lib/event_people'
+
+class CustomEventListener < EventPeople::Listeners::Base
+  bind :pay, 'resource.custom.pay'
+  bind :receive, 'resource.custom.receive'
+  bind :private_channel, 'resource.custom.private.service'
+
+  def pay(event)
+    puts "Paid #{event.body['amount']} for #{event.body['name']} ~> #{event.name}"
+
+    success!
+  end
+
+  def receive(event)
+    if event.body['amount'] > 500
+      puts "Received #{event.body['amount']} from #{event.body['name']} ~> #{event.name}"
+    else
+      puts '[consumer] Got SKIPPED message'
+
+      return reject!
+    end
+
+    success!
+  end
+
+  def private_channel(event)
+    puts "[consumer] Got a private message: \"#{event.body['message']}\" ~> #{event.name}"
+
+    success!
+  end
+end
+
+puts '****************** Daemon Ready ******************'
+
+EventPeople::Daemon.start

data/examples/emitter.rb

@@ -0,0 +1,56 @@
+#!/usr/bin/env ruby
+
+ENV['RABBIT_URL'] = 'amqp://guest:guest@localhost:5672'
+ENV['RABBIT_EVENT_PEOPLE_APP_NAME'] = 'EventPeopleExampleApp'
+ENV['RABBIT_EVENT_PEOPLE_VHOST'] = 'event_people'
+ENV['RABBIT_EVENT_PEOPLE_TOPIC_NAME'] = 'event_people'
+
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+
+require 'rubygems'
+require 'bundler'
+Bundler.require(:default, 'development')
+
+require_relative '../lib/event_people'
+
+events = []
+
+event_name = 'resource.custom.pay'
+body = { amount: 1500, name: 'John' }
+
+events.push(EventPeople::Event.new(event_name, body))
+
+event_name = 'resource.custom.receive'
+body = { amount: 35, name: 'Peter' }
+
+events.push(EventPeople::Event.new(event_name, body))
+
+event_name = 'resource.custom.receive'
+body = { amount: 350, name: 'George' }
+
+events.push(EventPeople::Event.new(event_name, body))
+
+event_name = 'resource.custom.receive'
+body = { amount: 550, name: 'James' }
+
+events.push(EventPeople::Event.new(event_name, body))
+
+event_name = 'resource.custom.private.service'
+body = { message: 'Secret' }
+
+events.push(EventPeople::Event.new(event_name, body))
+
+event_name = 'resource.origin.action'
+body = { bo: 'dy' }
+schema_version = 4.2
+
+event = EventPeople::Event.new(event_name, body, schema_version)
+
+p 'Sending messsages.'
+
+EventPeople::Emitter.trigger(event)
+EventPeople::Emitter.trigger(events)
+
+p 'Mesages sent!'
+
+EventPeople::Config.broker.close_connection

data/examples/listener.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+
+ENV['RABBIT_URL'] = 'amqp://guest:guest@localhost:5672'
+ENV['RABBIT_EVENT_PEOPLE_APP_NAME'] = 'EventPeopleExampleApp'
+ENV['RABBIT_EVENT_PEOPLE_VHOST'] = 'event_people'
+ENV['RABBIT_EVENT_PEOPLE_TOPIC_NAME'] = 'event_people'
+
+$LOAD_PATH.unshift File.expand_path('../../lib', __dir__)
+
+require 'rubygems'
+require 'bundler'
+Bundler.require(:default, 'development')
+
+require_relative '../lib/event_people'
+
+event_name = 'resource.origin.action'
+
+puts 'Start receiving messages'
+
+EventPeople::Listener.on(event_name) do |event|
+  puts ''
+  puts "  - Received a message from #{event.name}:"
+  puts "     Message: #{event.body}"
+  puts ''
+end
+
+puts 'Stop receiving messages'
+
+EventPeople::Config.broker.close_connection

data/lib/event_people/broker/base.rb

@@ -0,0 +1,37 @@
+module EventPeople
+  module Broker
+    class Base
+      @@connection = nil
+
+      def self.consumers
+        @consumers ||= {}
+      end
+
+      def connection
+        raise NotImplementedError.new('Must be implemented')
+      end
+
+      def self.close_connection
+        raise NotImplementedError.new('Must be implemented')
+      end
+
+      def self.consume(event_name, &block)
+        consumers[event_name] ||= begin
+          new.consume(event_name, &block)
+        end
+      end
+
+      def consume(event_name, &block)
+        raise NotImplementedError.new('Must be implemented')
+      end
+
+      def self.produce(events)
+        new.produce(events)
+      end
+
+      def produce(events)
+        raise NotImplementedError.new('Must be implemented')
+      end
+    end
+  end
+end

data/lib/event_people/broker/rabbit/queue.rb

@@ -0,0 +1,49 @@
+module EventPeople
+  module Broker
+    class Rabbit::Queue
+      def initialize(channel)
+        @channel = channel
+        @channel.prefetch(1)
+      end
+
+      def self.subscribe(channel, routing_key, &block)
+        new(channel).subscribe(routing_key, &block)
+      end
+
+      def subscribe(routing_key, &block)
+        base_name = routing_key.split('.')[0..2].join('.')
+        name = queue_name("#{base_name}.all")
+
+        channel.queue(name, queue_options)
+               .bind(topic, routing_key: routing_key)
+               .subscribe(manual_ack: true) do |delivery_info, properties, payload|
+                 callback(delivery_info, properties, payload, &block)
+               end
+      end
+
+      private
+
+      attr_reader :channel
+
+      def callback(delivery_info, properties, payload, &block)
+        event_name = delivery_info.routing_key
+
+        event = EventPeople::Event.new(event_name, payload)
+
+        block.call(event, channel, delivery_info)
+      end
+
+      def topic
+        Rabbit::Topic.topic(channel)
+      end
+
+      def queue_options
+        { durable: true }
+      end
+
+      def queue_name(routing_key)
+        "#{EventPeople::Config::APP_NAME.downcase}-#{routing_key.downcase}"
+      end
+    end
+  end
+end

data/lib/event_people/broker/rabbit/topic.rb

@@ -0,0 +1,34 @@
+module EventPeople
+  module Broker
+    class Rabbit::Topic
+      def initialize(channel)
+        @channel = channel
+      end
+
+      def self.topic(channel)
+        new(channel).topic
+      end
+
+      def topic
+        @topic ||= channel.topic(EventPeople::Config::TOPIC, topic_options)
+      end
+
+      def self.produce(channel, event)
+        new(channel).produce(event)
+      end
+
+      def produce(event)
+        topic.publish(event.payload, routing_key: event.name,
+                      content_type: 'application/json')
+      end
+
+      private
+
+      attr_reader :channel
+
+      def topic_options
+        { passive: true }
+      end
+    end
+  end
+end

data/lib/event_people/broker/rabbit.rb

@@ -0,0 +1,41 @@
+module EventPeople
+  module Broker
+    class Rabbit < Base
+      def connection
+        @@connection ||= session
+      end
+
+      def consume(event_name, &block)
+        Queue.subscribe(channel, event_name, &block)
+      end
+
+      def produce(events)
+        events.each do |event|
+          Topic.produce(channel, event)
+        end
+      end
+
+      def self.close_connection
+        @@connection.close
+      end
+
+      private
+
+      def channel
+        @@channel ||= connection.create_channel
+        @@channel = connection.create_channel if @@channel.closed?
+        @@channel
+      end
+
+      def session
+        Bunny.new(url).tap do |session|
+          session.start
+        end
+      end
+
+      def url
+        EventPeople::Config::FULL_URL
+      end
+    end
+  end
+end

data/lib/event_people/config.rb

@@ -0,0 +1,13 @@
+module EventPeople
+  class Config
+    APP_NAME = ENV['RABBIT_EVENT_PEOPLE_APP_NAME']
+    TOPIC    = ENV['RABBIT_EVENT_PEOPLE_TOPIC_NAME']
+    VHOST    = ENV['RABBIT_EVENT_PEOPLE_VHOST']
+    URL      = ENV['RABBIT_URL']
+    FULL_URL = "#{ENV['RABBIT_URL']}/#{ENV['RABBIT_EVENT_PEOPLE_VHOST']}"
+
+    def self.broker
+      EventPeople::Broker::Rabbit
+    end
+  end
+end

data/lib/event_people/daemon.rb

@@ -0,0 +1,34 @@
+module EventPeople
+  class Daemon
+    INTERRUPTION_SIGNALS = %w(TERM INT)
+
+    def self.start
+      Listeners::Manager.bind_all_listeners
+
+      bind_signals
+    end
+
+    def self.stop
+      EventPeople::Config.broker.close_connection
+
+      exit
+    end
+
+    def self.bind_signals
+      read, write = IO.pipe
+
+      INTERRUPTION_SIGNALS.each do |signal|
+        Signal.trap(signal) { write.puts(signal) }
+      end
+
+      begin
+        while io = IO.select([read])
+          signal = io.first[0].gets.strip
+          raise Interrupt if INTERRUPTION_SIGNALS.include?(signal)
+        end
+      rescue Interrupt
+        stop
+      end
+    end
+  end
+end

data/lib/event_people/emitter.rb

@@ -0,0 +1,23 @@
+require 'json'
+
+module EventPeople
+  # Public: An class which decorates el-rabbit topic creation.
+  #
+  class Emitter
+    # Public: Produces a event on the Broker.
+    #
+    # event - The event to be produced.
+    #
+    # Returns the Event.
+    def self.trigger(*events)
+      events.flatten.each_with_index do |event, index|
+        raise(MissingAttributeError, "Event on position #{index} must have a body") unless event.body?
+        raise(MissingAttributeError, "Event on position #{index} must have a name") unless event.name?
+      end
+
+      EventPeople::Config.broker.produce(events.flatten)
+
+      events
+    end
+  end
+end

data/lib/event_people/event.rb

@@ -0,0 +1,56 @@
+module EventPeople
+  class Event
+    attr_reader :name, :headers, :body, :schema_version
+
+    def initialize(name, body, schema_version = 1.0)
+      @name = name
+      @body = body.is_a?(String) ? JSON.parse(body) : body
+      @schema_version = @body&.dig('headers', 'schemaVersion') || schema_version
+
+      if name?
+        generate_headers
+        fix_name
+      end
+
+      build_payload if @body&.key?('headers')
+    end
+
+    def payload
+      { headers:, body: }.to_json
+    end
+
+    def body?
+      body && !body.empty?
+    end
+
+    def name?
+      name && !name.empty?
+    end
+
+    private
+
+    def build_payload
+      @headers = body['headers']
+      @body = body['body']
+    end
+
+    def generate_headers
+      header_spec = name&.split('.')
+
+      @headers = {
+        appName: EventPeople::Config::APP_NAME,
+        resource: header_spec[0],
+        origin: header_spec[1],
+        action: header_spec[2],
+        destiny: header_spec[3] || 'all',
+        schemaVersion: schema_version
+      }
+    end
+
+    def fix_name
+      return if name.split('.').size != 3
+
+      @name = "#{@name}.all"
+    end
+  end
+end

data/lib/event_people/listener.rb

@@ -0,0 +1,23 @@
+require 'bunny'
+
+module EventPeople
+  class Listener
+    def self.on(event_name, &block)
+      new.on(event_name, &block)
+    end
+
+    def on(event_name, &block)
+      raise(MissingAttributeError, 'Event name must be present') unless event_name&.size&.positive?
+
+      event_name = consumed_event_name(event_name)
+
+      EventPeople::Config.broker.consume(event_name, &block)
+    end
+
+    private
+
+    def consumed_event_name(event_name)
+      event_name.split('.').size == 3 ? "#{event_name}.all" : event_name
+    end
+  end
+end

data/lib/event_people/listeners/base.rb

@@ -0,0 +1,60 @@
+module EventPeople
+  module Listeners
+    class Base
+      attr_reader :channel, :delivery_info
+
+      def initialize(channel, delivery_info)
+        @channel = channel
+        @delivery_info = delivery_info
+      end
+
+      def callback(method_name, event)
+        send method_name, event
+      end
+
+      def success!
+        channel.ack(delivery_info.delivery_tag, false)
+      end
+
+      def fail!
+        channel.nack(delivery_info.delivery_tag, false, true)
+      end
+
+      def reject!
+        channel.reject(delivery_info.delivery_tag, false)
+      end
+
+      def self.bind(method, event_name)
+        app_name = ENV['RABBIT_EVENT_PEOPLE_APP_NAME'].downcase
+
+        Manager.register_listener_configuration(
+          {
+            listener_class: self,
+            method:,
+            routing_key: fixed_event_name(event_name, 'all')
+          }
+        )
+        Manager.register_listener_configuration(
+          {
+            listener_class: self,
+            method:,
+            routing_key: fixed_event_name(event_name, app_name)
+          }
+        )
+      end
+
+      def self.fixed_event_name(event_name, postfix)
+        case event_name&.split('.')&.size
+        when 4
+          parts = event_name.split('.')
+
+          "#{parts[0..2].join('.')}.#{postfix}"
+        when nil
+          event_name
+        else
+          "#{event_name}.#{postfix}"
+        end
+      end
+    end
+  end
+end

data/lib/event_people/listeners/manager.rb

@@ -0,0 +1,26 @@
+# Module responsible for managing all listeners
+module EventPeople
+  module Listeners
+    module Manager
+      class << self
+        def bind_all_listeners
+          listener_configurations.each do |config|
+            EventPeople::Listener.on(config[:routing_key]) do |event, channel, delivery_info|
+              config[:listener_class].new(channel, delivery_info).callback(config[:method], event)
+            end
+          end
+        end
+
+        def register_listener_configuration(configuration)
+          listener_configurations.push(configuration)
+        end
+
+        private
+
+        def listener_configurations
+          @listener_configurations ||= []
+        end
+      end
+    end
+  end
+end

data/lib/event_people/version.rb

@@ -0,0 +1,3 @@
+module EventPeople
+  VERSION = '1.0.1'
+end

data/lib/event_people.rb

@@ -0,0 +1,16 @@
+require 'event_people/version'
+require 'event_people/daemon'
+require 'event_people/event'
+require 'event_people/config'
+require 'event_people/emitter'
+require 'event_people/listener'
+require 'event_people/listeners/base'
+require 'event_people/listeners/manager'
+require 'event_people/broker/base'
+require 'event_people/broker/rabbit'
+require 'event_people/broker/rabbit/queue'
+require 'event_people/broker/rabbit/topic'
+
+module EventPeople
+  class MissingAttributeError < StandardError; end
+end

metadata

@@ -0,0 +1,141 @@
+--- !ruby/object:Gem::Specification
+name: event_people
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+platform: ruby
+authors:
+- Pin People
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2022-08-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry-meta
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bunny
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+description: Tool to produce and consume events to a distributed and async architecture
+email:
+- contato@pinpeople.com.br
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".circleci/config.yml"
+- ".env.example"
+- ".gitignore"
+- ".rspec"
+- ".ruby-version"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- event_people.gemspec
+- examples/daemon.rb
+- examples/emitter.rb
+- examples/listener.rb
+- lib/event_people.rb
+- lib/event_people/broker/base.rb
+- lib/event_people/broker/rabbit.rb
+- lib/event_people/broker/rabbit/queue.rb
+- lib/event_people/broker/rabbit/topic.rb
+- lib/event_people/config.rb
+- lib/event_people/daemon.rb
+- lib/event_people/emitter.rb
+- lib/event_people/event.rb
+- lib/event_people/listener.rb
+- lib/event_people/listeners/base.rb
+- lib/event_people/listeners/manager.rb
+- lib/event_people/version.rb
+homepage: https://github.com/pin-people/event_people_ruby
+licenses:
+- GNU LESSER GENERAL PUBLIC LICENSE V3
+metadata:
+  allowed_push_host: https://rubygems.org
+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: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: Expose an api to produce and consume events.
+test_files: []