Scott T. Hardin > Connector > Connector::Builtin::File::Path

Download:
Connector-1.12.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
View/Report Bugs
Source  

Name ^

Connector::Builtin::File::Path

Description ^

Highly configurable file writter/reader.

Parameters ^

LOCATION

The base directory where the files are located. This parameter is mandatory.

file

Pattern for Template Toolkit to build the filename. The path components are available in the key ARGS. In set mode the unfiltered data is available in key DATA.

content

Pattern for Template Toolkit to build the content. The data is passed "as is". If data is a scalar, it is wrapped into a hash using DATA as key.

ifexists
  • append: opens the file for appending write.
  • fail: call die
  • silent: fail silently.
  • replace: replace the file with the new content.

Supported Methods ^

set

Write data to a file.

    $conn->set('filename', { NAME => 'Oliver', 'ROLE' => 'Administrator' });

See the file parameter how to control the filename. By default, files are silently overwritten if they exist. See the ifexists parameter for an alternative behaviour.

get

Fetch data from a file. See the file parameter how to control the filename.

    my $data = $conn->set('filename');

Example ^

    my $conn = Connector::Builtin::File::Path->new({
       LOCATION: /var/data/
       file: [% ARGS.0 %].txt
       content: Hello [% NAME %]
    });

    $conn->set('test', { NAME => 'Oliver' });

Results in a file /var/data/test.txt with the content Hello Oliver.

syntax highlighting: