docs: made uvx note more explict

[ZeyadMoustafaKamal]

Summary

I used uvx to test my code using pytest it was just before the documentation and it worked pretty fine. But when I saw the docs I was confused as it says:

If you are running a tool in a project and the tool requires that your project is installed, e.g., when using pytest or mypy, you'll want to use uv run instead of uvx. Otherwise, the tool will be run in a virtual environment that is isolated from your project.

So to make it simple if you don't recommend using uvx in this situation then here is the pull request, and if not just close this pull request. I said that I don't have to open an issue to discuss this as it's so simple.

Test Plan

None

[zanieb]

Does pytest actually work here? You're in a project and running uvx pytest and your tests import your project? Are you using a flat project structure?

[ZeyadMoustafaKamal]

well here is the project I used clone it and see if this is the same thing you were talking about.

[zanieb]

Yeah this is because you're using a flat project structure, so the project can be imported without being installed (vs e.g., using src/<module> for your code)

[zanieb]

I can try to improve the docs here.

[ZeyadMoustafaKamal]

fine. and thanks a lot for your hard work.

[ZeyadMoustafaKamal]

Also I think we can close this now or what you think

[zanieb]

Thanks for sharing! I'm a bit confused but it sounds like we are missing something here.

[zanieb]

"e.g., when using pytest or mypy with your code in a src/ directory"

[ZeyadMoustafaKamal]

I think we should use the term 'flat project' instead of saying the src directory. If someone didn't know what it means like me they can search for it.

[zanieb]

Okay, that's fine with me — want to make that change here and we can merge your pull request?

[ZeyadMoustafaKamal]

fine.

[ZeyadMoustafaKamal]

done