/dnf-plugins-core

Core DNF Plugins

Primary LanguagePythonGNU General Public License v2.0GPL-2.0

Core DNF Plugins

Core plugins to use with DNF package manager.

Installation

RPM packages are available in official Fedora repositories:

dnf install dnf-plugins-core

Nigthly builds can be installed from copr repository.

Building from source

From the DNF git checkout directory:

mkdir build;
pushd build;
cmake .. && make;
popd;

CMake optional switches:

-DWITHOUT_LOCAL:str=1
    Different string value than "0" disables installing a local plugin.

-DWITHOUT_DEBUG:str=1
    Different string value than "0" disables installing a debug plugin.

Then to run DNF:

PYTHONPATH=`readlink -f .` bin/dnf <arguments>

Running tests

From the DNF git checkout directory:

mkdir build;
pushd build;
cmake .. && make ARGS="-V" test;
popd;

Contribution

Here's the most direct way to get your work merged into the project.

  1. Fork the project

  2. Clone down your fork

  3. Implement your feature or bug fix and commit changes

  4. If the change fixes a bug at Red Hat bugzilla, or if it is important to the end user, add the following block to the commit message:

    = changelog =
    msg:           message to be included in the changelog
    type:          one of: bugfix/enhancement/security (this field is required when message is present)
    resolves:      URLs to bugs or issues resolved by this commit (can be specified multiple times)
    related:       URLs to any related bugs or issues (can be specified multiple times)
    
    • For example:

      = changelog =
      msg: [download] Respect repo priority
      type: bugfix
      resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1800342
      
    • For your convenience, you can also use git commit template by running the following command in the top-level directory of this project:

      git config commit.template ./.git-commit-template
      
  5. In a separate commit, add your name and email under DNF-PLUGINS-CORE CONTRIBUTORS section in the authors file as a reward for your generosity

  6. Push the branch up to your fork

  7. Send a pull request for your branch

Please do not create pull requests with translation (.po) file improvements. Fix the translation on Fedora Weblate instead.

Documentation

The DNF-PLUGINS-CORE package distribution contains man pages dnf.plugin.*(8). It is also possible to read the DNF-PLUGINS-CORE documentation online.

Bug reporting etc.

Please report discovered bugs to the Red Hat bugzilla following this guide. If you planned to propose the patch in the report, consider contribution instead.

Freenode's irc channel #yum is meant for discussions related to both Yum and DNF. Questions should be asked there, issues discussed. Remember: #yum is not a support channel and prior research is expected from the questioner.