`zipfile` — Trabajar con archivos ZIP¶

Source code: Lib/zipfile.py

El formato de archivo ZIP es un estándar común de archivo y compresión. Este módulo proporciona herramientas para crear, leer, escribir, agregar y listar un archivo ZIP. Cualquier uso avanzado de este módulo requerirá una comprensión del formato, tal como se define en la PKZIP Application Note.

Actualmente, este módulo no maneja archivos ZIP multi-disco. Puede manejar archivos ZIP que usan las extensiones ZIP64 (es decir, archivos ZIP que tienen más de 4 GB de tamaño). Admite el descifrado de archivos cifrados en archivos ZIP, pero actualmente no puede crear un archivo cifrado. El descifrado es extremadamente lento ya que se implementa en Python nativo en lugar de C.

El módulo define los siguientes elementos:

exception zipfile.BadZipFile¶: El error lanzado para archivos ZIP incorrectos.

Nuevo en la versión 3.2.

exception zipfile.BadZipfile¶: Alias de BadZipFile, para compatibilidad con versiones anteriores de Python.

Obsoleto desde la versión 3.2.

exception zipfile.LargeZipFile¶: El error lanzado cuando un archivo ZIP requiera la funcionalidad ZIP64 pero no ha sido habilitado.

class zipfile.ZipFile: La clase para leer y escribir archivos ZIP. Vea la sección Objetos ZipFile para detalles del constructor.

class zipfile.Path: Un contenedor compatible con pathlib para archivos zip. Vea la sección Objetos de ruta para más detalles.

Nuevo en la versión 3.8.

class zipfile.PyZipFile: Clase para crear archivos ZIP que contienen bibliotecas de Python.

class zipfile.ZipInfo(filename='NoName', date_time=(1980, 1, 1, 0, 0, 0))¶: Clase utilizada para representar información sobre un miembro de un archivo. Las instancias de esta clase son retornadas por los métodos getinfo() y infolist() de objetos ZipFile. La mayoría de los usuarios del módulo zipfile no necesitarán crearlos, sino que solo usarán aquellos creados por este módulo. filename debe ser el nombre completo del miembro del archivo, y date_time debe ser una tupla que contenga seis campos que describan la hora de la última modificación del archivo; los campos se describen en la sección Objetos ZipInfo.

zipfile.is_zipfile(filename)¶: Retorna True si filename es un archivo ZIP válido basado en su número mágico; de lo contrario, retorna False. filename también puede ser un archivo o un objeto similar a un archivo.

Distinto en la versión 3.1: Soporte para archivos y objetos similares a archivos.

zipfile.ZIP_STORED¶: La constante numérica para un miembro de archivo sin comprimir.

zipfile.ZIP_DEFLATED¶: La constante numérica para el método de compresión ZIP habitual. Esto requiere el módulo zlib.

zipfile.ZIP_BZIP2¶: La constante numérica para el método de compresión BZIP2. Esto requiere el módulo bz2.

Nuevo en la versión 3.3.

zipfile.ZIP_LZMA¶: La constante numérica para el método de compresión LZMA. Esto requiere el módulo lzma.

Nuevo en la versión 3.3.

Nota

La especificación del formato del archivo ZIP ha incluido soporte para la compresión bzip2 desde 2001 y para la compresión LZMA desde 2006. Sin embargo, algunas herramientas (incluidas las versiones anteriores de Python) no admiten estos métodos de compresión y pueden negarse a procesar el archivo ZIP por completo o no puede extraer archivos individuales.

Ver también

PKZIP Application Note: Documentación sobre el formato de archivo ZIP por Phil Katz, el creador del formato y los algoritmos utilizados.
Info-ZIP Home Page: Información sobre los programas de archivo ZIP del proyecto Info-ZIP y las bibliotecas de desarrollo.

Objetos ZipFile¶

class zipfile.ZipFile(file, mode='r', compression=ZIP_STORED, allowZip64=True, compresslevel=None, *, strict_timestamps=True)¶

Abra un archivo ZIP, donde file puede ser una ruta a un archivo (una cadena), un objeto similar a un archivo o un path-like object.

