파이썬 코드로 표를 만드는 방법

간단한 표는 워드 프로그램의 테이블(Table, 표) 기능을 활용해 직접 작성하는 것이 빠릅니다.

하지만 대규모의 데이터를 표로 삽입하거나 반복적인 표 작성을 자동화하려면 python-docx 라이브러리를 사용하는 것이 좋습니다.

이번 수업에서는 python-docx를 사용하여 워드 파일에 표를 추가할때 사용하는 주요 메서드들을 알아보겠습니다.

참고 : 표로 시각화되는 데이터는 이해의 편의를 위해 파이썬 리스트로 정의되었습니다. 하지만 실제로는 pandas 라이브러리로 CSV 파일을 URL로 불러와 사용하는 것이 일반적입니다.

새로운 표를 문서에 추가하는 메서드입니다.

document.add_table(rows, cols)와 같이 사용하며 rows 행(가로열)의 수, cols 열(세로열)의 수를 지정합니다.

복사
from docx import Document

doc = Document()
table = doc.add_table(rows=3, cols=3)

특정 셀에 접근해 값을 설정하거나 가져오는 메서드입니다.

table.cell(row, col)와 같이 사용하며 row는 행 번호(0부터 시작), col은 열 번호(0부터 시작)를 지정합니다.

복사
cell = table.cell(0, 0)  # 첫 번째 행, 첫 번째 열의 셀
cell.text = "Hello, World!"

표의 스타일을 설정합니다.

경계선을 포함한 표를 생성하려면 table.style = 'Table Grid'와 같이 사용합니다.

복사
doc = Document()
table = doc.add_table(rows=3, cols=3)

table.style = 'Table Grid'  # Word의 미리 정의된 스타일 사용

표에 새로운 행(가로줄)을 추가하는 메서드입니다.

table.add_row()와 같이 사용하면 새로운 행을 추가합니다.

복사
row = table.add_row()
row.cells[0].text = "New Cell"

표에 새로운 열(세로줄)을 추가하는 메서드입니다.

table.add_column(width)와 같이 지정된 너비로 새로운 열을 추가

복사
from docx.shared import Inches

table.add_column(Inches(1))

셀에 텍스트를 설정하거나 가져올 때 사용합니다.

복사
cell = table.cell(1, 1)
cell.text = "Sample Text"

셀을 병합하는 메서드입니다.

아래 코드는 첫 번째 행의 두 셀을 병합하는 예시입니다.

복사
a = table.cell(0, 0)
b = table.cell(0, 1)
a.merge(b)  # 첫 번째 행의 두 셀을 병합