Skip to content

Latest commit

 

History

History
41 lines (25 loc) · 2.74 KB

README.md

File metadata and controls

41 lines (25 loc) · 2.74 KB

Google Cloud Events SDK for Dart

This Dart package provides developers with the tools necessary to easily interact with Google Cloud Events, facilitating the integration of Google Cloud services into Dart and Flutter applications. By abstracting the complexity of event handling, this SDK enables you to subscribe to, manage, and dispatch events from Google Cloud services with minimal effort.

Features

  • Serialize and Deserialize Cloud Events From Protobuf Format You can use this library with the Dart server framework of your choice in order to handle EventArc events in a Cloud Run instance.
  • TODO Should this repo should follow the SDK requirements so that it can be officially recognized?

Installation

Add google_cloud_events to your pubspec.yaml file:

dependencies:
  google_cloudevents_dart: ^1.0.0

Then, run pub get or flutter pub get to install the package.

Usage

For an example of using this package in a server application, see the example in this package.

Documentation

For detailed documentation on all features and functionalities, please visit the following documentation.

  1. What Are Cloud Events? Cloud Events Describes the specificiation that Google Cloud Events is derived from.
  2. How Google Implements Cloud Events: The Google Cloud Events Format (Detailed) Describes the packet
  3. How Does Google Send a Cloud Event? Protocol Buffers The way that Google serializes the data that it sends to cloud event recievers. Bonus The object/event definitions are contained in this folder in the google-cloudevents repository.
  4. How To Use Google Cloud Events (Triggers and Recievers of Cloud Events in Google Cloud Platform): Event Driven Architectures With Eventarc and Eventarc Overview. One way that Google makes it easier to register triggers and recievers for Cloud Events in Google Cloud Platform (GCP).
  5. How To Deploy An Eventarc Reciever Service To Cloud Run. For now the easiest way to write a reciever in Dart looks like Cloud Run.

License

This SDK is released under the MIT License.

Special Thanks

Special thanks to Very Good Ventures (VGV) for being leaders in Dart/Flutter development. We used the very_good_cli to help generate the boilerplate for this package. We also recommend trying dart_frog for developing your first dart server application.