rtecommon 3.0.0

Common tools/utilities/configurations used in the RealTime Events echo system.

RealTimeEvents Common

Category	Status' and Links
General
CD/CI

Shared tools, logging helpers, and configuration utilities for the RealTime Events ecosystem.

---

Short Description

rtecommon centralises reusable project infrastructure so RealTime Events services can share configuration, environment handling, and logging behaviour from one maintained package.

---

Module Overview

Key Features

• Shared configuration helpers for environment-driven application settings.
• Environment-backed settings models exposed from rtecommon.configs.settings for repo and runtime metadata.
• Common logging utilities with setup_logging, named logger access, and masked environment setting logging.
• Packaging and developer tooling aligned for Python 3.10 through 3.14.
• Repository bootstrap scripts for local Python, React, GitHub access, and private package access setup.
• Centralised test coverage for common helpers under tests/unit/.

Project Structure

• src/rtecommon/: Core shared Python modules.
• src/rtecommon/configs/settings.py: Shared environment-backed settings models loaded from the repo .env file.
• src/rtecommon/logging/: Shared logging configuration, formatters, and helper functions.
• tests/unit/: Unit tests for reusable modules.
• tasks/: Working task notes and repository lessons for Codex-assisted changes.
• Root setup scripts: InstallDevEnv.ps1, InstallPy.ps1, InstallReact.ps1, install_react.sh, SetupDotEnv.ps1, SetupGitHubAccess.ps1, and SetupPrivateRepoAccess.ps1.
• ReleaseNotes.md: Published branch-to-release change summaries.
• legacy/: Archived material excluded from normal test runs.

---

Tooling Scripts

• InstallDevEnv.ps1: Validates the supported Python range and prepares the local development toolchain.
• InstallPy.ps1: Installs or updates the local Python runtime on Windows when required for the repo.
• InstallReact.ps1 and install_react.sh: Bootstrap the React toolchain on Windows or shell-based environments.
• SetupDotEnv.ps1: Regenerates the repository .env file from the maintained template.
• SetupGitHubAccess.ps1 and SetupPrivateRepoAccess.ps1: Configure repository and package access for local work.

---

Getting Started

1. Run poetry install.
2. Create the repo .env via SetupDotEnv.ps1.
3. Set or verify PROJECT_NAME, PROJECT_DIR, and VENV_ENVIRONMENT in the generated .env before running code that imports rtecommon.configs.settings.
4. Optionally run InstallDevEnv.ps1 to validate the interpreter version and prepare the local toolchain.
5. Use InstallPy.ps1, InstallReact.ps1, or install_react.sh when the local environment still needs language or frontend tooling support.
6. Import rtecommon from a consuming service and configure logging with setup_logging.
7. Run the active test suite with poetry run pytest.

---

Usage

from rtecommon.configs.settings import env_settings
from rtecommon.logging import get_named_loggers
from rtecommon.logging import log_environment_settings
from rtecommon.logging import setup_logging

log_path = setup_logging(
    log_backup_count=7,
    log_dir="logs",
    log_level_console="INFO",
    log_level_file="DEBUG",
    service_name="rtecommon",
)

log_all, log_console, log_file = get_named_loggers()
log_environment_settings(
    {
        "PROJECT_NAME": env_settings.PROJECT_NAME,
        "SERVICE_NAME": "rtecommon",
        "VENV_ENVIRONMENT": env_settings.VENV_ENVIRONMENT,
    }
)

---

Release Notes Workflow

1. Commit the intended branch changes.
2. Compare the current branch against master.
3. Prepend a new section to ReleaseNotes.md without changing older entries.
4. Group the changes under clear headings and end the new entry with the divider line.
5. Publish the release branch and PR through the normal repository workflow.

---