Merge branch 'bugfix/pytest_build_dir_arg' into 'master'

fix(pytest): respect --build-dir argument from pytest-embedded

See merge request espressif/esp-idf!30609

conftest.py

@@ -206,6 +206,9 @@ def build_dir(
         check_dirs = [f'build_{target}_{config}']
     else:
         check_dirs = []
+        build_dir_arg = request.config.getoption('build_dir', None)
+        if build_dir_arg:
+            check_dirs.append(build_dir_arg)
         if target is not None and config is not None:
             check_dirs.append(f'build_{target}_{config}')
         if target is not None:

docs/en/contribute/esp-idf-tests-with-pytest.rst

@@ -478,6 +478,7 @@ Build Directories
 
 By default, each test case looks for the required binary files in the following directories (in order):
 
+- Directory set by ``--build-dir`` command line argument, if specified.
 - ``build_<target>_<sdkconfig>``
 - ``build_<target>``
 - ``build_<sdkconfig>``

docs/zh_CN/contribute/esp-idf-tests-with-pytest.rst

@@ -574,6 +574,7 @@ CI 用于执行所有相关测试的命令为： ``pytest <parent_dir> --target
 
 默认情况下，pytest 脚本会按照以下顺序查找编译目录：
 
+- 由 ``--build-dir`` 命令行参数设置的目录。（当指定时）
 - ``build_<target>_<sdkconfig>``
 - ``build_<target>``
 - ``build_<sdkconfig>``