Archived

(mirror of) ZMQ based microservice communications library

asyncio microservice python zmq

This repository has been archived on 2026-02-19. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.

Python 100%

Find a file

Rodrigo Oliveira 1c000f2edc Update README.md		2021-09-01 11:37:56 -03:00
examples	Update examples	2021-08-30 15:10:58 -03:00
jackplug	Use asyncio instead of ioloop (tornado) as event loop	2021-08-30 15:10:58 -03:00
.gitignore	Add set_logger method on JackBase and PlugBase	2020-10-09 12:58:35 -03:00
.pre-commit-config.yaml	Use code style tools	2020-10-09 12:58:37 -03:00
pyproject.toml	Use code style tools	2020-10-09 12:58:37 -03:00
README.md	Update README.md	2021-09-01 11:37:56 -03:00
requirements.development.txt	Update requirements and remove tornado as dependency	2021-08-30 15:12:09 -03:00
requirements.txt	Update requirements and remove tornado as dependency	2021-08-30 15:12:09 -03:00
setup.py	Bump version	2021-08-30 15:12:32 -03:00

README.md

JackPlug

ZMQ based microservice communications library

Two transports are supported: ipc (though IPCEndpoint, using the following path as default: /tmp/jack.plug), and tcp (TCPEndpoint, using 3559 as the default port number).

Requirements

pyzmq >= 19.0.2

Development requirements:

python 3.8
pyenv 1.2.20 (optional)

Installation instructions for development:

Install pyenv (optional):
- macos:
```
  $ brew install pyenv
```
- linux:
  - Install pyenv from your package manager, or follow these instructions

Create a new python virtualenv (optional):

  $ pyenv install 3.8.5
  $ pyenv virtualenv 3.8.5 jackplug
  $ pyenv activate jackplug

Install python requirements:
```
  $ pip install -r requirements.txt
```

Examples

An example of the use of this library can be found on the examples folder, and running them is pretty straightforward:

Run examples/jack.py and examples/plug.py, in different terminals. You should set the same transport argument on both of them (ipc or tcp).

$ python examples/jack.py ipc

$ python examples/plug.py ipc