=pod

=head1 NAME

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

=head1 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";

=head1 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.

=head1 METHOD REFERENCE (API)

=over 8

=item subject($file_name)

Sets or gets the file name.

=back

=head1 KNOWN BUGS AND LIMITATIONS

This is the first public release.

=head1 AUTHOR

Winfried Trumper E<lt>pub+perl(a)wt.tuxomania.netE<gt>

=head1 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.

=cut
