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