كود نظيف في Rust: المبادئ والأمثلة العملية

كود نظيف في Rust: المبادئ والأمثلة العملية

في عالم تطوير البرمجيات، كتابة كود يعمل هي نصف المهمة فقط. البراعة الحقيقية تظهر في القدرة على إنشاء كود يسهل قراءته وصيانته وتوسيعه. بالنسبة للغة Rust، المعروفة بأمان الذاكرة والأداء، تكتسب مبادئ الكود النظيف (Clean Code) أهمية خاصة. في هذه المقالة، سنستعرض المبادئ الأساسية لكتابة كود نظيف في Rust وندعمها بأمثلة عملية.

لماذا الكود النظيف مهم لـ Rust؟

Rust هي لغة قوية بنظام فريد للملكية (ownership) والاقتراض (borrowing). على الرغم من صرامتها، يمكن بسهولة إنشاء كود معقد يصعب صيانته. يساعد الكود النظيف في:

• تقليل عدد الأخطاء في مرحلتي الترجمة والتنفيذ.
• تبسيط العمل الجماعي ومراجعة الكود.
• زيادة إنتاجية التطوير من خلال قابلية القراءة.
• جعل الكود موثقًا ذاتيًا.

المبدأ 1: تسمية المتغيرات والدوال

الاسم الجيد هو أساس الكود النظيف. في Rust، حيث الأنواع صارمة، هذا مهم بشكل خاص. تجنب المتغيرات المكونة من حرف واحد (باستثناء مؤشرات الحلقات) واستخدم snake_case للمتغيرات والدوال.

مثال سيء:

fn c(a: &[i32]) -> i32 {    let mut s = 0;    for i in a {        s += i;    }    s}

مثال جيد (كود نظيف):

fn calculate_sum(numbers: &[i32]) -> i32 {    let mut sum = 0;    for number in numbers {        sum += number;    }    sum}

توصيات:

• استخدم أفعالًا للدوال: process_data(), validate_input().
• استخدم أسماء للمتغيرات: user_count, error_message.
• تجنب الاختصارات: calc → calculate, tmp → temporary_value.

المبدأ 2: دوال صغيرة ومسؤولية واحدة

يجب أن تقوم كل دالة بشيء واحد فقط. في Rust، هذا يساعد بشكل خاص عند العمل مع الإغلاقات (closures) والمكررات (iterators).

مثال سيء (الدالة تقوم بأكثر من اللازم):

fn process_user_data(users: &[User]) -> Vec<String> {    let mut result = Vec::new();    for user in users {        if user.age > 18 {            let name = user.name.to_uppercase();            result.push(format!("Adult: {}", name));        } else {            result.push(format!("Minor: {}", user.name));        }    }    result}

مثال جيد (تقسيم إلى دوال صغيرة):

fn classify_user(user: &User) -> &str {    if user.age > 18 { "Adult" } else { "Minor" }}

fn format_user_name(user: &User) -> String {    let classification = classify_user(user);    format!("{}: {}", classification, user.name)}

fn process_user_data(users: &[User]) -> Vec<String> {    users.iter().map(format_user_name).collect()}

لاحظ: في المثال الثاني، استخدمنا المكررات مما يجعل الكود أكثر تعبيرًا (idiomatic) في Rust.

المبدأ 3: التعامل مع الأخطاء وOption/Result

تقدم Rust أنواعًا قوية Option و Result لمعالجة الأخطاء. الكود النظيف يتطلب معالجة صريحة لجميع الحالات المحتملة.

مثال سيء (تجاهل الأخطاء):

fn divide(a: f64, b: f64) -> f64 {    if b == 0.0 {        panic!("Division by zero!");    }    a / b}

مثال جيد (معالجة نظيفة للأخطاء):

fn divide(a: f64, b: f64) -> Result<f64, String> {    if b == 0.0 {        Err("Division by zero