A biblioteca padrão
Slide 54 de 85
54fileA biblioteca padrão

Arquivos

hive.file é o sistema de arquivos. O conteúdo se move como uma Str que guarda bytes, e não texto validado, então um arquivo binário sobrevive intacto a uma ida e volta. Tudo que pode falhar responde com um Result<_, hive.file.FileError>, que é NotFound, Permission, Exists ou Io, cada um carregando o path e uma message:

  • read(path) é o arquivo inteiro; lines(path) suas linhas, um \r\n contando como um fim só, o pedaço vazio depois de uma última quebra de linha descartado e as linhas em branco do meio mantidas.
  • write(path, contents) e append(path, contents) respondem com o número de bytes escritos. Nenhum dos dois cria uma pasta que falta.
  • writeSecret(path, contents) escreve um Secret<Str>, deixando o arquivo legível só por esta conta — modo 0600, ou uma lista de acesso de uma conta só no Windows — acertado antes de qualquer parte do segredo estar nele. Ele protege o arquivo de outros usuários, não de um administrador, e recusa um arquivo de outro dono.
  • copy(from, to) e move(from, to) substituem o que houver em to; move é um renomear, então não atravessa de um disco para outro.
  • delete(path) remove um arquivo ou uma pasta vazia — uma pasta com algo dentro é Exists. makeDir(path) cria a pasta e todas acima dela, e aceita se ela já existir.
  • exists(path) é verdadeiro para um arquivo ou uma pasta; size(path) é em bytes; list(path) são os nomes simples numa pasta, pastas incluídas, em ordem.

Os leitores de tabela — csv, xlsx, ods — também moram aqui, mas falham com um hive.file.TableError próprio, que carrega só um path e uma message.

Escrevendo e lendo
proc main(): void {
	hive.file.makeDir("./out")
	hive.file.write("./out/report.txt", "concluído")
	hive.file.append("./out/report.txt", "\ne concluído outra vez")

	if hive.file.read("./out/report.txt") is Result.Ok(text) {
		echo text
	}
}
Perguntando sobre um arquivo
proc main(): void {
	hive.file.makeDir("./out")
	hive.file.write("./out/report.txt", "concluído")

	echo hive.file.exists("./out/report.txt")
	if hive.file.size("./out/report.txt") is Result.Ok(n) {
		echo n
	}
	if hive.file.list("./out") is Result.Ok(names) {
		echo names
	}
}