From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 42C35158087 for ; Wed, 2 Feb 2022 08:34:32 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 51D0E2BC0C0; Wed, 2 Feb 2022 08:34:31 +0000 (UTC) Received: from smtp.gentoo.org (woodpecker.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 2D5B62BC0C0 for ; Wed, 2 Feb 2022 08:34:31 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 071CB343278 for ; Wed, 2 Feb 2022 08:34:30 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 54BD72CE for ; Wed, 2 Feb 2022 08:34:27 +0000 (UTC) From: "Anna Vyalkova" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Anna Vyalkova" Message-ID: <1643790841.98564222a2d9f0f222a49dc65bc2ec13cc47249c.cybertailor@gentoo> Subject: [gentoo-commits] repo/proj/guru:dev commit in: / X-VCS-Repository: repo/proj/guru X-VCS-Files: CONTRIBUTING.md X-VCS-Directories: / X-VCS-Committer: cybertailor X-VCS-Committer-Name: Anna Vyalkova X-VCS-Revision: 98564222a2d9f0f222a49dc65bc2ec13cc47249c X-VCS-Branch: dev Date: Wed, 2 Feb 2022 08:34:27 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: e25da866-ea75-4c85-9218-ee4d0a000bd5 X-Archives-Hash: 8db1010bd319cd3e3a1013a36c5d76e5 commit: 98564222a2d9f0f222a49dc65bc2ec13cc47249c Author: Anna (cybertailor) Vyalkova sysrq in> AuthorDate: Wed Feb 2 08:34:01 2022 +0000 Commit: Anna Vyalkova sysrq in> CommitDate: Wed Feb 2 08:34:01 2022 +0000 URL: https://gitweb.gentoo.org/repo/proj/guru.git/commit/?id=98564222 CONTRIBUTING.md: few words about PEP517 mode Signed-off-by: Anna (cybertailor) Vyalkova sysrq.in> CONTRIBUTING.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 456282084..0b07b72af 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -90,12 +90,16 @@ There are [make.conf flags](https://wiki.gentoo.org/wiki/Package_testing#make.co The [app-portage/iwdevtools](https://github.com/ionenwks/iwdevtools) package contains scripts that help with ebuild development: finding incorrect dependencies, detectng [ABI changes](https://devmanual.gentoo.org/general-concepts/slotting/index.html#abi-breakage) etc. -- #### Tests and documentation for Python packages. +- #### Tests and documentation for Python packages Many Python packages have tests and documentation. Unlike some other eclasses the [distutils-r1 eclass](https://devmanual.gentoo.org/eclass-reference/distutils-r1.eclass/index.html) does not enable support for these tests automatically. This is because there are multiple test runners available for Python. To enable tests for your Python ebuilds, use the `distutils_enable_tests ` function. Similarly, support for documentation building with Sphinx can be added with the `distutils_enable_sphinx [--no-autodoc | ...]` function. Please note that these functions already append to IUSE and RESTRICT, so there is no need to specify this manually. See the [dev manual](https://devmanual.gentoo.org/eclass-reference/distutils-r1.eclass/index.html) and the [Gentoo Python Guide](https://projects.gentoo.org/python/guide/distutils.html) for more information. +- #### Prefer the PEP 517 mode for `distutils-r1` packages + +If you are writing a new ebuild or doing a version bump for a project that has `pyproject.toml` file, consider switching to [the PEP 517 mode](https://projects.gentoo.org/python/guide/distutils.html#the-pep-517-and-legacy-modes). + - #### Avoid introducing USE flags for small files and optional runtime dependencies. Installation of small files, like documentation, completions, man pages, etc, does not have to be toggle-able with an USE flag. Instead, just install these files unconditionally. This avoids unnecessary recompilations when an user forgot to enable a flag that installs a small file ([PG 0301](https://projects.gentoo.org/qa/policy-guide/installed-files.html#pg0301)).