search

falconry / falcon

The no-magic web data plane API and microservices framework for Python developers, with a focus on reliability, correctness, and performance at scale.
https://falcon.readthedocs.io/en/stable/
Apache License 2.0
9.5k stars 935 forks source link

Write a packager's guide #2081

Open vytas7 opened 2 years ago

vytas7 commented 2 years ago

It seems that people packaging Falcon for various OSes such as Linux distributions (or just hobby projects) have very different ideas how the process should look like, although PEP 517 was supposed to simplify that.

For instance, how do I test the built binary? It seems some packagers opt to invoke pytest directly without parameters and expect it to work, disregarding our tox environments completely (see: #2080, #2006 etc).

CaselIT commented 2 years ago

Where should this documentation be? A section in readme or a separate file? @kloczek do you have suggestions?

vytas7 commented 2 years ago

Absent better ideas, maybe README could link to a section on RtD.