From 0493796fb4a71284eab11d57310abafb5e3e4e4e Mon Sep 17 00:00:00 2001 From: HazizCISSE <319185872+HazizCISSE@users.noreply.github.com> Date: Sun, 15 Nov 2026 17:37:22 +0100 Subject: [PATCH] Fix translation template init documentation --- src/SeleniumLibrary/entry/translation.py | 6 ++++-- utest/test/entry/test_entry_point.py | 24 ++++++++++++++++++++++++ 2 files changed, 28 insertions(+), 2 deletions(-) diff --git a/src/SeleniumLibrary/entry/translation.py b/src/SeleniumLibrary/entry/translation.py index 0cfdb0e7b..8b4cf8fc4 100644 --- a/src/SeleniumLibrary/entry/translation.py +++ b/src/SeleniumLibrary/entry/translation.py @@ -45,8 +45,10 @@ def get_library_translation(plugins: str | None = None) -> dict: } translation["__init__"] = { "name": "__init__", - "doc": inspect.getdoc(selib), - "sha256": hashlib.sha256(inspect.getdoc(selib).encode("utf-16")).hexdigest(), # type: ignore + "doc": inspect.getdoc(type(selib).__init__), + "sha256": hashlib.sha256( + inspect.getdoc(type(selib).__init__).encode("utf-16") + ).hexdigest(), # type: ignore } translation["__intro__"] = { "name": "__intro__", diff --git a/utest/test/entry/test_entry_point.py b/utest/test/entry/test_entry_point.py index 2d94a64c0..058dd0bf3 100644 --- a/utest/test/entry/test_entry_point.py +++ b/utest/test/entry/test_entry_point.py @@ -1,9 +1,12 @@ +import hashlib +import inspect import json import sys from pathlib import Path from approvaltests import verify_all +from SeleniumLibrary import SeleniumLibrary from SeleniumLibrary.entry.get_versions import get_version from SeleniumLibrary.entry.translation import ( compare_translation, @@ -32,6 +35,27 @@ def test_get_translation(): assert item["sha256"], item["sha256"] +def test_translation_init_documents_import_arguments(): + data = get_library_translation() + init_doc = data["__init__"]["doc"] + assert init_doc == inspect.getdoc(SeleniumLibrary.__init__) + assert init_doc != data["__intro__"]["doc"] + assert ( + data["__init__"]["sha256"] + == hashlib.sha256(init_doc.encode("utf-16")).hexdigest() + ) + + +def test_translation_intro_is_class_documentation(): + data = get_library_translation() + intro_doc = data["__intro__"]["doc"] + assert intro_doc == SeleniumLibrary.__doc__ + assert ( + data["__intro__"]["sha256"] + == hashlib.sha256(intro_doc.encode("utf-16")).hexdigest() + ) + + def test_compare_translation(tmp_path: Path): translation = tmp_path / "translation.json" data = get_library_translation()