루아에서 `debug` 라이브러리는 어떤 기능을 제공하나요?

FAQ: Lua `debug` 라이브러리

Q1: Lua `debug` 라이브러리란 무엇인가요?
A1:
- Lua 스크립트 실행 환경을 동적으로 조사하고 제어할 수 있는 표준 라이브러리입니다.
- 호출 스택, 로컬 변수, 업값, 함수 소스 코드 위치 등을 읽거나 수정할 수 있게 해 줍니다.

Q2: `debug.getinfo` 함수는 어떤 정보를 제공하나요?
A2:
- 함수나 스택 프레임에 대한 메타 정보를 반환합니다.
- 반환 필드:
• source: 함수가 정의된 파일이나 문자열
• short_src: 간략화된 소스 이름
• linedefined, lastlinedefined: 함수 정의 시작·끝 행 번호
• what: “Lua”, “C”, “main” 등 스레드 타입
• name, namewhat: 호출 연관 이름 정보(가능할 경우)
- 사용 예: `debug.getinfo(2, "nSl")` — 호출자 정보 출력

Q3: 로컬 변수나 파라미터를 읽고 쓸 수 있는 방법은?
A3:
- debug.getlocal(arena, index): 특정 스택 레벨(arena)의 index번째 로컬 변수 이름과 값을 반환
- debug.setlocal(arena, index, value): 해당 위치에 값을 할당
- 활용: 디버거, 프로파일러, 런타임 패치 도구

Q4: 클로저의 업값(upvalue)을 다루려면?
A4:
- debug.getupvalue(func, n): 클로저 func의 n번째 업값 이름과 값을 반환
- debug.setupvalue(func, n, value): n번째 업값에 value를 할당
- 활용: 함수 간 상태 공유 조사, 동적 함수 수정

Q5: `debug.traceback`의 용도는 무엇인가요?
A5:
- 현재 스택 트레이스를 문자열로 반환하거나 출력합니다.
- 인자: (thread?, message?, level?) - 예: `print(debug.traceback("Error occurred", 2))` — 에러 메시지와 호출 경로 확인

Q6: 실행 중인 코드에 훅(hook)을 거는 방법은?
A6:
- debug.sethook([thread,] hook, mask, count)
• hook: 호출될 콜백 함수
• mask: “c”(호출/리턴), “r”(루틴 리턴), “l”(라인 실행) 중 선택 조합
• count: 명령어 실행 횟수 기준 훅 트리거
- debug.gethook, debug.gethookcount, debug.gethookmask로 조회 가능
- 활용: 프로파일링, 코드 커버리지, 동적 로깅

Q7: 레지스트리(registry)는 무엇이며 어떻게 사용하나요?
A7:
- debug.getregistry(): Lua VM 내부 레지스트리 테이블을 반환
- C API에서 전역 테이블처럼 특정 데이터 저장용
- 일반 Lua 코드에서는 잘 사용되지 않으나, 모듈 간 전역 상태 공유 가능

Q8: `debug.debug` 함수는 어떤 일을 하나요?
A8:
- REPL(read–eval–print loop) 형태의 대화형 디버깅 세션을 시작
- 프롬프트에서 Lua 코드를 입력·실행하며 즉석에서 상태 조사 가능
- 주로 개발 중 인터랙티브 디버깅 용도로 사용

Q9: `debug` 라이브러리 사용 시 주의할 점은 무엇인가요?
A9:
- 성능 오버헤드: 훅 설정, 정보 조회 등은 실행 속도를 크게 저하시킬 수 있음
- 보안 위험: 런타임 코드 구조를 자유롭게 조작 가능하므로 신뢰할 수 없는 코드와 함께 사용 금지
- 호환성: Lua 버전에 따라 반환 필드나 동작이 달라질 수 있음

Q10: 언제 `debug` 라이브러리를 사용하면 좋은가요?
A10:
- 복잡한 버그 추적, 프로파일링, 코드 커버리지 분석
- 런타임 패치, 핫스와핑(hot-swapping) 기능 구현
- 자체 디버거나 개발 도구 제작 시

루아(Lua)에서 `debug` 라이브러리는 주로 디버깅과 관련된 기능을 제공하는 모듈입니다.

