{"id":13432703,"url":"https://github.com/cloudevents/spec","last_synced_at":"2025-05-15T00:00:43.782Z","repository":{"id":37450944,"uuid":"113701924","full_name":"cloudevents/spec","owner":"cloudevents","description":"CloudEvents Specification","archived":false,"fork":false,"pushed_at":"2025-04-17T20:57:12.000Z","size":31926,"stargazers_count":5359,"open_issues_count":38,"forks_count":590,"subscribers_count":129,"default_branch":"main","last_synced_at":"2025-05-07T23:34:43.976Z","etag":null,"topics":["serverless","specification"],"latest_commit_sha":null,"homepage":"https://cloudevents.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloudevents.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":"docs/GOVERNANCE.md","roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-12-09T21:18:13.000Z","updated_at":"2025-05-07T11:57:31.000Z","dependencies_parsed_at":"2024-05-30T19:12:09.902Z","dependency_job_id":"baa8299b-0757-40e4-b89f-c1b6770cba31","html_url":"https://github.com/cloudevents/spec","commit_stats":{"total_commits":664,"total_committers":162,"mean_commits":4.098765432098766,"dds":0.7274096385542168,"last_synced_commit":"68902074ee868ea1d1a80e13005f37a96ecd445b"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudevents%2Fspec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudevents%2Fspec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudevents%2Fspec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudevents%2Fspec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudevents","download_url":"https://codeload.github.com/cloudevents/spec/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254249199,"owners_count":22039029,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["serverless","specification"],"created_at":"2024-07-31T02:01:15.500Z","updated_at":"2025-05-15T00:00:41.931Z","avatar_url":"https://github.com/cloudevents.png","language":"Python","readme":"# CloudEvents\n\n\u003c!-- no verify-specs --\u003e\n\n![CloudEvents logo](https://github.com/cncf/artwork/blob/main/projects/cloudevents/horizontal/color/cloudevents-horizontal-color.png?raw=true)\n\n[![CLOMonitor](https://img.shields.io/endpoint?url=https://clomonitor.io/api/projects/cncf/cloudevents/badge)](https://clomonitor.io/projects/cncf/cloudevents)\n[![OpenSSF Best Practices](https://bestpractices.coreinfrastructure.org/projects/6770/badge)](https://bestpractices.coreinfrastructure.org/projects/6770)\n\nEvents are everywhere. However, event producers tend to describe events\ndifferently.\n\nThe lack of a common way of describing events means developers must constantly\nre-learn how to consume events. This also limits the potential for libraries,\ntooling and infrastructure to aide the delivery of event data across\nenvironments, like SDKs, event routers or tracing systems. The portability and\nproductivity we can achieve from event data is hindered overall.\n\nCloudEvents is a specification for describing event data in common formats to\nprovide interoperability across services, platforms and systems.\n\nCloudEvents has received a large amount of industry interest, ranging from major\ncloud providers to popular SaaS companies. CloudEvents is hosted by the\n[Cloud Native Computing Foundation](https://cncf.io) (CNCF) and was approved as\na Cloud Native sandbox level project on\n[May 15, 2018](https://docs.google.com/presentation/d/1KNSv70fyTfSqUerCnccV7eEC_ynhLsm9A_kjnlmU_t0/edit#slide=id.g37acf52904_1_41), an\nincubator project on [Oct 24, 2019](https://github.com/cncf/toc/pull/297)\nand a graduated project on [Jan 25, 2024](https://github.com/cncf/toc/pull/996)\n([announcement](https://www.cncf.io/announcements/2024/01/25/cloud-native-computing-foundation-announces-the-graduation-of-cloudevents/)).\n\n## CloudEvents Documents\n\n|                               |                                 Latest Release                                  |                                      Working Draft                                       |\n| :---------------------------- | :-----------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------: |\n| **Core Specification:**       |\n| CloudEvents                   | [v1.0.2](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md)   | [WIP](cloudevents/spec.md) |\n|                               |\n| **Optional Specifications:**  |\n| AMQP Protocol Binding         | [v1.0.2](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/bindings/amqp-protocol-binding.md)  | [WIP](cloudevents/bindings/amqp-protocol-binding.md)       |\n| AVRO Event Format             | [v1.0.2](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/formats/avro-format.md)             | [WIP](cloudevents/formats/avro-format.md)                  |\n| AVRO Compact Event Format       | | [WIP](cloudevents/working-drafts/avro-compact-format.md)             |\n| HTTP Protocol Binding         | [v1.0.2](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/bindings/http-protocol-binding.md)  | [WIP](cloudevents/bindings/http-protocol-binding.md)       |\n| JSON Event Format             | [v1.0.2](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/formats/json-format.md)             | [WIP](cloudevents/formats/json-format.md)                  |\n| Kafka Protocol Binding        | [v1.0.2](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/bindings/kafka-protocol-binding.md) | [WIP](cloudevents/bindings/kafka-protocol-binding.md)      |\n| MQTT Protocol Binding         | [v1.0.2](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/bindings/mqtt-protocol-binding.md)  | [WIP](cloudevents/bindings/mqtt-protocol-binding.md)       |\n| NATS Protocol Binding         | [v1.0.2](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/bindings/nats-protocol-binding.md)  | [WIP](cloudevents/bindings/nats-protocol-binding.md)       |\n| WebSockets Protocol Binding   | -                                                                                                        | [WIP](cloudevents/bindings/websockets-protocol-binding.md) |\n| Protobuf Event Format         | [v1.0.2](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/formats/protobuf-format.md)         | [WIP](cloudevents/formats/protobuf-format.md)              |\n| XML Event Format              | -                                                                                                        | [WIP](cloudevents/working-drafts/xml-format.md)            |\n| Web hook                      | [v1.0.2](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/http-webhook.md)                    | [WIP](cloudevents/http-webhook.md)                         |\n|                               |\n| **Additional Documentation:** |\n| CloudEvents Primer                                             | [v1.0.2](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/primer.md) | [WIP](cloudevents/primer.md)                          |\n| [CloudEvents Adapters](cloudevents/adapters.md)                | -                                                                               | [Not versioned](cloudevents/adapters.md)              |\n| [CloudEvents SDK Requirements](cloudevents/SDK.md)             | -                                                                               | [Not versioned](cloudevents/SDK.md)                   |\n| [Documented Extensions](cloudevents/extensions/README.md)  | -                                                                               | [Not versioned](cloudevents/extensions/README.md) |\n| [Proprietary Specifications](cloudevents/proprietary-specs.md) | -                                                                               | [Not versioned](cloudevents/proprietary-specs.md)     |\n\n## Other Specifications\n|                 | Latest Release                                                  | Working Draft                 |\n| :-------------- | :-------------------------------------------------------------: | :---------------------------: |\n| CE SQL          | [v1.0.0](https://github.com/cloudevents/spec/tree/cesql/v1.0.0/cesql) | [WIP](cesql/spec.md)          |\n| Subscriptions   |                                 -                               | [WIP](subscriptions/spec.md)  |\n\nThe Registry and Pagination specifications can now be found in the\n[xRegistry/spec](https://github.com/xregistry/spec) repo.\n\nAdditional release related information:\n  [Historical releases and changelogs](docs/RELEASES.md)\n\nIf you are new to CloudEvents, it is recommended that you start by reading the\n[Primer](cloudevents/primer.md) for an overview of the specification's goals\nand design decisions, and then move on to the\n[core specification](cloudevents/spec.md).\n\nSince not all event producers generate CloudEvents by default, there is\ndocumentation describing the recommended process for adapting some popular\nevents into CloudEvents, see\n[CloudEvents Adapters](cloudevents/adapters.md).\n\n## SDKs\n\nIn addition to the documentation mentioned above, there are also a set of\nlanguage specific SDKs being developed:\n\n- [C#/.NET](https://github.com/cloudevents/sdk-csharp)\n- [Go](https://github.com/cloudevents/sdk-go)\n- [Java](https://github.com/cloudevents/sdk-java)\n- [Javascript](https://github.com/cloudevents/sdk-javascript)\n- [PHP](https://github.com/cloudevents/sdk-php)\n- [PowerShell](https://github.com/cloudevents/sdk-powershell)\n- [Python](https://github.com/cloudevents/sdk-python)\n- [Ruby](https://github.com/cloudevents/sdk-ruby)\n- [Rust](https://github.com/cloudevents/sdk-rust)\n\nThe [SDK requirements](cloudevents/SDK.md) document provides information\non how the SDKs are managed and what is expected of each one.\nThe SDK [feature support table](cloudevents/SDK.md#feature-support) is a\ngood resource to see which features, event formats and bindings are supported\nby each SDK.\n\nFor more information about how the SDKs operate, please see the following\ndocuments:\n- [SDK Governance](docs/SDK-GOVERNANCE.md)\n- [SDK Maintainer Guidlines](docs/SDK-maintainer-guidelines.md)\n- [SDK PR Guidlines](docs/SDK-PR-guidelines.md)\n\n## Community and Docs\n\nLearn more about the people and organizations who are creating a dynamic cloud\nnative ecosystem by making our systems interoperable with CloudEvents.\n\n- Our [Governance](docs/GOVERNANCE.md) documentation.\n- [Contributing](docs/CONTRIBUTING.md) guidance.\n- [Roadmap](docs/ROADMAP.md)\n- [Adopters](https://cloudevents.io/) - See \"Integrations\".\n- [Contributors](docs/contributors.md): people and organizations who helped\n  us get started or are actively working on the CloudEvents specification.\n- [Presentations, notes and other misc shared\n  docs](https://drive.google.com/drive/folders/1eKH-tVNV25jwkuBEoi3ESqvVjNRlJqYX?usp=sharing)\n- [Demos \u0026 open source](docs/README.md) -- if you have something to share\n  about your use of CloudEvents, please submit a PR!\n- [Code of Conduct](https://github.com/cncf/foundation/blob/master/code-of-conduct.md)\n\n### Security Concerns\n\nIf there is a security concern with one of the CloudEvents specifications, or\nwith one of the project's SDKs, please send an email to\n[cncf-cloudevents-security@lists.cncf.io](mailto:cncf-cloudevents-security@lists.cncf.io).\n\nA security assessment was performed by\n[Trail of Bits](https://www.trailofbits.com/) in October 2022. The report\ncan be found [here](docs/CE-SecurityAudit-2022-10.pdf) or on the Trail of Bits\n[website](https://github.com/trailofbits/publications/blob/master/reviews/CloudEvents.pdf).\n\n### Communications\n\nThe main mailing list for e-mail communications:\n\n- Send emails to: [cncf-cloudevents](mailto:cncf-cloudevents@lists.cncf.io)\n- To subscribe see: https://lists.cncf.io/g/cncf-cloudevents\n- Archives are at: https://lists.cncf.io/g/cncf-cloudevents/topics\n\nAnd a #cloudevents Slack channel under\n[CNCF's Slack workspace](http://slack.cncf.io/).\n\nFor SDK related comments and questions:\n\n- Email to: [cncf-cloudevents-sdk](mailto:cncf-cloudevents-sdk@lists.cncf.io)\n- To subscribe see: https://lists.cncf.io/g/cncf-cloudevents-sdk\n- Archives are at: https://lists.cncf.io/g/cncf-cloudevents-sdk/topics\n- Slack: #cloudeventssdk on [CNCF's Slack workspace](http://slack.cncf.io/)\n\nFor SDK specific communications, please see the main README in each\nSDK's github repo - see the [list of SDKs](#sdks).\n\n### Meeting Time\n\nSee the [CNCF public events calendar](https://www.cncf.io/community/calendar/).\nThis specification is being developed by the\n[CNCF Serverless Working Group](https://github.com/cncf/wg-serverless). This\nworking group meets every Thursday at 9AM PT (USA Pacific)\n([World Time Zone Converter](http://www.thetimezoneconverter.com/?t=9:00%20am\u0026tz=San%20Francisco\u0026)):\n\nPlease see the\n[meeting minutes doc](https://docs.google.com/document/d/1OVF68rpuPK5shIHILK9JOqlZBbfe91RNzQ7u_P7YCDE/edit#)\nfor the latest information on how to join the calls.\n\nRecording from our calls are available \n[here](https://www.youtube.com/playlist?list=PLO-qzjSpLN1BEyKjOVX_nMg7ziHXUYwec), and\nolder ones are\n[here](https://www.youtube.com/playlist?list=PLj6h78yzYM2Ph7YoBIgsZNW_RGJvNlFOt).\n\nPeriodically, the group may have in-person meetings that coincide with a major\nconference. Please see the\n[meeting minutes doc](https://docs.google.com/document/d/1OVF68rpuPK5shIHILK9JOqlZBbfe91RNzQ7u_P7YCDE/edit#)\nfor any future plans.\n","funding_links":[],"categories":["Python","Shell","serverless","Resources","Recently Updated","APIs","Serverless Platforms"],"sub_categories":["API Specification","[Feb 05, 2025](/content/2025/02/05/README.md)"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudevents%2Fspec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudevents%2Fspec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudevents%2Fspec/lists"}