El parámetro mode debe ser 'r' para leer un archivo existente, 'w' para truncar y escribir un nuevo archivo, 'a' para agregarlo a un archivo existente, o 'x' para crear y escribir exclusivamente un nuevo archivo. Si mode es 'x' y file se refiere a un archivo existente, se generará a FileExistsError. Si mode es 'a' y file se refiere a un archivo ZIP existente, entonces se le agregan archivos adicionales. Si file no se refiere a un archivo ZIP, se agrega un nuevo archivo ZIP al archivo. Esto está destinado a agregar un archivo ZIP a otro archivo (como: archivo:python.exe). Si mode es 'a' y el archivo no existe en absoluto, se crea. Si mode es 'r' o 'a', el archivo debe poder buscarse.

compression es el método de compresión ZIP que se utiliza al escribir el archivo, y debe ser ZIP_STORED, ZIP_DEFLATED, ZIP_BZIP2 o ZIP_LZMA; los valores no reconocidos harán que se lance NotImplementedError. Si ZIP_DEFLATED, ZIP_BZIP2 o ZIP_LZMA se especifica pero el módulo correspondiente (zlib, bz2 o lzma) no está disponible, RuntimeError es lanzado. El valor predeterminado es ZIP_STORED.

Si allowZip64 es True (el valor predeterminado) zipfile creará archivos ZIP que usan las extensiones ZIP64 cuando el archivo zip es mayor que 4 GB. Si es False zipfile generará una excepción cuando el archivo ZIP requiera extensiones ZIP64.

El parámetro compresslevel controla el nivel de compresión que se utilizará al escribir archivos en el archivo. Cuando se utiliza ZIP_STORED o ZIP_LZMA no tiene ningún efecto. Cuando se usa ZIP_DEFLATED se aceptan los enteros 0 a 9 (ver zlib para más información). Cuando se utiliza ZIP_BZIP2 se aceptan enteros 1 a 9 (consulte bz2 para obtener más información).

El argumento strictly_timestamps, cuando se establece en False, permite comprimir archivos anteriores a 1980-01-01 a costa de establecer la marca de tiempo en 1980-01-01. Un comportamiento similar ocurre con archivos más nuevos que 2107-12-31, la marca de tiempo también se establece en el límite.

Si el archivo se crea con el modo 'w', 'x' o 'a' y luego closed sin agregar ningún archivo al archivo, Las estructuras ZIP apropiadas para un archivo vacío se escribirán en el archivo.

ZipFile también es un manejador de contexto y por lo tanto, admite la declaración with. En el ejemplo, myzip se cierra después que el conjunto de instrucciones with se termine—incluso si se produce una excepción:

with ZipFile('spam.zip', 'w') as myzip:
    myzip.write('eggs.txt')

Nuevo en la versión 3.2: Se agregó la capacidad de usar ZipFile como administrador de contexto.

Distinto en la versión 3.3: Soporte agregado para bzip2 y compresión lzma.

Distinto en la versión 3.4: Las extensiones ZIP64 están habilitadas por defecto.

Distinto en la versión 3.5: Se agregó soporte para escribir en secuencias que no se pueden buscar. Se agregó soporte para el modo 'x'.

Distinto en la versión 3.6: Anteriormente, se generó un simple RuntimeError para valores de compresión no reconocidos.

Distinto en la versión 3.6.2: El parámetro file acepta un path-like object.

Distinto en la versión 3.7: Agregue el parámetro compresslevel.

Nuevo en la versión 3.8: El Argumento strict_timestamps solo palabra clave

ZipFile.close()¶: Cierra el archivo. Debe llamar a close() antes de salir de su programa o no se escribirán registros esenciales.

ZipFile.getinfo(name)¶: Retorna un objeto ZipInfo con información sobre el miembro del archivo name. Llamando a getinfo() para obtener un nombre que no figura actualmente en el archivo generará un KeyError.

ZipFile.infolist()¶: Retorna una lista que contiene un objeto ZipInfo para cada miembro del archivo. Los objetos están en el mismo orden que sus entradas en el archivo ZIP real en el disco si se abrió un archivo existente.

