amqp-client 1.2.1 → 2.0.0

data/README.md

@@ -1,193 +0,0 @@
-# AMQP::Client
-
-A modern AMQP 0-9-1 Ruby client. Very fast (just as fast as the Java client, and >4x than other Ruby clients), fully thread-safe, blocking operations and straight-forward error handling.
-
-It's small, only ~1800 lines of code, and without any dependencies. Other Ruby clients are about 4 times bigger. But without trading functionallity.
-
-It's safe by default, messages are published as persistent, and is waiting for confirmation from the broker. That can of course be disabled if performance is a priority.
-
-## Support
-
-The library is fully supported by [CloudAMQP](https://www.cloudamqp.com), the largest LavinMQ and RabbitMQ hosting provider in the world. Open [an issue](https://github.com/cloudamqp/amqp-client.rb/issues) or [email our support](mailto:support@cloudamqp.com) if you have problems or questions.
-
-## Documentation
-
-[API reference](https://cloudamqp.github.io/amqp-client.rb/)
-
-## Usage
-
-The client has two APIs.
-
-### Low level API
-
-This API matches the AMQP protocol very well, it can do everything the protocol allows, but requires some knowledge about the protocol, and doesn't handle reconnects.
-
-```ruby
-require "amqp-client"
-
-# Opens and establishes a connection
-conn = AMQP::Client.new("amqp://guest:guest@localhost").connect
-
-# Open a channel
-ch = conn.channel
-
-# Create a temporary queue
-q = ch.queue_declare
-
-# Publish a message to said queue
-ch.basic_publish_confirm "Hello World!", "", q.queue_name, persistent: true
-
-# Poll the queue for a message
-msg = ch.basic_get(q.queue_name)
-
-# Print the message's body to STDOUT
-puts msg.body
-```
-
-### High level API
-
-The library provides a high-level API that is a bit easier to get started with, and also handles reconnection automatically.
-
-```ruby
-require "amqp-client"
-require "json"
-require "zlib"
-
-# Start the client, it will connect and once connected it will reconnect if that connection is lost
-# Operation pending when the connection is lost will raise an exception (not timeout)
-amqp = AMQP::Client.new("amqp://localhost").start
-
-# Declares a durable queue
-myqueue = amqp.queue("myqueue")
-
-# Bind the queue to any exchange, with any binding key
-myqueue.bind("amq.topic", "my.events.*")
-
-# The message will be reprocessed if the client loses connection to the broker
-# between message arrival and when the message was supposed to be ack'ed.
-myqueue.subscribe(prefetch: 20) do |msg|
-  puts JSON.parse(msg.body)
-  msg.ack
-rescue => e
-  puts e.full_message
-  msg.reject(requeue: false)
-end
-
-# Publish directly to the queue
-myqueue.publish({ foo: "bar" }.to_json, content_type: "application/json")
-
-# Publish to any exchange
-amqp.publish("my message", "amq.topic", "topic.foo", headers: { foo: 'bar' })
-amqp.publish(Zlib.gzip("an event"), "amq.topic", "my.event", content_encoding: 'gzip')
-```
-
-## Benchmark
-
-1 byte messages:
-
-| Client | Publish rate | Consume rate | Memory usage |
-| ------ | ------------ | ------------ | ------------ |
-| amqp-client.rb | 237.000 msgs/s | 154.000 msgs/s | 23 MB |
-| bunny | 39.000 msgs/s | 44.000 msgs/s | 31 MB |
-
-Gem comparison:
-
-| Client | Runtime dependencies | [Lines of code](https://github.com/AlDanial/cloc) |
-| --- | --- | --- |
-| amqp-client.rb | 0 | 1876 |
-| bunny | 2 | 4003 |
-
-## Supported Ruby versions
-
-All maintained Ruby versions are supported.
-
-See the [CI workflow](https://github.com/cloudamqp/amqp-client.rb/blob/main/.github/workflows/main.yml) for the exact versions.
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'amqp-client'
-```
-
-And then execute:
-
-    bundle install
-
-Or install it yourself as:
-
-    gem install amqp-client
-
-## Development
-
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` 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`.
-
-### Release Process
-
-The gem uses rake tasks to automate the release preparation process. The actual gem building and publishing is handled automatically by GitHub Actions when a tag is pushed.
-
-#### Quick Release (Patch Version)
-
-```bash
-rake release:prepare
-```
-
-This will:
-
-1. Run tests and RuboCop to ensure code quality
-2. Bump the patch version (e.g., 1.2.0 → 1.2.1)
-3. Update the CHANGELOG.md with the new version and current date
-4. Create a git commit and tag for the release
-5. Push commits and tags to the remote repository
-6. GitHub Actions will automatically build and publish the gem to RubyGems
-
-#### Custom Version Bump
-
-For minor or major version bumps:
-
-```bash
-# Minor version bump (e.g., 1.2.0 → 1.3.0)
-rake release:prepare[minor]
-
-# Major version bump (e.g., 1.2.0 → 2.0.0)
-rake release:prepare[major]
-```
-
-#### Individual Release Steps
-
-You can also run individual steps if needed:
-
-```bash
-# Bump version only
-rake release:bump[patch]  # or [minor] or [major]
-
-# Update changelog with current version
-rake release:changelog
-
-# Create git tag with changelog entries
-rake release:tag
-
-# Push tag to remote (handles conflicts)
-rake release:push_tag
-```
-
-#### Manual Release Steps
-
-If you prefer manual control:
-
-1. Update the version number in `lib/amqp/client/version.rb`
-2. Update the CHANGELOG.md with the new version and release notes
-3. Commit your changes: `git add . && git commit -m "Release X.Y.Z"`
-4. Create and push a tag: `git tag vX.Y.Z && git push origin vX.Y.Z`
-5. GitHub Actions will automatically build and publish the gem when the tag is pushed
-
-## Contributing
-
-Bug reports and pull requests are welcome on GitHub at [https://github.com/cloudamqp/amqp-client.rb](https://github.com/cloudamqp/amqp-client.rb/)
-
-## License
-
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -1,197 +0,0 @@
-# frozen_string_literal: true
-
-require "rake/testtask"
-
-Rake::TestTask.new(:test) do |t|
-  t.description = "Run all but TLS tests"
-  t.options = "--exclude=/_tls$/"
-  t.pattern = "test/**/*_test.rb"
-end
-
-namespace :test do
-  Rake::TestTask.new(:all) do |t|
-    t.description = "Run all tests"
-    t.pattern = "test/**/*_test.rb"
-  end
-end
-
-require "rubocop/rake_task"
-
-RuboCop::RakeTask.new
-
-require "yard"
-
-YARD::Rake::YardocTask.new
-
-# Release helper methods
-def current_version
-  version_file = "lib/amqp/client/version.rb"
-  content = File.read(version_file)
-  content.match(/VERSION = "(.+)"/)[1]
-end
-
-def extract_changelog_for_version(version)
-  changelog = File.read("CHANGELOG.md")
-
-  # Find the section for this version
-  version_pattern = /^## \[#{Regexp.escape(version)}\][^\n]*\n(.*?)(?=^## \[|\z)/m
-  match = changelog.match(version_pattern)
-
-  if match
-    # Clean up the changelog entries
-    entries = match[1].strip
-    # Remove empty lines at the start and end
-    entries.gsub(/\A\s*\n+/, "").gsub(/\n+\s*\z/, "")
-  else
-    "No changelog entries found for version #{version}"
-  end
-end
-
-def push_tag_to_remote(version)
-  # Check if tag exists on remote
-  remote_tag_exists = system("git ls-remote --tags origin | grep -q refs/tags/v#{version}")
-
-  if remote_tag_exists
-    puts "Tag v#{version} already exists on remote. Force pushing updated tag..."
-    system("git push origin v#{version} --force")
-  else
-    puts "Pushing new tag v#{version} to remote..."
-    system("git push origin v#{version}")
-  end
-end
-
-def bump_version(version_type)
-  unless %w[major minor patch].include?(version_type)
-    puts "Invalid version type. Use: major, minor, or patch"
-    exit 1
-  end
-
-  version_file = "lib/amqp/client/version.rb"
-  content = File.read(version_file)
-
-  current_version = content.match(/VERSION = "(.+)"/)[1]
-  major, minor, patch = current_version.split(".").map(&:to_i)
-
-  case version_type
-  when "major"
-    major += 1
-    minor = 0
-    patch = 0
-  when "minor"
-    minor += 1
-    patch = 0
-  when "patch"
-    patch += 1
-  end
-
-  new_version = "#{major}.#{minor}.#{patch}"
-  new_content = content.gsub(/VERSION = ".+"/, %(VERSION = "#{new_version}"))
-
-  File.write(version_file, new_content)
-  puts "Bumped version from #{current_version} to #{new_version}"
-end
-
-def update_changelog
-  version = current_version
-  date = Time.now.strftime("%Y-%m-%d")
-
-  changelog = File.read("CHANGELOG.md")
-
-  if changelog.include?("## [#{version}]")
-    puts "Version #{version} already exists in CHANGELOG.md"
-  else
-    updated_changelog = changelog.sub(
-      "## [Unreleased]",
-      "## [Unreleased]\n\n## [#{version}] - #{date}"
-    )
-
-    File.write("CHANGELOG.md", updated_changelog)
-    puts "Updated CHANGELOG.md with version #{version}"
-  end
-end
-
-def create_git_tag
-  version = current_version
-
-  system("git add .")
-  system("git commit -m 'Release #{version}'")
-
-  # Check if tag already exists locally and remove it if it does
-  if system("git tag -l v#{version} | grep -q v#{version}")
-    puts "Tag v#{version} already exists locally, removing it..."
-    system("git tag -d v#{version}")
-  end
-
-  # Extract changelog entries for this version
-  changelog_entries = extract_changelog_for_version(version)
-
-  # Create tag message with version and changelog
-  tag_message = "Release #{version}\n\n#{changelog_entries}"
-
-  # Create annotated tag with the changelog
-  system("git", "tag", "-a", "v#{version}", "-m", tag_message)
-
-  puts "Created git tag v#{version} with changelog entries"
-end
-
-def prepare_release_process(version_type)
-  puts "Preparing release process..."
-
-  # Ensure working directory is clean
-  unless system("git diff --quiet && git diff --cached --quiet")
-    puts "Working directory is not clean. Please commit or stash changes first."
-    exit 1
-  end
-
-  # Bump version
-  Rake::Task["release:bump"].invoke(version_type)
-  Rake::Task["release:bump"].reenable
-
-  # Update changelog
-  Rake::Task["release:changelog"].invoke
-  Rake::Task["release:changelog"].reenable
-
-  # Create tag and push
-  Rake::Task["release:tag"].invoke
-  Rake::Task["release:tag"].reenable
-
-  # Push to git
-  system("git push origin")
-
-  # Handle tag push with potential conflicts
-  version = current_version
-  push_tag_to_remote(version)
-
-  puts "Successfully prepared release #{version}!"
-  puts "The CI will automatically build and publish the gem when the tag is pushed."
-end
-
-namespace :release do
-  desc "Bump version (usage: rake release:bump[major|minor|patch])"
-  task :bump, [:type] do |_t, args|
-    bump_version(args[:type] || "patch")
-  end
-
-  desc "Update changelog with current version"
-  task :changelog do
-    update_changelog
-  end
-
-  desc "Create git tag for current version"
-  task :tag do
-    create_git_tag
-  end
-
-  desc "Push tag to remote (handles conflicts)"
-  task :push_tag do
-    version = current_version
-    push_tag_to_remote(version)
-  end
-
-  desc "Prepare release (bump version, update changelog, create tag, push to git)"
-  task :prepare, [:type] => %i[test rubocop] do |_t, args|
-    prepare_release_process(args[:type] || "patch")
-  end
-end
-
-task default: [:test, *(:rubocop if ENV["CI"] != "true")]

data/amqp-client.gemspec

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "lib/amqp/client/version"
-
-Gem::Specification.new do |spec|
-  spec.name          = "amqp-client"
-  spec.version       = AMQP::Client::VERSION
-  spec.authors       = ["CloudAMQP"]
-  spec.email         = ["team@cloudamqp.com"]
-
-  spec.summary       = "AMQP 0-9-1 client"
-  spec.description   = "Modern AMQP 0-9-1 Ruby client"
-  spec.homepage      = "https://github.com/cloudamqp/amqp-client.rb"
-  spec.license       = "MIT"
-  spec.required_ruby_version = Gem::Requirement.new(">= 3.2.0")
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "#{spec.homepage}.git"
-  spec.metadata["changelog_uri"] = "https://github.com/cloudamqp/amqp-client.rb/blob/main/CHANGELOG.md"
-
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files = Dir.chdir(File.expand_path(__dir__)) do
-    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
-  end
-  spec.bindir        = "exe"
-  spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-end

data/bin/console

@@ -1,15 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "bundler/setup"
-require "amqp/client"
-
-# You can add fixtures and/or initialization code here to make experimenting
-# with your gem easier. You can also use a different console, if you like.
-
-# (If you use this, don't forget to add pry to your Gemfile!)
-# require "pry"
-# Pry.start
-
-require "irb"
-IRB.start(__FILE__)

data/bin/setup

@@ -1,8 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-IFS=$'\n\t'
-set -vx
-
-bundle install
-
-# Do any other automated setup that you need to do here