feat: Fine-tune OUDSLogger: add verbose flag to suppress debug/log output by default (#1367)(#1368)

Signed-off-by: Pierre-Yves Lapersonne <pierreyves.lapersonne@orange.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: pylapp <7559007+pylapp@users.noreply.github.com>
Co-authored-by: Pierre-Yves Lapersonne <pierreyves.lapersonne@orange.com>
Co-authored-by: Ludovic PINEL <ludovic.pinel@orange.com>

Author: 3 people

CHANGELOG.md

@@ -10,6 +10,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Move from Xcode 26.2 to Xcode 26.3 (Orange-OpenSource/ouds-ios#1375)
 
+### Added
+
+- `verbose` flag on `OUDSLogger` to suppress debug and log messages by default (Orange-OpenSource/ouds-ios#1365)
+
 ## [1.3.0](https://github.com/Orange-OpenSource/ouds-ios/compare/1.2.0...1.3.0) - 2026-03-26
 
 ### Added

OUDS/Core/ThemesContract/Sources/TokenatorConstants+Logs.swift

@@ -57,6 +57,6 @@ extension OUDSVersions {
         versionsLog += "- Text Area: \(Self.componentTextAreaVersion)\n"
         versionsLog += "- Text Input: \(Self.componentTextInputVersion)\n"
 
-        OL.info(versionsLog)
+        OL.log(versionsLog)
     }
 }

OUDS/Foundations/Sources/OUDSLogger.swift

@@ -19,6 +19,9 @@ public typealias OL = OUDSLogger
 
 /// The `os.Logger` wrapper used in the *OUDS iOS* library so as to logs things in standard output or elsewhere.
 ///
+/// By default, debug and log level messages are suppressed even in DEBUG builds.
+/// Set `OUDSLogger.verbose = true` to enable them.
+///
 /// - Since: 0.8.0
 public struct OUDSLogger {
 
@@ -28,18 +31,26 @@ public struct OUDSLogger {
     private static let bullet: String = "🍊"
     private static let prefix: String = "\(bullet) [OUDS]"
 
-    /// If compile mode is set as DEBUG, logs the message with a "debug" prefix
+    /// When `true`, debug and log level messages are written to the console.
+    /// Defaults to `false` so that OUDS internal logs do not pollute host-app output.
+    /// Can be toggled at any time by library consumers.
+    nonisolated(unsafe) public static var verbose: Bool = false
+
+    /// If compile mode is set as DEBUG and ``verbose`` is `true`, logs the message with a "debug" prefix
     /// and the `debug` method of the `os.Logger`
     /// - Parameter message: The message to log after the decoration
     public static func debug(_ message: String) {
+        guard verbose else { return }
         #if DEBUG
         logger.debug("\(prefix):debug: 🪲 \(message)")
         #endif
     }
 
     /// Logs the message with a "log" prefix and the `log` method of the `os.Logger`
+    /// if ``verbose`` is `true`
     /// - Parameter message: The message to log after the prefix
     public static func log(_ message: String) {
+        guard verbose else { return }
         #if DEBUG
         logger.log("\(prefix): 🗒️ \(message)")
         #endif

OUDS/Foundations/Tests/OUDSLoggerTests.swift

@@ -0,0 +1,35 @@
+//
+// Software Name: OUDS iOS
+// SPDX-FileCopyrightText: Copyright (c) Orange SA
+// SPDX-License-Identifier: MIT
+//
+// This software is distributed under the MIT license,
+// the text of which is available at https://opensource.org/license/MIT/
+// or see the "LICENSE" file for more details.
+//
+// Authors: See CONTRIBUTORS.txt
+// Software description: A SwiftUI components library with code examples for Orange Unified Design System
+//
+
+@testable import OUDSFoundations
+import Testing
+
+@Suite("OUDSLogger Tests")
+struct OUDSLoggerTests {
+
+    @Test("verbose flag is false by default")
+    func verboseFlagDefaultValue() {
+        // The documented default is false; verify without resetting first
+        // so we can detect if the declaration default were ever changed.
+        #expect(OUDSLogger.verbose == false)
+    }
+
+    @Test("verbose flag can be toggled by consumers")
+    func verboseFlagCanBeChanged() {
+        defer { OUDSLogger.verbose = false } // Always restore, even on failure
+        OUDSLogger.verbose = true
+        #expect(OUDSLogger.verbose == true)
+        OUDSLogger.verbose = false
+        #expect(OUDSLogger.verbose == false)
+    }
+}