@spec external_dependencies(schema()) :: [String.t()]

Get a list of external types referenced in a given record/enum.

@spec fqn(schema()) :: String.t()

Get a schema's fully qualified name by combining its namespace and name.

@spec load_schema!(Path.t()) :: schema()

Load a schema from a file.

@spec name(schema()) :: String.t()

Get a schema's name.

@spec namespace(schema()) :: String.t()

Get a schema's namespace.

Note: Unsure what to do if the schema has no namespace - make it a MatchError for now...

@spec path_from_fqn(Path.t(), String.t(), :flat | :tree) :: Path.t()

Resolve a schema's file path from its fqn.

@spec topological_sort([schema()]) :: {:ok, [schema()]} | {:error, any()}

Sort a list of avro schemas in topological order based on dependencies.