[Python] Can you include a standalone executable in a Python package with pyproject.toml?

Looking at Python packaging with pyproject.toml, I wonder whether it is possible to add a standalone executable (with #!/usr/bin/env python in the first line) to pyproject.toml, without going for a [project.scripts] entrypoint definition and the corresponding auto-generated wrapper. Do I understand right that pyproject.toml supports only the [project.scripts] entrypoint definitions as a way to define executables?

I don't have anything against the entrypoints. It makes the definition of Python executables platform-independent. But it's just a curious aspect of pyproject.toml.

Specifically, is it possible to have a project like this:

pyproject.toml
my_executable.py
my_packet/
__init__.py
my_module.py


Where my_executable.py has the +x permissions bits for execution and contains code like this:

#!/usr/bin/env python
from my_packet.my_module import func

def main():
return func()

if __name__ == '__main__':
main()


For completeness, the same in the entrypoint way:

pyproject.toml
my_packet/
__init__.py
my_module.py
my_executable.py


With pyproject.toml:

...
[project.scripts]
my-executable = "my_packet.my_executable:main"


Where my_executable.py is:

from my_packet.my_module import func

def main():
return func()

# may not have if __name__ at all
# or contain not application code
# like some tests


Then the executable gets generated during installation. And it looks like this:

#!/home/.../my_venv/bin/python
# -*- coding: utf-8 -*-
import re
import sys
from my_packet.my_executable import main
if __name__ == '__main__':
sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
sys.exit(main())

Continue reading...