如何通过Pytest的CLI或API程序化获取机器可读格式的fixtures列表？

要以机器可读格式（比如JSON）拿到项目里的Pytest fixtures列表，分CLI快捷方式和程序化API调用两种场景，我给你拆解下最省心的实现：

CLI方式（无需额外依赖） #

如果不想写复杂代码，有两个实用思路：

1. 轻量文本提取（适合简单需求） #

直接用Pytest自带的--fixtures选项，配合安静模式去掉冗余输出，再用基础文本工具提取结构化信息：

# 提取所有fixture名称（每行一个，纯文本格式）
pytest --fixtures --no-header -q | awk '{print $1}'

2. 极简自定义插件（输出JSON） #

如果需要结构化的JSON格式，写一个临时的极简Pytest插件脚本（比如fixtures_json.py）：

import json
import pytest

def pytest_configure(config):
    # 关闭默认的fixtures人类可读输出
    config.option.showfixtures = False

def pytest_sessionfinish(session, exitstatus):
    fixtures = []
    # 遍历所有已注册的fixture定义
    for name, fixturedefs in session._fixturemanager._arg2fixturedefs.items():
        fixture = fixturedefs[0]
        fixtures.append({
            "name": name,
            "scope": fixture.scope,
            "location": f"{fixture.func.__module__}.{fixture.func.__name__}",
            "doc": fixture.func.__doc__.strip() if fixture.func.__doc__ else None
        })
    # 输出JSON到控制台
    print(json.dumps(fixtures, indent=2))

然后运行命令即可得到JSON格式的fixtures列表：

pytest --no-header -q -p fixtures_json.py

这个方法不需要安装任何第三方插件，完全用Pytest原生能力实现。

API方式（程序化集成） #

如果要在Python代码里直接获取fixtures信息，不用启动子进程，直接调用Pytest的API即可：

import pytest
import json

def fetch_pytest_fixtures():
    # 初始化Pytest配置
    config = pytest.Config.fromargs(["--no-header", "-q"])
    # 创建会话并加载fixture定义
    session = pytest.Session(config)
    session._fixturemanager.parsefactories()

    # 收集fixture核心信息
    fixtures = []
    for name, fixturedefs in session._fixturemanager._arg2fixturedefs.items():
        fixture = fixturedefs[0]
        fixtures.append({
            "name": name,
            "scope": fixture.scope,
            "function_path": f"{fixture.func.__module__}.{fixture.func.__name__}",
            "docstring": fixture.func.__doc__.strip() if fixture.func.__doc__ else "无描述"
        })

    return json.dumps(fixtures, ensure_ascii=False, indent=2)

# 调用示例
if __name__ == "__main__":
    print(fetch_pytest_fixtures())

这段代码直接通过Pytest的内部管理对象收集fixture的名称、作用域、定义位置和文档字符串，输出为标准JSON，适合集成到自动化工具或CI流程里。

小提示：Pytest的内部API（比如_fixturemanager）虽然稳定，但不同大版本可能有细微调整，如果需要长期兼容，建议基于Pytest的插件机制来封装，而非直接调用内部属性。

内容的提问来源于stack exchange，提问作者filaton