Join GitHub today
GitHub is home to over 20 million developers working together to host and review code, manage projects, and build software together.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
= 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. = Caveats You cannot use both this library and the zlib standard library at the same time. If you try to use both there is a good chance you will get an allocation error of some sort. If you already have zlib, you do not need this library. = License This library is covered under the same license as zlib itself. For the text of the zlib license, please see http://zlib.net/zlib_license.html. = Authors * Park Heesob (C translation) * Daniel Berger (Testing, packaging, deployment)