روز ۲۸: ماژول‌ها در Rust چیستند و چرا اهمیت دارند؟

با بزرگ‌تر شدن پروژه‌های Rust، مدیریت فایل‌ها، کدها و وابستگی‌ها به یکی از چالش‌های اصلی تبدیل می‌شود. اگر همه چیز در یک فایل نوشته شود، خیلی زود کد غیرقابل نگهداری و گیج‌کننده خواهد شد. Rust برای حل این مشکل، سیستم ماژول‌ها را معرفی کرده است که به کمک آن می‌توان کد را به بخش‌های منطقی، قابل فهم و ایمن تقسیم کرد. ماژول‌ها در Rust فقط برای مرتب‌سازی نیستند، بلکه نقش بسیار مهمی در کنترل دسترسی و امنیت کد دارند. درک درست mod، pub و use یکی از پایه‌های معماری تمیز در Rust محسوب می‌شود.

مفهوم mod و ساختار ماژول‌ها در Rust

کلمه کلیدی mod برای تعریف یک ماژول جدید استفاده می‌شود. ماژول‌ها می‌توانند درون یک فایل یا در فایل‌های جداگانه تعریف شوند و ساختار درختی پروژه را شکل دهند. هر ماژول یک فضای نام مستقل ایجاد می‌کند که از تداخل نام‌ها جلوگیری می‌کند. این ویژگی در پروژه‌های بزرگ اهمیت زیادی دارد، زیرا اجازه می‌دهد چندین تابع یا struct با نام‌های مشابه اما در ماژول‌های مختلف وجود داشته باشند بدون اینکه مشکلی ایجاد شود. ماژول‌ها به Rust کمک می‌کنند تا کدها قابل پیش‌بینی و منظم باقی بمانند.

mod math {
    pub fn add(a: i32, b: i32) -> i32 {
        a + b
    }
}

در این مثال، یک ماژول به نام math تعریف شده که شامل یک تابع است. بدون استفاده از pub، این تابع از بیرون ماژول قابل دسترسی نخواهد بود.

چرا pub برای کنترل دسترسی حیاتی است؟

یکی از تفاوت‌های مهم Rust با بسیاری از زبان‌ها، پیش‌فرض private بودن همه چیز است. اگر صراحتاً چیزی را public نکنید، از خارج ماژول قابل دسترسی نخواهد بود. این رویکرد باعث می‌شود APIهای شما ناخواسته باز نشوند و از سوءاستفاده یا وابستگی‌های اشتباه جلوگیری شود. استفاده از pub یک تصمیم آگاهانه است، نه یک پیش‌فرض. این موضوع به طرز چشمگیری کیفیت طراحی نرم‌افزار را بالا می‌برد و شما را مجبور می‌کند درباره سطح دسترسی هر بخش از کد فکر کنید.

mod user {
    pub struct User {
        pub username: String,
        password: String,
    }
}

در این مثال، struct و فیلد username عمومی هستند، اما password فقط داخل همان ماژول قابل استفاده است. این دقیقاً همان چیزی است که در طراحی امن انتظار داریم.

استفاده از use برای ساده‌سازی مسیرها

وقتی پروژه بزرگ می‌شود، مسیرهای دسترسی به ماژول‌ها طولانی و ناخوانا می‌شوند. Rust برای حل این مشکل کلمه کلیدی use را ارائه کرده است. use اجازه می‌دهد مسیرهای طولانی را یک بار وارد کرده و بعد به شکل ساده‌تری از آن‌ها استفاده کنیم. این کار هم خوانایی کد را افزایش می‌دهد و هم احتمال خطا را کاهش می‌دهد. استفاده درست از use یکی از نشانه‌های کد تمیز در Rust است.

use crate::math::add;

fn main() {
    let result = add(2, 3);
    println!("{}", result);
}

در این مثال، به جای نوشتن مسیر کامل در هر بار استفاده، تابع add مستقیماً قابل دسترسی شده است.

