הכניסה

עבודה עם Excel לוח זרם מתוכנת היא דרישה נפוצה בעיבוד נתונים, דיווח ושימוש אוטומטי. תאי כושר - Foss ספריית Python היא ספרייה פתוחה שמאפשרת לך ליצור, לקרוא ולשנות. .xlsx ספרים עבודה ללא כל תלות על Microsoft Excel או סוויטות משרדיות אחרות.

שוחרר תחת רישיון MIT, aspose-cells-foss מספק API עשיר שטח מכסה ערכים תאים, טבלאות, סגנון, תרשימים, שולחנות, צורות, תמונות, אימות נתונים, הערות. hyperlinks, auto-filters, ופורמט תנאי. הספרייה דורשת Python 3.7 או גבוה יותר ומתקנה עם אחד pip הפיקוד .

פוסט זה מסביר את יכולות ניהול הגיליונות שה‑aspose-cells-foss מוסיפה לפרויקטים שלך ב-Python, עם דוגמאות קוד עובדות המבוססות על ה‑API האמיתי.


מה כולל

ערכי תאים ונוסחאות

The Cell מדרגה תומכת בצינורות, זרמים, רצועות וטופס.אתה יכול להגדיר ערך ישירות דרך put_value() או להוסיף רצועת טופס ל- formula רכוש – The 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)

עיצוב ועימוד

The Style שיעור מספק שיטות עבור תוספים, גבולות, פורמטים מספרים, ו- Alignment. 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")

תרשימים

The 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")

אימות נתונים

The 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")

מסננים אוטומטיים וטבלאות

שימוש ב-Auto Filter עם AutoFilter שיעור על ידי קריאה set_range() לאחר מכן, לסנן עמודים בודדים.לנתונים מבוססים, TableCollection.add() שיטה יוצרת לוחות ListObject עם סגנונות וסרטנים אוטומטיים.

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לאכן

The SaveFormat enum מגדיר את פורמטים היציאה הללו: AUTO, XLSX, CSV, TSV, MARKDOWN, ו JSON.הספרייה קוראת .xlsx ניתן לייבא נתונים CSV באמצעות Workbook.load_csv().


קוד פתוח & רישיון

תת-תא-פוס שוחרר תחת רישיון MIT, אשר מאפשר שימוש בלתי מוגבל בשני פרויקטים מסחריים ולא מסחרי. GitHub.הספרייה תלויה pycryptodome (> = 3.15.0) ו olefile (>= 0.46) עבור תמיכה בהצפנה.


להתחיל

חקור את התיעוד המלא וחומרי ההפניה כדי להתחיל לבנות עם aspose-cells-foss:

משאבים קשורים