ZipFile.namelist()¶: Retorna una lista de miembros del archivo por nombre.

ZipFile.open(name, mode='r', pwd=None, *, force_zip64=False)¶

Acceda a un miembro del archivo como un objeto binario similar a un archivo. name puede ser el nombre de un archivo dentro del archivo o un objeto ZipInfo. El parámetro mode, si está incluido, debe ser 'r' (el valor predeterminado) o 'w'. pwd es la contraseña utilizada para descifrar archivos ZIP cifrados.

open() también es un administrador de contexto y por lo tanto, soporta with statement:

with ZipFile('spam.zip') as myzip:
    with myzip.open('eggs.txt') as myfile:
        print(myfile.read())

Con mode 'r', el objeto tipo archivo (ZipExtFile) es de solo lectura y proporciona los siguientes métodos: read(), readline(), readlines(), seek(), tell(), __iter__(), __ next__(). Estos objetos pueden funcionar independientemente del archivo Zip.

Con mode = 'w', se retorna un controlador de archivo escribible, que admite el método write(). Mientras está abierto un identificador de archivo escribible, intentar leer o escribir otros archivos en el archivo ZIP generará un ValueError.

Al escribir un archivo, si el tamaño del archivo no se conoce de antemano pero puede exceder los 2 GB, pase force_zip64 = True para asegurarse de que el formato del encabezado sea capaz de admitir archivos grandes. Si el tamaño del archivo se conoce de antemano, construya un objeto ZipInfo con file_size establecido, y úselo como parámetro name.

Nota

Los métodos open(), read() y extract() pueden tomar un nombre de archivo o un objeto ZipInfo. Apreciará esto cuando intente leer un archivo ZIP que contiene miembros con nombres duplicados.

Distinto en la versión 3.6: Se eliminó el soporte de mode='U'. Use io.TextIOWrapper para leer archivos de texto comprimido en modo universal newlines.

Distinto en la versión 3.6: ZipFile.open() can now be used to write files into the archive with the mode='w' option.

Distinto en la versión 3.6: Llamar a open() en un ZipFile cerrado generará un ValueError. Anteriormente, se planteó a RuntimeError.

ZipFile.extract(member, path=None, pwd=None)¶

Extraer un miembro del archivo al directorio de trabajo actual; member debe ser su nombre completo o un objeto ZipInfo. La información de su archivo se extrae con la mayor precisión posible. path especifica un directorio diferente para extraer. member puede ser un nombre de archivo o un objeto ZipInfo. pwd es la contraseña utilizada para archivos cifrados.

Retorna la ruta normalizada creada (un directorio o archivo nuevo).

Nota

Si el nombre de archivo de un miembro es una ruta absoluta, se eliminarán un punto compartido de drive/UNC y las barras diagonales (hacia atrás), ej: ///foo/bar se convierte en foo/bar en Unix y C:\foo\bar se convierte en foo\bar en Windows. Y todos los componentes `` «..» `` en un nombre de archivo miembro se eliminarán, ej: ../../foo../../ba..r se convierte en foo../ba..r. En Windows, los caracteres ilegales (: ``, `` <, > ``, `` | ``, `` "` `,?`` Y *) se reemplazan por guion bajo (_).

Distinto en la versión 3.6: Llamando extract() en un ZipFile cerrado generará un ValueError. Anteriormente, se planteó a RuntimeError.

Distinto en la versión 3.6.2: El parámetro path acepta un path-like object.

ZipFile.extractall(path=None, members=None, pwd=None)¶: Extrae todos los miembros del archivo al directorio de trabajo actual. path especifica un directorio diferente para extraer. members es opcional y debe ser un subconjunto de la lista retornada por namelist(). pwd es la contraseña utilizada para archivos cifrados.

Advertencia

Nunca extraiga archivos de fuentes no confiables sin inspección previa. Es posible que los archivos se creen fuera de path, ej. miembros que tienen nombres de archivo absolutos que comienzan con "/" o nombres de archivo con dos puntos "..". Este módulo intenta evitar eso. Ver extract() nota.