이 라이브러리는 프로그래머가 코드의 실행 상태를 검사하고, 오류를 추적하며, 성능을 분석하는 데 유용한 도구들을 포함하고 있습니다.

`debug` 라이브러리는 루아의 표준 라이브러리 중 하나로, 디버깅을 위한 다양한 함수들을 제공합니다.

아래에서는 `debug` 라이브러리의 주요 기능과 사용 방법에 대해 자세히 설명하겠습니다.

1. 스택 검사 `debug` 라이브러리는 현재 실행 중인 함수 호출 스택을 검사할 수 있는 기능을 제공합니다.

이를 통해 함수 호출의 순서와 각 함수의 상태를 확인할 수 있습니다.

- `debug.getinfo()` : 특정 스택 레벨의 함수에 대한 정보를 반환합니다.

이 함수는 함수의 이름, 파일 이름, 행 번호, 매개변수 수, 반환 값 수 등 다양한 정보를 제공합니다.

- `debug.getstack()` : 현재 스택의 특정 레벨에 대한 정보를 반환합니다.

이 정보를 통해 호출 스택의 구조를 이해할 수 있습니다.



2. 변수 검사 `debug` 라이브러리는 변수의 상태를 검사하고 조작할 수 있는 기능도 제공합니다.

- `debug.getlocal()` : 특정 함수의 로컬 변수를 가져옵니다.

이 함수는 스택 레벨과 변수의 인덱스를 인자로 받아 해당 로컬 변수의 이름과 값을 반환합니다.

- `debug.setlocal()` : 특정 함수의 로컬 변수를 설정합니다.

이 함수는 스택 레벨과 변수의 인덱스를 인자로 받아 새로운 값을 설정할 수 있습니다.

- `debug.getupvalue()` : 특정 함수의 상위 변수를 가져옵니다.

이 함수는 함수와 인덱스를 인자로 받아 해당 상위 변수의 이름과 값을 반환합니다.

- `debug.setupvalue()` : 특정 함수의 상위 변수를 설정합니다.

이 함수는 함수와 인덱스를 인자로 받아 새로운 값을 설정할 수 있습니다.



3. 오류 처리 `debug` 라이브러리는 오류를 추적하고 처리하는 데 유용한 기능을 제공합니다.

- `debug.traceback()` : 오류가 발생했을 때 호출 스택의 정보를 문자열 형태로 반환합니다.

이 함수는 디버깅 시 오류의 원인을 파악하는 데 매우 유용합니다.



4. 성능 분석 `debug` 라이브러리는 성능 분석을 위한 기능도 제공합니다.

- `debug.sethook()` : 특정 이벤트(예: 함수 호출, 반환, 라인 실행 등)에 대한 후크를 설정할 수 있습니다.

이를 통해 코드의 실행 흐름을 추적하고 성능을 분석할 수 있습니다.

- `debug.gethook()` : 현재 설정된 후크 정보를 반환합니다.



5. 기타 기능 - `debug.debug()` : 디버거를 시작합니다.

이 함수는 루아의 디버깅 세션을 시작하여 사용자가 직접 코드를 검사하고 조작할 수 있는 환경을 제공합니다.

- `debug.getregistry()` : 루아의 레지스트리 테이블을 반환합니다.

레지스트리는 루아의 전역 상태를 관리하는 데 사용됩니다.

사용 예시 아래는 `debug` 라이브러리를 사용하는 간단한 예시입니다.

```lua function testFunction() local a = 10 local b = 20 return a + b end -- 스택 정보 출력 local info = debug.getinfo(1, "nSl") print("Function Name: " .. info.name) print("Source: " .. info.source) print("Line: " .. info.linedefined) -- 오류 추적 local function errorFunction() error("This is an error!") end local status, err = pcall(errorFunction) if not status then print("Error: " .. err) print(debug.traceback()) end ``` 결론 루아의 `debug` 라이브러리는 디버깅과 관련된 다양한 기능을 제공하여 개발자가 코드의 실행 상태를 검사하고 오류를 추적하는 데 큰 도움을 줍니다.

이 라이브러리를 활용하면 코드의 품질을 높이고, 문제를 신속하게 해결할 수 있습니다.

그러나 `debug` 라이브러리는 성능에 영향을 줄 수 있으므로, 프로덕션 환경에서는 주의해서 사용해야 합니다.