klunk 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6414ef36d0b3146def7a1217ceae1134f0e02fbe
+  data.tar.gz: 08c4f0c806ebbb3be0ef62bd30966f8b86fa6883
+SHA512:
+  metadata.gz: 225e0c1d2fc3233f3a63fe31b4f5f4cd2ac0cf44725b0f15914eb416dec171e993297ee65daf01061c8c75c932a40b0f6628cbde6cf06327c8a634cd624fd763
+  data.tar.gz: 2bec47db4358322c5139f826a1b9f439b1179e4c61d0cd30eba0654779aff2c42f39d7a90054927733048032bc2a4041b233132ef1e39f0b74f262b7f8da80ee

data/.gitignore

@@ -0,0 +1,34 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+.env
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+.ruby-version
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,11 @@
+AllCops:
+  TargetRubyVersion: 2.3
+
+Metrics/LineLength:
+  Max: 80
+
+Style/Documentation:
+  Enabled: false
+
+Style/FrozenStringLiteralComment:
+  Enabled: false

data/Gemfile

@@ -0,0 +1,8 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in klunk.gemspec
+gemspec
+
+group :development, :test do
+  gem 'rubocop', require: nil
+end

data/README.md

@@ -0,0 +1,162 @@
+# Klunk
+
+## Goal
+
+Create and setup __publishers__ (topics) and __subscribers__ (queues) for Rails applications.
+
+## About
+
+"Stop the pigeon! Stop the pigeon!"
+
+Dick Dastardly and Muttley, the villains from Wacky Races, are now flying aces and members of the Vulture Squadron, a crew of aviators on a mission to stop a homing pigeon named _Yankee Doodle Pigeon_ from delivering _messages_ to the other side. Each story features variations on the same plot elements: the Vulture Squadron tries to trap _Yankee Doodle Pigeon_ using one or more planes equipped with __Klunk__'s latest contraptions, but one or more of the Squadron messes up and the planes either crash, collide or explode (or all of the above).
+
+![The Vulture Squadron](vulture_squadron.jpg "The Vulture Squadron")
+
+## Publish-Subscribe Messaging Pattern
+
+In software architecture, __publish–subscribe__ is a messaging pattern where senders of messages, called _publishers_, do not program the messages to be sent directly to specific receivers, called _subscribers_, but instead characterize published messages into classes without knowledge of which _subscribers_, if any, there may be. Similarly, _subscribers_ express interest in one or more classes and only receive messages that are of interest, without knowledge of which _publishers_, if any, there are.
+
+__Publish–Subscribe__ is a sibling of the message queue paradigm, and is typically one part of a larger message-oriented middleware system. This pattern provides greater network scalability and a more dynamic network topology, with a resulting decreased flexibility to modify the publisher and the structure of the published data. In other words, __publish-subscribe__ is a pattern used to communicate messages between different system components without these components knowing anything about each other’s identity.
+
+This design pattern is not new, but it’s not commonly used by Rails developers. But it can bring major advantages for a Rails application.
+
+### Advantages
+
+* __Reduce model/controller bloat__
+
+ It can help decomposing fat models or controllers.
+
+* __Fewer callbacks__
+
+ Enable models to work independently with minimum knowledge about each other, ensuring loose coupling. Expanding the behavior to additional actions is just a matter of hooking to the desired event.
+
+* __Single Responsibility Principle (SRP)__
+
+ _Models_ should handle persistence, associations and not much else.
+ _Controllers_ should handle user requests and be a wrapper around the business logic (Service Objects).
+ Service Objects should encapsulate one of the responsibilities of the business logic, provide an entry point for external services, or act as an alternative to model concerns.
+ Thanks to its power to reduce coupling, the __publish-subscribe__ design pattern can be combined with single responsibility service objects (SRSOs) to help encapsulate the business logic, and forbid the business logic from creeping into either the models or the controllers. This keeps the code base clean, readable, maintainable and scalable.
+
+* __Testing__
+
+ By decomposing the fat models and controllers, and having a lot of SRSOs, testing of the code base becomes a much, much easier process. This is particularly the case when it comes to integration testing and inter-module communication. Testing should simply ensure that events are published and received correctly.
+
+### Disadvantages
+
+* _Loose coupling_
+
+ The greatest of the __publish-subscribe__ pattern’s strength may be also it’s greatest weakness. The structure of the data published (the event payload) must be well defined, and quickly becomes rather inflexible. In order to modify data structure of the published payload, it is necessary to know about all the _subscribers_, and either modify them also, or ensure the modifications are compatible with older versions. This makes refactoring of _publisher_ code much more difficult.
+ If you want to avoid this you have to be extra cautious when defining the payload of the _publishers_. Of course, if you have a great test suite, that tests the payload as well as mentioned previously, you don’t have to worry much about the system going down after you change the _publisher_’s payload or event name.
+
+* _Messaging Bus stability_
+
+ _Publishers_ have no knowledge of the status of the _subscriber_ and vice versa. Using simple __publish-subscribe__ tools, it might not be possible to ensure the stability of the messaging bus itself, and to ensure that all the published messages are correctly queued and delivered.
+
+* _Visibility_
+
+ Eventually, messages can cause receiver processes (workers) to crash. Specify maximum retry limits and message hospital (dead letter queues), where messages got sent if they failed. And, in order to avoid a catastrophic failover, having an UI to monitor those messages and retry them if needed is strongly encouraged.
+
+* _Infinite event loops_
+
+ When the system is completely driven by events, you should be extra cautious not to have event loops. These loops are just like the infinite loops that can happen in code. However, they are harder to detect ahead of time, and they can bring your system to a standstill. They can exist without your notice when there are many events published and subscribed across the system.
+
+* __Setup__
+
+ When you split the monolith and move towards fine grained systems, the setup and deployment of _publishers_ and _subscribers_ can be painful and error prone. This is why we created __Klunk__.
+
+## Installation
+
+Add it to your `Gemfile`:
+
+```ruby
+gem 'klunk'
+```
+
+Run the following command to install it:
+
+```console
+bundle install
+```
+
+Run the generator:
+
+```console
+rails generate klunk:install
+```
+
+## Configuration
+
+### Common
+
+ Check your `config/initializers/klunk.rb` file for basic and default values.
+
+ - `prefix`: organize names by using a prefix, usually the system name. Defaults to current Rails application name.
+ - `deadletter_suffix`: suffix for dead letter queue names. Default value is `failures`.
+ - `retries_limit`: the number of times that a message can be received before being sent to a dead letter queue. Must be between 1 and 1000. Default is 8.
+ - `message_retention_period`: The number of seconds for which the queue should retain a message. An integer representing seconds, from 60 (1 minute) to 1209600 (14 days). The default is 345600 (4 days).
+ - `deadletter_message_retention_period`: Same as above, for the corresponding dead letter queue. It's a good practice to keep the failed messages as long as you can to be able to retry them, so the default value is 14 days.
+
+#### Notes
+
+  - Queue names and queue URLs are case-sensitive
+
+### Queues
+
+  Use the file `config/queues.yml` to define your application queues.
+
+  - `name`: the queue name is mandatory. This value will be used together with the application and environment names to build the final queue name. Example: `klunk_development_queue` and `klunk_development_queue_failures`.
+  - `retries_limit`: optional, if set, this value will override the default maximum retries.
+  - `subscribes`: the topics this queue subscribes to (optional).
+    - `name`: the topic name (required). The topic name will be built like queue names (based on prefix and environment values unless `prefix`is set to false, as described below.
+    - `prefix`: boolean flag to decide if the topic name should  be built like the queues naming convention. If set to `false`, the full topic name must be provided. Optional, defaults to `true`.
+    - `system`: optional, used as prefix for external system name. Defaults to the current global `prefix` name.
+
+
+```yaml
+
+-
+  :name: queue_one
+-
+  :name: queue_two
+  :retries_limit: 3
+-
+  :name: queue_three
+  :subscribes:
+    -
+      :system: service_one
+      :name: topic_one
+    -
+      :system: service_one
+      :name: topic_two
+    -
+      :prefix: false
+      :name: full_topic_name
+
+```
+
+### Topics
+
+TODO: Explain how to setup - configuration files, values and so on...
+
+## Usage
+
+TODO: Write usage instructions here - explain the `Rake` tasks...
+
+## Disclaimer
+
+ So far, __Klunk__ only works with Amazon [SNS](https://aws.amazon.com/sns/) and [SQS](https://aws.amazon.com/sqs/) services. But you shouldn't be using anything else, right?! :wink:
+
+## Maintainers
+
+* Marco Antonio Gonzalez Junior (https://github.com/kayaman)
+* Wagner Vaz (https://github.com/0xdco)
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/kayaman/klunk.
+
+## License
+
+  __Klunk__ is an Open Source project licensed under the terms of
+the LGPLv3 license.  Please see [http://www.gnu.org/licenses/lgpl-3.0.html](http://www.gnu.org/licenses/lgpl-3.0.html)
+for license text.

data/Rakefile

@@ -0,0 +1,8 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+import './lib/tasks/klunk.rake'
+
+task default: :spec

data/klunk.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'klunk/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'klunk'
+  spec.version       = Klunk::VERSION
+  spec.authors       = ['Marco Antonio Gonzalez Junior', 'Wagner Vaz']
+  spec.email         = ['kayaman.baurets@gmail.com', 'wv@0xd.co']
+
+  spec.summary       =  'Enterprise Messaging System on Rails'
+  spec.description   =  'Enterprise Messaging System on Rails'
+  spec.homepage      = 'https://github.com/kayaman/klunk'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+
+  spec.require_paths = ['lib']
+
+  spec.add_runtime_dependency 'aws-sdk', '~> 2'
+  spec.add_runtime_dependency 'safe_yaml'
+  spec.add_runtime_dependency 'json'
+
+  spec.add_development_dependency 'bundler', '~> 1.13'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+end

data/lib/generators/klunk/USAGE

@@ -0,0 +1,4 @@
+To copy a Klunk initializer to your Rails app,
+with some default configuration values, just do:
+
+    rails generate klunk:install

data/lib/generators/klunk/install_generator.rb

@@ -0,0 +1,21 @@
+module Klunk
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      desc 'Creates Klunk initializer for your application'
+      source_root File.expand_path('../templates', __FILE__)
+
+      def copy_initializer
+        template 'config/initializers/klunk.rb'
+        puts 'Install complete! Check \'config/initializers/klunk.rb\'.'
+      end
+
+      def copy_topics_configuration_file
+        template 'config/topics.yml'
+      end
+
+      def copy_queues_configuration_file
+        template 'config/queues.yml'
+      end
+    end
+  end
+end

data/lib/generators/klunk/templates/config/initializers/klunk.rb

@@ -0,0 +1,17 @@
+Klunk.configure do |config|
+  # Organize names by using a prefix, usually the project name
+  config.prefix = Rails.application.class.parent_name.downcase if defined? Rails
+
+  # Message hospital: suffix for dead letter queue names
+  config.deadletter_suffix = 'failures'
+
+  # Message hospital: maximum retries limit
+  config.retries_limit = 8
+
+  # The number of seconds for which Amazon SQS retains a message. An integer
+  # representing seconds, from 60 (1 minute) to 120,9600 (14 days).
+  # The default is 345,600 (4 days).
+  config.message_retention_period = 345_600
+
+  config.deadletter_message_retention_period = 1_209_600
+end

data/lib/generators/klunk/templates/config/queues.yml

@@ -0,0 +1,19 @@
+# Define your Amazon SQS queues and subscriptions here
+
+# Examples:
+# -
+#   :name: queue_one
+#
+# -
+#   :name: queue_two
+#   :retries_limit: 3
+#
+# -
+#   :name: queue_three
+#   :retries_limit: 8
+#   :subscribes:
+#     -
+#       :name: topic_one
+#     -
+#       :system: some_other_system_name
+#       :name: topic_two

data/lib/generators/klunk/templates/config/topics.yml

@@ -0,0 +1,7 @@
+# Define your Amazon SNS topics here
+
+# Example:
+# -
+#  :name: event_one
+# -
+#  :name: event_two

data/lib/klunk/configuration.rb

@@ -0,0 +1,7 @@
+module Klunk
+  class Configuration
+    attr_accessor :prefix, :deadletter_suffix, :retries_limit,
+                  :message_retention_period,
+                  :deadletter_message_retention_period
+  end
+end

data/lib/klunk/queue.rb

@@ -0,0 +1,86 @@
+module Klunk
+  class Queue
+    QUEUES = YAML.load_file('config/queues.yml').map(&:deep_symbolize_keys)
+
+    class << self
+      def build(queue_options)
+        queue_name = queue_options.delete(:name)
+        subscriptions = queue_options.delete(:subscribes)
+        deadletter_queue = create_deadletter(queue_name)
+        deadletter_attributes = get_attributes(deadletter_queue[:queue_url])
+        attributes = build_attributes(queue_options)
+        attributes[:RedrivePolicy][:deadLetterTargetArn] =
+          deadletter_attributes['QueueArn']
+        attributes[:RedrivePolicy] = attributes[:RedrivePolicy].to_json
+        create(queue_name, attributes, subscriptions)
+      end
+
+      def create(queue_name, attributes, subscriptions)
+        begin
+          queue = client.create_queue(
+            queue_name: name_for(queue_name),
+            attributes: attributes
+            )
+        rescue Aws::SQS::Errors::QueueAlreadyExists
+          puts "#{queue_name} already exists.".green
+          queue = client.create_queue(queue_name: name_for(queue_name))
+        end
+        subscriptions.to_a.each do |subscription|
+          queue_arn = attributes['QueueArn']
+          topic_name = Topic.name_for(subscription[:name], subscription)
+          topic = Topic.create(topic_name)
+          ap Topic.subscribe(queue.queue_url, topic.topic_arn)
+        end
+        queue
+      end
+
+      def get_attributes(queue_url, attribute_names = ['All'])
+        attributes = client.get_queue_attributes(
+          queue_url: queue_url,
+          attribute_names: attribute_names
+        )
+        attributes[:attributes]
+      end
+
+      def name_for(queue_name, deadletter = false)
+        name = [Klunk.configuration.prefix, ENV['EB_ENV'], queue_name]
+        name << Klunk.configuration.deadletter_suffix if deadletter
+        name.compact.reject(&:blank?).join('_')
+      end
+
+      def create_deadletter(queue_name)
+        client.create_queue(
+          queue_name: name_for(queue_name, true),
+          attributes: {
+            MessageRetentionPeriod: deadletter_message_retention_period.to_s
+          }
+        )
+      end
+
+      def build_attributes(queue, attributes = {})
+        max_receive_count = queue[:retries_limit] ||
+                            Klunk.configuration.retries_limit
+        message_retention_period = queue[:message_retention_period] ||
+                                   Klunk.configuration.message_retention_period
+        {
+          MessageRetentionPeriod: message_retention_period.to_s,
+          RedrivePolicy: {
+            maxReceiveCount: max_receive_count
+          }.merge(attributes)
+        }
+      end
+
+      def client
+        @client ||= Aws::SQS::Client.new
+      end
+
+      def resource
+        Aws::SQS::Resource.new(client: client)
+      end
+
+      def deadletter_message_retention_period
+        Klunk.configuration.deadletter_message_retention_period
+      end
+    end
+  end
+end

data/lib/klunk/railtie.rb

@@ -0,0 +1,18 @@
+require 'rails/railtie'
+
+module Klunk
+  class Railtie < Rails::Railtie
+    config.eager_load_namespaces << Klunk
+
+    config.after_initialize do
+      unless Klunk.configured?
+        warn '[Klunk] Klunk is not configured and will use the default values.\
+               Use `rails generate klunk:install` and set it up.'
+      end
+    end
+
+    rake_tasks do
+      load "#{File.expand_path('../tasks', __FILE__)}/klunk.rake"
+    end
+  end
+end

data/lib/klunk/tasks/klunk.rake

@@ -0,0 +1,25 @@
+namespace :klunk do
+  namespace :sns do
+    desc 'Create SNS topics'
+    task create_topics: :environment do
+      Klunk::Topic::TOPICS.each do |topic|
+        puts Klunk::Topic.create(topic[:name])
+      end
+    end
+  end
+
+  namespace :sqs do
+    desc 'Create SQS queues if needed'
+    task create_sqs_queues_if_needed: :environment do
+      # TODO: help me
+    end
+
+    desc 'Create SQS queues'
+    task create_queues: :environment do
+      Klunk::Queue::QUEUES.each do |queue|
+        q = Klunk::Queue.build(queue)
+        puts "\n#{q[:queue_url]}"
+      end
+    end
+  end
+end

data/lib/klunk/topic.rb

@@ -0,0 +1,88 @@
+module Klunk
+  class Topic
+    TOPICS = YAML.load_file('config/topics.yml').map(&:deep_symbolize_keys)
+
+    class << self
+      def name_for(topic_name, options = {})
+        system_name = options[:system] || Klunk.configuration.prefix
+        [system_name, ENV['EB_ENV'], topic_name]
+          .compact.reject(&:blank?).join('_')
+      end
+
+      def create(topic_name)
+        topic = client.create_topic(name: topic_name)
+        puts "Topic: #{topic.topic_arn}".cyan
+        topic
+      end
+
+      def subscribe(queue_url, topic_arn, previous_policy = nil)
+        queue_attributes = Klunk::Queue.get_attributes(queue_url)
+        queue_arn = queue_attributes['QueueArn']
+        subscription = client.subscribe(
+          topic_arn: topic_arn,
+          protocol: 'sqs',
+          endpoint: queue_arn)
+        client.set_subscription_attributes(
+          subscription_arn: subscription.subscription_arn,
+          attribute_name: 'RawMessageDelivery',
+          attribute_value: 'true')
+        if queue_attributes.key?('Policy')
+          previous_policy = JSON.parse(queue_attributes['Policy'])
+        end
+        add_policy(queue_url, topic_arn, previous_policy)
+        topic_subscriptions = {
+          topic: "#{topic_arn}",
+          subscriptions: client.list_subscriptions_by_topic(
+            topic_arn: topic_arn
+          ).subscriptions.map {|topic| topic[:endpoint] }
+        }
+      end
+
+      def add_policy(queue_url, topic_arn, previous_policy)
+        previous_policy ||= build_policy(queue_url, topic_arn)
+        Queue.client.set_queue_attributes(
+          queue_url: queue_url,
+          attributes: {
+            Policy: previous_policy.tap do |p|
+              p['Statement'] ||= []
+              p['Statement'] << build_statement(queue_url, topic_arn)
+              p['Statement'].uniq!
+            end.to_json
+          }
+        )
+      end
+
+      def build_statement(queue_url, topic_arn)
+        queue_arn = Klunk::Queue.get_attributes(queue_url)['QueueArn']
+        queue_name = queue_arn.split(':').last
+        topic = client.get_topic_attributes(topic_arn: topic_arn)
+        topic_name = topic_arn.split(':').last
+        {
+          'Sid': "#{queue_name.camelize}_Send_#{topic_name.camelize}",
+          'Effect': 'Allow',
+          'Principal': { 'AWS': '*' },
+          'Action': 'SQS:SendMessage',
+          'Resource': queue_arn,
+          'Condition': {
+            'ArnEquals': { 'aws:SourceArn': topic_arn }
+          }
+        }
+      end
+
+      def build_policy(queue_url, topic_arn)
+        queue_arn = Klunk::Queue.get_attributes(queue_url)['QueueArn']
+        {
+          'Version':  '2012-10-17',
+          'Id': "#{queue_arn}/SQSDefaultPolicy",
+          'Statement': [
+            build_statement(queue_url, topic_arn)
+          ]
+        }
+      end
+
+      def client
+        @client ||= Aws::SNS::Client.new
+      end
+    end
+  end
+end

data/lib/klunk/version.rb

@@ -0,0 +1,3 @@
+module Klunk
+  VERSION = '0.1.0'.freeze
+end

data/lib/klunk.rb

@@ -0,0 +1,22 @@
+require 'klunk/version'
+require 'klunk/configuration'
+require 'klunk/queue'
+require 'klunk/topic'
+
+module Klunk
+  class << self
+    attr_accessor :configuration, :configured
+
+    def configure
+      self.configured = true
+      self.configuration ||= Configuration.new
+      yield(configuration)
+    end
+
+    def configured?
+      configured
+    end
+  end
+end
+
+require 'klunk/railtie' if defined?(Rails)

metadata

@@ -0,0 +1,149 @@
+--- !ruby/object:Gem::Specification
+name: klunk
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Marco Antonio Gonzalez Junior
+- Wagner Vaz
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-12-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: aws-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+- !ruby/object:Gem::Dependency
+  name: safe_yaml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Enterprise Messaging System on Rails
+email:
+- kayaman.baurets@gmail.com
+- wv@0xd.co
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- Gemfile
+- README.md
+- Rakefile
+- klunk.gemspec
+- lib/generators/klunk/USAGE
+- lib/generators/klunk/install_generator.rb
+- lib/generators/klunk/templates/config/initializers/klunk.rb
+- lib/generators/klunk/templates/config/queues.yml
+- lib/generators/klunk/templates/config/topics.yml
+- lib/klunk.rb
+- lib/klunk/configuration.rb
+- lib/klunk/queue.rb
+- lib/klunk/railtie.rb
+- lib/klunk/tasks/klunk.rake
+- lib/klunk/topic.rb
+- lib/klunk/version.rb
+- vulture_squadron.jpg
+homepage: https://github.com/kayaman/klunk
+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.6.8
+signing_key: 
+specification_version: 4
+summary: Enterprise Messaging System on Rails
+test_files: []