Developer Tools ko

개발자 도구

Unifyl은 파일 매니저를 강력한 개발 워크스테이션으로 변모시키는 포괄적인 개발자 지향 도구 모음을 포함합니다. 이 도구들은 Developer 메뉴에서 접근할 수 있으며 독립된 플로팅 윈도우로 열 수 있습니다.

---

목차

1. 인라인 터미널
   • 변수 삽입
   • 터미널 설정
2. 로그 뷰어
   • 로그 열기
   • 색상 코드 로그 레벨
   • 키워드 필터링과 하이라이트
   • 일시정지, 재개, 자동 스크롤
3. 프로세스 파일 맵
   • 프로세스별 보기
   • 파일별 보기
4. 포트 / 소켓 뷰어
   • 포트 테이블
   • 상세 패널
   • 프로세스 종료
5. SSH 터널 매니저
   • 터널 프로필
   • 터널 시작과 중지
6. Docker 컨테이너 탐색기
   • 컨테이너 목록
   • 파일 브라우저
7. 파일 모니터
   • 이벤트 유형
   • 이벤트 필터링
8. 기능 티어
9. 스크린샷

---

인라인 터미널

Unifyl은 파일 매니저와 긴밀하게 통합된 인라인 터미널을 제공합니다. 명령에서 현재 파일, 디렉터리, 선택 항목을 직접 참조할 수 있는 강력한 변수 삽입 시스템을 지원합니다.

변수 삽입

TerminalVariableExpander는 실행 전에 명령 입력의 특수 $ 토큰을 치환합니다. 모든 경로 값은 작은따옴표로 자동 셸 이스케이프되며, 내부 따옴표는 적절히 이스케이프됩니다.

변수	의미	예시 값
$F	현재(커서) 파일의 전체 경로	'/Users/me/Documents/report.pdf'
$D	현재 디렉터리 경로	'/Users/me/Documents'
$S	선택된 모든 파일 경로의 공백 구분 목록	'/Users/me/a.txt' '/Users/me/b.txt'
$f	파일명만 (확장자 포함)	'report.pdf'
$n	확장자 제외 파일명	'report'
$e	파일 확장자만	pdf

사용 예시

# Open the current file in VS Code
code $F

# Run a script on all selected files
./process.sh $S

# Create a backup of the current file
cp $F $D/$n_backup.$e

# Search for the filename in the current directory
grep -r $f $D

# Convert the current file to a different format
ffmpeg -i $F $D/$n.mp4

변수 확장의 동작 방식

확장기는 이중 확장을 방지하기 위해 단일 패스 치환 알고리즘을 사용합니다.

1. 모든 치환 토큰은 각 문자 위치에서 가장 긴 것부터 가장 짧은 것 순으로 검사됩니다
2. $ 토큰이 일치하면 확장된 값으로 치환됩니다
3. 스캔은 치환 이후 위치부터 계속되며, 확장된 내용을 재스캔하지 않습니다
4. $F가 사용되었으나 선택된 파일이 없으면 빈 문자열로 확장됩니다

터미널 설정

터미널의 외관과 동작은 Settings > Terminal에서 구성할 수 있습니다.

• 글꼴과 크기
• 색상 스킴
• 셸 선택 (zsh, bash, fish 등)
• 작업 디렉터리 동작 (활성 패널 따라가기 또는 고정)

---

로그 뷰어

로그 뷰어는 색상 코드 로그 레벨, 키워드 필터링, 텍스트 하이라이트를 갖춘 실시간 파일 테일링(tail -f와 유사)을 제공합니다. 독립 플로팅 패널로 열립니다.

로그 열기

1. 로그 파일 우클릭 (.log, .txt 또는 임의의 텍스트 파일) > "Open in Log Viewer"
2. 메뉴: Developer > Log Viewer 후 파일 선택
3. Tools 메뉴: Tools > Log Viewer

뷰어는 최소 크기 700x400 픽셀의 윈도우로 열립니다.

색상 코드 로그 레벨

로그 뷰어는 키워드 매칭(대소문자 무관)에 기반하여 로그 레벨을 자동 감지하고 각 라인을 그에 맞게 색상화합니다.

