NAME
File::Information::Base - generic module for extrating information from filesystems
VERSION
version v0.02
SYNOPSIS
use File::Information;
This is the base package for File::Information::Link, File::Information::Inode, and File::Information::Filesystem. Common methods are documented in this file. Details (such as supported keys) are documented in the respective modules.
METHODS
get
my $value = $obj->get($key [, %opts]);
Get a value for a given key. The keys supported by this function depend on the module. Below you find a list with keys for aggregated values. Aggregated values are virtual and may be from different sources. If a key is not supported and no default
option is given, the method will die.
The following optional options are supported:
as
-
The type to get the value in. This is the name of a perl package or special value (in all lower case). The packages supported depend on the type of data to be returned. Currently the following special values are supported:
sid
,uuid
,oid
,uri
,ise
(one of UUID, OID, or URI),mediatype
,raw
(a raw value). The following packages are supported (they need to be installed): Data::Identifier, DateTime, Data::URIID::Result, IO::Handle, File::Information::Link. default
-
The value to be returned when no actual value could be read. This can also be
undef
which switches fromdie
-ing when no value is available to returningundef
. lifecycle
-
The lifecycle to get the value for. The default is
current
. See also "lifecycles" in File::Information.
The following keys for aggregated values are supported:
comment
-
A comment on the document (if any).
description
-
A description of the document (if any).
displayname
-
A string that is suitable for display and likely meaningful to users.
finalmode
-
The final mode of the document. Normally this is unset, auto-final (meaning the document should become final once successfully verifies it's final state), or final (it reached it's final state).
ise
-
The ISE of the document. That is it's UUID, OID, or URI.
mediatype
-
The media type of the document.
oid
-
The POD of the document.
readonly
-
If the file is ready only. This is different from immutable files in that they still can be deleted (or other file attributes be changed). Note: In the
final
lifecycle all files are read only. size
-
The file size (in bytes).
thumbnail
-
A file that can be used as a thumbnail for the document.
title
-
Title of the document (if any).
uri
-
The URI of the document. Note: This is not the URL one can use to fetch the document. This URI is the identifier of the document.
uuid
-
The UUID of the document.
writemode
-
The write mode for the document. Normally one of random access, append only, or none.
property_info
my $info = $obj->property_info($property);
# or:
my @info = $obj->property_info;
# or:
my @info = $obj->property_info($property [, ...] );
Returns information on one or more properties. If no property is given returns infos for all known ones.
Note: This object may not have values for all the listed properties. Likewise it is not guaranteed that two objects have the same list of properties.
The return value is a hashref or an array of hashrefs which contain the following keys:
name
-
The name of the digest in universal tag format (the format used in this module).
digest
my $digest = $obj->digest($algorithm [, %opts ]);
Returns a digest (hash). The supported algorithms and lifecycle values depend on object. If there is a any kind of problem this function dies.
Algorithm names are given in the universal tag form but aliases for names as by Digest are supported.
Common values include: md-5-128
, sha-1-160
, sha-2-256
, and sha-3-512
.
The following optional options are supported:
as
-
The type to get the value in. This is the name of a perl package or one of:
hex
(the default),binary
,base64
(orb64
),base64_padded
, orutag
. To get an object that is compatible with the Digest API useDigest
. Do not try to use specific types such asDigest::MD5
default
-
The value to be returned when no actual value could be read. This can also be
undef
which switches fromdie
-ing when no value is available to returningundef
. lifecycle
-
The lifecycle to get the value for. The default is
current
See also "lifecycles" in File::Information.
uuid, oid, uri, ise, displayname, displaycolour, icontext, description
my $uuid = $obj->uuid;
my $oid = $obj->oid;
my $uri = $obj->uri;
my $ise = $obj->ise;
my $displayname = $obj->displayname;
my $displaycolour = $obj->displaycolour;
my $icontext = $obj->icontext;
my $description = $obj->description;
These functions are for compatibility with Data::TagDB::Tag and Data::Identifier.
They perform the same as calling "get" with their name as key. For example:
my $displayname = $obj->displayname;
# same as:
my $displayname = $obj->get('displayname');
There availability depends on the type of object.
instance
my File::Information $instance = $obj->instance;
Returns the instance that was used to create this object.
extractor, db
my Data::URIID $extractor = $obj->extractor;
my Data::TagDB $db = $obj->db;
my ... = $obj->digest_info;
These methods provide access to the same data as the methods of File::Information. Arguments will be passed to said functions. However the object my cache the result. Therefore it is only allowed to pass arguments that are compatible with caching (if any exist).
See "extractor" in File::Information, and "db" in File::Information for details.
AUTHOR
Löwenfelsen UG (haftungsbeschränkt) <support@loewenfelsen.net>
COPYRIGHT AND LICENSE
This software is Copyright (c) 2024 by Löwenfelsen UG (haftungsbeschränkt) <support@loewenfelsen.net>.
This is free software, licensed under:
The Artistic License 2.0 (GPL Compatible)