آکادمی بنو/آموزش پایتون

ماژول‌ها در پایتون

بهنام نوبخت · ۱۴۰۵/۸/۲۷

ماژول‌ها (Modules) در پایتون به ما کمک می‌کنند کدهای برنامه را در فایل‌های جداگانه سازمان‌دهی کنیم و از قابلیت‌های آماده پایتون یا کدهایی که قبلاً نوشته‌ایم، دوباره استفاده کنیم. برای مثال، اگر بخواهیم محاسبات ریاضی انجام دهیم، تولید اعداد تصادفی را مدیریت کنیم یا تاریخ و زمان را نمایش دهیم، می‌توانیم از ماژول‌های آماده پایتون استفاده کنیم. در این آموزش یاد می‌گیریم ماژول چیست، چگونه با دستور import آن را وارد برنامه کنیم و چگونه ماژول اختصاصی خودمان را بسازیم.

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

ماژول (Module) یک فایل پایتون با پسوند .py است که می‌تواند شامل متغیرها، توابع و کلاس‌ها باشد.

برای مثال، فرض کنید برنامه‌ای داریم که در آن چندین بار به محاسبه مساحت مستطیل نیاز پیدا می‌کنیم. به‌جای اینکه تابع محاسبه مساحت را در چند قسمت برنامه تکرار کنیم، می‌توانیم آن را در یک فایل جداگانه قرار دهیم و هر زمان نیاز داشتیم، از آن استفاده کنیم.

مهم‌ترین مزایای استفاده از ماژول‌ها عبارت‌اند از:

  • استفاده مجدد از کد: از توابع و کلاس‌های نوشته‌شده در برنامه‌های مختلف استفاده می‌کنیم.

  • سازمان‌دهی بهتر: کدهای مرتبط را در فایل‌های جداگانه قرار می‌دهیم.

  • نگهداری آسان‌تر: تغییر و اصلاح کدها ساده‌تر می‌شود.

  • کاهش تکرار: نیازی نیست قابلیت‌های یکسان را چندین بار پیاده‌سازی کنیم.

استفاده از ماژول با دستور import

برای استفاده از یک ماژول، معمولاً از دستور import استفاده می‌کنیم.

ساختار کلی این دستور به شکل زیر است:

import module_name

برای مثال، ماژول math یکی از ماژول‌های استاندارد پایتون است که توابع و ثابت‌های ریاضی را در اختیار ما قرار می‌دهد.

import math

print(math.sqrt(25))
print(math.pi)

خروجی:

5.0
3.141592653589793

در این مثال:

  • import math ماژول ریاضی را وارد برنامه می‌کند.

  • math.sqrt(25) جذر عدد ۲۵ را محاسبه می‌کند.

  • math.pi مقدار تقریبی عدد پی را در اختیار ما قرار می‌دهد.

دقت کنید که هنگام استفاده از اعضای ماژول، در این روش نام ماژول را قبل از نام تابع یا متغیر می‌نویسیم.

وارد کردن بخش مشخصی از یک ماژول

گاهی فقط به یک تابع یا متغیر از ماژول نیاز داریم. در این شرایط می‌توانیم از دستور from ... import استفاده کنیم.

from math import sqrt, pi

print(sqrt(36))
print(pi)

خروجی:

6.0
3.141592653589793

در این روش، دیگر لازم نیست قبل از sqrt و pi عبارت math. را بنویسیم.

همچنین می‌توانیم فقط یک عضو را وارد کنیم:

from math import factorial

print(factorial(5))

خروجی:

120

تابع factorial() فاکتوریل عدد را محاسبه می‌کند. برای مثال، فاکتوریل ۵ برابر حاصل‌ضرب اعداد ۱ تا ۵ است.

نام‌گذاری کوتاه برای ماژول‌ها با as

با استفاده از کلمه کلیدی as می‌توانیم یک نام مستعار برای ماژول تعریف کنیم.

import math as m

print(m.sqrt(49))
print(m.ceil(4.2))

خروجی:

7.0
5

در این مثال، به‌جای نوشتن math از نام کوتاه m استفاده کرده‌ایم.

می‌توانیم هنگام وارد کردن یک تابع نیز نام مستعار تعیین کنیم:

from math import factorial as fact

print(fact(4))

خروجی:

24

استفاده از نام مستعار زمانی مفید است که نام کوتاه‌تر باعث خوانایی بهتر کد شود؛ بااین‌حال، بهتر است نام‌های واضح و قابل‌فهم را انتخاب کنیم.

ماژول‌های کاربردی و آماده پایتون

پایتون ماژول‌های استاندارد متعددی دارد که بدون نصب کتابخانه اضافی می‌توانیم از آن‌ها استفاده کنیم.

