makasim / amqpextra

Golang AMQP reliable connection, publisher, consumer.

Extra features for streadway/amqp package.

Documentation

Dialer.

Provides:

• Auto reconnect.
• Context aware.
• Configured by WithXXX options.
• Dial multiple servers.
• Notifies ready\unready\closed states.

Examples:

• Dialer.ConnectionCh
• Dialer.Consumer
• Dialer.Publisher

Consumer.

Provides:

• Auto reconnect.
• Context aware.
• Configured by WithXXX options.
• Consumer can process messages in parallel.
• Consumers in-process auto-scaling and backpressure.
• Adds message context.
• Detects queue deletion and reconnect.
• Notifies ready\unready\closed states.

Examples:

• NewConsumer
• Wrap

Publisher.

Provides:

• Auto reconnect.
• Context aware.
• Configured by WithXXX options.
• Notifies ready\unready\closed states.
• Publish could wait till connection ready.
• Adds message context.
• Publish a message struct (define only what you need).
• Supports flow control.

Examples:

• NewPublisher

Consumer middlewares

The consumer could chain middlewares for a preprocessing received message.

Here's some built-in middlewares:

• HasCorrelationID - Nack message if has no correlation id
• HasReplyTo - Nack message if has no reply to.
• Logger - Context with logger.
• Recover - Recover worker from panic, nack message.
• Expire - Convert Message expiration to context with timeout.
• AckNack - Return middleware.Ack to ack message.