pathlib.Path.info es una función moderna de la biblioteca estándar de Python creada para hacer más eficiente la clasificación repetida de archivos y directorios. Resulta especialmente útil cuando una aplicación recorre muchas entradas y necesita saber si cada ruta es un archivo, un directorio, un enlace simbólico u otro tipo de objeto.
En esta guía aprenderás para qué sirve Path.info, cómo se diferencia de métodos directos como is_file(), is_dir() y exists(), cuándo la información en caché puede mejorar el rendimiento y qué precauciones evitan decisiones basadas en datos desactualizados.
Para repasar conceptos relacionados, consulta también nuestros artículos sobre pathlib en Python, el módulo os, shutil en Python y glob en Python.
Qué hace Path.info
Path.info ofrece un objeto de información asociado a una ruta. Ese objeto permite consultar el tipo de entrada y puede reutilizar metadatos obtenidos durante la enumeración de un directorio. En muchos sistemas, descubrir si una ruta es archivo o directorio requiere una consulta adicional al sistema operativo.
Cuando esa consulta se repite miles de veces, el coste acumulado puede ser importante. El objeto de información intenta evitar trabajo duplicado cuando los datos ya están disponibles.
Por qué es útil
Las APIs de enumeración de directorios suelen recibir algunos metadatos junto con cada entrada. Los métodos tradicionales pueden efectuar otra llamada aunque la información ya exista. Path.info reduce esa duplicación en flujos adecuados.
La mejora depende de la carga real. Se nota más en carpetas grandes, sistemas de archivos remotos, almacenamiento lento, herramientas de inventario o programas que realizan varias comprobaciones sobre cada entrada.
Ejemplo básico
from pathlib import Path
carpeta = Path("datos")
for ruta in carpeta.iterdir():
info = ruta.info
if info.is_file():
print("archivo:", ruta.name)
elif info.is_dir():
print("directorio:", ruta.name)
El ejemplo mantiene el estilo orientado a objetos de pathlib y clasifica las entradas de forma clara.
Diferencia frente a is_file e is_dir
Los métodos ruta.is_file() y ruta.is_dir() siguen siendo opciones correctas. Consultan el estado de la ruta cuando se ejecutan. La información de ruta.info, en cambio, puede aprovechar valores almacenados en el objeto.
Esta diferencia afecta a la actualidad de los datos. Si el sistema de archivos puede cambiar después de la enumeración, una comprobación directa o la propia operación ofrecen una visión más reciente. Si se clasifica un lote estable inmediatamente después de listarlo, la caché puede reducir trabajo.
Comprender la caché
La caché es la principal fuente de rendimiento y también el principal riesgo. Un archivo puede eliminarse, sustituirse, renombrarse o convertirse en directorio después de obtener sus metadatos.
No trates la información almacenada como una garantía permanente. Antes de operaciones destructivas o sensibles, valida mediante la operación real. Otro proceso, servicio o usuario puede modificar la ruta entre la comprobación y el uso.
Actualizar la observación
Cuando necesites una nueva observación, crea otro objeto Path para la misma ubicación o usa métodos directos. Evita conservar durante mucho tiempo un objeto de información y asumir que representa el estado actual.
from pathlib import Path
ruta = Path("informe.csv")
if ruta.info.is_file():
print("la vista almacenada indica archivo")
actual = Path(ruta)
if actual.is_file():
print("la comprobación nueva también indica archivo")
Enlaces simbólicos
Los enlaces simbólicos requieren una política explícita. Una comprobación puede seguir el enlace y clasificar su destino, mientras otra puede analizar el enlace en sí. Las herramientas de copia, limpieza y sincronización deben decidir si seguirán enlaces.
Seguirlos sin límites puede crear ciclos, acceder fuera de la raíz prevista o procesar archivos no relacionados. En recorridos recursivos, controla la profundidad y las ubicaciones visitadas.
Directorios grandes
En carpetas con decenas de miles de entradas, evitar una consulta de metadatos por elemento puede reducir la latencia. El efecto puede ser mayor en montajes remotos o discos fríos que en un SSD local con caché del sistema.
Mide cargas reales. El resultado depende del sistema operativo, el almacenamiento, la caché del kernel, la red y la estructura del directorio. Usa pruebas de aplicación o timeit en lugar de asumir una mejora universal.
Ejemplo de inventario
from pathlib import Path
def inventario(raiz: Path) -> dict[str, int]:
resultado = {"archivos": 0, "directorios": 0, "enlaces": 0, "otros": 0}
for ruta in raiz.iterdir():
info = ruta.info
if info.is_symlink():
resultado["enlaces"] += 1
elif info.is_file():
resultado["archivos"] += 1
elif info.is_dir():
resultado["directorios"] += 1
else:
resultado["otros"] += 1
return resultado
Este patrón es útil en indexadores, migraciones, paneles administrativos, analizadores de almacenamiento y herramientas de mantenimiento.
Manejo de errores
Las consultas pueden fallar por permisos, rutas eliminadas, unidades desconectadas, enlaces rotos o errores de red. Trata excepciones esperadas como PermissionError y FileNotFoundError alrededor de la unidad de trabajo más pequeña posible.
for ruta in Path("datos").iterdir():
try:
if ruta.info.is_file():
procesar(ruta)
except PermissionError:
registrar("sin permiso", ruta)
except FileNotFoundError:
registrar("entrada eliminada", ruta)
No ocultes excepciones generales sin contexto. Registra la ruta, la operación intentada y el tipo de error.
Condiciones de carrera
Comprobar una ruta y después actuar no es una operación atómica. Una entrada que era archivo puede cambiar antes de abrirse. Este problema se conoce como diferencia entre el momento de comprobación y el momento de uso.
Para acciones críticas, intenta la operación real y trata el fallo. La clasificación previa puede mejorar filtros o mensajes, pero no sustituye un manejo robusto de excepciones.
Seguridad
No uses el tipo de ruta como única validación de contenido subido o no confiable. Comprueba también extensión, tamaño, MIME, firma binaria, permisos y destino cuando corresponda.
Evita traversal de directorios resolviendo la ruta contra una raíz permitida y confirmando que la ubicación final permanece dentro de ella. La caché de tipos no es una frontera de autorización.
Compatibilidad de versiones
Path.info requiere una versión reciente de Python. Las bibliotecas compatibles con versiones anteriores deben detectar su disponibilidad o mantener una alternativa.
def es_archivo(ruta):
info = getattr(ruta, "info", None)
if info is not None:
return info.is_file()
return ruta.is_file()
Consulta la documentación oficial de pathlib para confirmar la API exacta. Las notas oficiales What’s New explican cambios por versión.
Estrategia de pruebas
Incluye archivos regulares, directorios, enlaces, enlaces rotos, permisos denegados, entradas eliminadas y carpetas que cambian rápidamente. Crea una ruta, consúltala, modifica el sistema de archivos y compara la observación almacenada con una nueva.
Las pruebas de rendimiento deben usar tamaños y dispositivos representativos. Un microbenchmark pequeño puede ocultar el beneficio real o exagerarlo.
Uso recursivo
Los recorridos recursivos pueden usar el objeto de información para decidir si descienden en un directorio. Define una política clara para enlaces y considera una profundidad máxima. En árboles no confiables, limita también el número total de entradas y el tiempo de ejecución.
Observabilidad
Los escaneos grandes se benefician de contadores de archivos, directorios, enlaces, entradas omitidas, errores y tiempo total. Estas métricas muestran si la caché mejora el rendimiento y dónde aparecen problemas.
Buenas prácticas
Usa Path.info en recorridos breves donde las entradas se clasifican inmediatamente. Evita conservar objetos durante mucho tiempo en carpetas que cambian continuamente. Maneja errores por entrada para que un elemento inaccesible no cancele todo el lote.
Mide antes de optimizar. Una implementación clara con métodos directos puede ser preferible hasta que el perfil de rendimiento muestre que las consultas de metadatos son importantes. Documenta las suposiciones sobre actualidad.
Cuándo usarlo
Es una buena opción para indexadores, copias de seguridad, sincronización, informes de almacenamiento, herramientas de build, bibliotecas multimedia, migraciones y pipelines de datos. Es menos relevante para scripts pequeños con pocas rutas.
Conclusión
pathlib.Path.info permite reutilizar metadatos del sistema de archivos y reducir consultas repetidas. Complementa los métodos existentes de Path en lugar de reemplazarlos.
La clave consiste en equilibrar velocidad y actualidad. Usa la caché en recorridos controlados, valida de nuevo antes de acciones críticas, trata condiciones de carrera y mide con datos representativos. Así podrás mejorar el rendimiento sin perder claridad ni seguridad.
