KAHIBARO Bookshelves
Discord Login Register

12.2. وارد کردن ماژول‌ها

تفاوت «ماژول» و «import» در عمل

در این بخش فرض می‌کنیم که پیش‌تر در همین فصل با مفهوم کلی «کتابخانه» و «ماژول» آشنا شده‌اید. اینجا تمرکز ما فقط روی شیوه‌های مختلف وارد کردن ماژول‌ها در کد پایتون است و این‌که هر روش چه اثری روی کد شما می‌گذارد.

ماژول (مثلاً math، random یا فایلی مثل my_utils.py) در واقع فایلی است که داخلش کد پایتون نوشته شده و می‌توانیم از توابع، کلاس‌ها و متغیرهای آن در برنامهٔ خودمان استفاده کنیم. برای دسترسی به آن‌ها باید از دستورهای مختلف import استفاده کنیم.

در ادامه مهم‌ترین الگوهای استفاده از import را می‌بینید.

وارد کردن کامل یک ماژول

ساده‌ترین و رایج‌ترین حالت:

import math
print(math.sqrt(16))   # استفاده از تابع sqrt از داخل ماژول math

نکته‌ها:

  • بعد از import math، نام ماژول (math) یک متغیر سراسری در برنامهٔ شما می‌شود.
  • برای دسترسی به هر عضو ماژول از نقطه استفاده می‌کنید: math.sqrt، math.pi و …
  • این روش:
    • خوانایی خوبی دارد؛ هر کسی ببیند math.sqrt است، متوجه می‌شود تابع از کجاست.
    • ریسک تداخل اسم را کم می‌کند (کمتر با نام توابع/متغیرهای خودتان قاطی می‌شود).

این روش برای یادگیری و برای بیشتر برنامه‌های ساده روش پیشنهادی است.

وارد کردن با نام مستعار (`as`)

گاهی نام ماژول طولانی است یا قرار است زیاد از آن استفاده کنید؛ در این صورت می‌توانید یک نام کوتاه‌تر به آن بدهید:

import math as m
print(m.sqrt(25))
print(m.pi)

یا برای مثال مشهور:

import numpy as np
import pandas as pd

نکته‌ها:

  • فقط نامی که در کد خودتان استفاده می‌کنید عوض می‌شود؛ خود ماژول همان ماژول است.
  • از این روش برای کوتاه و تمیز کردن کد استفاده می‌شود.
  • سعی کنید نام مستعار واضح انتخاب کنید؛ مثلاً math → m قابل حدس است، اما math → x گیج‌کننده است.

وارد کردن فقط بعضی از اعضای ماژول

اگر فقط به یکی دو تابع یا متغیر از یک ماژول نیاز دارید، می‌توانید فقط همان‌ها را وارد کنید:

from math import sqrt, pi
print(sqrt(9))  # دیگر نیازی نیست بنویسیم math.sqrt
print(pi)

نکته‌ها:

  • الان نام‌های sqrt و pi مستقیماً در فضای نام (namespace) برنامهٔ شما وجود دارند.
  • نیازی نیست بنویسید math.sqrt؛ ولی دیگر مشخص نیست این‌ها دقیقاً از کجا آمده‌اند، مگر با نگاه کردن به بالای فایل (جایی که import نوشته شده است).

این روش زمانی مفید است که:

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

اما مراقب تداخل نام باشید؛ اگر خودتان هم متغیری به نام pi تعریف کنید، یکی از آن‌ها روی دیگری می‌افتد.

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

همان‌طور که می‌توانیم برای ماژول نام مستعار تعیین کنیم، می‌توانیم برای توابع و متغیرهایی که از آن‌ها وارد می‌کنیم هم نام مستعار بگذاریم:

from math import sqrt as r, pi as PI
print(r(36))
print(PI)

این کار در موارد زیر به درد می‌خورد:

  • وقتی نام عضو طولانی است.
  • وقتی می‌خواهید تفاوت بین ثابت‌ها و متغیرهای معمولی را در نام‌گذاری مشخص کنید (مثلاً با حروف بزرگ).

