A biblioteca padrão
Slide 52 de 85
52--A biblioteca padrão

Anotações de campo

Gramática: field, annotations, annotation
IDENT:typeannotations
field = IDENT ":" type [ annotations ] ;
--annotationannotation
annotations = "--" annotation { annotation } ;Como o compilador lê; o §2.3 da especificação está desatualizado aqui.
JSONURLFlagaskeySTRING;Defaultasliteral;
annotation = ( "JSON" | "URL" | "Flag" ) "as" ( key | STRING ) ";" | "Default" "as" literal ";" ;Como o compilador lê; o §2.3 da especificação está desatualizado aqui.

Um campo pode ser anotado depois de um --, cada cláusula terminando no seu ;, em qualquer ordem. Toda anotação é sobre os codecs — como o campo se chama no fio, e o que ler onde o fio não tem nada — e nenhuma muda o campo do lado do Hive:

  • JSON as <chave>; é a chave de onde o campo é lido e com que é escrito, nas duas direções, então uma ida e volta concorda consigo mesma. Uma chave é o nome de outra pessoa, que não segue nenhuma das formas do Hive: user_name e user-name são chaves, e qualquer outra coisa vai entre aspas, "user name". É também como um campo cuja chave é uma palavra-chave ganha um nome próprio: kind: Str -- JSON as type;.
  • URL as <chave>; e Flag as <nome>; dizem o mesmo para uma query string e para uma flag de linha de comando, uma flag sem os traços — Flag as dry-run; é --dry-run, e Flag as dry-run n; acrescenta -n, o mais curto dos dois nomes sendo o curto.
  • Default as <literal>; é o que ler onde a chave está ausente ou é null: um literal Int, Float, Str, Bool ou Atom que o campo possa guardar, números negativos incluídos. Ele cobre só o que nunca foi dito: um valor do tipo errado continua sendo um erro.

Dois campos atendendo a uma mesma chave em qualquer formato são um erro de compilação, já que o decodificador leria o membro duas vezes. Um campo compartilhado é anotado uma vez para toda variante a que se junta.

As anotações guiam as duas metades
type User {
	name: Str -- JSON as username;
	age: Int
	firstName: Str -- Default as "";
	kind: Str -- JSON as type; Default as "member";
}

proc main(): void {
	// A chave é username nas duas direções, então a ida e volta concorda.
	echo encode(User("ada", 36, "Ada", "admin"), hive.json.codec())

	// firstName e type estão ausentes aqui, e cada Default os substitui.
	if User.decode("\{\"username\":\"ada\",\"age\":36}", hive.json.codec()) is Result.Ok(u) {
		echo "[{u.firstName}] {u.kind}"
	}
}