Plain Files Access
This module subclasses the Files module for plain files repository, i.e. real files stored in real directories.
See Files POD for method information.
Methods are sorted in the same order as in the super-class.
realfilename ($pathname, $releaseid)realfilename returns the true original name of the file.
$pathname
a string containing the path relative to 'sourceroot'
$releaseid
the release (or version) in which $pathname is expected to be found
There is a substantial performance advantage in avoiding file copy into a temporary. But this is the real file. Be careful enough not to make destructive operations on it!
Note:
If "standard" file copy is desired, comment out the method AND releaserealfilename.
releaserealfilename ($filename)releaserealfilename protects againt file erasure.
$filename
a string containing the filename
This is the companion "destructor" of realfilename. Since no file was created, just return for a no-op.
This overrides the default erasure action of the super-class.
toreal ($pathname, $releaseid)toreal translate the pair $pathname/$releaseid into a real full OS-absolute path.
$pathname
a string containing the path relative to 'sourceroot'
$releaseid
the release (or version) in which $pathname is expected to be found
If $pathname is located in some directory to ignore, the result is undef. Otherwise, the result is the full OS path in the correct 'version' directory.
Note:
This function should not be used outside this module.