lp.archiveuploader.uploadprocessor.UploadHandler : API documentation

Method	__init__	Constructor.
Static Method	forProcessor	Instantiate an UploadHandler subclass for a given upload.
Method	locateChangesFiles	Locate .changes files in the upload directory.
Method	processChangesFile	Process a single changes file.
Method	removeUpload	Remove an upload that has succesfully been processed.
Method	moveProcessedUpload	Move or remove the upload depending on the status of the upload.
Method	moveUpload	Move the upload to the named subdir of the root, eg 'accepted'.
Static Method	orderFilenames	`Order filenames, sorting *_source.changes before others.`

def __init__(self, processor, fsroot, upload):

overridden in lp.archiveuploader.uploadprocessor.BuildUploadHandler

Constructor.

Parameters	processor	The `UploadProcessor` that requested processing the upload.
	fsroot	Path to the directory containing the upload directory
	upload	Name of the directory containing the upload.

@staticmethod
def forProcessor(processor, fsroot, upload, build=None):

Instantiate an UploadHandler subclass for a given upload.

Parameters	processor	The `UploadProcessor` that requested processing the upload.
	fsroot	Path to the directory containing the upload directory
	upload	Name of the directory containing the upload.
	build	Optional; the build that produced the upload.

def locateChangesFiles(self):

Locate .changes files in the upload directory.

Return .changes files sorted with *_source.changes first. This
is important to us, as in an upload containing several changes files,
it's possible the binary ones will depend on the source ones, so
the source ones should always be considered first.

def processChangesFile(self, changes_file, logger=None):

Process a single changes file.

This is done by obtaining the appropriate upload policy (according to command-line options), creating a NascentUpload object and calling its process method.

We obtain the context for this processing from the relative path, within the upload folder, of this changes file. This influences our creation both of upload policy and the NascentUpload object.

See nascentupload.py for the gory details.

Returns a value from UploadStatusEnum, or re-raises an exception from NascentUpload.

Parameters	changes_file	filename of the changes file to process.
	logger	logger to use for processing.
Returns	an `UploadStatusEnum` value

def removeUpload(self, logger):

Remove an upload that has succesfully been processed.

Parameters logger The logger to use for logging results.

def moveProcessedUpload(self, destination, logger):

Move or remove the upload depending on the status of the upload.

Parameters	destination	An `UploadStatusEnum` value.
	logger	The logger to use for logging results.

def moveUpload(self, subdir_name, logger):

Move the upload to the named subdir of the root, eg 'accepted'.

Parameters	subdir_name	Name of the subdirectory to move to.
	logger	The logger to use for logging results.

@staticmethod
def orderFilenames(fnames):

Order filenames, sorting *_source.changes before others.

Aside from that, a standard string sort.

l.a.u.UploadHandler : class documentation