Other tools

In addition to the MailerQ application, we have some tools and scripts that (may) come in handy for MailerQ users - and for others. The following tools are available:

• Mailerq-mimify: an application to turn JSON messages into MIME, to allow injection in JSON instead of MIME format.
• Mailerq-amqpinit: a tool to initialize exchanges, queues and bindings based on a JSON config file.
• Mailerq-httpcaller: an application that turns instructions read from RabbitMQ into HTTP POST calls.
• Mailerq-amqphttp: a middleware application to connect MailerQ with the above httpcaller.
• Mailerq-webhook: a setup script for the above three applications.

The amqpinit and httpcaller tools are generic: they can also be useful in a non-MailerQ environment.

Mailerq-mimify

Application to preprocess messages before they are picked up by MailerQ. This application converts JSON messages into RFC8822 complient MIME messages. This application is helpful if you want to specify your messages in JSON format instead of MIME format. You can put properties like the subject line, headers, actual content and attachments into the MIME message specification, which are then turned into a valid MIME messages that is then sent to MailerQ to be delivered.

Click here for more information about AmqpInit

Mailerq-amqpinit

This is a generic tool to create RabbitMQ queues and exchanges based on a JSON config file. It reads the input from the config file, and ensures that all the listed queues, exchanges and bindings are created. It can be useful in startup or initialization scripts to ensure that all your queues are correctly configured. Also useful as standalone application.

Click here for more information about AmqpInit

Mailerq-httpcaller

This is a generic tool for sending out HTTP POST calls. Based on JSON input from a RabbitMQ message queue, this application sends out HTTP POST calls. This is a generic standalone tool for many different use cases - not only in combination with MailerQ. The JSON messages in the queue should contain the URL to call, and the message body to post. It can also optionally hold extra headers and other properties for the outgoing HTTP calls.

Click here for more information about HttpCaller

Mailerq-amqphttp

This is a MailerQ specific middleware application that connects the results-queue from MailerQ with the input-queue of the MailerQ-httpcaller (see above). It converts MailerQ's result queue output into instructions that are compatible with the httpcaller. For example, it adds a URL property to the JSON, and the message body is formatted. This "amqphttp" tool takes care this:

• It reads messages from MailerQ's result queue.
• Based on its configuration, adds a URL and formats the POST fields.
• The updated message is published to httpcaller's input queue.

Click here for more information about AmqpHttp

Mailerq-webhook

A MailerQ specific setup script to simplify setting up a MailerQ webhook stack. Although you can configure a stack yourself using the above three tools, you can also leave it up to the mailerq-webhook script:

• It runs 'mailerq-amqpinit' to initialize all appropriate queues and exchanges.
• It starts 'mailerq-amqphttp' to read out MailerQ's result queue.
• It starts 'mailerq-httpcaller' to make the HTTP POST calls.

Click here for more information about WebHook