archive 1.0.32

archive

Build Status

Overview

A Dart library to encode and decode various archive and compression formats.

The library has no reliance on dart:io, so it can be used for both server and web applications.

The archive library currently supports the following decoders:

  • Zip (Archive)
  • Tar (Archive)
  • ZLib [Inflate decompression]
  • GZip [Inflate decompression]
  • BZip2 [decompression]

And the following encoders:

  • Zip (Archive)
  • Tar (Archive)
  • ZLib [Deflate compression]
  • GZip [Deflate compression]
  • BZip2 [compression]

Sample

Extract the contents of a Zip file, and encode the contents as a BZip2 compressed Tar file:

import 'dart:io';
import 'package:archive/archive.dart';
void main() {
  // Read the Zip file from disk.
  List<int> bytes = new File('test.zip').readAsBytesSync();

  // Decode the Zip file
  Archive archive = new ZipDecoder().decodeBytes(bytes);

  // Extract the contents of the Zip archive to disk.
  for (ArchiveFile file in archive) {
    String filename = file.name;
    List<int> data = file.content;
    new File('out/' + filename)
          ..createSync(recursive: true)
          ..writeAsBytesSync(data);
  }

  // Encode the archive as a BZip2 compressed Tar file.
  List<int> tar_data = new TarEncoder().encode(archive);
  List<int> tar_bz2 = new BZip2Encoder().encode(tar_data);

  // Write the compressed tar file to disk.
  File fp = new File(filename + '.tbz');
  fp.writeAsBytesSync(tar_bz2);
}

1.0.30 - May 27, 2017

  • Add archive_io sub-package for supporting file streaming rather than storing everything in memory. This is a work-in-progress and under development.

1.0.29 - May 25, 2017

  • Fix issue with POSIX tar files.
  • Upgrade dependency on archive to >=1.0.0 <2.0.0

1.0.20 - Jun2 21, 2015

  • Improve performance decompressing large files in zip archives.

1.0.19 - February 23, 2014

  • Disable CRC verification by default when decoding archives.

1.0.18 - October 09, 2014

  • Add support for encoding uncompressed files in zip archives.

1.0.17 - April 25, 2014

  • Fix a bug in InputStream.

1.0.16 - March 02, 2014

  • Add stream support to Inflate decompression.

1.0.15 - February 16, 2014

  • Improved performance when writing large blocks.

1.0.14 - February 12, 2014

  • Misc updates and fixes.

1.0.13 - February 06, 2014

  • Added BZip2 encoder.

  • BREAKING CHANGE: File was renamed to ArchiveFile, to avoid conflicts with dart:io.

1.0.12 - February 04, 2014

  • Added BZip2 decoder.

1.0.11 - February 02, 2014

  • Changed InputStream to work with typed_data instead of List<int>, should reduce memory and increase performance.

1.0.10 - January 19, 2013

  • Renamed InputBuffer and OutputBuffer to InputStream and OutputStream, respectively.

  • Added readBits method to InputStream.

1. Depend on it

Add this to your package's pubspec.yaml file:

dependencies:
  archive: "^1.0.32"

2. Install it

You can install packages from the command line:

$ pub get

Alternatively, your editor might support 'pub get'. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:

import 'package:archive/archive.dart';

Platforms

About

Provides encoders and decoders for various archive and compression formats such as zip, tar, bzip2, gzip, and zlib.

Author

Email brendanduncan@gmail.com Brendan Duncan

Homepage

github.com/brendan-duncan/archive

Documentation

www.dartdocs.org/documentation/archive/1.0.32/

Uploader

brendanduncan@gmail.com

License

MIT 2.0

Published

Oct 12, 2017

Share