تحياتي ومرحبا بكم في رستلينغز. يحتوي هذا المشروع على تمارين صغيرة لتعتاد على قراءة وكتابة كود Rust. يتضمن ذلك قراءة رسائل المترجم والرد عليها!
يُنصح بممارسة تمارين Rustlings بالتوازي مع قراءة كتاب Rust الرسمي، وهو المصدر الأكثر شمولاً لتعلم Rust ️
Rust By example هو مورد آخر موصى به قد تجده مفيدًا. يحتوي على أمثلة التعليمات البرمجية وتمارين مشابهة لـ Rustlings، ولكن عبر الإنترنت.
قبل تثبيت Rustlings، تحتاج إلى تثبيت أحدث إصدار من Rust . تفضل بزيارة www.rust-lang.org/tools/install للحصول على مزيد من الإرشادات حول تثبيت Rust. سيؤدي هذا أيضًا إلى تثبيت Cargo ، مدير الحزم/المشروع الخاص بـ Rust.
؟ إذا كنت تستخدم نظام التشغيل Linux، فتأكد من تثبيت
gcc
(للرابط).ديب:
sudo apt install gcc
. Dnf:sudo dnf install gcc
.
؟ إذا كنت تستخدم نظام التشغيل MacOS، فتأكد من تثبيت Xcode وأدوات المطور الخاصة به عن طريق تشغيل
xcode-select --install
.
سيقوم الأمر التالي بتنزيل وتجميع Rustlings:
cargo install rustlings
rustup update
--locked
: cargo install rustlings --locked
بعد تثبيت Rustlings، قم بتشغيل الأمر التالي لتهيئة دليل rustlings/
:
rustlings init
rustlings
الأوامر... ( انقر للتوسيع )من المحتمل أنك تستخدم Linux وقمت بتثبيت Rust باستخدام مدير الحزم لديك.
يقوم Cargo بتثبيت الثنائيات في الدليل ~/.cargo/bin
. للأسف، لا يقوم مديرو الحزم غالبًا بإضافة ~/.cargo/bin
إلى متغير بيئة PATH
الخاص بك.
الحل هو…
~/.cargo/bin
يدويًا إلى PATH
rustup
: https://www.rust-lang.org/tools/installانتقل الآن إلى الدليل الذي تمت تهيئته حديثًا وقم بتشغيل Rustlings للحصول على مزيد من الإرشادات حول بدء التمارين:
cd rustlings/
rustlings
توصيتنا العامة هي VS Code مع البرنامج المساعد لمحلل الصدأ. لكن أي محرر يدعم محلل الصدأ يجب أن يكون كافيًا للعمل على التمارين.
أثناء العمل مع Rustlings، يرجى استخدام محطة طرفية حديثة للحصول على أفضل تجربة للمستخدم. يجب أن تكون المحطة الافتراضية على Linux وMac كافية. على نظام التشغيل Windows، نوصي باستخدام Windows Terminal.
يتم فرز التمارين حسب الموضوع ويمكن العثور عليها في الدليل الفرعي exercises/<topic>
. يوجد لكل موضوع ملف README.md
إضافي يحتوي على بعض الموارد لمساعدتك في البدء بالموضوع. نوصي بشدة بإلقاء نظرة عليها قبل البدء ️
تحتوي معظم التمارين على خطأ يمنعها من التجميع، والأمر متروك لك لإصلاحه! تحتوي بعض التمارين على اختبارات يجب اجتيازها لأداء التمرين ✅
ابحث عن TODO
و todo!()
لمعرفة ما تحتاج إلى تغييره. اطلب تلميحات عن طريق إدخال h
في وضع الساعة
بعد التهيئة، يمكن إطلاق Rustlings ببساطة عن طريق تشغيل الأمر rustlings
.
سيؤدي هذا إلى بدء وضع المراقبة الذي يرشدك خلال التمارين بترتيب محدد مسبقًا (ما نعتقد أنه الأفضل للقادمين الجدد). سيتم إعادة تشغيل التمرين الحالي تلقائيًا في كل مرة تقوم فيها بتغيير ملف التمرين في دليل exercises/
.
exercises/
... ( انقر للتوسيع )يمكنك إضافة علامة
--manual-run
(rustlings --manual-run
) لإعادة تشغيل التمرين الحالي يدويًا عن طريق إدخالr
في وضع المراقبة.الرجاء الإبلاغ عن المشكلة مع بعض المعلومات حول نظام التشغيل الخاص بك وما إذا كنت تقوم بتشغيل Rustlings في حاوية أو جهاز افتراضي (مثل WSL).
في وضع الساعة (بعد إطلاق rustlings
)، يمكنك إدخال l
لفتح قائمة التمارين التفاعلية.
تتيح لك القائمة…
c
: الاستمرار في تمرين آخر (تخطي بعض التمارين مؤقتًا أو العودة إلى تمرين سابق)r
: إعادة تعيين حالة التمرين المحدد وملفه (تحتاج إلى إعادة تحميل/إعادة فتح ملفه في المحرر الخاص بك بعد ذلك)انظر تذييل القائمة لجميع المفاتيح الممكنة.
إذا كنت بحاجة إلى أي مساعدة أثناء أداء التمارين ولم تكن التلميحات المضمنة مفيدة، فلا تتردد في طرح سؤال في فئة الأسئلة والأجوبة في المناقشات إذا لم يتم طرح سؤالك بعد
تمارين الطرف الثالث هي مجموعة من التمارين التي يحتفظ بها المجتمع. يمكنك استخدام نفس برنامج rustlings
الذي قمت بتثبيته مع cargo install rustlings
لتشغيلها:
هل ترغب في إنشاء مجموعتك الخاصة من تمارين Rustlings للتركيز على موضوع محدد؟ أو هل تريد ترجمة تمارين روستلينغز الأصلية؟ ثم اتبع الدليل الخاص بتمارين الطرف الثالث!
بمجرد الانتهاء من Rustlings، استخدم معرفتك الجديدة بشكل جيد! استمر في ممارسة مهاراتك في Rust من خلال إنشاء مشاريعك الخاصة أو المساهمة في Rustlings أو البحث عن مشاريع أخرى مفتوحة المصدر للمساهمة فيها.
إذا كنت تريد إزالة Rustlings من نظامك، فقم بتشغيل الأمر التالي:
cargo uninstall rustlings
انظر CONTRIBUTING.md؟
شكرا لجميع المساهمين الرائعين؟