1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2026-03-22 05:09:12 +00:00

community.general.copr: clarify includepkgs/excludepkgs (#11464)

At first glance, includepkgs seems to be something that would install
the package name from the given copr repo.  This isn't helped by the
example that says "Install caddy" which very much looks like it is
installing the package from the repo.  Not only did I, a human,
hallucinate this behaviour, so did a large search engine's AI
responses to related queries.

In fact these are labels to vary what packages DNF sees.  Clarify this
by using wording and examples closer to the upstream documentation [1]

[1] https://dnf.readthedocs.io/en/latest/conf_ref.html
This commit is contained in:
Ian Wienand 2026-02-08 02:19:59 +11:00 committed by GitHub
parent df6d6269a6
commit 8b0ce3e28f
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -50,12 +50,14 @@ options:
is run. is run.
type: str type: str
includepkgs: includepkgs:
description: List of packages to include. description:
- List of packages to include in all operations. Inverse of O(excludepkgs), DNF will exclude any package in
the repository that does not match this list. Matches a name or a glob.
type: list type: list
elements: str elements: str
version_added: 9.4.0 version_added: 9.4.0
excludepkgs: excludepkgs:
description: List of packages to exclude. description: List of packages in this repository to exclude from all operations. Matches a name or a glob.
type: list type: list
elements: str elements: str
version_added: 9.4.0 version_added: 9.4.0
@ -74,12 +76,14 @@ EXAMPLES = r"""
state: absent state: absent
name: '@copr/integration_tests' name: '@copr/integration_tests'
- name: Install Caddy - name: Install a repo where only packages starting with "python" that do not have i386 are seen by DNF
community.general.copr: community.general.copr:
name: '@caddy/caddy' name: '@sample/repo'
chroot: fedora-rawhide-{{ ansible_facts.architecture }} chroot: fedora-rawhide-{{ ansible_facts.architecture }}
includepkgs: includepkgs:
- caddy - 'python*'
excludepkgs:
- '*.i386'
""" """
RETURN = r""" RETURN = r"""