view release on metacpan or  search on metacpan

lib/Carrot/Productivity/Text/Placeholder/Miniplate/OS/Unix/File/Name./documentation/Name-en.pod  view on Meta::CPAN

=pod

=head1 NAME

Carrot::Productivity::Text::Placeholder::Miniplate::OS::Unix::File::Name - access name parts of a file

=head1 SYNOPSIS

	$class_names->provide(
		my $template_class = '::Productivity::Text::Placeholder::Template');

	my $template = $template_class->constructor(
		my $os_unix_file = '::OS::Unix::File::Name');
	$template->compile('File base name: [=file_name_only=]');

	$os_unix_file->set_subject('/tmp/test.dat');
	print ${$template->execute()}, "<-\n";

=head1 DESCRIPTION

Provides the placeholders file_name_(full|path|only|extension). The file doesn't needs to exists.

=head1 METHOD REFERENCE (API)

=over 8

=item subject($file_name)

Sets or gets the file name.

=item add_placeholder($template, $code_ref)

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

=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