파이썬 API
피망 슬롯 API는 피망 슬롯 시스템 제어는 물론 피망 슬롯와 Python 간의 데이터 이동을 가능하게 하는 여러 하위 모듈이 포함된 Python 패키지입니다. 현재 API는 Python 버전 3.9~3.14를 지원합니다. 다음 표는 사용 가능한 모든 하위 모듈의 개요를 제공합니다.
| 하위 모듈 | 설명 |
|---|---|
| 연결 | 주로 GMSPython에서 YAML 구문을 ETL(추출, 변환 및 로드) 데이터를 피망 슬롯로 소화하는 데 사용되지만 기본 Python 환경에서도 사용할 수 있습니다. |
| 제어 | 피망 슬롯 시스템의 전체 제어를 활성화합니다 |
| 코어 | GDX, GMD, GMO 및 기타 피망 슬롯 개체에 연결하는 데 사용되는 핵심 피망 슬롯 API 도구입니다. 전문가 수준의 지식이 필요합니다. |
| 엔진 | 피망 슬롯 엔진 API(OpenAPI 호환), 피망 슬롯 엔진으로 작업 관리 |
| 마법(베타) | Jupyter 노트북 내에서 피망 슬롯 사용을 활성화합니다. |
| 도구(베타) | 피망 슬롯 도구 라이브러리의 코드 베이스 |
| 이동 | 데이터 전용 API – 피망 슬롯 데이터가 피망 슬롯 스크립트 외부에서 유지 관리되도록 허용 |
- 참고
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
가져오기피망 슬롯transferasgt
- 주의
- 조건부 import 문이 도움이 될 수 있지만 사용자는 새로운 구조를 사용하도록 코드를 수정하는 것이 좋습니다.