Humanizer C# (.NET): طرق، أمثلة، تثبيت | PythonLib

Humanizer C# (.NET): دليل شامل مع أمثلة تطبيقية

1. ما هي مكتبة Humanizer ولماذا تحتاجها؟

Humanizer هي مكتبة مفتوحة المصدر شهيرة لمنصة .NET، تحل واحدة من أكثر المشاكل شيوعًا بين المطورين: تحويل البيانات التقنية والموجهة للآلة إلى صيغة يفهمها الإنسان بسهولة. بدلاً من كتابة عشرات الدوال المساعدة لتنسيق التواريخ والأرقام والتعدادات والنصوص، توفر Humanizer واجهة fluent أنيقة (سلاسل استدعاءات) تجعل الكود أنظف والمخرجات أكثر ودية.

لماذا تحتاجها؟ تخيل أنك تعرض للمستخدم وقت نشر تعليق. بدلاً من الصيغة الجافة "2024-03-15T14:30:00Z"، من الأفضل بكثير عرض "15 مارس 2024، 14:30" أو، إذا مر وقت قصير، "منذ لحظات" أو "منذ 5 دقائق". Humanizer تقوم بهذه التحويلات بسطر واحد من الكود. تدعم المكتبة الترجمة (أكثر من 30 لغة، بما في ذلك العربية)، والتعامل مع الأرقام (الأعداد الترتيبية، الأرقام الرومانية، البايتات "المقروءة")، والتعدادات (نصوص جميلة بمسافات بدلاً من CamelCase)، وغيرها الكثير.

Humanizer مكتوبة بلغة C# ومتوافقة تمامًا مع .NET Framework 4.6.1+ و.NET Core 2.0+ و.NET 5/6/7/8، بالإضافة إلى Xamarin وUnity وأي منصة تدعم .NET Standard 2.0. هذا يجعلها الخيار الأمثل لأي مشروع .NET يتطلب الترجمة وتحسين تجربة المستخدم.

2. طريقة التثبيت

يتم تثبيت Humanizer في مشروع .NET عبر مدير الحزم NuGet. استخدم أحد الأوامر التالية:

# التثبيت عبر .NET CLI (موصى به)
dotnet add package Humanizer

# التثبيت عبر Package Manager Console (Visual Studio)
Install-Package Humanizer

# التثبيت عبر NuGet Package Manager
# أو ابحث عن "Humanizer" في الواجهة الرسومية لـ NuGet

بعد التثبيت، أضف التوجيه using Humanizer; في بداية ملف الكود.

ملاحظة: إذا كنت تحتاج فقط إلى وظائف محددة (مثل التعامل مع التواريخ فقط)، توجد حزم أخف: Humanizer.Core (الأساسية)، Humanizer.Core.ar (الترجمة العربية). لكن لمعظم المشاريع، الحزمة الكاملة Humanizer كافية.