bunny 1.0.7 → 2.24.0

data/lib/bunny.rb

@@ -1,4 +1,5 @@
 # -*- encoding: utf-8; mode: ruby -*-
+# frozen_string_literal: true
 
 require "timeout"
 
@@ -10,14 +11,14 @@ require "bunny/framing"
 require "bunny/exceptions"
 
 require "bunny/socket"
-
+require "bunny/timestamp"
 require "bunny/timeout"
 
 begin
   require "openssl"
 
   require "bunny/ssl_socket"
-rescue LoadError => e
+rescue LoadError
   # no-op
 end
 
@@ -50,29 +51,74 @@ module Bunny
     AMQ::Protocol::PROTOCOL_VERSION
   end
 
-  # Instantiates a new connection. The actual connection network
+  # Instantiates a new connection. The actual network
   # connection is started with {Bunny::Session#start}
   #
+  # @param [String, Hash] connection_string_or_opts Connection string or a hash of connection options
+  # @param [Hash] optz Extra options not related to connection
+  #
+  # @option connection_string_or_opts [String] :host ("127.0.0.1") Hostname or IP address to connect to
+  # @option connection_string_or_opts [Array<String>] :hosts (["127.0.0.1"]) list of hostname or IP addresses to select hostname from when connecting
+  # @option connection_string_or_opts [Array<String>] :addresses (["127.0.0.1:5672"]) list of addresses to select hostname and port from when connecting
+  # @option connection_string_or_opts [Integer] :port (5672) Port RabbitMQ listens on
+  # @option connection_string_or_opts [String] :username ("guest") Username
+  # @option connection_string_or_opts [String] :password ("guest") Password
+  # @option connection_string_or_opts [String] :vhost ("/") Virtual host to use
+  # @option connection_string_or_opts [Integer, Symbol] :heartbeat (:server) Heartbeat timeout to offer to the server. :server means use the value suggested by RabbitMQ. 0 means heartbeats and socket read timeouts will be disabled (not recommended).
+  # @option connection_string_or_opts [Integer] :network_recovery_interval (4) Recovery interval periodic network recovery will use. This includes initial pause after network failure.
+  # @option connection_string_or_opts [Boolean] :tls (false) Should TLS/SSL be used?
+  # @option connection_string_or_opts [String] :tls_cert (nil) Path to client TLS/SSL certificate file (.pem)
+  # @option connection_string_or_opts [String] :tls_key (nil) Path to client TLS/SSL private key file (.pem)
+  # @option connection_string_or_opts [Array<String>] :tls_ca_certificates Array of paths to TLS/SSL CA files (.pem), by default detected from OpenSSL configuration
+  # @option connection_string_or_opts [String] :verify_peer (true) Whether TLS peer verification should be performed
+  # @option connection_string_or_opts [Symbol] :tls_protocol (negotiated) What TLS version should be used (:TLSv1, :TLSv1_1, or :TLSv1_2)
+  # @option connection_string_or_opts [Integer] :channel_max (2047) Maximum number of channels allowed on this connection, minus 1 to account for the special channel 0.
+  # @option connection_string_or_opts [Integer] :continuation_timeout (15000) Timeout for client operations that expect a response (e.g. {Bunny::Queue#get}), in milliseconds.
+  # @option connection_string_or_opts [Integer] :connection_timeout (30) Timeout in seconds for connecting to the server.
+  # @option connection_string_or_opts [Integer] :read_timeout (30) TCP socket read timeout in seconds. If heartbeats are disabled this will be ignored.
+  # @option connection_string_or_opts [Integer] :write_timeout (30) TCP socket write timeout in seconds.
+  # @option connection_string_or_opts [Proc] :hosts_shuffle_strategy a callable that reorders a list of host strings, defaults to Array#shuffle
+  # @option connection_string_or_opts [Proc] :recovery_completed a callable that will be called when a network recovery is performed
+  # @option connection_string_or_opts [Logger] :logger The logger.  If missing, one is created using :log_file and :log_level.
+  # @option connection_string_or_opts [IO, String] :log_file The file or path to use when creating a logger.  Defaults to STDOUT.
+  # @option connection_string_or_opts [IO, String] :logfile DEPRECATED: use :log_file instead.  The file or path to use when creating a logger.  Defaults to STDOUT.
+  # @option connection_string_or_opts [Integer] :log_level The log level to use when creating a logger.  Defaults to LOGGER::WARN
+  # @option connection_string_or_opts [Boolean] :automatically_recover (true) Should automatically recover from network failures?
+  # @option connection_string_or_opts [Integer] :recovery_attempts (nil) Max number of recovery attempts, nil means forever
+  # @option connection_string_or_opts [Integer] :reset_recovery_attempts_after_reconnection (true) Should recovery attempt counter be reset after successful reconnection? When set to false, the attempt counter will last through the entire lifetime of the connection object.
+  # @option connection_string_or_opts [Proc] :recovery_attempt_started (nil) Will be called before every connection recovery attempt
+  # @option connection_string_or_opts [Proc] :recovery_completed (nil) Will be called after successful connection recovery
+  # @option connection_string_or_opts [Boolean] :recover_from_connection_close (true) Should this connection recover after receiving a server-sent connection.close (e.g. connection was force closed)?
+  # @option connection_string_or_opts [Object] :session_error_handler (Thread.current) Object which responds to #raise that will act as a session error handler. Defaults to Thread.current, which will raise asynchronous exceptions in the thread that created the session.
+  #
+  # @option optz [String] :auth_mechanism ("PLAIN") Authentication mechanism, PLAIN or EXTERNAL
+  # @option optz [String] :locale ("PLAIN") Locale RabbitMQ should use
+  # @option optz [String] :connection_name (nil) Client-provided connection name, if any. Note that the value returned does not uniquely identify a connection and cannot be used as a connection identifier in HTTP API requests.
+  #
   # @return [Bunny::Session]
   # @see Bunny::Session#start
   # @see http://rubybunny.info/articles/getting_started.html
   # @see http://rubybunny.info/articles/connecting.html
   # @api public
