manifest: A new plugin for managing RPM package manifests

dnf-plugins-core.spec

@@ -1,4 +1,4 @@
-%{?!dnf_lowest_compatible: %global dnf_lowest_compatible 4.19.0}
+%{?!dnf_lowest_compatible: %global dnf_lowest_compatible 4.24.0}
 %global dnf_plugins_extra 2.0.0
 %global hawkey_version 0.73.0
 %global yum_utils_subpackage_name dnf-utils
@@ -41,7 +41,7 @@
 %endif
 
 Name:           dnf-plugins-core
-Version:        4.10.1
+Version:        4.11.0
 Release:        1%{?dist}
 Summary:        Core Plugins for DNF
 License:        GPL-2.0-or-later
@@ -69,6 +69,7 @@ Provides:       dnf-command(debug-restore)
 Provides:       dnf-command(debuginfo-install)
 Provides:       dnf-command(download)
 Provides:       dnf-command(groups-manager)
+Provides:       dnf-command(manifest)
 Provides:       dnf-command(repoclosure)
 Provides:       dnf-command(repograph)
 Provides:       dnf-command(repomanage)
@@ -88,6 +89,7 @@ Provides:       dnf-plugin-config-manager = %{version}-%{release}
 Provides:       dnf-plugin-debuginfo-install = %{version}-%{release}
 Provides:       dnf-plugin-download = %{version}-%{release}
 Provides:       dnf-plugin-generate_completion_cache = %{version}-%{release}
+Provides:       dnf-plugin-manifest = %{version}-%{release}
 Provides:       dnf-plugin-needs_restarting = %{version}-%{release}
 Provides:       dnf-plugin-groups-manager = %{version}-%{release}
 Provides:       dnf-plugin-repoclosure = %{version}-%{release}
@@ -105,7 +107,7 @@ Conflicts:      dnf-plugins-extras-common-data < %{dnf_plugins_extra}
 
 %description
 Core Plugins for DNF. This package enhances DNF with builddep, config-manager,
-copr, %{?with_debug_plugin:debug, }debuginfo-install, download, needs-restarting, groups-manager, repoclosure,
+copr, %{?with_debug_plugin:debug, }debuginfo-install, download, manifest, needs-restarting, groups-manager, repoclosure,
 repograph, repomanage, reposync, changelog and repodiff commands. Additionally
 provides generate_completion_cache passive plugin.
 
@@ -176,6 +178,7 @@ Requires:       python3-dbus
 Requires:       python3-dnf >= %{dnf_lowest_compatible}
 Requires:       python3-hawkey >= %{hawkey_version}
 Requires:       python3-dateutil
+Requires:       python3-libpkgmanifest
 Requires:       python3-systemd
 %if %{with debug_plugin}
 Provides:       python3-dnf-plugins-extras-debug = %{version}-%{release}
@@ -199,7 +202,7 @@ Conflicts:      python-%{name} < %{version}-%{release}
 
 %description -n python3-%{name}
 Core Plugins for DNF, Python 3 interface. This package enhances DNF with builddep,
-config-manager, copr, %{?with_debug_plugin:debug, }debuginfo-install, download, needs-restarting,
+config-manager, copr, %{?with_debug_plugin:debug, }debuginfo-install, download, manifest, needs-restarting,
 groups-manager, repoclosure, repograph, repomanage, reposync, changelog,
 repodiff, system-upgrade, offline-upgrade and offline-distrosync commands.
 Additionally provides generate_completion_cache passive plugin.
@@ -595,6 +598,7 @@ ln -sf %{yum_utils_subpackage_name}.1.gz %{buildroot}%{_mandir}/man1/repotrack.1
 %{_mandir}/man8/dnf*-expired-pgp-keys.*
 %{_mandir}/man8/dnf*-generate_completion_cache.*
 %{_mandir}/man8/dnf*-groups-manager.*
