test: Enhance test coverage for KleinanzeigenBot initialization and core functionality (#408)

tests/conftest.py

@@ -1,15 +1,109 @@
 """
-SPDX-FileCopyrightText: © Sebastian Thomschke and contributors
+SPDX-FileCopyrightText: © Jens Bergmann and contributors
 SPDX-License-Identifier: AGPL-3.0-or-later
 SPDX-ArtifactOfProjectHomePage: https://github.com/Second-Hand-Friends/kleinanzeigen-bot/
 """
-import logging
-from typing import Final
+import logging, os
+from typing import Any, Final
+from unittest.mock import MagicMock
 
-from kleinanzeigen_bot import utils
+import pytest
+
+from kleinanzeigen_bot import KleinanzeigenBot, utils
+from kleinanzeigen_bot.extract import AdExtractor
 from kleinanzeigen_bot.i18n import get_translating_logger
+from kleinanzeigen_bot.web_scraping_mixin import Browser
 
 utils.configure_console_logging()
 
-LOG:Final[logging.Logger] = get_translating_logger("kleinanzeigen_bot")
+LOG: Final[logging.Logger] = get_translating_logger("kleinanzeigen_bot")
 LOG.setLevel(logging.DEBUG)
+
+
+@pytest.fixture
+def test_data_dir(tmp_path: str) -> str:
+    """Provides a temporary directory for test data.
+
+    This fixture uses pytest's built-in tmp_path fixture to create a temporary
+    directory that is automatically cleaned up after each test.
+    """
+    return str(tmp_path)
+
+
+@pytest.fixture
+def sample_config() -> dict[str, Any]:
+    """Provides a basic sample configuration for testing.
+
+    This configuration includes all required fields for the bot to function:
+    - Login credentials (username/password)
+    - Browser settings
+    - Ad defaults (description prefix/suffix)
+    - Publishing settings
+    """
+    return {
+        'login': {
+            'username': 'testuser',
+            'password': 'testpass'
+        },
+        'browser': {
+            'arguments': [],
+            'binary_location': None,
+            'extensions': [],
+            'use_private_window': True,
+            'user_data_dir': None,
+            'profile_name': None
+        },
+        'ad_defaults': {
+            'description': {
+                'prefix': 'Test Prefix',
+                'suffix': 'Test Suffix'
+            }
+        },
+        'publishing': {
+            'delete_old_ads': 'BEFORE_PUBLISH',
+            'delete_old_ads_by_title': False
+        }
+    }
+
+
+@pytest.fixture
+def test_bot(sample_config: dict[str, Any]) -> KleinanzeigenBot:
+    """Provides a fresh KleinanzeigenBot instance for all test classes.
+
+    Dependencies:
+        - sample_config: Used to initialize the bot with a valid configuration
+    """
+    bot_instance = KleinanzeigenBot()
+    bot_instance.config = sample_config
+    return bot_instance
+
+
+@pytest.fixture
+def browser_mock() -> MagicMock:
+    """Provides a mock browser instance for testing.
+
+    This mock is configured with the Browser spec to ensure it has all
+    the required methods and attributes of a real Browser instance.
+    """
+    return MagicMock(spec=Browser)
+
+
+@pytest.fixture
+def log_file_path(test_data_dir: str) -> str:
+    """Provides a temporary path for log files.
+
+    Dependencies:
+        - test_data_dir: Used to create the log file in the temporary test directory
+    """
+    return os.path.join(str(test_data_dir), "test.log")
+
+
+@pytest.fixture
+def test_extractor(browser_mock: MagicMock, sample_config: dict[str, Any]) -> AdExtractor:
+    """Provides a fresh AdExtractor instance for testing.
+
+    Dependencies:
+        - browser_mock: Used to mock browser interactions
+        - sample_config: Used to initialize the extractor with a valid configuration
+    """
+    return AdExtractor(browser_mock, sample_config)