NAME

Dpkg::Source::Format - manipulate debian/source/format files

DESCRIPTION

This module provides a class that can manipulate Debian source package debian/source/format files.

METHODS

$f = Dpkg::Source::Format->new(%opts)

Creates a new object corresponding to a source package's debian/source/format file.

Options:

$f->set_from_parts($major[, $minor[, $variant]])

Sets the source format from its parts. The $major part is mandatory. The $minor and $variant parts are optional.

Notice: This function performs no validation.

($major, $minor, $variant) = $f->set($format)

Sets (and validates) the source $format specified. Will return the parsed format parts as a list, the optional $minor and $variant parts might be undef.

($major, $minor, $variant) = $f->get()

$format = $f->get()

Gets the source format, either as properly formatted scalar, or as a list of its parts, where the optional $minor and $variant parts might be undef.

$count = $f->parse($fh, $desc)

Parse the source format string from $fh, with filehandle description $desc.

$count = $f->load($filename)

Parse $filename contents for a source package format string.

$str = $f->output([$fh])

"$f"

Returns a string representing the source package format version. If $fh is set, it prints the string to the filehandle.

$f->save($filename)

Save the source package format into the given $filename.

CHANGES