Selenium × pytest 실천 가이드｜fixture・parametrize・conftest.py・mark를 실무 수준으로 해설

Selenium × pytest에서 자주 사용하는 4가지 기능——fixture・parametrize・conftest.py・mark——을 실무 수준의 샘플 코드와 함께 해설합니다.

pytest의 fixture・parametrize・mark를 익히면 Selenium 테스트를 「단발 스크립트」에서 「유지보수하기 쉬운 테스트 스위트」로 개선할 수 있습니다.

이 글에서는 실무에서 바로 사용할 수 있는 구성을 코드와 함께 소개합니다.

👉 전제：Selenium × Python 환경 구축이 완료되어 있는 것을 전제로 합니다. 아직인 분은 환경 구축 가이드를 먼저 확인하세요.

Selenium 테스트에는 「일단 동작한다」에서 「팀에서 사용할 수 있고 CI에서 돌릴 수 있는」 수준까지의 벽이 있습니다. 그 벽을 넘는 것이 pytest의 fixture・parametrize・mark를 익히는 것입니다.

Selenium × pytest 전체 구성이란？

폴더 구성

먼저 전체 폴더 구성과 각 파일의 역할을 파악합니다.

selenium-project/
├── venv/
├── tests/
│   ├── conftest.py          # WebDriver fixture・공통 설정
│   ├── test_login.py        # 로그인 테스트
│   ├── test_search.py       # 검색 테스트
│   └── test_register.py     # 회원 가입 테스트
├── pages/
│   └── login_page.py        # Page Object（별도 글에서 해설합니다）
├── requirements.txt
└── pytest.ini

각 파일의 역할

STEP 1：pytest fixture란？conftest.py로 Selenium WebDriver를 공통화하는 방법

conftest.py에 WebDriver의 fixture를 정의함으로써 모든 테스트 파일에서 공유할 수 있습니다.

# tests/conftest.py
import pytest
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager

@pytest.fixture(scope="function")
def driver():
    """테스트마다 Chrome을 기동・종료하는 fixture"""
    options = webdriver.ChromeOptions()
    # options.add_argument("--headless")  # CI/CD 환경에서는 ON으로 한다
    options.add_argument("--no-sandbox")            # Linux/CI 환경용
    options.add_argument("--disable-dev-shm-usage") # Linux/CI 환경용
    options.add_argument("--window-size=1920,1080")

    service = Service(ChromeDriverManager().install())
    driver = webdriver.Chrome(service=service, options=options)
    driver.implicitly_wait(10)  # 요소 검색 시 기본 대기（보조적 용도）

    yield driver

    try:
        driver.quit()
    except Exception:
        # 세션 절단 시에도 teardown이 실패하지 않도록 보호
        pass


@pytest.fixture(scope="function")
def logged_in_driver(driver):
    """로그인 상태가 필요한 테스트 전용 fixture.
    로그인 불필요한 테스트에는 driver fixture를 직접 사용할 것."""
    # ※ example-app.com은 샘플 URL입니다. 실제 테스트 대상 URL로 변경하세요.
    driver.get("https://example-app.com/login")
    driver.find_element(By.ID, "username").send_keys("test_user")
    driver.find_element(By.ID, "password").send_keys("test_pass")
    driver.find_element(By.ID, "login-btn").click()

    # 로그인 완료를 대기（이것이 없으면 CI 환경에서 불안정해진다）
    WebDriverWait(driver, 10).until(
        EC.url_contains("/dashboard")
    )

    yield driver
    # teardown（driver.quit()）은 driver fixture 측에서 수행하므로 여기서는 불필요

# 로그인 상태가 필요한 테스트에만 logged_in_driver를 사용
def test_dashboard_title(logged_in_driver):
    assert "대시보드" in logged_in_driver.title

# 로그인 불필요한 테스트는 driver를 직접 사용
def test_top_page_title(driver):
    driver.get("https://example-app.com")
    assert "홈" in driver.title

STEP 2：Selenium 테스트 작성법（정상 계통・이상 계통）

base_url fixture를 인수로 받음으로써 URL을 한 곳에서 관리할 수 있습니다. 하드코딩 없이 환경별 전환도 fixture 측에서만 대응할 수 있게 됩니다.

# tests/test_login.py
# ※ 이후 코드에서도 동일한 import를 사용합니다
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

# ── 정상 계통 ──────────────────────────────────────
def test_login_success(driver, base_url):
    """정상 계통：올바른 ID・PW로 로그인 성공한다"""
    driver.get(f"{base_url}/login")
    driver.find_element(By.ID, "username").send_keys("valid_user")
    driver.find_element(By.ID, "password").send_keys("valid_pass")
    driver.find_element(By.ID, "login-btn").click()

    WebDriverWait(driver, 10).until(EC.url_contains("/dashboard"))
    assert "/dashboard" in driver.current_url