-  def self.new(connection_string_or_opts = {}, opts = {}, &block)
-    if connection_string_or_opts.respond_to?(:keys) && opts.empty?
-      opts = connection_string_or_opts
+  def self.new(connection_string_or_opts = ENV['RABBITMQ_URL'], optz = {})
+    if connection_string_or_opts.respond_to?(:keys) && optz.empty?
+      optz = connection_string_or_opts
     end
 
-    conn = Session.new(connection_string_or_opts, opts)
+    conn = Session.new(connection_string_or_opts, optz)
     @default_connection ||= conn
 
     conn
   end
 
 
-  def self.run(connection_string_or_opts = {}, opts = {}, &block)
+  def self.run(connection_string_or_opts = ENV['RABBITMQ_URL'], opts = {}, &block)
     raise ArgumentError, 'Bunny#run requires a block' unless block
 
+    if connection_string_or_opts.respond_to?(:keys) && opts.empty?
+      opts = connection_string_or_opts
+    end
+
     client = Session.new(connection_string_or_opts, opts)
 
     begin

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bunny
 version: !ruby/object:Gem::Version
-  version: 1.0.7
+  version: 2.24.0
 platform: ruby
 authors:
 - Chris Duncan
@@ -9,91 +9,54 @@ authors:
 - Jakub Stastny aka botanicus
 - Michael S. Klishin
 - Stefan Kaes
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-12-23 00:00:00.000000000 Z
+date: 2025-03-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: amq-protocol
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.9.2
+        version: '2.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.9.2
-description: Easy to use, feature complete Ruby client for RabbitMQ 2.0 and later
+        version: '2.3'
+- !ruby/object:Gem::Dependency
+  name: sorted_set
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.2
+description: Easy to use, feature complete Ruby client for RabbitMQ 3.9 and later
   versions.
 email:
-- celldee@gmail.com
-- eric@5stops.com
-- stastny@101ideas.cz
-- michael@novemberain.com
-- skaes@railsexpress.de
+- michael.s.klishin@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
 - README.md
 files:
-- .gitignore
-- .rspec
-- .ruby-version
-- .travis.yml
-- .yardopts
-- ChangeLog.md
-- Gemfile
-- LICENSE
 - README.md
-- benchmarks/basic_publish/with_128K_messages.rb
-- benchmarks/basic_publish/with_1k_messages.rb
-- benchmarks/basic_publish/with_4K_messages.rb
-- benchmarks/basic_publish/with_64K_messages.rb
-- benchmarks/channel_open.rb
-- benchmarks/mutex_and_monitor.rb
-- benchmarks/queue_declare.rb
-- benchmarks/queue_declare_and_bind.rb
-- benchmarks/queue_declare_bind_and_delete.rb
-- benchmarks/synchronized_sorted_set.rb
-- benchmarks/write_vs_write_nonblock.rb
-- bin/ci/before_build.sh
-- bunny.gemspec
-- examples/connection/authentication_failure.rb
-- examples/connection/automatic_recovery_with_basic_get.rb
-- examples/connection/automatic_recovery_with_client_named_queues.rb
-- examples/connection/automatic_recovery_with_multiple_consumers.rb
-- examples/connection/automatic_recovery_with_server_named_queues.rb
-- examples/connection/channel_level_exception.rb
-- examples/connection/disabled_automatic_recovery.rb
-- examples/connection/heartbeat.rb
-- examples/connection/manually_reconnecting_consumer.rb
-- examples/connection/manually_reconnecting_publisher.rb
-- examples/connection/unknown_host.rb
-- examples/guides/exchanges/direct_exchange_routing.rb
-- examples/guides/exchanges/fanout_exchange_routing.rb
-- examples/guides/exchanges/headers_exchange_routing.rb
-- examples/guides/exchanges/mandatory_messages.rb
-- examples/guides/extensions/alternate_exchange.rb
-- examples/guides/extensions/basic_nack.rb
-- examples/guides/extensions/connection_blocked.rb
-- examples/guides/extensions/consumer_cancellation_notification.rb
-- examples/guides/extensions/dead_letter_exchange.rb
-- examples/guides/extensions/exchange_to_exchange_bindings.rb
-- examples/guides/extensions/per_message_ttl.rb
-- examples/guides/extensions/per_queue_message_ttl.rb
-- examples/guides/extensions/publisher_confirms.rb
-- examples/guides/extensions/queue_lease.rb
-- examples/guides/extensions/sender_selected_distribution.rb
-- examples/guides/getting_started/blabbr.rb
-- examples/guides/getting_started/hello_world.rb
-- examples/guides/getting_started/weathr.rb
-- examples/guides/queues/one_off_consumer.rb
-- examples/guides/queues/redeliveries.rb
 - lib/amq/protocol/extensions.rb
 - lib/bunny.rb
 - lib/bunny/authentication/credentials_encoder.rb
@@ -101,11 +64,9 @@ files:
 - lib/bunny/authentication/plain_mechanism_encoder.rb
 - lib/bunny/channel.rb
 - lib/bunny/channel_id_allocator.rb
-- lib/bunny/compatibility.rb
 - lib/bunny/concurrent/atomic_fixnum.rb
 - lib/bunny/concurrent/condition.rb
 - lib/bunny/concurrent/continuation_queue.rb
-- lib/bunny/concurrent/linked_continuation_queue.rb
 - lib/bunny/concurrent/synchronized_sorted_set.rb
 - lib/bunny/consumer.rb
 - lib/bunny/consumer_tag_generator.rb
@@ -116,9 +77,8 @@ files:
 - lib/bunny/exceptions.rb
 - lib/bunny/exchange.rb
 - lib/bunny/framing.rb
