Cupt::Cache::SourceVersion.3pm

Langue: en

Version: 2010-06-14 (ubuntu - 24/10/10)

Section: 3 (Bibliothèques de fonctions)

NAME

Cupt::Cache::SourceVersion - store info about specific version of deb source package

FIELDS

available_as

   {
     'release' => $release_info
     'directory' => download URI appendage (directory part)
   }
 
 

See Release info in Cupt::Cache.

package_name

name of the package, string, defined in Debian Policy, X3.1

binary_package_names

reference to array of binary package names (strings) that build from this package

architecture

source architecture of the package, string, defined in Debian Policy, X5.6.8

priority

priority, string, defined in Debian Policy, X5.6.6

section

section, string, defined in Debian Policy, X5.6.5, can be undef

standards_version

version of the last Debian Policy the package conforms to

maintainer

maintainer of the package, string

uploaders

package uploaders list, reference to array of strings, defined in Debian Policy, X5.6.3

version_string

version string, defined in Debian Policy, X5.6.12

build_depends

[ relation_expression... ]

Debian Policy, X7.1, 'Build-Depends'

Note that relation expression in this in all other fields of this class is build upon Cupt::Cache::ArchitecturedRelation which is subclass of Cupt::Cache::Relation.

build_depends_indep

[ relation_expression... ]

Debian Policy, X7.1, 'Build-Depends-Indep'

build_conflicts

[ relation_expression... ]

Debian Policy, X7.1, 'Build-Conflicts'

build_conflicts_indep

[ relation_expression... ]

Debian Policy, X7.1, 'Build-Conflicts-Indep'

tarball

   {
     'filename' => download URI appendage (file name ("leaf") part)
     'size' => size
     'md5sum' => MD5 hash sum of the file, can be undef
     'sha1sum' => SHA1 hash sum of the file, can be undef
     'sha256sum' => SHA256 hash sum of the file, can be undef
   }
 
 

diff

same as tarball, can be whole undef in case of Debian native package

dsc

same as tarball

others

hash entry that contains other fields found in the version entry in form { $name => $value }.

FLAGS

o_no_parse_relations

Option to don't parse dependency relation between packages, can speed-up parsing the version if this info isn't needed. Off by default.

o_no_parse_info_onlys

Option to don't parse 'Maintainer', 'Uploaders', 'Section' and unknown fields (those which are put to others), can speed-up parsing the version if this info isn't needed. Off by default.

METHODS

new

creates an Cupt::Cache::SourceVersion

Parameters:

initializer_argument - [ $package_name, fh, offset, ref_release_info ]

where

fh - file handle to opened file that contains version entry

offset - offset in bytes to locate version entry in fh, may include 'Package:' line or not

ref_release_info - reference to release info

METHODS

uris

method, returns available URIs to download the .deb file.

Returns:

   {
     'tarball' => [ I<URI entry>... ],
     (optionally) 'diff' => [ I<URI entry>... ],
     'dsc' => [ I<URI entry>... ],
   }
 
 

where:

URI entry - { 'download_uri' => download_uri, 'base_uri' => base_uri, 'appendage' => appendage }

download_uri - full URI to download

base_uri - base URI (as specified in sources.list)

appendage - string to append to base URI to compute download_uri, contains 'Filename' property of package entries.

is_signed

method, returns whether this version has signed source or not