Skip to content

Latest commit

 

History

History
101 lines (60 loc) · 2.67 KB

README.md

File metadata and controls

101 lines (60 loc) · 2.67 KB
Raw

yum-daemon

Yum-daemon is a 2 DBus services there make part for Yum's API available for application via DBus calls.

There is a DBus session bus service runnning as current user for performing readonly actions.

There is a DBus system bus service runnning as root for performing actions there is making changes to the system

This make 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.

Yum-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 priviledged user like root.

yum-daemon is still under heavy development and the API is not stable or complete yet

Source overview

yumdaemon/      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 yum-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 kill-session

System

make kill-system

Both

make kill-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 yumdaemon api is documented here

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 yumdaemon-system.py and optional yumdaemon-session.py
  • Add client api method in YumDaemonBase if it is available in both daemon or in YumDaemonClient 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