Skip to main content

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

  • just — task runner
  • uv — Python package manager

Setup

# Clone the repository
git clone https://github.com/AWeber-Imbi/imbi-common.git
cd imbi-common

# Install dependencies and pre-commit hooks
just setup

Running Tests

just test           # Full test suite with coverage (requires Docker)
just test <file>    # Run specific test file(s)

Code Quality

just lint    # Run all linters
just format  # Reformat code

License

BSD-3-Clause - See LICENSE file for details.

Authors

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

imbi_common-2.11.6.tar.gz (361.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

imbi_common-2.11.6-py3-none-any.whl (118.9 kB view details)

Uploaded Python 3

File details

Details for the file imbi_common-2.11.6.tar.gz.

File metadata

  • Download URL: imbi_common-2.11.6.tar.gz
  • Upload date:
  • Size: 361.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for imbi_common-2.11.6.tar.gz
Algorithm Hash digest
SHA256 9e4e19c25eea2806a5eba4918ce7531bd6141bb5ce28120c715f7b7c179d1db4
MD5 003d7208ac01d9bdd810246c08a87a4b
BLAKE2b-256 b4b747482b39e8afd2ad8846dbaa655d18eb4d6928a75cbc6b25ba46e42da4f5

See more details on using hashes here.

Provenance

The following attestation bundles were made for imbi_common-2.11.6.tar.gz:

Publisher: publish.yml on AWeber-Imbi/imbi-common

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file imbi_common-2.11.6-py3-none-any.whl.

File metadata

  • Download URL: imbi_common-2.11.6-py3-none-any.whl
  • Upload date:
  • Size: 118.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for imbi_common-2.11.6-py3-none-any.whl
Algorithm Hash digest
SHA256 695613e0f7a5e3527ca82eb5a83877ade99f174c762dc88d4ce3b85444cfa63e
MD5 263386cff117acb1b8c6430d0a3258c4
BLAKE2b-256 4c288eeeaefbded201e57062af7b599f0dc1fdc0d2e5a60db93bfef054abc8cd

See more details on using hashes here.

Provenance

The following attestation bundles were made for imbi_common-2.11.6-py3-none-any.whl:

Publisher: publish.yml on AWeber-Imbi/imbi-common

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page