From 6af1972ebc1db3cc95a1756c840d7eee8c424075 Mon Sep 17 00:00:00 2001
From: PakitoSec <jeromep83@gmail.com>
Date: Sun, 5 Apr 2026 21:29:10 +0200
Subject: [PATCH] feat: add force parameter to init_logger for idempotent
 initialization

---
 README.md            | 41 +++++++++++++++++++++++++++++++++++++++++
 src/logurich/core.py |  4 ++++
 2 files changed, 45 insertions(+)

diff --git a/README.md b/README.md
index f6a443a..dd8db2c 100644
--- a/README.md
+++ b/README.md
@@ -180,3 +180,44 @@ def cli():
 ```
 
 The `click_logger_params` decorator injects `--logger-level`, `--logger-verbose`, `--logger-filename`, `--logger-level-by-module`, and `--logger-rich` flags and configures Logurich before your command logic runs. The usage example above is also available at `examples/click_cli.py`.
+
+## Idempotent initialisation (`force`)
+
+By default, calling `init_logger()` a second time is a no-op — the existing configuration is kept and the call returns `None`. Pass `force=True` to tear down the current setup and reconfigure from scratch:
+
+```python
+from logurich import init_logger
+
+init_logger("INFO", enqueue=False)          # first call: configures logging
+init_logger("DEBUG", enqueue=False)         # no-op, returns None
+init_logger("DEBUG", enqueue=False, force=True)  # reconfigures logging
+```
+
+This is useful when tests or interactive sessions need to reset logging between runs.
+
+## User input
+
+The `user_input` module provides Rich-enhanced prompts with type coercion, hidden input, and optional timeouts. It does **not** depend on Click.
+
+```python
+import logging
+
+from logurich import init_logger, user_input, user_input_with_timeout
+
+init_logger("INFO", enqueue=False)
+logger = logging.getLogger(__name__)
+
+# Basic string input
+name = user_input("Enter your name", type=str)
+
+# Integer input with a default value
+count = user_input("How many items?", type=int, default=5)
+
+# Hidden input (e.g. passwords)
+secret = user_input("Enter secret", type=str, hide_input=True)
+
+# Input with a timeout (5 seconds, Unix only — falls back to regular input on Windows)
+answer = user_input_with_timeout("Quick! Type something", timeout_duration=5)
+```
+
+A runnable example is available at `examples/user_input_example.py`.
diff --git a/src/logurich/core.py b/src/logurich/core.py
index dc9a29a..d6220ee 100644
--- a/src/logurich/core.py
+++ b/src/logurich/core.py
@@ -754,9 +754,13 @@ def init_logger(
     highlight: bool = False,
     rotation: Optional[Union[str, int]] = "12:00",
     retention: Optional[int] = 10,
+    force: bool = False,
 ) -> Optional[str]:
     """Initialize stdlib logging with optional Rich rendering and queue support."""
 
+    if not force and logger_state.get("min_level") is not None:
+        return None
+
     _ensure_shutdown_threading_atexit_registered()
     _ensure_shutdown_atexit_registered()
     shutdown_logger()