כותב וקורא Ruby חינמי ו‑Ultra‑Fast ל‑Excel XLSX

התחלת עבודה עם Fast_Excel

השיטה המומלצת להתקנת ספריית Fast_Excel היא באמצעות RubyGems. יש להשתמש בפקודה הבאה להתקנה חלקה.

$ gem install fast_excel  

כתיבת גיליון פשוט באמצעות API של Ruby

ספריית הקוד הפתוח Fast_Excel מאפשרת למתכנתים ליצור קבצי Excel XLSX חדשים בצורה יעילה ומעט צורך בזיכרון בתוכנות Ruby שלהם. השימוש העיקרי הוא לייצור גליון נתונים פשוט ממערך של נתונים. היא תומכת בהוספת גיליונות חדשים, שינוי שם של גיליונות קיימים, הוספת טקסט ותמונות ועוד. הנה דוגמה פשוטה שמציגה איך מתכנתים יכולים ליצור גליון XLSX פשוט בתוך יישומי Ruby.

require 'fast_excel'

# Create a new workbook
workbook = FastExcel.open("constant_memory.xlsx", constant_memory: true)

# Add a worksheet
worksheet = workbook.add_worksheet("User Report")

# Add data rows. The write_row method accepts an array of values.
worksheet.write_row(0, ["ID", "Name", "Email"]) # Header row (row index 0)

users = User.limit(10000)

users.each_with_index do |user, index|
  # Write each row, starting from row 1
  worksheet.write_row(index + 1, [user.id, user.name, user.email])
end

# Don't forget to close the workbook to save the file!
workbook.close

עיצוב מתקדם של תאים באמצעות Ruby

ספריית Fast_Excel מספקת תמיכה מלאה למגוון אפשרויות עיצוב כדי שהגיליונות שלכם ייראו מקצועיים וקריאים. אתם יכולים להגדיר גודל גופן, משפחת גופן, צבע (כולל RGB), סגנונות כגון מודגש/נטוי, גרסאות קו תחתי, קו חוצה, גלגול טקסט, סיבוב, הזחה, גבולות (דק, כפול וכו'), יישור (אופקי/אנכי), פורמטים של מספרים ועוד. הנה דוגמה מועילה שמציגה איך מפתחים יכולים ליישם סוגים שונים של עיצוב לתאים, שורות ועמודות בגיליונות Excel בתוך אפליקציות Ruby.

require 'fast_excel'

workbook = Fast_Excel.open("formatted_report.xlsx")

# Create a bold format
bold = workbook.bold_format

# Create a custom number format
currency_format = workbook.number_format("$#,##0.00")

worksheet = workbook.add_worksheet("Sales Report")

# Set column widths and formats
worksheet.set_column(0, 0, 20)
worksheet.set_column(1, 1, 15, currency_format)

# Write a header row with bold formatting
worksheet.append_row(["Product", "Revenue"], bold)

# Write data rows
worksheet.append_row(["Product A", 15000])
worksheet.append_row(["Product B", 25000])

workbook.close

מניפולציה של עמודות ושורות באמצעות API של Ruby

ספריית Fast_Excel מאפשרת למפתחים לעבוד עם שורות ועמודות של גליון Excel בתוך אפליקציות Ruby. היא מספקת שליטה מלאה על ממדי העמודות והשורות שלכם. ניתן להגדיר רוחב וגובה ספציפיים, וה‑Fast_Excel אפילו תומכת ברוחב אוטומטי לערכי מחרוזת. הדוגמה הבאה מציגה כיצד לעבוד עם שורות ועמודות של גליון Excel בעזרת פקודות Ruby.

require 'fast_excel'

workbook = Fast_Excel.open("column_width.xlsx")
worksheet = workbook.add_worksheet

# Set the width of the first column to 30
worksheet.set_column(0, 0, 30)

# Set the height of the first row to 40
worksheet.set_row(0, 40)
worksheet.append_row(["This is a long string that needs more space"])
workbook.close

מהירות וביצועים משופרים

ספריית הקוד הפתוח Fast_Excel מצטיינת במהירות גבוהה ומכבית משמעותית על ספריות Ruby טהורות, במיוחד עם ערכות נתונים גדולות. מכיוון שה‑FastExcel משתמשת ב‑libxlsxwriter (ספריית C), הפעולות מהירות הרבה יותר מספריות Ruby טהורות. מבחני ביצועים מראים שהיא עוברת על אחרים כמו Axlsx במרבה פעמים. כתיבת 1,000 שורות – Fast_Excel מהירה כ‑3‑4 פעמים יותר מאשר Axlsx; עם נתונים גדולים (20,000 שורות) היא עדיין משמעותית מהירה יותר.