Distinto en la versión 3.6: Llamar a extractall() en un ZipFile cerrado generará un ValueError. Anteriormente, se planteó a RuntimeError.

Distinto en la versión 3.6.2: El parámetro path acepta un path-like object.

ZipFile.printdir()¶: Imprime una tabla de contenido para el archivo en sys.stdout.

ZipFile.setpassword(pwd)¶: Establece pwd como contraseña predeterminada para extraer archivos cifrados.

ZipFile.read(name, pwd=None)¶: Retorna los bytes del archivo name en el archivo. name es el nombre del archivo en el archivo, o un objeto ZipInfo. El archivo debe estar abierto para leer o agregar. pwd es la contraseña utilizada para los archivos cifrados y, si se especifica, anulará la contraseña predeterminada establecida con setpassword(). Llamar a read() en un archivo Zip que utiliza un método de compresión que no sea ZIP_STORED, ZIP_DEFLATED, ZIP_BZIP2 o ZIP_LZMA generará un NotImplementedError. También se generará un error si el módulo de compresión correspondiente no está disponible.

Distinto en la versión 3.6: Llamando read() en un ZipFile cerrado generará un ValueError. Anteriormente, se planteó a RuntimeError.

ZipFile.testzip()¶: Lee todos los archivos en el archivo y verifica sus CRC y encabezados de archivo. Retorna el nombre del primer archivo incorrecto o retorna None.

Distinto en la versión 3.6: Llamar a testzip() en un ZipFile cerrado generará un ValueError. Anteriormente, se planteó a RuntimeError.

ZipFile.write(filename, arcname=None, compress_type=None, compresslevel=None)¶: Escribe el archivo llamado filename en el archivo, dándole el nombre de archivo arcname (por defecto, será el mismo que filename, pero sin una letra de unidad y con los separadores de ruta principales eliminados). Si se proporciona, compress_type anula el valor dado para el parámetro compression al constructor para la nueva entrada. Del mismo modo, compresslevel anulará el constructor si se proporciona. El archivo debe estar abierto con el modo 'w', 'x' o 'a'.

Nota

Los nombres de archivo deben ser relativos a la raíz del archivo, es decir, no deben comenzar con un separador de ruta.

Nota

Si arcname (o filename, si arcname no se proporciona) contiene un byte nulo, el nombre del archivo en el archivo se truncará en el byte nulo.

Nota

A leading slash in the filename may lead to the archive being impossible to open in some zip programs on Windows systems.

Distinto en la versión 3.6: Llamando write() en un ZipFile creado con el modo 'r' o un ZipFile cerrado generará un ValueError. Anteriormente, se planteó a RuntimeError.

ZipFile.writestr(zinfo_or_arcname, data, compress_type=None, compresslevel=None)¶

Escribe un registro en el archivo. El contenido es data, que puede ser una instancia de str o a bytes; si es una str, primero se codifica como UTF-8. zinfo_or_arcname es el nombre del archivo que se le dará en el archivo o una instancia de ZipInfo. Si se trata de una instancia, se debe proporcionar al menos el nombre de archivo, la fecha y la hora. Si es un nombre, la fecha y la hora se configuran en la fecha y hora actuales. El archivo debe abrirse con el modo 'w', 'x' o 'a'.

Si se proporciona, compress_type anula el valor dado para el parámetro compression al constructor para la nueva entrada, o en zinfo_or_arcname (si es una instancia de ZipInfo). Del mismo modo, compresslevel anulará el constructor si se proporciona.

Nota

Al pasar una instancia de ZipInfo como el parámetro zinfo_or_arcname, el método de compresión utilizado será el especificado en el miembro compress_type de la instancia dada ZipInfo. Por defecto, el constructor ZipInfo establece este miembro en ZIP_STORED.

Distinto en la versión 3.2: El argumento compress_type.

Distinto en la versión 3.6: Llamando writestr() en un ZipFile creado con el modo 'r' o un ZipFile cerrado generará un ValueError. Anteriormente, se planteó a RuntimeError.

