Text::Printf version 0.07 ========================= This module provides a simple, lightweight templating mechanism. This is in contrast to most (or all?) other CPAN templating modules, which try to be as full-featured as possible. Text::Printf does not require you to buy into any complex syntax, or filesystem layout, or anything like that. Text::Printf can be used in two ways. The simpler way is via tsprintf, a templated version of sprintf: $str = tsprintf '2 {{fruit}} + 3 {{fruit}} = 5 {{fruit}}', {fruit => 'apples'}; The other way is to create a Text::Printf object with a string of boilerplate text. Then later, you pass the object a hash of substitution keywords and values, and it returns the filled-in result string. EXAMPLES $template = Text::Printf->new(<fill ( {to => 'Professor Dumbledore', relation => 'friend', day_type => 'swell', from => 'Harry', }); $letter2 = $template->fill ( {to => 'Lord Voldemort', relation => 'sworn enemy', day_type => 'rotten', from => 'Harry', }); That's it. No control flow, no executable content, no filesystem access. Never had it, never will. DEVELOPMENT STATE This is a brand-new module, so be wary. It has a decent test suite, but it hasn't been extensively field-tested. It should be considered "beta" software. If you find any bugs, or if any behavior of Text::Printf surprises you, I would be grateful if you could send me an email message about it. Thanks. INSTALLATION To install this module, do the standard Perl module four-step: perl Build.PL or perl Build.PL --install_path lib=... ./Build ./Build test ./Build install or ./Build install --options The old-fashioned Makefile.PL way works, too: perl Makefile.PL or perl Makefile.PL LIB='my/install/path' make make test make install DEPENDENCIES This module requires these other modules and libraries: Readonly Exception::Class Test::More (used by the test suite only) COPYRIGHT AND LICENSE Eric J. Roode, roode@cpan.org Copyright (c) 2005 by Eric J. Roode. All Rights Reserved. This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. To avoid my spam filter, please include "Perl", "module", or this module's name in the message's subject line, and/or GPG-sign your message.