تحويل CSV إلى جدول نصي محاذى

تحلّل الحقول المحاطة بعلامات الاقتباس تحليلًا صحيحًا — بما فيها الفواصل والفواصل المنقوطة وفواصل الأسطر داخل علامات الاقتباس — وتحسب عرض كل عمود وتبطّن كل خلية كي تصطف الأعمدة، وترسم خطًا فاصلًا تحت الترويسة. وعندما يحتوي أحد الصفوف على عدد من الحقول يختلف عن الترويسة، يفشل الاستدعاء بخطأ واضح بدلًا من إنتاج جدول معوّج، ما لم تفعّل خيار lenient لملء الصفوف القصيرة بخلايا فارغة.

لماذا نعرض CSV في جدول بعرض ثابت

CSV هو التنسيق الذي تنتقل به البيانات، لكنه تنسيق سيئ جدًا للقراءة. فالعمود الذي يحتوي قيمًا طويلة يدفع الحقل التالي بعيدًا إلى اليمين في صف دون آخر، فيفقد البصر المحاذاة بعد سطرين. وتحل جداول البيانات هذه المشكلة بإخفاء النص كليًا، وهذا بالضبط ما لا تريده عندما تكون الوجهة سجل طرفية أو تعليقًا على pull request أو بريدًا إلكترونيًا بنص عادي أو توثيقًا بتنسيق Markdown.

أما محوّل csv إلى جدول نصي فيحافظ على البيانات كنص — قابل للنسخ وللمقارنة بـ diff وللبحث فيه بـ grep — مع استعادة الشيء الوحيد الذي كانت جداول البيانات توفره: أعمدة مصطفّة. الصق التصدير وستحصل على كتلة يشغل فيها كل حقل الموضع نفسه في جميع الصفوف، مع مسطرة من الشَّرطات تحت الترويسة. ولأن الناتج نص عادي، فإنه يصمد أمام اللصق في أي أداة أو دردشة أو مراجعة شيفرة دون إعادة تنسيق، ويُقرأ بالطريقة نفسها على شاشة هاتف كما على شاشة عريضة.

كيف يعمل التحليل والمحاذاة

يتبع المحلل اصطلاحات RFC 4180: يجوز للحقل المحاط بعلامتي اقتباس مزدوجتين أن يحتوي على الفاصل وفواصل الأسطر وعلامات اقتباس حرفية تُكتب كعلامتي اقتباس مزدوجتين متتاليتين، وتُتجاهل الأسطر الفارغة. وهذا مهم عمليًا لأن عمليات التصدير الحقيقية تضع الحقول بين علامتي اقتباس تحديدًا عندما تحتوي شيئًا مثيرًا للاهتمام: عنوانًا فيه فاصلة، أو ملاحظة فيها فاصلة منقوطة، أو رسالة فيها فاصل سطر. بعد التحليل، يتحقق العارض من أن كل صف يحتوي العدد نفسه من الحقول الذي في الصف الأول.

وإن لم يكن الأمر كذلك، يفشل الاستدعاء بخطأ يذكر الصف والعددين معًا: فالصف الذي تنقصه فاصلة ختامية ينتج جدولًا منزاحًا بشكل واضح، والجدول المنزاح أسوأ من غياب الجدول. وإن كنت تفضّل رؤية البيانات على أي حال، فعّل lenient وستُملأ الصفوف القصيرة بخلايا فارغة حتى عرض أوسع صف. بعد ذلك يُحسب عرض كل عمود على أنه أطول خلية فيه، وتُبطَّن كل خلية حتى ذلك العرض، وتُدمج الأعمدة بخط عمودي.

وعندما يكون الصف الأول ترويسة، تُرسم تحته مسطرة من الشَّرطات. كل شيء حتمي: المدخل نفسه ينتج دائمًا مخرجًا مطابقًا بايتًا ببايت.

الفواصل والترويسات والاستخدام اليومي

ليس كل CSV يستخدم الفاصلة. فعمليات التصدير الأوروبية تستخدم غالبًا الفاصلة المنقوطة، وكثير من تفريغات قواعد البيانات يستخدم الجدولة أو الخط العمودي. مرّر الحرف في حقل delimiter وسيعمل كل شيء آخر بالطريقة نفسها: الحقول المقتبسة واكتشاف الأخطاء والملء المتساهل.

وإن لم تكن بياناتك تحتوي صف ترويسة، فاضبط header على القيمة false وسيُعرض الصف الأول كبيانات دون خط فاصل. تعمل هذه القدرة على الحافة دون تخزين أي شيء: يُحلَّل النص ويُعرض ثم يُتخلَّص منه. من المستخدمين النموذجيين سكربتات الإصدار التي تطبع جدولًا تلخيصيًا في سجلات CI، وبرامج الروبوت التي ترد بجدول مقروء في الدردشة، ومولّدات التوثيق التي تضمّن بيانات نموذجية محاذاة.

تُقبل مدخلات حتى 1 ميغابايت و50,000 صف، وهو ما يغطي بسهولة أي تصدير قد يلصقه إنسان ومعظم ما تولّده الآلات.