(self, name, mode="r", pwd=None, *, force_zip64=False)
Return file-like object for 'name'.

        name is a string for the file name within the ZIP file, or a ZipInfo
        object.

        mode should be 'r' to read a file already in the ZIP file, or 'w' to
        write to a file newly added to the archive.

        pwd is the password to decrypt files (only used for reading).

        When writing, if the file size is not known in advance but may exceed
        2 GiB, pass force_zip64 to use the ZIP64 format, which can handle large
        files.  If the size is known in advance, it is best to pass a ZipInfo
        instance for name, with zinfo.file_size set.
Return file-like object for 'name'.
Return file - like object for name .
def open(self, name, mode="r", pwd=None, *, force_zip64=False):
        """Return file-like object for 'name'.

        name is a string for the file name within the ZIP file, or a ZipInfo
        object.

        mode should be 'r' to read a file already in the ZIP file, or 'w' to
        write to a file newly added to the archive.

        pwd is the password to decrypt files (only used for reading).

        When writing, if the file size is not known in advance but may exceed
        2 GiB, pass force_zip64 to use the ZIP64 format, which can handle large
        files.  If the size is known in advance, it is best to pass a ZipInfo
        instance for name, with zinfo.file_size set.
        """
        if mode not in {"r", "w"}:
            raise ValueError('open() requires mode "r" or "w"')
        if pwd and not isinstance(pwd, bytes):
            raise TypeError("pwd: expected bytes, got %s" % type(pwd).__name__)
        if pwd and (mode == "w"):
            raise ValueError("pwd is only supported for reading files")
        if not self.fp:
            raise ValueError(
                "Attempt to use ZIP archive that was already closed")

        # Make sure we have an info object
        if isinstance(name, ZipInfo):
            # 'name' is already an info object
            zinfo = name
        elif mode == 'w':
            zinfo = ZipInfo(name)
            zinfo.compress_type = self.compression
            zinfo._compresslevel = self.compresslevel
        else:
            # Get info object for name
            zinfo = self.getinfo(name)

        if mode == 'w':
            return self._open_to_write(zinfo, force_zip64=force_zip64)

        if self._writing:
            raise ValueError("Can't read from the ZIP file while there "
                    "is an open writing handle on it. "
                    "Close the writing handle before trying to read.")

        # Open for reading:
        self._fileRefCnt += 1
        zef_file = _SharedFile(self.fp, zinfo.header_offset,
                               self._fpclose, self._lock, lambda: self._writing)
        try:
            # Skip the file header:
            fheader = zef_file.read(sizeFileHeader)
            if len(fheader) != sizeFileHeader:
                raise BadZipFile("Truncated file header")
            fheader = struct.unpack(structFileHeader, fheader)
            if fheader[_FH_SIGNATURE] != stringFileHeader:
                raise BadZipFile("Bad magic number for file header")

            fname = zef_file.read(fheader[_FH_FILENAME_LENGTH])
            if fheader[_FH_EXTRA_FIELD_LENGTH]:
                zef_file.read(fheader[_FH_EXTRA_FIELD_LENGTH])

            if zinfo.flag_bits & 0x20:
                # Zip 2.7: compressed patched data
                raise NotImplementedError("compressed patched data (flag bit 5)")

            if zinfo.flag_bits & 0x40:
                # strong encryption
                raise NotImplementedError("strong encryption (flag bit 6)")

            if fheader[_FH_GENERAL_PURPOSE_FLAG_BITS] & 0x800:
                # UTF-8 filename
                fname_str = fname.decode("utf-8")
            else:
                fname_str = fname.decode("cp437")

            if fname_str != zinfo.orig_filename:
                raise BadZipFile(
                    'File name in directory %r and header %r differ.'
                    % (zinfo.orig_filename, fname))

            # check for encrypted flag & handle password
            is_encrypted = zinfo.flag_bits & 0x1
            if is_encrypted:
                if not pwd:
                    pwd = self.pwd
                if not pwd:
                    raise RuntimeError("File %r is encrypted, password "
                                       "required for extraction" % name)
            else:
                pwd = None

            return ZipExtFile(zef_file, mode, zinfo, pwd, True)
        except:
            zef_file.close()
            raise
def open ( self , name , mode = "r" , pwd = None , * , force_zip64 = False ) : if mode not in { "r" , "w" } : raise ValueError ( 'open() requires mode "r" or "w"' ) if pwd and not isinstance ( pwd , bytes ) : raise TypeError ( "pwd: expected bytes, got %s" % type ( pwd ) . __name__ ) if pwd and ( mode == "w" ) : raise ValueError ( "pwd is only supported for reading files" ) if not self . fp : raise ValueError ( "Attempt to use ZIP archive that was already closed" ) # Make sure we have an info object if isinstance ( name , ZipInfo ) : # 'name' is already an info object zinfo = name elif mode == 'w' : zinfo = ZipInfo ( name ) zinfo . compress_type = self . compression zinfo . _compresslevel = self . compresslevel else : # Get info object for name zinfo = self . getinfo ( name ) if mode == 'w' : return self . _open_to_write ( zinfo , force_zip64 = force_zip64 ) if self . _writing : raise ValueError ( "Can't read from the ZIP file while there " "is an open writing handle on it. " "Close the writing handle before trying to read." ) # Open for reading: self . _fileRefCnt += 1 zef_file = _SharedFile ( self . fp , zinfo . header_offset , self . _fpclose , self . _lock , lambda : self . _writing ) try : # Skip the file header: fheader = zef_file . read ( sizeFileHeader ) if len ( fheader ) != sizeFileHeader : raise BadZipFile ( "Truncated file header" ) fheader = struct . unpack ( structFileHeader , fheader ) if fheader [ _FH_SIGNATURE ] != stringFileHeader : raise BadZipFile ( "Bad magic number for file header" ) fname = zef_file . read ( fheader [ _FH_FILENAME_LENGTH ] ) if fheader [ _FH_EXTRA_FIELD_LENGTH ] : zef_file . read ( fheader [ _FH_EXTRA_FIELD_LENGTH ] ) if zinfo . flag_bits & 0x20 : # Zip 2.7: compressed patched data raise NotImplementedError ( "compressed patched data (flag bit 5)" ) if zinfo . flag_bits & 0x40 : # strong encryption raise NotImplementedError ( "strong encryption (flag bit 6)" ) if fheader [ _FH_GENERAL_PURPOSE_FLAG_BITS ] & 0x800 : # UTF-8 filename fname_str = fname . decode ( "utf-8" ) else : fname_str = fname . decode ( "cp437" ) if fname_str != zinfo . orig_filename : raise BadZipFile ( 'File name in directory %r and header %r differ.' % ( zinfo . orig_filename , fname ) ) # check for encrypted flag & handle password is_encrypted = zinfo . flag_bits & 0x1 if is_encrypted : if not pwd : pwd = self . pwd if not pwd : raise RuntimeError ( "File %r is encrypted, password " "required for extraction" % name ) else : pwd = None return ZipExtFile ( zef_file , mode , zinfo , pwd , True ) except : zef_file . close ( ) raise