Biến Đặc biệt (Special Variables)

Pytest xử lý một số biến toàn cục theo cách đặc biệt khi chúng được định nghĩa trong các mô-đun kiểm thử.

collect_ignore

Được sử dụng để loại trừ các thư mục hoặc mô-đun kiểm thử. Cần phải là `list[str]`.

collect_ignore = ["setup.py"]

collect_ignore_glob

Được sử dụng để loại trừ các thư mục hoặc mô-đun kiểm thử bằng cách sử dụng ký tự đại diện Unix shell. Cần phải là `list[str]`.

collect_ignore_glob = ["*_ignore.py"]

pytest_plugins

Đăng ký các plugin bổ sung tại mức độ toàn cục. Có thể là `str` hoặc `Sequence[str]`.

pytest_plugins = "myapp.testsupport.myplugin"

pytest_plugins = ("myapp.testsupport.tools", "myapp.testsupport.regression")

pytest_mark

Đặt dấu hiệu cho cả lớp hoặc mô-đun. Có thể là một hoặc nhiều dấu hiệu.

import pytest

pytestmark = pytest.mark.webtest

import pytest

pytestmark = [pytest.mark.integration, pytest.mark.slow]

PYTEST_DONT_REWRITE (Chuỗi tài liệu mô-đun)

Thêm văn bản này vào chuỗi tài liệu của mô-đun để vô hiệu hóa việc ghi đè lại khẳng định.

Biến Môi trường (Environment Variables)

Các biến môi trường có thể được sử dụng để thay đổi hành vi của pytest.

PYTEST_ADDOPTS

Chứa một dòng lệnh (được phân tích bởi py:mod:shlex) sẽ được thêm vào trước dòng lệnh do người dùng cung cấp.

PYTEST_DEBUG

Khi được đặt, pytest sẽ in thông tin theo dõi và gỡ lỗi.

PYTEST_PLUGINS

Danh sách các mô-đun được phân cách bằng dấu phẩy cần được tải như các plugin:

export PYTEST_PLUGINS=mymodule.plugin,xdist

PYTEST_DISABLE_PLUGIN_AUTOLOAD

Khi được đặt, nó sẽ vô hiệu hóa việc tải tự động plugin thông qua điểm nhập setuptools. Chỉ các plugin được chỉ định rõ ràng mới được tải.

PYTEST_CURRENT_TEST

Không được thiết lập bởi người dùng, nhưng được pytest thiết lập nội bộ để chứa tên của bài kiểm thử hiện tại.

Ngoại lệ (Exceptions)

UsageError

Lớp ngoại lệ này được sử dụng khi có lỗi trong cách sử dụng hoặc gọi pytest.

class UsageError:
    """Lỗi trong cách sử dụng hoặc gọi pytest."""