File size: 4,650 Bytes
b4fb586
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
# Copyright 2025 the LlamaFactory team.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

"""LLaMA-Factory test configuration.

Contains shared fixtures, pytest configuration, and custom markers.
"""

import pytest

from llamafactory.extras.misc import get_current_device, is_env_enabled
from llamafactory.train.test_utils import patch_valuehead_model


try:
    CURRENT_DEVICE = get_current_device().type
except Exception:
    CURRENT_DEVICE = "cpu"


def pytest_configure(config):
    """Register custom pytest markers."""
    config.addinivalue_line(
        "markers", "slow: marks tests as slow (deselect with '-m \"not slow\"' or set RUN_SLOW=1 to run)"
    )
    config.addinivalue_line(
        "markers", "skip_on_devices: skip test on specified devices, e.g., @pytest.mark.skip_on_devices('npu', 'xpu')"
    )
    config.addinivalue_line(
        "markers", "require_device: test requires specific device, e.g., @pytest.mark.require_device('cuda')"
    )
    config.addinivalue_line("markers", "runs_on: test requires specific device, e.g., @pytest.mark.runs_on(['cpu'])")


def _handle_runs_on(items):
    """Skip tests on specified devices based on runs_on marker.

    Usage:
        # Skip tests on specified devices
        @pytest.mark.runs_on(['cpu'])
        def test_something():
            pass
    """
    for item in items:
        runs_on_marker = item.get_closest_marker("runs_on")
        if runs_on_marker:
            runs_on_devices = runs_on_marker.args[0]

            # Compatibility handling: Allow a single string instead of a list
            # Example: @pytest.mark.("cpu")
            if isinstance(runs_on_devices, str):
                runs_on_devices = [runs_on_devices]

            if CURRENT_DEVICE not in runs_on_devices:
                item.add_marker(
                    pytest.mark.skip(reason=f"test requires one of {runs_on_devices} (current: {CURRENT_DEVICE})")
                )


def _handle_slow_tests(items):
    """Skip slow tests unless RUN_SLOW environment variable is set.

    Usage:
        # Skip slow tests (default)
        @pytest.mark.slow

        # Run slow tests
        RUN_SLOW=1 pytest tests/
    """
    if not is_env_enabled("RUN_SLOW", "0"):
        skip_slow = pytest.mark.skip(reason="slow test (set RUN_SLOW=1 to run)")
        for item in items:
            if "slow" in item.keywords:
                item.add_marker(skip_slow)


def _handle_device_skips(items):
    """Skip tests on specified devices based on skip_on_devices marker.

    Usage:
        @pytest.mark.skip_on_devices("npu", "xpu")
        def test_something():
            pass
    """
    for item in items:
        skip_marker = item.get_closest_marker("skip_on_devices")
        if skip_marker:
            skip_devices = skip_marker.args
            if CURRENT_DEVICE in skip_devices:
                item.add_marker(
                    pytest.mark.skip(
                        reason=f"test skipped on {CURRENT_DEVICE.upper()} (skip list: {', '.join(skip_devices)})"
                    )
                )


def _handle_device_requirements(items):
    """Skip tests that require a specific device when running on other devices.

    Usage:
        @pytest.mark.require_device("cuda")
        def test_gpu_only():
            pass
    """
    for item in items:
        require_marker = item.get_closest_marker("require_device")
        if require_marker:
            required_device = require_marker.args[0] if require_marker.args else None
            if required_device and CURRENT_DEVICE != required_device:
                item.add_marker(
                    pytest.mark.skip(
                        reason=f"test requires {required_device.upper()} (current: {CURRENT_DEVICE.upper()})"
                    )
                )


def pytest_collection_modifyitems(config, items):
    """Modify test collection based on markers and environment."""
    _handle_slow_tests(items)
    _handle_device_skips(items)
    _handle_device_requirements(items)
    _handle_runs_on(items)


@pytest.fixture
def fix_valuehead_cpu_loading():
    """Fix valuehead model loading."""
    patch_valuehead_model()