Arquivo

7.3 · 7.2 · 7.1 · 7.0 · 6.5

Esse objeto é criado durante a fase de análise para representar um arquivo ou diretório que será lido ou gravado durante a fase de execução. Ele não é um identificador de arquivo aberto e não pode ser usado para ler ou gravar o conteúdo do arquivo diretamente. Em vez disso, use-o para construir o gráfico de ações em uma função de implementação de regras transmitindo-o para funções de criação de ações. Consulte a página "Regras" para mais informações.

Quando um File é transmitido a um objeto Args sem usar uma função map_each, ele é convertido em uma string usando o valor do campo path.

basename

string File.basename

O nome base deste arquivo. É o nome do arquivo no diretório.

dirname

string File.dirname

O nome do diretório que contém esse arquivo. Ele é retirado de path e é sempre relativo ao diretório de execução.

extensão

string File.extension

A extensão do arquivo, após (não incluindo) o ponto mais à direita. String vazia se o nome básico do arquivo não incluir pontos.

is_directory

bool File.is_directory

Retorna verdadeiro se for um diretório. Isso reflete o tipo que o arquivo foi declarado (ou seja, ctx.actions.declare_directory), não o tipo no sistema de arquivos, que pode ser diferente.

is_source

bool File.is_source

Retorna verdadeiro se este for um arquivo de origem, ou seja, se ele não for gerado.

is_symlink

bool File.is_symlink

Retorna true se for um diretório. Isso reflete o tipo de arquivo que foi declarado como (ou seja, ctx.actions.declare_symlink), e não o tipo no sistema de arquivos, que pode ser diferente.

proprietário

Label File.owner

Um rótulo de um destino que produz esse arquivo. Pode retornar None.

caminho

string File.path

O caminho de execução desse arquivo, relativo ao diretório de execução do espaço de trabalho. Ele consiste em duas partes: uma primeira parte opcional chamada de raiz (consulte também o módulo raiz) e a segunda parte, que é o short_path. A raiz pode estar vazia, o que geralmente acontece com arquivos não gerados. Para arquivos gerados, ele geralmente contém um fragmento de caminho específico da configuração que codifica itens como a arquitetura de CPU de destino usada durante a criação do arquivo. Use short_path para o caminho em que o arquivo é mapeado, se ele estiver nos arquivos de execução de um binário.

root

root File.root

A raiz abaixo da qual o arquivo reside.

short_path

string File.short_path

O caminho desse arquivo em relação à raiz. Isso exclui o root mencionado acima, ou seja, fragmentos específicos da configuração do caminho. Esse também é o caminho sob o qual o arquivo é mapeado, se estiver nos arquivos de execução de um binário.

tree_relative_path

string File.tree_relative_path

O caminho desse arquivo relativo à raiz da árvore do ancestral, se o campo is_directory do ancestral for verdadeiro. tree_relative_path só está disponível para arquivos abertos de um diretório em um comando de ação, ou seja, Args.add_all(). Para outros tipos de arquivos, é um erro acessar esse campo.