From Fedora Project Wiki

Revision as of 11:26, 2 August 2019 by Lruzicka (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Description

This test case tests that the modules have the required defaults set.

Setup

  1. Make sure you have a clean installation of Fedora (all flavors are possible).
  2. Log onto the system as a superuser or a user with sudo rights.
  3. Run a terminal application, such as gnome-terminal, or switch to a virtual console (Ctrl-Alt-F3). The following test is based on the DNF package manager.

Note: For the time's being, users can work with modules using dnf. In the future, other package managers will be able to deal with it. Until then, do not attempt to test this approach using tools other than dnf.

How to test

  1. List available modules:
    Execute dnf module list.
  2. Check for module streams. The stream column of a listed module must not be empty, i.e. there must be at least one stream for each listed module available. The module does not need to have a default stream, marked [d], as default streams are not required. However, it can have one.
  3. Check for profiles. The profile column of a listed module must not be empty, i.e. there must be at least one profile available for every stream. There might be more profiles available.
  4. Check for defaults profiles. For every module stream, there must be one, and only one, default profile, marked [d], set.
  5. For every examined module, check the detailed info, too.
    Execute the dnf module list <module> and see if the information corresponds with the previous information.
  6. Check that the module can be installed using the following command:
    Execute dnf module install <module>:<stream>, but do not explicitly provide any profile.
  7. Check that the module has been successfully installed.
    Execute dnf module list --installed.

Expected Results

  1. The listed module provides at least one stream.
  2. The listed module provide at least one profile for each stream.
  3. For each module stream, at least one profile is marked as default.
  4. The detailed information corresponds with the information in the overview.
  5. The module's stream can be installed without explicitly providing the profile.
  6. The module is installed with the selected stream and its default profile.


Notes:

  • Currently (August 2019), some modules do not have (default) profiles set, because their creators decided that they are not meant to be installed, they only provide dependencies. However, the good practice is that such modules do have a default profile, too. In this case, the default profile should be empty, i.e. not provide any packages to install and therefore the installation part of this test case will not succeed. If not sure, check with the module's creator.
  • If the above described operations do not succeed and the reported error seems to be a modular problem, i.e. a missing profile or stream, broken dependencies, and similar, then please report a bug against this particular module in Fedora Modules.
  • If the problem seems to be DNF related, the file a bug against DNF.