https://github.com/manatools/dnfdragora

dnfdragora is a dnf frontend based on libyui abstraction
https://github.com/manatools/dnfdragora

dnf fedora libyui-mga mageia package-manager python-3 rpm

Last synced: 6 days ago
JSON representation

dnfdragora is a dnf frontend based on libyui abstraction

• Host: GitHub
• URL: https://github.com/manatools/dnfdragora
• Owner: manatools
• License: gpl-3.0
• Created: 2016-03-28T20:05:49.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2025-01-08T14:54:54.000Z (14 days ago)
• Last Synced: 2025-01-11T04:42:06.126Z (11 days ago)
• Topics: dnf, fedora, libyui-mga, mageia, package-manager, python-3, rpm
• Language: Python
• Homepage:
• Size: 5.71 MB
• Stars: 142
• Watchers: 15
• Forks: 41
• Open Issues: 40
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes
  • License: LICENSE
  • Authors: AUTHORS

Awesome Lists containing this project

README

        
# dnfdragora 

![logo](https://raw.githubusercontent.com/manatools/dnfdragora/master/share/images/64x64/dnfdragora-logo.png "dnfdragora") dnfdragora is a [DNF](http://dnf.readthedocs.io/en/latest/) frontend, based on rpmdragora from Mageia (originally rpmdrake) Perl code.

dnfdragora is written in Python 3 and uses libYui, the widget abstraction library written by SUSE, so that it can be run using Qt 5, GTK+ 3, or ncurses interfaces.

Example with Qt:

![dnfdragora with Qt UI](screenshots/dnfdragora-qt.png "dnfdragora with Qt UI")

Example with GtK:

![dnfdragora with GtK UI](screenshots/dnfdragora-gtk.png "dnfdragora with GtK UI")

Example with ncurses:

![dnfdragora with ncurses UI](screenshots/dnfdragora-ncurses.png "dnfdragora with ncurses UI")

## REQUIREMENTS

### DNF5 Daemon

* https://github.com/rpm-software-management/dnf5

* Version higher than 5.2.7 required.

### pystray >= 0.17.3

* https://github.com/moses-palmer/pystray

### SUSE libyui >= 4.2.14

* https://github.com/libyui/libyui

* Consider to check some not yet approved changes here https://github.com/anaselli/libyui

### libyui-mga >= 1.2.1 - our widget extension

* https://github.com/manatools/libyui-mga

### SUSE libyui-bindings (included into libyui)

* https://github.com/libyui/libyui

### python-manatools >= 0.0.4

* https://github.com/manatools/python-manatools

### at least one of the SUSE libyui plugins

* libyui-gtk     - https://github.com/libyui/libyui-gtk

* libyui-ncurses - https://github.com/libyui/libyui

* libyui-qt      - https://github.com/libyui/libyui

* Consider here also to check some not yet approved changes at

  https://github.com/anaselli/libyui-XXX forks (where XXX is

  gtk, qt or ncurses)

### at least one of the MGA libyui widget extension plugins (according to the one above)

* libyui-mga-gtk     - https://github.com/manatools/libyui-mga-gtk

* libyui-mga-ncurses - https://github.com/manatools/libyui-mga-ncurses

* libyui-mga-qt      - https://github.com/manatools/libyui-mga-qt

## INSTALLATION

### Distribution packages:

* Mageia:

    * dnfdragora: `dnf install dnfdragora` or `urpmi dnfdragora`

    * dnfdragora-gui: `dnf install dnfdragora-` or `urpmi dnfdragora-`

        * Replace `` with `qt` or `gtk` depending on desired toolkit

* Fedora:

    * dnfdragora:     `dnf install dnfdragora`     (installs all needed for use on terminal)

    * dnfdragora-gui: `dnf install dnfdragora-gui` (installs all needed for use in desktop environment)

### From sources:

* Packages needed to build:

    * cmake >= 3.4.0

    * python3-devel >= 3.4.0

    * optional: gettext        (for locales)

    * optional: python3-sphinx (for manpages)

* Configure: `mkdir build && cd build && cmake ..`

    * -DCMAKE_INSTALL_PREFIX=/usr      - Sets the install path, eg. /usr, /usr/local or /opt

    * -DCHECK_RUNTIME_DEPENDENCIES=ON  - Checks if the needed runtime dependencies are met.

    * -DENABLE_COMPS=ON                - Useful if your distribution uses COMPS for groups, eg. Fedora, RHEL, CentOS

* Build:     `make`

* Install:   `make install`

* Run:       `dnfdragora`

### From sources (for developers and testers only):

* Packages needed to build:

    * cmake >= 3.4.0

    * python3-devel >= 3.4.0

    * python3-virtualenv

    * optional: gettext        (for locales)

    * optional: python3-sphinx (for manpages)

* Setup your virtual environment

    * cd $DNFDRAGORA_PROJ_DIR                 # DNFDRAGORA_PROJ_DIR is the dnfdragora project directory

    * virtualenv --system-site-packages venv  # create virtual environment under venv directory

    * . venv/bin/activate                     # activate virtual environment

* Configure: `mkdir build && cd build && cmake -D... .. && make install`

    * needed cmake options are

        * -DCMAKE_INSTALL_PREFIX=$DNFDRAGORA_PROJ_DIR/venv              - venv install prefix 

        * -DCMAKE_INSTALL_FULL_SYSCONFDIR=$DNFDRAGORA_PROJ_DIR/venv/etc - venv sysconfig directory

    * useful cmake options are

        * -DCHECK_RUNTIME_DEPENDENCIES=ON  - Checks if the needed runtime dependencies are met.

        * -DENABLE_COMPS=ON                - Useful if your distribution uses COMPS for groups, eg. Fedora, RHEL, CentOS

* Run: `dnfdragora` into virtual environment, add '--locales-dir' option if you want to test localization locally)

    * useful dnfdragora options are

        * --locales-dir         - if you want to test localization locally

        * --images-path         - local icons and images (set to $DNFDRAGORA_PROJ_DIR/venv/share/dnfdragora/images/)

## CONTRIBUTE

ManaTools and dnfdragora developers (as well as some users and contributors) are on Matrix. They often discuss development issues there

to get immediate feedback and develop ideas. The Matrix room is [`#manatools:matrix.org`](https://matrix.to/#/!manatools:matrix.org).

The Matrix room is also bridged to the IRC channel `#manatools` on Libera Chat. Get in touch with us!

If you have any issues or ideas add or comment an [issue](https://github.com/manatools/dnfdragora/issues).

Check also into our [TODO](TODO.md) file.

## LICENSE AND COPYRIGHT

See [license](LICENSE) file.