Въведение

Работата с Excel е програмирана изискване за обработка на данни, докладване и автоматизиране на работните потоци. Апсо-клетъчни фосфори е библиотека с отворен код Python, която ви позволява да създавате, четете и модифицирате .xlsx Работни книги без каквато и да е зависимост от Microsoft Excel или други офис софтуер.

Изпратени под Мит лиценз, Aspose-cells-foss осигурява богата API повърхност покрива стойности на клетките, формули, стилове, графика, таблици, форми, изображения, валидация на данни, коментари, хипервръзки, автофилтри и условно форматиране. Библиотеката изисква Python 3.7 или по-висока и се инсталира с един pip Командваща .

Тази статия променя възможностите за управление на шифровата таблица, които асистент-клетка-фос води до вашите Python проекти, с примери за работен код, основани в действителния API.

Какво е включено

Целеви стойности и формули

и на Cell клас поддържа интегра, плавателни линии, редове и формули. можете да зададете стойност директно чрез put_value() или да се приложи формула на строежа към formula Имотът – това е FormulaEvaluator Класа може да оценява формулите програмично.

from aspose.cells_foss import Workbook, Cell

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

# Set different value types
ws.cells["A1"] = Cell(42)
ws.cells["A2"] = Cell(3.14159)
ws.cells["A3"] = Cell("Revenue Report")

# Set a formula
ws.cells["A4"] = Cell(None, "=SUM(A1:A2)")

# Check the stored values
print(ws.cells["A1"].value)    # 42
print(ws.cells["A4"].formula)  # =SUM(A1:A2)

Стилни и форматирани

и на Style клас предоставя методи за попълване, граници, брой формати и съвместимост. Прилагане на стил към всяка клетка с Cell.apply_style().

from aspose.cells_foss import Workbook, Cell, Style

wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"] = Cell("Total")
ws.cells["B1"] = Cell(25000)

style = Style()
style.set_fill_color("FFD9E1F2")
style.set_border("bottom", "thin", "FF000000", 1)
style.set_number_format("#,##0.00")
ws.cells["B1"].apply_style(style)

wb.save("styled_report.xlsx")

График

и на ChartCollection Класови предложения, посветени на add_line(), add_bar(), add_pie(), add_scatter(), и много други методи за въвеждане на графики в работна книга. веднага след създаването, конфигурирайте Chart заглавие, легенда, категория данни и серия.

from aspose.cells_foss import Workbook

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

# Populate data
months = ["Jan", "Feb", "Mar", "Apr"]
sales = [120, 150, 180, 200]
for i, (m, s) in enumerate(zip(months, sales), 2):
    ws.cells[f"A{i}"].value = m
    ws.cells[f"B{i}"].value = s
ws.cells["A1"].value = "Month"
ws.cells["B1"].value = "Sales"

# Create a line chart
chart = ws.charts.add_line(0, 4, 20, 12)
chart.title = "Monthly Sales"
chart.category_data = "A2:A5"
chart.n_series.add("B2:B5", category_data="A2:A5", name="Sales")
chart.show_legend = True

wb.save("sales_chart.xlsx")

Валидиране на данни

и на DataValidation клас ви позволява да изпълнявате списъци с падане, редове на числа и правилата за персонализиране на клетъчните редови. type, operator, formula1, formula2, alert_style, error_title,и error_message.

from aspose.cells_foss import Workbook

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

# Add a dropdown validation
dv = ws.data_validations.add("B2:B100")
dv.type = 3       # List validation
dv.formula1 = '"Yes,No,Pending"'
dv.show_error_message = True
dv.error_title = "Invalid Entry"
dv.error_message = "Please select Yes, No, or Pending."

wb.save("validated.xlsx")

Автофилтри и таблици

Използвайте самофилтриране с AutoFilter Класа чрез повикване set_range() и след това филтриране на отделните колони. за структурирани данни, TableCollection.add() Методът създава таблици с стилове и автофилтри.

from aspose.cells_foss import Workbook

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

# Populate header + data
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
for i, (n, s) in enumerate([("Alice", 92), ("Bob", 78), ("Carol", 95)], 2):
    ws.cells[f"A{i}"].value = n
    ws.cells[f"B{i}"].value = s

# Apply an auto-filter
ws.auto_filter.set_range(0, 0, 3, 1)

# Or create a structured table
table = ws.tables.add(0, 0, 3, 1, True, "ScoreTable")

wb.save("filtered_data.xlsx")

Защита на работна книга и работни листове

Защита на работните книги с Workbook.protect() и индивидуални работни места с Worksheet.protect().Защитният API поддържа гранулярни разрешения като позволяване на форматиране или вмъкване от редове, докато блокира изтрити.

from aspose.cells_foss import Workbook

wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"].value = "Protected content"

# Protect the worksheet with a password
ws.protect("secret123", format_cells=True, insert_rows=True,
           delete_columns=False, delete_rows=False)

# Protect the workbook structure
wb.protect("workbook_pass", lock_structure=True, lock_windows=False)
wb.save("protected.xlsx")

Бързо стартиране

Инсталирайте пакета от PyPI:

pip install aspose-cells-foss>=26.3.1

Създайте работна книга, популяризирайте някои данни и я съхранявайте:

from aspose.cells_foss import Workbook, Cell, Style

# Create a new workbook
wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Quarterly Report"

# Add headers with styling
header_style = Style()
header_style.set_fill_color("FF4472C4")
for col, label in enumerate(["Region", "Q1", "Q2", "Q3", "Q4"], 1):
    cell_ref = f"{chr(64 + col)}1"
    ws.cells[cell_ref] = Cell(label)
    ws.cells[cell_ref].apply_style(header_style)

# Add data rows
data = [
    ("North", 12000, 15000, 13000, 16000),
    ("South", 9000, 11000, 10500, 12000),
    ("East", 14000, 13500, 15000, 17000),
]
for r, row in enumerate(data, 2):
    for c, val in enumerate(row, 1):
        ws.cells[f"{chr(64 + c)}{r}"].value = val

# Save as XLSX
wb.save("quarterly_report.xlsx")

# Also export to CSV
wb.save_as_csv("quarterly_report.csv")

Подкрепени формати

ФорматътРазширяванеПрочететеПисане
XLSX.xlsxДаДа
CSV.csvДаДа
TSV.tsvНеДа
JSON.jsonНеДа
Маркиране.mdНеДа

и на SaveFormat Enum определя тези формати за изход: AUTO, XLSX, CSV, TSV, MARKDOWN,и JSON.Библиотеката чете .xlsx да се изтеглят и да импортират CSV данни чрез Workbook.load_csv().

Отворени източници и лицензиране

Апсолут-целето се освобождава под Мит лиценз, което позволява неограничено използване както в търговски, така и в некоммерчески проекти. източникът е наличен на GitHub.Библиотеката зависи от pycryptodome (> = 3.15.0) и olefile (> = 0.46) за поддръжка на шифроване.

Започваме

Разгледайте пълната документация и референтния материал, за да започнете строителството с аспозиционни клетки: