Yum plugin that shows package descriptions when using the yum CLI.
This repository has been archived on 2023-10-26. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
2020-05-13 19:42:21 -04:00
yumwat Attempt to repress printing deets for same package twice. Untested until I have a transaction list I can test with. 2013-09-26 11:29:06 -04:00
.gitignore Initial commit 2013-06-02 13:12:25 -07:00
.pythong updates for 2018 2018-02-10 16:52:26 -05:00
CHANGES.rst Completion of install script brings us to a solid 1.0 release, I\'d say. 2014-03-08 17:06:00 -05:00
distribute_setup.py Run yumwat on the project. 2013-09-25 15:04:07 -04:00
distribute-0.6.35.tar.gz Implement MANIFEST.in to properly track all files for sdist tarball. 2013-09-25 16:11:07 -04:00
install.sh Completion of install script brings us to a solid 1.0 release, I\'d say. 2014-03-08 17:06:00 -05:00
MANIFEST.in Add README.rst to manifest for good measure, and add CHANGES.rst file that I am about to commit. 2013-09-25 16:23:56 -04:00
README.rst update before repo archive 2020-05-13 19:42:21 -04:00
setup.py update before repo archive 2020-05-13 19:42:21 -04:00
uninstall.sh Add uninstall script. 2013-09-25 15:54:29 -04:00

yumwat
======

:Author: David Gay <hello@davidgay.org>

Wild card! David Gay writes a yum plugin!

⚠️ This project is no longer maintained. As of 2020, it hasn't been updated
in six or seven years. Use at your own risk.

Wat
---

When I use yum to update my system or install new packages, I sometimes spot a
package I am unfamiliar with, such as the ``mesa-dri-filesystem`` package I saw
the other day. In some graphical extensions of yum, a brief discription of the
package is listed under each package name. I figured I'd check out some docs on
writing yum plugins, to see if I could display a description under each package
name in the CLI updater. Then the Internet was like, "Yo, each yum plugin is a
single file, written in the Python programming language", and after I cleaned
up my brain which had EXPLODED out of my HEAD I made this repo and now we are
on a science adventure.

License
-------

GNU GPL v3+.

Installing
----------

Installation is easy! From the project directory (where this file is),
do the following.

Shell Script
************

I have written a bit of a shell script that does the above installation
for you. It is ``install.sh``, and will require root privs, like
so: ``sudo ./install.sh``.

Manual Installation
*******************

1.  Install the plugin file: ``sudo cp yumwat.py /usr/lib/yum-plugins/``

2.  Install the plugin's configuration file: ``sudo cp yumwat.conf
    /etc/yum/pluginconf.d/``

3.  Add the line ``pluginpath=/usr/lib/yum-plugins`` to the file
    ``/etc/yum.conf``.

Timid mode
----------

The ``yumwat.conf`` file contains the line ``timid=0``. If timid is
set to 0, timid mode is off, and yumwat will print output unless
the ``--nowat`` option is used with yum. If timid is set to 1,
timid mode is on, and yumwat will not print output unless the
``--wat`` option is used with yum.

See below for how to easily enable or disable timid mode.

Enabling and Disabling
----------------------

**Enable yumwat** -- ``sudo /usr/lib/yum-plugins/yumwat.py enable``

**Disable yumwat** -- ``sudo /usr/lib/yum-plugins/yumwat.py disable``

**Enable timid mode** -- ``sudo /usr/lib/yum-plugins/yumwat.py timid``

**Disable timid mode** -- ``sudo /usr/lib/yum-plugins/yumwat.py assertive``

Uninstalling
------------

Easier than installation! We just need to make sure you remove the
generated bytecode file, too. You can do this by running the uninstall
script packaged with this plugin with root privs::

    sudo ./uninstall.sh

Otherwise, follow these steps:

1.  Remove the configuration file: ``sudo rm /etc/yum/pluginconf.d/yumwat.conf``

2.  Remove the plugin file and its generated bytecode: ``sudo rm
    /usr/lib/yum-plugins/yumwat.{py,pyc}``