File::Attributes - Manipulate file metadata
Version 0.04
use File::Attributes qw(set_attribute list_attributes get_all_attributes); my $file = 'foo.txt'; set_attribute($file, type => 'text/plain'); set_attribute($file, encoding => 'utf8'); my @attributes = list_attributes($file); # @attributes = qw(type encoding) %attributes = get_attributes($file); # $attributes{type} will be 'text/plain' # $attributes{foo} will be undefined.
File::Attributes is a wrapper around modules in the File::Attributes hierarchy. If you use this module directly (instead of one of the aforementioned decendants), then your attribute manipulations will Just Work, regardless of the underlying filesystem.
File::Attributes
Module::Pluggable is used to find all File::Attributes:: modules that inherit from File::Attributes::Base and that are applicable on your system. If it finds one, it uses that. If not, it uses File::Attributes::Simple, which is bundled with this module and works everywhere.
File::Attributes::
File::Attributes::Base
File::Attributes::Simple
As of version 0.04, plugins are now set up per-file, not per-system. This means that if you have File::Attributes::Extended installed, extended attributes will be used where available, but Simple attributes will be used on files where extended attributes don't work (a FAT filesytem on a Linux machine, for example). Existing simple attributes will be read even if extended attributes are available, but writes will affect only the extended attributes.
File::Attributes::Extended
This means that you can switch to a better attribute plugin at any time, without losing any old data!
None, by default. Specify the functions that you'd like to use as arguments to the module. If you want everything, specify :all.
:all
All functions throw an exception on error.
Returns the value of attribute $attribute on file $file. If $attribute doesn't exist, returns undefined.
$attribute
$file
Sets attribute $<attribute> on file $file to $value.
$value
Returns a hash of all attributes on $file.
Sets the attributes named by the keys of %hash to the value contained in %hash. Note that this operation is not atomic -- if setting an individual attribute fails, the attributes on $file may not be the same as before set_attributes was called!
%hash
set_attributes
Removes the attribute $attribute from $file.
Removes each attribute ($attribute0, $attribute1, ...) from $file.
$attribute0
$attribute1
...
Returns a list of the attributes on $file. Equivalent to (but faster than) keys get_attributes($file).
keys get_attributes($file)
Jonathan Rockway, <jrockway at cpan.org>
<jrockway at cpan.org>
Please report any bugs or feature requests to RT at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=File-Attributes.
Copyright 2006 Jonathan Rockway, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install File::Attributes, copy and paste the appropriate command in to your terminal.
cpanm
cpanm File::Attributes
CPAN shell
perl -MCPAN -e shell install File::Attributes
For more information on module installation, please visit the detailed CPAN module installation guide.