zipfile::encode - Zip archive handling

[ Tcllib Home | Main Table Of Contents | Table Of Contents | Keyword Index | Categories | Modules | Applications ]

# zipfile::encode(n) 0.3 tcllib "Zip archive handling"

## Name

zipfile::encode - Generation of zip archives

## Table Of Contents

## Synopsis

- package require Tcl 8.4
- package require logger
- package require Trf
- package require crc32
- package require snit
- package require zlibtcl
- package require fileutil
- package require zipfile::encode ?0.3?

- ::zipfile::encode ?objectName?
- <encoder> comment: text
- <encoder> file: dst owned src
- <encoder> write archive

## Description

This package provides a class for the generation of zip archives.

## Class API

::zipfile::encode ?objectName?

  The class command constructs encoder instances, i.e. objects. The result of the command is the fully-qualified name of the instance command.

  If no objectName is specified the class will generate and use an automatic name. If the objectName was specified, but is not fully qualified the command will be created in the current namespace.

## Instance API

<encoder> comment: text

  This method specifies the text of the global comment for the archive. The result of the method is the empty string. In case of multiple calls to this method for the same encoder the data from the last call prevails over all previous texts.

<encoder> file: dst owned src

  This method adds a new file to the archive. The contents of the file are found in the filesystem at src, and will be stored in the archive under path dst. If the file is declared as owned by the archive the original file will be deleted when the archive is constructed and written. The result of the method is an empty string.

<encoder> write archive

  This method takes the global comment and all added files, encodes them as a zip archive and stores the result at path archive in the filesystem. All added files which were owned by the archive are deleted at this point.

## Bugs, Ideas, Feedback

This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such in the category zipfile of the Tcllib Trackers. Please also report any ideas for enhancements you may have for either package and/or documentation.

## Keywords

compression, zip

## Category

File

## Copyright

Copyright © 2008-2009 Andreas Kupries