ماژول math برای محاسبات ریاضی

این ماژول شامل توابع و ثابت‌های ریاضی است.

import math

print(math.sqrt(64))
print(math.floor(4.9))
print(math.ceil(4.1))
print(math.factorial(5))

خروجی:

8.0
4
5
120

کاربرد توابع استفاده‌شده:

  • sqrt() محاسبه جذر عدد

  • floor() گرد کردن به سمت پایین تا عدد صحیح

  • ceil() گرد کردن به سمت بالا تا عدد صحیح

  • factorial() محاسبه فاکتوریل

ماژول random برای تولید مقادیر تصادفی

ماژول random برای تولید اعداد تصادفی و انتخاب تصادفی از میان چند مقدار استفاده می‌شود.

import random

number = random.randint(1, 10)

print(number)

خروجی نمونه:

7

عدد خروجی ممکن است در هر بار اجرا متفاوت باشد. تابع randint(1, 10) یک عدد صحیح تصادفی بین ۱ و ۱۰ تولید می‌کند؛ هر دو عدد ابتدا و انتها نیز در محدوده قرار دارند.

مثال دیگر:

import random

colors = ["قرمز", "آبی", "سبز", "زرد"]

print(random.choice(colors))

خروجی نمونه:

آبی

تابع choice() یک عضو تصادفی از لیست انتخاب می‌کند.

ماژول datetime برای تاریخ و زمان

برای کار با تاریخ و زمان می‌توانیم از ماژول datetime استفاده کنیم.

from datetime import datetime

now = datetime.now()

print(now)
print(now.year)
print(now.month)
print(now.day)

خروجی نمونه:

2026-10-18 09:30:00.123456
2026
10
18

مقدار دقیق خروجی به زمان اجرای برنامه بستگی دارد. همچنین year سال، month ماه و day روز را مشخص می‌کنند.

ماژول os برای کار با سیستم‌عامل

ماژول os امکاناتی برای تعامل با سیستم‌عامل فراهم می‌کند. برای مثال، می‌توانیم مسیر پوشه فعلی اجرای برنامه را دریافت کنیم.

import os

print(os.getcwd())

خروجی نمونه در ویندوز:

C:\Projects\Python

مسیر خروجی به محیطی که برنامه در آن اجرا می‌شود بستگی دارد.

ساخت ماژول اختصاصی در پایتون

علاوه بر ماژول‌های آماده، می‌توانیم ماژول‌های خودمان را نیز بسازیم.

فرض کنید می‌خواهیم برنامه‌ای برای محاسبه مساحت شکل‌های هندسی بنویسیم. بهتر است توابع محاسباتی را در یک فایل جداگانه قرار دهیم.

مرحله اول: ساخت فایل ماژول

دو فایل زیر را در یک پوشه ایجاد می‌کنیم:

python_project/
├── geometry.py
└── main.py

فایل geometry.py ماژول اختصاصی ما خواهد بود.

محتوای فایل geometry.py:

def rectangle_area(length, width):
    return length * width


def square_area(side):
    return side * side

در این فایل، دو تابع برای محاسبه مساحت مستطیل و مربع تعریف کرده‌ایم.

مرحله دوم: استفاده از ماژول در فایل دیگر

حالا در فایل main.py می‌توانیم توابع تعریف‌شده در geometry.py را وارد کنیم.

محتوای فایل main.py:

import geometry

rectangle = geometry.rectangle_area(5, 3)
square = geometry.square_area(4)

print("Rectangle area:", rectangle)
print("Square area:", square)

خروجی:

Rectangle area: 15
Square area: 16

در این مثال، پایتون فایل geometry.py را به‌عنوان یک ماژول شناسایی می‌کند و توابع آن را در اختیار فایل main.py قرار می‌دهد.

نکته مهم: در این مثال، هر دو فایل در یک پوشه قرار دارند. برای ساختارهای پوشه‌ای پیچیده‌تر، باید با مفهوم پکیج‌ها و نحوه مدیریت مسیرهای import نیز آشنا شویم.

استفاده از from ... import در ماژول اختصاصی

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

محتوای فایل main.py:

from geometry import rectangle_area

result = rectangle_area(8, 4)

print(result)

خروجی:

32

در این روش، فقط تابع rectangle_area را وارد کرده‌ایم و برای فراخوانی آن نیازی به نوشتن geometry. نداریم.

آشنایی با if __name__ == "__main__"

هنگام کار با ماژول‌های اختصاصی، ممکن است بخواهیم بخشی از کد فقط زمانی اجرا شود که فایل مستقیماً اجرا شده باشد، نه زمانی که آن را در فایل دیگری وارد می‌کنیم.

