find_py_modules?

AFAICT, there is no find_py_modules() function that could be used as value to setup(py_modules=...), similarly to how one can use setup(packages=find_packages()).

Such a function would be a useful addition, providing benefits similar to find_packages().

[pganssle]

Ah, no, I meant the opposite. py_modules is for when your source tree is basically a single Python file. There are no submodules, and if you’re doing things right, it’s a 1-element list. In such a simple module, you don’t need a function to find all the files that you want to package up, because the list is and always will be one item (once you get to 2 items, you need to refactor into a module with an __init__.py, because now you have to have submodules). It’s not that it’s too hard to write (though making a perfectly general version of this that does the right thing might be hard), it’s that it’s unnecessary because this is not something that needs to be done programmatically.

In my opinion, ideally you also wouldn’t need find_packages, since most people just want to use their folder structure as the module structure unchanged (like it is if you import from the module when your CWD is at the base of the repo and you aren’t using the src layout), but that has its own problems (for example many modules put a tests submodule that isn’t shipped with the package, which is also an anti-pattern in my opinion), and in any case it would be a major backwards-incompatible change.

We can leave the ticket open for a bit so other people can weigh in, but I’m definitely -1 on this idea. The only realistic use case would be an anti-pattern, and it has the potential to cause a lot of problems if used incorrectly (and most people will just guess how it’s supposed to be used based on the name, not look up the documentation on it).

[pganssle]

I don’t think it makes sense to do that. I personally find find_packages very dangerous, but it’s necessary because you need to specify all modules and submodules for your package. The fact that you can have modules nested under other modules is why it’s necessary to have a function that recursively finds modules.

py_modules is for python files that are themselves modules. In general, the best practice would be to have exactly one of these, and it’s very likely that you have other .py files in your root directory that are not intended to be used as modules, so find_py_modules would be even more dangerous than find_packages but with none of the benefits.

That said, do you have a specific use case in mind?