편집기 확장에 Biome 통합하기

Biome는 LSP를 최초 지원합니다. 편집기가 LSP를 구현하고 있다면, Biome와의 통합은 완벽할 것입니다.

LSP 프록시 사용하기

Biome에는 lsp-proxy라는 명령어가 있습니다. 실행 시 다음과 같은 두 가지 프로세스가 생성됩니다:

요청된 작업을 수행하는 daemonic 프로세스;
클라이언트(편집기)의 요청과 서버(데몬) 사이에서 중계 역할을 하는 서버;

편집기가 JSON-RPC 요청을 수신하고 처리할 수 있다면, 해당 명령어를 실행하여 편집기를 구성하면 됩니다.

이 과정을 neo-vim biome extension이 어떻게 수행하는지 확인할 수 있습니다.

`stdin` 사용하기

편집기가 LSP를 지원하지 않는 경우, 직접 biome 바이너리를 사용하고 표준 입력을 통해 호출하세요.

다음 명령어들은 표준 입력을 통해 호출할 수 있습니다:

Biome는 새 출력 결과(또는 변경 사항이 없으면 원래 출력)를 표준 출력에 반환하고 진단 정보를 표준 오류에 전달합니다.

stdin을 사용할 때는 반드시 --stdin-file-path 옵션을 전달해야 합니다. 파일의 경로가 시스템 파일 내에 존재할 필요는 없습니다. 이름은 임의로 지정해도 무방합니다. 중요한 점은 올바른 파일 확장자를 제공하여, Biome가 당신의 파일을 어떻게 처리할 것인지 알 수 있도록 해야 한다는 것입니다.

편집기의 책임은 바이너리 경로를 찾고 해결한 후, 필요한 시점에 호출하는 것입니다. 바이너리는 우리가 지원하는 아키텍처 및 운영체제에 따라 npm에 배포됩니다:

@biomejs/cli-darwin-arm64
@biomejs/cli-darwin-x64
@biomejs/cli-linux-arm64
@biomejs/cli-linux-x64
@biomejs/cli-win32-arm64
@biomejs/cli-win32-x64

바이너리 이름은 biome 또는 biome.exe이며, 라이브러리의 루트 디렉터리에 위치해 있습니다. 예를 들어: @biomejs/cli-darwin-arm64/biome, @biomejs/cli-win32-x64/biome.exe.

바이너리와 함께 데몬 사용하기

명령줄 인터페이스를 통해 바이너리를 사용하는 것은 매우 효율적이지만, 사용자에게 로그를 제공할 수는 없습니다. CLI는 데몬을 시작한 후, 해당 데몬을 통해 명령줄 명령어를 실행할 수 있게 해줍니다.

그렇기 위해 먼저 start 명령어로 데몬 프로세스를 시작해야 합니다:

1
biome start

그 후, 각 명령어는 --use-server 옵션을 추가해야 합니다. 예를 들어:

1
echo "console.log('')" | biome format --use-server --stdin-file-path=dummy.js

데몬 로그

Biome의 데몬은 로그를 자체 파일 시스템에 저장합니다. 로그는 biome-logs라는 폴더에 저장되며, 이 폴더의 경로는 운영체제에 따라 다릅니다:

리눅스: ~/.cache/biome;
윈도우: C:\Users\<UserName>\AppData\Local\biomejs\biome\cache
맥OS: /Users/<UserName>/Library/Caches/dev.biomejs.biome

기타 운영체제의 경우, 시스템 임시 디렉터리에서 해당 폴더를 찾을 수 있습니다.

정확한 경로를 확인하려면 다음 명령어를 실행하세요:

1
biome explain daemon-logs

로그 파일은 매시간 회전됩니다.