pytest.ini configuration

Introduction

pytest.ini helps you set up rules and options for running tests easily. It saves time by keeping settings in one place.

You want to run tests with specific options every time without typing them.

You need to ignore some files or folders during testing.

You want to change how pytest shows test results.

You want to add markers to group or skip tests.

You want to set the minimum pytest version required.

Syntax

PyTest

[pytest]
addopts = <options>
markers =
    <marker1>: <description>
    <marker2>: <description>
python_files = <pattern>
python_classes = <pattern>
python_functions = <pattern>
minversion = <version>
filterwarnings = <warning rules>

The file is named pytest.ini and placed in your project root.

Indent marker descriptions with 4 spaces for readability.

Examples

This example runs tests verbosely and stops after 2 failures. It defines two markers and looks for test files starting with test_.

PyTest

[pytest]
addopts = -v --maxfail=2
markers =
    slow: marks tests as slow
    smoke: marks smoke tests
python_files = test_*.py
minversion = 6.0

This example shortens tracebacks and ignores deprecation warnings during tests.

PyTest

[pytest]
addopts = --tb=short
filterwarnings = ignore::DeprecationWarning

Sample Program

This pytest.ini file sets verbose output, stops after one failure, defines a 'fast' marker, looks for test files starting with 'test_', and requires pytest version 6.0 or higher.

PyTest

[pytest]
addopts = -v --maxfail=1 --tb=short
markers =
    fast: marks fast tests
python_files = test_*.py
minversion = 6.0

Important Notes

Always place pytest.ini in the root folder of your project.

Use markers to organize tests and run specific groups easily.

Keep your addopts simple to avoid confusion when running tests manually.

Summary

pytest.ini stores test run settings in one file.

You can set options like verbosity, failure limits, and test file patterns.

Markers help label tests for easier selection.

Practice

1. What is the primary purpose of the pytest.ini file in a pytest project?

easy

A. To install pytest dependencies automatically

B. To store configuration settings for pytest test runs

C. To write test functions and test cases

D. To generate test reports after running tests

Solution

1. Step 1: Understand pytest.ini role

   The pytest.ini file is used to configure pytest behavior before running tests.

2. Step 2: Differentiate from other files

   Test functions are written in Python files, not in pytest.ini. Dependency installation and report generation are handled elsewhere.

3. Final Answer:

   To store configuration settings for pytest test runs -> Option B

4. Quick Check:

   pytest.ini = config file [OK]

Hint: pytest.ini holds settings, not test code or reports [OK]

Common Mistakes:

• Confusing pytest.ini with test script files
• Thinking pytest.ini installs packages
• Assuming pytest.ini generates reports

2. Which of the following is the correct way to set the verbosity level to 2 in pytest.ini?

easy

A. [pytest]
addopts = -vv

B. [pytest]
verbosity = 2

C. [pytest]
verbosity: 2

D. [pytest]
addopts = --verbosity=2

Solution

1. Step 1: Recall pytest verbosity setting

   pytest uses addopts to pass command-line options like -vv for verbosity level 2.

2. Step 2: Check syntax correctness

   [pytest] addopts = -vv correctly uses addopts = -vv. [pytest] verbosity = 2 uses an invalid key verbosity. [pytest] verbosity: 2 uses wrong syntax with colon. [pytest] addopts = --verbosity=2 uses an invalid flag.

3. Final Answer:

   [pytest] addopts = -vv -> Option A

4. Quick Check:

   Verbosity level 2 via addopts = -vv [OK]

Hint: Use addopts with -vv for verbosity level 2 in pytest.ini [OK]

Common Mistakes:

• Using 'verbosity' instead of 'addopts'
• Incorrect syntax with colon instead of equals
• Using unsupported flags like --verbosity

3. Given this pytest.ini content:

[pytest]
markers = slow: marks tests as slow
          smoke: marks smoke tests
addopts = -rs

What will be the effect of running pytest with this configuration?

medium

A. Tests marked as slow or smoke will be skipped automatically

B. pytest will run tests with no output

