툰코 다운로더: 유니코드 이슈 수정과 구조 개편을 향한 업데이트 계획



툰코 다운로더: 유니코드 이슈 수정과 구조 개편을 향한 업데이트 계획

최근 두 번째 웹툰 다운로더 개발을 진행 중이며, 초기 설계의 한계를 느껴 핵심 코드를 재구성하는 작업에 들어갔습니다. 기존 코드를 한꺼번에 전환하기보단, 필수 부분을 우선 수정해 안정성을 확보하는 전략으로 진행 중입니다. 특히 셀레니움을 활용한 자동화 흐름과 유니코드 처리 부분을 중심으로 개선을 추진하고 있으며, 툰코 다운로더를 포함한 유사 도구들의 구조를 더 탄탄하게 다듬어 나갈 예정입니다. 현재 일부 모듈은 이미 가닥이 잡히고 있으며, 데이터 저장 방식과 폴더 구성을 보다 체계적으로 바꿔 보완 작업을 병행 중입니다. 업데이트가 마무리되면 이전에 남겨둔 아이디어들도 차례로 시도해 볼 계획입니다.

 

👉 ✅ 상세 정보 바로 확인 👈

 

진행 상황과 이슈 요약

  • 현황 요약: 다중 페이지 로딩과 파일명 인코딩 문제를 중심으로 코드 정비에 집중 중이며, 셀레니움 기반 자동화의 견고함을 높이고자 로그 관리와 예외 처리를 강화했습니다.
  • 주요 이슈: 유니코드 인코딩 불일치, 파일명 안전성 확보, 데이터 저장 위치의 관리 필요성 등이 남아 있습니다. 이들 이슈를 단계적으로 해결하기 위해 모듈별 개선을 우선순위로 두고 있습니다.

 

 

 

👉 ✅ 상세 정보 바로 확인 👈

 

기술 스택과 도구 활용 현황

  • 셀레니움 활용 현황: 브라우저 자동화 흐름의 안정성을 높이기 위해 대기 전략과 예외 회피 로직을 보강했습니다. 재시도 로직과 타이밍 관리로 예측 불가한 로딩 이슈를 줄이는 방향으로 조정 중입니다.
  • 유니코드 처리 방식: 입력 문자열의 인코딩 스펙트럼을 전수 점검하고, 파일명과 경로 문자열에서 안전한 문자만 남기도록 필터링 규칙을 도입했습니다. 로그에는 인코딩 관련 이슈를 구체적으로 남겨 차후 테스트에서 재현이 쉽게 되도록 했습니다.
항목 수정 전 수정 후 기대 효과
유니코드 처리 일부 특수 문자 누락 가능 문자 인코딩 표준화 적용 호환성 증가, 오류 감소
저장 구조 단일 컨테이너에 모든 데이터 축적 다중 디렉토리 기반 저장 관리 용이성 증가
자동화 대기 로직 고정/불안정 대기 명시적 대기 및 재시도 도입 비정상 시도 축소

수정 포인트와 구현 방향

  • 진행 중인 수정 상세: 유니코드 관련 예외 처리 강화, 파일명 생성 로직의 안전성 확보, 셀레니움 흐름의 예외 분기 추가 등을 우선 적용했습니다. 코드 스타일도 표준화하고 로깅 수준을 높여 이슈 파악을 용이하게 했습니다.
  • 향후 보완 방향: 비동기 처리 도입으로 로딩 시간에 따른 지연을 숨김 없이 관리하고, 테스트 커버리지를 확장하여 예외 상황 재현성을 높일 예정입니다. 또한 데이터 저장 구조를 모듈화해 새로운 데이터 소스나 보조 도구와의 연동을 쉽게 만들 계획입니다.

데이터 관리와 파일 구조 개선

  • 폴더 구조 개편: 데이터 저장 위치를 분리하고, 버전별 폴더 체계를 도입해 과거 데이터의 영향을 최소화했습니다. 이는 유지 보수와 확장성을 크게 높이는 방향입니다.
  • 데이터 관리 전략: 메타데이터와 다운로드 파일을 분리 저장하고, 파일명 규칙을 일관되게 적용하는 정책을 수립했습니다. 로그 파일은 시점별로 분리 저장해 이력 관리가 쉬워지도록 구성했습니다.

업데이트 계획과 주의사항

  • 일정 및 단계: 초기 수정은 이르면 이번 주 내에 마무리될 가능성이 있으며, 이후 단계에서 추가 보완과 테스트를 거쳐 안정화 버전을 배포할 계획입니다.
  • 리스크 및 주의사항: 셀레니움 버전 차이, OS 의존성, 페이지 구조 변화에 따른 스크립트 실패 가능성을 염두에 두고, 회복 로직과 롤백 전략을 함께 구성합니다. 변경 사항은 문서화해 팀 간 공유를 원활하게 하겠습니다.

체크리스트
– 유니코드 테스트 케이스 5종 이상 확보 여부 확인
– 저장 폴더 구조 및 권한 체크
– 셀레니움 대기 전략과 재시도 로직 점검
– 로그 수준과 이력 관리 확인
– 테스트 환경에서의 회귀 테스트 계획 수립

결론

현재 진행 중인 수정은 핵심 기능의 신뢰성 향상과 구조 개선에 집중되어 있습니다. 유니코드 이슈를 견고하게 처리하고, 폴더 구조를 명확하게 분리하는 방향으로 가시적 개선이 이루어지고 있습니다. 업데이트가 마무리되면, 이전에 남겨둔 아이디어를 적용한 추가 시도도 진행할 예정이며, 더 나은 안정성과 확장성을 확보하는 것을 최우선 목표로 삼고 있습니다.

이전 글: 육아휴직급여 사후지급금: 신청 대상·필요 서류 완전정리