Jody Clements > Catalyst-Plugin-Compress-WithExclusions-0.02 > Catalyst::Plugin::Compress::WithExclusions



Annotate this POD

View/Report Bugs
Module Version: 0.02   Source  


Catalyst::Plugin::Compress::WithExclusions - Compresses all responses from the server, except excluded paths


Version 0.02


    use Catalyst qw/Compress::WithExclusions/;

Then specifiy the excluded paths as an array ref of regular expressions and the compression format that you want to use.

      compression_excluded => ['path_regex', ],
      compression_format => $format

Accepted formats for $format are the same as defined in Catalyst::Plugin::Compress


It is always a good idea to compress the results that are returned from your web application, if the client can handle it. Catalyst::Plugin::Compress does that for you with very little effort. However, there are times when you might not want the reponse to be compressed. For example when a returning a file that has already been zipped. The extra compression is unlikely to reduce the file size and will just add extra load to the server. This module builds upon the Catalyst::Plugin::Compress module and adds the option to skip the compression step for certain url paths. So, for example, if you dont want to compress any files in the download path, then you would add the following to your config:

      compression_excluded => ['^download', ],

Now all urls on the site that start with download will be uncompressed and everything else will be compressed as requested.



This is an internal method. It checks to see if any exclusions have been added in the configuration file.


This is an internal method that first checks to see if the path should be excluded from compression and then passes on to the parent for further checks.


Jody Clements, <clementsj at>


Please report any bugs or feature requests to bug-catalyst-plugin-compress-hmmer at, or through the web interface at I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.


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

    perldoc Catalyst::Plugin::Compress::WithExclusions

You can also look for information at:



Copyright 2012 Jody Clements.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See for more information.

syntax highlighting: