No project description provided
Project description
Rulebricks – Python SDK
Documentation
API reference documentation is available here.
Installation
Add this dependency to your project's build file:
pip install rulebricks
# or
poetry add rulebricks
Configuration
Before using the SDK, configure your API key. You can find your API key in your Rulebricks Dashboard.
import rulebricks as rb
# Replace 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX' with your actual API key
rb.set_api_key("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")
Basic Usage
Use the SDK to interact with the Rulebricks API in a synchronous manner is incredibly simple.
Here's an example of how to use the SDK to solve a rule:
import rulebricks as rb
# Set the API key
rb.set_api_key("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")
result = rb.rules.solve(
slug="tJOCd8XXXX",
request={
"customer_id": "anc39as3",
"purchase_history": ["t-shirt", "mug"],
"account_age_days": 4,
"last_purchase_days_ago": 3,
"email_subscription": False
}
)
print(result)
Asynchronous Usage
For asynchronous API calls, access methods via the async_api attribute.
This allows you to leverage Python's asyncio library for non-blocking operations:
import rulebricks as rb
import asyncio
# Set the API key
rb.set_api_key("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")
async def main():
async_result = await rb.async_api.rules.solve(
slug="tJOCd8XXXX",
request={
"customer_id": "anc39as3",
"purchase_history": ["t-shirt", "mug"],
"account_age_days": 4,
"last_purchase_days_ago": 3,
"email_subscription": False
}
)
print(async_result)
if __name__ == "__main__":
asyncio.run(main())
Beta status
This SDK is in beta, and there may be breaking changes between versions without a major version update. Therefore, we recommend pinning the package version to a specific version in your pyproject.toml file. This way, you can install the same version each time without breaking changes unless you are intentionally looking for the latest version.
Feedback and Contributions
Feedback is vital as we continue to improve the SDK and add more features. Please report any issues or suggest improvements through our GitHub issues page. Contributions to the SDK are welcome via pull requests.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for rulebricks-0.0.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e4ca029c8ac79f3bd926d10d48dca229f5b32952377ff07ef476223df15bf1f5 |
|
MD5 | ac9f67e0264a7ecfd259cec3431e5d15 |
|
BLAKE2b-256 | 55fbba0fab6a19e66ce10857feca13bc9a3bfd85903ef8951ad99ba1598c4432 |