amqp-client 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5cf775bb44cd9021dec5416472d52dec17a5e0ae847de7d56ea0d3acd1e27b11
+  data.tar.gz: 589416e377d8d3bcc448991664666aab664b7dd194fb8990e0294251439d0838
+SHA512:
+  metadata.gz: c3c5672321ffadc0966a3dd549697699be445a58db1448ac2e2cb2f06ad4a9b456036b64bfd52a1c35a56dd88301b36dea4cd639ca2d90155ead57d40b9ca16b
+  data.tar.gz: b23676715032b2fb4e909a550e6674155e1ef2be9fae08e543db6811b7f8a456c35ac09d57b0a0fa0c356e9eea954614221c33c27898beb30acd36f5b2c8e41d

data/.github/workflows/main.yml

@@ -0,0 +1,18 @@
+name: Ruby
+
+on: [push,pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 3.0.0
+    - name: Run the default task
+      run: |
+        gem install bundler -v 2.2.15
+        bundle install
+        bundle exec rake

data/.gitignore

@@ -0,0 +1,8 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rubocop.yml

@@ -0,0 +1,15 @@
+inherit_from: .rubocop_todo.yml
+
+AllCops:
+  TargetRubyVersion: 2.5
+
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Layout/LineLength:
+  Max: 120

data/.rubocop_todo.yml

@@ -0,0 +1,86 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2021-04-29 10:30:28 UTC using RuboCop version 1.12.1.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: AutoCorrect, AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, IgnoredPatterns.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 129
+
+# Offense count: 2
+Lint/ShadowedException:
+  Exclude:
+    - 'lib/amqp/client.rb'
+    - 'lib/amqp/client/connection.rb'
+
+# Offense count: 2
+# Cop supports --auto-correct.
+# Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods.
+Lint/UnusedMethodArgument:
+  Exclude:
+    - 'lib/amqp/client/channel.rb'
+
+# Offense count: 6
+# Configuration parameters: IgnoredMethods, CountRepeatedAttributes.
+Metrics/AbcSize:
+  Max: 52
+
+# Offense count: 1
+# Configuration parameters: CountComments, CountAsOne, ExcludedMethods, IgnoredMethods.
+# IgnoredMethods: refine
+Metrics/BlockLength:
+  Max: 76
+
+# Offense count: 3
+# Configuration parameters: CountComments, CountAsOne.
+Metrics/ClassLength:
+  Max: 148
+
+# Offense count: 5
+# Configuration parameters: IgnoredMethods.
+Metrics/CyclomaticComplexity:
+  Max: 18
+
+# Offense count: 9
+# Configuration parameters: CountComments, CountAsOne, ExcludedMethods, IgnoredMethods.
+Metrics/MethodLength:
+  Max: 83
+
+# Offense count: 1
+# Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
+Metrics/ParameterLists:
+  Max: 6
+
+# Offense count: 3
+# Configuration parameters: IgnoredMethods.
+Metrics/PerceivedComplexity:
+  Max: 12
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: always, always_true, never
+Style/FrozenStringLiteralComment:
+  Exclude:
+    - 'bm_append_string.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: implicit, explicit
+Style/RescueStandardError:
+  Exclude:
+    - 'lib/amqp/client.rb'
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: AutoCorrect, AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, IgnoredPatterns.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 129

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2021-04-13
+
+- Initial release

data/Gemfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in amqp-client.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+
+gem "minitest", "~> 5.0"
+
+gem "rubocop", "~> 1.7"

data/Gemfile.lock

@@ -0,0 +1,42 @@
+PATH
+  remote: .
+  specs:
+    amqp-client (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    minitest (5.14.2)
+    parallel (1.20.1)
+    parser (3.0.1.0)
+      ast (~> 2.4.1)
+    rainbow (3.0.0)
+    rake (13.0.3)
+    regexp_parser (2.1.1)
+    rexml (3.2.4)
+    rubocop (1.12.1)
+      parallel (~> 1.10)
+      parser (>= 3.0.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml
+      rubocop-ast (>= 1.2.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.4.1)
+      parser (>= 2.7.1.5)
+    ruby-progressbar (1.11.0)
+    unicode-display_width (2.0.0)
+
+PLATFORMS
+  x86_64-linux
+
+DEPENDENCIES
+  amqp-client!
+  minitest (~> 5.0)
+  rake (~> 13.0)
+  rubocop (~> 1.7)
+
+BUNDLED WITH
+   2.2.15

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2021 Carl Hörberg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,47 @@
+# AMQP::Client
+
+An AMQP 0-9-1 client alternative, trying to keep things as simple as possible.
+
+## 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
+
+## Usage
+
+```ruby
+require "amqp-client"
+
+c = AMQP::Client.new("amqp://guest:guest@localhost")
+conn = c.connect
+ch = conn.channel
+q = ch.queue_declare
+ch.basic_publish "Hello World!", "", q[:queue_name]
+msg = ch.basic_get q[:queue_name]
+puts msg.body
+```
+
+## 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`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at 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

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[test rubocop]

data/amqp-client.gemspec

@@ -0,0 +1,35 @@
+# 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       = ["Carl Hörberg"]
+  spec.email         = ["carl@cloudamqp.com"]
+
+  spec.summary       = "AMQP 0-9-1 client"
+  spec.description   = "Work in progress"
+  spec.homepage      = "https://github.com/cloudamqp/amqp-client.rb"
+  spec.license       = "MIT"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.5.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"]
+
+  # Uncomment to register a new dependency of your gem
+  # spec.add_dependency "example-gem", "~> 1.0"
+
+  # For more information and examples about making a new gem, checkout our
+  # guide at: https://bundler.io/guides/creating_gem.html
+end

data/bin/console

@@ -0,0 +1,15 @@
+#!/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

@@ -0,0 +1,8 @@
+#!/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

data/lib/amqp/client.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+require "socket"
+require "uri"
+require "openssl"
+require_relative "client/version"
+require_relative "client/errors"
+require_relative "client/frames"
+require_relative "client/connection"
+require_relative "client/channel"
+
+module AMQP
+  # AMQP 0-9-1 Client
+  class Client
+    def initialize(uri)
+      @uri = URI.parse(uri)
+      @tls = @uri.scheme == "amqps"
+      @port = @uri.port || @tls ? 5671 : 5672
+      @host = @uri.host || "localhost"
+      @user = @uri.user || "guest"
+      @password = @uri.password || "guest"
+      @vhost = URI.decode_www_form_component(@uri.path[1..-1] || "/")
+      @options = URI.decode_www_form(@uri.query || "").to_h
+    end
+
+    def connect
+      socket = Socket.tcp @host, @port, connect_timeout: 20, resolv_timeout: 5
+      enable_tcp_keepalive(socket)
+      if @tls
+        context = OpenSSL::SSL::SSLContext.new
+        context.verify_mode = OpenSSL::SSL::VERIFY_PEER unless @options["verify_peer"] == "none"
+        socket = OpenSSL::SSL::SSLSocket.new(socket, context)
+        socket.sync_close = true # closing the TLS socket also closes the TCP socket
+      end
+      channel_max, frame_max, heartbeat = establish(socket)
+      Connection.new(socket, channel_max, frame_max, heartbeat)
+    end
+
+    private
+
+    def establish(socket)
+      channel_max, frame_max, heartbeat = nil
+      socket.write "AMQP\x00\x00\x09\x01"
+      buf = String.new(capacity: 4096)
+      loop do
+        begin
+          socket.readpartial(4096, buf)
+        rescue EOFError, IOError, OpenSSL::Error => e
+          raise Error, "Could not establish AMQP connection: #{e.message}"
+        end
+
+        type, channel_id, frame_size = buf.unpack("C S> L>")
+        frame_end = buf.unpack1("@#{frame_size + 7} C")
+        raise UnexpectedFrameEndError, frame_end if frame_end != 206
+
+        case type
+        when 1 # method frame
+          class_id, method_id = buf.unpack("@7 S> S>")
+          case class_id
+          when 10 # connection
+            raise Error, "Unexpected channel id #{channel_id} for Connection frame" if channel_id != 0
+
+            case method_id
+            when 10 # connection#start
+              socket.write FrameBytes.connection_start_ok "\u0000#{@user}\u0000#{@password}"
+            when 30 # connection#tune
+              channel_max, frame_max, heartbeat = buf.unpack("@11 S> L> S>")
+              channel_max = [channel_max, 2048].min
+              frame_max = [frame_max, 4096].min
+              heartbeat = [heartbeat, 0].min
+              socket.write FrameBytes.connection_tune_ok(channel_max, frame_max, heartbeat)
+              socket.write FrameBytes.connection_open(@vhost)
+            when 41 # connection#open-ok
+              return [channel_max, frame_max, heartbeat]
+            when 50 # connection#close
+              code, text_len = buf.unpack("@11 S> C")
+              text, error_class_id, error_method_id = buf.unpack("@14 a#{text_len} S> S>")
+              socket.write FrameBytes.connection_close_ok
+              raise Error, "Could not establish AMQP connection: #{code} #{text} #{error_class_id} #{error_method_id}"
+            else raise Error, "Unexpected class/method: #{class_id} #{method_id}"
+            end
+          else raise Error, "Unexpected class/method: #{class_id} #{method_id}"
+          end
+        else raise Error, "Unexpected frame type: #{type}"
+        end
+      end
+    rescue StandardError
+      socket.close
+      raise
+    end
+
+    def enable_tcp_keepalive(socket)
+      socket.setsockopt(Socket::SOL_SOCKET, Socket::SO_KEEPALIVE, true)
+      socket.setsockopt(Socket::SOL_TCP, Socket::TCP_KEEPIDLE, 60)
+      socket.setsockopt(Socket::SOL_TCP, Socket::TCP_KEEPINTVL, 10)
+      socket.setsockopt(Socket::SOL_TCP, Socket::TCP_KEEPCNT, 3)
+    rescue => e
+      warn "amqp-client: Could not enable TCP keepalive on socket. #{e.inspect}"
+    end
+  end
+end

data/lib/amqp/client/channel.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+require_relative "./message"
+
+module AMQP
+  # AMQP Channel
+  class Channel
+    def initialize(connection, id)
+      @rpc = Queue.new
+      @connection = connection
+      @id = id
+      @closed = false
+    end
+
+    attr_reader :id
+
+    def open
+      write_bytes FrameBytes.channel_open(@id)
+      expect(:channel_open_ok)
+      self
+    end
+
+    def close(reason = "", code = 200)
+      return if @closed
+
+      write_bytes FrameBytes.channel_close(@id, reason, code)
+      expect :channel_close_ok
+      @closed = true
+    end
+
+    def queue_declare(name = "", passive: false, durable: true, exclusive: false, auto_delete: false, **args)
+      durable = false if name.empty?
+      exclusive = true if name.empty?
+      auto_delete = true if name.empty?
+
+      write_bytes FrameBytes.queue_declare(@id, name, passive, durable, exclusive, auto_delete)
+      name, message_count, consumer_count = expect(:queue_declare_ok)
+      {
+        queue_name: name,
+        message_count: message_count,
+        consumer_count: consumer_count
+      }
+    end
+
+    def basic_get(queue_name, no_ack: true)
+      return if @closed
+
+      write_bytes FrameBytes.basic_get(@id, queue_name, no_ack)
+      resp = @rpc.shift
+      frame, = resp
+      case frame
+      when :basic_get_ok
+        _, exchange_name, routing_key, redelivered = resp
+        body_size, properties = expect(:header)
+        pos = 0
+        body = ""
+        while pos < body_size
+          body_part = expect(:body)
+          body += body_part
+          pos += body_part.bytesize
+        end
+        Message.new(exchange_name, routing_key, properties, body, redelivered)
+      when :basic_get_empty
+        nil
+      else raise AMQP::Client::UnexpectedFrame, %i[basic_get_ok basic_get_empty], frame
+      end
+    end
+
+    def basic_publish(exchange, routing_key, body, properties = {})
+      raise AMQP::Client::ChannelClosedError, @id if @closed
+
+      write_bytes FrameBytes.basic_publish(@id, exchange, routing_key)
+      write_bytes FrameBytes.header(@id, body.bytesize, properties)
+
+      # body frames, splitted on frame size
+      pos = 0
+      while pos < body.bytesize
+        len = [4096, body.bytesize - pos].min
+        body_part = body.byteslice(pos, len)
+        write_bytes FrameBytes.body(@id, body_part)
+        pos += len
+      end
+    end
+
+    def push(*args)
+      @rpc.push(*args)
+    end
+
+    private
+
+    def write_bytes(bytes)
+      @connection.write_bytes bytes
+    end
+
+    def expect(expected_frame_type)
+      frame_type, args = @rpc.shift
+      frame_type == expected_frame_type || raise(UnexpectedFrame, expected_frame_type, frame_type)
+      args
+    end
+  end
+end

data/lib/amqp/client/connection.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+module AMQP
+  # AMQP Connection
+  class Connection
+    def initialize(socket, channel_max, frame_max, heartbeat)
+      @socket = socket
+      @channel_max = channel_max
+      @frame_max = frame_max
+      @heartbeat = heartbeat
+      @channels = {}
+      @closed = false
+      @rpc = Queue.new
+      Thread.new { read_loop }
+    end
+
+    def channel
+      id = 1.upto(@channel_max) { |i| break i unless @channels.key? i }
+      ch = Channel.new(self, id)
+      @channels[id] = ch
+      ch.open
+    end
+
+    def close(reason = "", code = 200)
+      write_bytes FrameBytes.connection_close(code, reason)
+      expect(:close_ok)
+      @closed = true
+    end
+
+    def write_bytes(bytes)
+      @socket.write bytes
+    end
+
+    private
+
+    def read_loop
+      socket = @socket
+      frame_max = @frame_max
+      buffer = String.new(capacity: frame_max)
+      loop do
+        begin
+          socket.readpartial(frame_max, buffer)
+        rescue IOError, EOFError
+          break
+        end
+
+        buf_pos = 0
+        while buf_pos < buffer.bytesize
+          type, channel_id, frame_size = buffer.unpack("@#{buf_pos}C S> L>")
+          frame_end = buffer.unpack1("@#{buf_pos + 7 + frame_size} C")
+          raise AMQP::Client::UnexpectedFrameEnd if frame_end != 206
+
+          buf = buffer.byteslice(buf_pos, frame_size + 8)
+          buf_pos += frame_size + 8
+          parse_frame(type, channel_id, frame_size, buf) || return
+        end
+      end
+    ensure
+      @closed = true
+      begin
+        @socket.close
+      rescue IOError
+        nil
+      end
+    end
+
+    def parse_frame(type, channel_id, frame_size, buf)
+      case type
+      when 1 # method frame
+        class_id, method_id = buf.unpack("@7 S> S>")
+        case class_id
+        when 10 # connection
+          raise AMQP::Client::Error, "Unexpected channel id #{channel_id} for Connection frame" if channel_id != 0
+
+          case method_id
+          when 50 # connection#close
+            code, text_len = buf.unpack("@11 S> C")
+            text, error_class_id, error_method_id = buf.unpack("@14 a#{text_len} S> S>")
+            warn "Connection closed #{code} #{text} #{error_class_id} #{error_method_id}"
+            write_bytes FrameBytes.connection_close_ok
+            return false
+          when 51 # connection#close-ok
+            @rpc.push [:close_ok]
+            return false
+          else raise AMQP::Client::UnsupportedMethodFrame, class_id, method_id
+          end
+        when 20 # channel
+          case method_id
+          when 11 # channel#open-ok
+            @channels[channel_id].push [:channel_open_ok]
+          when 40 # channel#close
+            channel = @channels.delete(channel_id)
+            channel&.closed!
+          when 41 # channel#close-ok
+            @channels[channel_id].push [:channel_close_ok]
+          else raise AMQP::Client::UnsupportedMethodFrame, class_id, method_id
+          end
+        when 50 # queue
+          case method_id
+          when 11 # queue#declare-ok
+            queue_name_len = buf.unpack1("@11 C")
+            queue_name, message_count, consumer_count = buf.unpack("@12 a#{queue_name_len} L> L>")
+            @channels[channel_id].push [:queue_declare_ok, queue_name, message_count, consumer_count]
+          else raise AMQP::Client::UnsupportedMethodFrame, class_id, method_id
+          end
+        when 60 # basic
+          case method_id
+          when 71 # get-ok
+            delivery_tag, redelivered, exchange_name_len = buf.unpack("@11 Q> C C")
+            exchange_name = buf.byteslice(21, exchange_name_len)
+            pos = 21 + exchange_name_len
+            routing_key_len = buf.unpack1("@#{pos} C")
+            pos += 1
+            routing_key = buf.byteslice(pos, routing_key_len)
+            pos += routing_key_len
+            message_count = buf.unpack1("@#{pos} L>")
+            @channels[channel_id].push [:basic_get_ok, delivery_tag, exchange_name, routing_key, message_count, redelivered == 1]
+          when 72 # get-empty
+            @channels[channel_id].push [:basic_get_empty]
+          else raise AMQP::Client::UnsupportedMethodFrame, class_id, method_id
+          end
+        else raise AMQP::Client::UnsupportedMethodFrame, class_id, method_id
+        end
+      when 2 # header
+        body_size = buf.unpack1("@11 Q>")
+        @channels[channel_id].push [:header, body_size, nil]
+      when 3 # body
+        body = buf.byteslice(7, frame_size)
+        @channels[channel_id].push [:body, body]
+      else raise AMQP::Client::UnsupportedFrameType, type
+      end
+      true
+    end
+
+    def expect(expected_frame_type)
+      frame_type, args = @rpc.shift
+      frame_type == expected_frame_type || raise(UnexpectedFrame, expected_frame_type, frame_type)
+      args
+    end
+  end
+end

data/lib/amqp/client/errors.rb

@@ -0,0 +1,37 @@
+module AMQP
+  class Client
+    class Error < StandardError; end
+
+    # Raised when a frame that wasn't expected arrives
+    class UnexpectedFrame < Error
+      def initialize(expected, actual)
+        super "Expected frame type '#{expected}' but got '#{actual}'"
+      end
+    end
+
+    # Raised when a frame doesn't end with 206
+    class UnexpectedFrameEnd < Error
+      def initialize(actual)
+        super "Expected frame end 206 but got '#{actual}'"
+      end
+    end
+
+    class UnsupportedFrameType < Error
+      def initialize(type)
+        super "Unsupported frame type '#{type}'"
+      end
+    end
+
+    class UnsupportedMethodFrame < Error
+      def initialize(class_id, method_id)
+        super "Unsupported class/method: #{class_id} #{method_id}"
+      end
+    end
+
+    class ChannelClosedError < Error
+      def initialize(id)
+        super "Channel #{id} already closed"
+      end
+    end
+  end
+end

data/lib/amqp/client/frames.rb

@@ -0,0 +1,186 @@
+# frozen_string_literal: true
+
+module AMQP
+  # Generate binary data for different frames
+  # Each frame type implemented as a method
+  # Having a class for each frame type is more expensive in terms of CPU and memory
+  module FrameBytes
+    module_function
+
+    def connection_start_ok(response)
+      [
+        1, # type: method
+        0, # channel id
+        4 + 4 + 6 + 4 + response.bytesize + 1, # frame size
+        10, # class id
+        11, # method id
+        0, # client props
+        5, "PLAIN", # mechanism
+        response.bytesize, response,
+        0, "", # locale
+        206 # frame end
+      ].pack("C S> L> S> S> L> Ca* L>a* Ca* C")
+    end
+
+    def connection_tune_ok(channel_max, frame_max, heartbeat)
+      [
+        1, # type: method
+        0, # channel id
+        12, # frame size
+        10, # class: connection
+        31, # method: tune-ok
+        channel_max,
+        frame_max,
+        heartbeat,
+        206 # frame end
+      ].pack("CS>L>S>S>S>L>S>C")
+    end
+
+    def connection_open(vhost)
+      [
+        1, # type: method
+        0, # channel id
+        2 + 2 + 1 + vhost.bytesize + 1 + 1, # frame_size
+        10, # class: connection
+        40, # method: open
+        vhost.bytesize, vhost,
+        0, # reserved1
+        0, # reserved2
+        206 # frame end
+      ].pack("C S> L> S> S> Ca* CCC")
+    end
+
+    def connection_close(code, reason)
+      frame_size = 2 + 2 + 2 + 1 + reason.bytesize + 2 + 2
+      [
+        1, # type: method
+        0, # channel id
+        frame_size, # frame size
+        10, # class: connection
+        50, # method: close
+        code,
+        reason.bytesize, reason,
+        0, # error class id
+        0, # error method id
+        206 # frame end
+      ].pack("C S> L> S> S> S> Ca* S> S> C")
+    end
+
+    def connection_close_ok
+      [
+        1, # type: method
+        0, # channel id
+        4, # frame size
+        10, # class: connection
+        51, # method: close-ok
+        206 # frame end
+      ].pack("C S> L> S> S> C")
+    end
+
+    def channel_open(id)
+      [
+        1, # type: method
+        id, # channel id
+        5, # frame size
+        20, # class: channel
+        10, # method: open
+        0, # reserved1
+        206 # frame end
+      ].pack("C S> L> S> S> C C")
+    end
+
+    def channel_close(id, reason, code)
+      frame_size = 2 + 2 + 2 + 1 + reason.bytesize + 2 + 2
+      [
+        1, # type: method
+        id, # channel id
+        frame_size, # frame size
+        20, # class: channel
+        40, # method: close
+        code,
+        reason.bytesize, reason,
+        0, # error class id
+        0, # error method id
+        206 # frame end
+      ].pack("C S> L> S> S> S> Ca* S> S> C")
+    end
+
+    def queue_declare(id, name, passive, durable, exclusive, auto_delete)
+      no_wait = false
+      bits = 0
+      bits |= (1 << 0) if passive
+      bits |= (1 << 1) if durable
+      bits |= (1 << 2) if exclusive
+      bits |= (1 << 3) if auto_delete
+      bits |= (1 << 4) if no_wait
+      frame_size = 2 + 2 + 2 + 1 + name.bytesize + 1 + 4
+      [
+        1, # type: method
+        id, # channel id
+        frame_size, # frame size
+        50, # class: queue
+        10, # method: declare
+        0, # reserved1
+        name.bytesize, name,
+        bits,
+        0, # arguments
+        206 # frame end
+      ].pack("C S> L> S> S> S> Ca* C L> C")
+    end
+
+    def basic_get(id, queue_name, no_ack)
+      frame_size = 2 + 2 + 2 + 1 + queue_name.bytesize + 2 + 2
+      [
+        1, # type: method
+        id, # channel id
+        frame_size, # frame size
+        60, # class: basic
+        70, # method: get
+        0, # reserved1
+        queue_name.bytesize, queue_name,
+        no_ack ? 1 : 0,
+        206 # frame end
+      ].pack("C S> L> S> S> S> Ca* C C")
+    end
+
+    def basic_publish(id, exchange, routing_key)
+      frame_size = 2 + 2 + 2 + 1 + exchange.bytesize + 1 + routing_key.bytesize + 1
+      [
+        1, # type: method
+        id, # channel id
+        frame_size, # frame size
+        60, # class: basic
+        40, # method: publish
+        0, # reserved1
+        exchange.bytesize, exchange,
+        routing_key.bytesize, routing_key,
+        0, # bits, mandatory/immediate
+        206 # frame end
+      ].pack("C S> L> S> S> S> Ca* Ca* C C")
+    end
+
+    def header(id, body_size, properties)
+      frame_size = 2 + 2 + 8 + 2
+      [
+        2, # type: header
+        id, # channel id
+        frame_size, # frame size
+        60, # class: basic
+        0, # weight
+        body_size,
+        0, # properties
+        206 # frame end
+      ].pack("C S> L> S> S> Q> S> C")
+    end
+
+    def body(id, body_part)
+      [
+        3, # type: body
+        id, # channel id
+        body_part.bytesize, # frame size
+        body_part,
+        206 # frame end
+      ].pack("C S> L> a* C")
+    end
+  end
+end

data/lib/amqp/client/message.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module AMQP
+  Message = Struct.new(:exchange_name, :routing_key, :properties, :body, :redelivered)
+end

data/lib/amqp/client/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module AMQP
+  class Client
+    VERSION = "0.1.0"
+  end
+end

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification
+name: amqp-client
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Carl Hörberg
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2021-05-28 00:00:00.000000000 Z
+dependencies: []
+description: Work in progress
+email:
+- carl@cloudamqp.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/main.yml"
+- ".gitignore"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- amqp-client.gemspec
+- bin/console
+- bin/setup
+- lib/amqp/client.rb
+- lib/amqp/client/channel.rb
+- lib/amqp/client/connection.rb
+- lib/amqp/client/errors.rb
+- lib/amqp/client/frames.rb
+- lib/amqp/client/message.rb
+- lib/amqp/client/version.rb
+homepage: https://github.com/cloudamqp/amqp-client.rb
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/cloudamqp/amqp-client.rb
+  source_code_uri: https://github.com/cloudamqp/amqp-client.rb.git
+  changelog_uri: https://github.com/cloudamqp/amqp-client.rb/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.15
+signing_key:
+specification_version: 4
+summary: AMQP 0-9-1 client
+test_files: []