v0.4.0

pykorail v0.4.0

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

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

What's Changed

💥 호환성이 깨지는 변경

• FIX: NetFunnel 요청을 코레일톡+ 7.0.8 실측 형태로 맞춘다 by @devgyurak in #114

🚄 코레일 API 대응

• ADD: NetFunnel 대기열에 동작별 aid 를 받고 대상 동작 문서를 정정한다 by @devgyurak in #116
• ADD: 운행 달력(schedule.runDt) 조회와 성수기 NetFunnel aid 선택을 추가한다 by @devgyurak in #120
• DOCS: 할인 자격이 없으면 예약이 어른 운임으로 강등될 수 있음을 안내한다 by @devgyurak in #125

✨ 새 기능

• ADD: 비동기 클라이언트 AsyncKorail 공개 by @devgyurak in #89
• ADD: 비동기 NetFunnel 대기열 도우미(AsyncNetFunnelHelper) by @devgyurak in #99
• ADD: NetFunnel 도우미에 close·컨텍스트 매니저 추가 by @devgyurak in #106
• ADD: 안내견 동반 승객(GuideDogPassenger)을 추가한다 by @devgyurak in #122

🐛 버그 수정

• FIX: sdist include 패턴을 루트에 고정하고 scripts·.github 를 싣는다 by @devgyurak in #105
• FIX: close() 가 도중에 취소돼도 세션 정리를 끝까지 마친다 by @devgyurak in #112

📦 의존성

• REF: async 테스트 함수도 테스트 규약 검사에 포함 by @devgyurak in #87

📝 문서

