pgmq-ruby 0.1.0 → 0.3.0

data/lib/pgmq/transaction.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+module PGMQ
+  # Low-level transaction support for PGMQ operations
+  #
+  # Provides atomic execution of PGMQ operations within PostgreSQL transactions.
+  # Transactions are a database primitive - this is a thin wrapper around
+  # PostgreSQL's native transaction support.
+  #
+  # This is analogous to rdkafka-ruby providing Kafka transaction support -
+  # it's a protocol/database feature, not a framework abstraction.
+  #
+  # @example Atomic multi-queue operations
+  #   client.transaction do |txn|
+  #     txn.send("orders", { order_id: 123 })
+  #     txn.send("notifications", { type: "order_created" })
+  #   end
+  #
+  # @example Automatic rollback on error
+  #   client.transaction do |txn|
+  #     txn.send("orders", { order_id: 123 })
+  #     raise "Error"  # Both operations rolled back
+  #   end
+  module Transaction
+    # Executes PGMQ operations atomically within a database transaction
+    #
+    # Obtains a connection from the pool, starts a transaction, and yields
+    # a client that uses that transaction for all operations.
+    #
+    # @yield [PGMQ::Client] transactional client using the same connection
+    # @return [Object] result of the block
+    # @raise [PGMQ::Errors::ConnectionError] if transaction fails
+    #
+    # @example
+    #   client.transaction do |txn|
+    #     msg_id = txn.send("queue", { data: "test" })
+    #     txn.delete("queue", msg_id)
+    #   end
+    def transaction
+      @connection.with_connection do |conn|
+        conn.transaction do
+          yield TransactionalClient.new(self, conn)
+        end
+      end
+    rescue PG::Error, StandardError => e
+      raise PGMQ::Errors::ConnectionError, "Transaction failed: #{e.message}"
+    end
+
+    # Minimal wrapper that ensures all operations use the transaction connection
+    #
+    # @private
+    class TransactionalClient
+      # @param parent [PGMQ::Client] parent client instance
+      # @param conn [PG::Connection] transaction connection
+      def initialize(
+        parent,
+        conn
+      )
+        @parent = parent
+        @conn = conn
+      end
+
+      # Forward all method calls to parent, but use our transaction connection
+      # @param method [Symbol] method name
+      # @return [Object] result of method call
+      def method_missing(method, ...)
+        @parent.respond_to?(method, true) ? @parent.__send__(method, ...) : super
+      end
+
+      # Override Object#send to call parent's send method
+      # @param queue_name [String] queue name
+      # @param message [String] message as JSON string
+      # @param delay [Integer] delay in seconds
+      # @return [String] message ID
+      def send(
+        queue_name,
+        message,
+        delay: 0
+      )
+        @parent.send(queue_name, message, delay: delay)
+      end
+
+      # Check if method exists on parent
+      # @param method [Symbol] method name
+      # @param include_private [Boolean] include private methods
+      # @return [Boolean] true if method exists
+      def respond_to_missing?(
+        method,
+        include_private = false
+      )
+        @parent.respond_to?(method, include_private) || super
+      end
+
+      # Inject our transaction connection instead of using the pool
+      def with_connection
+        yield @conn
+      end
+
+      # Expose parent's connection (for tests/inspection)
+      def connection
+        @parent.connection
+      end
+    end
+  end
+end

data/lib/pgmq/version.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module PGMQ
+  # Current version of the pgmq-ruby gem
+  VERSION = '0.3.0'
+end

data/lib/pgmq.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require 'zeitwerk'
+require 'time'
+
+loader = Zeitwerk::Loader.for_gem
+loader.inflector.inflect(
+  'pgmq' => 'PGMQ'
+)
+loader.setup
+loader.eager_load
+
+# PGMQ - Low-level Ruby client for Postgres Message Queue
+#
+# This is a low-level library providing direct access to PGMQ operations.
+# For higher-level abstractions, job processing, and framework integrations,
+# see pgmq-framework (similar to how rdkafka-ruby relates to Karafka).
+#
+# @example Basic usage
+#   require 'pgmq'
+#
+#   # Create client with connection parameters
+#   client = PGMQ::Client.new(
+#     host: 'localhost',
+#     port: 5432,
+#     dbname: 'mydb',
+#     user: 'postgres',
+#     password: 'postgres'
+#   )
+#
+#   # Or with connection string
+#   client = PGMQ::Client.new('postgres://localhost/mydb')
+#
+#   # Basic queue operations
+#   client.create('orders')
+#   msg_id = client.send('orders', { order_id: 123 })
+#   msg = client.read('orders', vt: 30)
+#   client.delete('orders', msg.msg_id)
+#   client.drop_queue('orders')
+module PGMQ
+  class << self
+    # Convenience method to create a new client
+    #
+    # @return [PGMQ::Client] new client instance
+    # @see PGMQ::Client#initialize
+    #
+    # @example
+    #   client = PGMQ.new('postgres://localhost/mydb')
+    def new(*, **)
+      Client.new(*, **)
+    end
+  end
+end

