멘션

Triagebot은 특정 파일을 건드리는 풀 리퀘스트에 댓글을 남길 수 있습니다. 이는 해당 파일에 대한 변경 사항을 검토하고 싶어 하는 사람들에게 알리거나, 작성자에게 안내 메시지를 제공하는 데 유용할 수 있습니다.

사용법

멘션은 저장소의 triagebot.toml 설정에 따라 풀 리퀘스트가 열릴 때(또는 새 변경 사항이 푸시될 때) 자동으로 트리거됩니다.

설정

멘션을 활성화하려면 triagebot.toml의 [mentions] 테이블에 항목을 추가하십시오.

테이블의 각 키는 저장소 내 경로이거나(type="content"인 경우) 문자열이어야 합니다. 자세한 내용은 아래 전용 절을 참고하십시오.

테이블에 지정할 수 있는 선택적 값은 네 가지입니다.

• type — 충족되어야 하는 매칭 유형을 지정하며, filename(기본값) 또는 content 중 하나입니다.
• trigger_files — type = "content" 멘션의 경우, 콘텐츠 매칭을 지정된 파일 글롭 배열로만 제한합니다.
• cc — 알림을 보낼 사용자들의 문자열 목록입니다. 이들은 @ehuss나 @rust-lang/clippy처럼 @로 시작해야 합니다. 이것이 지정되지 않으면 아무도 알림을 받지 않습니다.
• message — 댓글에 포함될 메시지입니다. 이것이 지정되지 않으면 댓글에는 Some changes occurred in {path}라고 표시됩니다.

경로 기반 멘션

기본적으로 triagebot은 주어진 UNIX 스타일 경로로 시작하는¹ 모든 파일을 확인합니다. type="filename"으로 명시적으로 요청할 수 있습니다.

글롭 매칭은 다음 구문을 지원합니다.

• ?는 임의의 한 문자와 일치합니다.
• *는 0개 이상의 문자와 일치합니다.
• **는 디렉터리를 재귀적으로 매칭합니다.
• {a,b}는 a나 b 중 하나와 일치하며, 여기서 a와 b는 임의의 글롭 패턴입니다.
• [ab]는 a 또는 b와 일치하며, 여기서 a와 b는 문자입니다. [!ab]는 a와 b를 제외한 모든 문자와 일치합니다.

예를 들어 library/std(또는 library/std*)는 library/std/src/process.rs처럼 library/std 디렉터리 아래의 모든 것과 일치합니다.

콘텐츠 기반 멘션

선택적으로 triagebot은 type="content"로 풀 리퀘스트에 추가된 모든 줄을 확인할 수 있습니다.

이 경우 키는 찾아야 할 콘텐츠입니다.

예시

[mentions."src/tools/cargo"]
cc = ["@ehuss"]

[mentions."src/rustdoc-json-types"]
message = """
rustdoc-json-types is a **public** (although nightly-only) API.
If possible, consider changing `src/librustdoc/json/conversions.rs`;
otherwise, make sure you bump the `FORMAT_VERSION` constant.
"""

[mentions."#[rustc_attr]"]
type = "content"
cc = ["@someone"]

[mentions."miri"]
type = "content"
trigger_files = ["library"]
message = """
Any special-casing of Miri in the standard library requires review.
"""
cc = ["@rust-lang/miri"]

구현

src/handlers/mentions.rs를 참고하십시오.

1. 시작하는 것을 구현하기 위해, 경로 끝에 암묵적인 글롭 *가 추가됩니다. ↩