fix: prevent example collection crash for readme_generator (#596)

* fix: prevent execution of readme_generator during pytest collection (#592)

* fix: respect 'skip' marker during example collection

Author: planetf1

docs/examples/aLora/example_readme_generator.py

@@ -3,11 +3,12 @@
 
 from cli.alora.readme_generator import generate_readme, make_readme_jinja_dict
 
-generate_readme(
-    dataset_path="stembolt_failure_dataset.jsonl",
-    base_model="granite-4.0-micro",
-    prompt_file=None,
-    output_path="stembolts_model_readme.md",
-    name="your-username/stembolts-alora",
-    hints=None,
-)
+if __name__ == "__main__":
+    generate_readme(
+        dataset_path="stembolt_failure_dataset.jsonl",
+        base_model="granite-4.0-micro",
+        prompt_file=None,
+        output_path="stembolts_model_readme.md",
+        name="your-username/stembolts-alora",
+        hints=None,
+    )

docs/examples/conftest.py

@@ -115,6 +115,10 @@ def _should_skip_collection(markers):
     if "qualitative" in markers and gh_run == 1:
         return True, "Skipping qualitative test in CI (CICD=1)"
 
+    # Explicitly skip if 'skip' marker is present
+    if "skip" in markers:
+        return True, "Example marked with skip marker"
+
     # Skip slow tests if SKIP_SLOW=1 environment variable is set
     if "slow" in markers and int(os.environ.get("SKIP_SLOW", 0)) == 1:
         return True, "Skipping slow test (SKIP_SLOW=1)"