Arquivo

Reportar um problema Ver a fonte Nightly · 8.0 7.4 . 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.

Membros

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 o arquivo. Ele é extraído 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 "true" 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 "true" se for um arquivo de origem, ou seja, se não for gerado. 

bool File.is_symlink

Retorna "true" se for um diretório. Isso reflete o tipo que o arquivo foi declarado (ou seja, ctx.actions.declare_symlink), 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 em que o arquivo está localizado.

short_path

string File.short_path

O caminho desse arquivo em relação à raiz. Isso exclui a raiz mencionada anteriormente, ou seja, fragmentos do caminho específicos da configuração. 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 em relação à 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, como Args.add_all(). Para outros tipos de arquivos, é um erro acessar esse campo.