KAHIBARO Bookshelves
Discord Login Register

12.3. کتابخانه‌های استاندارد

مروری بر کتابخانهٔ استاندارد پایتون

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

در ادامه، ایدهٔ کلی کتابخانهٔ استاندارد را توضیح می‌دهیم و بعد، قبل از رفتن به زیر‌بخش‌های math، random و datetime، چند نمونهٔ مهم دیگر را خیلی کوتاه معرفی می‌کنیم تا تصویر کلی‌تری بگیرید.

کتابخانهٔ استاندارد یعنی چه؟

وقتی پایتون را نصب می‌کنید، فقط «هستهٔ زبان» را دریافت نمی‌کنید؛ بلکه یک مجموعهٔ بزرگ از ماژول‌ها هم همراه آن می‌آید که به آن‌ها کتابخانهٔ استاندارد (Standard Library) می‌گویند.

ویژگی‌های مهم کتابخانهٔ استاندارد:

  • همراه پایتون نصب است
    لازم نیست برای استفاده از آن‌ها چیزی با pip نصب کنید.
  • کیفیت و پایداری بالا
    توسط خود تیم پایتون و جامعهٔ رسمی نگه‌داری می‌شود.
  • پوشش دادن کارهای متداول مثل:
    • کار با زمان و تاریخ
    • انجام محاسبات ریاضی
    • کار با فایل‌ها و پوشه‌ها
    • فشرده‌سازی (zip و …)
    • شبکه (ارسال درخواست‌های سادهٔ وب و …)
    • قالب‌بندی متن، کار با رشته‌ها، الگوهای متنی و …

ایدهٔ اصلی این است:
به‌جای این‌که همه‌چیز را از صفر بنویسید، اول در کتابخانهٔ استاندارد بگردید؛ اغلب «چرخ قبلاً اختراع شده است» و فقط باید از آن استفاده کنید.

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

در اکثر مواقع، برای استفاده از یک ماژول استاندارد فقط کافی است آن را import کنید. چند الگوی رایج:

  • وارد کردن کل ماژول:
  import math
  print(math.pi)
  • وارد کردن یک تابع یا کلاس مشخص:
  from math import sqrt
  print(sqrt(16))
  • وارد کردن با نام کوتاه‌تر (مخفف):
  import datetime as dt
  today = dt.date.today()
  print(today)

در زیر‌بخش‌های بعدی این فصل، برای ماژول‌های math، random و datetime نمونه‌های عملی‌تری خواهید دید؛ این‌جا روی مرور کلی بقیهٔ بخش‌های مهم کتابخانهٔ استاندارد تمرکز می‌کنیم.

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

کتابخانهٔ استاندارد ده‌ها ماژول دارد. لازم نیست همه را حفظ کنید؛ مهم این است بدانید چه نوع کارهایی را پوشش می‌دهد تا وقتی نیازی داشتید، بتوانید آن را پیدا کنید.

۱. کار با سیستم‌عامل و فایل‌ها

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

  • os
    برای کار با سیستم‌عامل:
    • ساخت پوشه، حذف پوشه
    • به‌دست‌آوردن مسیر فعلی
    • لیست کردن فایل‌های داخل یک پوشه

نمونهٔ ساده:

  import os
  print(os.getcwd())          # مسیر فعلی
  print(os.listdir("."))      # فایل‌های پوشهٔ فعلی
  • pathlib
    روش «شی‌گرا»تر و جدیدتر برای کار با مسیرها:
  from pathlib import Path
  p = Path(".")
  for item in p.iterdir():
      print(item)
  • shutil
    برای کارهای سطح بالاتر روی فایل‌ها:
    • کپی فایل
    • جابه‌جا کردن فایل
    • فشرده‌سازی پوشه

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

۲. فشرده‌سازی و آرشیو

  • zipfile
    ساخت و خواندن فایل‌های zip.
  • tarfile
    برای فایل‌های tar (بیشتر در لینوکس/یونیکس).

نمونهٔ خیلی سادهٔ ساخت فایل zip:

import zipfile
with zipfile.ZipFile("archive.zip", "w") as z:
    z.write("file1.txt")
    z.write("file2.txt")

۳. کار با متن و رشته‌ها

پایتون در هستهٔ خود امکانات خوبی برای کار با رشته‌ها دارد، اما کتابخانهٔ استاندارد ابزارهای پیشرفته‌تری هم ارائه می‌کند.

  • re
    برای جست‌وجو و تطبیق الگوها در متن با «عبارات باقاعده» (Regular Expressions).
    در این دوره وارد جزئیات کامل re نمی‌شویم، اما بدانید که برای جست‌وجوی پیچیده در متن از این ماژول استفاده می‌شود.
  import re
  text = "Email: user@example.com"
  match = re.search(r"\w+@\w+\.\w+", text)
  if match:
      print("ایمیل پیدا شد:", match.group())
  • textwrap
    برای شکستن متن‌های طولانی به چند خط منظم.
  • string
    شامل ثابت‌ها و ابزارهای کمکی برای رشته‌ها، مثل string.ascii_letters، string.digits و … که برای تولید رمز عبور یا پردازش متن مفید است.

۴. ذخیره‌سازی داده و ساختارهای سریالی

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

  • json
    برای خواندن/نوشتن داده‌ها در قالب JSON (فرمت بسیار رایج برای تبادل داده، مخصوصاً در وب و APIها).
  import json
  data = {"name": "Ali", "age": 20}
  text = json.dumps(data)          # تبدیل دیکشنری به رشتهٔ JSON
  print(text)
  back = json.loads(text)          # تبدیل رشتهٔ JSON به دیکشنری
  print(back["name"])
  • pickle
    برای ذخیرهٔ مستقیم اشیای پایتونی در فایل و بازیابی آن‌ها.
    (برای شروع، معمولاً json گزینهٔ امن‌تر و رایج‌تری است.)

