A biblioteca padrão
Slide 55 de 85
55assetA biblioteca padrão

Onde um programa está

O hive.file também diz onde o programa está, cada resposta um caminho absoluto com / entre as partes em toda plataforma — que toda chamada do módulo aceita, Windows incluído:

  • workingDirectory() é a pasta de onde caminhos relativos são lidos; no hive run, a do ponto de entrada.
  • home() é a pasta pessoal do usuário.
  • executable() é o próprio arquivo do programa em execução — no hive run, a cópia que o compilador construiu.
  • isDir(path) diz se um caminho é uma pasta, onde o exists diz sim para os dois.

As três primeiras respondem com um Result<Str, hive.file.FileError>, NotFound quando o sistema não sabe dizer.

Um programa também pode carregar arquivos próprios. Uma pasta assets/ ao lado do ponto de entrada entra no executável sempre que o programa lê dela, e hive.file.asset(path) lê um arquivo de volta pelo caminho dentro de assets/ — então um programa copiado para qualquer lugar, sem nada ao lado, continua com eles. Um caminho em que a construção não colocou nada é NotFound, e também todo caminho num programa construído sem pasta assets/. Arquivos cujo nome começa com . ou _ ficam de fora.

Onde ele está rodando
proc main(): void {
	if hive.file.workingDirectory() is Result.Ok(here) {
		echo "running in {here}"
	}
	if hive.file.home() is Result.Ok(home) {
		echo "home is {home}"
	}
	if hive.file.executable() is Result.Ok(me) {
		echo "this program is {me}"
	}
	echo hive.file.isDir(".")
}
Um arquivo que ele carrega
proc main(): void {
	// Um arquivo em assets/notes.txt, ao lado deste, entra no programa e
	// é lido de lá para onde quer que o programa seja copiado.
	read := hive.file.asset("notes.txt")
	if read is Result.Ok(notes) {
		echo notes
	} else if read is Result.Error(why) {
		echo why.message
	}
}