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 da 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.
