File Coverage

blib/lib/Mojolicious/Plugin/Riotjs.pm

Criterion	Covered	Total	%
statement	17	17	100.0
branch	2	4	50.0
condition	2	5	40.0
subroutine	4	4	100.0
pod	2	2	100.0
total	27	32	84.3

package Mojolicious::Plugin::Riotjs;

=head1 NAME

Mojolicious::Plugin::Riotjs - A Mojolicious  plugin for including riot.js .tag files in your project

=head1 VERSION

0.04

=head1 DESCRIPTION

L is a L plugin for including
L C<.tag> files in your project. It also
makes it very easy to bundle the latest L.

=head2 What is riotjs?

From the L:

  A REACT-LIKE, 2.5KB USER INTERFACE LIBRARY
  Custom tags - Virtual DOM - Full stack - IE8

=head2 Dependencies

Riot is required for this module to work. You can install Riot with
L:

  $ sudo apt-get install npm
  $ npm install riot

=head1 SYNOPSIS

  use Mojolicious::Lite;

  get "/" => "index";
  app->plugin("riotjs");
  app->asset(
    "app.js" => qw(
      http://cdnjs.cloudflare.com/ajax/libs/riot/2.0.13/riot.js
      /js/todo.tag
      /js/main.js
    )
  );
  app->start;

  __DATA__
  @@ /js/todo.tag

    { opts.title }

      { item.title }



      Add #{ items.length + 1 }


    this.items = []

    add(e) {
      var input = e.target[0]
      if (input.value.length) this.items.push({ title: input.value })
      input.value = ''
    }


  @@ /js/main.js
  riot.mount('todo')

  @@ index.html.ep



      Riot.js Demo




      %= asset "app.js"



=cut

use Mojo::Base 'Mojolicious::Plugin';
use Cwd ();

our $VERSION = '0.04';

$ENV{NODE_PATH} ||= '';

=head1 METHODS

=head2 node_paths

  @paths = $self->node_paths($app);

Returns the path to available "node_modules". This is used by L to
set the C environment variable.

The default is to look for "node_modules" in current directy and relative to
L. It will also use the current value of
C if already set.

=cut

sub node_paths {
  my ($self, $app) = @_;
  my %PATH;

  grep { $_ and -d and !$PATH{$_}++ } split(/:/, $ENV{NODE_PATH}), eval { Cwd::abs_path('node_modules') },
    $app->home->rel_dir('node_modules');
}

=head2 register

Will register the L with the
".tag" file extension.

=cut

sub register {
  my ($self, $app, $config) = @_;

  $config->{ext} ||= 'tag';
  $ENV{NODE_PATH} = join ':', $self->node_paths($app);
  $app->plugin('AssetPack') unless eval { $app->asset };
  $app->asset->preprocessors->add($config->{ext} => 'Mojolicious::Plugin::Riotjs::Preprocessor' => $config);
}

=head1 COPYRIGHT AND LICENSE

Copyright (C) 2014, Jan Henning Thorsen

This program is free software, you can redistribute it and/or modify it under
the terms of the Artistic License version 2.0.

=head1 AUTHOR

Jan Henning Thorsen - C

=cut

1;