https://github.com/marcelog/ebunny_pool

A rabbitmq worker pool
https://github.com/marcelog/ebunny_pool

Last synced: about 11 hours ago
JSON representation

A rabbitmq worker pool

• Host: GitHub
• URL: https://github.com/marcelog/ebunny_pool
• Owner: marcelog
• License: apache-2.0
• Created: 2014-06-20T16:31:01.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2015-02-20T14:54:30.000Z (almost 10 years ago)
• Last Synced: 2024-11-09T06:05:57.912Z (about 2 months ago)
• Language: Erlang
• Size: 305 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# ebunny_pool

This is a simple library that allows you to implement [rabbitmq](http://www.rabbitmq.com/)

workers. It will automatically declare the exchange and queue needed, and create

 a [DLX](https://www.rabbitmq.com/dlx.html) for it too, so failed tasks can be

 retried after the specified interval.

This is similar to [rabbitmq_minionpool](https://github.com/marcelog/rabbitmq_minionpool).

# How to use

Start the top level supervisor named **ebunny_pool_sup** from your own

supervisor tree. Create a module that implements the behavior **ebunny_pool_worker**:

```erlang

-module(sample_worker).

-behavior(ebunny_pool_worker).

-export([init/1, handle/3, terminate/2]).

-include_lib("amqp_client/include/amqp_client.hrl").

-record(state, {}).

init(Options) ->

  {ok, #state{}}. % You can return {ok, term()} | {error, term()}.

handle(

  DeliverInfo = #'basic.deliver'{

    consumer_tag = _ConsumerTag,

    delivery_tag = DeliveryTag,

    redelivered = _Redelivered,

    exchange = _Exchange,

    routing_key = _RoutingKey

  },

  Message = #amqp_msg{

    props = _Props,

    payload = Payload

  },

  State

) ->

  lager:debug("Got message: ~p", [Payload]),

  ok. % Return ok to ACK the message, or error to reject it and send it to the DLX.

terminate(_Reason, _State) ->

  ok.

```

To start a new consumer:

```erlang

ebunny_pool:new_consumer([

  {user, "guest"},

  {pass, "guest"},

  {vhost, "/"},

  {port, 5672},

  {host, "127.0.0.1"},

  {reconnect_timeout, 5000}, % If rabbitmq connection dies, try to reconnect every N milliseconds

  {exchange, "workers"}, % Name of the excuange. DLX Exchange will be the same ++ ".retry"

  {queue, "download"}, % Name of the queue. DLX Queue will be the same ++ ".retry"

  {retry_timeout, 10000}, % TTL For the DLX queue.

  {concurrency, 5}, % How many tasks to handle concurrently

  {callback, sample_worker}, % Callback module

  {callback_options, []} % Options sent to Callback:init/1

]).

```