No project description provided
Project description
Python SDK for CloudEvents
Status
This SDK is still considered a work in progress, therefore things might (and will) break with every update.
This SDK current supports the following versions of CloudEvents:
- v1.0
- v0.3
Python SDK
Package cloudevents provides primitives to work with CloudEvents specification: https://github.com/cloudevents/spec.
Sending CloudEvents
Below we will provide samples on how to send cloudevents using the popular
requests
library.
Binary HTTP CloudEvent
from cloudevents.http import CloudEvent, to_binary_http
import requests
# This data defines a binary cloudevent
attributes = {
"type": "com.example.sampletype1",
"source": "https://example.com/event-producer",
}
data = {"message": "Hello World!"}
event = CloudEvent(attributes, data)
headers, body = to_binary_http(event)
# POST
requests.post("<some-url>", data=body, headers=headers)
Structured HTTP CloudEvent
from cloudevents.http import CloudEvent, to_structured_http
import requests
# This data defines a structured cloudevent
attributes = {
"type": "com.example.sampletype2",
"source": "https://example.com/event-producer",
}
data = {"message": "Hello World!"}
event = CloudEvent(attributes, data)
headers, body = to_structured_http(event)
# POST
requests.post("<some-url>", data=body, headers=headers)
You can find a complete example of turning a CloudEvent into a HTTP request in the samples directory.
Request to CloudEvent
The code below shows how to consume a cloudevent using the popular python web framework flask:
from flask import Flask, request
from cloudevents.http import from_http
app = Flask(__name__)
# create an endpoint at http://localhost:/3000/
@app.route("/", methods=["POST"])
def home():
# create a CloudEvent
event = from_http(request.get_data(), request.headers)
# you can access cloudevent fields as seen below
print(
f"Found {event['id']} from {event['source']} with type "
f"{event['type']} and specversion {event['specversion']}"
)
return "", 204
if __name__ == "__main__":
app.run(port=3000)
You can find a complete example of turning a CloudEvent into a HTTP request in the samples directory.
SDK versioning
The goal of this package is to provide support for all released versions of CloudEvents, ideally while maintaining the same API. It will use semantic versioning with following rules:
- MAJOR version increments when backwards incompatible changes is introduced.
- MINOR version increments when backwards compatible feature is introduced INCLUDING support for new CloudEvents version.
- PATCH version increments when a backwards compatible bug fix is introduced.
Community
- There are bi-weekly calls immediately following the Serverless/CloudEvents call at 9am PT (US Pacific). Which means they will typically start at 10am PT, but if the other call ends early then the SDK call will start early as well. See the CloudEvents meeting minutes to determine which week will have the call.
- Slack: #cloudeventssdk channel under CNCF's Slack workspace.
- Email: https://lists.cncf.io/g/cncf-cloudevents-sdk
- Contact for additional information: Denis Makogon (
@denysmakogon
on slack).
Maintenance
We use black and isort for autoformatting. We setup a tox environment to reformat the codebase.
e.g.
pip install tox
tox -e reformat
For information on releasing version bumps see RELEASING.md
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
Built Distribution
File details
Details for the file cumason123-cloudevents-1.1.8.tar.gz
.
File metadata
- Download URL: cumason123-cloudevents-1.1.8.tar.gz
- Upload date:
- Size: 7.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d969db6c2031250f99ceee16354fe9e59e805cbcfe1e64c43b8a7be9355751f9 |
|
MD5 | 6678225b105902228b79048afcd9bb0a |
|
BLAKE2b-256 | 98c4cdf39930bf86759ba555a7ed77df648063f84b86da9c21447e81370fe987 |
File details
Details for the file cumason123_cloudevents-1.1.8-py3-none-any.whl
.
File metadata
- Download URL: cumason123_cloudevents-1.1.8-py3-none-any.whl
- Upload date:
- Size: 14.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 43b8c8c04733a2404a5e8945b2b36bf5c98d45e8ba63bf074711336c5317c621 |
|
MD5 | 313c0b1cc030237d0dea8e45247962a9 |
|
BLAKE2b-256 | 9ee8b3c2cea4c971b960da1b56d755299e7e276e3f8737731196bdb36de8a38d |