/ 
Fuse-Template-0.0201
/ Fuse::Template

NAME

Fuse::Template - Mount a directory with templates.

VERSION

0.0201

USAGE

sudo might be optional.

MOUNT

Example SQLite:

$ sudo fuse-template
  --root /path/to/templates \
  --mountpoint /path/to/mountpoint \
  --schema dbi:SQLite:path/to/db \
  ;

Example MySQL:

$ sudo fuse-template
  --root /path/to/templates \
  --mountpoint /path/to/mountpoint \
  --schema "dbi:mysql:database=MyDB;host=127.1;port=3006 user pass" \
  ;

See DBI for possible --schema formats.

UNMOUNT

This needs to be done manually for now. (Patches are welcome!)

sudo umount /path/to/mountpoint;

DESCRIPTION

IMPORTANT! Version 0.02 of Fuse::Template breaks backward compat by using the new "v7" naming convention from DBIx::Class::Schema::Loader. Set the SCHEMA_LOADER_BACKCOMPAT environment variable, if you want the old behavior.

The idea with this project is to auto-maintain password files, and other plain text files for different systems, with data from a database.

See examples/ in this distribution for templates.

Example file system structure:

root/               -> mountpooit/
root/somefile       -> mountpoint/somefile
root/foo.tt         -> mountpoint/foo
root/bar/baz.txt.tt -> mountpoint/bar/baz.txt

somefile is accessible directly at mountpoint. Template files (.tt) are parsed and the output is accessible on mountpoint side. This is done using Template::Toolkit.

Files in mountpoint are read-only for now.

TEMPLATES

Here is an example template:

root = [% self.root %]
[% rs = schema.resultset('MyTable') %]
[% rs = MyTable; # same as schema.resultset(...) %]
[% WHILE (row = rs.next) # get next row in resultset %]
col_name = [% row.col_name # retrieve column data %]
[% END %]

See DBIx::Class for information on how to use the schema object, and DBIx::Class::Resultset on how to select data and more...

Available variables:

root
mountpoint
mountopts
self # this object
schema # DBIx::Class object
+ all resultsetset/tables

Resultset use this naming convention to convert tablenames:

Table Name  | Moniker Name
---------------------------
luser       | Luser
luser_group | LuserGroup
luser-opts  | LuserOpts

See "moniker_map" in DBIx::Class::Schema::Loader for details

INSTALLATION

On ubuntu:

$ sudo aptitude install libfuse-perl
$ wget -q http://xrl.us/cpanm | perl - --sudo Fuse::Template

See App::cpanminus if you are curious about the "wget" command.

ATTRIBUTES

root

$object = $self->root;

$object must be stringified to path where templates/files are located. $object must follow the same API as Fuse::Template::Root.

Can be set in constructor as:

root => \%constructor_args
root => $path_to_root

%constructor_args can override defaults, while $path_to_root will only override path attribute in root-object.

mountpoint

$path = $self->mountpoint;

Path to where the filesystem should be mounted.

mountopts

$str = $self->mountopts;

Example mount option: "allow_other"

schema

$dbic_object = $self->schema;

Can be set in constructor as:

schema => \%args
schema => "$dsn $username $password"

See Fuse::Template::Schema for details.

debug

$bool = $self->debug;

Enable/disable debug output from Fuse. Default is disabled.

METHODS

find_file

$real_path = $self->find_file($virtual_path);

Returns path to the file in root path.

log

$bool = $self->log($level => $format => @args);

AUTHOR

Jan Henning Thorsen

LICENSE

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