▼File:   Racket File and Format Libraries
On this page:
zip
zip->output
zip-verbose
  top  ← prev  up  next → 

4 zip File Creation

 (require file/zip) package: base
The file/zip library provides utilities to create zip archive files, which are compatible with both Windows and Unix (including Mac OS X) unpacking. The actual compression is implemented by deflate.

procedure

(zip zip-file path ... [#:timestamp timestamp]) → void?

  zip-file : path-string?
  path : path-string?
  timestamp : (or/c #f exact-integer?) = #f
Creates zip-file, which holds the complete content of all paths.

The given paths are all expected to be relative path names of existing directories and files (i.e., relative to the current directory). If a nested path is provided as a path, its ancestor directories are also added to the resulting zip file, up to the current directory (using pathlist-closure).

Files are packaged as usual for zip files, including permission bits for both Windows and Unix (including Mac OS X). The permission bits are determined by file-or-directory-permissions, which does not preserve the distinction between owner/group/other permissions. Also, symbolic links are always followed.

If timestamp is not #f, it is used as the modification date for each file, instead of the result of file-or-directory-modify-seconds.

procedure

(zip->output paths    
  [out    
  #:timestamp timestamp]) → void?
  paths : (listof path-string?)
  out : output-port? = (current-output-port)
  timestamp : (or/c #f exact-integer?) = #f
Zips each of the given paths, and packages it as a zip “file” that is written directly to out. Unlike zip, the specified paths are included as-is; if a directory is specified, its content is not automatically added, and nested directories are added without parent directories.

parameter

(zip-verbose) → boolean?

(zip-verbose on?) → void?
  on? : any/c
A parameter that controls output during a zip operation. Setting this parameter to a true value causes zip to display to (current-error-port) the filename that is currently being compressed.

  top  ← prev  up  next →