NAME
   Directory::Deploy - Create files and directories on disk

VERSION
   Version 0.003

SYNOPSIS
       package My::Assets;

       use Directory::Deploy::Declare;

       include <<'_END_';
       # A line beginning with '#' is ignored
       run/
       # A path with a trailing slash is a directory (otherwise a file)
       run/root/
       run/tmp/:700
       # A :\d+ after a path is the mode (permissions) for the file/dir
       assets/
       assets/root/
       assets/root/static/
       assets/root/static/css/
       assets/root/static/js/
       assets/tt/
       _END_

           include
               'assets/tt/frame.tt.html' => \<<'_END_',
       <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
       <html xmlns="http://www.w3.org/1999/xhtml">
       <head>
       <title>[% title %]</title>
       <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
       </head>
       <body>
       <div id="doc2">

           [% content %]

           <div class="footer"> ... </div>

       </div>
       </body>
       </html>
       _END_

               'assets/root/static/css/base.css' => \<<'_END_',
       body, table {
           font-family: Verdana, Arial, sans-serif;
           background-color: #fff;
       }

       a, a:hover, a:active, a:visited {
           text-decoration: none;
           font-weight: bold;
           color: #436b95;
       }
       _END_
       ; # End of the include

       no Directory::Deploy::Declare;

       # ... elsewhere ...

       My::Assets->deploy( { base => $dir } )

       # ... or ...

       my $assets = My::Assets->new( base => $dir )
       $assets->deploy

DESCRIPTION
   Directory::Deploy is a tool for creating files and directories (on disk)

   The usage is pretty much as the SYNOPSIS says. Caveat emptor: the
   interface is Beta(tm) and *might* change

AUTHOR
   Robert Krimen, "<rkrimen at cpan.org>"

BUGS
   Please report any bugs or feature requests to "bug-directory-deploy at
   rt.cpan.org", or through the web interface at
   <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Directory-Deploy>. I
   will be notified, and then you'll automatically be notified of progress
   on your bug as I make changes.

SUPPORT
   You can find documentation for this module with the perldoc command.

       perldoc Directory::Deploy

   You can also look for information at:

   *   RT: CPAN's request tracker

       <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Directory-Deploy>

   *   AnnoCPAN: Annotated CPAN documentation

       <http://annocpan.org/dist/Directory-Deploy>

   *   CPAN Ratings

       <http://cpanratings.perl.org/d/Directory-Deploy>

   *   Search CPAN

       <http://search.cpan.org/dist/Directory-Deploy/>

ACKNOWLEDGEMENTS
COPYRIGHT & LICENSE
   Copyright 2009 Robert Krimen, all rights reserved.

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