Why Markers for categorization in Selenium Python? - Purpose & Use Cases

The Big Idea

What if you could run only the tests you need with a simple label?

The Scenario

Imagine you have a big set of tests for a website. You want to run only the tests about login today, but you have to open each test file and find those tests manually.

The Problem

Doing this by hand is slow and easy to mess up. You might forget some tests or run the wrong ones. It feels like searching for a needle in a haystack every time.

The Solution

Markers let you tag tests with labels like 'login' or 'slow'. Then you can tell your test tool to run only tests with a certain tag. This saves time and avoids mistakes.

Before vs After

✗ Before

def test_login():
    # no marker, must find manually
    pass

def test_logout():
    pass

✓ After

@pytest.mark.login
def test_login():
    pass

@pytest.mark.logout
def test_logout():
    pass

What It Enables

You can quickly run just the tests you want, making testing faster and more organized.

Real Life Example

A team working on a shopping site runs only 'payment' tests before a release to be sure checkout works, without waiting for all tests.

Key Takeaways

Manual test selection is slow and error-prone.

Markers tag tests for easy grouping and running.

Markers help run focused tests quickly and reliably.

Practice

1. What is the main purpose of using markers in pytest with Selenium tests?

easy

A. To write test cases faster

B. To label and organize tests for selective running

C. To automatically fix test failures

D. To generate test reports

Solution

1. Step 1: Understand what markers do

   Markers are used to label tests so you can group or select them easily.

2. Step 2: Identify the main purpose

   This helps run only certain tests or skip some, improving test control.

3. Final Answer:

   To label and organize tests for selective running -> Option B

4. Quick Check:

   Markers = Organize tests [OK]

Hint: Markers help pick which tests to run or skip [OK]

Common Mistakes:

• Thinking markers speed up writing tests
• Believing markers fix test errors automatically
• Confusing markers with report generation

2. Which is the correct way to add a marker named smoke to a test function in pytest?

easy

A. @pytest.mark.smoke\ndef test_example(): pass

B. @pytest.mark('smoke')\ndef test_example(): pass

C. @pytest.mark[smoke]\ndef test_example(): pass

D. @pytest.mark->smoke\ndef test_example(): pass

Solution

1. Step 1: Recall pytest marker syntax

   Markers use dot notation: @pytest.mark.marker_name above the test.

2. Step 2: Match syntax to options

   Only @pytest.mark.smoke\ndef test_example(): pass uses correct dot notation without extra symbols.

3. Final Answer:

   @pytest.mark.smoke\ndef test_example(): pass -> Option A

4. Quick Check:

   Marker syntax = dot notation [OK]

Hint: Use dot notation: @pytest.mark.marker_name [OK]

Common Mistakes:

• Using parentheses instead of dot notation
• Using brackets or arrows incorrectly
• Missing the @ symbol before pytest.mark

3. Given this pytest code snippet, what tests will run if you execute pytest -m smoke?

@pytest.mark.smoke
def test_login(): pass

@pytest.mark.regression
def test_checkout(): pass

def test_search(): pass

medium

A. Only test_login

B. Only test_checkout

C. Both test_login and test_checkout

D. All three tests

Solution

1. Step 1: Understand pytest -m option

   The -m option runs tests with the given marker only.

2. Step 2: Identify tests with 'smoke' marker

   Only test_login has @pytest.mark.smoke.

3. Final Answer:

   Only test_login -> Option A

4. Quick Check:

   pytest -m smoke runs smoke tests only [OK]

Hint: -m runs tests with matching marker only [OK]

Common Mistakes:

• Running all tests ignoring markers
• Confusing marker names
• Assuming unmarked tests run with any marker

4. You wrote this test with a marker but it does not run when you use pytest -m regression. What is the error?

@pytest.mark.regresion
def test_payment(): pass

medium

A. Test function name is incorrect

B. Missing @ symbol before pytest.mark

C. Marker name is misspelled

D. pytest -m cannot run marked tests

Solution

1. Step 1: Check marker spelling

   The marker used is 'regresion' but command uses 'regression'.

2. Step 2: Understand effect of misspelling

   pytest -m regression won't find tests marked 'regresion', so test is skipped.

3. Final Answer:

   Marker name is misspelled -> Option C

4. Quick Check:

   Marker spelling must match exactly [OK]

Hint: Check marker spelling matches command exactly [OK]

Common Mistakes:

• Typos in marker names
• Forgetting @ before pytest.mark
• Assuming pytest runs all marked tests without -m

5. You want to run all tests except those marked slow. Which pytest command should you use?

hard

A. pytest -m slow

B. pytest --exclude slow

C. pytest --skip slow

D. pytest -m "not slow"

Solution

1. Step 1: Understand pytest marker expressions

   To exclude tests with a marker, use -m "not marker_name" syntax.

2. Step 2: Match command to requirement

   pytest -m "not slow" uses "not slow" to run all tests except those marked slow.

3. Final Answer:

   pytest -m "not slow" -> Option D

4. Quick Check:

   Use -m "not marker" to exclude tests [OK]

Hint: Use -m "not marker" to skip marked tests [OK]

Common Mistakes:

• Using -m marker to run only those tests
• Using unsupported --skip or --exclude options
• Not quoting the expression with spaces