레벨	매칭 키워드	텍스트 색상
Error	ERROR, FATAL, FAIL	빨강
Warning	WARN	주황
Info	INFO	파랑
Normal	(그 외 전부)	기본 레이블 색상

각 라인은 또한 왼쪽에 고정폭 글꼴로 라인 번호를 표시합니다(40pt 폭 열, 우측 정렬, 3차 색상).

키워드 필터링과 하이라이트

툴바에는 실시간 필터링을 제공하는 필터 텍스트 필드가 있습니다.

• Filter: 임의의 텍스트를 입력하여 해당 텍스트를 포함하는 라인만 표시 (대소문자 무관)
• Highlight: 각 라인 내 매칭 텍스트는 노란색 배경 하이라이트(30% 불투명도)를 받습니다
• Count: 필터가 활성화되면 상태 표시줄에 전체 라인 수와 매칭 라인 수가 모두 표시됩니다

예시: 필터 필드에 "timeout"을 입력하면 "timeout"을 포함하는 라인만 표시되고 각 등장 위치가 노란색으로 하이라이트됩니다.

일시정지, 재개, 자동 스크롤

컨트롤	동작
Pause/Resume 버튼	테일링의 일시정지/재개를 토글합니다. 일시정지 상태에서는 파일의 새 데이터가 표시에 추가되지 않습니다. 굵은 주황색 "PAUSED" 표시기가 상태 표시줄에 나타납니다.
Auto-scroll 체크박스	활성화되면 새 라인이 도착할 때 뷰가 자동으로 맨 아래로 스크롤됩니다. 현재 스크롤 위치를 유지하려면 비활성화하십시오.
Clear 버튼	표시에서 모든 라인을 제거합니다 (파일을 수정하지 않습니다).

테일링의 동작 방식

1. 파일을 FileHandle(forReadingFrom:)으로 엽니다
2. 모든 기존 내용을 읽어 라인으로 파싱합니다
3. DispatchSource.makeFileSystemObjectSource가 파일 디스크립터의 .write 및 .extend 이벤트를 모니터링합니다
4. 새 데이터가 도착하면 마지막으로 알려진 오프셋부터 읽어 라인 버퍼에 추가합니다
5. 라인 버퍼는 50,000라인으로 제한되며, 이 한도를 초과하면 오래된 라인이 제거됩니다
6. 뷰가 사라지면 파일 핸들과 디스패치 소스가 정리됩니다

---

프로세스 파일 맵

프로세스 파일 맵은 어떤 프로세스가 어떤 파일 핸들을 열고 있는지, 어떤 파일이 어떤 프로세스에 의해 사용되는지를 보여줍니다. 이 정보를 수집하기 위해 lsof를 사용합니다.

열기

• 메뉴: Developer > Process File Map
• 독립 플로팅 패널로 열림 (최소 850x500 픽셀)

프로세스별 보기

기본 보기 모드입니다. 인터페이스는 두 패널로 분할됩니다.

왼쪽 패널 - 프로세스 목록:

• 각 프로세스는 이름, PID, 열린 파일 수의 뱃지를 표시합니다
• 프로세스는 이름 알파벳순으로 정렬됩니다
• 검색 필드는 프로세스 이름, PID 또는 파일 경로로 필터링합니다
• 카운트 뱃지는 매칭되는 프로세스의 총 수를 표시합니다

오른쪽 패널 - 선택된 프로세스가 연 파일들:

• Type과 Path 두 열을 가진 테이블 표시
• 파일 유형은 색상 코드 뱃지로 표시됩니다:

유형	색상	의미
REG	파랑	일반 파일
DIR	초록	디렉터리
IPv4	주황	IPv4 소켓
IPv6	주황	IPv6 소켓
unix	보라	유닉스 도메인 소켓
PIPE	분홍	파이프
CHR	갈색	캐릭터 디바이스

• 파일 경로는 고정폭 캡션 글꼴로 표시되며, 너무 길면 중간이 잘립니다

파일별 보기

툴바의 세그먼티드 컨트롤로 "By File" 모드로 전환합니다. 이 뷰는 다음을 보여줍니다.

