chantra / rpms / dnf

Forked from rpms/dnf 2 years ago
Clone

Blame SOURCES/0008-Module-switch-command.patch

862ba9
From 6ed0458744090ab307da9d9118690372b2e66ca8 Mon Sep 17 00:00:00 2001
862ba9
From: Jaroslav Mracek <jmracek@redhat.com>
862ba9
Date: Wed, 11 Nov 2020 12:47:21 +0100
862ba9
Subject: [PATCH 1/5] Make module_base better industrialized for method reuse
862ba9
862ba9
It will allow to use internal for module switch command.
862ba9
---
862ba9
 dnf/module/module_base.py | 29 ++++++++++++++++++++---------
862ba9
 1 file changed, 20 insertions(+), 9 deletions(-)
862ba9
862ba9
diff --git a/dnf/module/module_base.py b/dnf/module/module_base.py
862ba9
index 49c871c4..0da4fab1 100644
862ba9
--- a/dnf/module/module_base.py
862ba9
+++ b/dnf/module/module_base.py
862ba9
@@ -323,7 +323,7 @@ class ModuleBase(object):
862ba9
             assert len(streamDict) == 1
862ba9
         return moduleDict
862ba9
 
862ba9
-    def _resolve_specs_enable_update_sack(self, module_specs):
862ba9
+    def _resolve_specs_enable(self, module_specs):
862ba9
         no_match_specs = []
862ba9
         error_spec = []
862ba9
         module_dicts = {}
862ba9
@@ -339,6 +339,9 @@ class ModuleBase(object):
862ba9
                 error_spec.append(spec)
862ba9
                 logger.error(ucd(e))
862ba9
                 logger.error(_("Unable to resolve argument {}").format(spec))
862ba9
+        return no_match_specs, error_spec, module_dicts
862ba9
+
862ba9
+    def _update_sack(self):
862ba9
         hot_fix_repos = [i.id for i in self.base.repos.iter_enabled() if i.module_hotfixes]
862ba9
         try:
862ba9
             solver_errors = self.base.sack.filter_modules(
862ba9
@@ -347,6 +350,10 @@ class ModuleBase(object):
862ba9
                 debugsolver=self.base.conf.debug_solver)
862ba9
         except hawkey.Exception as e:
862ba9
             raise dnf.exceptions.Error(ucd(e))
862ba9
+        return solver_errors
862ba9
+
862ba9
+    def _enable_dependencies(self, module_dicts):
862ba9
+        error_spec = []
862ba9
         for spec, (nsvcap, moduleDict) in module_dicts.items():
862ba9
             for streamDict in moduleDict.values():
862ba9
                 for modules in streamDict.values():
862ba9
@@ -357,6 +364,17 @@ class ModuleBase(object):
862ba9
                         error_spec.append(spec)
862ba9
                         logger.error(ucd(e))
862ba9
                         logger.error(_("Unable to resolve argument {}").format(spec))
862ba9
+        return error_spec
862ba9
+
862ba9
+    def _resolve_specs_enable_update_sack(self, module_specs):
862ba9
+        no_match_specs, error_spec, module_dicts = self._resolve_specs_enable(module_specs)
862ba9
+
862ba9
+        solver_errors = self._update_sack()
862ba9
+
862ba9
+        dependency_error_spec = self._enable_dependencies(module_dicts)
862ba9
+        if dependency_error_spec:
862ba9
+            error_spec.extend(dependency_error_spec)
862ba9
+
862ba9
         return no_match_specs, error_spec, solver_errors, module_dicts
862ba9
 
862ba9
     def _modules_reset_or_disable(self, module_specs, to_state):
862ba9
@@ -379,14 +397,7 @@ class ModuleBase(object):
862ba9
                 if to_state == STATE_DISABLED:
862ba9
                     self.base._moduleContainer.disable(name)
862ba9
 
862ba9
-        hot_fix_repos = [i.id for i in self.base.repos.iter_enabled() if i.module_hotfixes]
862ba9
-        try:
862ba9
-            solver_errors = self.base.sack.filter_modules(
862ba9
-                self.base._moduleContainer, hot_fix_repos, self.base.conf.installroot,
862ba9
-                self.base.conf.module_platform_id, update_only=True,
862ba9
-                debugsolver=self.base.conf.debug_solver)
862ba9
-        except hawkey.Exception as e:
862ba9
-            raise dnf.exceptions.Error(ucd(e))
862ba9
+        solver_errors = self._update_sack()
862ba9
         return no_match_specs, solver_errors
