back to: packages

Portage utils

Description:

Portage-utils is a set of "small and fast portage helper tools written in C".

The idea was to adapt theses tools for paludis. In short we have two patches:

* The first one add support for overlays, (portage users can use this patched version)
* The second one make the q tools to work with paludis

Author(s): truc

Installation

Well, no surprise,

Code:

paludis -i portage-utils

should do it This package also come with two hooks and one configuration file:

Location:

/usr/share/paludis/hooks/common/qlop-hook.bash

/usr/share/paludis/hooks/common/q-reinitialize.bash

/etc/paludis/hooks/config/q-reinitialize.conf

This hook regenerate the the cache files portage-utils uses (.ebuild.x and .metadata.x). And, unless you disable it in the configuration file, it can regenerate the metadata/cache for the overlay with the write_cache key defined and different from /var/empty

A short script palsearch is also included in the package. Use this script to search package on their name or their description see here for a short introduction.

Usage

Basicaly you can do the same with the patched and the vanilla version of portage-utils, it's just that the later will not work with paludis, and even less with your overlays...

Here is some of the main differences:

Code: new options

q --ls-overlays

Overlay(s) :

Name : einit                 location : /var/paludis/repositories/einit                                      metadata : /var/cache/paludis/metadata/einit
Name : initng                location : /var/paludis/repositories/initng                                     metadata : /var/cache/paludis/metadata/initng
Name : paludis-overlay       location : /var/paludis/repositories/paludis-overlay                            metadata : /var/cache/paludis/metadata/paludis-overlay
Name : paludis-extras-scm    location : /home/sam/prog/gentoo/paludis-extras/overlay-scm                     metadata : /var/cache/paludis/metadata/paludis-extras-scm
Name : local                 location : /var/paludis/repositories/local                                      metadata : /var/cache/paludis/metadata/local
Name : gentoo                location : /var/paludis/repositories/gentoo                                     metadata : /var/paludis/repositories/gentoo/metadata/cache
Name : paludis-extras        location : /var/paludis/repositories/paludis-extras                             metadata : /var/cache/paludis/metadata/paludis-extras

You will also notice an --overlay <arg> option has been added to various tools( qlop,qgrep,quse and qsearch), this option generally improves speed by performing the given action on only the the requested overlay (<arg>).

qatom now supports overlays too, and scm,live,cvs and svn version:

Code:

qatom sys-apps/paludis-scm::paludis-extras
sys-apps paludis scm paludis-extras

qatom -c sys-apps/paludis-scm::paludis-extras sys-apps/paludis-22.0::paludis-extras
sys-apps/paludis-scm::paludis-extras > sys-apps/paludis-22.0::paludis-extras

qlop has been modified a lot to be as reliable as possible. you'll find in the changelog examples on how to use it.

files:

Changelog ( download )

<?xml 
include( "../paludis-extras/overlay/overlay/app-portage/portage-utils/ChangeLog"); 
?>

qlop-hook.bash (click to see) ( download )

<?xml include( "src/app-portage/portage-utils/qlop-hook.bash.html"); ?>

If you are interested in the sources, or helping develop, then the sources can be fetched from our anonymous git repo at:

Code:

git clone git://git.paludis-extras.org/app-portage/portage-utils.git

The code is imported directly from gentoo into a seperate repo, which you can fetch here (It's updated every 6 hours):

Code:

git clone git://git.paludis-extras.org/app-portage/portage-utils-cvs.git

Cool external links:.