• DOCS: README 구성 정리 — Async 노출·커버리지 배지·빠진 기능·개발 절 by @devgyurak in #93
• DOCS: README 구성 정리(#93)를 되돌린다 by @devgyurak in #94
• DOCS: README 구성 정리 — Async 노출·커버리지 배지·빠진 기능·개발 절 by @devgyurak in #95
• DOCS: 레퍼런스의 좌석 예매 예제를 바로잡고 커버리지 안내에 CI 링크를 건다 by @devgyurak in #96
• DOCS: opencode 서브에이전트 사본을 .claude 원본과 맞춤 by @devgyurak in #110
• DOCS: 근거 문서에서 외부 클라이언트 이름을 뺀다 by @devgyurak in #124

🧹 내부 정리

• REF: 동기 I/O 계층을 비동기 원본에서 생성 by @devgyurak in #88
• REF: Account 와 응답 해석을 _shared 로 통합 by @devgyurak in #91
• ADD: develop 커버리지 배지를 CI 가 직접 생성 by @devgyurak in #92
• REF: 이중 close 보호를 세션 래퍼 한 곳으로 모은다 by @devgyurak in #108
• ADD: NetFunnel 응답의 ip·port 재지정을 따르지 않음을 근거와 회귀 테스트로 고정한다 by @devgyurak in #115

기타

• DOCS: 열차 조회 NetFunnel 성수기 판정을 bizDdStgCd == "5" 로 확정한다 by @devgyurak in #119

Full Changelog: v0.3.1...v0.4.0

v0.3.1

pykorail v0.3.1

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

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

What's Changed

💥 호환성이 깨지는 변경

• DOCS: 라이선스를 상업적 이득 금지 조항을 더한 자체 라이선스로 변경 by @devgyurak in #84

🚄 코레일 API 대응

• FIX: 좌석 지정 예매가 열차 행의 좌석 속성을 보낸다 by @devgyurak in #72

🐛 버그 수정

• FIX: curl-cffi 하한을 0.10.0 으로 올리고 하한 검증 CI 잡 추가 by @devgyurak in #82

📦 의존성

• UPT: Bump the dev-tools group across 1 directory with 2 updates by @dependabot[bot] in #70

📝 문서

• DOCS: 비밀번호 변경 안내 뒤 실패하는 호출 범위를 정정 by @devgyurak in #71
• DOCS: README 에 재판매 금지 고지와 프록시 FAQ 추가 by @devgyurak in #83

🧹 내부 정리

• REF: 예약의 취소 식별자 기본값을 상수로 드러낸다 by @devgyurak in #74
• REF: 응답 모델의 from_response 반환 타입을 Self 로 by @devgyurak in #75
• REF: to_kst · KST 를 공용 모듈로 옮긴다 by @devgyurak in #73
• REF: pyproject 검사를 정규식 대신 tomllib 으로 by @devgyurak in #76
• ADD: develop 머지로 닫히지 않는 이슈를 대신 닫는 워크플로 by @devgyurak in #78

기타

• DOCS: 공항버스 rsvSaleDvCd 실서버 비교 결과를 근거 문서에 기록 by @devgyurak in #79

Full Changelog: v0.3.0...v0.3.1

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

v0.2.2

pykorail v0.2.2

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

• PyPI: https://pypi.org/project/pykorail/0.2.2/
• 지원 파이썬: 3.10 – 3.14

What's Changed

🐛 버그 수정

• FIX: HTTP 403 이용제한이 비밀번호 오류·결과 없음으로 보고되던 문제 by @devgyurak in #30
• FIX: HTTP 200 으로 온 이용제한 봉투가 결과 없음·로그인 실패로 보고되던 문제 by @devgyurak in #32

📦 의존성

• UPT: Bump ruff from 0.16.9 to 0.16.10 in the dev-tools group by @dependabot[bot] in #31

Full Changelog: v0.2.1...v0.2.2

v0.2.1

pykorail v0.2.1

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

• PyPI: https://pypi.org/project/pykorail/0.2.1/
• 지원 파이썬: 3.10 – 3.14

What's Changed

🔐 보안

• UPT: urllib3 2.8.0 by @devgyurak in #29

🚄 코레일 API 대응

• FIX: 앱 7.0.8 신원값·로그인 폼·기기 ID 체계 반영 by @devgyurak in #28

🐛 버그 수정

• FIX: HTTP 403 이용제한이 비밀번호 오류·결과 없음으로 보고되던 문제 by @devgyurak in #30

📦 의존성

• UPT: Bump the dev-tools group with 2 updates by @dependabot[bot] in #25

🧹 내부 정리

• FIX: Trivy DB 공급원 하나가 죽으면 CI 전체가 멈추던 문제 by @devgyurak in #26

Full Changelog: v0.2.0...v0.2.1

v0.2.0

pykorail v0.2.0

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

• PyPI: https://pypi.org/project/pykorail/0.2.0/
• 지원 파이썬: 3.10 – 3.14

What's Changed

🚄 코레일 API 대응

• FIX: DynaPath 서명을 코레일톡+ 7.0.8 의 SDK v1.0.3 에 맞추기 by @devgyurak in #23

📦 의존성

• UPT: Bump the dev-tools group with 2 updates by @dependabot[bot] in #20
• UPT: Bump the actions group with 3 updates by @dependabot[bot] in #21

📝 문서

• DOCS: 깃허브 유저명 변경을 저장소 전반에 반영 by @devgyurak in #18

🧹 내부 정리

• ADD: Dependabot 으로 액션·uv 의존성 주간 범프 by @devgyurak in #19
• ADD: CI 에서 actionlint 로 워크플로 검증 by @devgyurak in #22

New Contributors

• @dependabot[bot] made their first contribution in #20

Full Changelog: v0.1.2...v0.2.0

v0.1.2

pykorail v0.1.2

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

• PyPI: https://pypi.org/project/pykorail/0.1.2/
• 지원 파이썬: 3.10 – 3.14

What's Changed

💥 호환성이 깨지는 변경

• FIX: 로그인 실패 경로가 두 갈래로 갈리던 문제 by @leegyurak in #14
• FIX: 승차권 목록 항목 언래핑이 응답 누락에 죽던 문제 by @leegyurak in #13

🐛 버그 수정

• FIX: 좌석 상세 조회 실패에 승차권 목록이 통째로 사라지던 문제 by @leegyurak in #12
• FIX: 예약 하나를 찾으려고 목록 전체의 좌석을 긁던 문제 by @leegyurak in #15

기타

• ADD: 인근역 포함 조회 옵션 by @alton15 in #17

New Contributors

• @alton15 made their first contribution in #17

Full Changelog: v0.1.1...v0.1.2

v0.1.1

pykorail v0.1.1

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

• PyPI: https://pypi.org/project/pykorail/0.1.1/
• 지원 파이썬: 3.10 – 3.14

What's Changed

🚄 코레일 API 대응

• ADD: 환불 수수료 사전조회 (korail.tickets.refund_fee) by @leegyurak in #11

📝 문서

• 배지 stale 캐시 무효화 by @leegyurak in #2
• DOCS: 커밋·PR·브랜치 이름 규약 스킬 by @leegyurak in #7

🧹 내부 정리

• Claude 코드 리뷰 워크플로 추가 by @leegyurak in #3
• REF: CI 를 우분투로 통일하고 인코딩 규약을 정적 검사로 대체 by @leegyurak in #4
• DEL: Claude 코드 리뷰 워크플로 by @leegyurak in #8
• ADD: CodeRabbit 리뷰 설정 by @leegyurak in #9
• FIX: 테스트 목록 대조가 체크아웃 경로에 좌우되던 것 by @leegyurak in #10

Full Changelog: v0.1.0...v0.1.1

v0.1.0

pykorail v0.1.0

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

• PyPI: https://pypi.org/project/pykorail/0.1.0/
• 지원 파이썬: 3.10 – 3.14

What's Changed

📝 문서

• README 재설계 + 태그 보호 규칙 추가 by @leegyurak in #1

New Contributors

• @leegyurak made their first contribution in #1

Full Changelog: https://github.com/leegyurak/pykorail/commits/v0.1.0