pytest-case 1.0.0

A clean, modern, wrapper for pytest.mark.parametrize

pytest-case

Usage examples:

import pytest
from typing import Tuple, Generator
from pytest_case import case


def add_test_cases() -> Generator[Tuple[int, int, int]]:
    yield (
        n
        for n in [
            (3, 3, 6),
            (3, 4, 7),
            (-1, 6, 5),
        ]
    )


@case("regular args", 4, 2, 2)
@case(
    "params as kwargs",
    a=2,
    b=2,
    expected=1,
)
@case('with expected fail', 1, 0, -1, mark=pytest.mark.xfail)
@case(add_test_cases())
def test__divide(a: int, b: int, expected: int) -> None:
    assert expected == a / b

Features

Default Arguments Values

@case("Check for Failure", val="Failure")
@case("Check for success", val="Success", sanity="Success")
def test__with_default(val: str, sanity: str = "Failure") -> None:
    assert sanity == val

Generator Case

from itertools import product
from pytest_case import case

@case(product(
    ("Chrome", "Firefox", "Safari"), 
    ("Windows", "macOS", "Linux")
))
def test__browser_os_compatibility(browser: str, operating_system: str) -> None:
    # Will generate cases:
    # ("Chrome", "Windows"), ("Chrome", "macOS"), ("Chrome", "Linux"), ("Firefox", "Windows"), ...
    pass

Using Fixtures

• Using pytest built-in request fixture.

  def test__with_request_fixture(request: Any) -> None:
      fixture_value = request.getfixturevalue("fixture_name")
      ...
  

• Using pytest-lazy-fixtures

  from pytest_case import case
  from pytest_lazy_fixtures import lf
  
  
  @case("Lazy Fixture Case", lf("fixture_name"))
  def test__with_lf_cases(fixture_val: Any) -> None
      ...
  

Project Roadmap:

These are the the predicted checkpoints for this project:

• Test Arguments Default Values That would be cool!
• Test Marks Marks that are currently supported by pytest, such as: xfail, skip, ...
• Tests Cases Generators Provide a generator function to the case to automatically generate cases.
• Use Fixtures Use fixtures in cases and tests
• Tests Samples Generation Generate parameters to catch edge-cases, based on restrictions or datasets.