Archivo

Nocturno · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6
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 identificador de archivo abierto y no se puede usar para leer o escribir directamente el contenido del archivo. En cambio, la usas para construir el gráfico de acciones en una función de implementación de reglas pasándola 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

Nombre del directorio que contiene este archivo. Se toma de path y siempre es relativa al directorio de ejecución.

extensión

string File.extension

Extensión del archivo, después del punto más a la derecha (sin incluirlo). Cadena vacía si el nombre base del archivo no incluye puntos.

is_directory

bool File.is_directory

Devuelve verdadero si se trata de un directorio. Esto refleja el tipo para el que se declaró el archivo (es decir, ctx.actions.declare_directory), no su tipo en el sistema de archivos, que podría ser diferente.

is_source

bool File.is_source

Devuelve verdadero si es un archivo fuente, es decir, no se generó. 

bool File.is_symlink

Devuelve verdadero si se trata de un directorio. Esto refleja el tipo para el que se declaró el archivo (es decir, ctx.actions.declare_symlink), no su tipo en el sistema de archivos, que podría ser diferente.

propietario

Label File.owner

Es la etiqueta de un destino que produce este archivo. Puede devolver None.

ruta de acceso

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 raíz (consulta también el módulo raíz) y la segunda parte, que es el short_path. La raíz puede estar vacía, lo que suele suceder con los archivos no generados. En el caso de 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ó 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 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 el root mencionado anteriormente, es decir, los fragmentos específicos de la configuración de la ruta de acceso. Esta también es la ruta de acceso en la que se asigna el archivo si se encuentra en los runfiles de un archivo 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 elemento superior, si el campo is_directory del elemento superior 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.