Merge branch 'trunk' into install_drivers

Author: harsha509

Diff for: examples/java/src/test/java/dev/selenium/troubleshooting/LoggingTest.java

@@ -0,0 +1,45 @@
+package dev.selenium.troubleshooting;
+
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Paths;
+import java.util.Arrays;
+import java.util.logging.FileHandler;
+import java.util.logging.Handler;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.Test;
+import org.openqa.selenium.manager.SeleniumManager;
+import org.openqa.selenium.remote.RemoteWebDriver;
+
+public class LoggingTest {
+
+  @Test
+  public void logging() throws IOException {
+    Logger logger = Logger.getLogger("");
+
+    logger.setLevel(Level.FINE);
+    Arrays.stream(logger.getHandlers()).forEach(handler -> {
+      handler.setLevel(Level.FINE);
+    });
+
+    Handler handler = new FileHandler("selenium.xml");
+    logger.addHandler(handler);
+
+    Logger.getLogger(RemoteWebDriver.class.getName()).setLevel(Level.FINEST);
+    Logger.getLogger(SeleniumManager.class.getName()).setLevel(Level.SEVERE);
+
+    Logger localLogger = Logger.getLogger(this.getClass().getName());
+    localLogger.warning("this is a warning");
+    localLogger.info("this is useful information");
+    localLogger.fine("this is detailed debug information");
+
+    byte[] bytes = Files.readAllBytes(Paths.get("selenium.xml"));
+    String fileContent = new String(bytes);
+
+    Assertions.assertTrue(fileContent.contains("this is a warning"));
+    Assertions.assertTrue(fileContent.contains("this is useful information"));
+    Assertions.assertTrue(fileContent.contains("this is detailed debug information"));
+  }
+}

Diff for: examples/python/tests/troubleshooting/test_logging.py

@@ -0,0 +1,27 @@
+import logging
+import os
+
+import pytest
+
+
+def test_logging():
+    logger = logging.getLogger('selenium')
+
+    logger.setLevel(logging.DEBUG)
+
+    log_path = "selenium.log"
+    handler = logging.FileHandler(log_path)
+    logger.addHandler(handler)
+
+    logging.getLogger('selenium.webdriver.remote').setLevel(logging.WARN)
+    logging.getLogger('selenium.webdriver.common').setLevel(logging.DEBUG)
+
+    logger.info("this is useful information")
+    logger.warning("this is a warning")
+    logger.debug("this is detailed debug information")
+
+    try:
+        with open(log_path, 'r') as fp:
+            assert len(fp.readlines()) == 3
+    finally:
+        os.remove(log_path)

Diff for: examples/ruby/spec/troubleshooting/logging_spec.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe 'Logging' do
+  describe 'Options' do
+    let(:file_name) { File.expand_path('selenium.log') }
+    after { FileUtils.rm_f(file_name) }
+
+    it 'logs things' do
+      logger = Selenium::WebDriver.logger
+
+      logger.level = :debug
+
+      logger.output = file_name
+
+      logger.ignore(:jwp_caps, :logger_info)
+      logger.allow(%i[selenium_manager example_id])
+
+      logger.warn('this is a warning', id: :example_id)
+      logger.info('this is useful information', id: :example_id)
+      logger.debug('this is detailed debug information', id: :example_id)
+
+      expect(File.readlines(file_name).grep(/\[:example_id\]/).size).to eq 3
+    end
+  end
+end