std.Decorator#

std.Decorator is a namespace of decorator markers written above family methods. Importing it makes @Decorator.NAME available. The package lists the markers, so @Decorator.NAME is only accepted for a name it exports, and each marker's value is its own name (out(Decorator.private) prints private). Decorators are applied while the program is compiled, so the markers are never called at runtime.

mars

takepkg std.Decorator;

family Stack{
    func init(){ me._items = arr(); }

    @Decorator.private
    func _top_index() => me._items.len() - 1;

    func peek() => me._items.iget(me._top_index());
}

Decorator	Status	Meaning
`@Decorator.private`	Implemented	Callable only from methods of the declaring family
`@Decorator.subclass`	Implemented	Callable from methods of the declaring family and of families inheriting from it
`@Decorator.static`	Planned	Method called on the family, without an instance
`@Decorator.class`	Planned	Method that receives the family
`@Decorator.overload`	Planned	Several functions with one name, chosen by argument types

The markers live in std/Decorator.mars; a marker listed there that the interpreter does not apply yet reports "not implemented yet".

Rules and errors are described under private methods. Using a decorator without importing std.Decorator, an unknown decorator, a planned one, both private and subclass on one method, a private init, or a decorator outside a family is a compile error.