Valence.Typespec (valence v1.0.0)

Copy Markdown View Source

Boundary gradual: extrai @type/@spec do AST (mesmo fonte que a IDE vê) e converte tipos de typespec para Valence.Type.

Nada de Code.Typespec sobre beam: aqui o tipo tem que existir antes de compilar, e o source é a única fonte de verdade.

Summary

Functions

Nome do módulo a partir do alias do defmodule (Accounts.User).

Spec de um módulo importado (import Ecto.Changeset + cast/3).

Indexa uma ou mais fontes: %{modules: %{nome => %Module{}}, structs: %{}}.

Nome completo de um módulo referenciado no código: resolve alias do módulo atual (Producer → MyApp.Producers.Producer).

Como spec/4, mas só o @spec do source (definição local do módulo).

Resolve um AST de typespec em Valence.Type.t/0.

Assinatura resolvida de mod.name/arity, ou nil.

Tipo declarado mod.name/arity resolvido, ou nil.

Functions

alias_name(atom)

Nome do módulo a partir do alias do defmodule (Accounts.User).

imported_spec(index, mod, name, arity)

Spec de um módulo importado (import Ecto.Changeset + cast/3).

Phoenix importa Ecto.Changeset inteiro; sem isso, toda validação de changeset no projeto real cairia em dynamic(). Resolve com o módulo dono da spec (t() continua Ecto.Changeset.t()).

index(sources)

Indexa uma ou mais fontes: %{modules: %{nome => %Module{}}, structs: %{}}.

structs recebe os schemas declarados por macro (use Valence.Schema e use Ecto.Schema), porque esses tipos não existem no source — a macro os gera em tempo de compilação. O Ecto é lido estaticamente por Valence.Surfaces.Ecto, com as associações resolvidas depois que todos os módulos do índice são conhecidos (um schema pode referenciar outro arquivo).

module_name(index, current, parts)

@spec module_name(map(), String.t(), [atom()] | String.t()) :: String.t()

Nome completo de um módulo referenciado no código: resolve alias do módulo atual (Producer → MyApp.Producers.Producer).

own_spec(index, mod, name, arity)

Como spec/4, mas só o @spec do source (definição local do módulo).

resolve(index, mod, ast, stack \\ [])

Resolve um AST de typespec em Valence.Type.t/0.

spec(index, mod, name, arity)

Assinatura resolvida de mod.name/arity, ou nil.

Ordem de resolução: @spec do source → spec do .beam do módulo compilado → callbacks do behaviour que o módulo declara com use (é o que tipa MeuRepo.all/2 a partir de Ecto.Repo).

Se a spec declara mais parâmetros do que a chamada (argumento com default), os extras são ignorados — heurística explícita, não precisão falsa.

type(index, mod, name, arity)

Tipo declarado mod.name/arity resolvido, ou nil.