Use the Python Pulsar client with Astra Streaming

You can use the Python Pulsar client with Astra Streaming to produce and consume messages.

For a complete source code example, see the Astra Streaming Examples repository.

Prerequisites

A supported Python version:
- For Linux, versions 3.4 to 3.7 are supported
- For macOS, version 3.7 is supported
An Apache Pulsar™ topic in Astra Streaming
A text editor or IDE

Create a project

Create a folder for a new Python project.

In your new directory, install the Pulsar client library with pip:

mkdir SimpleProducerConsumer && cd SimpleProducerConsumer

touch index.py

pip install pulsar-client==2.10

Write the script

Create an index.py file containing the following code. This code creates a Pulsar client instance with the topic URL and token authentication.

index.py

import pulsar
import time

serviceUrl = "<REPLACE_WITH_SERVICE_URL>";
pulsarToken = "<REPLACE_WITH_PULSAR_TOKEN>";

tenantName = "<REPLACE_WITH_TENANT_NAME>";
namespace = "<REPLACE_WITH_NAMESPACE>";
topicName = "<REPLACE_WITH_TOPIC>";

topic = "persistent://{0}/{1}/{2}".format(tenantName, namespace, topicName)

client = pulsar.Client(serviceUrl, authentication=pulsar.AuthenticationToken(pulsarToken))

This script is intentionally incomplete. Your IDE might show errors until you complete the next steps.

Provide values for the following variables:

Parameter Definition Where to find the value

Parameter	Definition	Where to find the value
`serviceUrl`	The URL to connect to the Pulsar cluster	In the Astra Portal header, click Applications, and then select Streaming. Click the name of your tenant, and then click the Connect tab. In the Tenant Details section, get the Broker Service URL.
`pulsarToken`	The token for Pulsar cluster authentication	For information about creating Pulsar tokens, see Manage tokens.
`tenantName`	The name of your streaming tenant	In the Astra Portal header, click Applications, and then select Streaming. Get the tenant name from the Astra Streaming dashboard.
`namespace`	The segmented area for certain topics in your streaming tenant	In the Astra Portal header, click Applications, and then select Streaming. Click the name of your tenant, and then click the Namespace and Topics tab. Choose the target namespace from the list of namespaces.
`topicName`	Topic name (not the full name)	In the Astra Portal header, click Applications, and then select Streaming. Click the name of your tenant, and then click the Namespace and Topics tab. Expand the target namespace in the list of namespaces to view the names of the topics within. Do not use the Full Name.

serviceUrl

The URL to connect to the Pulsar cluster

In the Astra Portal header, click Applications, and then select Streaming.
Click the name of your tenant, and then click the Connect tab.
In the Tenant Details section, get the Broker Service URL.

pulsarToken

The token for Pulsar cluster authentication

For information about creating Pulsar tokens, see Manage tokens.

tenantName

The name of your streaming tenant

In the Astra Portal header, click Applications, and then select Streaming.
Get the tenant name from the Astra Streaming dashboard.

namespace

The segmented area for certain topics in your streaming tenant

In the Astra Portal header, click Applications, and then select Streaming.
Click the name of your tenant, and then click the Namespace and Topics tab.
Choose the target namespace from the list of namespaces.

topicName

Topic name (not the full name)

In the Astra Portal header, click Applications, and then select Streaming.
Click the name of your tenant, and then click the Namespace and Topics tab.
Expand the target namespace in the list of namespaces to view the names of the topics within. Do not use the Full Name.

Use the client to create a producer:
index.py
```
producer = client.create_producer(topic)
```

Send a message:

index.py

producer.send('Hello World'.encode('utf-8'))

Use the Python client instance to create a consumer subscription to the same topic that you sent a message to:
index.py
```
consumer = client.subscribe(topic, 'my-subscription')
```

Iterate through messages and write their data:

index.py

waitingForMsg = True
while waitingForMsg:
    try:
        msg = consumer.receive(2000)
        print("Received message '{}' id='{}'".format(msg.data(), msg.message_id()))

        # Acknowledging the message to remove from message backlog
        consumer.acknowledge(msg)

        waitingForMsg = False
    except:
        print("Still waiting for a message...");

    time.sleep(1)

Clean up:
```
client.close()
```

Run the script

In your Python project directory, run the script:

python3 index.py

The output includes a lot of logs. Received message confirms that the script succeeded:

Received message 'Hello World' id='(422529,5,-1,0)'

Use the Python Pulsar client with Astra Streaming

Prerequisites

Create a project

Write the script

Run the script

Next steps

Was this helpful?

Give Feedback