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 abiertos y no se puede usar para leer o escribir directamente el contenido del archivo. En su lugar, lo usas para construir el gráfico de acciones en una función de implementación de reglas pasando a las funciones de creación de acciones. Consulta la
página de 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 cadena tomando el valor de su campo path.
Miembros
basename
string File.basename
Es el nombre base de este archivo. Es el nombre del archivo dentro del directorio.
dirname
string File.dirname
Es el nombre del directorio que contiene este archivo. Se toma de la
ruta de acceso y siempre es relativo al directorio de ejecución.
extension
string File.extension
Es la extensión de archivo de este archivo, después del período más a la derecha (sin incluirlo). Es una cadena vacía si el nombre base del archivo no incluye períodos.
is_directory
bool File.is_directory
Muestra verdadero si es un directorio.
is_source
bool File.is_source
Muestra verdadero si es un archivo fuente, es decir, no se genera.
owner
Label File.owner
Es una etiqueta de un destino que produce este archivo.
Puede mostrar
None.
path
string File.path
Es la ruta de ejecución de este archivo, relativa al directorio de ejecución del espacio de trabajo. Consta de dos partes: una primera parte opcional llamada
root (consulta también el módulo
root) y la segunda parte, que es la
short_path. La raíz puede estar vacía, lo que suele ocurrir con los archivos no generados. Para los archivos generados, suele contener un fragmento de ruta específico de la configuración que codifica elementos como la arquitectura de CPU de destino que se usó mientras se compilaba el archivo. Usa la
short_path para la ruta de acceso en la que se asigna el archivo si está en los archivos de ejecución de un objeto binario.
root
root File.root
Es la raíz debajo de la cual reside este archivo.
short_path
string File.short_path
Es la ruta de acceso de este archivo en relación con su raíz. Esto excluye la
raíz mencionada anteriormente, es decir, los fragmentos de la ruta de acceso específicos de la configuración. También es la ruta de acceso en la que se asigna el archivo si está en los archivos de ejecución de un objeto binario.
tree_relative_path
string File.tree_relative_path
Es la ruta de acceso de este archivo en relación con la raíz del árbol del antecesor, si el campo
is_directory del antecesor es verdadero.
tree_relative_path solo está disponible para los 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.
