1.0.20
2 files changed
tree: b640df6a72533f2c0cbbdb28cd0782e9e840bff1
  1. bin/
  2. example/
  3. lib/
  4. test/
  5. .gitignore
  6. ChangeLog.txt
  7. LICENSE
  8. pubspec.yaml
  9. README.md
README.md

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' as Io;
import 'package:archive/archive.dart';
void main() {
  // Read the Zip file from disk.
  List<int> bytes = new Io.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 Io.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.
  Io.File fp = new Io.File(filename + '.tbz');
  fp.writeAsBytesSync(tar_bz2);
}