From 6a6152bb6530d7e9b540f9710961543fae5ef281 Mon Sep 17 00:00:00 2001
From: Caparrini <a.caparrini@icloud.com>
Date: Mon, 19 Jan 2026 20:54:45 +0100
Subject: [PATCH 1/3] Added logging.rst which was missing.

---
 docs/sections/Advanced/logging.rst | 147 +++++++++++++++++++++++++++++
 1 file changed, 147 insertions(+)
 create mode 100644 docs/sections/Advanced/logging.rst

diff --git a/docs/sections/Advanced/logging.rst b/docs/sections/Advanced/logging.rst
new file mode 100644
index 0000000..ac4261f
--- /dev/null
+++ b/docs/sections/Advanced/logging.rst
@@ -0,0 +1,147 @@
+Logging Configuration
+=====================
+
+mloptimizer follows the standard Python library logging pattern, giving you full control over log output. By default, the library uses a `NullHandler`, meaning no log messages are displayed unless you explicitly configure logging.
+
+Using the verbose Parameter (Recommended)
+-----------------------------------------
+
+The easiest way to enable logging is using the ``verbose`` parameter in ``GeneticSearch``:
+
+.. code-block:: python
+
+    from mloptimizer.interfaces import GeneticSearch
+
+    # Silent (default)
+    opt = GeneticSearch(estimator_class=..., hyperparam_space=..., verbose=0)
+
+    # Info level - shows optimization lifecycle
+    opt = GeneticSearch(estimator_class=..., hyperparam_space=..., verbose=1)
+
+    # Debug level - shows detailed evaluation info
+    opt = GeneticSearch(estimator_class=..., hyperparam_space=..., verbose=2)
+
+This is similar to how scikit-learn and XGBoost handle verbosity.
+
+Basic Configuration
+-------------------
+
+To enable logging output, configure Python's logging module before running your optimization:
+
+.. code-block:: python
+
+    import logging
+
+    # Enable INFO level logging globally
+    logging.basicConfig(level=logging.INFO)
+
+    # Now use mloptimizer
+    from mloptimizer.interfaces import GeneticSearch
+    # ... your optimization code
+
+This will display informative messages about the optimization process, including start/end summaries and progress updates.
+
+Configuring mloptimizer's Logger Only
+-------------------------------------
+
+To enable logging specifically for mloptimizer without affecting other libraries:
+
+.. code-block:: python
+
+    import logging
+
+    # Get mloptimizer's logger
+    mlopt_logger = logging.getLogger("mloptimizer")
+    mlopt_logger.setLevel(logging.INFO)
+
+    # Add a handler to output to console
+    handler = logging.StreamHandler()
+    handler.setFormatter(logging.Formatter("%(asctime)s [%(levelname)s]: %(message)s"))
+    mlopt_logger.addHandler(handler)
+
+Logging to a File
+-----------------
+
+To save logs to a file for later analysis:
+
+.. code-block:: python
+
+    import logging
+
+    # Configure logging to file
+    logging.basicConfig(
+        filename='optimization.log',
+        level=logging.INFO,
+        format="%(asctime)s [%(levelname)s]: %(message)s"
+    )
+
+Or configure both console and file output:
+
+.. code-block:: python
+
+    import logging
+
+    # Create logger
+    logger = logging.getLogger("mloptimizer")
+    logger.setLevel(logging.INFO)
+
+    # Console handler
+    console_handler = logging.StreamHandler()
+    console_handler.setFormatter(logging.Formatter("%(asctime)s [%(levelname)s]: %(message)s"))
+    logger.addHandler(console_handler)
+
+    # File handler
+    file_handler = logging.FileHandler("optimization.log")
+    file_handler.setFormatter(logging.Formatter("%(asctime)s [%(levelname)s]: %(message)s"))
+    logger.addHandler(file_handler)
+
+Log Levels
+----------
+
+mloptimizer uses standard Python logging levels:
+
+- **DEBUG**: Detailed information for diagnosing problems (individual evaluations, internal state)
+- **INFO**: Confirmation that things are working as expected (optimization start/end, generation summaries)
+- **WARNING**: Indication of potential issues (deprecated parameters, suboptimal configurations)
+- **ERROR**: Serious problems that prevent operation
+
+Example with DEBUG level:
+
+.. code-block:: python
+
+    import logging
+    logging.getLogger("mloptimizer").setLevel(logging.DEBUG)
+
+Silencing Logs
+--------------
+
+To completely suppress mloptimizer's log output:
+
+.. code-block:: python
+
+    import logging
+    logging.getLogger("mloptimizer").setLevel(logging.CRITICAL)
+
+Or to only see warnings and errors:
+
+.. code-block:: python
+
+    import logging
+    logging.getLogger("mloptimizer").setLevel(logging.WARNING)
+
+Integration with scikit-learn
+-----------------------------
+
+Since mloptimizer follows the same logging pattern as scikit-learn and other major Python libraries, you can configure logging for your entire ML pipeline consistently:
+
+.. code-block:: python
+
+    import logging
+
+    # Configure logging for all ML libraries
+    logging.basicConfig(
+        level=logging.INFO,
+        format="%(asctime)s [%(name)s] %(levelname)s: %(message)s"
+    )
+
+    # Now all libraries (mloptimizer, sklearn, etc.) will log consistently

From 99f48cd3e6b6c43447027017f9c1518a657cc19c Mon Sep 17 00:00:00 2001
From: Caparrini <a.caparrini@icloud.com>
Date: Mon, 19 Jan 2026 20:57:09 +0100
Subject: [PATCH 2/3] Fix version for 0.9.4 -> 0.9.4.1

---
 mloptimizer/VERSION | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mloptimizer/VERSION b/mloptimizer/VERSION
index 2bd77c7..18346b2 100644
--- a/mloptimizer/VERSION
+++ b/mloptimizer/VERSION
@@ -1 +1 @@
-0.9.4
\ No newline at end of file
+0.9.4.1
\ No newline at end of file

From 9b6208e1c77a34d05c711efd411554cd0d555493 Mon Sep 17 00:00:00 2001
From: Caparrini <a.caparrini@icloud.com>
Date: Mon, 19 Jan 2026 21:19:59 +0100
Subject: [PATCH 3/3] Removing pdf to avoid error

---
 .readthedocs.yaml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.readthedocs.yaml b/.readthedocs.yaml
index db4f951..70b2396 100644
--- a/.readthedocs.yaml
+++ b/.readthedocs.yaml
@@ -16,5 +16,4 @@ python:
     - requirements: requirements_docs.txt
 
 formats:
-  - pdf
   - epub
\ No newline at end of file