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

ماژول چیست؟

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

import کردن ماژول

# وارد کردن کل ماژول
import math
print(math.pi)         # 3.14159...
print(math.sqrt(16))   # 4.0

from...import

# وارد کردن بخش خاصی
from math import pi, sqrt
print(pi)        # 3.14159...
print(sqrt(16))  # 4.0

# وارد کردن همه (توصیه نمی‌شود)
from math import *

اسم مستعار (alias)

import math as m
print(m.pi)  # 3.14159...

import numpy as np  # رایج در علم داده

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

ماژول	کاربرد
math	توابع ریاضی
random	اعداد تصادفی
datetime	تاریخ و زمان
json	کار با JSON
os	سیستم‌عامل
sys	سیستم
re	عبارات منظم
string	توابع رشته
collections	ساختارهای داده

ساخت ماژول سفارشی

فایلی به نام mymath.py بسازید:

# mymath.py
def add(a, b):
    return a + b

def multiply(a, b):
    return a * b

PI = 3.14159

سپس در فایل دیگر:

# main.py
import mymath
print(mymath.add(2, 3))      # 5
print(mymath.PI)             # 3.14159

from mymath import multiply
print(multiply(4, 5))        # 20

متغیر __name__

برای تشخیص اینکه فایل مستقیم اجرا می‌شود یا import شده:

# mymodule.py
def greet():
    print("سلام!")

if __name__ == "__main__":
    # فقط وقتی فایل مستقیم اجرا شود
    greet()

dir() — لیست محتویات ماژول

import math
print(dir(math))  # لیست همه توابع و متغیرها

بسته‌ها (Packages)

بسته پوشه‌ای از ماژول‌هاست. هر پوشه باید فایل __init__.py داشته باشد:

myproject/
├── main.py
└── mypackage/
    ├── __init__.py
    ├── module1.py
    └── module2.py

# import از بسته
from mypackage import module1

نصب ماژول‌های خارجی با pip

pip install requests
pip install numpy
pip install pandas

خلاصه

عملیات	سینتکس
import کل	import math
import بخش	from math import pi
alias	import math as m
ساخت ماژول	فایل .py
نصب خارجی	pip install name