Description

This package contains the RabbitMQ implementation of the Input-/OutputPortPlugin interface of pypz. It enables the operators to send and receive data records through queues allowing load sharing.

Check the documentation for more details.

Install

The python artifact is hosted on https://pypi.org/, so you can install it via pip:

pip install pypz-rmq-io

If you want to work on it locally, then you should install in editable mode:

pip install -e ./plugins/rmq_io

Test

You can run tests against an existing RabbitMQ cluster, however, it is more convenient and safe to use a local test cluster.

1. Run the official image to start a local cluster

docker run -d --rm --name rabbitmq --hostname test -p 15672:15672 -p 5672:5672 rabbitmq:3-management

2. Install the subproject in editable more.

pip install -e ./plugins/rmq_io

3. To run the tests locally, you need to execute the following command:

python -m unittest discover .\plugins\rmq_io\test\ -p "*.py"

4. Delete cluster

docker stop rabbitmq

Build

Before you build, you will need to install the "build" package:

pip install build

Optionally, you might want to set a version for local testing. Using setuptools-scm, you can pretend a version via setting the following environment variable:

# Powershell
$env:SETUPTOOLS_SCM_PRETEND_VERSION_FOR_PYPZ_RMQ_IO="v1.2.3"

# Linux
export SETUPTOOLS_SCM_PRETEND_VERSION_FOR_PYPZ_RMQ_IO="v1.2.3"

Then from the subproject's root, you will need to execute the following command:

python -m build

It will create the source distribution and the wheel file in the "dist" folder.