https://github.com/manatools/dnfdaemon
DBus daemon for doing package action with the dnf package manager
https://github.com/manatools/dnfdaemon
daemon dbus dnf dnf-daemon fedora mageia
Last synced: 5 months ago
JSON representation
DBus daemon for doing package action with the dnf package manager
- Host: GitHub
- URL: https://github.com/manatools/dnfdaemon
- Owner: manatools
- License: gpl-2.0
- Created: 2014-03-08T06:01:07.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2023-12-20T16:11:50.000Z (about 2 years ago)
- Last Synced: 2025-08-11T02:48:13.003Z (5 months ago)
- Topics: daemon, dbus, dnf, dnf-daemon, fedora, mageia
- Language: Python
- Size: 488 KB
- Stars: 12
- Watchers: 5
- Forks: 16
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog
- License: COPYING
Awesome Lists containing this project
README
dnf-daemon
===========
dnf-daemon is a 2 DBus services there make part for dnf's API available for application via DBus calls.
There is a DBus session bus service running as current user for performing readonly actions.
There is a DBus system bus service running as root for performing actions there is making changes to the system
This makes it easy to do packaging action from your application no matter what language it is written in, as long as there
is DBus binding for it.
dnf-daemon uses PolicyKit for authentication for the system service, so when you call one of the commands (as normal users) you will get a
PolicyKit dialog to ask for password of a privileged user like root.
**dnf-daemon is still under heavy development and the API is not stable or complete yet**
Source overview
----------------
dnfdaemon/ Contains the daemon python source
client/ Contains the client API bindings for python 2.x & 3.x
test/ Unit test for the daemon and python bindings
dbus/ DBus system service setup files
policykit1/ PolicyKit authentication setup files
How to install services and python bindings:
-----------------------------------------------
Run the following
```
git clone ...
cd dnf-daemon
make test-inst
```
How to test:
-------------
just run:
make test-verbose
to run the unit test with output to console
or this to just run the unit tests.
make test
To make the daemons shutdown
-------------------------------
Session:
make exit-session
System
make exit-system
Both
make exit-both
to run the daemons in debug mode from checkout:
------------------------------------------------
session (readonly as current user)
make run-session
system (as root)
make run-system
API Definitions:
====================================
The dnfdaemon api is documented [here](http://dnf-daemon.readthedocs.org/en/latest/index.html)
The API is under development, so it might change, when we hit version 1.0, API methods will be frozen and
API method names, parameters and return types will not change in future releases, new API can be added,
but the old ones stays as is
API Addition Checklist:
====================================
* Add the new API methods to dnfdaemon-system.py and optional dnfdaemon-session.py
* Add client api method in DnfDaemonBase if it is available in both daemon
or in DnfDaemonClient is it is a system only api.
* Add unit tests for the api in test/test-system-api.py and optional to test/test-system-api.py if it exists in the session api
* Update docs/server.rst and docs/client-python.api ( add new api method to members )
* All unit tests must pass (make test) before pushing to github