countries-mania-js

نظرة عامة على البنية

graph LR
    A["countries.build()"] --> B["سلسلة البناء"]
    B --> C[".withCurrency()"]
    B --> D[".withPopulation()"]
    B --> E[".withCapitalCity()"]
    B --> F[".withCallingCode()"]
    C & D & E & F --> G["التوحيد"]
    H[i18n-iso-countries] --> G
    I[i18n-nationality] --> G
    G --> J["build() / toJSON() / toFile()"]

مكتبة صغيرة تحوّل بيانات الدول المرجعية المبعثرة إلى شكل واحد متّسق. فبدل أن تعرض سجلًا ثابتًا، تقدّم بانيًا: تُسلسل الحقول التي تهمّك وحدها، ثم تُخرج النتيجة ككائن أو نص JSON أو ملف على القرص.

تعتمد المكتبة على i18n-iso-countries وi18n-nationality، وتوفّق بين مجموعتَي المفاتيح المختلفتين لديهما، وتكمل البيانات الوصفية — العملة وعدد السكان والعاصمة ورمز الاتصال — التي لا توفّرها أي منهما بمفردها.

الميزات الرئيسية:

• واجهة انسيابية قابلة للتسلسل مع إثراء اختياري
• توحيد رموز ISO 3166 وأسماء الجنسيات في سجل واحد
• بيانات وصفية اختيارية: العملة وعدد السكان والعاصمة ورمز الاتصال
• ثلاثة مخرجات: كائن في الذاكرة أو نص JSON أو ملف مكتوب
• منشورة على npm تحت رخصة MIT
• بلا أي إعداد يتجاوز حزمتَي البيانات المطلوبتين

التقنيات المستخدمة:

• اللغة: JavaScript، Node.js
• التوزيع: npm
• مصادر البيانات: i18n-iso-countries، i18n-nationality