cointrader/docs/plans/2026-03-01-fix-pandas-ta-python312.md

pandas-ta Python 버전 호환성 수정 계획

For Claude: REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.

Goal: Jenkins CI에서 pandas-ta==0.4.71b0이 Python 3.11에서 설치 실패하는 문제를 해결한다.

Architecture: pandas-ta==0.4.71b0은 Python >=3.12를 요구하므로, Dockerfile의 베이스 이미지를 python:3.11-slim에서 python:3.12-slim으로 업그레이드한다. requirements.txt의 의존 패키지 버전도 Python 3.12와 호환되는 버전으로 정리한다.

Tech Stack: Docker, Python 3.12-slim, pandas-ta 0.4.71b0, python-binance 1.0.19

---

문제 분석

Jenkins 빌드 로그 오류:

ERROR: Ignored the following versions that require a different python version:
  0.4.67b0 Requires-Python >=3.12; 0.4.71b0 Requires-Python >=3.12
ERROR: Could not find a version that satisfies the requirement pandas-ta==0.4.71b0

원인: requirements.txt에 pandas-ta==0.4.71b0이 명시되어 있으나, Dockerfile 베이스 이미지가 python:3.11-slim이라 Python 3.12 이상을 요구하는 pandas-ta를 설치할 수 없다.

해결 방향: Dockerfile 베이스 이미지를 python:3.12-slim으로 변경한다.

---

Task 1: Dockerfile 베이스 이미지 업그레이드

Files:

• Modify: Dockerfile:1

Step 1: Dockerfile 수정

Dockerfile 1번째 줄을 다음과 같이 변경한다:

변경 전:

FROM python:3.11-slim

변경 후:

FROM python:3.12-slim

Step 2: 변경 내용 확인

head -1 /Users/gihyeon/github/cointrader/Dockerfile

Expected:

FROM python:3.12-slim

---

Task 2: requirements.txt 의존성 호환성 검토 및 수정

Files:

• Modify: requirements.txt

Step 1: 현재 requirements.txt 내용 확인

cat /Users/gihyeon/github/cointrader/requirements.txt

Expected (현재 내용):

python-binance==1.0.19
pandas>=2.2.0
pandas-ta==0.4.71b0
python-dotenv==1.0.0
httpx>=0.27.0
pytest>=8.1.0
pytest-asyncio>=0.24.0
aiohttp==3.9.3
websockets==12.0
loguru==0.7.2

Step 2: pandas-ta 0.4.71b0의 의존성 확인

PyPI 정보에 따르면 pandas-ta==0.4.71b0은 다음을 요구한다:

• numba==0.61.2
• numpy>=2.2.6
• pandas>=2.3.2

requirements.txt의 pandas>=2.2.0은 pandas>=2.3.2를 만족하므로 문제없다.
단, numba가 명시되어 있지 않아 pandas-ta 설치 시 자동으로 설치된다.

Step 3: requirements.txt 수정 (pandas 최소 버전 상향)

pandas>=2.2.0을 pandas>=2.3.2로 변경하여 pandas-ta의 요구사항을 명시적으로 반영한다:

변경 전:

pandas>=2.2.0

변경 후:

pandas>=2.3.2

Step 4: 변경 내용 확인

grep "pandas" /Users/gihyeon/github/cointrader/requirements.txt

Expected:

pandas>=2.3.2
pandas-ta==0.4.71b0

---

Task 3: 로컬 Docker 빌드 테스트

Docker가 설치된 환경에서만 실행한다.

Step 1: Docker 빌드

cd /Users/gihyeon/github/cointrader
docker build -t cointrader:test .

Expected: 빌드 성공 (Successfully tagged cointrader:test 또는 #N DONE)

Step 2: 빌드된 이미지의 Python 버전 확인

docker run --rm cointrader:test python --version

Expected:

Python 3.12.x

Step 3: pandas-ta import 확인

docker run --rm cointrader:test python -c "import pandas_ta; print(pandas_ta.__version__)"

Expected:

0.4.71b0

Step 4: 테스트 이미지 정리

docker rmi cointrader:test

---

Task 4: git 커밋 및 Gitea push

Files:

• Modify: Dockerfile
• Modify: requirements.txt

Step 1: git 상태 확인

cd /Users/gihyeon/github/cointrader
git status

Expected:

modified:   Dockerfile
modified:   requirements.txt

Step 2: 변경 내용 검토

git diff Dockerfile requirements.txt

Expected:

• Dockerfile: -FROM python:3.11-slim → +FROM python:3.12-slim
• requirements.txt: -pandas>=2.2.0 → +pandas>=2.3.2

Step 3: 스테이징

git add Dockerfile requirements.txt

Step 4: 커밋

git commit -m "fix: upgrade to Python 3.12 to support pandas-ta>=0.4.67b0"

Expected: 커밋 성공

Step 5: Gitea push

git push origin main

Expected: push 성공 후 Jenkins가 자동으로 새 빌드를 트리거함

Step 6: 커밋 확인

git log --oneline -3

Expected: 방금 만든 커밋이 최상단에 표시됨

---

Task 5: Jenkins 빌드 재실행 및 결과 확인

Step 1: Jenkins 빌드 트리거

Gitea push 후 Jenkins Webhook이 설정되어 있다면 자동으로 빌드가 트리거된다.
수동으로 트리거하려면 Jenkins 웹 UI에서 cointrader 파이프라인 → Build Now 클릭.

Step 2: 빌드 로그에서 성공 확인

Jenkins 빌드 로그에서 다음 내용이 나타나야 한다:

#9 [5/7] RUN pip install --no-cache-dir -r requirements.txt
...
Successfully installed pandas-ta-0.4.71b0 ...
#9 DONE xx.xs

오류 없이 [Build Docker Image] 스테이지가 완료되어야 한다.

Step 3: 전체 파이프라인 성공 확인

Jenkins 빌드 결과가 SUCCESS로 표시되어야 한다:

Finished: SUCCESS

---

트러블슈팅

문제	원인	해결
python-binance==1.0.19 설치 실패	Python 3.12 비호환	python-binance>=1.0.19로 변경하거나 최신 버전 확인
aiohttp==3.9.3 설치 실패	Python 3.12 비호환	aiohttp>=3.9.3으로 완화하거나 최신 버전으로 업그레이드
numba 설치 시간 초과	numba 컴파일 시간	빌드 타임아웃 설정 증가 또는 --timeout=300 추가
Jenkins Webhook 미동작	Gitea Webhook 미설정	Gitea 저장소 설정 → Webhooks → Jenkins URL 추가

---

참고: Python 3.12 호환성 체크리스트

Python 3.11 → 3.12 주요 변경사항 중 이 프로젝트에 영향 가능한 항목:

• asyncio 동작 변경: asyncio.get_event_loop() deprecated → asyncio.get_running_loop() 권장
• typing 모듈 일부 변경: Union[X, Y] → X | Y 문법 지원 강화
• datetime.utcnow() deprecated → datetime.now(timezone.utc) 권장

현재 코드베이스(src/, tests/)에서 위 패턴 사용 여부를 확인하고 필요 시 수정한다.