Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scimma-client-0.0.4.tar.gz (18.7 kB view details)

Uploaded Source

Built Distribution

scimma_client-0.0.4-py3-none-any.whl (6.6 kB view details)

Uploaded Python 3

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

Hashes for scimma-client-0.0.4.tar.gz
Algorithm Hash digest
SHA256 33c0a5173a6e14bc9625bcb30c969e4553b61872bb73d56d3a831cd567777e69
MD5 acf1dd6feafdee93ca2d2e1b8d21f89c
BLAKE2b-256 ac84b0d8f24721b928df87be4b251da4949115ace7e47ca3daad49ab46896e7b

See more details on using hashes here.

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

Hashes for scimma_client-0.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 e24f6b9244ccccbcef916d384e07d38d261752fc11eac21675338cc45abbcd6d
MD5 116d5dfbaabdb8e5a1a6060ecf654557
BLAKE2b-256 edbc80fb620d613b6dbddd2242e9c13e1b9886bd386e6c4e06305f3f4bf04cc6

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page