Auto-detect src and/or test directories

Some people keep their source in a src directory and some people keep their tests in test. This seems to up often enough that we should either detect this and automatically do something or warn people they should create a .env file that manipulates their PYTHONPATH to include the appropriate directories.

[brettcannon]

https://twitter.com/r1chardj0n3s/status/1019521759156924416 suggests at least on Twitter people like to use src.

[uchuugaka]

When you follow the same import rules as Python, it is really simple. A file or package in the same directory should be importable normally in the current file. It’s really not much to ask to silence an incorrect warning that all other editors seem to get right.

On Jun 5, 2020, at 13:35, Jake Bailey [e-mail] wrote:

Nobody is going to use src and test directories all the time, it forces an unrealistic directory structure on Python projects.

This issue is about auto-detection. If you do not use this structure (most projects do not use src, many use test), you are not affected. The language server has done this for about 8 months to good effect. Jedi’s import resolution is looser, and may resolve things more forgivingly. Other tooling (like linters) may or may not be able to do this yet.

Seems more like we need the app to recognize local modules the same way Python itself does without going through hoops of setting up additional, unnecessary files.

This is a pretty difficult thing to get correct in all cases. The biggest offenders are scripts; it’s not generically possible to know if any given .py file is intended to be imported from somewhere else or run as a script, nor can we really know from where a user is intending to run their code (where imports are rooted, which we typically assume to be the workspace root). If it’s a script, then the interpreter will add the script’s directory as a search path. But the editor doesn’t know this is going to happen 100% of the time. Tools like pytest may also modify the search path. And if the user has a src directory, or some other format, it can’t know for certain if a given import is going to resolve or not.

Anything automatic/default is a heuristic to be improved, but the notion of configuring search paths is not uncommon in editors that need to handle Python, as there is no perfect algorithm that can both provide good feedback about errors and handle the wide range of cases.

— You are receiving this because you commented. Reply to this email directly, view it on GitHub, or unsubscribe.