A simple python library for interacting with the ARGO Messaging Service
A simple python library for interacting with the ARGO Messaging Service.
The Messaging Services is implemented as a Publish/Subscribe Service. Instead of focusing on a single Messaging API specification for handling the logic of publishing/subscribing to the broker network the API focuses on creating nodes of Publishers and Subscribers as a Service.
In the Publish/Subscribe paradigm, Publishers are users/systems that can send messages to named-channels called Topics. Subscribers are users/systems that create Subscriptions to specific topics and receive messages.
You may find more information about the ARGO Messaging Service documentation
You may find and download the ARGO Messaging Library from ARGO Repository as well as from PyPI.
If you want the devel instance so as to test all new features
If you want the stable instance you may download it from here
PyPI package is available here:
The AMS library uses a valid AMS token to execute requests against the AMS cluster. This token can be provided with 2 ways:
- Obtain a valid ams token and then use it when initializing the ams object.
from argo_ams_library import ArgoMessagingService ams = ArgoMessagingService(endpoint="ams_endpoint", project="ams_project", token="your_ams_token")
- Use a valid certificate
from argo_ams_library import ArgoMessagingService ams = ArgoMessagingService(endpoint="ams_endpoint", project="ams_project", cert="/path/to/cert", key="/path/to/cert/key")
The library will use the provided certificate to access the corresponding ams token through the ARGO Authentication Service and then set the ams object's token field with the retrieved token.
In the folder examples, you may find examples of using the library:
- for publishing messages (
- for consuming messages in pull mode (
This example explains how to publish messages in a topic with the use of the library. Topics are resources that can hold messages. Publishers (users/systems) can create topics on demand and name them (Usually with names that make sense and express the class of messages delivered in the topic). A topic name must be scoped to a project.
You may find more information about Topics in the ARGO Messaging Service documentation
publish.py --host=[the FQDN of AMS Service] --token=[the user token] --project=[the name of your project registered in AMS Service] --topic=[the topic to publish your messages]
Consume messages in pull mode
This example explains how to consume messages from a predefined subscription with the use of the library. A subscription is a named resource representing the stream of messages from a single, specific topic, to be delivered to the subscribing application. A subscription name must be scoped to a project. In pull delivery, your subscriber application initiates requests to the Pub/Sub server to retrieve messages. When you create a subscription, the system establishes a sync point. That is, your subscriber is guaranteed to receive any message published after this point. Messages published before the sync point may not be delivered.
You may find more information about Subscriptions in the ARGO Messaging Service documentation
consume-pull.py --host=[the FQDN of AMS Service] --token=[the user token] --project=[the name of your project registered in AMS Service] --topic=[the topic from where the messages are delivered ] --subscription=[the subscription name to pull the messages] --nummsgs=[the num of messages to consume]
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size argo-ams-library-0.5.0.tar.gz (17.5 kB)||File type Source||Python version None||Upload date||Hashes View|