zip

2015-06-08

Library for ZIP archive file reading and writing

Upstream URL

github.com/bluelisp/zip

Author

David Lichteblau and contributors <zip-devel@common-lisp.net>

License

Lisp-LGPL (and some parts BSD-style, see LICENSE for details)
README
Common Lisp ZIP library A library for .zip-file reading and writing, written in Common Lisp. Credits: David Lichteblau, Tomas Hlavaty. Thanks to everyone who has contributed patches. Send bug reports to [1]<zip-devel@common-lisp.net> ([2]list information). Thanks to [3]common-lisp.net for web site and mailing list hosting. Please note the repository on [4]github. Uses [5]salza2 for compression, [6]flexi-streams for external format support, [7]trivial-gray-streams for gray streams portability, and includes [8]inflate.cl for decompression. Recent changes 2015: Move to github, and backport of changes from downstream fork (Thanks to Tomas Hlavaty.) 2006 -- 2011: During this time a fork occurred. The common-lisp.net version of the library received little attention, except that it was ported to ASDF2. (Thanks to Faré Rideau.) 2006: Fixed the gray stream port, including a data corruption bug that was in CVS for some time. (Thanks to Kevin Reid and others.) Switched to flexi-stream external-format functions for portability. Uses trivial-gray-streams now. Allegro 8.0 fix (thanks to Edi Weitz). Comment support (thanks to Surendra Singhi). Incompatible change: Don't bind *locale* on Allegro anymore. 2005-04-05: ACL fixes (thank to Edi Weitz). Lispworks port (thanks to Sean Ross). Store file-write-date (also fixes FilZip compatibility). Download * Using Quicklisp (if in doubt, this is a good way to get started): (ql:quickload :zip) * From github: git clone https://github.com/bluelisp/zip * Using clbuild2 from github: clbuild install-from-upstream zip -- For the one or two clbuild users out there * Using clbuild2 via QuickLisp: clbuild quickload zip -- Ditto * Tarball releases -- Unfortunately we are not currently offering a release tarball for download. Portability Needs gray streams. The original version had separate support out-of-the-box on SBCL, Lispworks, and ACL. The fork briefly introduced some features specific to simple-stream / ACL. We believe the library to currently be portable to most popular Common Lisp implementations, but patches are welcome. ZIP-file reading Zip archives are represented as opaque handles. Entries of the zip-file are named by strings and represented as objects, too. Function OPEN-ZIPFILE (pathname) => zipfile Open .zip-file pathname for reading and return a handle for it. Function CLOSE-ZIPFILE (zipfile) Close the file handle. Macro WITH-ZIPFILE ((var pathname) &body body) => result of body Bind var to the result of open-zipfile, evaluate body as an implicit progn and call close-zipfile before exiting. Function GET-ZIPFILE-ENTRY (name zipfile) => zipfile-entry Return an entry handle for the file called name. Function ZIPFILE-ENTRIES (zipfile) => hash-table Return a hash-table mapping filenames to entry handles for all files contained in the zip archive. Macro DO-ZIPFILE-ENTRIES ((name-var entry-var zipfile) &body body) => nil Map over all entries in zipfile binding name-var and entry-var to each file name and entry handle in turn. Establish implicit block named nil around the loop. Function ZIPFILE-ENTRY-NAME (zipfile-entry) => string Return an entry's file name as a string. Function ZIPFILE-ENTRY-CONTENTS (entry &optional stream) => see below If stream is given, extract entry to the (unsigned-byte 8) stream given as the argument. Otherwise, return the entry contents as an (unsigned-byte 8) vector. Function UNZIP (pathname target-directory &key if-exists verbose) => nil Extract all entries from the zip archive at pathname into target-directory. if-exists as for [9]cl:open. ZIP-file writing zipwriters are handles used to create zip archives. They are distinct from the zip handles used for reading. Macro WITH-OUTPUT-TO-ZIPFILE ((var pathname &key if-exists) &body body) Function WRITE-ZIPENTRY (zipwriter name data &key file-write-date) Append a new entry called name to zipwriter. Read data from (unsigned-byte 8) stream data until EOF and compress it into "deflate"-format. Use file-write-date as the entry's date and time. Default to (file-write-date data), use 1980-01-01T00:00 if nil. Function ZIP (pathname source-directory &key if-exists) Compress all files in source-directory recursively into a new zip archive at pathname. Note that entry file names will not contain the name source-directory. Bookmark [10]spec References 1. mailto:zip-devel@common-lisp.net 2. http://common-lisp.net/cgi-bin/mailman/listinfo/zip-devel 3. http://common-lisp.net/ 4. https://github.com/bluelisp/zip 5. http://www.xach.com/lisp/salza2/ 6. http://www.weitz.de/flexi-streams/ 7. http://common-lisp.net/project/cl-plus-ssl/#trivial-gray-streams 8. http://opensource.franz.com/deflate/ 9. http://www.xach.com/clhs.php?open 10. http://www.pkware.com/company/standards/appnote/appnote.txt

Dependencies (4)

  • babel
  • cl-fad
  • salza2
  • trivial-gray-streams
  • GitHub
  • Quicklisp