xlwings 오류 해결하기: ValueError: Worksheet names must be unique

소개

xlwings를 사용하면서 'ValueError: Worksheet names must be unique'라는 오류가 발생하는 경우에 대해 이야기해보겠습니다. 이 오류는 Excel 파일에 새로운 시트를 추가하려고 시도할 때, 이미 동일한 이름의 시트가 존재할 경우 발생합니다. 그런 경험을 하신 분들이 많겠지만, 걱정하지 마세요! 이 글에서는 이 오류의 원인과 여러 해결 방법을 살펴보겠습니다.

에러 발생 예시 코드

먼저, 오류가 발생할 수 있는 코드 예시를 살펴보겠습니다.

import xlwings as xw

# 새로운 엑셀 파일 열기
wb = xw.Book()

# 시트 추가하기
wb.sheets.add('MySheet')
wb.sheets.add('MySheet')  # 동일한 이름으로 두 번째 시트 추가 시도

에러 해결 방법

1. 시트 이름을 고유하게 설정하기

가장 직관적인 방법은 시트를 추가할 때 고유한 이름을 사용하는 것입니다. 예를 들어, 현재 시트의 개수와 날짜를 포함하여 시트 이름을 설정할 수 있습니다.

import xlwings as xw
from datetime import datetime

# 새로운 엑셀 파일 열기
wb = xw.Book()

# 고유한 시트 이름 생성
unique_name = f"MySheet_{datetime.now().strftime('%Y%m%d_%H%M%S')}"
wb.sheets.add(unique_name)

2. 기존 시트 확인 후 추가

시트를 추가하기 전에, 이미 존재하는 시트 이름을 확인하여 중복을 피하는 방법도 있습니다.

import xlwings as xw

# 새로운 엑셀 파일 열기
wb = xw.Book()

# 시트 이름 정의
sheet_name = 'MySheet'

# 동일한 이름의 시트가 있는지 확인
if sheet_name not in [sheet.name for sheet in wb.sheets]:
    wb.sheets.add(sheet_name)
else:
    print(f"'{sheet_name}'라는 이름의 시트가 이미 존재합니다.")

마무리

이번 포스트에서는 xlwings를 사용할 때 발생할 수 있는 'ValueError: Worksheet names must be unique' 오류 그리고 이를 해결하기 위한 방법들을 살펴보았습니다. 고유한 시트 이름을 사용하는 것이 가장 안전한 방법이며, 기존의 시트들의 목록을 체크하는 것도 좋은 전략입니다. 항상 코드를 작성할 때는 몇 가지 규칙을 설정해두고 작업하면, 발생할 수 있는 오류를 줄일 수 있습니다!