NAME

Rex::Apache::Build - Build your WebApp Package

DESCRIPTION

With this module you can prepare your WebApp for deployment.

SYNOPSIS

 yui_path "./yuicompressor-2.4.6.jar";

 get_version_from "webapp/lib/MyApp.pm", qr{\$VERSION=([^;]+);};

 get_version_from "webapp/index.php", qr{\$VERSION=([^;]+);};

 task "build", sub {
   sprocketize;
   sprocketize "app/assets/javascript/*.js",
    out => "public/js/sprockets.js";

   coffee;
   coffee "app/assets/coffee",
    out => "public/js";

   sass;
   sass "app/assets/stylesheets",
    out => "public/stylesheets";

   yui;
   yui compress => "file1.js", "file2.js", "file3.css";
   yui compress => glob("public/javascript/*.js"), glob("public/css/*.css");

   build;

   build "webapp",
    source  => "webapp/",
    version => "1.0";
 };

EXPORTED FUNCTIONS

yui_path($path_to_yui_compressor)

This function sets the path to the yui_compressor. If a relative path is given it will search from the path where the Rexfile is in.

coffee_path($path_to_coffee)

This function sets the path to the coffee compiler. If a relative path is given it will search from the path where the Rexfile is in.

sprocketize_path($path_to_sprocketize)

This function sets the path to the sprocketize compiler. If a relative path is given it will search from the path where the Rexfile is in.

sass_path($path_to_sass)

This function sets the path to the sass compiler. If a relative path is given it will search from the path where the Rexfile is in.

yui($action, @files)

Run a yui command.

 task "build", sub {
   # this will compress the given files
   yui compress => "file1.js", "file2.js", ...;

   # yui without any parameters will compress all files in public/javascripts
   yui;
 };

build([$name, %options])

This function builds your package. Currently only tar.gz packages are supported.

 # this will a package of the current directory named after the
 # directory of the Rexfile and append the version provided by
 # get_version_from() function
 # This function builds a tar.gz archive.
 task "build", sub {
   build;
 };

 # this will build a package of the current directory named "my-web-app" and
 # append the version provided by get_version_from() function.
 task "build", sub {
   build "my-web-app";
 };

 # this function will build a package of the directory "html", name it
 # "my-web-app" and append the version "1.0" to it.
 task "build", sub {
   build "my-web-app",
     path => "html",
     version => "1.0",
     exclude => ["yuicompressor.jar", "foobar.html"],
     type => "tgz";
 };

get_version_from($file, $regexp)

Get the version out of a file.

sprocketize($path_to_js_files, %option)

This function calls the sprocketize command with the given options.

 task "build", sub {
   sprocketize "app/javascript/*.js",
            include   => [qw|app/javascripts vendor/sprockets/prototype/src|],
            asset_root => "public/js",
            out      => "public/js/sprockets.js";

   # to include more use an arrayRef
   sprocketize ["app/javascript/*.js", "app/javascript/po/*.js"],
            include   => [qw|app/javascripts vendor/sprockets/prototype/src|],
            asset_root => "public/js",
            out      => "public/js/sprockets.js";

   # if called without parameters

   sprocketize;

   # it will use the following defaults:
   # - javascript (sprockets) in assets/javascripts/*.js
   # - include  assets/javascripts
   # - asset_root public
   # - out public/${name_of_directory_where_Rexfile_lives}.js
 };

coffee($path, %options)

Compile coffee files to javascript.

 task "build", sub {
   # this command will build all files in "coffeesrc" and
   # write the output to "javascripts"
   coffee "coffeesrc",
      out  => "javascripts";

   # without parameters it will build all files in assets/coffee
   # and write the output to public/javascripts.
   coffee;
 };

sass($input_dir, %option)

This command will compile all sass files in $input_dir.

 task "build", sub {
   # this command will compile all sass files from app/assets/stylesheets
   # and put the output into public/stylesheets.
   sass "app/assets/stylesheets",
    out => "public/stylesheets";

   # The default is to build all files in assets/sass and put the output
   # into public/css.
   sass;
 };