파이썬 API

피망 슬롯 API는 피망 슬롯 시스템 제어는 물론 피망 슬롯와 Python 간의 데이터 이동을 가능하게 하는 여러 하위 모듈이 포함된 Python 패키지입니다. 현재 API는 Python 버전 3.9~3.14를 지원합니다. 다음 표는 사용 가능한 모든 하위 모듈의 개요를 제공합니다.

하위 모듈설명
연결 주로 GMSPython에서 YAML 구문을 ETL(추출, 변환 및 로드) 데이터를 피망 슬롯로 소화하는 데 사용되지만 기본 Python 환경에서도 사용할 수 있습니다.
제어 피망 슬롯 시스템의 전체 제어를 활성화합니다
코어 GDX, GMD, GMO 및 기타 피망 슬롯 개체에 연결하는 데 사용되는 핵심 피망 슬롯 API 도구입니다. 전문가 수준의 지식이 필요합니다.
엔진 피망 슬롯 엔진 API(OpenAPI 호환), 피망 슬롯 엔진으로 작업 관리
마법(베타)Jupyter 노트북 내에서 피망 슬롯 사용을 활성화합니다.
도구(베타)피망 슬롯 도구 라이브러리의 코드 베이스
이동 데이터 전용 API – 피망 슬롯 데이터가 피망 슬롯 스크립트 외부에서 유지 관리되도록 허용
참고
  • 호환성 문제로 인해 피망 슬롯 Python API는 Microsoft Store의 Python 인터프리터와 작동하지 않습니다.
  • 당신이 찾고 있다면GAMSPy문서를 참조하세요.공식 가이드.

API를 설치하려면 다음을 방문하세요:시작하기.

가져오기 명세서 마이그레이션

피망 슬롯 42 출시로 피망 슬롯 Python 생태계가 재구성되었습니다. 새로운 구조에는 많은 이점이 있습니다(더 쉽고 안전한 (제거)설치, 더 깔끔한 모듈 네임스페이스 등).

주의
새로운 API 구조는 단순히 이전 버전을 "업데이트"하는 데 사용할 수 없습니다. 사용자는 설치를 시도하기 전에 처음부터 새로운 Python 환경을 구축해야 합니다.

피망 슬롯 Python API 생태계의 재구성은 새로운 중첩 구조의 생성으로 제한되었습니다. 클래스, 메소드 및 기타 변수 이름은 수정되지 않았습니다. 새 시스템을 사용하는 경우 레거시 코드의 import 문을 업데이트해야 합니다. 가장 좋은 방법은 새로운 패키지 구조를 사용하여 필요에 따라 다른 하위 모듈을 가져오는 것입니다.<module_name>에서 가져오기 *구문). 새로운 API 구조로의 전환을 돕기 위해 이전 구문과 새 구문 간의 매핑을 제공합니다.

이전가져오기성명신규가져오기권장사항
피망 슬롯에서 GamsWorkspace 가져오기 피망 슬롯에서 GamsWorkspace 가져오기
피망 슬롯 가져오기에서 * 게임 가져오기
gdxcc에서 가져오기 * 피망 슬롯core에서 gdx 가져오기
-또는-
피망 슬롯core.gdx를 gdx로 가져오기
optcc 가져오기 *에서 피망 슬롯core에서 가져오기 옵션
-또는-
피망 슬롯core.opt를 opt로 가져오기
gt로 gamstransfer 가져오기 피망 슬롯에서 gt로 가져오기 전송
-또는-
gt로 피망 슬롯transfer 가져오기
gams_engine 가져오기 피망 슬롯engine 가져오기
참고
Jupyter 사용자는 자신을 마이그레이션해야 합니다.reload_ext gams_magic->reload_ext 피망 슬롯magic그리고load_ext gams_magic->load_ext 피망 슬롯magic

이전 API와 새 API 테스트

사용자는 Python API의 다른 버전으로 동일한 Python 코드를 실행할 수 있습니다. 이 경우 조건부 import 문을 포함하는 것이 도움이 될 수 있습니다. 다음을 사용하여 피망 슬롯 주요 버전 번호를 테스트할 수 있습니다.GamsWorkspace.api_major_rel_number속성:

에서게임가져오기GamsWorkspace
ifGamsWorkspace.api_major_rel_number<42:# 이전 API 구조
가져오기gdxccasgdx
에서게임가져오기 *
가져오기gamstransferasgt
그밖에:# 새로운 API 구조
가져오기피망 슬롯core.gdxasgdx
으로부터 피망 슬롯control 가져오기 *
가져오기피망 슬롯transferasgt
주의
조건부 import 문이 도움이 될 수 있지만 사용자는 새로운 구조를 사용하도록 코드를 수정하는 것이 좋습니다.