Date: Sun, 30 Jun 2024 08:34:00 +0000 From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 280061] Porters Handbook: missing important aspects: PEP517 (python) Message-ID: <bug-280061-9@https.bugs.freebsd.org/bugzilla/>
next in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D280061 Bug ID: 280061 Summary: Porters Handbook: missing important aspects: PEP517 (python) Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Severity: Affects Many People Priority: --- Component: Books & Articles Assignee: doc@FreeBSD.org Reporter: ohartmann@walstatt.org The porters handbook is missing an important aspect when using python softw= are utilising pyproject.toml. Wiki (https://wiki.freebsd.org/Python/PortsPolicy) states: [...] USE_PYTHON Features ... pep517 blabla ... (have a pyproject.toml specifying a build backend that builds an installable wheel) ... blabla [...] This feature is only available on Wiki page, but is missing in the official documentation project's pages, found on https://docs.freebsd.org/en/books/porters-handbook/book/ Experience of the past decades left me back considering Wiki pages as outda= ted in some aspects, I guess I'm not the only one, so I may be wrong, also wron= ging the Porters Handbook being the main source of documentation. I'd like to see this mentioned aspect of use_python=3Dpep517 and it's relat= ed pyproject.toml file mentioned in the official documentation. Several github.com based python ports/project use pyproject.toml instead of setup.py. I couldn't find anything about a implicit standard taken when setup.py is missing in the official handbook, so it took me a couple of time finding out about this, unnecessary to mention that it's a steep way to cli= mb for an not-so-skilled-developer. If interested, some Espressif projects in the waters of ESP32 development utilise "PEP517 method" of the installation process . Thank you very much --=20 You are receiving this mail because: You are the assignee for the bug.=
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-280061-9>