개발자 가이드

Aspose.Cells FOSS for Python은 프로그래밍 방식의 스프레드시트 처리를 위한 무료 오픈소스 라이브러리입니다. 데이터 파이프라인을 구축하든, 자동 보고서를 생성하든, ML 결과를 Excel로 내보내든, 문서화 파이프라인을 위해 워크북을 Markdown으로 변환하든, Aspose.Cells FOSS는 Microsoft Office 없이도 스프레드시트 조작의 모든 계층을 포괄하는 포괄적인 API를 제공합니다.

주요 기능

워크북 및 워크시트 작업

새 워크북을 처음부터 만들거나 기존 XLSX 또는 CSV 파일을 엽니다.
깨끗하고 파이썬스러운 API로 Workbook → Worksheets → Cells → Cell 계층 구조를 탐색합니다.
workbook.add_worksheet(name) 및 workbook.remove_worksheet(index_or_name)을 사용하여 워크시트를 추가하고, 이름을 바꾸고, 제거합니다.
주소(ws.cells["A1"])로 개별 셀에 접근하고, 값을 직접 설정하며, 채워진 범위를 반복합니다.

Cell Styling and Formatting

개별 셀에 세밀한 서식을 적용합니다. Font 클래스를 통해 글꼴 패밀리, 크기, 색상, 굵게, 기울임, 밑줄 및 취소선을 제어합니다. cell.style.fill.set_solid_fill("FFRRGGBB")을 사용하여 배경 채우기를 설정합니다. 색상은 # 접두사 없이 8자리 AARRGGBB 16진수 문자열로 표현됩니다(예: "FFFF0000"는 불투명 빨간색을 의미합니다).

차트 생성 및 시각화

워크시트에 전용 메서드인 ws.charts.add_bar(top_row, left_col, bottom_row, right_col) 및 ws.charts.add_line(...)를 사용하여 열, 선, 막대 및 파이 차트를 추가합니다. 차트 제목을 문자열로 설정(chart.title = "My Chart"), 차트 수준에서 범주 데이터를 구성(chart.category_data = "A2:A6"), 그리고 명명된 시리즈를 추가합니다(chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

수식 지원

cell.formula = "=SUM(A1:A5)"을 설정하거나 Cell(None, "=SUM(A1:A5)")을 구성하고 이를 셀 컬렉션에 할당하여 Excel 호환 수식을 입력합니다.

다중 형식 내보내기

워크북을 XLSX, CSV, TSV, Markdown 및 JSON으로 단일 workbook.save(path) 호출을 사용하여 내보냅니다. 명시적 제어를 위해 SaveFormat 상수를 사용하십시오: SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.TSV, SaveFormat.MARKDOWN, SaveFormat.JSON. 세밀한 Markdown 출력(정렬, 헤더 수준, 워크시트 인덱스)을 위해 MarkdownSaveOptions을 사용하십시오. 메모리 내 Markdown 생성을 위해 MarkdownHandler.save_markdown_to_string(wb)을 사용하십시오. 즉시 사용할 수 있는 코드는 Export Format Examples를, 팁 및 FAQ는 Export Troubleshooting를 참조하십시오.

Note: Aspose.Cells FOSS는 XLSX, CSV, TSV, Markdown 및 JSON으로 내보냅니다. PDF, HTML, PNG, TIFF, DOCX 및 PPTX 내보내기는 FOSS 라이브러리의 일부가 아닙니다.

플러그인 생태계

옵션인 markitdown-aspose-cells-plugin 패키지는 Microsoft의 MarkItDown 라이브러리와 통합되어 XLSX 읽기 지원을 추가합니다. pip install markitdown-aspose-cells-plugin으로 설치하고 MarkItDown API를 통해 투명하게 사용하십시오.

시작하기

설치 

pip install aspose-cells-foss

안녕 세상 

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Hello, Aspose.Cells FOSS!"
ws.cells["A2"].value = 42
workbook.save("hello.xlsx")

Markdown으로 내보내기 

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 95
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 88

workbook.save_as_markdown("results.md")

열 차트 만들기 

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]

data = [("Q1", 50), ("Q2", 100), ("Q3", 170), ("Q4", 300)]
for i, (label, value) in enumerate(data):
    ws.cells[f"A{i+2}"].value = label
    ws.cells[f"B{i+2}"].value = value

chart = ws.charts.add_bar(6, 0, 20, 8)
chart.title = "Quarterly Revenue"
chart.category_data = "A2:A5"
chart.n_series.add("B2:B5", category_data="A2:A5", name="Revenue")

workbook.save("chart.xlsx")

셀 서식 

from aspose.cells_foss import Workbook, Cell, Font

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"] = Cell("Revenue Report")

cell = ws.cells["A1"]
cell.style.font.bold = True
cell.style.font.size = 14
cell.style.font.color = "FFFFFFFF"   # White text (AARRGGBB, no #)
cell.style.fill.set_solid_fill("FF1E64C8")  # Blue background

workbook.save("styled.xlsx")

사용 가능한 가이드

참조

 한국어