identifier

This is the name of the actual keyword. It is a required string that is in the same format as a usual Perl identifier.

get_identifier

  Str Object->get_identifier ()

Returns the name the handler will be setup under.

setup_for

  Object->setup_for (ClassName $class, %args)

This will setup the handler in the specified $class. The handler will dispatch to the "parse_declaration" method when the keyword is used.

A normal code reference will also be exported into the calling namespace. It will either be empty or, if a "generate_export" method is provided, the return value of that method.

parse_declaration

  Object->parse_declaration (Str $filename, HashRef $setup_args, @call_args)

This simply creates a new context and passes it to the "parse" method.

parse

  Object->parse (Object $context)

This method must implement the actual parsing of the keyword syntax.