/ 
Gzip-Libdeflate-0.02
River stage one • 1 direct dependent • 1 total dependent
/ Gzip::Libdeflate

NAME

Gzip::Libdeflate - Libdeflate compression library

SYNOPSIS

use Gzip::Libdeflate;
my $gl = Gzip::Libdeflate->new (level => 12);
my $out = $gl->compress ("ABCDEFG" x 2);
print length ($out), "\n";
my $rt = $gl->decompress ($out);
print "$rt\n";

produces output

29
ABCDEFGABCDEFG

(This example is included as synopsis.pl in the distribution.)

VERSION

This documents version 0.02 of Gzip-Libdeflate corresponding to git commit 009e90b2d795e8a4412e4590c482d1ce8b50d30c released on Sun Feb 21 09:08:43 2021 +0900. This distribution also includes libdeflate version 1.7.

DESCRIPTION

This module provides an interface to libdeflate. Libdeflate is a newly-written compression library which offers the same deflate form of compression as zlib, as used in gzip, libpng and many similar utilities. This distribution includes libdeflate within itself, so it is not necessary to have that on your system.

METHODS

compress

my $comp_thing = $gl->compress ($thing);

Compress input $thing using whatever compression level and type you have specified for $gl in "new".

decompress

my $thing = $gl->decompress ($dthing);

Decompress $comp_thing into $thing. If you have chosen the zlib or deflate options in "new", you also need to specify the expected size of $thing.

my $thing = $gl->decompress ($dthing, 1000);

In the gzip format, the size is stored within the data itself, so it doesn't need to be specified.

new

my $gl = Gzip::Libdeflate->new (%options);

Possible options are

level
my $gl = Gzip::Libdeflate->new (level => 9);

A numerical argument of compression level from 1 (fast and poor compression) to 12 (slow and good compression). If you do not specify it, the default is 6. These correspond to the compression levels of zlib, but with extra compression levels 10-12 also added. See "About libdeflate" for details.

As with zlib, there is also a "zero compression" option of level 0 which just puts the input into the gzip format without compressing it at all.

type
my $gl = Gzip::Libdeflate->new (type => 'deflate');

Change the type of compression. The default is type gzip but you can also choose deflate and zlib. These are all the same thing up to headers.

SEE ALSO

About libdeflate

Libdeflate is a new library which offers the same form of deflate compression as offered by zlib. From its README:

    libdeflate is a library for fast, whole-buffer DEFLATE-based compression and decompression.

See the Libdeflate github repository for full information.

CPAN modules

Alien::libdeflate

AUTHOR

Ben Bullock, <bkb@cpan.org>

COPYRIGHT & LICENCE

This package and associated files are copyright (C) 2021 Ben Bullock.

You can use, copy, modify and redistribute this package and associated files under the Perl Artistic Licence or the GNU General Public Licence.

Libdeflate's copyright and licence are as follows.

Copyright 2016 Eric Biggers

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.