A biblioteca padrãoSlide 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\ncontando 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)eappend(path, contents)respondem com o número de bytes escritos. Nenhum dos dois cria uma pasta que falta.writeSecret(path, contents)escreve umSecret<Str>, deixando o arquivo legível só por esta conta — modo0600, 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)emove(from, to)substituem o que houver emto;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
}
}