+%{_mandir}/man8/dnf*-manifest.*
 %{_mandir}/man8/dnf*-needs-restarting.*
 %{_mandir}/man8/dnf*-repoclosure.*
 %{_mandir}/man8/dnf*-repodiff.*
@@ -661,6 +665,7 @@ ln -sf %{yum_utils_subpackage_name}.1.gz %{buildroot}%{_mandir}/man1/repotrack.1
 %{python3_sitelib}/dnf-plugins/expired-pgp-keys.py
 %{python3_sitelib}/dnf-plugins/generate_completion_cache.py
 %{python3_sitelib}/dnf-plugins/groups_manager.py
+%{python3_sitelib}/dnf-plugins/manifest.py
 %{python3_sitelib}/dnf-plugins/needs_restarting.py
 %{python3_sitelib}/dnf-plugins/repoclosure.py
 %{python3_sitelib}/dnf-plugins/repodiff.py
@@ -680,6 +685,7 @@ ln -sf %{yum_utils_subpackage_name}.1.gz %{buildroot}%{_mandir}/man1/repotrack.1
 %{python3_sitelib}/dnf-plugins/__pycache__/expired-pgp-keys.*
 %{python3_sitelib}/dnf-plugins/__pycache__/generate_completion_cache.*
 %{python3_sitelib}/dnf-plugins/__pycache__/groups_manager.*
+%{python3_sitelib}/dnf-plugins/__pycache__/manifest.*
 %{python3_sitelib}/dnf-plugins/__pycache__/needs_restarting.*
 %{python3_sitelib}/dnf-plugins/__pycache__/repoclosure.*
 %{python3_sitelib}/dnf-plugins/__pycache__/repodiff.*

doc/CMakeLists.txt

@@ -28,6 +28,7 @@ INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/dnf4-builddep.8
     ${CMAKE_CURRENT_BINARY_DIR}/dnf4-generate_completion_cache.8
     ${CMAKE_CURRENT_BINARY_DIR}/dnf4-groups-manager.8
     ${CMAKE_CURRENT_BINARY_DIR}/dnf4-leaves.8
+    ${CMAKE_CURRENT_BINARY_DIR}/dnf4-manifest.8
     ${CMAKE_CURRENT_BINARY_DIR}/dnf4-modulesync.8
     ${CMAKE_CURRENT_BINARY_DIR}/dnf4-needs-restarting.8
     ${CMAKE_CURRENT_BINARY_DIR}/dnf4-repoclosure.8

doc/conf.py

@@ -255,6 +255,7 @@ def version_readout():
     ('groups-manager', 'dnf4-groups-manager', u'DNF groups-manager Plugin', AUTHORS, 8),
     ('leaves', 'dnf4-leaves', u'DNF leaves Plugin', AUTHORS, 8),
     ('local', 'dnf4-local', u'DNF local Plugin', AUTHORS, 8),
+    ('manifest', 'dnf4-manifest', u'DNF manifest Plugin', AUTHORS, 8),
     ('modulesync', 'dnf4-modulesync', u'DNF modulesync Plugin', AUTHORS, 8),
     ('needs_restarting', 'dnf4-needs-restarting', u'DNF needs_restarting Plugin', AUTHORS, 8),
     ('repoclosure', 'dnf4-repoclosure', u'DNF repoclosure Plugin', AUTHORS, 8),

doc/index.rst

@@ -37,6 +37,7 @@ This documents core plugins of DNF:
    groups-manager
    leaves
    local
+   manifest
    migrate
    modulesync
    needs_restarting

doc/manifest.rst

