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 de 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 desse arquivo, após (não incluindo) o ponto mais à direita. String vazia se o nome de base do arquivo não inclui pontos.

is_directory

bool File.is_directory

Retorna verdadeiro se for um diretório.

is_source

bool File.is_source

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

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 em que o arquivo está localizado.

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 em que o arquivo é mapeado se ele 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.