A pub-sub client library for Multi-messenger Astrophysics
Project description
Hop Client
hop-client is a pub-sub client library for Multimessenger Astrophysics.
Quickstart
Publish a GCN to Kafka:
hop publish kafka://hostname:port/gcn mygcn.gcn3
Subscribe to the earliest offset of a Kafka topic and print to stdout:
hop subscribe kafka://hostname:port/gcn -e
An example RFC 822 formatted GCN circular (example.gcn3
) is provided in
tests/data
.
Client configuration
properties can be passed to hop publish
via -X property=value
or in a configuration
file specified by -F <config-file>
, mimicking the behavior of kafkacat
. This can be
used to connect to a Kafka broker with SSL authentication enabled, for example.
Installation
You can install hop either via pip, conda, or from source.
To install with pip:
pip install -U hop-client
To install with conda, you must use the channel from the SCiMMA Anaconda organization:
conda install --channel scimma hop-client
To install from source:
tar -xzf hop-client-x.y.z.tar.gz
cd hop-client-x.y.z
python setup.py install
Development
A Makefile is provided to ease in testing, deployment and generating documentation.
A list of commands can be listed with make help
.
In addition, two extras are provided when installing the scimma client that installs the required test and documentation libraries:
pip install -U hop-client[dev,docs]
To mark a new version, use Github tags to mark your commit with a semver version:
git tag v0.0.1
To release a new version and upload to package repositories, push your tag after pushing your commit:
git push --tags
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for hop_client-0.0.4a8-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1ecc1160e81ea6a5c7a80be83685a34b3ed706eec565ff25e08d984d9e0a3a0e |
|
MD5 | c791c367eafa4d20ff636127d50852f3 |
|
BLAKE2b-256 | 2d58c6e83e013324ff3bfab4c1f8a684e06973ff27b043c44423fbcd962400bc |