Scroll to navigation

Debian::L10n::Db(3pm) User Contributed Perl Documentation Debian::L10n::Db(3pm)

NAME

Debian::L10n::Db - handle database of debian l10n stuff

SYNOPSIS

 use Debian::L10n::Db;
 my $l10n_db = Debian::L10n::Db->new();
 $l10n_db->read("../data/unstable");
 foreach ($l10n_db->list_packages()) {
         print "Package $_ ".$l10n_db->version($_)."\n";
 }

DESCRIPTION

This module is an interface to the database files used in several places of the debian localisation infrastructure, such as the webpages under "webwml/<language>/internaltional/l10n/".

METHODS

new
This is the constructor, it only performs some initialization. 

   my $l10n_db = Debian::L10n::Db->new();
read
Read database from a given file. Returns 1 on success and otherwise 0. 

   $l10n_db->read("foo");
write
Write database into file. 

   $l10n_db->write("foo");
list_packages
Returns an array with the list of package names
clear_pkg
Reset info for a given package 

   $l10n_db->clear_pkg("foo");
set_status
Change the status for the category specified as second argument.
del_status
If a reference to a statusline is provided, it removes the first found It should remove the right line (pkg, type, and file) from the DB, and empty the package if nothing else is left.
get_header
Returns the value of the specified header
set_header
Sets the specified header to the specified value
get_date
Returns date of generation
set_date
Sets the date of generation
clean-db
clean_db cleans the database by removing data for a document whose status is 'done' for more than three days.

DATA MANIPULATION

Data about packages can be classified within scalar values ("package", "version", "section", "priority", "maintainer", "pooldir", "type", "upstream"), arrays ("errors", "catgets", "gettext"), and arrays of arrays ("nls", "po", "po4a", "templates", "podebconf", "man", "menu" and "desktop"). Each field has a method with the same name to get and set it, e.g. 

   $section = $l10n_db->section($pkg);
   $l10n_db->section($pkg, "libs");

The first line get the section associated with the package in $pkg, whereas the second set it to "libs".

Two other methods are also defined to access those data, by prefixing field name by "has_" and "add_". The former is used to ask whether this field is defined in database, and the latter appends values for arrays or arrays of arrays.

   if ($l10n_db->has_templates($pkg)) {
           print "Package $pkg has Debconf templates\n";
   }
   $l10n_db->add_po($pkg, 'po/fr.po', 'fr', '42t0f0u', 'po/adduser_3.42_po_fr.po');

AUTHOR

Copyright (C) 2001-2004 Denis Barbier <barbier@debian.org> Copyright (C) 2004 Martin Quinson <enough@spam>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

2011-03-30 perl v5.14.2