__ ____ ____ __ \ \ / /\ \ / /\ \ / / _ _ \ \ /\ / / \ \ /\ / / \ \ /\ / / (_|_) \ V V / \ V V / \ V V / _ _ \_/\_/ \_/\_/ \_/\_/ (_|_) ____ _ _ ____ _ / ___| |__ ___ ___| | __/ ___|___(_)_ __ | | | '_ \ / _ \/ __| |/ / | _|_ / | '_ \ | |___| | | | __/ (__| <| |_| |/ /| | |_) | \____|_| |_|\___|\___|_|\_\\____/___|_| .__/ |_| This is the README for WWW::CheckGzip version 0.05. WWW::CheckGzip is a "module" for the Perl computer programming language, a library of computer code to install on a computer. This document contains four sections: 1. About - what the module does 2. Documentation - how to learn more about the module 3. Installation - how to install this module on a computer 4. Help - what to do if you get stuck ----------------------------------------------------------------------------- 1. ABOUT WWW::CheckGzip - check web pages for correct gzipping of content This module offers a way to check a web page for correct gzip compression. It tests the following, in the order given: Page OK with compression The web page is retrievable with an Accept-Encoding header set. If the page is not retrievable, "check" calls the test callback, then returns and does no further actions. Header OK When sent a request with an Accept-Encoding header containing the string "gzip", the web page responds with a content encoding header. Header is gzip The content encoding header of the response is "gzip". Content is in gzip format The content of the web page's response is in the gzip format. This is checked using "Gzip::Faster/gunzip". Content is smaller The size of the uncompressed content of the web page is larger than it is when compressed. This test will fail, for example, if gzip encoding is wrongly used to compress images or extremely small web pages. Page OK without compression The web page is retrievable without an Accept-Encoding header set. Response has no gzip header The web page does not send a gzip header if the Accept-Encoding header is not set. Content is not compressed The web page does not gzip compress the content when Accept-Encoding header is not sent. This is checked using "Gzip::Faster/gunzip". ----------------------------------------------------------------------------- 2. DOCUMENTATION You can read the documentation for the module online at the following websites: * http://search.cpan.org/perldoc?WWW::CheckGzip * http://metacpan.org/release/WWW-CheckGzip (These links go to the latest version of the module.) After installing the module, you can read the documentation on your computer using perldoc WWW::CheckGzip ----------------------------------------------------------------------------- 3. INSTALLATION This module requires Perl version 5.6.1 or later. To install the module from CPAN, use cpan WWW::CheckGzip If you have the App::cpanminus installer, you may prefer cpanm WWW::CheckGzip To install the module from the source file, WWW-CheckGzip-0.05.tar.gz, follow this sequence of commands: tar xfz WWW-CheckGzip-0.05.tar.gz cd WWW-CheckGzip-0.05 perl Makefile.PL make make install If you want to test the module before installing it, use "make test" after "make" and before "make install". ----------------------------------------------------------------------------- 4. HELP To get help with the module, you can email the author, Ben Bullock, at . If you think there is a problem in the module, you can report a bug at , or if you want to alter the source code of WWW::CheckGzip, try the public repository on github at . ----------------------------------------------------------------------------- This README was written on Wed Oct 4 11:01:41 2017. -----------------------------------------------------------------------------