Registries

Registry for source-language parsers and reverse code generators.

class crosstl.translator.source_registry.SourceRegistry

Bases: object

Lookup table for source parsers by name, alias, and extension.

extensions()

Return registered source file extensions in sorted order.

Return type:

Sequence[str]

get(name)

Return the source spec registered for a name or alias.

Return type:

Optional[SourceSpec]

get_by_extension(path_or_ext)

Return the source spec registered for a file path or extension.

Return type:

Optional[SourceSpec]

names()

Return registered canonical source names in sorted order.

Return type:

Sequence[str]

register(spec, *, overwrite=False)

Register a source spec and all of its aliases/extensions.

Return type:

SourceSpec

resolve_name(name)

Resolve a source name or alias to its canonical registry name.

Return type:

Optional[str]

class crosstl.translator.source_registry.SourceSpec(name, extensions, load_lexer_parser, reverse_codegen_factory=None, aliases=())

Bases: object

Descriptor for a source language frontend.

A source spec connects file extensions and aliases to a lazily imported lexer/parser pair. Specs can also provide a reverse code generator factory when the source language can be converted back into CrossGL.

parse(code)

Parse source code into that source backend’s AST.

crosstl.translator.source_registry.register_default_sources()

Register the built-in CrossGL and native source frontends.

Return type:

None

Backend registry and alias resolution for CrossGL code generators.

class crosstl.translator.codegen.registry.BackendRegistry

Bases: object

Lookup table for target code generators by backend name and alias.

aliases()

Return a copy of the alias-to-backend mapping.

Return type:

Dict[str, str]

all()

Return all registered backend specs.

Return type:

Iterable[BackendSpec]

get(name)

Return the backend spec registered for a name or alias.

Return type:

Optional[BackendSpec]

names()

Return registered canonical backend names in sorted order.

Return type:

Sequence[str]

register(spec, *, overwrite=False)

Register a backend spec and all of its aliases.

Return type:

BackendSpec

resolve_name(name)

Resolve a backend name or alias to its canonical registry name.

Return type:

Optional[str]

class crosstl.translator.codegen.registry.BackendSpec(name, codegen_class, aliases=(), file_extensions=(), format_backend=None)

Bases: object

Descriptor for a target code generator backend.

crosstl.translator.codegen.registry.backend_names()

Return registered backend names from the global registry.

Return type:

Sequence[str]

crosstl.translator.codegen.registry.get_backend(name)

Return a backend spec from the global registry.

Return type:

Optional[BackendSpec]

crosstl.translator.codegen.registry.get_backend_extension(name)

Return the preferred output extension for a backend, if known.

Return type:

Optional[str]

crosstl.translator.codegen.registry.get_codegen(name)

Instantiate the code generator class for a registered backend.

crosstl.translator.codegen.registry.normalize_backend_name(name)

Resolve a backend name or alias through the global registry.

Return type:

Optional[str]

crosstl.translator.codegen.registry.register_backend(spec, *, overwrite=False)

Register a target backend in the global backend registry.

Return type:

BackendSpec

Plugin discovery helpers for external CrossGL Translator backends.

crosstl.translator.plugin_loader.discover_backend_plugins(force=False)

Discover backend plugin specs under crosstl.backend.

Discovery imports optional backend_spec and source_spec modules from backend packages. Those modules can expose spec constants or a register function to attach additional source parsers and target code generators.

Return type:

None