google-events

What it is and what it does

Google CloudEvents is a Python library that defines and provides classes for event types used across Google Cloud services. It wraps protobuf definitions from the Google CloudEvents repository, allowing developers to parse and work with event payloads in a type-safe manner. The library is designed primarily for use with Google Cloud Run services that receive event triggers, though it can be used anywhere CloudEvents need to be deserialized and handled.

The package depends on proto-plus and protobuf for its core functionality, translating protobuf message definitions into Python classes. It requires Python 3.7 or later and is distributed as a pure-Python wheel, making installation straightforward across platforms.

Use it for:

• Parse Cloud Storage events in Cloud Run services to react to bucket or object changes.
• Handle Pub/Sub message events received as CloudEvents in event-driven architectures.
• Deserialize and type-check event payloads from Google Cloud event sources in serverless functions.
• Build event routing logic that depends on structured event type definitions from Google services.
• Integrate with Cloud Audit Logs or other Google Cloud event streams in Python applications.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides Python classes for Google CloudEvents event types, enabling parsing and handling of event payloads from Google Cloud services.

Yes. The package is actively maintained, has low install friction, carries a permissive license, and solves a real problem for developers working with Google Cloud event-driven systems. No known vulnerabilities. Install it if you are building Cloud Run services or other Python applications that consume Google CloudEvents.

Install

google-events on PyPI

pip install google-events

uv add google-events

poetry add google-events

Installing google-events

Before you install

Low install friction with a pure-Python wheel distribution. Actively maintained as of June 2026, with regular releases since January 2021.

License in practice

Licensed under Apache License 2.0 (permissive), allowing use in most commercial and open-source projects without significant restrictions.

Quickstart

pip install google-events

from google.events.cloud import storage

def handle_event_trigger(json_payload):
    event = storage.StorageObjectData.from_json(json_payload)
    print(f"{event.bucket}/{event.name} had event")
    return "OK"

Requires Python 3.7 or later.

Verify before relying

• Whether the library covers all Google Cloud event types or only a subset of available services.
• Performance characteristics when parsing large or deeply nested event payloads.
• Backward compatibility guarantees across minor version updates.

Package facts

Evidence: google_events-0.14.0-py3-none-any.whl

Tags

More Internet packages