garaio_bunny 2.19.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6968f28e951ec5f7c22a54027c77e34ed1ed3cc0a192d8a349c3bd433f31765e
+  data.tar.gz: be7bdd9c7913c0055dfb4ebfda34fe494bcd8f18732afe105a6b5bc04979bc1a
+SHA512:
+  metadata.gz: 1cdd517b7aa747e75c847cdd65a58fbd4c80b7e3e113d856d96936795aa9eab53d246c5a2f6dae097ca4a40f5e650e7b826e88bf5abaccb239a3de0ee8cccf06
+  data.tar.gz: 0c9cfb087ea822402c4383ac1438afb5ea92d5031a065eb29ec3fd9c4082476d312ceb8b07abb3834e3b7e0bb3dc325b250c50e8e2584e99c0087d15cef4932b

data/README.md

@@ -0,0 +1,231 @@
+# Bunny, a Ruby RabbitMQ Client
+
+Bunny is a RabbitMQ client that focuses on ease of use. It
+is feature complete, supports all recent RabbitMQ features and does not
+have any heavyweight dependencies.
+
+
+## I Know What RabbitMQ and Bunny are, How Do I Get Started?
+
+[Right here](http://rubybunny.info/articles/getting_started.html)!
+
+
+## What is Bunny Good For?
+
+One can use Bunny to make Ruby applications interoperate with other
+applications (both built in Ruby and not). Complexity and size may vary from
+simple work queues to complex multi-stage data processing workflows that involve
+many applications built with all kinds of technologies.
+
+Specific examples:
+
+ * Events collectors, metrics & analytics applications can aggregate events produced by various applications
+   (Web and not) in the company network.
+
+ * A Web application may route messages to a Java app that works
+   with SMS delivery gateways.
+
+ * MMO games can use flexible routing RabbitMQ provides to propagate event notifications to players and locations.
+
+ * Price updates from public markets or other sources can be distributed between interested parties, from trading systems to points of sale in a specific geographic region.
+
+ * Content aggregators may update full-text search and geospatial search indexes
+   by delegating actual indexing work to other applications over RabbitMQ.
+
+ * Companies may provide streaming/push APIs to their customers, partners
+   or just general public.
+
+ * Continuous integration systems can distribute builds between multiple machines with various hardware and software
+   configurations using advanced routing features of RabbitMQ.
+
+ * An application that watches updates from a real-time stream (be it markets data
+   or Twitter stream) can propagate updates to interested parties, including
+   Web applications that display that information in the real time.
+
+
+## Supported Ruby Versions
+
+Modern Bunny versions support
+
+ * CRuby 2.5 through 3.0 (inclusive)
+
+Bunny works sufficiently well on JRuby but there are known
+JRuby bugs in versions prior to JRuby 9000 that cause high CPU burn. JRuby users should
+use [March Hare](http://rubymarchhare.info).
+
+Bunny `1.7.x` was the last version to support CRuby 1.9.3 and 1.8.7
+
+
+## Supported RabbitMQ Versions
+
+Modern Bunny releases target [currently supported RabbitMQ release series](https://www.rabbitmq.com/versions.html).
+
+
+## Change Log
+
+Bunny is a mature library (started in early 2009) with
+a stable public API.
+
+Change logs per release series:
+
+ * [master](https://github.com/ruby-amqp/bunny/blob/master/ChangeLog.md) (most notable changes for all release series)
+ * [2.19.x](https://github.com/ruby-amqp/bunny/blob/2.19.x-stable/ChangeLog.md)
+
+
+
+## Installation & Bundler Dependency
+
+### Most Recent Release
+
+[![Gem Version](https://badge.fury.io/rb/bunny.svg)](http://badge.fury.io/rb/bunny)
+
+### With Rubygems
+
+To install Bunny with RubyGems:
+
+```
+gem install bunny
+```
+
+### Bundler Dependency
+
+To use Bunny in a project managed with Bundler:
+
+``` ruby
+gem "bunny", ">= 2.19.0"
+```
+
+
+## Quick Start
+
+Below is a small snippet that demonstrates how to publish
+and synchronously consume ("pull API") messages with Bunny.
+
+For a 15 minute tutorial using more practical examples, see [Getting Started with RabbitMQ and Ruby using Bunny](http://rubybunny.info/articles/getting_started.html).
+
+``` ruby
+require "bunny"
+
+# Start a communication session with RabbitMQ
+conn = Bunny.new
+conn.start
+
+# open a channel
+ch = conn.create_channel
+ch.confirm_select
+
+# declare a queue
+q  = ch.queue("test1")
+q.subscribe(manual_ack: true) do |delivery_info, metadata, payload|
+  puts "This is the message: #{payload}"
+  # acknowledge the delivery so that RabbitMQ can mark it for deletion
+  ch.ack(delivery_info.delivery_tag)
+end
+
+# publish a message to the default exchange which then gets routed to this queue
+q.publish("Hello, everybody!")
+
+# await confirmations from RabbitMQ, see
+# https://www.rabbitmq.com/publishers.html#data-safety for details
+ch.wait_for_confirms
+
+# give the above consumer some time consume the delivery and print out the message
+sleep 1
+
+puts "Done"
+
+ch.close
+# close the connection
+conn.close
+```
+
+
+## Documentation
+
+### Getting Started
+
+For a 15 minute tutorial using more practical examples, see [Getting Started with RabbitMQ and Ruby using Bunny](http://rubybunny.info/articles/getting_started.html).
+
+### Guides
+
+Bunny documentation guides are available at [rubybunny.info](http://rubybunny.info):
+
+ * [Queues and Consumers](http://rubybunny.info/articles/queues.html)
+ * [Exchanges and Publishers](http://rubybunny.info/articles/exchanges.html)
+ * [AMQP 0.9.1 Model Explained](http://www.rabbitmq.com/tutorials/amqp-concepts.html)
+ * [Connecting to RabbitMQ](http://rubybunny.info/articles/connecting.html)
+ * [Error Handling and Recovery](http://rubybunny.info/articles/error_handling.html)
+ * [TLS/SSL Support](http://rubybunny.info/articles/tls.html)
+ * [Bindings](http://rubybunny.info/articles/bindings.html)
+ * [Using RabbitMQ Extensions with Bunny](http://rubybunny.info/articles/extensions.html)
+ * [Durability and Related Matters](http://rubybunny.info/articles/durability.html)
+
+Some highly relevant RabbitMQ documentation guides:
+
+ * [Connections](https://www.rabbitmq.com/connections.html)
+ * [Channels](https://www.rabbitmq.com/channels.html)
+ * [Queues](https://www.rabbitmq.com/queues.html)
+ * [Publishers](https://www.rabbitmq.com/publishers.html)
+ * [Consumers](https://www.rabbitmq.com/consumers.html)
+ * Data safety: publisher and consumer [Confirmations](https://www.rabbitmq.com/confirms.html)
+ * [Production Checklist](https://www.rabbitmq.com/production-checklist.html)
+
+### API Reference
+
+[Bunny API Reference](http://reference.rubybunny.info/).
+
+
+## Community and Getting Help
+
+### Mailing List
+
+[Bunny has a mailing list](http://groups.google.com/group/ruby-amqp). Please use it for all questions,
+investigations, and discussions. GitHub issues should be used for specific, well understood, actionable
+maintainers and contributors can work on.
+
+We encourage you to also join the [RabbitMQ mailing list](https://groups.google.com/forum/#!forum/rabbitmq-users)
+mailing list. Feel free to ask any questions that you may have.
+
+
+## Continuous Integration
+
+[![Build Status](https://travis-ci.org/ruby-amqp/bunny.svg)](https://travis-ci.org/ruby-amqp/bunny/)
+
+
+### News & Announcements on Twitter
+
+To subscribe for announcements of releases, important changes and so on, please follow [@rubyamqp](https://twitter.com/#!/rubyamqp) on Twitter.
+
+More detailed announcements can be found in the [RabbitMQ Ruby clients blog](http://blog.rubyrabbitmq.info).
+
+
+### Reporting Issues
+
+If you find a bug you understand well, poor default, incorrect or unclear piece of documentation,
+or missing feature, please [file an
+issue](http://github.com/ruby-amqp/bunny/issues) on GitHub.
+
+Please use [Bunny's mailing list](http://groups.google.com/group/ruby-amqp) for questions,
+investigations, and discussions. GitHub issues should be used for specific, well understood, actionable
+maintainers and contributors can work on.
+
+When filing an issue, please specify which Bunny and RabbitMQ versions you
+are using, provide recent RabbitMQ log file contents, full exception stack traces,
+and steps to reproduce (or failing test cases).
+
+
+## Other Ruby RabbitMQ Clients
+
+The other widely used Ruby RabbitMQ client is [March Hare](http://rubymarchhare.info) (JRuby-only).
+It's a mature library that require RabbitMQ 3.3.x or later.
+
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for more information
+about running various test suites.
+
+
+## License
+
+Released under the MIT license.

data/lib/amq/protocol/extensions.rb

@@ -0,0 +1,16 @@
+# @private
+module AMQ
+  # @private
+  module Protocol
+    # @private
+    class Basic
+      # Extended to allow wrapping delivery tag into
+      # a versioned one.
+      #
+      # @private
+      class GetOk
+        attr_writer :delivery_tag
+      end
+    end
+  end
+end

data/lib/bunny/authentication/credentials_encoder.rb

@@ -0,0 +1,55 @@
+module Bunny
+  # Contains credentials encoding implementations for various
+  # authentication strategies.
+  module Authentication
+    # Base credentials encoder. Subclasses implement credentials encoding for
+    # a particular authentication mechanism (PLAIN, EXTERNAL, etc).
+    #
+    # @api plugin
+    class CredentialsEncoder
+
+      #
+      # API
+      #
+
+      # Session that uses this encoder
+      # @return [Bunny::Session]
+      attr_reader :session
+
+      # Instantiates a new encoder for the authentication mechanism
+      # used by the provided session.
+      #
+      # @return [Bunny::CredentialsEncoder]
+      def self.for_session(session)
+        registry[session.mechanism].new(session)
+      end
+
+      # @private
+      def self.registry
+        @@registry ||= Hash.new { raise NotImplementedError }
+      end
+
+      # Registers an encoder for authentication mechanism
+      # @api plugin
+      def self.auth_mechanism(*mechanisms)
+        mechanisms.each do |m|
+          registry[m] = self
+        end
+      end
+
+      # Encodes provided credentials according to the specific authentication
+      # mechanism
+      # @return [String] Encoded credentials
+      def encode_credentials(username, challenge)
+        raise NotImplementedError.new("Subclasses must override this method")
+      end
+
+      protected
+
+      def initialize(session)
+        @session = session
+      end
+
+    end
+  end
+end

data/lib/bunny/authentication/external_mechanism_encoder.rb

@@ -0,0 +1,27 @@
+require "bunny/authentication/credentials_encoder"
+
+module Bunny
+  module Authentication
+    # Encodes credentials using the EXTERNAL mechanism
+    class ExternalMechanismEncoder < CredentialsEncoder
+
+      auth_mechanism "EXTERNAL", "external"
+
+      # Encodes a username and password for the EXTERNAL mechanism. Since
+      # authentication is handled by an encapsulating protocol like SSL or
+      # UNIX domain sockets, EXTERNAL doesn't pass along any username or
+      # password information at all and this method always returns the
+      # empty string.
+      #
+      # @param [String] username The username to encode. This parameter is
+      #   ignored.
+      # @param [String] password The password to encode. This parameter is
+      #   ignored.
+      # @return [String] The username and password, encoded for the
+      #   EXTERNAL mechanism. This is always the empty string.
+      def encode_credentials(username, password)
+        ""
+      end
+    end
+  end
+end

data/lib/bunny/authentication/plain_mechanism_encoder.rb

@@ -0,0 +1,19 @@
+require "bunny/authentication/credentials_encoder"
+
+module Bunny
+  module Authentication
+    # Encodes credentials using the PLAIN mechanism
+    class PlainMechanismEncoder < CredentialsEncoder
+
+      auth_mechanism "PLAIN", "plain"
+
+      # Encodes provided credentials as described in RFC 2595
+      # @api public
+      # @see http://tools.ietf.org/rfc/rfc2595.txt RFC 2595
+      def encode_credentials(username, password)
+        "\0#{username}\0#{password}"
+      end
+
+    end
+  end
+end