ساختار فایل‌ها و ماژول‌ها در پروژه‌های واقعی

در پروژه‌های واقعی Rust، معمولاً هر ماژول در فایل یا پوشه جداگانه قرار می‌گیرد. Rust به صورت خودکار فایل‌ها را بر اساس نام ماژول‌ها شناسایی می‌کند. اگر یک ماژول شامل زیرماژول باشد، معمولاً به صورت یک پوشه با فایل mod.rs یا فایل‌های هم‌نام تعریف می‌شود. این ساختار باعث می‌شود پروژه از نظر ذهنی شبیه یک درخت منطقی باشد و پیدا کردن کدها بسیار ساده‌تر شود.

src/
 ├── main.rs
 ├── auth.rs
 └── utils/
     ├── mod.rs
     └── helper.rs

این ساختار یکی از رایج‌ترین الگوها در پروژه‌های حرفه‌ای Rust است و به خوبی با فلسفه ماژول‌محور زبان هماهنگ است.

تفاوت crate، module و package در Rust

یکی از نقاطی که بسیاری از تازه‌کارها را گیج می‌کند، تفاوت بین crate، module و package است. crate کوچک‌ترین واحد کامپایل در Rust است و می‌تواند یک برنامه یا یک کتابخانه باشد. module بخشی از یک crate است که برای سازمان‌دهی کد استفاده می‌شود. package مجموعه‌ای از crateهاست که معمولاً توسط Cargo مدیریت می‌شود. درک این تفاوت‌ها کمک می‌کند بهتر بفهمید mod و use دقیقاً در کجای این ساختار قرار می‌گیرند و چرا مسیرها با crate شروع می‌شوند.

استفاده از pub use برای طراحی API تمیز

گاهی اوقات می‌خواهید ساختار داخلی پروژه مخفی بماند، اما یک API ساده و تمیز به بیرون ارائه دهید. Rust این امکان را با pub use فراهم می‌کند. با این تکنیک می‌توان آیتم‌ها را از ماژول‌های داخلی re-export کرد بدون اینکه مصرف‌کننده از ساختار داخلی خبر داشته باشد. این الگو در کتابخانه‌های حرفه‌ای Rust بسیار رایج است و نشان‌دهنده طراحی سطح بالا است.

pub use crate::utils::helper::format_name;

با این کار، کاربران فقط با یک مسیر ساده کار می‌کنند، حتی اگر پیاده‌سازی داخلی پیچیده باشد.

خطاهای رایج در کار با ماژول‌ها

یکی از رایج‌ترین خطاها در کار با ماژول‌ها، فراموش کردن pub یا تعریف نادرست مسیرهاست. بسیاری از خطاهای کامپایل Rust در مراحل اولیه به سیستم ماژول‌ها مربوط می‌شوند، اما خبر خوب این است که پیام‌های خطای Rust معمولاً بسیار دقیق و راهگشا هستند. یاد گرفتن خواندن این پیام‌ها بخشی از مهارت حرفه‌ای شدن با Rust محسوب می‌شود. با تمرین، سیستم ماژول‌ها به جای مانع، به یکی از بهترین ابزارهای شما تبدیل خواهد شد.

جمع‌بندی ماژول‌ها در Rust

ماژول‌ها قلب سازمان‌دهی کد در Rust هستند و بدون درک عمیق mod، pub و use نمی‌توان پروژه‌های بزرگ و تمیز نوشت. Rust با پیش‌فرض private بودن و کنترل دقیق دسترسی، شما را به سمت طراحی امن و قابل نگهداری سوق می‌دهد. در این روز یاد گرفتیم چگونه کدها را تقسیم کنیم، دسترسی‌ها را کنترل کنیم و APIهای حرفه‌ای طراحی نماییم. این مبحث پایه‌ای است برای ورود به معماری‌های بزرگ‌تر و کار با crateها و کتابخانه‌های خارجی در روزهای آینده.