arquivo

Informar um problema Ver código-fonte

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, use-o para construir o gráfico de ação em uma função de implementação de regra passando-o para funções de criação de ação. 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.

Participantes

nome de base

string File.basename

O nome base deste arquivo. Esse é o nome do arquivo dentro do diretório.

dirname

string File.dirname

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

extensão

string File.extension

A extensão do arquivo, seguindo (não incluindo) o ponto mais à direita. String vazia se o nome de base do arquivo não incluir pontos.

diretório_is

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 for gerado.

proprietário

Label File.owner

Um rótulo de um destino que produz este 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. Ela consiste em duas partes, uma primeira parte opcional chamada root (consulte também o módulo root) e a segunda parte, que é a short_path. A raiz pode estar vazia, o que normalmente ocorre em arquivos não gerados. Para arquivos gerados, ele geralmente contém um fragmento de caminho específico da configuração que codifica elementos como a arquitetura de CPU de destino usada ao compilar o arquivo. Use o short_path para o caminho em que o arquivo está mapeado se ele estiver nos arquivos de execução de um binário.

raiz

root File.root

A raiz abaixo da qual esse arquivo reside.

caminho_curto

string File.short_path

O caminho desse arquivo em relação à raiz. Isso exclui os raiz mencionados anteriormente, ou seja, os fragmentos específicos do caminho do caminho. Esse também é o caminho no qual o arquivo será mapeado se estiver nos arquivos de execução de um binário.

caminho_árvore_relativo

string File.tree_relative_path

O caminho desse arquivo em relação à raiz da árvore ancestral, caso o campo is_directory do ancestral seja 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.