bunny 2.7.4 → 2.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 67acdd00ad8e7f36b89bcf6043cca832b5ee9ed8
-  data.tar.gz: 3fcc3fedbafc611804bf76f0be43e211f8292f75
+SHA256:
+  metadata.gz: 2edd88411f92dbdbb1d06b334006e446d5b3e3fb165f3baae3745bd066cf9651
+  data.tar.gz: 437032f606bb6f77fee02e65706e615f8a52c0e05467bbe257f1796fcedd624c
 SHA512:
-  metadata.gz: f730e0dd7c1777043f3fa31b3316df10bb7d12f880d4d0d48cff481d8ab199f667f5399a4de7a059b61a3ad520739448d12ca7f8eca87b90f6bef897f4ca2add
-  data.tar.gz: eeff99bc77bb6b95c0c4f84704c699166fd1ca0c29a21c78dde60ca545042f85cf7f5115c58fbc8575f614063ccccd10239ef9bd42a9bb43343e101470679c8d
+  metadata.gz: 698398dc76ca4e3dd11e3c5dc6b078998f23895bd3d975b01e1329c08c8ff0835cb9691d0108f0f6e13aaa769b870b258ff5e1de1958321be4804ca99b30a0be
+  data.tar.gz: 2a1fdcc61d683a991d07f601a986c5bc04d40cdd7155a1833dc7dba46be014c23d36612c505531b2f2adfe08ed057d6a493cbf5df368318205ffaf88659a88fb

data/README.md

@@ -7,7 +7,7 @@ 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)!
+[Right here](https://www.rabbitmq.com/getstarted.html)!
 
 
 ## What is Bunny Good For?
@@ -43,12 +43,17 @@ Specific examples:
    Web applications that display that information in the real time.
 
 
-
 ## Supported Ruby Versions
 
 Modern Bunny versions support
 
- * CRuby 2.0 through 2.4
+ * CRuby 2.6 through 3.1 (inclusive)
+ * [TruffleRuby](https://www.graalvm.org/ruby/)
+
+For environments that use TLS, Bunny expects Ruby installations to use a recent enough OpenSSL version that
+**includes support for TLS 1.3**.
+
+### JRuby
 
 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
@@ -59,15 +64,20 @@ Bunny `1.7.x` was the last version to support CRuby 1.9.3 and 1.8.7
 
 ## Supported RabbitMQ Versions
 
-Bunny `1.5.0` and later versions only support RabbitMQ `3.3+`.
-Bunny `1.4.x` and earlier supports RabbitMQ 2.x and 3.x.
+Modern Bunny releases target [currently supported RabbitMQ release series](https://www.rabbitmq.com/versions.html).
 
 
-## Project Maturity
+## Change Log
 
 Bunny is a mature library (started in early 2009) with
 a stable public API.
 
+Change logs per release series:
+
+ * [main](https://github.com/ruby-amqp/bunny/blob/main/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
 
@@ -75,20 +85,20 @@ a stable public API.
 
 [![Gem Version](https://badge.fury.io/rb/bunny.svg)](http://badge.fury.io/rb/bunny)
 
-### With Rubygems
+### Bundler Dependency
 
-To install Bunny with RubyGems:
+To use Bunny in a project managed with Bundler:
 
-```
-gem install bunny
+``` ruby
+gem "bunny", ">= 2.19.0"
 ```
 
-### Bundler Dependency
+### With Rubygems
 
-To use Bunny in a project managed with Bundler:
+To install Bunny with RubyGems:
 
-``` ruby
-gem "bunny", ">= 2.7.2"
+```
+gem install bunny
 ```
 
 
@@ -97,7 +107,7 @@ gem "bunny", ">= 2.7.2"
 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).
+For a 15 minute tutorial using more practical examples, see [Getting Started with RabbitMQ and Ruby using Bunny](https://www.rabbitmq.com/tutorials/tutorial-one-ruby.html).
 
 ``` ruby
 require "bunny"
@@ -108,20 +118,31 @@ 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!")
 
-# fetch a message from the queue
-delivery_info, metadata, payload = q.pop
+# 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 "This is the message: #{payload}"
+puts "Done"
 
+ch.close
 # close the connection
-conn.stop
+conn.close
 ```
 
 
@@ -133,17 +154,29 @@ For a 15 minute tutorial using more practical examples, see [Getting Started wit
 
 ### Guides
 
-Other documentation guides are available at [rubybunny.info](http://rubybunny.info):
+Bunny documentation guides are [under `docs/guides` in this repository](https://github.com/ruby-amqp/bunny/tree/main/docs/guides):
 
- * [Queues and Consumers](http://rubybunny.info/articles/queues.html)
- * [Exchanges and Publishers](http://rubybunny.info/articles/exchanges.html)
+ * [Queues and Consumers](https://github.com/ruby-amqp/bunny/tree/main/docs/guides/queues.md)
+ * [Exchanges and Publishers](https://github.com/ruby-amqp/bunny/tree/main/docs/guides/exchanges.md)
  * [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)
+ * [Connecting to RabbitMQ](https://github.com/ruby-amqp/bunny/tree/main/docs/guides/connecting.md)
+ * [Error Handling and Recovery](https://github.com/ruby-amqp/bunny/tree/main/docs/guides/error_handling.md)
+ * [TLS/SSL Support](https://github.com/ruby-amqp/bunny/tree/main/docs/guides/tls.md)
+ * [Bindings](https://github.com/ruby-amqp/bunny/tree/main/docs/guides/bindings.md)
+ * [Using RabbitMQ Extensions with Bunny](https://github.com/ruby-amqp/bunny/tree/main/docs/guides/extensions.md)
+ * [Durability and Related Matters](https://github.com/ruby-amqp/bunny/tree/main/docs/guides/durability.md)
+
+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)
+ * [Quorum queues](https://www.rabbitmq.com/quorum-queues.html)
+ * [Streams](https://rabbitmq.com/streams.html) (Bunny can perform basic operations on streams even though it does not implement the [RabbitMQ Stream protocol](https://github.com/rabbitmq/rabbitmq-server/blob/v3.10.x/deps/rabbitmq_stream/docs/PROTOCOL.adoc))
+ * [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
 
@@ -167,13 +200,6 @@ mailing list. Feel free to ask any questions that you may have.
 [![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,