862ba9
 
862ba9
     def _get_package_name_set_and_remove_profiles(self, module_list, nsvcap, remove=False):
862ba9
-- 
862ba9
2.26.2
862ba9
862ba9
862ba9
From e6473f4e6f17bb635e023b8905f29b318b8795bf Mon Sep 17 00:00:00 2001
862ba9
From: Jaroslav Mracek <jmracek@redhat.com>
862ba9
Date: Wed, 11 Nov 2020 17:09:16 +0100
862ba9
Subject: [PATCH 2/5] Add module switch-to support (RhBug:1792020)
862ba9
862ba9
It is a combination of module rpm distrosync, module profile switch and
862ba9
module stream switch.
862ba9
862ba9
= changelog =
862ba9
msg:           Add new `module switch-to` command for switching content
862ba9
of module streams
862ba9
type:          enhancement
862ba9
resolves:      https://bugzilla.redhat.com/show_bug.cgi?id=1792020
862ba9
---
862ba9
 VERSION.cmake              |   2 +-
862ba9
 dnf.spec                   |   2 +-
862ba9
 dnf/cli/commands/module.py |  24 ++++-
862ba9
 dnf/module/module_base.py  | 182 ++++++++++++++++++++++++++++++++-----
862ba9
 4 files changed, 185 insertions(+), 25 deletions(-)
862ba9
862ba9
diff --git a/dnf/cli/commands/module.py b/dnf/cli/commands/module.py
862ba9
index 5a6c0069..4cdc915e 100644
862ba9
--- a/dnf/cli/commands/module.py
862ba9
+++ b/dnf/cli/commands/module.py
862ba9
@@ -271,6 +271,28 @@ class ModuleCommand(commands.Command):
862ba9
 
862ba9
             logger.error(dnf.exceptions.MarkingErrors(no_match_group_specs=skipped_groups))
862ba9
 
862ba9
+    class SwitchToSubCommand(SubCommand):
862ba9
+
862ba9
+        aliases = ('switch-to',)
862ba9
+        summary = _('switch a module to a stream and distrosync rpm packages')
862ba9
+
862ba9
+        def configure(self):
862ba9
+            demands = self.cli.demands
862ba9
+            demands.available_repos = True
862ba9
+            demands.sack_activation = True
862ba9
+            demands.resolving = True
862ba9
+            demands.root_user = True
862ba9
+            self.base.conf.module_stream_switch = True
862ba9
+
862ba9
+        def run_on_module(self):
862ba9
+            try:
862ba9
+                self.module_base.switch_to(self.opts.module_spec, strict=self.base.conf.strict)
862ba9
+            except dnf.exceptions.MarkingErrors as e:
862ba9
+                if self.base.conf.strict:
862ba9
+                    if e.no_match_group_specs or e.error_group_specs:
862ba9
+                        raise e
862ba9
+                logger.error(str(e))
862ba9
+
862ba9
     class ProvidesSubCommand(SubCommand):
862ba9
 
862ba9
         aliases = ("provides", )
862ba9
@@ -319,7 +341,7 @@ class ModuleCommand(commands.Command):
862ba9
 
862ba9
     SUBCMDS = {ListSubCommand, InfoSubCommand, EnableSubCommand,
862ba9
                DisableSubCommand, ResetSubCommand, InstallSubCommand, UpdateSubCommand,
862ba9
-               RemoveSubCommand, ProvidesSubCommand, RepoquerySubCommand}
862ba9
+               RemoveSubCommand, SwitchToSubCommand, ProvidesSubCommand, RepoquerySubCommand}
862ba9
 
862ba9
     SUBCMDS_NOT_REQUIRED_ARG = {ListSubCommand}
862ba9
 
862ba9
diff --git a/dnf/module/module_base.py b/dnf/module/module_base.py
862ba9
index 0da4fab1..03d54f72 100644
862ba9
--- a/dnf/module/module_base.py
862ba9
+++ b/dnf/module/module_base.py
862ba9
@@ -140,31 +140,140 @@ class ModuleBase(object):
862ba9
         if fail_safe_repo_used:
