Description

The pr-zlib library is a pure Ruby version of the zlib compression library. It consists of both a port of zlib.h and the Ruby zlib library that ships as part of the standard library.

Synopsis

# Imitating a bit of code used in rubygems require ‘pr/zlib’ require ‘stringio’

data = StringIO.new(data) Zlib::GzipReader.new(data).read

Motivation

First, building the zlib C library on MS Windows with Visual C++ is very difficult. However, certain libraries depend on zlib, most notably rubygems. By providing a pure Ruby version we eliminate any compiler or platform compatability issues.

Second, even some Unix distributions, such as Debian, do not ship with the zlib library by default. By creating a pure Ruby version of the zlib library we eliminate the need to install a 3rd party C library, and eliminate a potential weak link in the dependency chain.

Third, by creating pure Ruby versions of the library and the interface we are more likely to receive patches, feature requests, documentation updates, etc, from the Ruby community since not everyone who knows Ruby also knows C.

Last, the zlib interface that ships as part of the stdlib is a little on the clunky side. By providing a pure Ruby version, authors can create their own interface as they see fit.

TODO

More tests, and better tests, are needed for both Rbzlib and Zlib.

Authors

  • Park Heesob (C translation)

  • Daniel Berger (Testing, packaging, deployment)