Módulos, testes e leis
Slide 41 de 85
41.goMódulos, testes e leis

Importando um arquivo Go

Gramática: import
importPATHasIDENT
import = "import" PATH [ "as" IDENT ] ;

O Hive compila para Go, então um arquivo Go ao lado de um Hive pode ser chamado diretamente por ele: import ./lib/measures.go. O .go é obrigatório — o contrário do .hive de um módulo Hive, que nunca é escrito — então um import nunca deixa dúvida sobre qual das duas linguagens você vai abrir.

Todo valor é copiado em profundidade nas duas direções, que é o sentido da fronteira: uma função Go pode ordenar a slice que recebeu, guardá-la ou escrever nela depois, e nada disso alcança o valor Hive de onde ela veio. É também por isso que uma função Go importada chega como um func.

Só o que o Go exporta é alcançável. Uma função é alcançada com a primeira letra em minúscula — Grams é measures.grams — uma struct mantém o nome e põe em minúscula a primeira letra dos campos, e as assinaturas são lidas pelo próprio Go em vez de adivinhadas. O que atravessa:

  • string, int, float64, bool, []T, [][]string, um map com chave escalar — cujas chaves chegam ordenadas, já que um map Go não tem ordem — e uma struct que o arquivo exporta;
  • (T, error), que chega como Result<T, Str>; um error sozinho como Result<Bool, Str>, Ok(true) quando é nil; e nenhum resultado como um func que não responde nada.

Um ponteiro, um canal, uma interface, um valor de função, um parâmetro variádico, int64, um array de tamanho fixo, um campo de struct não exportado ou embutido, ou um tipo de outro pacote é recusado, nomeando o parâmetro que não pôde receber. Toda função exportada do arquivo precisa atravessar, chamada ou não, e a primeira que não consegue é a reportada. Um arquivo Go que importa um pacote de fora da biblioteca padrão do Go faz a build buscá-lo, uma vez, com go mod tidy.

lib/measures.go
package measures

import (
	"fmt"
	"strings"
)

// Todo campo deste struct cruza a fronteira, então o struct inteiro cruza.
type Weight struct {
	Grams int
	Label string
}

// Exportado, então o Hive o alcança com a inicial minúscula: measures.grams.
func Grams(w Weight) int {
	return w.Grams
}

// A forma do Go de reportar falha é a do Hive: (T, error) é Result<T, Str>.
func Parse(s string) (Weight, error) {
	if !strings.HasSuffix(s, "g") {
		return Weight{}, fmt.Errorf("%q does not end in g", s)
	}
	return Weight{Grams: len(s) * 100, Label: s}, nil
}
main.hive, ao lado dele
import ./lib/measures.go

proc main(): void {
	tool := measures.Weight(899, "Hive tool")
	echo measures.grams(tool)

	parsed := measures.parse("450g")
	if parsed is Result.Ok(w) {
		echo "{w.label}: {w.grams}"
	} else if parsed is Result.Error(why) {
		echo why
	}
}