A client library for SCiMMA
Project description
SCiMMA Client
scimma-client is a pub-sub client library for Multimessenger Astrophysics.
Quickstart
Publish a GCN to Kafka:
scimma publish -b kafka://hostname:port/gcn mygcn.gcn3
An example RFC 822 formatted GCN circular (example.gcn3
) is provided in
tests/data
.
Client configuration
properties can be passed to scimma 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 scimma-client either via pip, conda, or from source.
To install with pip:
pip install -U scimma-client
To install with conda, you must use the channel from the SCiMMA Anaconda organization:
conda install --channel scimma scimma-client
To install from source:
tar -xzf scimma-client-x.y.z.tar.gz
cd scimma-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 scimma-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
File details
Details for the file scimma-client-0.0.4.tar.gz
.
File metadata
- Download URL: scimma-client-0.0.4.tar.gz
- Upload date:
- Size: 18.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/40.6.2 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.6.10
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 33c0a5173a6e14bc9625bcb30c969e4553b61872bb73d56d3a831cd567777e69 |
|
MD5 | acf1dd6feafdee93ca2d2e1b8d21f89c |
|
BLAKE2b-256 | ac84b0d8f24721b928df87be4b251da4949115ace7e47ca3daad49ab46896e7b |
File details
Details for the file scimma_client-0.0.4-py3-none-any.whl
.
File metadata
- Download URL: scimma_client-0.0.4-py3-none-any.whl
- Upload date:
- Size: 6.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/40.6.2 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.6.10
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e24f6b9244ccccbcef916d384e07d38d261752fc11eac21675338cc45abbcd6d |
|
MD5 | 116d5dfbaabdb8e5a1a6060ecf654557 |
|
BLAKE2b-256 | edbc80fb620d613b6dbddd2242e9c13e1b9886bd386e6c4e06305f3f4bf04cc6 |