✨ Add support for python -m gunicorn

[tiangolo]

✨ Add support for python -m gunicorn.

This just adds a simple __main__.py replicating the script defined in setup.py.

That adds support for python -m gunicorn, as described here in the Python docs.

It is useful when python or equivalent is available as a command but gunicorn is not, even though it is installed and available to import. And where the idea is still to call it from the CLI and not importing and running from code... 🤷‍♂️

I know that sounds contrived, but the specific use case is Pex: https://pex.readthedocs.io/

It is based on "zip applications" from this PEP 441.

So, it would be called like:

$ ./some-binary-pex-file -m gunicorn

[tilgovi]

Thanks! Great idea.

[jamadden]

I think this is a great idea too!

Should this be documented (EDIT: and tested) somewhere?

[tilgovi]

Good point, @jamadden :)

[tiangolo]

Thanks! 🚀

---

About documenting it, let me know if you would like it to be explicitly stated, probably as a small note somewhere. Right now it would just work like e.g. pip or python -m pip.

I also understand that python -m gunicorn would not be the "canonical form" to call it, and I admit it is a rather "exotic" use case 😅 , so you might also want to just leave it out of the docs, just to not confuse users (I've done that in FastAPI 🤷‍♂️ ), but let me know if you prefer to have it explicit somewhere.

---

About tests, I didn't find something to test the CLI behavior to try and include this there, the option I would think of would be a subprocess calling Python directly and checking the string from something like:

python -m gunicorn --version
__main__.py (version 20.0.4)

That's what I do for testing some corner cases in Typer. But that could mean an extra layer of complexity and a bit of time increase for the tests (probably just a couple of secs though). If that sounds fine for you, I can sketch a PR with it. On the other side, do you have an idea of a better/different approach that you would prefer?

[di]

+1 to documenting this somewhere, at the very least in the changelog (but it looks like this just gets updated on release?)