# ── 이상 계통 ──────────────────────────────────────
def test_login_failure_wrong_password(driver, base_url):
    """이상 계통：패스워드가 틀린 경우 에러 메시지가 표시된다"""
    driver.get(f"{base_url}/login")
    driver.find_element(By.ID, "username").send_keys("valid_user")
    driver.find_element(By.ID, "password").send_keys("wrong_pass")
    driver.find_element(By.ID, "login-btn").click()

    error_msg = WebDriverWait(driver, 10).until(
        EC.visibility_of_element_located(
            (By.CSS_SELECTOR, "[data-testid='login-error']")  # data-testid 권장
        )
    )
    assert "비밀번호가 올바르지 않습니다" in error_msg.text

def test_login_failure_empty_fields(driver, base_url):
    """이상 계통：ID와 PW가 빈 상태로 전송하면 유효성 검사 에러가 나온다"""
    driver.get(f"{base_url}/login")
    driver.find_element(By.ID, "login-btn").click()

    error = WebDriverWait(driver, 10).until(
        EC.visibility_of_element_located((By.CLASS_NAME, "validation-error"))
    )
    assert error.is_displayed()

STEP 3：pytest parametrize에 의한 데이터 기반 테스트 구현

@pytest.mark.parametrize를 사용하면 동일한 테스트 로직을 여러 데이터로 반복 실행할 수 있습니다. 이상 계통의 패턴이 많은 경우에 특히 효과적입니다.

# tests/test_login.py（계속）
import pytest

# 테스트 데이터를 리스트로 정의（로직과 데이터를 분리）
INVALID_LOGIN_CASES = [
    ("", "valid_pass", "사용자명을 입력해 주세요"),
    ("valid_user", "", "패스워드를 입력해 주세요"),
    ("wrong_user", "valid_pass", "인증에 실패했습니다"),
    ("valid_user", "wrong_pass", "비밀번호가 올바르지 않습니다"),
    ("a" * 256, "valid_pass", "입력값이 너무 깁니다"),
]

@pytest.mark.parametrize("username, password, expected_error", INVALID_LOGIN_CASES)
def test_login_validation(driver, base_url, username, password, expected_error):
    """parametrize：여러 이상 계통 패턴을 정리하여 테스트"""
    driver.get(f"{base_url}/login")
    driver.find_element(By.ID, "username").send_keys(username)
    driver.find_element(By.ID, "password").send_keys(password)
    driver.find_element(By.ID, "login-btn").click()

    error_msg = WebDriverWait(driver, 10).until(
        EC.visibility_of_element_located((By.CLASS_NAME, "error-message"))
    )
    assert expected_error in error_msg.text

실행 결과 샘플

pytest tests/test_login.py -v

collected 8 items

test_login.py::test_login_success                                      PASSED
test_login.py::test_login_failure_wrong_password                       PASSED
test_login.py::test_login_failure_empty_fields                         PASSED
test_login.py::test_login_validation[-valid_pass-사용자명을 입력해…]    PASSED
test_login.py::test_login_validation[valid_user--패스워드를 입력해…]   PASSED
test_login.py::test_login_validation[wrong_user-valid_pass-인증에…]    PASSED
test_login.py::test_login_validation[valid_user-wrong_pass-비밀번호…]  PASSED
test_login.py::test_login_validation[aaaa…-valid_pass-입력값이…]       PASSED

========================== 8 passed in 18.34s ==========================

STEP 4：pytest mark로 테스트를 분류・선택 실행한다

@pytest.mark를 사용하면 테스트에 태그를 붙여 특정 그룹만 선택하여 실행할 수 있습니다. CI/CD에서 「스모크 테스트만 실행」「전체 테스트를 실행」하고 싶을 때 필수입니다.

pytest.ini에 커스텀 mark 등록

[pytest]
testpaths = tests
addopts = -v
markers =
    smoke: 스모크 테스트（최우선・매회 실행）
    regression: 리그레션 테스트（전체 확인 시 실행）
    slow: 실행에 시간이 걸리는 테스트

mark를 붙이고 선택 실행

@pytest.mark.smoke
def test_login_success(driver, base_url): ...

@pytest.mark.regression
def test_login_failure_wrong_password(driver, base_url): ...

@pytest.mark.slow
@pytest.mark.regression
def test_login_session_timeout(driver, base_url): ...

# 스모크 테스트만 실행（배포 후 확인에）
pytest -m smoke

# 느린 테스트를 제외하고 실행
pytest -m "not slow"

# smoke이면서 regression（양쪽 mark가 붙은 테스트만）
pytest -m "smoke and regression"

STEP 5：fixture의 응용（셋업・티어다운）