+- lib/bunny/get_response.rb
 - lib/bunny/heartbeat_sender.rb
-- lib/bunny/jruby/socket.rb
-- lib/bunny/jruby/ssl_socket.rb
 - lib/bunny/message_properties.rb
 - lib/bunny/queue.rb
 - lib/bunny/reader_loop.rb
@@ -126,179 +86,33 @@ files:
 - lib/bunny/session.rb
 - lib/bunny/socket.rb
 - lib/bunny/ssl_socket.rb
-- lib/bunny/system_timer.rb
 - lib/bunny/test_kit.rb
 - lib/bunny/timeout.rb
+- lib/bunny/timestamp.rb
 - lib/bunny/transport.rb
 - lib/bunny/version.rb
 - lib/bunny/versioned_delivery_tag.rb
-- profiling/basic_publish/with_4K_messages.rb
-- repl
-- spec/compatibility/queue_declare_spec.rb
-- spec/compatibility/queue_declare_with_default_channel_spec.rb
-- spec/higher_level_api/integration/basic_ack_spec.rb
-- spec/higher_level_api/integration/basic_cancel_spec.rb
-- spec/higher_level_api/integration/basic_consume_spec.rb
-- spec/higher_level_api/integration/basic_consume_with_objects_spec.rb
-- spec/higher_level_api/integration/basic_get_spec.rb
-- spec/higher_level_api/integration/basic_nack_spec.rb
-- spec/higher_level_api/integration/basic_publish_spec.rb
-- spec/higher_level_api/integration/basic_qos_spec.rb
-- spec/higher_level_api/integration/basic_recover_spec.rb
-- spec/higher_level_api/integration/basic_reject_spec.rb
-- spec/higher_level_api/integration/basic_return_spec.rb
-- spec/higher_level_api/integration/channel_close_spec.rb
-- spec/higher_level_api/integration/channel_flow_spec.rb
-- spec/higher_level_api/integration/channel_open_spec.rb
-- spec/higher_level_api/integration/confirm_select_spec.rb
-- spec/higher_level_api/integration/connection_spec.rb
-- spec/higher_level_api/integration/connection_stop_spec.rb
-- spec/higher_level_api/integration/consistent_hash_exchange_spec.rb
-- spec/higher_level_api/integration/consumer_cancellation_notification_spec.rb
-- spec/higher_level_api/integration/dead_lettering_spec.rb
-- spec/higher_level_api/integration/exchange_bind_spec.rb
-- spec/higher_level_api/integration/exchange_declare_spec.rb
-- spec/higher_level_api/integration/exchange_delete_spec.rb
-- spec/higher_level_api/integration/exchange_unbind_spec.rb
-- spec/higher_level_api/integration/exclusive_queue_spec.rb
-- spec/higher_level_api/integration/heartbeat_spec.rb
-- spec/higher_level_api/integration/merry_go_round_spec.rb
-- spec/higher_level_api/integration/message_properties_access_spec.rb
-- spec/higher_level_api/integration/predeclared_exchanges_spec.rb
-- spec/higher_level_api/integration/publisher_confirms_spec.rb
-- spec/higher_level_api/integration/publishing_edge_cases_spec.rb
-- spec/higher_level_api/integration/queue_bind_spec.rb
-- spec/higher_level_api/integration/queue_declare_spec.rb
-- spec/higher_level_api/integration/queue_delete_spec.rb
-- spec/higher_level_api/integration/queue_purge_spec.rb
-- spec/higher_level_api/integration/queue_unbind_spec.rb
-- spec/higher_level_api/integration/read_only_consumer_spec.rb
-- spec/higher_level_api/integration/sender_selected_distribution_spec.rb
-- spec/higher_level_api/integration/tls_connection_spec.rb
-- spec/higher_level_api/integration/tx_commit_spec.rb
-- spec/higher_level_api/integration/tx_rollback_spec.rb
-- spec/higher_level_api/integration/with_channel_spec.rb
-- spec/issues/issue100_spec.rb
-- spec/issues/issue141_spec.rb
-- spec/issues/issue78_spec.rb
-- spec/issues/issue83_spec.rb
-- spec/issues/issue97_attachment.json
-- spec/issues/issue97_spec.rb
-- spec/lower_level_api/integration/basic_cancel_spec.rb
-- spec/lower_level_api/integration/basic_consume_spec.rb
-- spec/spec_helper.rb
-- spec/stress/channel_open_stress_spec.rb
-- spec/stress/channel_open_stress_with_single_threaded_connection_spec.rb
-- spec/stress/concurrent_consumers_stress_spec.rb
-- spec/stress/concurrent_publishers_stress_spec.rb
-- spec/stress/connection_open_close_spec.rb
-- spec/stress/long_running_consumer_spec.rb
-- spec/tls/cacert.pem
-- spec/tls/client_cert.pem
-- spec/tls/client_key.pem
-- spec/tls/server_cert.pem
-- spec/tls/server_key.pem
-- spec/unit/bunny_spec.rb
-- spec/unit/concurrent/atomic_fixnum_spec.rb
-- spec/unit/concurrent/condition_spec.rb
-- spec/unit/concurrent/linked_continuation_queue_spec.rb
-- spec/unit/concurrent/synchronized_sorted_set_spec.rb
-- spec/unit/system_timer_spec.rb
-- spec/unit/version_delivery_tag_spec.rb
 homepage: http://rubybunny.info
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  changelog_uri: https://github.com/ruby-amqp/bunny/blob/main/ChangeLog.md
+  source_code_uri: https://github.com/ruby-amqp/bunny/
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.1.11
-signing_key: 
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Popular easy to use Ruby client for RabbitMQ
-test_files:
-- spec/compatibility/queue_declare_spec.rb
-- spec/compatibility/queue_declare_with_default_channel_spec.rb
-- spec/higher_level_api/integration/basic_ack_spec.rb
-- spec/higher_level_api/integration/basic_cancel_spec.rb
-- spec/higher_level_api/integration/basic_consume_spec.rb
-- spec/higher_level_api/integration/basic_consume_with_objects_spec.rb
-- spec/higher_level_api/integration/basic_get_spec.rb
-- spec/higher_level_api/integration/basic_nack_spec.rb
-- spec/higher_level_api/integration/basic_publish_spec.rb
-- spec/higher_level_api/integration/basic_qos_spec.rb
-- spec/higher_level_api/integration/basic_recover_spec.rb
-- spec/higher_level_api/integration/basic_reject_spec.rb
-- spec/higher_level_api/integration/basic_return_spec.rb
-- spec/higher_level_api/integration/channel_close_spec.rb
-- spec/higher_level_api/integration/channel_flow_spec.rb
-- spec/higher_level_api/integration/channel_open_spec.rb
-- spec/higher_level_api/integration/confirm_select_spec.rb
-- spec/higher_level_api/integration/connection_spec.rb
-- spec/higher_level_api/integration/connection_stop_spec.rb
-- spec/higher_level_api/integration/consistent_hash_exchange_spec.rb
-- spec/higher_level_api/integration/consumer_cancellation_notification_spec.rb
-- spec/higher_level_api/integration/dead_lettering_spec.rb
-- spec/higher_level_api/integration/exchange_bind_spec.rb
-- spec/higher_level_api/integration/exchange_declare_spec.rb
-- spec/higher_level_api/integration/exchange_delete_spec.rb
-- spec/higher_level_api/integration/exchange_unbind_spec.rb
-- spec/higher_level_api/integration/exclusive_queue_spec.rb
-- spec/higher_level_api/integration/heartbeat_spec.rb
-- spec/higher_level_api/integration/merry_go_round_spec.rb
-- spec/higher_level_api/integration/message_properties_access_spec.rb
-- spec/higher_level_api/integration/predeclared_exchanges_spec.rb
-- spec/higher_level_api/integration/publisher_confirms_spec.rb
-- spec/higher_level_api/integration/publishing_edge_cases_spec.rb
-- spec/higher_level_api/integration/queue_bind_spec.rb
-- spec/higher_level_api/integration/queue_declare_spec.rb
-- spec/higher_level_api/integration/queue_delete_spec.rb
-- spec/higher_level_api/integration/queue_purge_spec.rb
-- spec/higher_level_api/integration/queue_unbind_spec.rb
-- spec/higher_level_api/integration/read_only_consumer_spec.rb
-- spec/higher_level_api/integration/sender_selected_distribution_spec.rb
-- spec/higher_level_api/integration/tls_connection_spec.rb
-- spec/higher_level_api/integration/tx_commit_spec.rb
-- spec/higher_level_api/integration/tx_rollback_spec.rb
-- spec/higher_level_api/integration/with_channel_spec.rb
-- spec/issues/issue100_spec.rb
-- spec/issues/issue141_spec.rb
-- spec/issues/issue78_spec.rb
-- spec/issues/issue83_spec.rb
-- spec/issues/issue97_attachment.json
-- spec/issues/issue97_spec.rb
-- spec/lower_level_api/integration/basic_cancel_spec.rb
-- spec/lower_level_api/integration/basic_consume_spec.rb
-- spec/spec_helper.rb
-- spec/stress/channel_open_stress_spec.rb
-- spec/stress/channel_open_stress_with_single_threaded_connection_spec.rb
-- spec/stress/concurrent_consumers_stress_spec.rb
-- spec/stress/concurrent_publishers_stress_spec.rb
-- spec/stress/connection_open_close_spec.rb
-- spec/stress/long_running_consumer_spec.rb
-- spec/tls/cacert.pem
-- spec/tls/client_cert.pem
-- spec/tls/client_key.pem
-- spec/tls/server_cert.pem
-- spec/tls/server_key.pem
-- spec/unit/bunny_spec.rb
-- spec/unit/concurrent/atomic_fixnum_spec.rb
-- spec/unit/concurrent/condition_spec.rb
-- spec/unit/concurrent/linked_continuation_queue_spec.rb
-- spec/unit/concurrent/synchronized_sorted_set_spec.rb
-- spec/unit/system_timer_spec.rb
-- spec/unit/version_delivery_tag_spec.rb
-has_rdoc: true
+test_files: []

