PkgForge::Queue::Entry - Represents an entry in a build queue for the LCFG Package Forge
This documentation refers to PkgForge::Queue::Entry version 1.1.10
use PkgForge::Queue::Entry; use PkgForge::Job; my $qentry = PkgForge::Queue::Entry->new($dir); print "Queue entry: " . $qentry->id . " submitted at: " . $qentry->pretty_timestamp . "\n"; my $job = PkgForge::Job->new_from_qentry($qentry);
In the LCFG Package Forge a build queue is represented by a directory. The jobs in a queue are each represented by separate sub-directories within that build queue directory.
This module is used as a lightweight representation of an entry within a queue. It is basically a means of querying useful meta-data associated with a physical directory.
These attributes are all only settable when the Queue::Entry object is created. After that point they are all read-only.
This is the path to a directory which represents an entry in a build queue. It must exist.
This is the identifier for the build queue entry, it is the name of the specific sub-directory within the queue directory, (i.e. the final, deepest level of the directory tree only).
This is the UID of the owner of the queue entry directory.
This is the ctime of the queue entry directory.
Takes the path to the individual directory which represents a job in the build queue and returns a Queue::Entry object.
This takes a timeout, in seconds, and returns a boolean value which signifies whether or not the build queue entry is more than that many seconds old.
This method will erase the directory associated with this build queue entry. Note that it also blows away the object since it no longer has any physical meaning once the directory is gone. Internally this uses the
remove_tree subroutine provided by PkgForge::Utils. It is possible, optionally, to pass in a reference to a hash of options to control how the
remove_tree subroutine functions.
This method returns a nicely formatted string form of the
timestamp attribute. This uses the
localtime function and is provided mainly for prettier logging.
This is the list of platforms on which we have tested this software. We expect this software to work on any Unix-like platform which is supported by Perl.
Please report any bugs or problems (or praise!) to firstname.lastname@example.org, feedback and patches are also always very welcome.
Stephen Quinney <email@example.com>
Copyright (C) 201O University of Edinburgh. All rights reserved.
This library is free software; you can redistribute it and/or modify it under the terms of the GPL, version 2 or later.