How to Fix Import Error in pytest: Simple Solutions

Import errors in pytest usually happen because Python cannot find the module or test file. To fix this, ensure your test files are in the correct folder, your PYTHONPATH is set properly, and use relative imports or add the project root to sys.path.

Why This Happens

Import errors in pytest occur when Python cannot locate the module or file you want to test. This often happens if your test files are not in the right folder or if Python's search path does not include your project directory.

python

import mymodule

def test_func():
    assert mymodule.add(2, 3) == 5

Output

ImportError: No module named 'mymodule'

The Fix

To fix import errors, place your test files inside your project folder or a tests folder. Use relative imports if needed, or add your project root to sys.path in your test files. Also, run pytest from the project root directory.

python

import sys
import os
sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '..')))
import mymodule

def test_func():
    assert mymodule.add(2, 3) == 5

Output

============================= test session starts =============================
collected 1 item

test_sample.py .                                                          [100%]

============================== 1 passed in 0.01s ==============================

Prevention

Always organize your project with a clear folder structure, such as placing tests in a tests folder. Run pytest from the project root to ensure Python finds modules correctly. Use relative imports or configure PYTHONPATH if needed. Consider using pytest.ini to set the Python path or add __init__.py files to make folders packages.

Related Errors

Other common errors include ModuleNotFoundError when a module is missing, or AttributeError if you import the module but call a wrong function. Fix these by checking module names, function names, and your environment setup.

Key Takeaways

Run pytest from your project root folder to avoid import errors.

Add your project directory to sys.path in tests if imports fail.

Organize tests in a dedicated folder and use relative imports.

Use pytest.ini or environment variables to configure Python paths.

Check module and function names carefully to prevent related import errors.