refactor: restructure resources and add offline station catalog

.github/workflows/python-package.yml

@@ -2,43 +2,53 @@ name: Python package
 
 on:
   push:
-    branches: [ "main" ]
+    branches: ["main"]
   pull_request:
-    branches: [ "main" ]
+    branches: ["main"]
 
 jobs:
-  build:
+  test:
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
 
     steps:
-    - uses: actions/checkout@v4
-
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v3
-      with:
-        python-version: ${{ matrix.python-version }}
-
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        python -m pip install flake8 pytest
-        python -m pip install requests
-        python -m pip install pandas
-        python -m pip install xmltodict
-        python -m pip install dotenv
-        if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
-
-    - name: Lint with flake8
-      run: |
-        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
-        flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
-
-    - name: Set PYTHONPATH
-      run: echo "PYTHONPATH=$(pwd)" >> $GITHUB_ENV
-
-    - name: Test with pytest
-      run: pytest
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package and test dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+
+      - name: Check for fatal lint errors
+        run: flake8 src tests --count --select=E9,F63,F7,F82 --show-source --statistics
+
+      - name: Check package types
+        run: python -m mypy
+
+      - name: Run unit tests
+        run: python -m pytest -m "not integration"
+
+  package:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+
+      - name: Build and validate distributions
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build twine
+          python -m build
+          python -m twine check dist/*

.github/workflows/python-publish.yml

@@ -50,12 +50,7 @@ jobs:
     # For more information, see: https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment#deployment-protection-rules
     environment:
       name: pypi
-      # OPTIONAL: uncomment and update to include your PyPI project URL in the deployment status:
-      # url: https://pypi.org/p/YOURPROJECT
-      #
-      # ALTERNATIVE: if your GitHub Release name is the PyPI project version string
-      # ALTERNATIVE: exactly, uncomment the following line instead:
-      # url: https://pypi.org/project/YOURPROJECT/${{ github.event.release.name }}
+      url: https://pypi.org/project/UnOffical-TAGO-API/
 
     steps:
       - name: Retrieve release distributions

.gitignore

@@ -3,9 +3,7 @@ tagopi/__pycache__
 tests/__pycache__
 .pytest_cache
 .env
-caches/cache.pkl
 .vscodeoutput.json
 .tagoapi
-
-
-tagoapi/caches/station.pkl
+.idea/
+*.egg-info/

CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+이 프로젝트는 `MAJOR.MINOR.PATCH` 버전 형식을 사용합니다.
+
+## 0.14.0 - Unreleased
+
+### Added
+
+- 공식 정류소 데이터 기반 오프라인 `StationCatalog`
+- `StationCatalogError`
+
+### Changed
+
+- 패키지 빌드 설정을 `pyproject.toml`로 전환
+
+### Removed
+
+- 구현되지 않은 `utils.get_station` 메모 모듈
+- Resource와 연결되지 않던 실험적 model lazy-loading 기능
+
+## 0.13.0 - 2026-07-29
+
+### Added
+
+- 서비스별 Route, Station, Arrival, Vehicle Resource
+- `CityCode` 모델과 `CityResource`
+- `TagoPage` 기반 페이지 응답
+
+### Changed
+
+- 모델과 Resource의 책임 분리
+- 공공데이터포털 및 제공기관 예외 계층 정리
+- 구형 Client 메서드를 deprecated API로 전환
+
+### Removed
+
+- `BaseList`
+- pickle cache와 구형 converter/decorator
+- requests 기반 구형 HTTP helper