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 archivo abierto y no se puede usar para leer ni escribir directamente el contenido del archivo. En su lugar, debes usarlo para construir el gráfico de acciones en una función de implementación de reglas. Para ello, debes pasarlo a funciones que crean acciones. Consulta 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 cadena 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 la
ruta de acceso y siempre es relativa al directorio de ejecución.
extensión
string File.extension
La extensión de archivo de este archivo, después del punto más a la derecha (sin incluir). La cadena está 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 true si se trata de un archivo de origen, es decir, si no se generó.
propietario
Label File.owner
Es una etiqueta de un destino que produce este archivo.
Es posible que se muestre
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 parte opcional llamada
root (consulta también el módulo
root) y la segunda parte que es el
short_path. La raíz puede estar vacía, que suele ser para archivos no generados. Para los archivos generados, generalmente contiene un fragmento de ruta de acceso específico de la configuración que codifica cosas como la arquitectura de la CPU de destino que se usó durante la compilación de dicho archivo. Usa
short_path para la ruta de acceso en la que se asigna el archivo si está en los runfiles de un objeto binario.
raíz
root File.root
Es la raíz debajo de la cual se encuentra 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. Esta también es la ruta de acceso en la que se asigna el archivo si está en los runfiles de un objeto binario.
tree_relative_path
string File.tree_relative_path
La ruta de acceso de este archivo en relación con la raíz del árbol del 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.
