debian::l10n::db(3pm) [debian man page]
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($_)." "; } 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 "; } $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. perl v5.14.2 2011-03-30 Debian::L10n::Db(3pm)
Check Out this Related Man Page
Debian::Dependency(3pm) User Contributed Perl Documentation Debian::Dependency(3pm) NAME
Debian::Dependency - dependency relationship between Debian packages SYNOPSIS
# simple dependency my $d = Debian::Dependency->new( 'perl' ); # also parses a single argument my $d = Debian::Dependency->new('perl (>= 5.10)'); # dependency with a version my $d = Debian::Dependency->new( 'perl', '5.10' ); # dependency with version and relation my $d = Debian::Dependency->new( 'perl', '>=', '5.10' ); print $d->pkg; # 'perl' print $d->ver; # '5.10' # for people who like to type much my $d = Debian::Dependency->new( { pkg => 'perl', ver => '5.10' } ); # stringification print "$d" # 'perl (>= 5.10)' # 'adding' $deps = $dep1 + $dep2; $deps = $dep1 + 'foo (>= 1.23)' CLASS_METHODS new() Construnct a new instance. new( { pkg => 'package', rel => '>=', ver => '1.9' } ) If a hash reference is passed as an argument, its contents are used to initialize the object. new( [ { pkg => 'foo' }, 'bar (<= 3)' ] ); In an array reference is passed as an argument, its elements are used for constructing a dependency with alternatives. new('foo (= 42)') new('foo (= 42) | bar') If a single argument is given, the construction is passed to the "parse" constructor. new( 'foo', '1.4' ) Two arguments are interpreted as package name and version. The relation is assumed to be '>='. new( 'foo', '=', '42' ) Three arguments are interpreted as package name, relation and version. set Overrides the set method from Class::Accessor. Used to convert zero versions (for example 0 or 0.000) to void versions. parse() Takes a single string argument and parses it. Examples: perl perl (>= 5.8) libversion-perl (<< 3.4) FIELDS pkg Contains the name of the package that is depended upon rel Contains the relation of the dependency. May be any of '<<', '<=', '=', '>=' or '>>'. Default is '>='. ver Contains the version of the package the dependency is about. The value is an instance of Dpkg::Version class. If you set it to a scalar value, that is given to Dpkg::Version->new(). "rel" and "ver" are either both present or both missing. Examples print $dep->pkg; $dep->ver('3.4'); METHODS
satisfies($dep) Returns true if $dep states a dependency that is already covered by this instance. In other words, if this method returns true, any package satisfying the dependency of this instance will also satisfy $dep ($dep is redundant in dependency lists where this instance is already present). $dep can be either an instance of the Debian::Dependency class, or a plain string. my $dep = Debian::Dependency->new('foo (>= 2)'); print $dep->satisfies('foo') ? 'yes' : 'no'; # no print $dep->satisfies('bar') ? 'yes' : 'no'; # no print $dep->satisfies('foo (>= 2.1)') ? 'yes' : 'no'; # yes SEE ALSO
Debian::Dependencies AUTHOR
Damyan Ivanov <dmn@debian.org> COPYRIGHT &; LICENSE Copyright (C) 2008,2009,2010 Damyan Ivanov <dmn@debian.org> This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. perl v5.14.2 2012-01-15 Debian::Dependency(3pm)