How can I run a uv pytest tool with proper dependencies and module paths?

Question

Directory Structure

project-root/
├── src/
│ ├── file1.py
│ ├── file2.py
└── tests/
│ ├── test_file1.py
│ ├── test_file2.py
├── requirements.txt
├── pyproject.toml

So basically, under the project root, I have the source codes as src/*.py, test scripts as tests/*.py and the requirements.txt that gives the python packages such as tensorflow==2.18.0

Goal

At the project root directory, run

uv tool run pytest

and all the tests from tests/*.py will be run to log the output to the console.

Difficulties

I am facing two difficulties here, related to the import path, and dependencies.

Import Path

Basically, as follows.

# test_file1.py

from file1 import Class1 # Fails, but this would be my first preference to import
from src.file1 import Class1 # Still fails

How can I import classes and functions defined in src/*.py to the files in the tests? I tried

uv pip install --editable ./

The command run successfully, but did not help, and the classes in the source files are still not visible in the test directory.

Dependency Resolution

I am installing the pip dependencies with

time uv pip install --requirement requirements.txt

which is working for the source code. But it seems the pytest tool cannot see those dependencies, so it is complaining like

ModuleNotFoundError: No module named 'tensorflow'

Note

As I said, uv is my preferred tool for packaging, so it is best if the answer sticks to this framework instead of introducing Poetry or something.

Have you tried adding sys.path to src?

Coco Q.
– Coco Q.

2025-03-13 11:39:25 +00:00
Commented Mar 13 at 11:39 — Coco Q.
– Coco Q., Commented Mar 13 at 11:39

Moisés do Nascimento · Accepted Answer · 2025-03-16 20:43:57Z

6

Complete answer can be found here;

But you can simply create _init_.py file under tests directory!

Secondary fix is to add this to your pyproject.toml:

[tool.pytest.ini_options]
pythonpath = ["."]

edited Mar 16 at 20:43

answered Mar 16 at 20:42

Moisés do Nascimento

691 silver badge3 bronze badges

Sign up to request clarification or add additional context in comments.

1 Comment

Peter Jun 12 at 14:45

Note that this refers to a different question. uv tool run pytest is not the same as uv run pytest.

Peter · Accepted Answer · 2025-06-12 14:47:42Z

2

You should probably not use uv tool run pytest, but uv run pytest. When you run pytest as a tool, it is installed in a separate isolated virtual environment. Since pytest relies on the dependencies, it should run in a virtual environment with the package and dependencies installed. See the second note on this page: https://docs.astral.sh/uv/guides/tools/.

answered Jun 12 at 14:47

Peter

3,3541 gold badge14 silver badges10 bronze badges

1 Comment

bearoplane Sep 22 at 7:04

This fixed my failing tests. Targeting my local directory (in this case a uv workspace) with uvx pytest . fails, where uv run pytest after installing it pytest as a dev dependency (uv add --dev pytest) succeeds. This should be the accepted answer.

Collectives™ on Stack Overflow

How can I run a uv pytest tool with proper dependencies and module paths?

Directory Structure

Goal

Difficulties

Import Path

Dependency Resolution

Note

2 Answers 2

1 Comment

1 Comment

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

Directory Structure

Goal

Difficulties

Import Path

Dependency Resolution

Note

2 Answers 2

1 Comment

1 Comment

Your Answer

Sign up or log in

Post as a guest

Related