data/.gitignore

@@ -1,22 +0,0 @@
-.DS_Store
-.*.swp
-*.class
-*.rbc
-*.gem
-/doc/
-.yardoc
-.rvmrc
-Gemfile.lock
-.rbx/*
-.tags
-.tags_sorted_by_file
-.Apple*
-bin/*
-.bundle/*
-vendor/*
-playground/*
-*.org
-repl-*
-debug/*
-*.dump
-deploy.docs.sh

data/.rspec

@@ -1,3 +0,0 @@
---color
---format
-progress

data/.ruby-version

@@ -1 +0,0 @@
-2.0@rabbitmq

data/.travis.yml

@@ -1,23 +0,0 @@
-language: ruby
-bundler_args: --without development
-before_script: "./bin/ci/before_build.sh"
-script: "bundle exec rspec -cfs spec"
-rvm:
-  - "2.0"
-  - "1.9.3"
-  - "jruby-19mode"
-  - "1.9.2"
-  - "rbx-19mode"
-  - "1.8.7"
-notifications:
-  email: michael@rabbitmq.com
-services:
-  - rabbitmq
-branches:
-  only:
-    - master
-    - 0.9.x-stable
-matrix:
-  allow_failures:
-    - rvm: rbx-19mode
-    - rvm: 1.8.7

data/.yardopts

@@ -1,8 +0,0 @@
---no-private
---protected
---markup="markdown" lib/**/*.rb
---main README.md
---hide-tag todo
--
-LICENSE
-ChangeLog.md