Stabilize 'build.py'

• I have searched the issues of this repo and believe that this is not a duplicate.
• I have searched the documentation and believe that my question is not covered.

Feature Request

In order to compile C-extensions, it is currently required to add a build script to the project directory and to pyproject.toml:

[tool.poetry]
build = "build.py"

This feature is described in #11, but not in the official Poetry documentation. So my question is whether this feature is stable. If this is the case, I would like to propose to include it in the official documentation.

[medley56]

It sounds like there are some design decisions to be made around this (e.g. how much to automate vs how much responsibility to put on the build.py script) but it seems like a really crucial feature to support building extensions both during poetry install and poetry build in a consistent and documented way. I vote to prioritize this. I’m currently evangelizing poetry within my organization but it will be a hard sell without a supported way to build extensions.

[davidcortesortuno]

I’m using setuptools and cython, does this help? https://github.com/davidcortesortuno/poetry_cython_proj/blob/main/build.py