كاتب وقارئ Ruby فائق السرعة ومجاني لملفات Excel XLSX

البدء مع Fast_Excel

الطريقة الموصى بها لتثبيت مكتبة Fast_Excel هي باستخدام RubyGems. يرجى استخدام الأمر التالي لتثبيت سلس.

$ gem install fast_excel  

كتابة جدول بيانات بسيط عبر واجهة برمجة التطبيقات 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

معالجة الأعمدة والصفوف عبر واجهة برمجة التطبيقات 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 صف) لا تزال أسرع بشكل كبير.