# tests/conftest.py（추가）
import pytest

@pytest.fixture(scope="function")
def go_to_login(driver):
    driver.get("https://example-app.com/login")
    yield driver
    import os, re, time
    os.makedirs("screenshots", exist_ok=True)
    # ※ 실무에서는 pytest_runtest_makereport로 실패 시에만 저장하는 구성이 일반적입니다
    driver.save_screenshot(f"screenshots/{int(time.time())}.png")


@pytest.fixture(scope="session")
def base_url():
    """base_url을 fixture화（환경별 전환이 쉬워진다）
    ※ 이것으로 BASE_URL 상수는 불필요. 모든 테스트에서 이 fixture를 사용할 것."""
    return "https://example-app.com"  # ※ 샘플 URL입니다. 실제 URL로 변경하세요.

import os, re, pytest

@pytest.hookimpl(hookwrapper=True)
def pytest_runtest_makereport(item, call):
    outcome = yield
    report = outcome.get_result()
    if report.when == "call" and report.failed:
        driver = item.funcargs.get("driver")
        if driver:
            os.makedirs("screenshots", exist_ok=True)
            # Windows 금지 문자를 일괄 제거（\ / * ? : " < > |）
            safe_name = re.sub(r'[\\/*?:"<>|]', "_", item.name)
            driver.save_screenshot(f"screenshots/{safe_name}.png")

STEP 6：실천적인 테스트 예시（회원 가입 폼）

# tests/test_register.py
import pytest
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

# ※ 실제 프로젝트에서는 같은 이메일 주소를 반복하면 중복 등록 에러가 됩니다
# 테스트마다 유니크화하는 경우：f"test_{int(time.time())}@example.com"
VALID_USER = {
    "name": "테스트 사용자",
    "email": "test@example.com",
    "password": "SecurePass123!",
}

VALIDATION_CASES = [
    ("name", "", "이름을 입력해 주세요"),
    ("email", "not-an-email", "올바른 이메일 주소를 입력해 주세요"),
    ("email", "", "이메일 주소를 입력해 주세요"),
    ("password", "short", "패스워드는 8자 이상으로 입력해 주세요"),
]

@pytest.fixture
def register_page(driver, base_url):
    """회원 가입 페이지로 이동하는 fixture（base_url fixture로 URL을 통일）"""
    driver.get(f"{base_url}/register")
    yield driver


@pytest.mark.smoke
def test_register_success(register_page):
    """스모크：정상적인 회원 가입이 완료된다"""
    d = register_page
    d.find_element(By.ID, "name").send_keys(VALID_USER["name"])
    d.find_element(By.ID, "email").send_keys(VALID_USER["email"])
    d.find_element(By.ID, "password").send_keys(VALID_USER["password"])
    d.find_element(By.ID, "submit-btn").click()

    success = WebDriverWait(d, 10).until(
        EC.visibility_of_element_located((By.CLASS_NAME, "success-message"))
    )
    assert "등록이 완료되었습니다" in success.text


@pytest.mark.regression
@pytest.mark.parametrize("field, value, expected_error", VALIDATION_CASES)
def test_register_validation(register_page, field, value, expected_error):
    """리그레션：유효성 검사 에러의 패턴 테스트"""
    d = register_page
    d.find_element(By.ID, "name").send_keys(VALID_USER["name"])
    d.find_element(By.ID, "email").send_keys(VALID_USER["email"])
    d.find_element(By.ID, "password").send_keys(VALID_USER["password"])

    target = d.find_element(By.ID, field)
    target.clear()
    target.send_keys(value)
    d.find_element(By.ID, "submit-btn").click()

    error = WebDriverWait(d, 10).until(
        # By.ID로 필드별 에러 요소를 특정（By.CLASS_NAME보다 정밀도가 높다）
        EC.visibility_of_element_located((By.ID, f"{field}-error"))
    )
    assert expected_error in error.text

⚠️ Selenium × pytest에서 자주 있는 실수 7선

tests/
├── conftest.py   ← 여기에 놓는다（tests/ 바로 아래）
└── test_login.py

[pytest]
markers =
    smoke: 스모크 테스트
    regression: 리그레션 테스트

# NG
cd tests && pytest

# OK：프로젝트 루트에서 실행
cd selenium-project
pytest

FAQ

이 글의 구성대로 진행하면 테스트 설계와 테스트 구현이 명확하게 분리된 유지보수하기 쉬운 테스트 스위트가 완성됩니다.

📋 이 글의 정리

먼저 parametrize를 사용하여 기존 테스트의 데이터를 분리하는 것부터 시작해 보세요. 그 하나의 패턴을 구현하는 것만으로 「테스트 설계」와 「테스트 구현」이 분리되어 테스트 스위트 전체의 가독성이 한 번에 좋아집니다.