وارد کردن «همه چیز» با `from module import *`

پایتون اجازه می‌دهد کل محتوای یک ماژول را با * وارد کنید:

from math import *
print(sqrt(16))
print(pi)

این کار به این معناست که «تقریباً» تمام اعضای عمومی ماژول (math) وارد فضای نام فعلی می‌شوند.

اما این روش تقریباً همیشه پیشنهاد نمی‌شود، به‌خصوص برای تازه‌کارها، چون:

  • معلوم نیست هر نامی که در کد استفاده می‌کنید از کجا آمده.
  • احتمال تداخل نام‌ها بسیار بالا می‌رود:
    • اگر خودتان تابعی به نام sqrt بنویسید، ممکن است روی math.sqrt بیفتد.
  • خوانندهٔ کد باید حدس بزند که چه چیزهایی از ماژول وارد شده‌اند.

بهتر است به‌جای این روش، از یکی از روش‌های قبلی (به‌خصوص import module یا from module import name1, name2) استفاده کنید.

چندین ماژول در یک فایل

می‌توانید در یک فایل پایتون چندین ماژول را با هم وارد کنید:

import math
import random
x = math.sqrt(49)
y = random.randint(1, 10)
print(x, y)

یا به شکل فشرده‌تر در یک خط:

import math, random

ولی معمولاً برای خواناتر شدن، هر ماژول را در یک خط جداگانه می‌نویسیم:

import math
import random
import datetime

نکته‌های مرتب‌سازی:

  • معمول است که importها را بالای فایل، در ابتدای برنامه بنویسیم.
  • معمولاً ترتیب پیشنهادی:
    1. ماژول‌های استاندارد پایتون (مثل math, random, os)
    2. کتابخانه‌های خارجی (مثلاً بعداً numpy, pandas)
    3. ماژول‌های خودتان (فایل‌های پروژهٔ خودتان)

وارد کردن ماژول‌های خودتان (فایل‌های دیگر)

اگر فایلی به نام helpers.py در همان پوشهٔ فایل اصلی شما وجود داشته باشد، می‌توانید آن را مثل یک ماژول وارد کنید:

# فایل helpers.py
def salam():
    print("سلام از helpers!")
# فایل main.py
import helpers
helpers.salam()

نکته‌ها:

  • نام فایل (helpers.py) بدون پسوند .py به عنوان نام ماژول استفاده می‌شود (helpers).
  • هر دو فایل باید در یک پوشه (دایرکتوری) باشند، مگر این‌که ساختار پوشه‌ها و پکیج‌ها را (در مباحث پیشرفته‌تر) تنظیم کرده باشید.

همچنین می‌توانید از from helpers import salam هم استفاده کنید:

from helpers import salam
salam()

وارد کردن فقط هنگام نیاز (import درون تابع)

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

def calc():
    import math
    return math.sqrt(81)
print(calc())

این کار گاهی برای به‌تعویق انداختن بارگذاری یک کتابخانهٔ سنگین استفاده می‌شود، ولی برای شروع بهتر است تمام importها را بالای فایل بنویسید تا کد خواناتر و قابل‌پیش‌بینی‌تر باشد.

نام فضای فعلی و جلوگیری از تداخل

هر متغیری که در فایل شما تعریف شود، در فضای نام (namespace) آن فایل قرار می‌گیرد. زمانی که می‌نویسید:

from math import pi

دیگر متغیری با نام pi در فضای نام شما وجود دارد. اگر بعداً بنویسید:

pi = 3

مقدار pi شما دیگر آن ثابت math.pi نخواهد بود، بلکه این مقدار جدید را می‌گیرد. برای جلوگیری از این‌گونه تداخل‌ها:

  • یا از import math استفاده کنید و همیشه بنویسید math.pi.
  • یا اگر مجبورید از from math import pi استفاده کنید، سعی کنید روی همان نام چیزی تعریف نکنید.

این‌که چه روشی انتخاب می‌کنید، به سلیقه و سبک کدنویسی بستگی دارد، ولی در شروع کار، استفاده از import module امن‌تر و شفاف‌تر است.

