// readme

PGMQ-Ruby

Ruby client for PGMQ - PostgreSQL Message Queue

What is PGMQ-Ruby?

PGMQ-Ruby is a Ruby client for PGMQ (PostgreSQL Message Queue). It provides direct access to all PGMQ operations with a clean, minimal API - similar to how rdkafka-ruby relates to Kafka.

Think of it as:

  • Like AWS SQS - but running entirely in PostgreSQL with no external dependencies
  • Like Sidekiq/Resque - but without Redis, using PostgreSQL for both data and queues
  • Like rdkafka-ruby - a thin, efficient wrapper around the underlying system (PGMQ SQL functions)

Architecture Note: This library follows the rdkafka-ruby/Karafka pattern - pgmq-ruby is the low-level foundation, while higher-level features (job processing, Rails integration, retry strategies, middleware) will live in pgmq-framework (similar to how Karafka builds on rdkafka-ruby). Like rdkafka-ruby’s simple consumer, pgmq-ruby ships a minimal single-threaded PGMQ::Consumer loop for one or more queues.

Table of Contents