Add migrated files

Author: mielvds

tests/conftest.py

@@ -0,0 +1,77 @@
+#!/usr/bin/env python
+"""
+Pytest plugin hooks for the pyld test-suite runner.
+
+- Adds CLI options: --earl, --loader, --tests (paths), --number
+- Configures jsonld default loader based on --loader
+- Captures test outcomes and writes an EARL report when requested
+"""
+from __future__ import annotations
+
+import os
+import sys
+import pytest
+
+# ensure local lib on path for jsonld
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', 'lib'))
+from pyld import jsonld  # type: ignore
+from helpers import EarlReport
+
+EARL_REPORT = EarlReport()
+
+
+def pytest_addoption(parser):
+    parser.addoption('--earl', action='store', default=None,
+                     help='Write EARL report to this filename')
+    parser.addoption('--loader', action='store', default='requests',
+                     help='Document loader to use: requests or aiohttp [default: requests]')
+    parser.addoption('--tests', action='store', default='',
+                     help='Colon-separated list of test manifests or directories to run (overrides discovery)')
+    parser.addoption('--number', action='store', default=None,
+                     help='Limit tests to those containing the specified test identifier')
+
+
+def pytest_configure(config):
+    # Set a default JSON-LD document loader early based on option
+    loader = config.getoption('--loader')
+    if loader == 'requests':
+        jsonld._default_document_loader = jsonld.requests_document_loader()
+    elif loader == 'aiohttp':
+        jsonld._default_document_loader = jsonld.aiohttp_document_loader()
+    # make EARL report instance available via config
+    config.earl_report = EARL_REPORT
+
+
+def pytest_runtest_makereport(item, call):
+    """
+    Capture finished test call outcome and add to the EARL report.
+    The test item is expected to have a 'case' funcarg (our parametrized tests).
+    """
+    # Only interested in the 'call' phase outcome (not setup/teardown)
+    if call.when != 'call':
+        return
+
+    # call.excinfo is None for a passing call; set success accordingly
+    success = call.excinfo is None
+
+    # Extract test id from fixture 'case' if present
+    case = item.funcargs.get('case') if 'case' in item.funcargs else None
+    if case:
+        data = case.get('test_data', {})
+        test_id = data.get('id', data.get('@id', data.get('name', data.get('label', item.name))))
+    else:
+        test_id = item.name
+
+    # Only record pass/fail (skipped tests will not be recorded as pass)
+    if success:
+        EARL_REPORT.add_assertion(test_id, True)
+    else:
+        EARL_REPORT.add_assertion(test_id, False)
+
+
+def pytest_sessionfinish(session, exitstatus):
+    earl_path = session.config.getoption('--earl') or os.environ.get('PYLD_EARL')
+    if earl_path:
+        # write the EARL report collected
+        session.config.earl_report.write(earl_path)
+        print(f'Wrote EARL report to: {earl_path}')