تفاوت ماژول و پکیج در پایتون و نحوه ساخت آن‌ها

با گسترش پروژه‌های برنامه‌نویسی، نوشتن تمام کدها در یک فایل واحد غیرممکن و مدیریت آن بسیار دشوار می‌شود. زبان پایتون برای سازماندهی بهتر کدها، مفاهیمی به نام ماژول (Module) و پکیج (Package) را معرفی کرده است. در این مقاله از پای شو، تفاوت‌های کلیدی بین این دو مفهوم را بررسی کرده و نحوه ساخت و استفاده از آن‌ها را یاد می‌گیریم.

ماژول (Module) در پایتون چیست؟

به زبان ساده، هر فایل پایتونی با پسوند .py که حاوی توابع، متغیرها و کلاس‌ها باشد، یک ماژول محسوب می‌شود. ماژول‌ها به شما اجازه می‌دهند کدهای مرتبط را در یک فایل مجزا قرار دهید و هر زمان که نیاز بود، آن‌ها را به فایل‌های دیگر وارد (Import) کنید.

نحوه ساخت و استفاده از ماژول

فرض کنید فایلی به نام math_utils.py می‌سازیم و کدهای زیر را درون آن قرار می‌دهیم:

# فایل: math_utils.py

def square(x):
    return x ** 2

def cube(x):
    return x ** 3

PI = 3.14159

اکنون برای استفاده از این ماژول در فایل اصلی برنامه‌تان، کافی است آن را Import کنید:

# فایل اصلی برنامه‌
import math_utils

print(math_utils.square(4))  # خروجی: 16
print(math_utils.PI)         # خروجی: 3.14159

همچنین می‌توانید با استفاده از کلمه کلیدی from بخش خاصی از ماژول را فراخوانی کنید:

from math_utils import cube

print(cube(3))  # خروجی: 27

پکیج (Package) در پایتون چیست؟

وقتی تعداد ماژول‌ها بسیار زیاد می‌شود، نگهداری همه آن‌ها در یک پوشه بی‌نظم خواهد شد. اینجاست که پکیج به کمک ما می‌آید. پکیج مجموعه‌ای از چندین ماژول است که در قالب یک پوشه (Directory) ساختاریافته قرار می‌گیرند.

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

ساختار یک پکیج در پایتون

برای اینکه پایتون یک پوشه معمولی را به عنوان یک پکیج شناسایی کند، آن پوشه باید شامل یک فایل ویژه به نام __init__.py باشد (البته در نسخه‌های جدید پایتون این فایل به صورت پیش‌فرض الزامی نیست، اما وجود آن برای سازگاری و تعریف تنظیمات پکیج همچنان توصیه می‌شود).

ساختار یک پکیج فرضی به نام my_package به شکل زیر است:

my_package/
│
├── __init__.py
├── calculator.py
└── string_tools.py

نحوه ساخت و استفاده از پکیج

فرض کنید داخل پوشه my_package فایلی به نام calculator.py داریم که کدهای ریاضی در آن قرار دارد. برای استفاده از این ماژول درون پکیج، به شکل زیر عمل می‌کنیم:

# روش اول: ایمپورت کردن ماژول به صورت کامل
import my_package.calculator

result = my_package.calculator.square(5)
print(result)

# روش دوم: استفاده از from برای دسترسی مستقیم
from my_package import calculator

print(calculator.cube(2))

تفاوت‌های اصلی ماژول و پکیج در یک نگاه

برای درک بهتر تفاوت این دو مفهوم، به موارد زیر دقت کنید:

۱. مقیاس و ساختار: ماژول تنها یک فایل منفرد با پسوند .py است، در حالی که پکیج یک پوشه (Directory) است که می‌تواند شامل چندین ماژول مختلف (و حتی زیر‌پکیج‌ها) باشد. ۲. هدف اصلی: ماژول برای گروه‌بندی توابع و کلاس‌های مرتبط در یک فایل استفاده می‌شود، در حالی که پکیج برای مدیریت ساختاریافته تعداد زیادی از ماژول‌ها در قالب یک پروژه بزرگ کاربرد دارد. ۳. شناسایی توسط پایتون: ماژول با یک فایل متنی ساده شناخته می‌شود، اما پکیج نیازمند یک پوشه با ساختار مشخص و معمولاً فایل __init__.py است.

جمع‌بندی

استفاده صحیح از ماژول‌ها و پکیج‌ها پایه‌ورزی برنامه‌نویسی تمیز و ماژولار (Modular Programming) در پایتون است. با کمک این ابزارها که در این مقاله از سایت پای شو بررسی کردیم، می‌توانید کدهای خود را به بخش‌های کوچک‌تر و قابل‌مدیریت تقسیم کنید، از تکرار کد جلوگیری نمایید و توسعه پروژه‌های بزرگ را به امری ساده‌تر تبدیل کنید.