cangjie-macro

Cangjie macros transform code at compile time by manipulating token streams and using quote expressions. You can define non-attribute and attribute macros to automatically generate boilerplate like toString methods, leveraging the std.ast package for parsing and AST traversal.

Quote expressions in Cangjie metaprogramming allow you to construct token streams dynamically. By using interpolation within quotes, you can embed variables and tokens directly into code templates, enabling flexible compile-time code transformation and AST manipulation.

Yes, nested macros in Cangjie support cross-macro communication. You can pass context and share state between macros using setItem and getChildMessages, allowing coordinated compile-time code generation and diagnostic reporting across multiple macro expansions.

Building an attribute macro package in Cangjie requires using the macro package format alongside the std.ast library for parsing. You define the macro to transform AST nodes at compile time, utilizing diagnostic utilities to report errors during the expansion phase.

You should use Cangjie macros when you need to automate boilerplate generation, such as logging or performance instrumentation, at compile time. By traversing and transforming the AST with std.ast, macros eliminate runtime overhead and reduce manual code maintenance.

Non-attribute macros in Cangjie are invoked like functions, while attribute macros are applied to declarations to transform their AST structure. Both use token streams and quote expressions, but attribute macros allow targeted context passing and code modification for the decorated element.