feat(tests): add pytest-order and enhance error logging in command execution

Author: Ang-m4

plugins/tutor-contrib-paragon/pyproject.toml

@@ -30,7 +30,7 @@ dependencies = [
     "tutor>=19.0.0,<20.0.0",
 ]
 
-optional-dependencies = { dev = ["tutor[dev]>=19.0.0,<20.0.0", "pytest>=8.3.4"] }
+optional-dependencies = { dev = ["tutor[dev]>=19.0.0,<20.0.0", "pytest>=8.3.4", "pytest-order>=1.3.0"] }
 
 # These fields will be set by hatch_build.py
 dynamic = ["version"]

plugins/tutor-contrib-paragon/tests/integration/helpers.py

@@ -21,14 +21,19 @@ def execute_tutor_command(command: list[str]):
     Returns:
         subprocess.CompletedProcess: Contains stdout, stderr, returncode.
     """
+    full_command = ["tutor"] + command
     result = subprocess.run(
-        ["tutor"] + command,
+        full_command,
         stdout=subprocess.PIPE,
         stderr=subprocess.PIPE,
         text=True,
         check=False,
     )
 
+    if result.returncode != 0:
+        logger.error("Command failed: %s", " ".join(full_command))
+        logger.error("stderr: %s", result.stderr.strip())
+
     return result
 
 

plugins/tutor-contrib-paragon/tests/integration/plugin_setup_test.py

@@ -15,12 +15,14 @@
     PARAGON_THEME_SOURCES_FOLDER,
 )
 
+import pytest
 import logging
 import os
 
 logger = logging.getLogger(__name__)
 
 
+@pytest.mark.order(1)
 def test_paragon_plugin_installed():
     """Verify that the 'paragon' plugin is installed and enabled."""
 
@@ -34,6 +36,7 @@ def test_paragon_plugin_installed():
     assert "enabled" in result.stdout, f"The '{PARAGON_NAME}' plugin is not enabled"
 
 
+@pytest.mark.order(2)
 def test_paragon_plugin_folders_created():
     """Verify that the 'paragon' plugin's folders exist in the filesystem."""
 
@@ -51,6 +54,7 @@ def test_paragon_plugin_folders_created():
         assert os.path.isdir(folder_path), f"{folder_path} is not a directory."
 
 
+@pytest.mark.order(3)
 def test_paragon_plugin_build_tokens_job_exists():
     """Verify that the 'paragon-build-tokens' job exists in Tutor's configuration."""