javascript::minifier(3pm) [debian man page]

JavaScript::Minifier(3pm)				User Contributed Perl Documentation				 JavaScript::Minifier(3pm)

NAME

       JavaScript::Minifier - Perl extension for minifying JavaScript code

SYNOPSIS

       To minify a JavaScript file and have the output written directly to another file

	 use JavaScript::Minifier qw(minify);
	 open(INFILE, 'myScript.js') or die;
	 open(OUTFILE, '>myScript-min.js') or die;
	 minify(input => *INFILE, outfile => *OUTFILE);
	 close(INFILE);
	 close(OUTFILE);

       To minify a JavaScript string literal. Note that by omitting the outfile parameter a the minified code is returned as a string.

	 my minifiedJavaScript = minify(input => 'var x = 2;');

       To include a copyright comment at the top of the minified code.

	 minify(input => 'var x = 2;', copyright => 'BSD License');

       To treat ';;;' as '//' so that debugging code can be removed. This is a common JavaScript convention for minification.

	 minify(input => 'var x = 2;', stripDebug => 1);

       The "input" parameter is manditory. The "output", "copyright", and "stripDebug" parameters are optional and can be used in any combination.

DESCRIPTION

       This module removes unnecessary whitespace from JavaScript code. The primary requirement developing this module is to not break working
       code: if working JavaScript is in input then working JavaScript is output. It is ok if the input has missing semi-colons, snips like '++ +'
       or '12 .toString()', for example. Internet Explorer conditional comments are copied to the output but the code inside these comments will
       not be minified.

       The ECMAScript specifications allow for many different whitespace characters: space, horizontal tab, vertical tab, new line, carriage
       return, form feed, and paragraph separator. This module understands all of these as whitespace except for vertical tab and paragraph
       separator. These two types of whitespace are not minimized.

       For static JavaScript files, it is recommended that you minify during the build stage of web deployment. If you minify on-the-fly then it
       might be a good idea to cache the minified file. Minifying static files on-the-fly repeatedly is wasteful.

   EXPORT
       None by default.

       Exportable on demand: minifiy()

SEE ALSO

       This project is developed using an SVN repository. To check out the repository svn co http://dev.michaux.ca/svn/random/JavaScript-Minifier

       This module is inspired by Douglas Crockford's JSMin: http://www.crockford.com/javascript/jsmin.html

       You may also be interested in the CSS::Minifier module also available on CPAN.

AUTHORS

       Peter Michaux, <petermichaux@gmail.com> Eric Herrera, <herrera@10east.com>

COPYRIGHT AND LICENSE

       Copyright (C) 2007 by Peter Michaux

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or,
       at your option, any later version of Perl 5 you may have available.

perl v5.10.1							    2010-12-19						 JavaScript::Minifier(3pm)

JavaScript::Packer(3pm) 				User Contributed Perl Documentation				   JavaScript::Packer(3pm)

NAME

       JavaScript::Packer - Perl version of Dean Edwards' Packer.js

VERSION

       Version 1.006003

DESCRIPTION

       A JavaScript Compressor

       This module is an adaptation of Dean Edwards' Packer.js.

       Additional information: http://dean.edwards.name/packer/

SYNOPSIS

	   use JavaScript::Packer;

	   my $packer = JavaScript::Packer->init();

	   $packer->minify( $javascript, $opts );

       To return a scalar without changing the input simply use (e.g. example 2):

	   my $ret = $packer->minify( $javascript, $opts );

       For backward compatibility it is still possible to call 'minify' as a function:

	   JavaScript::Packer::minify( $javascript, $opts );

       The first argument must be a scalarref of javascript-code.

       Second argument must be a hashref of options. Possible options are:

       compress
	   Defines compression level. Possible values are 'clean', 'shrink', 'obfuscate' and 'best'.  Default value is 'clean'.  'best' uses
	   'shrink' or 'obfuscate' depending on which result is shorter. This is recommended because especially when compressing short scripts the
	   result will exceed the input if compression level is 'obfuscate'.

       copyright
	   You can add a copyright notice at the top of the script.

       remove_copyright
	   If there is a copyright notice in a comment it will only be removed if this option is set to a true value. Otherwise the first comment
	   that contains the word "copyright" will be added at the top of the packed script. A copyright comment will be overwritten by a
	   copyright notice defined with the copyright option.

       no_compress_comment
	   If not set to a true value it is allowed to set a JavaScript comment that prevents the input being packed or defines a compression
	   level.

	       /* JavaScript::Packer _no_compress_ */
	       /* JavaScript::Packer shrink */

EXAMPLES

       Example 1
	   Common usage.

	       #!/usr/bin/perl

	       use strict;
	       use warnings;

	       use JavaScript::Packer;

	       my $packer = JavaScript::Packer->init();

	       open( UNCOMPRESSED, 'uncompressed.js' );
	       open( COMPRESSED, '>compressed.js' );

	       my $js = join( '', <UNCOMPRESSED> );

	       $packer->minify( $js, { compress => 'best' } );

	       print COMPRESSED $js;
	       close(UNCOMPRESSED);
	       close(COMPRESSED);

       Example 2
	   A scalar is requested by the context. The input will remain unchanged.

	       #!/usr/bin/perl

	       use strict;
	       use warnings;

	       use JavaScript::Packer;

	       my $packer = JavaScript::Packer->init();

	       open( UNCOMPRESSED, 'uncompressed.js' );
	       open( COMPRESSED, '>compressed.js' );

	       my $uncompressed = join( '', <UNCOMPRESSED> );

	       my $compressed = $packer->minify( $uncompressed, { compress => 'best' } );

	       print COMPRESSED $compressed;
	       close(UNCOMPRESSED);
	       close(COMPRESSED);

AUTHOR

       Merten Falk, "<nevesenin at cpan.org>"

BUGS

       Please report any bugs or feature requests through the web interface at http://github.com/nevesenin/javascript-packer-perl/issues
       <http://github.com/nevesenin/javascript-packer-perl/issues>.

SUPPORT

       You can find documentation for this module with the perldoc command.

       perldoc JavaScript::Packer

COPYRIGHT &; LICENSE
       Copyright 2008 - 2012 Merten Falk, all rights reserved.

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

perl v5.14.2							    2012-03-02						   JavaScript::Packer(3pm)