Robot Framework의 통합 개발 환경인 RIDE는 테스트 케이스의 수가 많아질수록 성능 저하 및 잦은 오류로 인해 사용에 어려움이 있습니다. 특히 로컬(Windows) 환경에서 디버깅한 코드가 리모트(Linux) 환경에서 다르게 동작하여 추가적인 수정 작업이 필요한 경우가 많습니다. 또한, 로컬에서 작성된 파일을 원격 서버에 업로드하여 테스트하고 제출하는 과정에서 오류나 누락이 발생하기 쉽습니다. 이러한 문제점들을 해결하기 위해 VS Code를 이용한 원격 실행 및 디버깅, 보고서 확인, 그리고 코드 제출 워크플로우를 구축하는 방법을 소개합니다.
필수 VS Code 확장 프로그램
VS Code를 통한 효율적인 Robot Framework 개발 환경을 위해 다음 확장 프로그램들을 설치해야 합니다:
- Remote SSH: 원격 서버에 SSH로 접속하여 파일을 편집하고 터미널 명령을 실행합니다.
- Live Preview: 생성된 HTML 보고서를 실시간으로 미리 보고 웹 브라우저에서 확인할 수 있게 해줍니다.
- Robot Framework Intellisense: Robot Framework 키워드에 대한 자동 완성 및 정의로 이동 기능을 제공합니다.
Remote SSH 확장 프로그램 설치 및 원격 서버 연결
먼저 VS Code 확장 프로그램 마켓플레이스에서 Remote SSH를 검색하여 설치합니다. 설치 완료 후 VS Code 좌측 하단의 <> < > 모양 아이콘(또는 F1 키를 누른 후 'Remote-SSH: Connect to Host...' 입력)을 클릭하고, 연결할 SSH 사용자 이름과 서버 IP 주소를 사용자이름@서버IP 형식으로 입력합니다.
첫 연결 시에는 사용자 홈 디렉토리 내의 .ssh 폴더에 설정 파일이 생성되거나 업데이트될 수 있습니다. 연결 과정에서 문제가 발생할 경우, 관련 SSH 설정 및 네트워크 상태를 확인하시기 바랍니다.
Robot Framework Intellisense 활용
이 확장 프로그램의 가장 큰 장점은 키워드 정의로 쉽게 이동하고 자동 완성 기능을 활용할 수 있다는 것입니다.
- 키워드 정의로 이동: 키워드 위에 마우스를 올린 후
Ctrl + 마우스 왼쪽 클릭을 하거나, 키워드에 커서를 두고F12키를 누르면 해당 키워드가 정의된 위치로 즉시 이동합니다. - 자동 완성: 키워드를 입력할 때 관련 키워드 목록이 자동으로 표시되어 빠르고 정확하게 코드를 작성할 수 있도록 돕습니다.
테스트 디버깅 및 보고서 확인
pybot 유틸리티 설정
Robot Framework 3.0.0 버전 이후부터는 pybot 명령어가 기본적으로 제공되지 않습니다. 따라서 수동으로 pybot 래퍼 스크립트를 생성해야 합니다. 다음은 root 권한으로 스크립트를 생성하고 실행 권한을 부여하는 방법입니다.
- 시스템에 설치된 Python 인터프리터 경로를 확인합니다.
$ which python
/usr/bin/python
/usr/bin/pybot파일을 생성하고 다음 내용을 추가합니다. 이때 첫 줄의 Python 경로를which python명령으로 확인한 경로로 설정합니다.
$ sudo vi /usr/bin/pybot
#!/usr/bin/python
# Robot Framework 테스트 실행 래퍼 스크립트
import sys
from robot import run_cli
if __name__ == "__main__":
run_cli(sys.argv[1:])
- 생성한
pybot스크립트에 실행 권한을 부여합니다.
$ sudo chmod +x /usr/bin/pybot
pybot --version명령을 실행하여 정상적으로 설정되었는지 확인합니다.
$ pybot --version
Robot Framework 3.1.2 (Python 2.7.5 on linux2)
터미널을 통한 테스트 케이스 실행
VS Code 내에서 새로운 터미널을 열고, 테스트 스위트 파일이 있는 디렉토리로 이동합니다. 다음 명령어를 사용하여 테스트 케이스를 실행할 수 있습니다.
- 모든 테스트 실행:
pybot your_test_suite.robot - 특정 테스트 케이스 실행:
pybot -t "Your Specific Test Case Name" your_test_suite.robot - 특정 태그가 있는 테스트 케이스 실행:
pybot -i "TagName" your_test_suite.robot
테스트 보고서 확인
Live Preview 확장 프로그램을 사용하여 생성된 HTML 형식의 테스트 보고서를 확인할 수 있습니다.
report.html 또는 log.html 파일을 VS Code에서 연 후, 우측 상단의 돋보기 아이콘을 클릭하여 미리보기를 활성화합니다.
미리보기 창에서 우클릭 또는 상단 메뉴를 통해 'Open in Browser' 옵션을 선택하면 기본 웹 브라우저에서 보고서를 열 수 있습니다. 테스트를 반복 실행하더라도 보고서 파일이 업데이트될 때마다 브라우저에서 자동으로 새로 고쳐져 편리하게 로그를 확인할 수 있습니다.