Los siguientes atributos de datos también están disponibles:

ZipFile.filename¶: Nombre del archivo ZIP.

ZipFile.debug¶: El nivel de salida de depuración a usar. Esto se puede configurar de 0 (el valor predeterminado, sin salida) a 3 (la mayor cantidad de salida). La información de depuración se escribe en sys.stdout.

ZipFile.comment¶: El comentario asociado con el archivo ZIP como un objeto bytes. Si se asigna un comentario a una instancia de ZipFile creada con el modo 'w', 'x' o 'a', no debe tener más de 65535 bytes. Los comentarios más largos que esto se truncarán.

Objetos de ruta¶

class zipfile.Path(root, at='')¶

Construye un objeto Path a partir de un archivo zip root (que puede ser una instancia ZipFile o file adecuado para pasar al constructor ZipFile).

at especifica la ubicación de esta ruta dentro del archivo zip, ej. “dir/file.txt”, “dir/” o “”.El valor predeterminado es la cadena vacía, que indica la raíz.

Los objetos de ruta exponen las siguientes características de objetos pathlib.Path:

Los objetos de ruta se pueden atravesar utilizando el operador /.

Path.name¶: El componente final de la ruta.

Path.open(mode='r', *, pwd, **)¶: Invoca ZipFile.open() en la ruta actual. Permite la apertura para lectura o escritura, texto o binario a través de los modos admitidos: “r”, “w”, “rb”, “wb”. Los argumentos posicionales y de palabras clave se pasan a través de io.TextIOWrapper cuando se abren como texto y se ignoran en caso contrario. pwd es el parámetro pwd para ZipFile.open().

Distinto en la versión 3.9: Se agregó soporte para modos de texto y binarios para abrir. El modo predeterminado ahora es texto.

Path.iterdir()¶: Enumera los hijos del directorio actual.

Path.is_dir()¶: Retorna True si el contexto actual hace referencia a un directorio.

Path.is_file()¶: Retorna True si el contexto actual hace referencia a un archivo.

Path.exists()¶: Retorna True si el contexto actual hace referencia a un archivo o directorio en el archivo zip.

Path.read_text(*, **)¶: Lee el archivo actual como texto unicode. Los argumentos posicionales y de palabras clave se pasan a io.TextIOWrapper (excepto buffer, que está implícito en el contexto).

Path.read_bytes()¶: Lee el archivo actual como bytes.

Objetos PyZipFile¶

El constructor PyZipFile toma los mismos parámetros que el constructor ZipFile, y un parámetro adicional, optimize.

class zipfile.PyZipFile(file, mode='r', compression=ZIP_STORED, allowZip64=True, optimize=-1)¶

Nuevo en la versión 3.2: El parámetro optimize.

Distinto en la versión 3.4: Las extensiones ZIP64 están habilitadas por defecto.

Las instancias tienen un método ademas de los objetos ZipFile:

writepy(pathname, basename='', filterfunc=None)¶

Busca archivos *.py y agrega el archivo correspondiente al archivo.

Si no se proporcionó el parámetro optimize a PyZipFile o -1, el archivo correspondiente es un archivo *.pyc, compilando si es necesario.

Si el parámetro optimize a PyZipFile era 0, 1 or 2, solo se agregarán a ese archivo los archivos con ese nivel de optimización (ver compile()) el archivo, compilando si es necesario.

Si pathname es un archivo, el nombre del archivo debe terminar con .py, y solo el archivo (correspondiente *.pyc) se agrega en el nivel superior (sin información de ruta). Si pathname es un archivo que no termina con .py, se generará RuntimeError. Si es un directorio, y el directorio no es un directorio de paquetes, entonces todos los archivos *.pyc se agregan en el nivel superior. Si el directorio es un directorio de paquetes, todos *.pyc se agregan bajo el nombre del paquete como una ruta de archivo, y si alguno de los subdirectorios son directorios de paquetes, todos estos se agregan recursivamente en orden ordenado.

basename está destinado solo para uso interno.

