bionic (3) Mojolicious::Plugin::AssetPack::Guides::Developing.3pm.gz

NAME

       Mojolicious::Plugin::AssetPack::Guides::Developing - Developing with AssetPack

OVERVIEW

       This guide will provide a setup for effective development with Mojolicious::Plugin::AssetPack.

GUIDE

   Environment variables
       It is possible to set environment variables to change the behavior of AssetPack:

       • MOJO_ASSETPACK_DEBUG

         Set this environment variable to get more debug to STDERR. Currently you can set it to a value between
         0 and 3, where 3 provides the most debug.

       • MOJO_ASSETPACK_LAZY

         Set this environment variable if you want to delay processing the assets until they are requested. This
         can be very useful while developing when the assets are changed frequently.

   Faster development cycle
       For a faster development cycle, you can use MOJO_ASSETPACK_LAZY. This environment variable will make
       AssetPack only rebuild the asset that is in use on the current web page.

         $ MOJO_ASSETPACK_LAZY=1 morbo myapp.pl

   Enforcing production assets
       To be sure that production assets are built correctly, you can add a unit test like the one below. This
       is especially important if you are using "MOJO_ASSETPACK_LAZY".

         use Test::Mojo;
         use Test::More;

         $ENV{MOJO_MODE} = "production";
         my $t = Test::Mojo->new("MyApp");

         $t->get_ok("/")
           ->element_exists(q(head link[href$="/app.css"]))
           ->element_exists(q(body script[src$="/app.js"]));

         done_testing;

       The "element_exists()" tests should match the topics defined when defining the different assets.

Optional modules

       There are some optional modules you might want to install:

       • CSS::Minifier::XS

         Used by Mojolicious::Plugin::AssetPack::Pipe::Css.

       • CSS::Sass

         Used by Mojolicious::Plugin::AssetPack::Pipe::Sass.

       • IO::Socket::SSL

         Required if you want to download assets served over SSL.

       • JavaScript::Minifier::XS

         Used by Mojolicious::Plugin::AssetPack::Pipe::JavaScript.

SEE ALSO

       Mojolicious::Plugin::AssetPack, Mojolicious::Plugin::AssetPack::Guides::Cookbook and
       Mojolicious::Plugin::AssetPack::Guides::Tutorial.

perl v5.26.1                                       2018-0Mojolicious::Plugin::AssetPack::Guides::Developing(3pm)