NAME

Text::Placeholder::Group::OS::Unix::File::Properties - access properties of a file

SYNOPSIS

        use Text::Placeholder;
        my $placeholder = Text::Placeholder->new(
                my $os_unix_file = '::OS::Unix::File::Properties');
        $placeholder->compile('[=file_timestamp_modification=] / [=file_owner_name=] / [=file_mode_rwx=]');

        $os_unix_file->subject('/etc/hosts');
        print ${$placeholder->execute()}, "<-\n";

DESCRIPTION

Provides the placeholders file_(owner_id|owner_name|group_id|group_name|size|timestamp_creation|timestamp_modification|timestamp_status). The file must exists. Can be used on the same name together with ::OS::Unix::File::Name via ::Aggregator.

METHOD REFERENCE (API)

subject($file_name)

Sets or gets the file name.

add_placeholder($placeholder, $code_ref)

Adds the $code_ref under the name of $placeholder. $code_ref is executed and returns the current value to be substituted for $placeholder.

KNOWN BUGS AND LIMITATIONS

This is the first public release.

AUTHOR

Winfried Trumper <pub+perl(a)wt.tuxomania.net>

COPYRIGHT AND LICENSE

Copyright (C) 2011 Winfried Trumper

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.