Biome를 당신의 VCS와 통합하는 방법

VCS(Versions Control System, 버전 관리 시스템) 통합은 기본적으로 하나의 VCS만 제공할 수 있는 추가 기능을 활용하기 위해 고안되었습니다.
현재까지 Biome는 단지 Git만 지원합니다.
이 통합은 선택적 활성화(opt-in)입니다.
vcs.enabled를 활성화하고, vcs.clientKind를 Biome 설정 파일에서 지정해야 합니다:

1
{
2
  "vcs": {
3
    "enabled": true,
4
    "clientKind": "git"
5
  }
6
}

이 설정은 자체적으로 아무 것도 수행하지 않습니다. 원하는 기능을 선택적으로 사용해야 합니다.

무시 파일 사용

vcs.useIgnoreFile를 활성화하여, 당신의 VCS 무시 파일에 나열된 모든 파일과 디렉터리를 Biome이 무시하도록 허용하세요.
현재로서는, Biome는 작업 디렉터리의 무시 파일만 인식합니다.

1
{
2
  "vcs": {
3
    "enabled": true,
4
    "clientKind": "git",
5
    "useIgnoreFile": true
6
  }
7
}

변경된 파일만 처리

이 기능은 현재 명령줄 인터페이스(CLI)를 통해만 사용 가능하며, 이전 리비전에서 변경된 파일들만 처리할 수 있게 해줍니다.

먼저, 설정 파일을 업데이트하고, 기본 브랜치를 vcs.defaultBranch 필드를 통해 지정해야 합니다:

1
{
2
  "vcs": {
3
    "enabled": true,
4
    "clientKind": "git",
5
    "useIgnoreFile": true,
6
    "defaultBranch": "main"
7
  }
8
}

다음으로, 명령어에 --changed 옵션을 추가하여, 당신의 VCS가 “변경됨”으로 인식하는 파일들만 처리하세요.
Biome는 해당 브랜치 main과 현재 리비전 기준으로 변경된 파일을 식별합니다:

1
biome check --changed

또는, 임의의 브랜치를 지정하기 위해 --since 옵션을 사용할 수도 있습니다. 이 옵션은 vcs.defaultBranch보다 우선 순위가 높습니다. 예를 들어, next 브랜치에서의 변경 사항을 확인하고 싶다면 다음과 같이 할 수 있습니다:

1
biome check --changed --since=next

스테이징된 파일만 처리

커밋하기 전에, 색인에 추가된 파일(또는 스테이징된 파일, staged files)의 형식과 린트를 검사할 수 있습니다.
명령어에 --staged 옵션을 추가하면, 해당 파일들만 처리합니다:

1
biome check --staged

--staged 옵션은 ci 명령에서는 사용할 수 없습니다. 왜냐하면 컨티뉴어스 인테그레이션**(CI)** 환경에서는 커밋이 예상되지 않기 때문입니다.