ظهر مشروع OpenLeetCode مؤخراً على Hacker News كأداة تسمح بتشغيل اختبارات LeetCode محلياً مع بقاء الاختبارات في المستودع. بدلاً من الاعتماد على منصة LeetCode فقط، يمكنك الآن تشغيل الاختبارات على جهازك، وتعديلها، ومشاركتها مع فريقك. هذا الدليل يشرح لك كيفية تثبيت الأداة وتشغيلها خطوة بخطوة، مع توضيح الأخطاء الشائعة وبدائلها.

ملاحظة: README المشروع غير واضح تماماً، لذا الخطوات هنا تقريبية بناءً على بنية المشروع. سنشير إلى النقاط الغامضة ونقدم حلولاً عملية.

ما هو OpenLeetCode؟ شرح مبسط

OpenLeetCode هو أداة سطر أوامر (CLI) مفتوحة المصدر تسمح لك بتشغيل اختبارات LeetCode محلياً. الفكرة: بدلاً من كتابة الحل في موقع LeetCode وانتظار التحقق، يمكنك كتابة الحل في ملف على جهازك، وإضافة اختباراتك الخاصة، ثم تشغيل الأداة لترى النتيجة فوراً. الاختبارات تكون في مستودع GitHub، مما يسهل مشاركتها مع الفريق.

من يحتاج OpenLeetCode ومن لا؟

من يحتاجه: المطورون الذين يفضلون العمل محلياً، طلاب علوم الحاسب الذين يريدون تتبع تقدمهم، فرق العمل التي ترغب في مشاركة اختبارات موحدة.

من لا يحتاجه: من يكتفي بحل المشاكل على موقع LeetCode فقط، أو من يبحث عن منصة متكاملة مع دروس فيديو.

المميزات الرئيسية لـ OpenLeetCode

• تشغيل اختبارات LeetCode محلياً دون اتصال بالإنترنت
• إضافة اختبارات مخصصة لكل مشكلة
• مشاركة الاختبارات عبر مستودع GitHub
• خفيف وسريع (أداة CLI)
• مفتوح المصدر (مجاني تماماً)

المتطلبات الأساسية قبل التثبيت

• Node.js (الإصدار 14 أو أحدث) مثبت على جهازك
• npm (مدير حزم Node.js)
• Git (للاستفادة من مستودع الاختبارات)
• حساب GitHub (اختياري للمشاركة)

خطوات تثبيت OpenLeetCode (مع تحذير: README غير واضح)

ملاحظة: README المشروع لا يوضح خطوات التثبيت بوضوح. بناءً على بنية المشروع، إليك الخطوات التقريبية:

1. استنساخ المستودع: git clone https://github.com/therepanic/openleetcode.git
2. الدخول إلى المجلد: cd openleetcode
3. تثبيت الاعتماديات: npm install
4. ربط الأداة (اختياري): npm link لتتمكن من تشغيل الأمر openleetcode من أي مكان

إذا واجهت أخطاء، تأكد من تثبيت Node.js و npm بشكل صحيح.

شرح ملف .env (إن وجد) والإعدادات

المشروع لا يتطلب ملف .env بشكل صريح، لكن قد تحتاج لتعيين بعض المتغيرات البيئية مثل LEETCODE_SESSION إذا كنت تريد جلب المشاكل من حسابك في LeetCode. ابحث عن ملف .env.example في المستودع، وانسخه إلى .env واملأ الحقول المطلوبة.

تشغيل OpenLeetCode لأول مرة

بعد التثبيت، جرب تشغيل الأمر: openleetcode --help لرؤية الأوامر المتاحة. لتشغيل اختبار لمشكلة معينة، استخدم: openleetcode run path/to/problem حيث المسار يشير إلى مجلد المشكلة الذي يحتوي على ملف الحل وملف الاختبار.

أخطاء شائعة وحلولها

استخدامات عملية لأمثلة من LeetCode

مثال: تشغيل اختبار لمشكلة Two Sum

1. أنشئ مجلداً باسم two-sum
2. ضع ملف الحل solution.js:

function twoSum(nums, target) {
  const map = {};
  for (let i = 0; i < nums.length; i++) {
    const complement = target - nums[i];
    if (map[complement] !== undefined) {
      return [map[complement], i];
    }
    map[nums[i]] = i;
  }
  return [];
}
module.exports = twoSum;

1. ضع ملف الاختبار test.js:

const twoSum = require('./solution');
const assert = require('assert');
assert.deepStrictEqual(twoSum([2,7,11,15], 9), [0,1]);
assert.deepStrictEqual(twoSum([3,2,4], 6), [1,2]);
console.log('All tests passed');

1. شغّل: openleetcode run two-sum

مثال: إضافة اختبار جديد أضف سطراً في ملف test.js مثل: assert.deepStrictEqual(twoSum([3,3], 6), [0,1]);

مثال: مشاركة مستودع اختبارات مع فريق ارفع مجلد المشكلة إلى مستودع GitHub، واطلب من فريقك استنساخه وتشغيل openleetcode run.

هل يستحق OpenLeetCode التجربة؟ تقييم موضوعي

OpenLeetCode أداة واعدة لكنها في مراحلها الأولى. README غير واضح، ونقص التوثيق قد يعيق المبتدئين. إذا كنت مطوراً متوسطاً وتحب التجربة، فجربها. لكن لا تتوقع دعماً كاملاً لجميع مشاكل LeetCode. الأداة مناسبة لمن يريد بيئة اختبار محلية خفيفة.

بدائل مشابهة لـ OpenLeetCode

أسئلة شائعة (FAQ)

هل OpenLeetCode مجاني؟

نعم، المشروع مفتوح المصدر ومجاني تماماً.

هل يمكن استخدام OpenLeetCode بدون اتصال بالإنترنت؟

نعم، بعد تثبيت الأداة وجلب المستودع، يمكنك العمل بدون إنترنت.

ما هي لغات البرمجة التي يدعمها OpenLeetCode؟

حسب README، يدعم JavaScript و Python بشكل أساسي. قد يدعم لغات أخرى حسب الإضافات.

كيف أضيف اختبارات جديدة لمشكلة معينة؟

أضف حالات اختبار في ملف الاختبار (مثل test.js) باستخدام assert أو مكتبة الاختبارات المفضلة لديك.

هل OpenLeetCode متوافق مع جميع مشاكل LeetCode؟

ليس بالضرورة. قد تحتاج لتعديل تنسيق الإدخال/الإخراج لبعض المشاكل.

ما الفرق بين OpenLeetCode و LeetCode الرسمي؟

LeetCode الرسمي منصة متكاملة مع محرر ومجتمع. OpenLeetCode أداة CLI محلية تركز على الاختبارات فقط.

هل يوجد دعم للمجتمع العربي؟

لا يوجد دعم رسمي، لكن يمكنك فتح issue أو المشاركة في مجتمع GitHub.

خاتمة وتوصيات

OpenLeetCode أداة مفيدة لمن يريد بيئة اختبار محلية لمشاكل LeetCode. ابدأ بتجربتها على مشكلة بسيطة مثل Two Sum. إذا أعجبتك، شاركها مع زملائك. تذكر أن الأداة جديدة، لذا كن مستعداً لبعض التجربة والخطأ.