v0.3.0

pykorail v0.3.0

uv add pykorail==0.3.0
# 또는
pip install pykorail==0.3.0

• PyPI: https://pypi.org/project/pykorail/0.3.0/
• 지원 파이썬: 3.11 – 3.15

⚠️ 깨지는 변경

아래 자동 생성된 목록은 PR 제목만 나열해서 무엇이 깨지는지는 드러나지 않습니다. 0.2.x 에서 올릴 때 손봐야 하는 곳을 여기에 적습니다.

Python 3.10 지원 종료 — #41

requires-python 이 >=3.11 로 올라갑니다. 3.10 환경이 깨지는 것은 아닙니다 — pip · uv 가 3.10 에서는 0.2.x 를 자동으로 고릅니다. 0.3.0 부터의 변경을 받으려면 파이썬을 3.11 이상으로 올리세요.

Train 에 필수 필드 다섯 개가 늘었습니다 — #45 · #54

dep_run_order · arr_run_order · seat_attribute (#45), dep_cons_order · arr_cons_order (#54) 입니다. 응답을 Train.from_response() 로 받는 코드는 영향이 없습니다. Train(...) 을 직접 만들어 쓰는 코드는 TypeError 로 깨집니다 — 다섯 값을 채워 넣으세요.

알려진 응답 코드의 예외가 서버 메시지를 싣습니다 — #53

NeedToLoginError · NoResultsError · SoldOutError 가 "Need to Login" 같은 영문 기본 문구 대신 서버가 준 h_msg_txt 를 msg 와 str() 에 싣습니다. 타입과 code 는 그대로라 except SoldOutError 나 exc.code == "P058" 는 영향이 없습니다. 기본 문구를 문자열로 비교하던 코드만 타입이나 code 로 바꾸세요.

비밀번호 변경 안내에 걸린 로그인이 예외가 됩니다 — #52

같은 비밀번호를 6개월 넘게 쓴 계정은 코레일이 로그인 응답에 비밀번호 변경 안내를 싣습니다. 전에는 strResult=SUCC 라는 이유로 성공으로 처리됐습니다 — 세션은 인증되지 않았는데도요. 그 뒤 로그인이 필요한 호출(예약 조회 · 예매 · 취소 등)은 전부 NeedToLoginError 로 실패했고, 열차 조회는 그대로 됐습니다. 이제 login() 이 PasswordChangeRequiredError 를 올립니다. LoginFailedError 의 하위 타입이라 기존 except LoginFailedError 가 그대로 잡습니다. 코레일톡 앱이나 홈페이지에서 안내를 처리한 뒤 다시 로그인하세요.

📌 알아둘 것

깨지지는 않지만 0.2.x 와 다른 곳입니다.

환승 예약은 예약번호 하나에 구간이 둘입니다 — #56

reservations.all() 에 구간마다 한 줄씩 나오고(find() 는 그중 첫 줄 하나만 돌려줍니다), 각 줄의 price 는 그 구간의 금액이 아니라 예약 전체의 금액입니다(두 구간에 같은 값). 여기까지는 0.2.x 도 같았습니다 — 앱에서 만든 환승 예약도 all() 에서 두 줄로 나왔습니다.

0.3.0 에서 달라진 것은 둘입니다. cancel() 이 환승 예약을 취소합니다 — 전에는 cancel() 이 보내는 값이 여정이 둘인 예약에 맞지 않아 서버가 ERR800052 로 거절했고, 앱에서 만든 환승 예약을 pykorail 로 취소할 수 없었습니다. 이제 어느 구간을 넘겨도 예약 전체가 취소됩니다. 그리고 목록의 각 줄이 자기 구간의 좌석을 가집니다 — 전에는 둘째 줄도 첫 구간의 좌석을 들고 왔습니다.

What's Changed

💥 호환성이 깨지는 변경

• DEL: Python 3.10 지원 종료 by @devgyurak in #41

🚄 코레일 API 대응

• FIX: 비밀번호 변경 안내에 걸린 로그인을 성공으로 치던 문제 by @devgyurak in #52

✨ 새 기능

• ADD: 문서 사이트 site/ — 저장소 문서를 Starlight 로 빌드 by @devgyurak in #34
• ADD: Python 3.15 지원 by @devgyurak in #42
• ADD: 열차 조회 결과 이어 받기 (trains.search 의 max_pages) by @devgyurak in #44
• ADD: 호차 · 좌석 조회 (trains.cars · trains.seats) by @devgyurak in #45
• ADD: 환승 조회 (trains.search_transfers · trains.transfer_stations) by @devgyurak in #48
• ADD: 예매 전 운임 조회 (trains.fares) by @devgyurak in #50
• ADD: 마일리지 · 할인쿠폰 조회 (korail.membership) by @devgyurak in #51
• ADD: 좌석을 골라 예매하기 (reservations.create_with_seats) by @devgyurak in #54
• ADD: 공항버스 정류장 · 시간표 · 좌석 조회 (korail.airport_bus) by @devgyurak in #55
• ADD: 환승 여정 예매 (reservations.create_transfer) by @devgyurak in #56

🐛 버그 수정

• FIX: 목록 자리에 null 이 와도 조회 · 예약 목록 · 승차권 목록이 죽지 않게 by @devgyurak in #46
• FIX: 알려진 응답 코드의 예외가 서버 메시지를 버리던 문제 by @devgyurak in #53

📦 의존성

• UPT: Bump ty from 0.0.84 to 0.0.85 in the dev-tools group across 1 directory by @dependabot[bot] in #36
• UPT: Bump pycryptodome from 3.23.0 to 3.24.0 in the runtime group across 1 directory by @dependabot[bot] in #37

📝 문서

• DOCS: README 상단에 라이트·다크 배너 이미지 추가 by @devgyurak in #33
• DOCS: README 에 문서 사이트 링크 추가 by @devgyurak in #38
• ADD: 문서 사이트 헤더 · favicon 에 승차권 로고 by @devgyurak in #49
• DOCS: v0.3.0 릴리스 전 정리 — 예제 날짜와 .env by @devgyurak in #63

🧹 내부 정리

• FIX: Dependabot 이 site 의 typescript 메이저 범프를 올리지 않게 함 by @devgyurak in #39
• FIX: 미리보기 빌드가 돌도록 wrangler 설정에 previews 블록 추가 by @devgyurak in #47

Full Changelog: v0.2.2...v0.3.0