چگونه بفهمیم چه چیزی در یک ماژول وجود دارد؟

گاهی می‌خواهید ببینید داخل یک ماژول چه تابع‌ها و متغیرهایی هست. در حالت تعاملی پایتون (یا در یک اسکریپت برای آزمون) می‌توانید از dir() استفاده کنید:

import math
print(dir(math))

این دستور یک لیست از نام اعضای ماژول به شما می‌دهد. همچنین می‌توانید از تابع help() برای گرفتن توضیح دربارهٔ ماژول یا یک تابع خاص استفاده کنید (توضیح کامل‌تر دربارهٔ مستندات و help() می‌تواند در بخش‌های دیگر بیاید، اینجا فقط ایدهٔ کلی را می‌بینید):

import math
help(math.sqrt)

نکته‌های عملی هنگام استفاده از import

  • تا حد امکان از import module استفاده کنید، مخصوصاً وقتی تازه شروع کرده‌اید.
  • از from module import name زمانی استفاده کنید که:
    • آن نام را خیلی زیاد استفاده می‌کنید،
    • و مطمئنید با نام‌های دیگر تداخل ندارد.
  • از from module import * پرهیز کنید؛
    • هم کد را مبهم می‌کند،
    • هم پیدا کردن خطاها را سخت‌تر.
  • importها را همیشه در بالای فایل گروه‌بندی و مرتب کنید تا خواندن پروژه برای خودتان و دیگران راحت‌تر باشد.

این الگوهای مختلف وارد کردن ماژول‌ها پایهٔ کار با کتابخانه‌های مختلف پایتون هستند؛ در بخش‌های بعدی همین فصل با نمونه‌های واقعی و رایج (مثل math, random, datetime و نصب کتابخانه‌های خارجی) این مفاهیم را در عمل خواهید دید.

Views: 0

Comments

Please login to add a comment.

Don't have an account? Register now!

Where to Move

