docs: improve pyopenssl docs in deploy.rst

cherrypy / cherrypy

CherryPy is a pythonic, object-oriented HTTP framework. https://cherrypy.dev

https://docs.cherrypy.dev

BSD 3-Clause "New" or "Revised" License

1.8k stars 357 forks source link

docs: improve pyopenssl docs in deploy.rst #2031

Open ktdreyer opened 1 month ago

ktdreyer commented 1 month ago

Update the docs to say that builtin is now the default backend.

Give Python examples of how to set both backends (builtin and pyopenssl.)

What kind of change does this PR introduce?

[ ] bug fix
[ ] feature
[x] docs update
[ ] tests/coverage improvement
[ ] refactoring
[ ] other

ktdreyer commented 1 month ago

With the simple "hello world" application, I get better performance with the pyopenssl backend (testing in a container on localhost) so I think that's the main reason users would choose pyopenssl now. Is that right?

webknjaz commented 1 month ago

I'm not sure. I think many people just put it behind a reverse proxy instead of handling TLS in-app. I have a feeling that the pyopenssl integration is a bit more buggy as of the last Cheroot release. I dream of having enough time to refactor both adapters..