it2는 iTerm2의 Python API를 활용하여 iTerm2 애플리케이션을 제어하는 강력한 커맨드 라인 인터페이스(CLI) 도구입니다. 이 도구는 macOS 환경에서 iTerm2 3.3.0 이상 버전과 Python 3.9 이상이 설치되어 있고 iTerm2의 Python API가 활성화되어 있을 때 작동합니다.

it2의 핵심 기능은 iTerm2 인스턴스와 직접 통신하여 터미널 세션, 윈도우, 탭, 프로파일 등 다양한 요소를 프로그래밍 방식으로 조작하는 것입니다. 이는 iTerm2가 제공하는 내장 Python API를 통해 이루어지며, it2 CLI는 이 API에 대한 편리한 접근 계층을 제공합니다.

핵심 방법론 및 기술적 설명:

it2의 작동 방식은 src/it2/cli.py를 메인 진입점으로 사용하여 Click 프레임워크 기반의 CLI를 구성하고, src/it2/core/connection.py를 통해 iTerm2의 Python API와 연결하는 것에 중점을 둡니다.

1. iTerm2 Python API 연결: it2는 iTerm2가 로컬에서 실행 중인 iTerm2 애플리케이션과 통신하기 위해 제공하는 iterm2.Connection 객체를 활용합니다. 이 연결은 iTerm2가 내부에 호스팅하는 Python 스크립트 환경과 외부 프로세스(여기서는 it2 CLI) 간의 IPC(Inter-Process Communication)를 설정합니다. connection.py 모듈은 이 연결을 초기화하고 유지하며, iTerm2 API의 비동기 특성을 처리하기 위해 asyncio를 사용합니다. 연결이 설정되면, it2는 iterm2.app.App, iterm2.Session, iterm2.Window 등의 객체를 통해 현재 iTerm2 상태에 접근하고 명령을 보낼 수 있습니다.

2. 명령어 구조화:
   • 세션 관리 (it2 session, it2 send, it2 run): iterm2.Session 객체를 통해 텍스트를 전송(write()), 명령어를 실행(async_send_text()), 세션 분할(async_split_pane()), 또는 세션 목록 조회(async_get_sessions()) 등을 수행합니다. send 및 run 명령어는 각각 write() 메서드와 async_send_text() 메서드를 래핑하며, 후자는 텍스트 끝에 개행 문자(newline)를 추가하여 실행을 트리거합니다. --session <id> 또는 --all 옵션을 통해 특정 세션 또는 모든 세션을 대상으로 지정할 수 있으며, 이는 async_get_session_by_id() 또는 async_get_sessions()를 통해 얻은 세션 객체에 명령을 전달하는 방식으로 구현됩니다.
   • 윈도우 및 탭 제어 (it2 window, it2 tab): iterm2.Window 및 iterm2.Tab 객체를 활용하여 윈도우 생성(async_create_window()), 이동(set_dimensions()), 크기 조절(set_dimensions()), 탭 생성(async_create_tab()), 탭 선택(async_select_tab()) 등 GUI와 관련된 조작을 수행합니다. it2 window arrange 기능은 현재 윈도우 배열 상태를 YAML 파일에 저장하거나 복원하는 논리를 포함하여 복잡한 워크플로우를 자동화합니다.
   • 프로파일 관리 (it2 profile): iterm2.profile.Profile 객체를 통해 iTerm2 프로파일을 나열(async_get_profiles()), 적용(async_set_profile()), 또는 특정 속성을 설정(async_set_profile_setting())합니다. 이는 iTerm2의 내부 설정 시스템에 직접 접근하여 폰트 크기, 배경색, 투명도 등 시각적/기능적 설정을 변경할 수 있게 합니다.

3. 모니터링 (it2 monitor): it2는 iTerm2의 이벤트 스트림을 구독하여 실시간으로 터미널 출력을 감시(session.on_output()), 키스트로크를 로깅(session.on_keystroke()), iTerm2 애플리케이션 또는 세션 변수를 추적(app.on_variable_changed(), session.on_variable_changed()), 그리고 쉘 통합을 통해 프롬프트 이벤트를 모니터링합니다. -f (follow) 옵션은 비동기 이벤트 리스너를 유지하면서 새로운 데이터를 지속적으로 스트리밍하는 방식으로 구현됩니다. -p (pattern) 옵션은 수신된 데이터에 대해 정규 표현식(re 모듈) 기반의 필터링을 적용합니다.

4. 설정 관리 (~/.it2rc.yaml): 사용자는 ~/.it2rc.yaml 파일을 통해 사용자 지정 프로파일(profiles) 및 명령어 별칭(aliases)을 정의할 수 있습니다.
   • 프로파일: YAML 구조는 일련의 it2 명령어 시퀀스를 정의하여 복잡한 환경 설정 스크립트를 추상화합니다. 예를 들어, split: vertical은 it2 vsplit과 동일하게 작동하며, pane1: command는 해당 분할된 pane에 특정 명령어를 전송하는 방식으로 파싱됩니다. $it2 load <profile_name>$ 명령어는 이 YAML 정의를 읽어 해당 it2 명령어를 순차적으로 실행합니다.
   • 별칭: aliases 섹션은 긴 it2 명령어를 짧은 사용자 지정 별칭으로 매핑하여 $it2 alias <alias_name>$으로 실행할 수 있게 합니다.

5. 오류 처리: it2는 iTerm2와의 연결 실패(에러 코드 2), 대상(세션/윈도우/탭)을 찾을 수 없는 경우(에러 코드 3), 또는 잘못된 인수(에러 코드 4)와 같은 특정 시나리오에 대해 정의된 종료 코드(sys.exit())를 반환하여 스크립트 또는 자동화 워크플로우에서 오류를 쉽게 감지하고 처리할 수 있도록 합니다.

이러한 기능들은 it2가 iTerm2 사용자들이 복잡한 터미널 환경을 명령줄에서 효율적으로 자동화하고 관리할 수 있도록 지원하는 강력한 도구가 되게 합니다.