data/pgmq-ruby.gemspec

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative 'lib/pgmq/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'pgmq-ruby'
+  spec.version = PGMQ::VERSION
+  spec.authors = ['Maciej Mensfeld']
+  spec.email = ['maciej@mensfeld.pl']
+
+  spec.summary = 'Ruby client for PGMQ (Postgres Message Queue)'
+  spec.description = 'A Ruby driver for PGMQ - a lightweight message queue built on PostgreSQL. ' \
+                     'Like AWS SQS and RSMQ, but on Postgres.'
+  spec.homepage = 'https://github.com/mensfeld/pgmq-ruby'
+  spec.license = 'LGPL-3.0'
+  spec.required_ruby_version = '>= 3.2.0'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/mensfeld/pgmq-ruby'
+  spec.metadata['changelog_uri'] = 'https://github.com/mensfeld/pgmq-ruby/blob/master/CHANGELOG.md'
+  spec.metadata['bug_tracker_uri'] = 'https://github.com/mensfeld/pgmq-ruby/issues'
+  spec.metadata['documentation_uri'] = 'https://github.com/mensfeld/pgmq-ruby#readme'
+  spec.metadata['rubygems_mfa_required'] = 'true'
+
+  spec.files = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(spec|examples)/}) }
+  spec.require_paths = ['lib']
+
+  # Runtime dependencies
+  spec.add_dependency 'connection_pool', '~> 2.4'
+  spec.add_dependency 'pg', '~> 1.5'
+  spec.add_dependency 'zeitwerk', '~> 2.6'
+end

data/renovate.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": [
+    "config:recommended"
+  ],
+  "github-actions": {
+    "enabled": true,
+    "pinDigests": true
+  },
+  "packageRules": [
+    {
+      "matchManagers": [
+        "github-actions"
+      ],
+      "minimumReleaseAge": "7 days"
+    }
+  ]
+}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pgmq-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Maciej Mensfeld
@@ -9,6 +9,20 @@ bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: connection_pool
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
 - !ruby/object:Gem::Dependency
   name: pg
   requirement: !ruby/object:Gem::Requirement
@@ -23,13 +37,60 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.5'
-description: A Ruby driver for PGMQ - a lightweight message queue built on PostgreSQL
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+description: A Ruby driver for PGMQ - a lightweight message queue built on PostgreSQL.
+  Like AWS SQS and RSMQ, but on Postgres.
 email:
-- contact@karafka.io
+- maciej@mensfeld.pl
 executables: []
 extensions: []
 extra_rdoc_files: []
-files: []
+files:
+- ".coditsu/ci.yml"
+- ".github/workflows/ci.yml"
+- ".github/workflows/push.yml"
+- ".gitignore"
+- ".rspec"
+- ".ruby-version"
+- ".yard-lint.yml"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- docker-compose.yml
+- lib/pgmq.rb
+- lib/pgmq/client.rb
+- lib/pgmq/client/consumer.rb
+- lib/pgmq/client/maintenance.rb
+- lib/pgmq/client/message_lifecycle.rb
+- lib/pgmq/client/metrics.rb
+- lib/pgmq/client/multi_queue.rb
+- lib/pgmq/client/producer.rb
+- lib/pgmq/client/queue_management.rb
+- lib/pgmq/connection.rb
+- lib/pgmq/errors.rb
+- lib/pgmq/message.rb
+- lib/pgmq/metrics.rb
+- lib/pgmq/queue_metadata.rb
+- lib/pgmq/transaction.rb
+- lib/pgmq/version.rb
+- pgmq-ruby.gemspec
+- renovate.json
 homepage: https://github.com/mensfeld/pgmq-ruby
 licenses:
 - LGPL-3.0
@@ -38,6 +99,7 @@ metadata:
   source_code_uri: https://github.com/mensfeld/pgmq-ruby
   changelog_uri: https://github.com/mensfeld/pgmq-ruby/blob/master/CHANGELOG.md
   bug_tracker_uri: https://github.com/mensfeld/pgmq-ruby/issues
+  documentation_uri: https://github.com/mensfeld/pgmq-ruby#readme
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: