A biblioteca padrão
Slide 63 de 85
63envA biblioteca padrão

Variáveis de ambiente

hive.env.get(name) responde com um Result<Str, hive.env.EnvironmentError>, já que uma variável que ninguém definiu é um resultado comum e não uma falha. Ele procura nesta ordem, e o primeiro a nomear a chave vence:

  • o arquivo .env ao lado do executável;
  • o da pasta em que o programa foi iniciado — que o hive run faz ser a pasta do ponto de entrada;
  • o .env na pasta acima de qualquer um dos dois;
  • o ambiente do sistema operacional.

Então um valor num .env por perto vence um exportado no shell. O arquivo é lido uma vez, no primeiro get: linhas em branco e comentários com # são pulados, um prefixo export é permitido, e um valor entre aspas perde as aspas. Um .env com qualquer coisa privada pertence a um arquivo que só você pode ler, que o hive.file.writeSecret cria.

hive.env.getSecret(name) é a mesma busca respondendo com um Secret<Str>. O ambiente e o .env ainda o guardam como texto, mas a cópia do próprio programa fica travada e não pode ser impressa.

proc main(): void {
	result := hive.env.get("DATABASE_URL")
	if result is Result.Ok(url) {
		echo "DATABASE_URL é {url}"
	} else if result is Result.Error(why) {
		echo "DATABASE_URL não está definida: {why.message}"
	}
}
Uma variável que é um segredo
proc main(): void {
	if hive.env.getSecret("API_KEY") is Result.Ok(key) {
		echo "API_KEY tem {len(reveal(key))} caracteres"
	}
}