Tries to import __main__.py

[flying-sheep]

__main__.py doesn’t need a if __name__ == '__main__', since it just exists to be a CLI

Therefore doctestplus shouldn‘t try to import it.

[pllim]

I don't think we can guess what is CLI and what isn't. You can skip a file if you want to.

https://github.com/scientific-python/pytest-doctestplus#skipping-tests

[flying-sheep]

You misunderstand; __main__.py is a standard for defining CLIs in Python.

The content of __main__.py typically isn’t fenced with an if __name__ == '__main__' block. Instead, those files are kept short and import functions to execute from other modules.

There’s no guesswork involved here. Files called __main__.py should not be executed unless you want to run a CLI.

[pllim]

Ah, okay. For some reason, I never encountered this usage myself. Usually it is via entry points. Thanks for the clarification!

[flying-sheep]

Some ubiquitous tools like build or pip encourage usage with python -m pkgname as opposed to their pyproject-build/pip entrypoints.

That results in pkgname/__main__.py being executed.