862ba9
             raise dnf.exceptions.Error(_(
862ba9
                 "Installing module from Fail-Safe repository is not allowed"))
862ba9
-        #  Remove source packages they cannot be installed or upgraded
862ba9
-        base_no_source_query = self.base.sack.query().filterm(arch__neq=['src', 'nosrc']).apply()
862ba9
-        install_base_query = base_no_source_query.filter(nevra_strict=install_set_artefacts)
862ba9
+        __, profiles_errors = self._install_profiles_internal(
862ba9
+            install_set_artefacts, install_dict, strict)
862ba9
+        if profiles_errors:
862ba9
+            error_specs.extend(profiles_errors)
862ba9
 
862ba9
-        # add hot-fix packages
862ba9
-        hot_fix_repos = [i.id for i in self.base.repos.iter_enabled() if i.module_hotfixes]
862ba9
-        hotfix_packages = base_no_source_query.filter(
862ba9
-            reponame=hot_fix_repos, name=install_dict.keys())
862ba9
-        install_base_query = install_base_query.union(hotfix_packages)
862ba9
+        if no_match_specs or error_specs or solver_errors:
862ba9
+            raise dnf.exceptions.MarkingErrors(no_match_group_specs=no_match_specs,
862ba9
+                                               error_group_specs=error_specs,
862ba9
+                                               module_depsolv_errors=solver_errors)
862ba9
 