۵. ابزارهای مربوط به زمان‌سنجی و کارایی

  • time
    برای کار با زمانِ سیستم (تا حدودی سطح پایین).
    می‌توانید برای اندازه‌گیری مدت اجرای یک قطعه کد از time.time() استفاده کنید.
  • timeit
    برای اندازه‌گیری دقیق‌تر زمان اجرای بخش‌های کوچک کد.
    این ماژول بیشتر وقتی مهم می‌شود که روی «کارایی» (Performance) حساس باشید.

۶. ابزارهای مرتبط با شبکه و وب (مقدماتی)

حتی بدون کتابخانه‌های خارجی هم می‌توانید کارهای سادهٔ وب انجام دهید.

  • urllib
    برای ارسال درخواست‌های سادهٔ HTTP (مثلاً دریافت محتوای یک صفحهٔ وب).
    در توسعهٔ وب جدی‌تر معمولاً از کتابخانه‌های خارجی مثل requests استفاده می‌شود، اما urllib پایه‌ای‌ترین ابزار استاندارد است.
  • http
    مجموعه‌ای از ابزارها برای کار با پروتکل HTTP؛ برای شروع خیلی ضروری نیست، اما بدانید در کتابخانهٔ استاندارد وجود دارد.

این‌ها در فصل‌های «توسعهٔ وب» و «API های بسیار ساده» کاربرد پیدا می‌کنند.

۷. ابزارهای کاربردی عمومی

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

  • collections
    ساختارهای دادهٔ پیشرفته‌تر مثل:
    • Counter برای شمردن تکرار عناصر
    • defaultdict برای دیکشنری با مقدار پیش‌فرض
    • deque برای صف (Queue) با کارایی بالا
  from collections import Counter
  nums = [1, 2, 2, 3, 3, 3]
  c = Counter(nums)
  print(c)      # خروجی: Counter({3: 3, 2: 2, 1: 1})
  • itertools
    ابزارهایی برای ساخت و ترکیب حلقه‌ها و توالی‌ها.
    در کار با داده‌ها و نوشتن کدهای فشرده و کارآمد بسیار مفید است.
  • functools
    ابزارهای مربوط به توابع، مثل lru_cache برای کش‌کردن نتایج یک تابع.

۸. ابزارهای اشکال‌زدایی و توسعه

  • logging
    برای ثبت پیام‌ها و وقایع (Log) در حین اجرای برنامه:
    • ثبت خطاها
    • ثبت اتفاقات مهم
    • ذخیره در فایل

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

  • traceback
    برای کار با اطلاعات خطاها (Stack Trace) در صورت بروز استثناها؛
    در کنار try و except که در فصل «خطاها و اشکال‌زدایی» می‌آید به کار می‌آید.
  • pdb
    اشکال‌زدا (Debugger) تعاملی پایتون؛
    می‌توانید وسط اجرا برنامه را متوقف کرده و متغیرها را بررسی کنید.

چطور از کتابخانهٔ استاندارد بیشترین استفاده را ببریم؟

۱. پیش از نوشتن کد، جست‌وجو کنید
اگر می‌خواهید:

  • کلمه‌ها را بشمارید
  • فایل‌ها را جابه‌جا کنید
  • با تاریخ کار کنید
  • داده‌ها را فشرده کنید
    احتمالاً یکی از ماژول‌های استاندارد این کار را قبلاً انجام داده است.

۲. مستندات رسمی را مرور کنید
آدرس کلی مستندات کتابخانهٔ استاندارد:

  • https://docs.python.org
    (نسخهٔ پایتون خود را انتخاب کنید و به بخش Library Reference بروید.)

۳. با مثال‌های کوچک آزمایش کنید
مثل کدی که در این فصل و زیر‌بخش‌های math، random و datetime می‌بینید:

  • چند خط بنویسید
  • در حالت تعاملی پایتون (REPL) یا اسکریپت اجرا کنید
  • رفتار توابع را مرحله‌به‌مرحله امتحان کنید

۴. آرام‌آرام، نه همه‌چیز یک‌جا
لازم نیست همهٔ ماژول‌ها را یک‌جا یاد بگیرید.
به‌مرور و هم‌زمان با پروژه‌ها و تمرین‌هایتان با آن‌ها آشنا می‌شوید.

چند تمرین پیشنهادی برای کار با کتابخانهٔ استاندارد

برای تمرین، می‌توانید چند پروژهٔ خیلی کوچک با تکه‌هایی از کتابخانهٔ استاندارد بسازید:

  1. گذار زمان ساده
    با استفاده از ماژول‌های زمانی (مثل time یا datetime) برنامه‌ای بنویسید که:
    • زمان شروع را ذخیره کند
    • بعد از گرفتن یک ورودی از کاربر، مدت زمانی را که گذشته است چاپ کند
  2. شمارش کلمات در یک متن
    برنامه‌ای بنویسید که:
    • یک رشته (متن) بگیرد
    • با استفاده از collections.Counter تعداد هر کلمه را بشمارد
  3. ذخیره و بازیابی تنظیمات با JSON
    برنامه‌ای کوچک بسازید که:
    • یک دیکشنری تنظیمات بسازد (مثلاً {"theme": "dark", "font_size": 14})
    • آن را با json در فایلی ذخیره کند
    • در اجرای بعدی، آن فایل را بخواند و تنظیمات را بازیابی کند

در زیر‌بخش‌های بعدی این فصل، به‌طور مشخص با سه ماژول 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. واژه‌نامهٔ اصطلاحات