عن المشروع

Yarn 1.x هو مدير حزم لمشاريع JavaScript، ويوصف في ملف README الخاص به بأنه إدارة تبعيات سريعة وموثوقة وآمنة. يحتوي هذا المستودع على مصادر إصدارات 1.x (أحدث إصدار وقت كتابة هذا النص هو 1.22) وهو مجمد بشكل صريح: الميزات الجديدة وإصلاحات الأخطاء تحدث الآن في مستودع yarnpkg/berry، بينما يُحتفظ بهذا المستودع لأغراض تاريخية بشكل أساسي ولإصلاحات عاجلة عرضية لتسهيل الانتقال من 1.x إلى الإصدارات اللاحقة. القدرات الرئيسية الموثقة في ملف README: - التخزين المؤقت: كل حزمة يتم تنزيلها تُخزَّن مؤقتًا، لذا لا يلزم تنزيل نفس الحزمة مرة أخرى. - التزامن: معظم العمليات تعمل بشكل متزامن لزيادة استخدام الموارد إلى أقصى حد، وهو ما يقول المشروع إنه يؤدي إلى تثبيتات أسرع. - التثبيت الحتمي: تنسيق ملف قفل مفصل لكن موجز بالإضافة إلى خوارزمية تثبيت حتمية تهدف إلى ضمان أن التثبيت الذي يعمل على نظام واحد يعمل بنفس الطريقة على نظام آخر، بغض النظر عن ترتيب التثبيت. - فحوصات السلامة: تُستخدم المجاميع الاختبارية (checksums) للتحقق من كل حزمة مثبتة قبل تنفيذ كودها. - الوضع دون اتصال: يمكن تثبيت الحزم المثبتة مسبقًا مرة أخرى دون اتصال بالإنترنت. - أداء الشبكة ومرونتها: يتم وضع الطلبات في قائمة انتظار بكفاءة لتجنب الشلالات في الطلبات، وفشل طلب واحد لا يفشل التثبيت بالكامل لأن الطلبات يُعاد محاولتها تلقائيًا. - الوضع المسطح: يتم حل إصدارات التبعيات غير المتطابقة إلى إصدار واحد لتجنب التكرار. لا تتضمن تعليمات التثبيت والاستخدام في ملف README نفسه؛ بل يشير إلى دليل التثبيت ودليل الاستخدام على موقع yarnpkg.com. يلاحظ ملف README أيضًا أن قاعدة كود 1.x قديمة إلى حد ما وستقبل فقط إصلاحات الأمان، ويوصي بالانتقال إلى أحدث إصدار، حيث يتيح إعداد nodeLinker الاختيار بين node_modules (مثل npm)، أو الروابط الرمزية (مثل pnpm)، أو ملفات البيان عبر Yarn PnP. يُنسب الفضل في الأعمال السابقة إلى Bundler وCargo وnpm، ويشكر ملف README سام هولمز على التبرع باسم حزمة npm. تذكر أقسام الرعاية Doppler وWorkOS.