ماژولها در پایتون
بهنام نوبخت · ۱۴۰۵/۸/۲۷
ماژولها (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__": را بررسی کردیم.
نظرات
هنوز نظری ثبت نشده است.