برای این کار از شرط زیر استفاده می‌کنیم:

if __name__ == "__main__":
    print("This file is running directly.")

برای درک بهتر، فایل geometry.py را به شکل زیر تغییر می‌دهیم:

def rectangle_area(length, width):
    return length * width


if __name__ == "__main__":
    print(rectangle_area(5, 3))

اگر فایل geometry.py را مستقیماً اجرا کنیم، خروجی زیر نمایش داده می‌شود:

15

اما اگر آن را در فایل دیگری با دستور import geometry وارد کنیم، تابع تعریف می‌شود، ولی دستور print() داخل شرط اجرا نمی‌شود.

این الگو برای آزمایش یک ماژول و جلوگیری از اجرای ناخواسته کدها هنگام وارد کردن آن بسیار کاربردی است.

تفاوت ماژول و پکیج در پایتون

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

  • ماژول (Module): معمولاً یک فایل پایتون مانند geometry.py است.

  • پکیج (Package): ساختاری برای سازمان‌دهی چند ماژول مرتبط در کنار یکدیگر است؛ معمولاً در قالب یک پوشه.

برای مثال، ساختار زیر را در نظر بگیرید:

python_project/
├── main.py
└── utilities/
    ├── __init__.py
    ├── geometry.py
    └── text_tools.py

در این ساختار، پوشه utilities یک پکیج است و فایل‌های geometry.py و text_tools.py ماژول‌های آن هستند.

در نسخه‌های جدید پایتون، ساختارهای پکیج بدون فایل __init__.py نیز امکان‌پذیرند؛ اما این فایل همچنان در بسیاری از پروژه‌ها برای مشخص کردن و پیکربندی پکیج استفاده می‌شود.

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

هنگام استفاده از ماژول‌ها، ممکن است با چند خطای رایج روبه‌رو شویم.

خطای ModuleNotFoundError

این خطا معمولاً زمانی رخ می‌دهد که پایتون نتواند ماژول موردنظر را پیدا کند.

برای مثال:

import mymodule

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

برای رفع آن، نام ماژول، محل قرارگیری فایل و محیط اجرای برنامه را بررسی کنید.

۲. نام‌گذاری فایل با نام ماژول‌های استاندارد

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

برای مثال، نام‌گذاری فایل اختصاصی به‌صورت random.py یا math.py ممکن است باعث تداخل با ماژول اصلی شود.

به‌جای آن، نام‌های مشخصی مانند random_helpers.py یا geometry.py انتخاب کنید.

۳. اشتباه گرفتن نام ماژول با نام فایل

فرض کنید نام فایل ما geometry.py است. برای وارد کردن آن می‌نویسیم:

import geometry

پسوند .py در دستور import نوشته نمی‌شود.

تمرین‌های ماژول‌ها در پایتون

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

تمرین اول: استفاده از ماژول math

برنامه‌ای بنویسید که ماژول math را وارد کند و موارد زیر را نمایش دهد:

  • جذر عدد ۸۱

  • مقدار عدد پی

  • فاکتوریل عدد ۶

تمرین دوم: انتخاب تصادفی

با استفاده از ماژول random، یک لیست شامل پنج نام بسازید و یک نام را به‌صورت تصادفی انتخاب و نمایش دهید.

تمرین سوم: ساخت ماژول اختصاصی

دو فایل با نام‌های calculator.py و main.py بسازید.

در فایل calculator.py، توابع زیر را تعریف کنید:

  • تابع جمع دو عدد

  • تابع تفریق دو عدد

  • تابع ضرب دو عدد

سپس در فایل main.py این توابع را وارد کنید و نتیجه چند محاسبه را نمایش دهید.

تمرین چهارم: جلوگیری از اجرای ناخواسته کد

در فایل calculator.py یک بخش آزمایشی با استفاده از شرط if __name__ == "__main__": بنویسید. بررسی کنید که با اجرای مستقیم فایل، بخش آزمایشی اجرا شود؛ اما با وارد کردن ماژول در main.py، آن بخش اجرا نشود.

جمع‌بندی

در این آموزش یاد گرفتیم که ماژول‌ها در پایتون برای سازمان‌دهی کد و استفاده مجدد از توابع، متغیرها و کلاس‌ها به کار می‌روند. با دستورهای import و from ... import ماژول‌های آماده و اختصاصی را وارد برنامه کردیم، با ماژول‌های کاربردی مانند math، random، datetime و os آشنا شدیم و یک ماژول اختصاصی ساختیم. همچنین تفاوت ماژول و پکیج و کاربرد شرط if __name__ == "__main__": را بررسی کردیم.

۱۰

نظرات

کد در دسترس نیست

هنوز نظری ثبت نشده است.