862ba9
-        for pkg_name, set_specs in install_dict.items():
862ba9
-            query = install_base_query.filter(name=pkg_name)
862ba9
-            if not query:
862ba9
-                # package can also be non-modular or part of another stream
862ba9
-                query = base_no_source_query.filter(name=pkg_name)
862ba9
-                if not query:
862ba9
-                    for spec in set_specs:
862ba9
-                        logger.error(_("Unable to resolve argument {}").format(spec))
862ba9
-                    logger.error(_("No match for package {}").format(pkg_name))
862ba9
-                    error_specs.extend(set_specs)
862ba9
-                    continue
862ba9
-            self.base._goal.group_members.add(pkg_name)
862ba9
+    def switch_to(self, module_specs, strict=True):
862ba9
+        # :api
862ba9
+        no_match_specs, error_specs, module_dicts = self._resolve_specs_enable(module_specs)
862ba9
+        # collect name of artifacts from new modules for distrosync
862ba9
+        new_artifacts_names = set()
862ba9
+        # collect name of artifacts from active modules for distrosync before sack update
862ba9
+        active_artifacts_names = set()
862ba9
+        src_arches = {"nosrc", "src"}
862ba9
+        for spec, (nsvcap, moduledict) in module_dicts.items():
862ba9
+            for name in moduledict.keys():
862ba9
+                for module in self.base._moduleContainer.query(name, "", "", "", ""):
862ba9
+                    if self.base._moduleContainer.isModuleActive(module):
862ba9
+                        for artifact in module.getArtifacts():
862ba9
+                            arch = artifact.rsplit(".", 1)[1]
862ba9
+                            if arch in src_arches:
862ba9
+                                continue
862ba9
+                            pkg_name = artifact.rsplit("-", 2)[0]
862ba9
+                            active_artifacts_names.add(pkg_name)
862ba9
+
862ba9
+        solver_errors = self._update_sack()
862ba9
+
862ba9
+        dependency_error_spec = self._enable_dependencies(module_dicts)
862ba9
+        if dependency_error_spec:
862ba9
+            error_specs.extend(dependency_error_spec)
862ba9
+
862ba9
+        # <package_name, set_of_spec>
862ba9
+        fail_safe_repo = hawkey.MODULE_FAIL_SAFE_REPO_NAME
862ba9
+        install_dict = {}
862ba9
+        install_set_artifacts = set()
862ba9
+        fail_safe_repo_used = False
862ba9
+
862ba9
+        # list of name: [profiles] for module profiles being removed
862ba9
+        removed_profiles = self.base._moduleContainer.getRemovedProfiles()
862ba9
+
862ba9
+        for spec, (nsvcap, moduledict) in module_dicts.items():
862ba9
+            for name, streamdict in moduledict.items():
862ba9
+                for stream, module_list in streamdict.items():
862ba9
+                    install_module_list = [x for x in module_list
862ba9
+                                           if self.base._moduleContainer.isModuleActive(x.getId())]
862ba9
+                    if not install_module_list:
862ba9
+                        "No active matches for argument '{0}' in module '{1}:{2}'"
862ba9
+                        logger.error(_("No active matches for argument '{0}' in module "
862ba9
+                                       "'{1}:{2}'").format(spec, name, stream))
862ba9
+                        error_specs.append(spec)
862ba9
+                        continue
862ba9
+                    profiles = []
862ba9
+                    latest_module = self._get_latest(install_module_list)
862ba9
+                    if latest_module.getRepoID() == fail_safe_repo:
862ba9
+                        msg = _(
862ba9
+                            "Installing module '{0}' from Fail-Safe repository {1} is not allowed")
862ba9
+                        logger.critical(msg.format(latest_module.getNameStream(), fail_safe_repo))
862ba9
+                        fail_safe_repo_used = True
862ba9
+                    if nsvcap.profile:
862ba9
+                        profiles.extend(latest_module.getProfiles(nsvcap.profile))
862ba9
+                        if not profiles:
862ba9
+                            available_profiles = latest_module.getProfiles()
862ba9
+                            if available_profiles:
862ba9
+                                profile_names = ", ".join(sorted(
862ba9
+                                    [profile.getName() for profile in available_profiles]))
862ba9
+                                msg = _("Unable to match profile for argument {}. Available "
862ba9
+                                        "profiles for '{}:{}': {}").format(
862ba9
+                                    spec, name, stream, profile_names)
862ba9
+                            else:
862ba9
+                                msg = _("Unable to match profile for argument {}").format(spec)
862ba9
+                            logger.error(msg)
862ba9
+                            no_match_specs.append(spec)
862ba9
+                            continue
862ba9
+                    elif name in removed_profiles:
862ba9
+
862ba9
+                        for profile in removed_profiles[name]:
862ba9
+                            module_profiles = latest_module.getProfiles(profile)
862ba9
+                            if not module_profiles:
862ba9
+                                logger.warning(
862ba9
+                                    _("Installed profile '{0}' is not available in module "
862ba9
+                                      "'{1}' stream '{2}'").format(profile, name, stream))
862ba9
+                                continue
862ba9
+                            profiles.extend(module_profiles)
862ba9
+                    for profile in profiles:
862ba9
+                        self.base._moduleContainer.install(latest_module, profile.getName())
862ba9
+                        for pkg_name in profile.getContent():
862ba9
+                            install_dict.setdefault(pkg_name, set()).add(spec)
862ba9
+                    for module in install_module_list:
862ba9
+                        artifacts = module.getArtifacts()
862ba9
+                        install_set_artifacts.update(artifacts)
862ba9
+                        for artifact in artifacts:
862ba9
+                            arch = artifact.rsplit(".", 1)[1]
862ba9
+                            if arch in src_arches:
862ba9
+                                continue
862ba9
+                            pkg_name = artifact.rsplit("-", 2)[0]
862ba9
+                            new_artifacts_names.add(pkg_name)
862ba9
+        if fail_safe_repo_used:
862ba9
+            raise dnf.exceptions.Error(_(
862ba9
+                "Installing module from Fail-Safe repository is not allowed"))
862ba9
+        install_base_query, profiles_errors = self._install_profiles_internal(
862ba9
+            install_set_artifacts, install_dict, strict)
862ba9
+        if profiles_errors:
862ba9
+            error_specs.extend(profiles_errors)
862ba9
+
862ba9
+        # distrosync module name
862ba9
+        all_names = set()
862ba9
+        all_names.update(new_artifacts_names)
862ba9
+        all_names.update(active_artifacts_names)
862ba9
+        remove_query = self.base.sack.query().filterm(empty=True)
862ba9
+        for pkg_name in all_names:
862ba9
+            query = self.base.sack.query().filterm(name=pkg_name)
862ba9
+            installed = query.installed()
862ba9
+            if not installed:
862ba9
+                continue
862ba9
+            available = query.available()
862ba9
+            if not available:
862ba9
+                logger.warning(_("No packages available to distrosync for package name "
862ba9
+                                 "'{}'").format(pkg_name))
862ba9
+                if pkg_name not in new_artifacts_names:
862ba9
+                    remove_query = remove_query.union(query)
862ba9
+                continue
862ba9
+
862ba9
+            only_new_module = query.intersection(install_base_query)
862ba9
+            if only_new_module:
862ba9
+                query = only_new_module
862ba9
             sltr = dnf.selector.Selector(self.base.sack)