@@ -0,0 +1,122 @@
+====================
+ DNF manifest Plugin
+====================
+
+Working with RPM package manifest files using the ``libpkgmanifest`` library.
+
+:ref:`Strict <strict-label>` mode is enforced for all operations.
+
+--------
+Synopsis
+--------
+
+``dnf manifest new [options] [<package-name-spec>...]``
+
+``dnf manifest download [options]``
+
+``dnf manifest install [options]``
+
+-----------
+Subcommands
+-----------
+
+``new``
+    Generate a manifest file based on the provided input.
+
+    Supported input forms include:
+    - Package specifications
+    - Prototype input file
+    - None (defaults to using installed packages)
+
+    The input is resolved, and all relevant packages and dependencies
+    are saved in the manifest file.
+
+    See options and examples for more details.
+
+    Without specific input, the manifest is generated solely from
+    installed packages.
+
+``download``
+    Download all packages specified in the manifest file to disk.
+
+    By default, packages are downloaded to a subfolder named after the 
+    manifest file. You can also use the global ``--destdir`` option to
+    specify a custom directory for the downloaded packages.
+
+    The manifest file may contain packages for multiple base architectures.
+    By default, only packages corresponding to the current system architecture
+    are downloaded. To download packages for specific architectures, use the 
+    ``--archs`` option.
+
+``install``
+    Install all packages specified in the manifest file.
+
+---------
+Arguments
+---------
+
+``<package-name-spec>``
+    Specification for including a package in the manifest file.
+    Local RPMs or filenames are not supported.
+    For more information, refer to :ref:`Specifying Packages <specifying_packages-label>`.
+
+-------
+Options
+-------
+
+``--input``
+    Specify a custom path for the prototype input file.
+    By default, ``rpms.in.yaml`` is used.
+
+``--manifest``
+    Specify a custom path for the manifest file.
+    By default, ``packages.manifest.yaml`` is used.
+
+``--source``
+    Include source packages in consideration.
+    Not supported for the ``install`` command.
+
+``--use-system``
+    Consider currently installed system packages for dependency resolution
+    and exclude them from the resulting manifest file.
+
+``--archs``
+    Specify a comma-separated list of architectures to work with.
+    By default, only packages corresponding to the current system architecture are processed.
+
+``--per-arch``
+    Create a separate manifest file for each requested base architecture.
+    By default, a single manifest file is created for all architectures.
+
+--------
+Examples
+--------
+
+``dnf manifest new``
+    If the ``rpms.in.yaml`` prototype input file is in the current directory, it will be used
+    for package dependency resolution. If not, the manifest will be generated from the
+    system's installed packages.
+
+    The new manifest file is created at the default location: ``packages.manifest.yaml``.
+
+``dnf manifest new alsa-lib alsa-tools``
+    Create a new manifest file containing the ``alsa-lib`` and ``alsa-tools`` packages along
+    with all their dependencies.
+
+``dnf manifest new wget --use-system``
+    Create a new manifest file including the ``wget`` package and all its uninstalled dependencies.
+
+``dnf manifest download --manifest /home/user/Downloads/manifest.yaml --source``
+    Download all packages, including source packages, specified in the given manifest file.
+
+``dnf manifest install -y``
+    Install all packages specified in the manifest file located in the current directory
+    under the default file name, automatically answering "yes" to all prompts during the
+    transaction resolution.
+
+--------
+See Also
+--------
+
+* `libpkgmanifest upstream <https://github.com/rpm-software-management/libpkgmanifest>`_
+* `Prototype input file specification <https://github.com/konflux-ci/rpm-lockfile-prototype?tab=readme-ov-file#whats-the-input_file>`_

plugins/CMakeLists.txt

@@ -14,6 +14,7 @@ INSTALL (FILES leaves.py DESTINATION ${PYTHON_INSTALL_DIR}/dnf-plugins)
 if (${WITHOUT_LOCAL} STREQUAL "0")
 INSTALL (FILES local.py DESTINATION ${PYTHON_INSTALL_DIR}/dnf-plugins)
 endif()
+INSTALL (FILES manifest.py DESTINATION ${PYTHON_INSTALL_DIR}/dnf-plugins)
 if (${PYTHON_VERSION_MAJOR} STREQUAL "2")
 INSTALL (FILES migrate.py DESTINATION ${PYTHON_INSTALL_DIR}/dnf-plugins)
 endif()