Importando um arquivo Go
Gramática: import
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 comoResult<T, Str>; umerrorsozinho comoResult<Bool, Str>,Ok(true)quando énil; e nenhum resultado como umfuncque 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.
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
}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
}
}