bitranox-template-py-cli 2.1.1__tar.gz → 2.1.3__tar.gz

{bitranox_template_py_cli-2.1.1 → bitranox_template_py_cli-2.1.3}/CHANGELOG.md

@@ -6,6 +6,35 @@ the [Keep a Changelog](https://keepachangelog.com/) format.
 
 ## [Unreleased]
 
+## [2.1.3] 2026-10-08 11:57:40
+
+### Fixed
+- **`config --profile NAME` refuses an invalid logging setting like `config` does.** The
+  subcommand's `--profile` reloads the configuration after logging has started, and that reload
+  skipped the logging settings, so a `[lib_log_rich]` value or `LOG_*` variable that makes plain
+  `config` exit 78 was displayed with exit 0. The reload now restarts logging with the reloaded
+  configuration, which refuses exactly what plain `config` refuses (a scrub pattern, a console
+  format preset or style key and a level name included) with the same `Error:` lines, also for a
+  `[lib_log_rich]` section that is invalid only in that profile's own file; the rest of the
+  command then logs with the profile's settings. New `RestartLogging` port
+  (`AppServices.restart_logging`; the testing composition's double keeps its quiet runtime).
+
+## [2.1.2] 2026-10-08 09:43:32
+
+### Changed
+- **A refused attachment exits 77, not 1 with a traceback (exit code change).** An attachment
+  btx_lib_mail's security checks refuse (a blocked extension such as `.exe`, a file under a
+  blocked directory, a symlink, a file over the size limit) made `send-email` exit 1 with
+  `Error: Unexpected error - Attachment security violation (...)` and log the refusal with a
+  traceback, as if the program had crashed. Since btx_lib_mail 4.0.0 every blocked extension is
+  refused on every platform, so this is an ordinary outcome on Linux and macOS too. It now exits
+  77 (`ExitCode.ATTACHMENT_REFUSED`, sysexits `EX_NOPERM`: not permitted by policy) with one
+  line, `Error: Attachment refused by security policy - <the library's reason>`, logs no
+  traceback, and delivers nothing. A script that checks for 1 after a refused attachment must
+  check for 77. With `email.attachments.raise_on_security_violation = false` the attachment is
+  still skipped with a warning and the message sent, as before; a violation that names no attachment
+  left to drop is refused in warn mode too, and now exits 77 where it exited 1.
+
 ## [2.1.1] 2026-10-06 18:13:05
 
 ### Fixed

{bitranox_template_py_cli-2.1.1 → bitranox_template_py_cli-2.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: bitranox_template_py_cli
-Version: 2.1.1
+Version: 2.1.3
 Summary: Template CLI application with configuration management and structured logging
 Project-URL: Homepage, https://github.com/bitranox/bitranox_template_py_cli
 Project-URL: Repository, https://github.com/bitranox/bitranox_template_py_cli.git
@@ -26,7 +26,7 @@ Requires-Dist: click>=8.5.0
 Requires-Dist: lib-cli-exit-tools>=2.4.0
 Requires-Dist: lib-layered-config>=7.0.1
 Requires-Dist: lib-log-rich>=6.3.9
-Requires-Dist: orjson>=3.12.0
+Requires-Dist: orjson>=3.13.0
 Requires-Dist: pydantic>=2.13.5
 Requires-Dist: python-dotenv>=1.2.4
 Requires-Dist: rich-click>=1.9.9

{bitranox_template_py_cli-2.1.1 → bitranox_template_py_cli-2.1.3}/docs/systemdesign/module_reference.md

@@ -26,14 +26,14 @@ moves or removes a module, a CLI option or a public name.
 - `src/bitranox_template_py_cli/adapters/email/transport.py`  -  `send_email` / `send_notification` over btx_lib_mail
 - `src/bitranox_template_py_cli/adapters/email/sender.py`  -  Re-exports of `config.py` and `transport.py`
 - `src/bitranox_template_py_cli/adapters/email/validation.py`  -  Email recipient validation
-- `src/bitranox_template_py_cli/adapters/logging/setup.py`  -  lib_log_rich initialization; takes only the `LOG_*` lines of a `.env`, and raises `InvalidLoggingConfigError` for a refused `[lib_log_rich]` value or `LOG_*` variable, after starting logging with its defaults (and without the `LOG_*` variables only when one of them is refused)
+- `src/bitranox_template_py_cli/adapters/logging/setup.py`  -  lib_log_rich initialization; takes only the `LOG_*` lines of a `.env`, and raises `InvalidLoggingConfigError` for a refused `[lib_log_rich]` value or `LOG_*` variable, after starting logging with its defaults (and without the `LOG_*` variables only when one of them is refused); `restart_logging` shuts the running runtime down and starts it again with another configuration
 - `src/bitranox_template_py_cli/adapters/cli/`  -  CLI adapter package:
   - `__init__.py`  -  Public facade
   - `constants.py`  -  Shared constants
   - `safe_console.py`  -  Encode-safe terminal output; use `safe_console.echo` instead of `click.echo`
   - `exit_codes.py`  -  POSIX exit codes (ExitCode IntEnum)
   - `context.py`  -  Click context helpers
-  - `config_load.py`  -  Configuration load for the CLI; records a load failure, `require_config` refuses with exit 78
+  - `config_load.py`  -  Configuration load for the CLI; records a load failure, `require_config` refuses with exit 78, `restart_logging` restarts logging with a configuration reloaded by `config --profile`, refusing its logging settings as the root does
   - `root.py`  -  Root command group
   - `main.py`  -  Entry point
   - `typed_click.py`  -  Strictly typed wrappers for rich_click's `option`, `version_option` and `get_current_context`
@@ -70,6 +70,7 @@ moves or removes a module, a CLI option or a public name.
 - `tests/conftest.py`  -  Shared fixtures (see Test Fixtures below)
 - `tests/test_behaviors.py`  -  Domain function tests
 - `tests/test_cache_effectiveness.py`  -  Configuration loading returns consistent (cached) results
+- `tests/test_cli_attachment_refused.py`  -  An attachment btx_lib_mail's security checks refuse exits 77 with one `Error:` line, nothing delivered
 - `tests/test_cli_config.py`  -  `config`, `config-deploy`, `config-generate-examples` commands
 - `tests/test_cli_config_errors.py`  -  A configuration that cannot be loaded: who reports it, and who still runs
 - `tests/test_cli_core.py`  -  Traceback, main entry, help, hello, fail, info, unknown command
@@ -136,19 +137,20 @@ Run `lint-imports` to verify compliance.
 
 POSIX-conventional exit codes defined in `adapters/cli/exit_codes.py`:
 
-| Code | Name                | Usage                                                                                                                  |
-|------|---------------------|------------------------------------------------------------------------------------------------------------------------|
-| 0    | `SUCCESS`           | Command completed successfully                                                                                         |
-| 1    | `GENERAL_ERROR`     | Unhandled exception, general failure                                                                                   |
-| 2    | `FILE_NOT_FOUND`    | Attachment or file not found; also click's usage error (bad option value, malformed `--set`, invalid `--profile` name) |
-| 13   | `PERMISSION_DENIED` | Cannot write to target directory                                                                                       |
-| 22   | `INVALID_ARGUMENT`  | Invalid CLI argument or section not found                                                                              |
-| 69   | `SMTP_FAILURE`      | SMTP delivery failed                                                                                                   |
-| 78   | `CONFIG_ERROR`      | Configuration missing, not loadable or invalid                                                                         |
-| 110  | `TIMEOUT`           | Operation timed out                                                                                                    |
-| 130  | `SIGNAL_INT`        | Interrupted (SIGINT/Ctrl+C)                                                                                            |
-| 141  | `BROKEN_PIPE`       | Output pipe closed                                                                                                     |
-| 143  | `SIGNAL_TERM`       | Terminated (SIGTERM)                                                                                                   |
+| Code | Name                 | Usage                                                                                                                  |
+|------|----------------------|------------------------------------------------------------------------------------------------------------------------|
+| 0    | `SUCCESS`            | Command completed successfully                                                                                         |
+| 1    | `GENERAL_ERROR`      | Unhandled exception, general failure                                                                                   |
+| 2    | `FILE_NOT_FOUND`     | Attachment or file not found; also click's usage error (bad option value, malformed `--set`, invalid `--profile` name) |
+| 13   | `PERMISSION_DENIED`  | Cannot write to target directory                                                                                       |
+| 22   | `INVALID_ARGUMENT`   | Invalid CLI argument or section not found                                                                              |
+| 69   | `SMTP_FAILURE`       | SMTP delivery failed                                                                                                   |
+| 77   | `ATTACHMENT_REFUSED` | Attachment refused by btx_lib_mail's security checks (blocked extension or directory, symlink, size, ...)              |
+| 78   | `CONFIG_ERROR`       | Configuration missing, not loadable or invalid                                                                         |
+| 110  | `TIMEOUT`            | Operation timed out                                                                                                    |
+| 130  | `SIGNAL_INT`         | Interrupted (SIGINT/Ctrl+C)                                                                                            |
+| 141  | `BROKEN_PIPE`        | Output pipe closed                                                                                                     |
+| 143  | `SIGNAL_TERM`        | Terminated (SIGTERM)                                                                                                   |
 
 ---
 
@@ -243,7 +245,7 @@ Send email using configured SMTP settings.
 | `--raise-on-missing-attachments / --no-raise-on-missing-attachments` | Override missing-attachment handling |
 | `--raise-on-invalid-recipient / --no-raise-on-invalid-recipient`     | Override invalid-recipient handling  |
 
-**Exit codes:** 0, 2 (file not found, or usage error), 22 (invalid option value), 69 (SMTP failure), 78 (no SMTP hosts, an invalid `[email]` section, or configuration not loadable)
+**Exit codes:** 0, 2 (file not found, or usage error), 22 (invalid option value), 69 (SMTP failure), 77 (an attachment refused by btx_lib_mail's security checks), 78 (no SMTP hosts, an invalid `[email]` section, or configuration not loadable)
 
 ### send-notification
 
@@ -411,7 +413,7 @@ The `adapters/memory/` package provides lightweight implementations for testing:
 |---------------------|-----------------------------------------------------------------------------|
 | `memory/config.py`  | `GetConfig`, `GetDefaultConfigPath`, `DeployConfiguration`, `DisplayConfig` |
 | `memory/email.py`   | `SendEmail`, `SendNotification`                                             |
-| `memory/logging.py` | `InitLogging`                                                               |
+| `memory/logging.py` | `InitLogging`, `RestartLogging`                                             |
 
 `adapters/memory` exports `EmailSpy` (from `memory/email.py`): its `send_email` and
 `send_notification` methods satisfy the email ports and record each call as a `CapturedEmail` /

{bitranox_template_py_cli-2.1.1 → bitranox_template_py_cli-2.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "bitranox_template_py_cli"
-version = "2.1.1"
+version = "2.1.3"
 description = "Template CLI application with configuration management and structured logging"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -14,7 +14,7 @@ dependencies = [
     "lib_layered_config>=7.0.1",
     "btx_lib_mail>=4.0.0",
     "pydantic>=2.13.5",
-    "orjson>=3.12.0",
+    "orjson>=3.13.0",
 ]
 license = { text = "MIT" }
 authors = [{ name = "bitranox", email = "bitranox@gmail.com" }]

{bitranox_template_py_cli-2.1.1 → bitranox_template_py_cli-2.1.3}/src/bitranox_template_py_cli/__init__conf__.py

@@ -40,7 +40,7 @@ name = "bitranox_template_py_cli"
 #: Human-readable summary shown in CLI help output.
 title = "Template CLI application with configuration management and structured logging"
 #: Current release version pulled from ``pyproject.toml`` by automation.
-version = "2.1.1"
+version = "2.1.3"
 #: Repository homepage presented to users.
 homepage = "https://github.com/bitranox/bitranox_template_py_cli"
 #: Author attribution surfaced in CLI output.

{bitranox_template_py_cli-2.1.1 → bitranox_template_py_cli-2.1.3}/src/bitranox_template_py_cli/adapters/cli/commands/config.py

@@ -32,7 +32,7 @@ from bitranox_template_py_cli.adapters.config.overrides import nest_overrides
 from bitranox_template_py_cli.domain.enums import DeployTarget, OutputFormat
 
 from .. import safe_console
-from ..config_load import load_config, report_load_failure, require_config
+from ..config_load import load_config, report_load_failure, require_config, restart_logging
 from ..constants import CLICK_CONTEXT_SETTINGS
 from ..context import CLIContext, get_cli_context
 from ..exit_codes import ExitCode
@@ -110,7 +110,8 @@ def _resolve_config(ctx: click.Context, cli_ctx: CLIContext, profile: str | None
 
     When a subcommand-level profile override is specified, reloads config
     with that profile, the root's ``--env-file`` and any root-level ``--set``
-    overrides stored in the CLI context.
+    overrides stored in the CLI context, and restarts logging with it, which
+    refuses its logging settings the way the root refuses its own.
 
     Args:
         ctx: The running command's click context, exited with 78 when loading failed.
@@ -126,6 +127,8 @@ def _resolve_config(ctx: click.Context, cli_ctx: CLIContext, profile: str | None
     config, error = load_config(
         cli_ctx.services, profile=profile, env_file=cli_ctx.env_file, set_overrides=cli_ctx.set_overrides
     )
+    if error is None:
+        error = restart_logging(cli_ctx.services, config, env_file=cli_ctx.env_file)
     if error is not None:
         report_load_failure(error, show_traceback=cli_ctx.traceback)
         ctx.exit(ExitCode.CONFIG_ERROR)

{bitranox_template_py_cli-2.1.1 → bitranox_template_py_cli-2.1.3}/src/bitranox_template_py_cli/adapters/cli/commands/email/_common.py

@@ -11,6 +11,7 @@ import logging
 import os
 from typing import TYPE_CHECKING, Any, NoReturn, cast
 
+from btx_lib_mail import AttachmentSecurityError
 from pydantic import ValidationError
 
 from bitranox_template_py_cli import __init__conf__
@@ -169,8 +170,10 @@ def execute_with_email_error_handling(
         1. ConfigurationError -> CONFIG_ERROR (78): Missing/invalid config
         2. ValueError -> INVALID_ARGUMENT (22): Invalid parameters or email format
         3. FileNotFoundError -> FILE_NOT_FOUND (2): Missing attachment (if enabled)
-        4. DeliveryError/RuntimeError -> SMTP_FAILURE (69): SMTP transport failures
-        5. Exception (catch-all) -> GENERAL_ERROR (1): Unexpected errors with traceback
+        4. AttachmentSecurityError -> ATTACHMENT_REFUSED (77): An attachment btx_lib_mail's
+           security checks refuse (blocked extension or directory, symlink, size, ...)
+        5. DeliveryError/RuntimeError -> SMTP_FAILURE (69): SMTP transport failures
+        6. Exception (catch-all) -> GENERAL_ERROR (1): Unexpected errors with traceback
 
         This ordering ensures specific exceptions aren't caught by broader handlers.
         When adding new exception types, insert them before the catch-all Exception handler.
@@ -205,6 +208,8 @@ def execute_with_email_error_handling(
             "Attachment file not found",
             exit_code=ExitCode.FILE_NOT_FOUND,
         )
+    except AttachmentSecurityError as exc:
+        _refuse_attachment(exc)
     except (DeliveryError, RuntimeError) as exc:
         _handle_send_error(
             exc,
@@ -264,6 +269,27 @@ def _refuse_email_config(exc: ValidationError, heading: str, *, exit_code: ExitC
     get_current_context().exit(exit_code)
 
 
+def _refuse_attachment(exc: AttachmentSecurityError) -> NoReturn:
+    """Report an attachment btx_lib_mail refused on security grounds, then exit 77.
+
+    The refusal is policy working as configured, not a crash, so no traceback is logged. The
+    user sees the library's reason, which names the violation and the resolved path; it never
+    carries a credential.
+
+    Args:
+        exc: The refusal btx_lib_mail raised.
+
+    Raises:
+        click.exceptions.Exit: Always raised, with the ATTACHMENT_REFUSED exit code.
+    """
+    logger.error(
+        "Attachment refused by security policy",
+        extra={"reason": exc.reason, "violation_type": exc.violation_type.value},
+    )
+    safe_console.echo(f"\nError: Attachment refused by security policy - {exc.reason}", err=True)
+    get_current_context().exit(ExitCode.ATTACHMENT_REFUSED)
+
+
 def _handle_send_result(result: bool, recipients: list[str] | None, message_type: str) -> None:
     """Handle the result of a send operation.
 

{bitranox_template_py_cli-2.1.1 → bitranox_template_py_cli-2.1.3}/src/bitranox_template_py_cli/adapters/cli/config_load.py

@@ -16,6 +16,7 @@ Contents:
     * :func:`load_config` - load with profile, ``.env`` and ``--set``, or say why not.
     * :func:`start_logging` - start logging; an invalid ``[lib_log_rich]`` value or ``LOG_*``
       variable is a load failure.
+    * :func:`restart_logging` - the same refusal for a configuration loaded after logging started.
     * :func:`require_config` - the configuration, or exit 78 naming the failure.
     * :func:`report_load_failure` - the one-line report, after the traceback on request.
     * :func:`echo_load_traceback` - the loader's traceback alone, for a caller with its own line.
@@ -123,6 +124,30 @@ def start_logging(
     return config, config_error
 
 
+def restart_logging(services: AppServices, config: Config, *, env_file: str | None) -> Exception | None:
+    """Restart logging with a configuration loaded after it started; a refused setting is returned.
+
+    ``config --profile`` reloads the configuration once logging is running, so
+    :func:`start_logging` never sees the reloaded ``[lib_log_rich]`` section; without this an
+    invalid value there would display with exit 0 while plain ``config`` exits 78. Restarting
+    runs the very start :func:`start_logging` ran, so it refuses the same settings in the same
+    words, and the rest of the command logs with the reloaded settings.
+
+    Args:
+        services: The composition's services; only ``restart_logging`` is used.
+        config: The configuration :func:`load_config` returned.
+        env_file: The ``--env-file`` path, or None; logging reads its ``LOG_*`` lines from it.
+
+    Returns:
+        None, or the refusal; logging then runs with its defaults.
+    """
+    try:
+        services.restart_logging(config, dotenv_path=env_file)
+    except InvalidLoggingConfigError as exc:
+        return exc
+    return None
+
+
 def echo_load_traceback(error: Exception, *, show_traceback: bool) -> None:
     """Write the loader's chained traceback to stderr when ``--traceback`` was given.
 
@@ -170,4 +195,11 @@ def require_config(ctx: click.Context, cli_ctx: CLIContext) -> Config:
     return cli_ctx.config
 
 
-__all__ = ["echo_load_traceback", "load_config", "report_load_failure", "require_config", "start_logging"]
+__all__ = [
+    "echo_load_traceback",
+    "load_config",
+    "report_load_failure",
+    "require_config",
+    "restart_logging",
+    "start_logging",
+]

{bitranox_template_py_cli-2.1.1 → bitranox_template_py_cli-2.1.3}/src/bitranox_template_py_cli/adapters/cli/exit_codes.py

@@ -27,6 +27,8 @@ class ExitCode(IntEnum):
     * 2-13: errno-derived codes (ENOENT, EACCES)
     * 22: EINVAL
     * 69: EX_UNAVAILABLE (sysexits.h)
+    * 77: EX_NOPERM (sysexits.h): refused by policy, such as an email attachment
+      btx_lib_mail's security checks reject
     * 78: EX_CONFIG (sysexits.h)
     * 110: ETIMEDOUT
     * 128+N: signal N (informational only)
@@ -44,6 +46,7 @@ class ExitCode(IntEnum):
     PERMISSION_DENIED = 13
     INVALID_ARGUMENT = 22
     SMTP_FAILURE = 69
+    ATTACHMENT_REFUSED = 77
     CONFIG_ERROR = 78
     TIMEOUT = 110
     SIGNAL_INT = 130

{bitranox_template_py_cli-2.1.1 → bitranox_template_py_cli-2.1.3}/src/bitranox_template_py_cli/adapters/config/defaultconfig.d/50-mail.toml

@@ -235,5 +235,6 @@ allow_symlinks = false
 # Default: true (raise AttachmentSecurityError)
 # Environment Variable: BITRANOX_TEMPLATE_PY_CLI___EMAIL__ATTACHMENTS__RAISE_ON_SECURITY_VIOLATION=true
 # .env: EMAIL__ATTACHMENTS__RAISE_ON_SECURITY_VIOLATION=true
-# Note: When false, violations log a warning and skip the attachment
+# Note: When true, send-email refuses the whole message and exits 77 (EX_NOPERM)
+#   naming the violation; when false, violations log a warning and skip the attachment
 raise_on_security_violation = true

{bitranox_template_py_cli-2.1.1 → bitranox_template_py_cli-2.1.3}/src/bitranox_template_py_cli/adapters/email/transport.py

@@ -128,6 +128,10 @@ def send_email(
         ConfigurationError: No SMTP hosts configured.
         FileNotFoundError: Required attachment missing or unreadable and
             config.raise_on_missing_attachments is True.
+        AttachmentSecurityError: btx_lib_mail's security checks refused an
+            attachment (blocked extension or directory, symlink, size, ...)
+            and config.attachment_raise_on_security_violation is True.
+            Raised before anything is delivered.
         DeliveryError: All SMTP hosts failed for a recipient.
 
     Side Effects:

{bitranox_template_py_cli-2.1.1 → bitranox_template_py_cli-2.1.3}/src/bitranox_template_py_cli/adapters/logging/setup.py

@@ -7,6 +7,7 @@ eliminating duplication between module entry (__main__.py) and console script
 Contents:
     * :func:`init_logging` - idempotent logging initialization from the ``[lib_log_rich]``
       section and the ``LOG_*`` variables (the environment, plus the ``LOG_*`` lines of a ``.env``).
+    * :func:`restart_logging` - stop the running runtime and start it again with another configuration.
     * :class:`InvalidLoggingConfigError` - the ``[lib_log_rich]`` section or a ``LOG_*`` variable
       cannot configure logging.
     * :func:`_build_runtime_config` - constructs RuntimeConfig from layered sources.
@@ -280,9 +281,35 @@ def init_logging(config: Config, *, dotenv_path: str | None = None) -> None:
     lib_log_rich.runtime.attach_std_logging()
 
 
+def restart_logging(config: Config, *, dotenv_path: str | None = None) -> None:
+    """Stop the running lib_log_rich runtime, then start it again with ``config``.
+
+    :func:`init_logging` returns at once while a runtime is running, so a configuration loaded
+    after logging started (``config --profile``'s reload) would never have its logging settings
+    judged. This runs that same start again: a setting lib_log_rich refuses raises exactly as it
+    does there, and logging is left running with the defaults. lib_log_rich has no public call
+    that checks settings without starting the runtime.
+
+    Args:
+        config: Already-loaded layered configuration object.
+        dotenv_path: As for :func:`init_logging`.
+
+    Raises:
+        InvalidLoggingConfigError: As for :func:`init_logging`.
+
+    Side Effects:
+        Flushes and shuts down the running runtime first (its queue, Graylog and journald
+        adapters included); the new one carries ``config``'s logging settings.
+    """
+    if lib_log_rich.runtime.is_initialised():
+        lib_log_rich.runtime.shutdown()
+    init_logging(config, dotenv_path=dotenv_path)
+
+
 __all__ = [
     "InvalidLoggingConfigError",
     "LoggingConfigModel",
     "init_logging",
     "log_variables_hidden",
+    "restart_logging",
 ]

{bitranox_template_py_cli-2.1.1 → bitranox_template_py_cli-2.1.3}/src/bitranox_template_py_cli/adapters/memory/__init__.py

@@ -20,7 +20,7 @@ from .config import (
     get_default_config_path_in_memory,
 )
 from .email import EmailSpy
-from .logging import init_logging_in_memory
+from .logging import init_logging_in_memory, restart_logging_in_memory
 
 # Static conformance assertions
 if TYPE_CHECKING:
@@ -28,11 +28,13 @@ if TYPE_CHECKING:
         GetConfig,
         GetDefaultConfigPath,
         InitLogging,
+        RestartLogging,
     )
 
     _assert_get_config: GetConfig = get_config_in_memory
     _assert_get_default_config_path: GetDefaultConfigPath = get_default_config_path_in_memory
     _assert_init_logging: InitLogging = init_logging_in_memory
+    _assert_restart_logging: RestartLogging = restart_logging_in_memory
 
 __all__ = [
     "EmailSpy",
@@ -41,4 +43,5 @@ __all__ = [
     "get_config_in_memory",
     "get_default_config_path_in_memory",
     "init_logging_in_memory",
+    "restart_logging_in_memory",
 ]

{bitranox_template_py_cli-2.1.1 → bitranox_template_py_cli-2.1.3}/src/bitranox_template_py_cli/adapters/memory/logging.py

@@ -63,4 +63,17 @@ def init_logging_in_memory(config: Config, *, dotenv_path: str | None = None) ->
         )
 
 
-__all__ = ["init_logging_in_memory"]
+def restart_logging_in_memory(config: Config, *, dotenv_path: str | None = None) -> None:
+    """Keep the test runtime: :func:`init_logging_in_memory` ignores the configuration, so a restart changes nothing.
+
+    Args:
+        config: Unused; the parameter exists to satisfy the ``RestartLogging`` protocol.
+        dotenv_path: Unused for the same reason.
+
+    Example:
+        >>> from lib_layered_config import Config
+        >>> restart_logging_in_memory(Config({"lib_log_rich": {"rate_limit": "100:60"}}, {}))
+    """
+
+
+__all__ = ["init_logging_in_memory", "restart_logging_in_memory"]

{bitranox_template_py_cli-2.1.1 → bitranox_template_py_cli-2.1.3}/src/bitranox_template_py_cli/application/ports.py

@@ -109,6 +109,16 @@ class InitLogging(Protocol):
     def __call__(self, config: Config, *, dotenv_path: str | None = None) -> None: ...
 
 
+class RestartLogging(Protocol):
+    """Stop the running logging runtime and start it again with ``config``, as ``InitLogging`` does.
+
+    For a configuration loaded after logging is running; a refused setting raises
+    ``InvalidLoggingConfigError`` after logging has been started with its defaults.
+    """
+
+    def __call__(self, config: Config, *, dotenv_path: str | None = None) -> None: ...
+
+
 __all__ = [
     "DeployConfiguration",
     "DisplayConfig",
@@ -116,6 +126,7 @@ __all__ = [
     "GetDefaultConfigPath",
     "InitLogging",
     "LoadEmailConfigFromDict",
+    "RestartLogging",
     "SendEmail",
     "SendNotification",
 ]

{bitranox_template_py_cli-2.1.1 → bitranox_template_py_cli-2.1.3}/src/bitranox_template_py_cli/composition/__init__.py

@@ -19,7 +19,7 @@ from ..adapters.email.sender import (
 )
 
 # Logging services
-from ..adapters.logging.setup import init_logging
+from ..adapters.logging.setup import init_logging, restart_logging
 
 # Static conformance assertions — pyright verifies that each adapter function
 # structurally satisfies its corresponding Protocol at type-check time.
@@ -32,6 +32,7 @@ if TYPE_CHECKING:
         GetDefaultConfigPath,
         InitLogging,
         LoadEmailConfigFromDict,
+        RestartLogging,
         SendEmail,
         SendNotification,
     )
@@ -44,6 +45,7 @@ if TYPE_CHECKING:
     _assert_send_notification: SendNotification = send_notification
     _assert_load_email_config_from_dict: LoadEmailConfigFromDict = load_email_config_from_dict
     _assert_init_logging: InitLogging = init_logging
+    _assert_restart_logging: RestartLogging = restart_logging
 
 
 @dataclass(frozen=True, slots=True)
@@ -58,6 +60,7 @@ class AppServices:
     send_notification: SendNotification
     load_email_config_from_dict: LoadEmailConfigFromDict
     init_logging: InitLogging
+    restart_logging: RestartLogging
 
 
 def build_production() -> AppServices:
@@ -71,6 +74,7 @@ def build_production() -> AppServices:
         send_notification=send_notification,
         load_email_config_from_dict=load_email_config_from_dict,
         init_logging=init_logging,
+        restart_logging=restart_logging,
     )
 
 
@@ -92,6 +96,7 @@ def build_testing(*, spy: EmailSpy | None = None) -> AppServices:
         get_config_in_memory,
         get_default_config_path_in_memory,
         init_logging_in_memory,
+        restart_logging_in_memory,
     )
 
     email_spy = spy if spy is not None else EmailSpy()
@@ -106,23 +111,21 @@ def build_testing(*, spy: EmailSpy | None = None) -> AppServices:
         # The real translation: an in-memory one would let every CLI test skip it.
         load_email_config_from_dict=load_email_config_from_dict,
         init_logging=init_logging_in_memory,
+        restart_logging=restart_logging_in_memory,
     )
 
 
 __all__ = [
-    # Composition
     "AppServices",
     "build_production",
     "build_testing",
     "deploy_configuration",
     "display_config",
-    # Configuration
     "get_config",
     "get_default_config_path",
-    # Logging
     "init_logging",
     "load_email_config_from_dict",
-    # Email
+    "restart_logging",
     "send_email",
     "send_notification",
 ]

{bitranox_template_py_cli-2.1.1 → bitranox_template_py_cli-2.1.3}/tests/conftest.py

@@ -384,7 +384,7 @@ def inject_config(
             result = cli_runner.invoke(cli, ["config"], obj=factory)
             assert "key" in result.output
     """
-    from bitranox_template_py_cli.adapters.memory import init_logging_in_memory
+    from bitranox_template_py_cli.adapters.memory import init_logging_in_memory, restart_logging_in_memory
     from bitranox_template_py_cli.composition import AppServices, build_production
 
     def _inject(config: Config) -> Callable[[], AppServices]:
@@ -403,6 +403,7 @@ def inject_config(
             # The quiet runtime: production init_logging queues INFO lines that race into
             # CliRunner's stderr, so a stderr assertion would depend on timing.
             init_logging=init_logging_in_memory,
+            restart_logging=restart_logging_in_memory,
         )
         return lambda: test_services
 
@@ -438,7 +439,7 @@ def inject_config_with_profile_capture(
             cli_runner.invoke(cli, ["--profile", "staging", "config"], obj=factory)
             assert captured == ["staging"]
     """
-    from bitranox_template_py_cli.adapters.memory import init_logging_in_memory
+    from bitranox_template_py_cli.adapters.memory import init_logging_in_memory, restart_logging_in_memory
     from bitranox_template_py_cli.composition import AppServices, build_production
 
     def _inject(config: Config, captured_profiles: list[str | None]) -> Callable[[], AppServices]:
@@ -458,6 +459,7 @@ def inject_config_with_profile_capture(
             # The quiet runtime: production init_logging queues INFO lines that race into
             # CliRunner's stderr, so a stderr assertion would depend on timing.
             init_logging=init_logging_in_memory,
+            restart_logging=restart_logging_in_memory,
         )
         return lambda: test_services
 
@@ -493,7 +495,7 @@ def inject_deploy_with_profile_capture(
             cli_runner.invoke(cli, ["--profile", "prod", "config-deploy", ...], obj=factory)
             assert captured == ["prod"]
     """
-    from bitranox_template_py_cli.adapters.memory import init_logging_in_memory
+    from bitranox_template_py_cli.adapters.memory import init_logging_in_memory, restart_logging_in_memory
     from bitranox_template_py_cli.composition import AppServices, build_production
 
     def _inject(deployed_path: Path, captured_profiles: list[str | None]) -> Callable[[], AppServices]:
@@ -522,6 +524,7 @@ def inject_deploy_with_profile_capture(
             # The quiet runtime: production init_logging queues INFO lines that race into
             # CliRunner's stderr, so a stderr assertion would depend on timing.
             init_logging=init_logging_in_memory,
+            restart_logging=restart_logging_in_memory,
         )
         return lambda: test_services
 
@@ -553,7 +556,7 @@ def inject_deploy_configuration() -> Callable[[Callable[..., list[Path]]], Calla
             cli_runner.invoke(cli, ["config-deploy", "--target", "user"], obj=factory)
             assert len(calls) == 1
     """
-    from bitranox_template_py_cli.adapters.memory import init_logging_in_memory
+    from bitranox_template_py_cli.adapters.memory import init_logging_in_memory, restart_logging_in_memory
     from bitranox_template_py_cli.composition import AppServices, build_production
 
     def _inject(deploy_fn: Callable[..., list[Path]]) -> Callable[[], AppServices]:
@@ -569,6 +572,7 @@ def inject_deploy_configuration() -> Callable[[Callable[..., list[Path]]], Calla
             # The quiet runtime: production init_logging queues INFO lines that race into
             # CliRunner's stderr, so a stderr assertion would depend on timing.
             init_logging=init_logging_in_memory,
+            restart_logging=restart_logging_in_memory,
         )
         return lambda: test_services
 
@@ -654,7 +658,7 @@ def email_cli_context(
             assert ctx.spy.sent_notifications[0].subject == "Hi"
     """
     from bitranox_template_py_cli.adapters.email.config import load_email_config_from_dict
-    from bitranox_template_py_cli.adapters.memory import init_logging_in_memory
+    from bitranox_template_py_cli.adapters.memory import init_logging_in_memory, restart_logging_in_memory
     from bitranox_template_py_cli.adapters.memory.email import EmailSpy as EmailSpyImpl
     from bitranox_template_py_cli.composition import AppServices, build_production
 
@@ -677,6 +681,7 @@ def email_cli_context(
             # The quiet runtime: production init_logging queues INFO lines that race into
             # CliRunner's stderr, so a stderr assertion would depend on timing.
             init_logging=init_logging_in_memory,
+            restart_logging=restart_logging_in_memory,
         )
         return EmailCliContext(factory=lambda: test_services, spy=spy)
 
@@ -708,7 +713,7 @@ def config_cli_context(
             result = cli_runner.invoke(cli, ["config"], obj=factory)
             assert "key" in result.output
     """
-    from bitranox_template_py_cli.adapters.memory import init_logging_in_memory
+    from bitranox_template_py_cli.adapters.memory import init_logging_in_memory, restart_logging_in_memory
     from bitranox_template_py_cli.composition import AppServices, build_production
 
     def _create(config_data: dict[str, Any]) -> Callable[[], AppServices]:
@@ -729,6 +734,7 @@ def config_cli_context(
             # The quiet runtime: production init_logging queues INFO lines that race into
             # CliRunner's stderr, so a stderr assertion would depend on timing.
             init_logging=init_logging_in_memory,
+            restart_logging=restart_logging_in_memory,
         )
         return lambda: test_services