C. Only tests marked as slow will run

D. pytest will show extra summary info for skipped and failed tests

Solution

1. Step 1: Understand markers and addopts

   The markers section defines labels for tests but does not skip them automatically. The addopts = -rs option tells pytest to show extra summary info for skipped and failed tests.

2. Step 2: Analyze each option

   Tests marked as slow or smoke will be skipped automatically is wrong because markers alone don't skip tests. Only tests marked as slow will run is wrong because no selection is made. pytest will run tests with no output is wrong because -rs increases output detail.

3. Final Answer:

   pytest will show extra summary info for skipped and failed tests -> Option D

4. Quick Check:

   addopts = -rs shows skip/fail summary [OK]

Hint: addopts = -rs shows skip and fail summaries [OK]

Common Mistakes:

• Thinking markers skip tests automatically
• Confusing addopts flags with test selection
• Assuming no output with -rs option

4. You added this to your pytest.ini file:

[pytest]
markers = regression
addopts = --maxfail=3

But when you run pytest, you get an error: ERROR: unknown option: --maxfail=3
What is the most likely cause?

medium

A. The addopts line should use -maxfail=3 instead

B. The pytest.ini file is missing the [pytest] header

C. The pytest version is outdated and does not support --maxfail

D. Markers must be defined after addopts in pytest.ini

Solution

1. Step 1: Understand the error message

   The error says unknown option: --maxfail=3, meaning pytest does not recognize this option.

2. Step 2: Check possible causes

   The addopts line should use -maxfail=3 instead is wrong because --maxfail requires two dashes. The pytest.ini file is missing the [pytest] header is wrong because the header is present. Markers must be defined after addopts in pytest.ini is wrong because order does not matter. The most common cause is an outdated pytest version that lacks support for --maxfail.

3. Final Answer:

   The pytest version is outdated and does not support --maxfail -> Option C

4. Quick Check:

   Unknown option usually means outdated pytest [OK]

Hint: Unknown option often means pytest version too old [OK]

Common Mistakes:

• Changing option syntax incorrectly
• Forgetting to include [pytest] header
• Thinking order of keys matters in pytest.ini

5. You want to configure pytest.ini to:
1. Mark tests with slow and critical labels.
2. Run only tests matching the pattern test_*.py.
3. Stop after 2 failures.

Which of the following pytest.ini configurations achieves all three correctly?

hard

A. [pytest]
markers = slow: slow tests
critical: critical tests
python_files = test_*.py
addopts = --maxfail=2

B. [pytest]
markers = slow
critical
python_files = test_*.py
addopts = -x --maxfail=2

C. [pytest]
markers = slow: slow tests
critical: critical tests
python_files = test_*.py
addopts = -x --maxfail=2

D. [pytest]
markers = slow: slow tests
critical: critical tests
python_files = test_*.py
addopts = --maxfail=2 -x

Solution

1. Step 1: Check markers syntax

   Options A, C, and D correctly define markers with descriptions. [pytest] markers = slow critical python_files = test_*.py addopts = -x --maxfail=2 lacks descriptions, which is allowed but less clear.

2. Step 2: Verify test file pattern

   All options set python_files = test_*.py correctly.

3. Step 3: Confirm failure stop and run options

   [pytest] markers = slow: slow tests critical: critical tests python_files = test_*.py addopts = --maxfail=2 uses addopts = --maxfail=2 which stops after 2 failures but does not stop immediately on first failure. Options C and D add -x which stops after first failure, conflicting with requirement to stop after 2 failures. [pytest] markers = slow critical python_files = test_*.py addopts = -x --maxfail=2 lacks descriptions in markers.

4. Final Answer:

   Markers with descriptions, correct python_files, and stop after 2 failures -> Option A

5. Quick Check:

   Use --maxfail=2 without -x to stop after 2 failures [OK]

Hint: Use --maxfail=2 without -x to stop after 2 failures [OK]

Common Mistakes:

• Adding -x stops after 1 failure, not 2
• Omitting marker descriptions
• Misconfiguring python_files pattern