belfry_magicbell 1.2.1

Unofficial Python SDK for MagicBell

MagicBell-Python SDK

This SDK provides convenient access to the belfry_magicbell REST API from applications written in Python. It includes helpers for creating notifications, managing users, managing projects, and executing GraphQL.

---

This is an unofficial Python SDK for MagicBell open sourced with ❤️ by Noteable, a collaborative notebook platform that enables teams to use and visualize data, together.

Install | Getting Started | Examples | License | Code of Conduct | Contributing

Requirements

Python 3.8+

Installation

Poetry

poetry add belfry_magicbell

Then import the package:

import belfry_magicbell

Pip

pip install belfry_magicbell

Then import the package:

import belfry_magicbell

Getting Started

import belfry_magicbell
from belfry_magicbell.configuration import Configuration

config = Configuration(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
)
async with belfry_magicbell.belfry_magicbell(config) as mb:
    # Send a notification
    await mb.realtime.create_notification(
        belfry_magicbell.WrappedNotification(
            notification=belfry_magicbell.Notification(
                title="My first notification from python!",
                recipients=[belfry_magicbell.Recipient(email="[e-mail]")],
            )
        )
    )

Authentication

Most API calls require your belfry_magicbell project API Key and API Secret. Some API calls (i.e. projects) require your belfry_magicbell user JWT (enterprise only).

See the belfry_magicbell API documentation for more information.

Configuration

Configuration can be done explicitly using the belfry_magicbell.Configuration class, or implicitly by setting environment variables with the belfry_magicbell_ prefix.

Explicit Configuration

from belfry_magicbell.configuration import Configuration


# Create a configuration object with the required parameters
config = Configuration(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
)

Implicit Configuration

export MAGICBELL_API_KEY="YOUR_API_KEY"
export MAGICBELL_API_SECRET="YOUR_API_SECRET"

from belfry_magicbell.configuration import Configuration


config = Configuration()

Examples

For more examples see the examples directory.

Contributing

See CONTRIBUTING.md.

---

Open sourced with ❤️ by Noteable for the community.