• 상단의 현재 디렉터리 경로
• 그 디렉터리에서 핸들이 열린 파일들의 목록
• 각 파일 항목은 펼치면 이를 사용하는 프로세스를 표시하는 디스클로저 그룹
• 각 프로세스는 이름과 PID를 표시
• 헤더는 핸들이 열린 파일의 총 수를 표시

데이터 로딩

프로세스 파일 맵은 성능 최적화된 플래그로 lsof를 실행합니다.

lsof -n -l -P -u <current_uid> -Fptnc

플래그	목적
-n	DNS/네트워크 주소 해석 건너뛰기
-l	UID-사용자명 변환 건너뛰기
-P	포트 번호-서비스명 변환 건너뛰기
-u	현재 사용자로 제한 (수백 개의 시스템 데몬 생략)
-F	기계 가독성 필드 출력 포맷

---

포트 / 소켓 뷰어

포트 뷰어는 현재 머신에서 LISTEN 상태인 모든 TCP 포트를 보여주며, 해당 포트에 바인딩된 프로세스를 식별하고 종료할 수 있는 기능을 제공합니다.

열기

• 메뉴: Developer > Port / Socket Viewer
• 독립 플로팅 패널로 열림 (최소 850x500 픽셀)

포트 테이블

메인 영역은 다음 열을 가진 정렬 가능한 테이블을 표시합니다.

열	내용
Port	고정폭 세미볼드 글꼴의 포트 번호
Protocol	TCP 또는 UDP 뱃지 (TCP 파란 배경, UDP 주황 배경)
PID	고정폭 캡션 글꼴의 프로세스 ID
Process	프로세스 이름
State	초록 점 표시기를 동반한 상태 (예: "LISTEN")
Address	고정폭 글꼴의 바인딩 주소 (예: *, 127.0.0.1, ::1)

툴바에는 다음이 포함됩니다.

• 포트 번호, 프로세스 이름 또는 PID로 필터링하는 검색 필드
• 재스캔을 위한 새로고침 버튼

상세 패널

오른쪽에는 선택된 포트의 상세 정보가 표시됩니다.

• 포트 번호
• 프로토콜
• PID
• 프로세스 이름
• 상태
• 주소
• 빨간색 Kill Process 버튼

프로세스 종료

"Kill Process"를 클릭하면 확인 대화상자가 나타납니다.

Kill process "<name>" (PID <pid>)?
This will terminate the process listening on port <port>. This action cannot be undone.

"Kill Process"로 확인하거나 취소해야 합니다. 종료는 kill -9 <pid>로 수행됩니다. 성공적인 종료 후 포트 목록은 자동으로 새로고침됩니다.

데이터 소스

포트 뷰어는 다음을 실행합니다.

lsof -iTCP -sTCP:LISTEN -n -P -Fn -Fp -Fc

결과는 포트+PID 조합으로 중복 제거되고 포트 번호 오름차순으로 정렬됩니다.

---

SSH 터널 매니저

SSH 터널 매니저로 Unifyl에서 직접 SSH 포트 포워딩 터널을 만들고, 저장하고, 관리할 수 있습니다.

터널 프로필

각 터널 프로필은 다음을 저장합니다.

필드	설명	기본값
Name	터널의 표시 이름	"New Tunnel"
Local Port	포워딩할 로컬 머신의 포트	8080
Remote Host	대상 호스트 (SSH 서버 관점에서)	"localhost"
Remote Port	원격 호스트의 대상 포트	3306
SSH Server	SSH 서버 호스트명 또는 IP	(비어 있음)
SSH User	SSH 사용자명	(비어 있음)
Use Key Auth	SSH 키 인증 사용 여부	true
Key Path	SSH 개인 키 경로	~/.ssh/id_rsa

프로필은 unifyl.sshTunnelProfiles 키 아래 UserDefaults에 영속화됩니다.

터널 시작과 중지

• 프로필 옆의 Start 버튼을 클릭하여 터널을 설정합니다
• 터널은 -L 플래그로 ssh 명령을 실행하는 자식 Process 인스턴스로 동작합니다
• 상태 메시지가 터널별로 표시됩니다
• Stop을 클릭하여 SSH 프로세스를 종료합니다
• SSH 터널 매니저 윈도우가 닫힐 때 모든 터널이 자동으로 중지됩니다

프로필 만들기와 편집

• + 버튼을 클릭하여 새 프로필을 만듭니다
• 모든 프로필 매개변수를 위한 필드를 가진 시트가 나타납니다
• 기존 프로필을 선택하고 Edit를 클릭하여 편집할 수 있습니다
• Delete 버튼으로 프로필을 삭제합니다

---

Docker 컨테이너 탐색기

Docker 컨테이너 탐색기로 실행 중인 Docker 컨테이너 내부의 파일을 탐색하고 편집할 수 있으며, 백그라운드에서 docker CLI 명령을 사용합니다.

컨테이너 목록

탐색기는 먼저 다음을 실행하여 모든 Docker 컨테이너(실행 중 및 중지)를 나열합니다.

docker ps -a --format "{{.ID}}|{{.Names}}|{{.Image}}|{{.Status}}|{{.Ports}}|{{.CreatedAt}}|{{.State}}"

각 컨테이너 항목은 다음을 표시합니다.

• 컨테이너 이름
• 이미지 이름
• 상태 (running, exited 등)
• 포트 매핑
• 생성 시각

파일 브라우저

실행 중인 컨테이너를 선택하면 Unifyl은 docker exec를 사용해 컨테이너 내부의 파일을 나열합니다.

docker exec <container_id> ls -la <path>

각 파일 항목은 다음을 표시합니다.

• 권한
• 소유자와 그룹
• 크기
• 날짜
• 이름
• 디렉터리 표시기

디렉터리로 들어갈 수 있으며, 파일은 docker cp를 사용해 컨테이너로/에서 복사할 수 있습니다.

---

파일 모니터

파일 모니터는 macOS FSEvents를 사용하여 디렉터리의 파일 시스템 변경을 실시간으로 감시합니다.

이벤트 유형

이벤트 유형	색상	아이콘	설명
Created	초록	plus.circle.fill	새 파일 또는 디렉터리가 생성됨
Modified	노랑	pencil.circle.fill	기존 파일이 수정됨
Deleted	빨강	minus.circle.fill	파일 또는 디렉터리가 삭제됨
Renamed	파랑	arrow.triangle.swap	파일 또는 디렉터리가 이름이 변경됨

이벤트 필터링

• 각 이벤트 유형의 체크박스를 토글하여 특정 카테고리를 표시/숨김
• 이벤트는 타임스탬프와 함께 스크롤 가능한 목록으로 표시됩니다
• 모니터링되는 경로가 툴바에 표시됩니다
• 단일 버튼 클릭으로 모니터링 시작/중지

동작 방식

FileMonitorViewModel은 FSEventStreamRef를 사용해 지정된 디렉터리를 모니터링합니다. 알려진 파일의 스냅샷을 유지하면서 이전 스냅샷과 현재 상태를 비교하여 생성, 삭제, 이름 변경을 감지합니다.

---

기능 티어

도구	티어
인라인 터미널	Free
로그 뷰어	Pro
프로세스 파일 맵	Pro
포트 / 소켓 뷰어	Pro
SSH 터널 매니저	Pro
Docker 컨테이너 탐색기	Pro
파일 모니터	Pro

---

스크린샷

로그 뷰어

색상 코드 로그 레벨(에러는 빨강, 경고는 주황, 정보는 파랑), 툴바의 필터 텍스트 필드, 왼쪽 여백의 라인 번호와 함께 테일링된 로그 파일을 보여주는 로그 뷰어.

포트 / 소켓 뷰어

리스닝 중인 TCP 포트와 관련 프로세스, 프로토콜 뱃지의 테이블을 표시하는 포트 뷰어. 오른쪽 상세 패널은 선택된 포트 정보와 Kill Process 버튼을 표시합니다.

프로세스 파일 맵

"By Process" 모드의 프로세스 파일 맵. 왼쪽에는 파일 수 뱃지가 있는 프로세스 목록, 오른쪽에는 색상 코드 파일 유형 뱃지(REG, DIR, IPv4, unix, PIPE)가 있는 열린 파일 테이블이 표시됩니다.