sabu-chassis

sabu-chassis is a shared Sabu library that provides reusable utilities for multiple services.

It is designed for cross-cutting concerns that should be imported directly by services (for example: logging setup and shared runtime conventions), instead of being exposed as a standalone service.

Why this package exists

In Sabu, some capabilities are best delivered as code dependencies rather than API calls.

Using sabu-chassis as a dependency makes it easier to:

• Reuse the same behavior across services.
• Keep service internals consistent.
• Ship functionality (not inter-service data exchange) in a versioned Python package.

Current scope

At the moment, the primary implemented utility is logging configuration.

The logging setup is currently tuned for one service context. As the microservices chassis effort progresses, this will be normalized so all Sabu services can use a common logging standard in later versions.

Installation

Dockerizing and using in services independently

pip install sabu-chassis

Installing as a dependency (e.g., inside Dockerized services)

cd libs/sabu_chassis
pip install .

Developing locally (cloning the repository)

from sabu_chassis.logging import configure_logging, get_logger, set_request_id

configure_logging()
set_request_id('req-123')

logger = get_logger(__name__)
logger.info('service_started')

Libraries should use get_logger(__name__) and leave configure_logging() to the application or workflow entry point.

Optional environment variables commonly used by the logging module include:

• LOG_LEVEL
• WERKZEUG_LEVEL
• LOG_SERVICE
• LOG_ENV
• LOG_DIR_BASE

Sabu

Sabu is a sector-based carbon-emission evaluation framework built with a microservices architecture.

Each module runs as an independent service. Current services focus on building life-cycle assessment and city-scale geospatial cleaning/validation workflows. Alongside services, Sabu also includes shared Python libraries such as sabu-chassis to provide reusable internal functionality.

Roadmap note

sabu-chassis will continue to grow as a shared library for Sabu services, with future versions expanding beyond logging into additional standardized service utilities.