콘텐츠로 이동

Tutorial 07

Scripts and Automation

목표

이 튜토리얼은 반복 작업을 파일로 남기고 다시 실행하는 방법을 설명합니다.

핵심 주제:

  • script
  • script-save
  • target set
  • fail-fast 동작

1. 반복 작업은 script로 묶는다

같은 review 절차를 계속 반복해야 한다면 명령을 파일로 저장해 두는 편이 낫습니다.

실행:

hfVisualizer --remote script D:\Work\review.ipc.txt

2. 기본 대상은 target set으로 정한다

스크립트를 돌릴 때마다 --target <id>를 반복하고 싶지 않다면 먼저 기본 대상을 정합니다.

hfVisualizer --remote list
hfVisualizer --remote target set 8f6d1c2b
hfVisualizer --remote script D:\Work\review.ipc.txt

중요한 점:

  • target set은 script 파일 안에 쓰는 명령이 아닙니다.
  • script를 실행하는 바깥 CLI에서 먼저 설정하는 개념입니다.

3. script 파일에는 command tail만 넣는다

script 파일 안에는 hfVisualizer --remote를 반복해서 적지 않습니다.

예시 파일 review.ipc.txt:

open D:\Work\frame.h5.hdb
camera fit
representation both
display-control grid off
write-scene D:\Work\frame.png

4. script-save는 현재 작업 흐름을 저장한다

hfVisualizer --remote script-save D:\Work\last-session.ipc.txt

이 명령은 현재 세션에서 실행된 canonical tail을 *.ipc.txt 형식으로 저장합니다.

저장된 파일은 나중에 다시 script로 실행할 수 있습니다.

5. fail-fast를 기억한다

script는 기본적으로 fail-fast 방식으로 동작합니다.

즉:

  • 파일 안의 어떤 명령에서 오류가 나면
  • 그 지점에서 실행이 멈춥니다.

그래서 script를 만들 때는 다음 원칙이 좋습니다.

  • 앞부분에서 target model과 view 상태를 먼저 안정화한다
  • 뒤로 갈수록 결과 저장이나 화면 캡처를 둔다

6. --view-id는 개별 명령에서만 생각한다

script 안에서도 render view를 명시적으로 겨냥해야 할 수 있습니다.

이때는 해당 명령이 --view-id를 지원하는지 원격 제어 매뉴얼을 먼저 확인하는 것이 좋습니다.

초기 script는 우선 activeRenderView 기반으로 단순하게 만드는 것을 권장합니다.

7. 추천 workflow

  1. GUI나 CLI로 작업을 한 번 수행
  2. script-save로 현재 흐름을 저장
  3. 저장된 *.ipc.txt를 검토하고 불필요한 줄을 정리
  4. 이후에는 script로 재실행

같이 보면 좋은 문서

다음 문서