Archivo

Informa un problema Ver la fuente

Este objeto se crea durante la fase de análisis para representar un archivo o directorio que se leerá o escribirá durante la fase de ejecución. No es un controlador de archivos abierto y no se puede usar para leer ni escribir contenido de archivos directamente. En su lugar, la usará para construir el gráfico de acción en una función de implementación de reglas pasándola a las funciones de creación de acciones. Consulte la página Reglas para obtener más información.

Cuando se pasa un File a un objeto Args sin usar una función map_each, se convierte en una string mediante el valor de su campo path.

Miembros

nombre base

string File.basename

El nombre base de este archivo. Este es el nombre del archivo dentro del directorio.

dirname

string File.dirname

El nombre del directorio que contiene este archivo. Se toma de path y siempre está relacionado con el directorio de ejecución.

extensión

string File.extension

Es la extensión de este archivo que sigue (sin incluir) el período que se encuentra más a la derecha. String vacía si el nombre base del archivo no incluye puntos.

is_directory

bool File.is_directory

Muestra true si se trata de un directorio.

is_source

bool File.is_source

Muestra verdadero si se trata de un archivo de origen, es decir, no se genera.

propietario

Label File.owner

Es una etiqueta de un destino que produce este archivo. Puede mostrar None.

ruta de acceso

string File.path

La ruta de ejecución de este archivo, en relación con el directorio de ejecución del lugar de trabajo. Consta de dos partes, una primera opcional llamada root (consulta también el módulo root) y la segunda, short_path. La raíz puede estar vacía, lo que suele ocurrir con los archivos no generados. En el caso de los archivos generados, por lo general contiene un fragmento de ruta de configuración específico que codifica cosas como la arquitectura de CPU de destino que se usó durante la compilación de dicho archivo. Usa el short_path para la ruta en la que se asigna el archivo si está en los archivos de ejecución de un objeto binario.

root

root File.root

La raíz bajo la que reside este archivo

ruta_corta

string File.short_path

Es la ruta de acceso de este archivo en relación con su raíz. Esto excluye la raíz antes mencionada, es decir, los fragmentos específicos de la configuración de la ruta de acceso. También es la ruta debajo de la cual se asigna el archivo si está en los archivos de ejecución de un objeto binario.

ruta_relativa_árbol

string File.tree_relative_path

Es la ruta de acceso de este archivo en relación con la raíz del árbol principal, si el campo is_directory del principal es verdadero. tree_relative_path solo está disponible para archivos expandidos de un directorio en un comando de acción, es decir, Args.add_all(). Para otros tipos de archivos, es un error acceder a este campo.