Text::Printf version 0.06
=========================

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(<<END_TEMPLATE);
    Dear {{to}},
        Have a {{day_type}} day.
    Your {{relation}},
    {{from}}
    END_TEMPLATE

    $letter1 = $template->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 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.
