macros

package
v0.11.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 1, 2026 License: Apache-2.0 Imports: 5 Imported by: 0

Documentation

Overview

Package macros extends the compiler with a @macro engine.

A @macro directive stores a declaration; OnPreprocess turns each declaration into a PrimaryExtension dispatching on TokAtPrompt; and every expansion re-enters the parser with the caller's arguments substituted into the body.

Typical use: 

@macro greet(name) { const @{ value: $name } }
@greet("World")   // expands to: const @{ value: "World" }

Without this bundle, @name is "unexpected token @name".

Index

Constants

View Source 
const DeclarationKey = "macros"

DeclarationKey is the meta slot where @macro declarations land before OnPreprocess converts them to a PrimaryExtension.

View Source 
const ID = "macros"

Variables

View Source 
var Directive = core.Directive{
	Name:    "macro",
	Example: "@macro greet(name) {\n  const @{ value: $name }\n}",
	Handler: handleDirective,
}

Directive parses `@macro name(p1, p2) { body }` into a Declaration appended to meta[DeclarationKey]. Duplicate names are a compile error, not a silent override.

Functions

func Bundle 

func Bundle(_ map[string]string) core.Bundle

Types

type Declaration 

type Declaration struct {
	Name   string
	Params []string
	Body   string
}

Declaration is the parsed form of `@macro name(params) { body }`.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.