Bubble Api

Interactions with Bubble.io API in Python made easy !

Powered by Cuure   

---

Installing

The easiest way to install it is through pipy :

pip install bubble-api

How to use it

At the moment, there is no documentation for this library. You can, however, rely on the integration tests we use to ensure proper integration with Bubble. You can find them here.

Creating a BubbleClient instance :

from bubble_api import BubbleClient

bubble_client = BubbleClient(
    base_url="https://cuure.com",
    api_token="YOUR_API_TOKEN",
    bubble_version="live"
)

Interact with bubble data :

From the BubbleClient instance you can now interact with the data api easily.

object_data = bubble_client.get(
    "table_name",
    bubble_id="bubble_object_id",
)

And so on with all the basic interactions with the api: delete, update, replace, ...

You can also use constraints for getting or deleting objects. This is done through a list of Contraint object you can declare by operations with the Field class.

from bubble_api import BubbleClient, Field
from datetime import datetime

bubble_client = BubbleClient( ... )

constraints = [
    Field("name") == "Bob",
    Field("Created") > datetime(2023, 1, 1),
]

data = bubble_client.get(
    "table_name",
    constraints=constraints
)

All the fields names and constraints values formatting is handle by the library.

Incoming features

• Big request optimization using remaining approximation (exclude_remaining)
• Multithreading
• Default fields (Modified Date, unique id, Created Date, ...)
• Lifetime object management (update, refresh, replace)
• Documentation

Authors

• Dylan Nina - Initial work - settorac-nina
• Mathis Bourdin - Contributor - mathisbrdn

License

This project is licensed under the MIT License - see the LICENSE file for details