# `filecmp`— Comparaciones de Archivo y Directorio

Código fuente: Lib/filecmp.py

El módulo `filecmp` define funciones para comparar ficheros y directorios, con varias compensaciones de tiempo/corrección. Para comparar ficheros, vea también el módulo `difflib`.

El módulo `filecmp` define las siguientes funciones:

`filecmp.``cmp`(f1, f2, shallow=True)

  Compara los ficheros llamados f1 y f2, retornando `True` si son iguales, `False` en caso contrario.

  Si shallow es verdadero y las firmas `os.stat()` (tipo de fichero, tamaño, y tiempo de modificación) de los dos ficheros son idénticas, los ficheros se consideran iguales

  De lo contrario, los ficheros son tratados como diferentes si sus tamaños o contenidos difieren.

  Note que ningún programa externo es llamado desde esta función, dándole portabilidad y eficiencia.

  La función utiliza un caché para comparaciones pasadas y los resultados, con entradas de caché invalidadas si la información de `os.stat()` para el fichero cambia. El caché entero puede ser limpiado utilizando `clear_cache()`.

`filecmp.``cmpfiles`(dir1, dir2, common, shallow=True)

  Compara los ficheros en los dos directorios dir1 y dir2 cuyos nombres son dados por common.

  Retorna tres listas de nombres de fichero: match, mismatch, errors. match contiene la lista de ficheros que coinciden, mismatch contiene los nombres de aquellos que no, y errors lista los nombres de los ficheros que no deberían ser comparados. Los ficheros son listados en errors si no existen en uno de los directorios, el usuario carece de permisos para leerlos o si la comparación no puede hacerse por alguna razón.

  El parámetro shallow tiene el mismo significado y valor por defecto en cuanto a `filecmp.cmp()`.

  Por ejemplo, `cmpfiles('a', 'b', ['c', 'd/e'])` comparará `a/c` con `b/c` y `a/d/e` con `b/d/e`. `'c'` y `'d/e'` estará cada uno en una de las tres listas retornadas.

`filecmp.``clear_cache`()

  Limpia el caché de filecmp. Esto podría ser útil si un fichero es comparado muy rápido después de que es modificado que está dentro de la resolución mtime del sistema de archivos subyacente.

  Nuevo en la versión 3.4.

## La clase `dircmp`

class `filecmp.``dircmp`(a, b, ignore=None, hide=None)

  Construye un nuevo objeto de comparación de directorio, para comparar los directorios a y b. ignore es una lista de nombres a ignorar, y predetermina a `filecmp.DEFAULT_IGNORES`. hide es una lista de nombres a ocultar, y predetermina a `[os.curdir, os.pardir]`.

  La clase `dircmp` compara ficheros haciendo comparaciones shallow como está descrito en `filecmp.cmp()`.

  La clase `dircmp` provee los siguientes métodos:

  `report`()

    Imprime (a `sys.stdout`) una comparación entre a y b.

  `report_partial_closure`()

    Imprime una comparación entre a y b y subdirectorios inmediatos comunes.

  `report_full_closure`()

    Imprime una comparación entre a y b y subdirectorios comunes (recursivamente).

  La clase `dircmp` ofrece un número de atributos interesantes que pueden ser utilizados para obtener varios bits de información sobre los árboles de directorio que están siendo comparados.

  Note que vía los hooks `__getattr__()`, todos los atributos son perezosamente computados, así que no hay penalización de velocidad si sólo esos atributos que son ligeros de computar son utilizados.

  `left`

    El directorio a.

  `right`

    El directorio b.

  `left_list`

    Ficheros y subdirectorios en a, filtrados por hide e ignore.

  `right_list`

    Ficheros y subdirectorios en b, filtrados por hide e ignore.

  `common`

    Ficheros y subdirectorios en a y b.

  `left_only`

    Ficheros y subdirectorios sólo en a.

  `right_only`

    Ficheros y subdirectorios sólo en b.

  `common_dirs`

    Subdirectorios en a y b.

  `common_files`

    Ficheros en a y b.

  `common_funny`

    Nombres en a y b, de forma que el tipo difiera entre los directorios, o los nombres por los que `os.stat()` reporta un error.

  `same_files`

    Ficheros que son idénticos en a y b, utilizando el operador de comparación de fichero de la clase.

  `diff_files`

    Ficheros que están en a y b, cuyos contenidos difieren acorde al operador de comparación del fichero de clase.

  `funny_files`

    Ficheros que están en a y b, pero no deberían ser comparados.

  `subdirs`

    Un diccionario que asigna nombres en `common_dirs` a instancias `dircmp` (o instancias MyDirCmp si esa instancias es del tipo MyDirCmp, una subclase de `dircmp`).

    Distinto en la versión 3.10: Anteriormente las entradas siempre eran instancias `dircmp`. Ahora son del mismo tipo que self, si self es una subclase de `dircmp`.

`filecmp.``DEFAULT_IGNORES`

  Nuevo en la versión 3.4.

  Lista de directorios ignorados por `dircmp` por defecto.

Aquí hay un ejemplo simplificado de uso del atributo `subdirs` para buscar recursivamente a través de dos directorios para mostrar diferentes ficheros comunes:

    >>> from filecmp import dircmp
    >>> def print_diff_files(dcmp):
    ...     for name in dcmp.diff_files:
    ...         print("diff_file %s found in %s and %s" % (name, dcmp.left,
    ...               dcmp.right))
    ...     for sub_dcmp in dcmp.subdirs.values():
    ...         print_diff_files(sub_dcmp)
    ...
    >>> dcmp = dircmp('dir1', 'dir2')
    >>> print_diff_files(dcmp)