From nobody Sun Jun 30 08:34:00 2024 X-Original-To: doc@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4WBjBc5kbDz5P8fB for ; Sun, 30 Jun 2024 08:34:00 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4WBjBc3tYGz4Qkm for ; Sun, 30 Jun 2024 08:34:00 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1719736440; a=rsa-sha256; cv=none; b=nMjbzPc3TD56hw1JLJs3hxrIB/KYPS2unT1NHb6gJtjNilyRg/FOG/YUt198Vb8sNUrOLE H5wZdCm+6TB11DbBi5JCQhyzp66m/AN/yYHxStVKnzSYWsQAVZKXRTkmauwB7QRpNK2q03 c5Koa5utUWxFVRRqtpO72/hBW+KrCLfkY9nhmG92ANcwNmdFf9Tc6TwO6N55mLkUc4p9YF 1YvcotLxVk9S77PlwX2qrlKQxvI16NbRwM2pzrMTF9SE4DHutZr2NZM7xWhnRsmgVxPyLU ubo6TM4j/lKL56up3iEnqsBFTlLvZrtAHt/utWJgGDmbfjbOZu2CCO0TQyOOow== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1719736440; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=oLdbnKIU34VtdeK+Ufb921A3EXxI2+i/okmKQBjx6Gw=; b=OsKobpDArrDdlPwVvPox+LJyD4AdPdUKOdKcA9TCuG7MqDLMhmo84qa0PcGdfKBebntPX7 9GP0VCa+gEMc+fVgl9HkwbTlUG3WEgBJTrYjDJozWbTewOl6DkamoZeqdFf5qVZQSGqOG2 CvYbY530VrZTwEygf4ZJSE1ZWjxoP57KImhb45CdIganb9hv4zRdzICAl2N3jiG0Gf2TZ1 O0iYPeM9FzCEPQ5YFGyzWtqEtp5etCd1jQYxKqK87Xd54lTo7QIEf+uFKW8Q6AcD5EWtXI 3c2Dze4nLkg+KA77JXJP5jCo//yDeOyCuxUYqUplDSEq7B7EEYAbOPmr+b5fdw== Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4WBjBc3V6vzFX0 for ; Sun, 30 Jun 2024 08:34:00 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 45U8Y0GS062009 for ; Sun, 30 Jun 2024 08:34:00 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 45U8Y0Tm062008 for doc@FreeBSD.org; Sun, 30 Jun 2024 08:34:00 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 280061] Porters Handbook: missing important aspects: PEP517 (python) Date: Sun, 30 Jun 2024 08:34:00 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Books & Articles X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Many People X-Bugzilla-Who: ohartmann@walstatt.org X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: doc@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform op_sys bug_status bug_severity priority component assigned_to reporter Message-ID: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@FreeBSD.org MIME-Version: 1.0 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.=