Imbi Common Library
Shared library for the Imbi ecosystem providing core data access, authentication primitives, and domain models.
Overview
imbi-common is a Python library that provides common functionality for all Imbi services including:
- Database Clients: Apache AGE/PostgreSQL (graph database) and ClickHouse (analytics database) with connection management
- Domain Models: Pydantic models for Projects, Organizations, Teams, Environments, ProjectTypes, and more
- Authentication: JWT token creation/verification, token encryption
- Configuration: Pydantic Settings-based configuration management with TOML file support
- Blueprint System: Dynamic schema extension system for runtime model customization
- Logging: Consistent logging configuration across all services
Services Using imbi-common
- imbi-api: Main API service for service management
- imbi-gateway: Webhook processing service
- imbi-mcp: Model Context Protocol server for Claude integration
Documentation
Full documentation is available at: https://aweber-imbi.github.io/imbi-common/
Development
Prerequisites
Setup
# Clone the repository
git clone https://github.com/AWeber-Imbi/imbi-common.git
cd imbi-common
# Install dependencies and pre-commit hooks
moon run root:setup
Running Tests
moon run common:test # The common library's test suite (requires Docker)
uv run --env-file .env.test pytest libraries/common/tests/<file> # Run a specific test file
Code Quality
moon run common:lint common:typecheck common:format # Run all linters + type check
uv run pre-commit run --all-files # Reformat code
License
BSD-3-Clause - See LICENSE file for details.
Authors
- Dave Shawley daves@aweber.com
- Gavin M. Roy gavinr@aweber.com
Contributing
Contributions are welcome! Please see CONTRIBUTING.md for guidelines.
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file imbi_common-2.21.0.tar.gz.
File metadata
- Download URL: imbi_common-2.21.0.tar.gz
- Upload date:
- Size: 183.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
913830ba26f1cf582e6102eae8d4fb64c008f3c11c33b6635bef1c9b10186f77
|
|
| MD5 |
6cfbea4c485122e35bb86dc52c4a0400
|
|
| BLAKE2b-256 |
b9624c1503f90a716900b7afbb2cc6db08b3dfaf138602641a070d6983020d07
|
Provenance
The following attestation bundles were made for imbi_common-2.21.0.tar.gz:
Publisher:
release.yml on AWeber-Imbi/imbi
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
imbi_common-2.21.0.tar.gz -
Subject digest:
913830ba26f1cf582e6102eae8d4fb64c008f3c11c33b6635bef1c9b10186f77 - Sigstore transparency entry: 2283688207
- Sigstore integration time:
-
Permalink:
AWeber-Imbi/imbi@bd1d2b3eb7d253c3a0fc41f0f90dcfc0006d237e -
Branch / Tag:
refs/tags/2.21.0 - Owner: https://github.com/AWeber-Imbi
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@bd1d2b3eb7d253c3a0fc41f0f90dcfc0006d237e -
Trigger Event:
push
-
Statement type:
File details
Details for the file imbi_common-2.21.0-py3-none-any.whl.
File metadata
- Download URL: imbi_common-2.21.0-py3-none-any.whl
- Upload date:
- Size: 126.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9416dd5ac6c44833028b14c3e3b658ff48492ecd5e8e2d7bcbb9bc31aa5c3469
|
|
| MD5 |
f6cb264d13e41b9766969b4f58adfe1a
|
|
| BLAKE2b-256 |
701943048e7edc4bda76cc4b9a1fe1c37ebb15244931589f4b55db6b576968c5
|
Provenance
The following attestation bundles were made for imbi_common-2.21.0-py3-none-any.whl:
Publisher:
release.yml on AWeber-Imbi/imbi
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
imbi_common-2.21.0-py3-none-any.whl -
Subject digest:
9416dd5ac6c44833028b14c3e3b658ff48492ecd5e8e2d7bcbb9bc31aa5c3469 - Sigstore transparency entry: 2283689967
- Sigstore integration time:
-
Permalink:
AWeber-Imbi/imbi@bd1d2b3eb7d253c3a0fc41f0f90dcfc0006d237e -
Branch / Tag:
refs/tags/2.21.0 - Owner: https://github.com/AWeber-Imbi
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@bd1d2b3eb7d253c3a0fc41f0f90dcfc0006d237e -
Trigger Event:
push
-
Statement type:
