Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rpm-software-management/dnf

Package manager based on libdnf and libsolv. Replaces YUM.
https://github.com/rpm-software-management/dnf

dnf libdnf package-manager python rpm

Last synced: about 2 months ago
JSON representation

Package manager based on libdnf and libsolv. Replaces YUM.

Host: GitHub
URL: https://github.com/rpm-software-management/dnf
Owner: rpm-software-management
License: gpl-2.0
Created: 2012-03-09T15:31:09.000Z (over 12 years ago)
Default Branch: master
Last Pushed: 2024-07-26T07:27:55.000Z (about 2 months ago)
Last Synced: 2024-07-26T08:46:59.821Z (about 2 months ago)
Topics: dnf, libdnf, package-manager, python, rpm
Language: Python
Homepage:
Size: 55.7 MB
Stars: 1,221
Watchers: 67
Forks: 407
Open Issues: 51
Metadata Files:
- Readme: README.rst
- License: COPYING
- Authors: AUTHORS

Awesome Lists containing this project

awesome-python-applications - Repo
awesome-python-applications - Repo

README

        .. image:: https://translate.fedoraproject.org/widgets/dnf/-/dnf-master/svg-badge.svg

    :alt: Translation status

    :target: https://translate.fedoraproject.org/engage/dnf/?utm_source=widget

###############

 Dandified YUM

###############

.. image:: https://raw.githubusercontent.com/rpm-software-management/dnf/gh-pages/logos/DNF_logo.png

 

Dandified YUM (DNF) is the next upcoming major version of `YUM `_. It does package management using `RPM `_, `libsolv `_ and `hawkey `_ libraries. For metadata handling and package downloads it utilizes `librepo `_. To process and effectively handle the comps data it uses `libcomps `_.

============

 Installing

============

DNF and all its dependencies are available in Fedora 18 and later, including the

rawhide Fedora.

Optionally you can use repositories with DNF nightly builds for last 2 stable Fedora versions available at copr://rpmsoftwaremanagement/dnf-nightly. You can enable the repository e.g. using:: 

    dnf copr enable rpmsoftwaremanagement/dnf-nightly

Then install DNF typing::

    sudo yum install dnf

In other RPM-based distributions you need to build all the components from their

sources.

======================

 Building from source

======================

All commands should be run from the DNF git checkout directory.

To install the build dependencies::

    sudo dnf builddep dnf.spec

To build DNF::

    mkdir build;

    pushd build;

    cmake ..; # add '-DPYTHON_DESIRED="3"' option for Python 3 build

    make;

    popd;

To run DNF when compiled for Python2::

    PYTHONPATH=`readlink -f .` bin/dnf-2 

To run DNF when compiled for Python3::

    PYTHONPATH=`readlink -f .` bin/dnf-3 

If you want to build the manpages, use the option ``-DWITH_MAN=0`` with cmake.

Man pages will be located in ``build/doc`` and can be read with ``man -l``, e.g::

    man -l build/doc/dnf4.8

=============================

 Building and installing rpm

=============================

From the DNF git checkout directory::

    $ tito build --test --rpm

    # dnf install /tmp/tito/noarch/*

===============

 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

#. Clone down your fork

#. Implement your feature or bug fix and commit changes

#. 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: Verify GPG signatures when running dnf-automatic

       type: bugfix

       resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1793298

   * 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

#. In special commit add your name and email under ``DNF CONTRIBUTORS`` section in `authors file `_ as a reward for your generosity

#. Push the branch up to your fork

#. Send a pull request for your branch

Please, do not create the pull requests with translation (.po) files improvements. Fix the translation on `Fedora Weblate `_ instead.

===============

 Documentation

===============

The DNF package distribution contains man pages, dnf(8) and dnf.conf(8). It is also possible to `read the DNF documentation `_ online, the page includes API documentation. There's also a `wiki `_ meant for contributors to DNF and related projects.

====================

 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.