add-config — 문서 블록의 설정(config)에 키·값 추가하기

add-config — 문서 블록의 설정(config)에 키·값 추가하기

Raku의 문서 시스템은 코드에 달린 Pod 문서를 AST 노드로 표현하는데, 그 블록(RakuAST::Doc::Block)은 자체 설정(config)을 가질 수 있어요. add-config는 그 설정에 키와 값을 하나 추가하는 메서드예요. 마크업 블록(# , =begin 같은)이 가지는 옵션을 AST로 넣을 때 쓰인다고 보면 돼요.

출처: Raku 공식 문서 — add-config

본문

In RakuAST::Doc::Block — 설정에 키·값 추가

$block.add-config(
  'allow',
  RakuAST::QuotedString.new(
    processors => <words val>,
    segments   => (
      RakuAST::StrLiteral.new("B C"),
    )
  )
);

키(key)와 값(value)을 받아서 설정에 추가해요. 값은 문자열이거나 RakuAST 객체여야 해요.

예제를 보면 키는 'allow'라는 문자열이고, 값은 RakuAST::QuotedString.new(...)으로 만든 RakuAST 객체네요. 이 값은 processors => <words val>처럼 워드·값 프로세서를 적용하고, segmentsRakuAST::StrLiteral.new("B C")라는 문자열 조각을 담은 형태예요. 결국 설정값 하나를 AST로 구성해서 넣는 과정이라고 이해하면 돼요.