filterfunc, si se proporciona, debe ser una función que tome un único argumento de cadena. Se le pasará cada ruta (incluida cada ruta de archivo completa individual) antes de que se agregue al archivo. Si filterfunc retorna un valor falso, la ruta no se agregará y si se trata de un directorio se ignorará su contenido. Por ejemplo, si nuestros archivos de prueba están todos en directorios de test o comienzan con la cadena test_, podemos usar un filterfunc para excluirlos

>>> zf = PyZipFile('myprog.zip')
>>> def notests(s):
...     fn = os.path.basename(s)
...     return (not (fn == 'test' or fn.startswith('test_')))
>>> zf.writepy('myprog', filterfunc=notests)

El método writepy() crea archivos con nombres de archivo como este

string.pyc                   # Top level name
test/__init__.pyc            # Package directory
test/testall.pyc             # Module test.testall
test/bogus/__init__.pyc      # Subpackage directory
test/bogus/myfile.pyc        # Submodule test.bogus.myfile

Nuevo en la versión 3.4: El parámetro filterfunc.

Distinto en la versión 3.6.2: El parámetro pathname acepta un path-like object.

Distinto en la versión 3.7: La recursividad ordena las entradas del directorio.

Objetos ZipInfo¶

Las instancias de la clase ZipInfo son retornadas por los métodos getinfo() y infolist() de ZipFile. Cada objeto almacena información sobre un solo miembro del archivo ZIP.

Hay un método de clase para hacer una instancia de ZipInfo para un archivo de sistema de archivos:

classmethod ZipInfo.from_file(filename, arcname=None, *, strict_timestamps=True)¶

Construye una instancia de ZipInfo para un archivo en el sistema de archivos, en preparación para agregarlo a un archivo zip.

filename debe ser la ruta a un archivo o directorio en el sistema de archivos.

Si se especifica arcname, este es usado como el nombre dentro del archivo. Si no se especifica arcname, el nombre será el mismo que filename, pero con cualquier letra de unidad y separadores de ruta principales eliminados.

El argumento strictly_timestamps, cuando se establece en False, permite comprimir archivos anteriores a 1980-01-01 a costa de establecer la marca de tiempo en 1980-01-01. Un comportamiento similar ocurre con archivos más nuevos que 2107-12-31, la marca de tiempo también se establece en el límite.

Nuevo en la versión 3.6.

Distinto en la versión 3.6.2: El parámetro filename acepta un path-like object.

Nuevo en la versión 3.8: El Argumento strict_timestamps solo palabra clave

Las instancias tienen los siguientes métodos y atributos:

ZipInfo.is_dir()¶

Retorna True si este miembro del archivo es un directorio.

Utiliza el nombre de la entrada: los directorios siempre deben terminar con /.

Nuevo en la versión 3.6.

ZipInfo.filename¶: Nombre del archivo en el archivo.

ZipInfo.date_time¶

La hora y fecha de la última modificación al miembro del archivo. Esta es una tupla de seis valores:

Índice	Valor
`0`	Año (>= 1980)
`1`	Mes (basado en uno)
`2`	Día del mes (basado en uno)
`3`	Horas (basados en cero)
`4`	Minutos (basados en cero)
`5`	Segundos (basado en cero)

Nota

El formato de archivo ZIP no admite marcas de tiempo anteriores a 1980.

ZipInfo.compress_type¶: Tipo de compresión para la miembro del archivo.

ZipInfo.comment¶: Comenta para el miembro de archivo individual como un objeto bytes.

ZipInfo.extra¶: Datos de campo de expansión. La PKZIP Application Note contiene algunos comentarios sobre la estructura interna de los datos contenidos en este objeto bytes.

ZipInfo.create_system¶: Sistema que creó el archivo ZIP.

ZipInfo.create_version¶: Versión PKZIP que creó el archivo ZIP.

ZipInfo.extract_version¶: Se necesita la versión PKZIP para extraer el archivo.

ZipInfo.reserved¶: Debe ser cero.

ZipInfo.flag_bits¶: Bits de bandera ZIP.

