#Pytest 中那些"约定大于配置"的设计

# tests/test_calculator.py — 约定示例
def test_add():
    """函数以 test_ 开头 → 自动成为测试用例"""
    assert 1 + 1 == 2


def helper_function():
    """不以 test_ 开头 → 只是普通函数，不会被当成测试"""
    return "I'm invisible to pytest"


class TestSubtract:
    """类以 Test 开头，且没有 __init__ → 类内方法自动收集"""

    def test_positive(self):
        assert 5 - 3 == 2

    def test_negative(self):
        assert 3 - 5 == -2

    def helper(self):
        """这个方法不以 test_ 开头 → 也不会被当成测试"""
        pass

# tests/conftest.py — 全局级
import pytest

@pytest.fixture(scope="session")
def db_connection():
    """会话级数据库连接，所有测试共享"""
    conn = create_connection("postgres://...")
    yield conn
    conn.close()

@pytest.fixture
def sample_user(db_connection):
    """函数级 fixture，每个测试拿到独立用户"""
    user = db_connection.create_user(name="alice")
    yield user
    db_connection.delete_user(user.id)

# tests/unit/conftest.py — 仅单元测试专用
import pytest

@pytest.fixture
def mock_http_client(mocker):
    """懒得真发 HTTP，单元测试用 mock"""
    return mocker.patch("src.http.Client")

# 注意：这里没有 import tests/conftest.py
# fixture 自动向上继承

# tests/unit/test_core.py — 随便用，不需要 import
def test_user_creation(sample_user, mock_http_client):
    # sample_user 来自 tests/conftest.py（继承）
    # mock_http_client 来自 tests/unit/conftest.py（本地）
    assert sample_user.name == "alice"

# tests/conftest.py
def pytest_collection_modifyitems(config, items):
    """hook 函数：修改收集到的测试列表"""
    # 函数名 = hook 名，不需要任何装饰器
    for item in items:
        item.add_marker("slow")  # 给每个测试打上 slow 标记

def pytest_addoption(parser):
    """hook 函数：添加命令行参数"""
    parser.addoption("--env", action="store", default="dev")

# conftest.py — 显式声明额外插件
pytest_plugins = [
    "tests.plugins.auth",    # 加载自定义插件模块
    "tests.plugins.db_fixtures",
]

# pytest_ordering/plugin.py
def pytest_collection_modifyitems(config, items):
    """函数名等于 hook 名 → 自动Hook实现"""
    items.sort(key=lambda item: item.get_marker_value("order", 0))

# 如果直接使用 pluggy，需要手动标记
import pluggy

hookimpl = pluggy.HookimplMarker("pytest")

class MyPlugin:
    @hookimpl                           # ← 必须显式标记
    def pytest_collection_modifyitems(self, config, items):
        items.sort(key=lambda x: x.name)

# 传统方式（unittest）
class TestUser(unittest.TestCase):
    def setUp(self):
        self.db = create_db()      # 每一个测试方法都得写 self.db

    def test_name(self):
        assert self.db.get_user(1).name == "alice"

# pytest 方式
def test_name(db):            # 参数名叫 db → pytest 去找名叫 db 的 fixture
    assert db.get_user(1).name == "alice"

@pytest.fixture(scope="function")  # 默认：每个测试函数一个实例
def user(): ...

@pytest.fixture(scope="class")     # 一个测试类内共享
def class_db(): ...

@pytest.fixture(scope="module")    # 一个测试文件内共享
def module_config(): ...

@pytest.fixture(scope="session")   # 一次 pytest 运行全程共享
def session_db(): ...

@pytest.fixture(scope="module")
def db_conn():
    conn = create_connection()
    yield conn          # ← 这里返回 fixture 值
    conn.close()        # ← 模块所有测试跑完后自动执行

# unittest 风格
self.assertEqual(a, b)
self.assertIn(item, list)
self.assertRaises(ValueError, func)

# pytest 风格
assert a == b
assert item in list
with pytest.raises(ValueError):
    func()

# src/user_service.py
class UserService:
    def __init__(self, db):
        self.db = db

    def get_user_name(self, user_id):
        user = self.db.get_user(user_id)
        return user["name"] if user else None

# tests/conftest.py
import pytest

@pytest.fixture
def db():
    """模拟数据库"""
    data = {}
    def get_user(uid):
        return data.get(uid)
    class MockDB:
        get_user = staticmethod(get_user)
        def add_user(self, uid, name):
            data[uid] = {"id": uid, "name": name}
    return MockDB()

@pytest.fixture
def service(db):
    """注入带模拟数据库的服务"""
    from src.user_service import UserService
    return UserService(db)

def pytest_collection_modifyitems(config, items):
    """Hook：所有测试打标记（第五层·Hook隐身术）"""
    for item in items:
        print(f"  收集到: {item.nodeid}")

# tests/test_user.py
def test_get_existing_user(service, db):     # 参数 = fixture 名（第六层·参数注入）
    db.add_user(1, "Alice")
    assert service.get_user_name(1) == "Alice"  # 直接用 assert（第七层）

def test_get_nonexistent_user(service):
    name = service.get_user_name(999)
    assert name is None  # 不是 self.assertIsNone

# tests/integration/conftest.py
import pytest

@pytest.fixture
def db():
    """覆盖父级 conftest：换成真实数据库"""
    import sqlite3
    conn = sqlite3.connect(":memory:")
    conn.execute("CREATE TABLE users (id INT, name TEXT)")
    yield conn
    conn.close()

# service fixture 从 tests/conftest.py 自动继承

# tests/integration/test_api.py
def test_real_insert(service, db):
    db.execute("INSERT INTO users VALUES (1, 'Alice')")
    # service fixture 来自 tests/conftest.py（继承）
    # db fixture 来自 tests/integration/conftest.py（覆盖）
    assert service.get_user_name(1) == "Alice"