862ba9
             sltr.set(pkg=query)
862ba9
-            self.base._goal.install(select=sltr, optional=(not strict))
862ba9
+            self.base._goal.distupgrade(select=sltr)
862ba9
+        self.base._remove_if_unneeded(remove_query)
862ba9
+
862ba9
         if no_match_specs or error_specs or solver_errors:
862ba9
             raise dnf.exceptions.MarkingErrors(no_match_group_specs=no_match_specs,
862ba9
                                                error_group_specs=error_specs,
862ba9
@@ -183,7 +292,7 @@ class ModuleBase(object):
862ba9
         fail_safe_repo = hawkey.MODULE_FAIL_SAFE_REPO_NAME
862ba9
         fail_safe_repo_used = False
862ba9
 
862ba9
-        #  Remove source packages they cannot be installed or upgraded
862ba9
+        #  Remove source packages because they cannot be installed or upgraded
862ba9
         base_no_source_query = self.base.sack.query().filterm(arch__neq=['src', 'nosrc']).apply()
862ba9
 
862ba9
         for spec in module_specs:
862ba9
@@ -694,6 +803,35 @@ class ModuleBase(object):
862ba9
     def _format_repoid(self, repo_name):
862ba9
         return "{}\n".format(self.base.output.term.bold(repo_name))
862ba9
 
862ba9
+    def _install_profiles_internal(self, install_set_artifacts, install_dict, strict):
862ba9
+        #  Remove source packages because they cannot be installed or upgraded
862ba9
+        base_no_source_query = self.base.sack.query().filterm(arch__neq=['src', 'nosrc']).apply()
862ba9
+        install_base_query = base_no_source_query.filter(nevra_strict=install_set_artifacts)
862ba9
+        error_specs = []
862ba9
+
862ba9
+        # add hot-fix packages
862ba9
+        hot_fix_repos = [i.id for i in self.base.repos.iter_enabled() if i.module_hotfixes]
862ba9
+        hotfix_packages = base_no_source_query.filter(
862ba9
+            reponame=hot_fix_repos, name=install_dict.keys())
862ba9
+        install_base_query = install_base_query.union(hotfix_packages)
862ba9
+
862ba9
+        for pkg_name, set_specs in install_dict.items():
862ba9
+            query = install_base_query.filter(name=pkg_name)
862ba9
+            if not query:
862ba9
+                # package can also be non-modular or part of another stream
862ba9
+                query = base_no_source_query.filter(name=pkg_name)
862ba9
+                if not query:
862ba9
+                    for spec in set_specs:
862ba9
+                        logger.error(_("Unable to resolve argument {}").format(spec))
862ba9
+                    logger.error(_("No match for package {}").format(pkg_name))
862ba9
+                    error_specs.extend(set_specs)
862ba9
+                    continue
862ba9
+            self.base._goal.group_members.add(pkg_name)
862ba9
+            sltr = dnf.selector.Selector(self.base.sack)
862ba9
+            sltr.set(pkg=query)
862ba9
+            self.base._goal.install(select=sltr, optional=(not strict))
862ba9
+        return install_base_query, error_specs
862ba9
+
862ba9
 
862ba9
 def format_modular_solver_errors(errors):
862ba9
     msg = dnf.util._format_resolve_problems(errors)
862ba9
-- 
862ba9
2.26.2
862ba9
862ba9
862ba9
From df8c74679193bf27db584b3ad225997b2f5f4b87 Mon Sep 17 00:00:00 2001
862ba9
From: Jaroslav Mracek <jmracek@redhat.com>
862ba9
Date: Thu, 12 Nov 2020 13:51:02 +0100
862ba9
Subject: [PATCH 3/5] [minor] Rename all variables with artefact to artifact
862ba9
862ba9
---
862ba9
 dnf/module/module_base.py | 10 +++++-----
862ba9
 1 file changed, 5 insertions(+), 5 deletions(-)
862ba9
862ba9
diff --git a/dnf/module/module_base.py b/dnf/module/module_base.py
862ba9
index 03d54f72..7298c9a3 100644
862ba9
--- a/dnf/module/module_base.py
862ba9
+++ b/dnf/module/module_base.py
862ba9
@@ -73,7 +73,7 @@ class ModuleBase(object):
862ba9
         # <package_name, set_of_spec>
862ba9
         fail_safe_repo = hawkey.MODULE_FAIL_SAFE_REPO_NAME
862ba9
         install_dict = {}
862ba9
-        install_set_artefacts = set()
862ba9
+        install_set_artifacts = set()
862ba9
         fail_safe_repo_used = False
862ba9
         for spec, (nsvcap, moduledict) in module_dicts.items():
862ba9
             for name, streamdict in moduledict.items():
862ba9
@@ -136,12 +136,12 @@ class ModuleBase(object):
862ba9
                         for pkg_name in profile.getContent():
862ba9
                             install_dict.setdefault(pkg_name, set()).add(spec)
862ba9
                     for module in install_module_list:
862ba9
-                        install_set_artefacts.update(module.getArtifacts())
862ba9
+                        install_set_artifacts.update(module.getArtifacts())
862ba9
         if fail_safe_repo_used:
862ba9
             raise dnf.exceptions.Error(_(
862ba9
                 "Installing module from Fail-Safe repository is not allowed"))
862ba9
         __, profiles_errors = self._install_profiles_internal(
862ba9
-            install_set_artefacts, install_dict, strict)
862ba9
+            install_set_artifacts, install_dict, strict)
862ba9
         if profiles_errors:
862ba9
             error_specs.extend(profiles_errors)
862ba9
 
862ba9
@@ -326,8 +326,8 @@ class ModuleBase(object):
862ba9
                     else:
862ba9
                         for profile in latest_module.getProfiles():
862ba9
                             upgrade_package_set.update(profile.getContent())
862ba9
-                        for artefact in latest_module.getArtifacts():
862ba9
-                            subj = hawkey.Subject(artefact)
862ba9
+                        for artifact in latest_module.getArtifacts():
862ba9
+                            subj = hawkey.Subject(artifact)
862ba9
                             for nevra_obj in subj.get_nevra_possibilities(
862ba9
                                     forms=[hawkey.FORM_NEVRA]):
862ba9
                                 upgrade_package_set.add(nevra_obj.name)
862ba9
-- 
862ba9
2.26.2
862ba9
862ba9
862ba9
From 0818bb80fc0846f602f338a2119671be97c47217 Mon Sep 17 00:00:00 2001
862ba9
From: Jaroslav Mracek <jmracek@redhat.com>
862ba9
Date: Thu, 12 Nov 2020 15:11:29 +0100
862ba9
Subject: [PATCH 4/5] [doc] Add description of dnf module switch-to
862ba9
862ba9
---
862ba9
 doc/command_ref.rst | 30 ++++++++++++++++++++++--------
862ba9
 1 file changed, 22 insertions(+), 8 deletions(-)
862ba9
862ba9
diff --git a/doc/command_ref.rst b/doc/command_ref.rst
862ba9
index 83879013..c12837ea 100644
862ba9
--- a/doc/command_ref.rst
862ba9
+++ b/doc/command_ref.rst
862ba9
@@ -979,15 +979,31 @@ Module subcommands take :ref:`\<module-spec>\ <specifying_modules-label>`... arg
862ba9
     In case no profile was provided, all default profiles get installed.
862ba9
     Module streams get enabled accordingly.
862ba9
 
862ba9
-    This command cannot be used for switching module streams. It is recommended to remove all
862ba9
-    installed content from the module and reset the module using the
862ba9
-    :ref:`reset <module_reset_command-label>` command. After you reset the module, you can install
862ba9
-    the other stream.
862ba9
+    This command cannot be used for switching module streams. Use the
862ba9
+    :ref:`dnf module switch-to <module_switch_to_command-label>` command for that.
862ba9
 
