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 diretamente o conteúdo do arquivo. Em vez disso, ele é usado para construir o gráfico de ações em uma função de implementação de regra, transmitindo-o para funções de criação de ações. Consulte a página
Regras para mais informações.
Quando um File é transmitido para um objeto Args sem usar uma função map_each, ele é convertido em uma string usando o valor do campo path.
Membros
basename
string File.basename
O nome base desse arquivo. Esse é o nome do arquivo dentro do diretório.
dirname
string File.dirname
O nome do diretório que contém esse arquivo. Ele é extraído do
caminho e é sempre relativo ao diretório de execução.
extension
string File.extension
A extensão desse arquivo, seguindo (não incluindo) o período mais à direita. String vazia se o nome base do arquivo não incluir períodos.
is_directory
bool File.is_directory
Retorna verdadeiro se for um diretório.
is_source
bool File.is_source
Retorna verdadeiro se for um arquivo de origem, ou seja, não gerado.
owner
Label File.owner
Um rótulo de um destino que produz esse arquivo.
Pode retornar
None.
path
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
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, ela 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 o
short_path para o caminho em que o arquivo é mapeado se estiver nos arquivos de execução de um binário.
root
root File.root
A raiz abaixo da qual esse arquivo reside.
short_path
string File.short_path
O caminho desse arquivo relativo à raiz. Isso exclui a
raiz mencionada, ou seja, fragmentos específicos da configuração do caminho. Esse também é o caminho em que 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 expandidos 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.
