Bump version and update Changes

[io-compress-brotli.git] / lib / IO / Uncompress / Brotli.pm

diff --git a/lib/IO/Uncompress/Brotli.pm b/lib/IO/Uncompress/Brotli.pm
index 1c6671b0cd3ed77dcd5d5353a3d224065a207ea9..f472ca989afb0d5e9bef138a3c612487442272ee 100644 (file)
--- a/lib/IO/Uncompress/Brotli.pm
+++ b/lib/IO/Uncompress/Brotli.pm
@@ -8,11 +8,26 @@ use parent qw/Exporter/;
 our @EXPORT = qw/unbro/;
 our @EXPORT_OK = @EXPORT;
 
 our @EXPORT = qw/unbro/;
 our @EXPORT_OK = @EXPORT;
 

-our $VERSION = '0.004001';
+our $VERSION = '0.004_002';

 
 require XSLoader;
 XSLoader::load('IO::Compress::Brotli', $VERSION);
 
 
 require XSLoader;
 XSLoader::load('IO::Compress::Brotli', $VERSION);
 

+# 0.004001 has unbro with prototype $$
+# 0.004_002 renames it to unbro_given_size, and provides unbro with
+#           prototype $;$ which calls:
+#           * unbro_given_size when called with two arguments
+#           * the OO interface when called with one argument
+sub unbro ($;$) {
+       my ($buffer, $decoded_size) = @_;
+       if (defined $decoded_size) {
+               return unbro_given_size($buffer, $decoded_size)
+       } else {
+               my $bro = IO::Uncompress::Brotli->create;
+               return $bro->decompress($buffer);
+       }
+}
+

 1;
 __END__
 
 1;
 __END__
 


@@ -58,6 +73,11 @@ data. It allocates a buffer of size I<$maximum_decoded_size> to store
 the decompressed data, if this is not sufficient (or there is another
 error) this function will croak.
 
 the decompressed data, if this is not sufficient (or there is another
 error) this function will croak.
 

+As of version 0.004_002, the I<$maximum_decoded_size> argument is
+optional. If not provided, B<unbro> uses the streaming interface
+described in the next section to decompress the buffer in blocks of
+one megabyte. The decompressed blocks are concatenated and returned.
+

 Exported by default.
 
 =back
 Exported by default.
 
 =back