the new entry.

The archive must be open with mode ``'w'``, ``'x'`` or ``'a'``.

.. note::

There is no official file name encoding for ZIP files. If you have unicode file

names, you must convert them to byte strings in your desired encoding before

passing them to :meth:`write`. WinZip interprets all file names as encoded in

CP437, also known as DOS Latin.

.. note::

Archive names should be relative to the archive root, that is, they should not

.. method:: ZipFile.writestr(zinfo_or_arcname, data[, compress_type])

Write the string *data* to the archive; *zinfo_or_arcname* is either the file

Write a file into the archive. The contents is *data*, which may be either

a :class:`str` or a :class:`bytes` instance; if it is a :class:`str`,

it is encoded as UTF-8 first. *zinfo_or_arcname* is either the file

name it will be given in the archive, or a :class:`ZipInfo` instance. If it's

an instance, at least the filename, date, and time must be given. If it's a

name, the date and time is set to the current date and time.

.. attribute:: ZipFile.comment

The comment text associated with the ZIP file. If assigning a comment to a

The comment associated with the ZIP file as a :class:`bytes` object.

If assigning a comment to a

:class:`ZipFile` instance created with mode ``'w'``, ``'x'`` or ``'a'``,

this should be a

string no longer than 65535 bytes. Comments longer than this will be

truncated in the written archive when :meth:`close` is called.

it should be no longer than 65535 bytes. Comments longer than this will be

truncated.

.. _pyzipfile-objects:

.. attribute:: ZipInfo.comment

Comment for the individual archive member.

Comment for the individual archive member as a :class:`bytes` object.

.. attribute:: ZipInfo.extra

Expansion field data. The `PKZIP Application Note`_ contains

some comments on the internal structure of the data contained in this string.

some comments on the internal structure of the data contained in this

:class:`bytes` object.

.. attribute:: ZipInfo.create_system