ZipInfo.volume¶: Número de volumen del encabezado del archivo.

ZipInfo.internal_attr¶: Atributos internos.

ZipInfo.external_attr¶: Atributos de archivo externo.

ZipInfo.header_offset¶: Byte desplazado al encabezado del archivo.

ZipInfo.CRC¶: CRC-32 del archivo sin comprimir.

ZipInfo.compress_size¶: Tamaño de los datos comprimidos.

ZipInfo.file_size¶: Tamaño del archivo sin comprimir.

Interfaz de línea de comandos¶

El módulo zipfile proporciona una interfaz de línea de comandos simple para interactuar con archivos ZIP.

Si desea crear un nuevo archivo ZIP, especifique su nombre después de la opción -c y luego enumere los nombres de archivo que deben incluirse:

$ python -m zipfile -c monty.zip spam.txt eggs.txt

Pasar un directorio también es aceptable:

$ python -m zipfile -c monty.zip life-of-brian_1979/

Si desea extraer un archivo ZIP en el directorio especificado, use la opción -e:

$ python -m zipfile -e monty.zip target-dir/

Para obtener una lista de los archivos en un archivo ZIP, use la opción -l:

$ python -m zipfile -l monty.zip

Opciones de línea de comando¶

-l <zipfile>¶
--list <zipfile>¶: Lista de archivos en un archivo zip.

-c <zipfile> <source1> ... <sourceN>¶
--create <zipfile> <source1> ... <sourceN>¶: Crea el archivo zip a partir de archivos fuente.

-e <zipfile> <output_dir>¶
--extract <zipfile> <output_dir>¶: Extrae el archivo zip en el directorio de destino.

-t <zipfile>¶
--test <zipfile>¶: Prueba si el archivo zip es válido o no.

Problemas de descompresión¶

La extracción en el módulo zipfile puede fallar debido a algunos problemas que se enumeran a continuación.

Del archivo mismo¶

La descompresión puede fallar debido a una contraseña incorrecta / suma de verificación CRC / formato ZIP o método / descifrado de compresión no compatible.

Limitaciones del sistema de archivos¶

Exceder las limitaciones en diferentes sistemas de archivos puede causar que la descompresión falle. Como los caracteres permitidos en las entradas del directorio, la longitud del nombre del archivo, la longitud de la ruta, el tamaño de un solo archivo y la cantidad de archivos, etc.

Limitaciones de recursos¶

La falta de memoria o volumen de disco conduciría a la descompresión fallida. Por ejemplo, las bombas de descompresión (también conocido como ZIP bomb) se aplican a la biblioteca de archivos zip que pueden causar el agotamiento del volumen del disco.

Interrupción¶

La interrupción durante la descompresión, como presionar control-C o matar el proceso de descompresión, puede dar como resultado una descompresión incompleta del archivo.

Comportamientos predeterminados de extracción¶

No conocer los comportamientos de extracción predeterminados puede causar resultados de descompresión inesperados. Por ejemplo, al extraer el mismo archivo dos veces, sobrescribe los archivos sin preguntar.

`zipfile` — Trabajar con archivos ZIP¶

Objetos ZipFile¶

Objetos de ruta¶

Objetos PyZipFile¶

Objetos ZipInfo¶

Interfaz de línea de comandos¶

Opciones de línea de comando¶

Problemas de descompresión¶

Del archivo mismo¶

Limitaciones del sistema de archivos¶

Limitaciones de recursos¶

Interrupción¶

Comportamientos predeterminados de extracción¶

Tabla de contenido

Tema anterior

Próximo tema

Esta página

zipfile — Trabajar con archivos ZIP¶

Objetos ZipFile¶

Objetos de ruta¶

Objetos PyZipFile¶

Objetos ZipInfo¶

Interfaz de línea de comandos¶

Opciones de línea de comando¶

Problemas de descompresión¶

Del archivo mismo¶

Limitaciones del sistema de archivos¶

Limitaciones de recursos¶

Interrupción¶

Comportamientos predeterminados de extracción¶

`zipfile` — Trabajar con archivos ZIP¶