Move chapter:

  • ☰ 1. فصل ۱: برنامه‌نویسی چیست؟
    • ☰ 1.1. برنامهٔ کامپیوتری چیست؟
      • ☰ 1.2. پایتون چیست؟
        • ☰ 1.3. پایتون کجا استفاده می‌شود؟
          • ☰ 1.4. چگونه برنامه‌نویسی به حل مسائل کمک می‌کند
            • ☰ 1.5. اولین برنامهٔ پایتون شما
            • ☰ 2. فصل ۲: راه‌اندازی پایتون
              • ☰ 2.1. نصب پایتون (ویندوز / macOS / لینوکس)
                • ☰ 2.2. استفاده از پایتون در ترمینال
                  • ☰ 2.3. استفاده از یک IDE (IDLE / VS Code)
                    • ☰ 2.4. اجرای اسکریپت‌های پایتون
                      • ☰ 2.5. حالت تعاملی پایتون
                      • ☰ 3. فصل ۳: متغیرها و انواع داده
                        • ☰ 3.1. متغیر چیست؟
                          • ☰ 3.2. ایجاد متغیرها
                            • ☰ 3.3. اعداد (`int`، `float`)
                              • ☰ 3.4. متن (`str`)
                                • ☰ 3.5. مقادیر بولی (`True`، `False`)
                                  • ☰ 3.6. بررسی نوع داده با `type()`
                                  • ☰ 4. فصل ۴: عملیات پایه
                                    • ☰ 4.1. عملیات حسابی
                                      • ☰ 4.2. کار با اعداد
                                        • ☰ 4.3. عملیات روی رشته‌ها
                                          • ☰ 4.4. ترکیب متن و متغیرها
                                            • ☰ 4.5. کامنت‌ها در پایتون
                                            • ☰ 5. فصل ۵: ورودی و خروجی کاربر
                                              • ☰ 5.1. دریافت ورودی از کاربر
                                                • ☰ 5.2. تبدیل ورودی به عدد
                                                  • ☰ 5.3. قالب‌بندی خروجی
                                                    • ☰ 5.4. نوشتن برنامه‌های تعاملی
                                                    • ☰ 6. فصل ۶: شرط‌ها (if / else)
                                                      • ☰ 6.1. عملگرهای مقایسه‌ای
                                                        • ☰ 6.2. عملگرهای منطقی
                                                          • ☰ 6.3. if، elif، else
                                                            • ☰ 6.4. شرط‌های تو در تو
                                                              • ☰ 6.5. اشتباهات رایج مبتدیان
                                                              • ☰ 7. فصل ۷: حلقه‌ها
                                                                • ☰ 7.1. چرا حلقه‌ها مفید هستند؟
                                                                  • ☰ 7.2. حلقه‌های while
                                                                    • ☰ 7.3. حلقه‌های for
                                                                      • ☰ 7.4. شمارنده‌های حلقه
                                                                        • ☰ 7.5. break و continue
                                                                          • ☰ 7.6. تمرین‌های حلقه
                                                                          • ☰ 8. فصل ۸: مجموعه‌های داده
                                                                            • ☰ 8.1. لیست‌ها (Lists)
                                                                              • ☰ 8.2. تاپل‌ها (Tuples)
                                                                                • ☰ 8.3. دیکشنری‌ها (Dictionaries)
                                                                                  • ☰ 8.4. مجموعه‌ها (Sets – مقدماتی)
                                                                                    • ☰ 8.5. انتخاب ساختار دادهٔ مناسب
                                                                                    • ☰ 9. فصل ۹: توابع
                                                                                      • ☰ 9.1. چرا توابع مهم هستند؟
                                                                                        • ☰ 9.2. تعریف توابع
                                                                                          • ☰ 9.3. پارامترها و آرگومان‌ها
                                                                                            • ☰ 9.4. مقادیر بازگشتی
                                                                                              • ☰ 9.5. محدودهٔ متغیرها (محلی در برابر سراسری)
                                                                                                • ☰ 9.6. استفادهٔ مجدد از کد
                                                                                                • ☰ 10. فصل ۱۰: کار با فایل‌ها
                                                                                                  • ☰ 10.1. فایل چیست؟
                                                                                                    • ☰ 10.2. خواندن فایل‌های متنی
                                                                                                      • ☰ 10.3. نوشتن و افزودن به فایل‌ها
                                                                                                        • ☰ 10.4. مسیر فایل‌ها
                                                                                                          • ☰ 10.5. برنامه‌های ساده مبتنی بر فایل
                                                                                                          • ☰ 11. فصل ۱۱: خطاها و اشکال‌زدایی
                                                                                                            • ☰ 11.1. انواع خطاها
                                                                                                              • ☰ 11.2. خواندن پیام‌های خطا
                                                                                                                • ☰ 11.3. خطاهای رایج مبتدیان
                                                                                                                  • ☰ 11.4. try و except
                                                                                                                    • ☰ 11.5. راهبردهای اشکال‌زدایی
                                                                                                                    • ☰ 12. فصل ۱۲: استفاده از کتابخانه‌های پایتون
                                                                                                                      • ☰ 12.1. کتابخانه چیست؟
                                                                                                                        • ☰ 12.2. وارد کردن ماژول‌ها
                                                                                                                          • ☰ 12.3. کتابخانه‌های استاندارد
                                                                                                                            • ☰ 12.3.1. math
                                                                                                                              • ☰ 12.3.2. random
                                                                                                                                • ☰ 12.3.3. datetime
                                                                                                                                • ☰ 12.4. نصب کتابخانه‌های خارجی با pip
                                                                                                                                • ☰ 13. فصل ۱۳: برنامه‌نویسی شی‌گرا (OOP)
                                                                                                                                  • ☰ 13.1. برنامه‌نویسی شی‌گرا چیست؟
                                                                                                                                    • ☰ 13.2. کلاس‌ها و اشیاء
                                                                                                                                      • ☰ 13.3. ویژگی‌ها و متدها
                                                                                                                                        • ☰ 13.4. متد `__init__`
                                                                                                                                          • ☰ 13.5. کپسوله‌سازی
                                                                                                                                            • ☰ 13.6. وراثت (مقدماتی)
                                                                                                                                              • ☰ 13.7. مثال‌های سادهٔ شی‌گرا
                                                                                                                                              • ☰ 14. فصل ۱۴: خودکارسازی با پایتون
                                                                                                                                                • ☰ 14.1. خودکارسازی چیست؟
                                                                                                                                                  • ☰ 14.2. خودکار کردن وظایف ساده
                                                                                                                                                    • ☰ 14.3. کار با فایل‌ها و پوشه‌ها
                                                                                                                                                      • ☰ 14.4. خودکارسازی پردازش متن
                                                                                                                                                        • ☰ 14.5. زمان‌بندی اجرای اسکریپت‌ها
                                                                                                                                                          • ☰ 14.6. مثال‌های کاربردی خودکارسازی
                                                                                                                                                          • ☰ 15. فصل ۱۵: توسعهٔ وب با پایتون
                                                                                                                                                            • ☰ 15.1. وب چگونه کار می‌کند؟ (نمای کلی)
                                                                                                                                                              • ☰ 15.2. آشنایی با Flask
                                                                                                                                                                • ☰ 15.3. ساخت یک وب‌سرور ساده
                                                                                                                                                                  • ☰ 15.4. مسیرها و قالب‌ها (Templates)
                                                                                                                                                                    • ☰ 15.5. پردازش ورودی کاربر (فرم‌ها)
                                                                                                                                                                      • ☰ 15.6. API های بسیار ساده
                                                                                                                                                                      • ☰ 16. فصل ۱۶: علم داده با پایتون
                                                                                                                                                                        • ☰ 16.1. علم داده چیست؟
                                                                                                                                                                          • ☰ 16.2. کار با داده‌ها
                                                                                                                                                                            • ☰ 16.3. آشنایی با NumPy
                                                                                                                                                                              • ☰ 16.4. آشنایی با pandas
                                                                                                                                                                                • ☰ 16.5. مصورسازی داده با matplotlib
                                                                                                                                                                                  • ☰ 16.6. مثال‌های سادهٔ تحلیل داده
                                                                                                                                                                                  • ☰ 17. فصل ۱۷: پروژه‌های کوچک
                                                                                                                                                                                    • ☰ 17.1. بازی حدس عدد
                                                                                                                                                                                      • ☰ 17.2. ماشین‌حساب ساده
                                                                                                                                                                                        • ☰ 17.3. فهرست کارها (To-Do List)
                                                                                                                                                                                          • ☰ 17.4. تولیدکنندهٔ رمز عبور
                                                                                                                                                                                            • ☰ 17.5. برنامهٔ آزمون (Quiz)
                                                                                                                                                                                              • ☰ 17.6. پروژهٔ کوچک وب یا داده
                                                                                                                                                                                              • ☰ 18. فصل ۱۸: گام‌های بعدی
                                                                                                                                                                                                • ☰ 18.1. چگونه پایتون را تمرین کنیم
                                                                                                                                                                                                  • ☰ 18.2. نوشتن کد تمیز و خوانا
                                                                                                                                                                                                    • ☰ 18.3. انتخاب یک حوزهٔ تخصصی
                                                                                                                                                                                                      • ☰ 18.3.1. توسعهٔ وب
                                                                                                                                                                                                        • ☰ 18.3.2. علم داده
                                                                                                                                                                                                          • ☰ 18.3.3. خودکارسازی
                                                                                                                                                                                                            • ☰ 18.3.4. توسعهٔ نرم‌افزار
                                                                                                                                                                                                            • ☰ 18.4. منابع یادگیری و انجمن‌ها
                                                                                                                                                                                                            • ☰ 19. پیوست
                                                                                                                                                                                                              • ☰ 19.1. برگهٔ تقلب دستور زبان پایتون
                                                                                                                                                                                                                • ☰ 19.2. خطاهای رایج و راه‌حل‌ها
                                                                                                                                                                                                                  • ☰ 19.3. واژه‌نامهٔ اصطلاحات