NAME

Path::Maker - make files and directories as scaffolding

SYNOPSIS

use Path::Maker;

my $maker = Path::Maker->new(base_dir => $ENV{HOME});
$maker->render_to_file('gitconfig.mt' => '.gitconfig', $ENV{USER});
$maker->create_dir('.swap');
$maker->write_file('.vimrc', "set directory=~/.swap\n");
$maker->chmod('.ssh/id_rsa', 0400);

__DATA__

@@ gitconfig.mt
[user]
    name = <?= $_[0] ?>

DESCRIPTION

Path::Maker helps you make files or directories as scaffolding. When I wrote a CLI script for mojo, I found that Mojolicious::Command is very useful. This module provides some functionality of that module with template syntax Text::MicroTemplate.

CONSTRUCTOR

Constructor $maker = Path::Maker->new(%options) accepts following options:

  • base_dir

    If relative path is specified to methods chmod, create_dir, render_to_file or write_file, then it is assumed to relative to the base_dir. Default: current working directory.

  • package

    Whose __DATA__ section to be read. Default: caller.

  • template_header

    If template_header is provided, it is inserted to every template files. See eg/template-header.pl for example.

  • template_dir

    By default, Path::Maker searches for template files in __DATA__ section. If template_dir is provided, it also searches for template files in template_dir. See eg/module-scaffold.pl for example.

METHOD

  • $maker->chmod($path, $mode)

    Change permission of $path.

  • $maker->create_dir($dir)

    Create directory $dir.

  • $string = $maker->render($template_name, @arg)

    Render $template_name with @arg.

  • $maker->render_to_file($template_name, $file, @arg)

    Render $template_name to $file with @arg.

  • $maker->write_file($file, $string)

    Write $string to $file.

SEE ALSO

Mojolicious::Command

Text::MicroTemplate

Text::MicroTemplate::DataSection

LICENSE

Copyright (C) Shoichi Kaji.

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

AUTHOR

Shoichi Kaji skaji@cpan.org