bedrock

bedrock is the runtime core of the Bedrock modular framework.

It provides manifest-driven module loading, lifecycle management, and first-party contrib modules for common capabilities.

Status

The core runtime is fully implemented and functional.

This package contains production-ready subsystems:

• Module registry with dependency resolution and lifecycle hooks
• Dependency injection container with singleton/transient/scoped lifetimes
• Hook system for structured call/response extension points (sync, async, robust)
• SQLAlchemy 2.0 database layer with Alembic migrations
• Cache system with memory and Redis backends
• Signal/event system (blinker-derived)
• Typer-based CLI for module and database management
• Comprehensive utility library (lazy loading, introspection, string helpers)

Installation

# With uv (recommended)
uv add bedrock-core

# With poetry
poetry add bedrock-core

# With pip
pip install bedrock-core

Quick Start

import bedrock

# Initialize the runtime (discovers and loads modules)
bedrock.setup()

# Access key singletons
from bedrock.module import apps          # ModuleRegistry
from bedrock.database import db          # DatabaseManager
from bedrock.contrib.cache import cache  # CacheService

Key Singletons

Module Structure

my_app/
├── __init__.py
├── manifest.yaml    # Module identity and dependencies
├── models.py        # SQLAlchemy models (optional)
├── entities.py      # Pydantic models for validation
├── service.py       # Business logic
├── exc.py           # Module exceptions
└── bootstrap.py     # Lifecycle hooks

Architecture

Bedrock is framework-agnostic by design. The core runtime has no HTTP dependencies and is usable in:

• API servers (FastAPI, Flask, etc.)
• Background workers (Celery, etc.)
• CLI tools
• Scripts and automation

For more details, see the documentation.