سكربت Python يحوّل ملفات CSV لديك إلى JSON أو XML بالبنية التي يتوقعها نظامك بالضبط

مثال على النتيجة

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  المجلد: sales/2026-10، عُثر على 9 ملفات
2026-11-02 09:14:03 INFO  shop-01.csv: 1,284 صفًا
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 صفًا
2026-11-02 09:14:04 WARN  shop-07.csv: تُخطّيت 3 صفوف بلا سعر (الأسطر 88، 412، 913)
2026-11-02 09:14:05 INFO  تم: 10,412 صفًا -> report-2026-10.xlsx (الورقتان «المبيعات» و«الإجماليات»)

[columns]
date = التاريخ, تاريخ البيع, اليوم
product = المنتج, الصنف, الاسم
quantity = الكمية, العدد, قطع
price = السعر, سعر الوحدة

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """يقرأ ملف متجر واحد ويمنح أعمدته أسماء أعمدة التقرير."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name}: لا يوجد عمود لـ «{name}» (جرى البحث عن: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

عن هذه الخدمة

كثير من الأنظمة لا تقبل البيانات إلا بصيغة JSON أو XML: استيراد إلى متجر أو نظام CRM، أو رفع لدى شريك، أو موجز بيانات لتطبيق. يقرأ سكربت Python هذا ملف CSV المصدَّر لديك ويكتب الملف بالبنية التي تحتاجها: أسماء الحقول، والحقول المتداخلة داخل غيرها، والأرقام والتواريخ بأنواعها الصحيحة، والترميز. في الباقة المميزة يمكنه أيضًا تجميع الصفوف في سجل واحد، مثل طلب مع كل عناصره. أرسل إلينا بضعة صفوف من ملف CSV ومثالًا أو وصفًا لملف JSON أو XML الذي يطلبه الطرف الآخر (وثائقه أو ملفًا نموذجيًا). تشغّل السكربت بنفسك على جهازك. إنه يحوّل البيانات التي تعطيه إياها: لا يرفع النتيجة إلى أي مكان ولا يتحقق منها مقابل النظام الآخر.

ما المشمول

• ما الذي تحصل عليهأرشيف ZIP يضم سكربت Python وملف README بتعليمات خطوة بخطوة، ومن الباقة القياسية ملف إعدادات بربط الأعمدة بالحقول؛ ويُعرض الكود أيضًا في صفحة الطلب.
• JSON أو XMLأو كلاهما معًا من ملف CSV واحد
• بنيتك الخاصةأسماء الحقول وتداخلها كما في نموذجك أو وثائقك
• أنواع صحيحةأرقام وقيم true أو false وتواريخ بالصيغة التي تحتاجها
• معالجة الترميزاتإخراج بترميز UTF-8 من CSV بأي ترميز شائع
• كود مقروءمع تعليقات، ليسهل إضافة حقل لاحقًا

كيف يعمل

1. 1
   النماذجترسل بضعة صفوف CSV ونموذجًا لملف JSON أو XML الذي تحتاجه
2. 2
   الكودنكتب السكربت ودليل تشغيله
3. 3
   جرّبهتحوّل ملفك وتجربه في النظام الذي يحتاجه
4. 4
   التعديلاتتطلب التعديلات ضمن باقتك وترسل أي رسالة خطأ

ما نحتاجه منك

10-20 صفًا من ملف CSV لديك (القيم المختلقة لا بأس بها)، وما يجب أن تكون عليه النتيجة: ملف JSON أو XML نموذجي، أو الجزء من وثائق النظام الآخر الذي يصفه، أو مخطط XSD إن وُجد. أي عمود يذهب إلى أي حقل، وكيف تُكتب التواريخ والأرقام، وهل تشكّل عدة صفوف سجلًا واحدًا. نظامك: Windows أو macOS أو Linux.

سنسألك:

• إلى أين سيذهب ملف JSON أو XML؟
• كيف يبدو ملف CSV؟
• كيف يجب أن تبدو النتيجة؟
• أين سيعمل؟

قارن بين الباقات

الأسئلة والأجوبة

لم تجد إجابتك؟ اسألنا