From 6606793f69993900aa1ddd8d01e4d8569eb8c153 Mon Sep 17 00:00:00 2001
From: Janusz Nowakowski <jnowakowski@gmail.com>
Date: Mon, 19 May 2025 10:50:19 +0200
Subject: [PATCH] docs(logging): fix example to include missing StreamHandler

The previous logging example set the log level but did not include a StreamHandler,
causing no output in many environments. This fix adds a StreamHandler and formatter
to ensure logs are visible in terminal/script use.
---
 docs/logging.md | 24 +++++++++++++++++-------
 1 file changed, 17 insertions(+), 7 deletions(-)

diff --git a/docs/logging.md b/docs/logging.md
index 408a20ac6f7..ed45f5db2d3 100644
--- a/docs/logging.md
+++ b/docs/logging.md
@@ -16,21 +16,31 @@ In the following code, the logging level is set to `INFO`, and the Google Transl
 
 ```python
 import logging
+import sys
 from googleapiclient.discovery import build
 
+# Configure root logger
 logger = logging.getLogger()
 logger.setLevel(logging.INFO)
 
+# Ensure logs are printed to stdout
+handler = logging.StreamHandler(sys.stdout)
+formatter = logging.Formatter('%(levelname)s:%(name)s:%(message)s')
+handler.setFormatter(formatter)
+logger.addHandler(handler)
+
 def main():
-  service = build('translate', 'v2', developerKey='your_api_key')
-  print service.translations().list(
-      source='en',
-      target='fr',
-      q=['flower', 'car']
+    service = build('translate', 'v2', developerKey='your_api_key')
+    result = service.translations().list(
+        source='en',
+        target='fr',
+        q=['flower', 'car']
     ).execute()
+    print(result)
 
 if __name__ == '__main__':
-  main()
+    main()
+
 ```
 
 The output of this code should print basic logging info:
@@ -48,4 +58,4 @@ For even more detailed logging you can set the debug level of the [httplib2](htt
 ```python
 import httplib2
 httplib2.debuglevel = 4
-```
\ No newline at end of file
+```