Go to file
Jaroslav Rohel 9b8f32dbb6 Do not export symbols from private "/common/utils"
Libraries and applications (libdnf5.so, dnf5, dnf5daemon-client...) use
(and statically link) private utilities from "/common/utils".
And they also publicly export the symbols of these private utilities.

This modification hides the symbols of utilities linked from
"/common/utils".
2024-06-10 09:54:06 +00:00
.github prepare-release: Use new v1.2 action with 4-digits version format 2024-05-28 06:51:09 +00:00
.tito Initialized to use tito. 2022-08-09 13:33:13 +02:00
bindings libdnf5-cli library: Do not export private symbols 2024-06-10 09:54:06 +00:00
cmake translations: Configure cmake to generate translations 2022-10-13 14:44:08 +02:00
common Do not export symbols from private "/common/utils" 2024-06-10 09:54:06 +00:00
dnf5 dnf5 app, dnf5 plugins: Do not export private symbols 2024-06-10 09:54:06 +00:00
dnf5-plugins dnf5 app, dnf5 plugins: Do not export private symbols 2024-06-10 09:54:06 +00:00
dnf5daemon-client Update translations from weblate 2024-06-03 14:14:48 +00:00
dnf5daemon-server Update translations from weblate 2024-06-03 14:14:48 +00:00
doc Update description of --minimal option 2024-06-05 11:09:23 +00:00
include libdnf5-cli library: Do not export private symbols 2024-06-10 09:54:06 +00:00
libdnf5 libdnf5 library, libdnf5 plugins: Do not export private symbols 2024-06-10 09:54:06 +00:00
libdnf5-cli Do not export symbols from private "/common/utils" 2024-06-10 09:54:06 +00:00
libdnf5-plugins libdnf5 library, libdnf5 plugins: Do not export private symbols 2024-06-10 09:54:06 +00:00
test Disable libdnf5, libdnf5-cli, dnf5 cpr_plugin C++ unit tests 2024-06-10 09:54:06 +00:00
.clang-format Fix clang-format paths to libdnf5 2023-06-21 06:37:49 +00:00
.clang-tidy Disable irrelevant clang-tidy checks 2022-11-23 14:00:36 +01:00
.gitignore Use libdnf5 in .gitignore 2023-06-21 06:37:49 +00:00
.packit.yaml packit: Create downstream PR only for Rawhide 2024-05-28 06:51:09 +00:00
.pre-commit-config.yaml update pre-commit hooks 2023-11-24 07:31:43 +00:00
.readthedocs.yaml doc: call Python build script as a pre_build job 2023-12-19 05:56:29 +00:00
AUTHORS.md Add self to AUTHORS.md 2023-12-12 11:06:20 +00:00
CHANGELOG.md Release 5.2.3.0 2024-06-03 14:14:48 +00:00
CMakeLists.txt Extend version to four numbers (5.x.y.z) 2024-04-10 13:56:57 +00:00
CONTRIBUTING.md CONTRIBUTING: don't mention "ready-for-review" 2023-09-21 09:44:19 +00:00
COPYING.md doc: Add libdnf5-plugins to lgpl-2.1-or-later list in COPYING.md 2023-09-05 11:07:54 +00:00
DCO Import a new project template 2022-08-09 13:33:09 +02:00
README.md Update README with updated coprs 2023-11-03 13:58:29 +00:00
VERSION.cmake Release 5.2.3.0 2024-06-03 14:14:48 +00:00
clang-format clang-format: use grep -E instead of egrep 2023-04-20 15:36:48 +02:00
clang-tidy-changed Import a new project template 2022-08-09 13:33:09 +02:00
dnf5.spec spec: Fix files and directories ownership 2024-06-05 05:55:04 +00:00
gpl-2.0.txt Import a new project template 2022-08-09 13:33:09 +02:00
lgpl-2.1.txt :Basic pre-commit configuration 2023-03-14 16:26:42 +01:00

README.md

DNF5

DNF5 is a command-line package manager that automates the process of installing, upgrading, configuring, and removing computer programs in a consistent manner. It supports RPM packages, modulemd modules, and comps groups and environments.

As part of the DNF5 stack, libdnf is the package management library. It was originally written to support the DNF package manager, but gradually grew up into a versatile library. You can now use libdnf to build custom tools that load repositories, query packages, resolve dependencies, and install packages.

DNF5 is also powered with the libsolv library which provides an easy to use programming interface.

By using DNF5, you can work with the following artifacts:

  • RPM repositories (repomd)
  • RPM packages
  • Comps groups
  • Comps environments
  • Advisories (updateinfo, errata)
  • Modules (modulemd)

DNF5 is written in C++ and it can interface with the following programming languages:

  • C++ - fully supported.
  • Python 3 - fully supported.
  • Perl 5 - best effort.
  • Ruby - best effort.

Note, however, that DNF5 cannot yet interface with the following programming languages:

  • Go - does not work, we are looking for contributors.
  • C - not implemented, not a priority for any of our existing API users.

Installing DNF5

DNF5 is available since Fedora 38. To install the DNF5 package manager, use either of the following commands, depending on your Fedora release:

Fedora release Command
37 sudo dnf copr enable rpmsoftwaremanagement/dnf-nightly && sudo dnf install dnf51
38 or newer sudo dnf install dnf5

Note: dnf-nightly provides nightly builds for the entire DNF stack. Once you enable this repository you will start receiving updates for DNF, libdnf, and for the other packages of the stack.

Testing DNF5 obsoletes DNF

Optionally you can install DNF5 from these COPR repositories23. The packages are build using the copr option --rpmbuilds-with dnf5_obsoletes_dnf. By installing these packages DNF5 will be the default package manager in your system. You will still be able to use DNF running dnf4.

Packages from dnf5-testing are versioned following Fedora release pace and are updated every two weeks. Packages from dnf5-testing-nightly are built nightly.

Command DNF5 Version
sudo dnf copr enable rpmsoftwaremanagement/dnf5-testing2 Fedora rawhide version
sudo dnf copr enable rpmsoftwaremanagement/dnf5-testing-nightly3 Nightly Builds

Documentation

  • DNF5 HTML Documentation
  • The header files are documented because documentation is mainly generated from these files.

Contributing to the DNF5 project

For details about how to contribute to the DNF5 project, see CONTRIBUTING.md.

  • By contributing to the DNF5 project you agree with the Developer Certificate of Origin (DCO). DCO contains a simple statement that you, as a contributor, have the legal right to submit a contribution. For more details, see the DCO file.
  • All contributions to this project are licensed under LGPLv2.1+ or GPLv2+. For more details, see the License section.

Reporting issues

To report an issue, use either of the following methods:

Developing DNF5 by building and testing the code

For details about building and testing DNF5, see the Development environment setup section.

Translating

TBD

License

  • The DNF5 libraries are licensed under LGPLv2.1+.
  • The standalone programs that are part of the DNF5 project are licensed under GPLv2+.

For more details about licenses, see COPYING.