From Fedora Project Wiki
< Features
m (moved DnfFeatureDraft to Features/DNF) |
m (Fix a typo - "backend") |
||
| (24 intermediate revisions by 7 users not shown) | |||
| Line 4: | Line 4: | ||
<!-- The actual name of your feature page should look something like: Features/YourFeatureName. This keeps all features in the same namespace --> | <!-- The actual name of your feature page should look something like: Features/YourFeatureName. This keeps all features in the same namespace --> | ||
= DNF, a | = DNF and hawkey, a New Package Manager and Package Management Library = | ||
== Summary == | == Summary == | ||
Provide hawkey, a new package management library built on top of [https://github.com/openSUSE/libsolv libsolv]. Preview the next-generation Yum package manager, using hawkey/libsolv for backend. | |||
== Owner == | == Owner == | ||
* Name: [[User: | * Name: [[User:jsilhan| Jan Šilhan]] | ||
* Email: | * Email: jsilhan@redhat.com | ||
== Current status == | == Current status == | ||
* Targeted release: [[Releases/18 | Fedora 18 ]] | * Targeted release: [[Releases/18 | Fedora 18 ]] | ||
* Last updated: {{REVISIONYEAR}}-{{REVISIONMONTH}}-{{REVISIONDAY2}} | * Last updated: {{REVISIONYEAR}}-{{REVISIONMONTH}}-{{REVISIONDAY2}} | ||
* Percentage of completion: | * Percentage of completion: 100% | ||
The DNF package and its dependencies are in f18 repositories now, in a testable state. | |||
* yum commands supported in the F18 version of dnf: clean, downgrade, erase, help, history, info, install, list, makecache, provides, repolist, update | |||
* by default DNF has a cronjob enabled that periodically syncs the enabled repos' metadata | |||
* the API for plugins is not a part of this version | |||
* the API for extensions is not a part of this version | |||
== Detailed Description == | == Detailed Description == | ||
DNF is a fork of Yum 3.4 that uses libsolv for a | [https://github.com/rpm-software-management/hawkey hawkey] is a library allowing clients to query and resolve dependencies of RPM packages based on the current state of RPMDB and yum repositories. While a superset of the functionality itself is available in yum, the new API promises to bring unification, fewer restrictions on clients' implementation language (yum API is in Python) and eventually performance improvements. | ||
The API version of hawkey in Fedora 18 will not be final one, it will more be to demonstrate the concepts of the library. Projects needing depsolving in Fedora will be encouraged to start experimenting and reporting bugs and missing features. | |||
DNF is a fork of Yum 3.4 that uses libsolv via hawkey for a backend. The main goals of the project are: | |||
* using a SAT solver for dependency resolving | * using a SAT solver for dependency resolving | ||
** allowing us to eventually use the same solver in rpm too | ** allowing us to eventually use the same solver in rpm too | ||
| Line 30: | Line 38: | ||
* better performance and memory footprint. | * better performance and memory footprint. | ||
For Fedora 18 this is mainly meant as a preview. The package can be installed along yum so user's workflow is not disturbed when DNF malfunctions. | For Fedora 18 this is mainly meant as a preview. The package can be installed along yum so user's workflow is not disturbed when DNF malfunctions. The users will be advised against using DNF on critical production machines. | ||
=== Naming === | |||
DNF stands for Dandified yum. Since DNF is a tech preview in Fedora 18 the Python module names can not be 'yum.*' as that would clash with yum itself. | |||
=== Why not zif/zypp? === | === Why not zif/zypp? === | ||
People are asking why we didn't choose to adopt zif (or SUSE's zypp) instead of fixing yum. The reasons are: | People are asking why we didn't choose to adopt zif (or SUSE's zypp) instead of fixing yum. The reasons are: | ||
* dnf looks for a middle ground between a sane API and some backwards compatibility. | * dnf looks for a middle ground between a sane API and some backwards compatibility. | ||
* dnf and hawkey are first steps toward using the same resolver | * dnf and hawkey are first steps toward using the same resolver across the entire stack. | ||
* Libsolv is a well tested and proven code base, currently the most sophisticated and optimized dependency solving implementation. | * Libsolv is a well tested and proven code base, currently the most sophisticated and optimized dependency solving implementation. | ||
== Benefit to Fedora == | == Benefit to Fedora == | ||
Faster and simpler package manager. | |||
Hawkey clients will get: | |||
* easier bindings to other languages than Python | |||
* concise, clear package management API | |||
* better performance (through utilizing libsolv) | |||
The set of possible hawkey API consumers: | |||
* dnf (the next generation yum) | |||
* release engineering [https://github.com/akozumpl/hawkey/wiki/Use-cases tools] | |||
* PackageKit | |||
* graphical package management tools | |||
* Anaconda | |||
DNF clients and users will get: | |||
* Faster and simpler package manager. | |||
* Simplified client code. | |||
== Scope == | == Scope == | ||
=== Including libsolv in Fedora === | |||
This is a library for fast dependencies resolving created and maintained by SUSE. The rpms are in Fedora already, we will need to rebase the package as needed. | |||
=== hawkey package === | |||
Including documentation for the API. | |||
=== How To Test === | === How To Test === | ||
| Line 60: | Line 91: | ||
--> | --> | ||
Unit tests included | Unit tests included for: | ||
* hawkey C API | |||
* hawkey Python bindings | |||
* DNF | |||
Manual testing is done by performing actions one would normally do through yum, e.g. 'dnf install virt-manager'. | Manual testing is done by performing actions one would normally do through yum, e.g. 'dnf install virt-manager'. | ||
| Line 66: | Line 100: | ||
== User Experience == | == User Experience == | ||
=== Hawkey User Experience === | |||
None visible (hawkey is a new library). | |||
=== DNF User Experience === | |||
To test-drive dnf use 'dnf <command>' instead of 'yum <command>'. list/update/install/erase are currently all supported. | To test-drive dnf use 'dnf <command>' instead of 'yum <command>'. list/update/install/erase are currently all supported. | ||
<!-- If this feature is noticeable by its target audience, how will their experiences change as a result? Describe what they will see or notice. --> | <!-- If this feature is noticeable by its target audience, how will their experiences change as a result? Describe what they will see or notice. --> | ||
| Line 73: | Line 110: | ||
<!-- What other packages (RPMs) depend on this package? Are there changes outside the developers' control on which completion of this feature depends? In other words, completion of another feature owned by someone else and might cause you to not be able to finish on time or that you would need to coordinate? Other upstream projects like the kernel (if this is not a kernel feature)? --> | <!-- What other packages (RPMs) depend on this package? Are there changes outside the developers' control on which completion of this feature depends? In other words, completion of another feature owned by someone else and might cause you to not be able to finish on time or that you would need to coordinate? Other upstream projects like the kernel (if this is not a kernel feature)? --> | ||
Hawkey is a new library and will be only depended on by DNF at this point. | |||
DNF will not disturb any existing Fedora software. | |||
In the future if DNF gets accepted as the main package manager of the platform, yum plugins will have to be updated for the new API and so will Anaconda. I am prepared to assist in this effort with documentation and patches. | In the future if DNF gets accepted as the main package manager of the platform, yum plugins will have to be updated for the new API and so will Anaconda. I am prepared to assist in this effort with documentation and patches. | ||
| Line 84: | Line 123: | ||
== Documentation == | == Documentation == | ||
For dnf: | |||
* development documentation maintained [https://github.com/rpm-software-management/dnf/wiki at github wiki] | |||
* manpage available in the package and [http://rpm-software-management.github.io/dnf/command_ref.html online] | |||
For hawkey: | |||
* development documentation maintained [https://github.com/rpm-software-management/hawkey/wiki in a wiki] | |||
* faq and tutorial are [https://github.com/rpm-software-management/hawkey online] | |||
== Release Notes == | == Release Notes == | ||
<!-- The Fedora Release Notes inform end-users about what is new in the release. Examples of past release notes are here: http://docs.fedoraproject.org/release-notes/ --> | <!-- The Fedora Release Notes inform end-users about what is new in the release. Examples of past release notes are here: http://docs.fedoraproject.org/release-notes/ --> | ||
<!-- The release notes also help users know how to deal with platform changes such as ABIs/APIs, configuration or data file formats, or upgrade concerns. If there are any such changes involved in this feature, indicate them here. You can also link to upstream documentation if it satisfies this need. This information forms the basis of the release notes edited by the documentation team and shipped with the release. --> | <!-- The release notes also help users know how to deal with platform changes such as ABIs/APIs, configuration or data file formats, or upgrade concerns. If there are any such changes involved in this feature, indicate them here. You can also link to upstream documentation if it satisfies this need. This information forms the basis of the release notes edited by the documentation team and shipped with the release. --> | ||
None yet. | |||
== Comments and Discussion == | == Comments and Discussion == | ||
[[Category: | Please report bugs and missing Yum features to the [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora Red Hat Bugzilla]. | ||
[[Category:FeatureAcceptedF18]] | |||
<!-- When your feature page is completed and ready for review --> | <!-- When your feature page is completed and ready for review --> | ||
<!-- remove Category:FeaturePageIncomplete and change it to Category:FeatureReadyForWrangler --> | <!-- remove Category:FeaturePageIncomplete and change it to Category:FeatureReadyForWrangler --> | ||
<!-- After review, the feature wrangler will move your page to Category:FeatureReadyForFesco... if it still needs more work it will move back to Category:FeaturePageIncomplete--> | <!-- After review, the feature wrangler will move your page to Category:FeatureReadyForFesco... if it still needs more work it will move back to Category:FeaturePageIncomplete--> | ||
<!-- A pretty picture of the page category usage is at: https://fedoraproject.org/wiki/Features/Policy/Process --> | <!-- A pretty picture of the page category usage is at: https://fedoraproject.org/wiki/Features/Policy/Process --> | ||
Latest revision as of 17:20, 15 November 2015
DNF and hawkey, a New Package Manager and Package Management Library
Summary
Provide hawkey, a new package management library built on top of libsolv. Preview the next-generation Yum package manager, using hawkey/libsolv for backend.
Owner
- Name: Jan Šilhan
- Email: jsilhan@redhat.com
Current status
- Targeted release: Fedora 18
- Last updated: 2015-11-15
- Percentage of completion: 100%
The DNF package and its dependencies are in f18 repositories now, in a testable state.
- yum commands supported in the F18 version of dnf: clean, downgrade, erase, help, history, info, install, list, makecache, provides, repolist, update
- by default DNF has a cronjob enabled that periodically syncs the enabled repos' metadata
- the API for plugins is not a part of this version
- the API for extensions is not a part of this version
Detailed Description
hawkey is a library allowing clients to query and resolve dependencies of RPM packages based on the current state of RPMDB and yum repositories. While a superset of the functionality itself is available in yum, the new API promises to bring unification, fewer restrictions on clients' implementation language (yum API is in Python) and eventually performance improvements.
The API version of hawkey in Fedora 18 will not be final one, it will more be to demonstrate the concepts of the library. Projects needing depsolving in Fedora will be encouraged to start experimenting and reporting bugs and missing features.
DNF is a fork of Yum 3.4 that uses libsolv via hawkey for a backend. The main goals of the project are:
- using a SAT solver for dependency resolving
- allowing us to eventually use the same solver in rpm too
- strict API definition for plugins
- strict API definition for extending projects (Anaconda)
- leaner codebase than Yum, allowing for easier maintenance
- better performance and memory footprint.
For Fedora 18 this is mainly meant as a preview. The package can be installed along yum so user's workflow is not disturbed when DNF malfunctions. The users will be advised against using DNF on critical production machines.
Naming
DNF stands for Dandified yum. Since DNF is a tech preview in Fedora 18 the Python module names can not be 'yum.*' as that would clash with yum itself.
Why not zif/zypp?
People are asking why we didn't choose to adopt zif (or SUSE's zypp) instead of fixing yum. The reasons are:
- dnf looks for a middle ground between a sane API and some backwards compatibility.
- dnf and hawkey are first steps toward using the same resolver across the entire stack.
- Libsolv is a well tested and proven code base, currently the most sophisticated and optimized dependency solving implementation.
Benefit to Fedora
Hawkey clients will get:
- easier bindings to other languages than Python
- concise, clear package management API
- better performance (through utilizing libsolv)
The set of possible hawkey API consumers:
- dnf (the next generation yum)
- release engineering tools
- PackageKit
- graphical package management tools
- Anaconda
DNF clients and users will get:
- Faster and simpler package manager.
- Simplified client code.
Scope
Including libsolv in Fedora
This is a library for fast dependencies resolving created and maintained by SUSE. The rpms are in Fedora already, we will need to rebase the package as needed.
hawkey package
Including documentation for the API.
How To Test
Unit tests included for:
- hawkey C API
- hawkey Python bindings
- DNF
Manual testing is done by performing actions one would normally do through yum, e.g. 'dnf install virt-manager'.
User Experience
Hawkey User Experience
None visible (hawkey is a new library).
DNF User Experience
To test-drive dnf use 'dnf <command>' instead of 'yum <command>'. list/update/install/erase are currently all supported.
Dependencies
Hawkey is a new library and will be only depended on by DNF at this point.
DNF will not disturb any existing Fedora software.
In the future if DNF gets accepted as the main package manager of the platform, yum plugins will have to be updated for the new API and so will Anaconda. I am prepared to assist in this effort with documentation and patches.
Contingency Plan
If DNF doesn't work the user can use yum instead.
Documentation
For dnf:
- development documentation maintained at github wiki
- manpage available in the package and online
For hawkey:
Release Notes
None yet.
Comments and Discussion
Please report bugs and missing Yum features to the Red Hat Bugzilla.