lp.archiveuploader.dscfile : API documentation

DSCFile and related.

Class representing a DSC file, which encapsulates collections of files representing a source uploaded.

Function	unpack_source	Unpack a source package into a temporary directory
Function	cleanup_unpacked_dir	Remove the directory with an unpacked source package.
Class	SignableTagFile	Base class for signed file verification.
Class	DSCFile	Models a given DSC file and its content.
Class	DSCUploadedFile	Represents a file referred to in a DSC.
Function	findFile	Find and return any file under source_dir
Function	find_copyright	Find and store any debian/copyright.
Function	find_changelog	Find and move any debian/changelog.
Function	check_format_1_0_files	Check that the given counts of each file type suit format 1.0.
Function	check_format_3_0_native_files	Check that the given counts of each file type suit format 3.0 (native).
Function	check_format_3_0_quilt_files	Check that the given counts of each file type suit format 3.0 (native).

def unpack_source(dsc_filepath):

Unpack a source package into a temporary directory

Parameters	dsc_filepath	Path to the dsc file
Returns	Path to the temporary directory with the unpacked sources

def findFile(source_dir, filename):

Find and return any file under source_dir

Parameters	source_file	The directory where the source was extracted
	source_dir	The directory where the source was extracted.
Returns	The full path of the file, else return None if the file is not found.

def find_copyright(source_dir, logger):

Find and store any debian/copyright.

Parameters	source_dir	The directory where the source was extracted.
	logger	A logger object for debug output.
Returns	Contents of copyright file

def find_changelog(source_dir, logger):

Find and move any debian/changelog.

This function finds the changelog file within the source package. The changelog file is later uploaded to the librarian by DSCFile.storeInDatabase().

Parameters	source_dir	The directory where the source was extracted.
	logger	A logger object for debug output.
Returns	Changelog contents

def check_format_1_0_files(filename, file_type_counts, component_counts, component_signature_counts, bzip2_count, xz_count):

Check that the given counts of each file type suit format 1.0.

A 1.0 source must be native (with only one tar.gz), or have an orig.tar.gz and a diff.gz. It cannot use bzip2 or xz compression. If it has an orig.tar.gz, it may have an orig.tar.gz.asc signature.

def check_format_3_0_native_files(filename, file_type_counts, component_counts, component_signature_counts, bzip2_count, xz_count):

Check that the given counts of each file type suit format 3.0 (native).

A 3.0 (native) source must have only one tar.*. Any of gzip, bzip2, and xz compression are permissible.

def check_format_3_0_quilt_files(filename, file_type_counts, component_counts, component_signature_counts, bzip2_count, xz_count):

Check that the given counts of each file type suit format 3.0 (native).

A 3.0 (quilt) source must have exactly one orig.tar.*, one debian.tar.*, and at most one orig-COMPONENT.tar.* for each COMPONENT. Any of gzip, bzip2, and xz compression are permissible. It may have orig.tar.*.asc or orig-COMPONENT.tar.* signatures.

l.a.dscfile : module documentation