설치

uv 기반 설치 (권장)

먼저 Python 용 패키지 매니저인 uv 의 설치가 필요하다. uv 설치 페이지 를 참고하여 사용자의 환경에 맞게 설치하도록 한다.

이제 다음과 같은 uv 명령으로 LogLab 을 설치한다.

uv tool install --from git+https://github.com/haje01/loglab.git loglab

참고

만약 기존에 설치된 loglab 을 최신 버전으로 업그레이드하고 싶다면, 다음처럼 진행한다.

uv tool upgrade loglab

소스 코드로 설치

최신 소스 코드를 기반으로 다음처럼 개발용으로 설치도 가능하다.

git clone https://github.com/haje01/loglab
cd loglab
uv venv
source .venv/bin/activate
uv pip install -e .

설치가 잘 되었다면 로그랩의 커맨드라인 툴인 loglab 을 이용할 수 있다. 다음과 같이 입력해보자.

$ loglab

Usage: loglab [OPTIONS] COMMAND [ARGS]...

LogLab 메인 CLI 그룹.

LogLab의 모든 명령어들을 그룹화하는 메인 진입점.

Options:
-v, --verbose  디버깅 정보 출력 레벨 증가 (-v: INFO, -vv: DEBUG)
--help         Show this message and exit.

Commands:
html     랩 파일로부터 HTML 문서를 생성.
object   랩 파일로부터 로그 작성용 코드 객체를 생성.
schema   랩 파일로부터 로그 검증용 JSON 스키마를 생성.
show     랩 파일의 내용을 텍스트 형태로 출력.
verify   실제 로그 파일이 스키마에 맞는지 검증.
version  로그랩의 현재 버전을 표시.

$ loglab
Usage: loglab [OPTIONS] COMMAND [ARGS]...

Options:
-v, --verbose  디버깅 정보 출력 레벨 증가 (-v: INFO, -vv: DEBUG)
--help         Show this message and exit.

Commands:
html     랩 파일로부터 HTML 문서를 생성.
object   랩 파일로부터 로그 작성용 코드 객체를 생성.
schema   랩 파일로부터 로그 검증용 JSON 스키마를 생성.
show     랩 파일의 내용을 텍스트 형태로 출력.
verify   실제 로그 파일이 스키마에 맞는지 검증.
version  로그랩의 현재 버전을 표시.

위에서 알 수 있듯 loglab 에는 다양한 명령어가 있는데 예제를 통해 하나씩 살펴보도록 하겠다. 먼저 간단히 버전을 확인해보자.

$ loglab version
0.3.0