Python 콘솔

Shotgun Python 콘솔

Shotgun 툴킷용 Python 콘솔
최신 버전: v1.1.2(베타)
버전 번호의 경우 유의적 버전 표준을 따릅니다.
시스템 이름: tk-multi-pythonconsole

참고: 이 문서에서는 툴킷 구성에 대한 제어 권한을 갖고 있는 경우에만 사용할 수 있는 기능에 대해 설명합니다. 자세한 정보는 Shotgun 통합 사용자 안내서를 참조하십시오.
개요 요약
설명서
            패널
            
                  편집기
                  출력
            버튼
                  출력
                  편집기
            전역
            외부 소스
            핫키
            기타 참고 사항
설치, 업데이트 및 개발
구성 옵션

이 응용프로그램은 툴킷 응용프로그램을 실행하는 모든 환경에 사용할 수 있는 대화식 Python 콘솔을 제공합니다.

설명서

다음은 Python 인터프리터에 액세스할 수 있는 DCC에서 사용하는 Python 콘솔 패널로 해당 인터프리터와의 상호 작용은 제한되어 있거나 지원되지 않습니다.

Shotgun Python 콘솔
Photoshop CC 2017의 Python 콘솔

Shotgun Python 콘솔
Flame의 Python 콘솔

패널

Maya에 고정되어 있는 콘솔

콘솔을 설치하고 나면 DCC에 패널로 등록되고, Shotgun 메뉴에서 사용할 수 있습니다. 포함된 툴킷 패널(Maya, Nuke, Houdini)을 지원하는 앱에서는 콘솔이 고정 패널에 표시됩니다. 이전 버전의 DCC 또는 패널을 지원하지 않는 DCC와 사용하는 경우 콘솔은 일반 툴킷 대화상자로 표시됩니다.

탭

Python 콘솔은 각각 편집기 및 출력 창을 포함하고 있는 탭을 하나 이상 표시합니다. 오른쪽 아래에 있는 + 버튼을 클릭해서 새 탭을 생성할 수 있습니다. 탭 이름 옆에는 x 버튼이 있어 탭을 삭제할 수 있습니다. 탭 자체를 두 번 클릭하면 탭의 새 이름을 입력하라는 메시지가 표시됩니다. 탭은 드래그 앤 드롭으로 재정렬할 수 있습니다. 탭의 상태는 DCC를 닫을 때 저장되었다가 다음에 실행할 때 복원됩니다.

편집기

편집기

콘솔에는 Python 편집을 위한 입력 영역이 있습니다. 편집기에는 행 번호가 포함되며, 현재 커서가 가리키는 행이 강조 표시되고, 기본적인 구문 강조 표시도 지원됩니다. 콘솔은 DCC의 팔레트를 사용하여 통합된 모양과 느낌을 주려고 합니다.

출력

출력

출력 영역에는 실행한 Python의 결과가 표시됩니다. 소스 Python 명령 에코는 기본적으로 켜져 있고, 해당 출력은 >>> 접두사가 추가되어 구별됩니다. 각 실행에는 타임스탬프도 표시됩니다. 에코를 끌 수 있는 토글도 있습니다. 구문 및 런타임 오류는 디버깅을 위한 전체 스택 트래킹과 함께 빨간색으로 표시됩니다.

버튼

버튼

출력

  • 지우기(Clear) - 출력 브라우저의 컨텐츠를 지웁니다.
  • 에코(Echo) - 출력 브라우저에서 실행된 명령의 에코를 토글합니다.

편집기

  • 실행(Execute) - 편집기의 컨텐츠를 실행합니다.
  • 저장(Save) - 편집기의 현재 컨텐츠를 파일에 저장합니다.
  • 열기(Open) - 파일을 편집기에서 엽니다.
  • 지우기(Clear) - 편집기의 컨텐츠를 지웁니다.
  • 행(Lines) - 현재 탭의 행 번호를 토글합니다.

전역

전역