862ba9
 ``dnf [options] module update <module-spec>...``
862ba9
     Update packages associated with an active module stream, optionally restricted to a profile.
862ba9
     If the `profile_name` is provided, only the packages referenced by that profile will be updated.
862ba9
 
862ba9
+.. _module_switch_to_command-label:
862ba9
+
862ba9
+``dnf [options] module switch-to <module-spec>...``
862ba9
+    Switch to or enable a module stream, change versions of installed packages to versions provided
862ba9
+    by the new stream, and remove packages from the old stream that are no longer available. It also
862ba9
+    updates installed profiles if they are available for the new stream. When a profile was
862ba9
+    provided, it installs that profile and does not update any already installed profiles.
862ba9
+
862ba9
+    This command can be used as a stronger version of the
862ba9
+    :ref:`dnf module enable <module_enable_command-label>` command, which not only enables modules,
862ba9
+    but also does a `distrosync` to all modular packages in the enabled modules.
862ba9
+
862ba9
+    It can also be used as a stronger version of the
862ba9
+    :ref:`dnf module install <module_install_command-label>` command, but it requires to specify
862ba9
+    profiles that are supposed to be installed, because `switch-to` command does not use `default
862ba9
+    profiles`. The `switch-to` command doesn't only install profiles, it also makes a `distrosync`
862ba9
+    to all modular packages in the installed module.
862ba9
+
862ba9
 ``dnf [options] module remove <module-spec>...``
862ba9
     Remove installed module profiles, including packages that were installed with the
862ba9
     :ref:`dnf module install <module_install_command-label>` command. Will not remove packages
862ba9
@@ -1010,10 +1026,8 @@ Module subcommands take :ref:`\<module-spec>\ <specifying_modules-label>`... arg
862ba9
     of modular dependency issue the operation will be rejected. To perform the action anyway please use
862ba9
     \-\ :ref:`-skip-broken <skip-broken_option-label>` option.
862ba9
 
862ba9
-    This command cannot be used for switching module streams. It is recommended to remove all
862ba9
-    installed content from the module, and reset the module using the
862ba9
-    :ref:`reset <module_reset_command-label>` command. After you reset the module, you can enable
862ba9
-    the other stream.
862ba9
+    This command cannot be used for switching module streams. Use the
862ba9
+    :ref:`dnf module switch-to <module_switch_to_command-label>` command for that.
862ba9
 
862ba9
 .. _module_disable_command-label:
862ba9
 
862ba9
-- 
862ba9
2.26.2
862ba9
862ba9
862ba9
From 6b0b2b99e40c20706145e774626658825f5bc55d Mon Sep 17 00:00:00 2001
862ba9
From: Jaroslav Mracek <jmracek@redhat.com>
862ba9
Date: Wed, 25 Nov 2020 12:34:30 +0100
862ba9
Subject: [PATCH 5/5] Do not use source rpms for module switch
862ba9
862ba9
It prevents misleading message from libsolv that it tries to install
862ba9
source rpm.
862ba9
---
862ba9
 dnf/module/module_base.py | 4 +++-
862ba9
 1 file changed, 3 insertions(+), 1 deletion(-)
862ba9
862ba9
diff --git a/dnf/module/module_base.py b/dnf/module/module_base.py
862ba9
index 7298c9a3..02d5d5a3 100644
862ba9
--- a/dnf/module/module_base.py
862ba9
+++ b/dnf/module/module_base.py
862ba9
@@ -253,8 +253,10 @@ class ModuleBase(object):
862ba9
         all_names.update(new_artifacts_names)
862ba9
         all_names.update(active_artifacts_names)
862ba9
         remove_query = self.base.sack.query().filterm(empty=True)
862ba9
+        base_no_source_query = self.base.sack.query().filterm(arch__neq=['src', 'nosrc']).apply()
862ba9
+
862ba9
         for pkg_name in all_names:
862ba9
-            query = self.base.sack.query().filterm(name=pkg_name)
862ba9
+            query = base_no_source_query.filter(name=pkg_name)
862ba9
             installed = query.installed()
862ba9
             if not installed:
862ba9
                 continue
862ba9
-- 
862ba9
2.26.2
862ba9