일부 Shotgun/툴킷 전역은 셸용 Shotgun 엔진에서 사용할 수 있는 항목과 유사하게 콘솔에 사전 정의되어 있습니다.

  • Tk API 핸들은 tk 변수를 통해 사용할 수 있습니다.
  • Shotgun API 핸들은 shotgun 변수를 통해 사용할 수 있습니다.
  • 현재 컨텍스트는 context 변수에 저장됩니다.
  • 셸 엔진은 engine 변수를 통해 액세스할 수 있습니다.

외부 소스

앱에는 외부 위치에서 Python 소스를 로드하기 위해 구현할 수 있는 후크가 함께 제공됩니다. 이 후크는 external_sources_hook라고 부르며, 사용하려면 get_external_source_actions라는 메서드를 구현해야 합니다. 이 메서드는 트리거 시 콘솔에 (컨텐츠와 함께) 새 탭을 추가하는 QActions 목록을 반환해야 합니다. 사전 정의된 사용자 목록을 위해 github에서 gist를 로드하는 구현 예시가 제공됩니다. 후크에 의해 반환되는 액션은 열기(Open) 버튼을 오래 누르면 나타나는 팝업 메뉴에 표시됩니다.

외부 소스

핫키

  • 선택 항목 실행은 Ctrl + Enter
  • 새 탭 생성은 Ctrl + T
  • 탭 탐색은 Ctrl + Shift + [ 또는 Ctrl + Shift + ]
  • 입력/출력 글꼴 크기 조정은 Ctrl + Wheel

참고: 일부 DCC에서는 핫키를 사용하지 못할 수도 있습니다.

기타 참고 사항

  • 일부 이전 버전의 DCC에서는 세션을 닫을 때 Python 콘솔을 연 채로 두면 충돌이 발생할 수도 있습니다. 이는 일부 이전 버전의 PySide에서 발생하는 버그일 수 있습니다. 최신 버전의 PySide와 번들로 제공되는 보다 최신 버전의 DCC에서는 종료 시 충돌이 나타나지 않습니다. 최신 DCC 릴리즈 버전에서 이 문제가 발생하면 자세히 조사할 수 있도록 티켓을 제출해 주십시오.

설치 및 업데이트

Shotgun Pipeline Toolkit에 이 앱 추가

이 앱을 이름이 asset인 환경에 있는 프로젝트 XYZ에 추가하고 싶다면 다음 명령을 실행합니다.

> tank Project XYZ install_app asset tk-maya tk-multi-pythonconsole

최신 버전으로 업데이트

프로젝트에 이 항목이 이미 설치되어 있는 경우 최신 버전을 얻으려면 update 명령을 실행할 수 있습니다. 특정 프로젝트와 함께 제공되는 tank 명령을 탐색하여 다음과 같이 실행할 수 있습니다.

> cd /my_tank_configs/project_xyz
> ./tank updates

또는 스튜디오 tank 명령을 실행하고 업데이트 확인을 실행할 프로젝트 이름을 지정할 수 있습니다.

> tank Project XYZ updates

협업 및 개선

Shotgun Pipeline Toolkit에 액세스할 수 있다면 모든 앱, 엔진 및 프레임워크가 저장 및 관리되는 Github에서 그 소스 코드에도 액세스할 수 있습니다. 이러한 항목을 자유롭게 개선하여 향후 독립적인 개발을 위한 기반으로 사용하고 변경 후 다시 풀 리퀘스트를 제출하거나, 아니면 그냥 조금만 손을 보고 어떻게 빌드되었는지, 툴킷이 어떻게 작동하는지 확인해 보십시오. 이 코드 리포지토리는 https://github.com/shotgunsoftware/tk-multi-pythonconsole에서 액세스할 수 있습니다.

특별 요구 사항

  • 이를 이용하려면 Shotgun 버전 v6.2.0 이상이 필요합니다.
  • 이 기능을 이용하려면 Shotgun Pipeline Toolkit Core API 버전 v0.16.32 이상이 필요합니다.

구성

아래는 사용되는 모든 구성 설정을 요약한 것입니다. 해당 설정은 이 앱 또는 엔진을 사용하려는 환경 파일에서 정의해야 합니다.

external_sources_hook

유형: hook

기본값: {self}/external_sources.py

설명: 새 탭의 외부 소스에 관한 정보를 제공합니다.

팔로우

0 댓글

댓글을 남기려면 로그인하세요.