کار با فایل و مسیر در پایتون با os و pathlib

مدیریت فایل‌ها و مسیرها یکی از پایه‌ای‌ترین نیازها در توسعه نرم‌افزار، اسکریپت‌نویسی و علم داده است. پایتون دو ابزار اصلی برای این کار ارائه می‌دهد: ماژول قدیمی os که مبتنی بر رشته‌ها کار می‌کند و ماژول مدرن‌تر pathlib که از نسخه ۳.۴ به بعد معرفی شد و با رویکرد شیءگرا، کار با مسیرها را بسیار ساده‌تر و امن‌تر کرده است. در این مقاله یاد می‌گیرید که چگونه به بهترین شکل از این ابزارها برای پروژه‌های خود استفاده کنید.

۱. مقایسه os و pathlib در یک نگاه

پاسخ سریع: تفاوت اصلی بین این دو ماژول در نحوه برخورد آن‌ها با مسیرها است؛ ماژول os مسیرها را به عنوان «رشته» (String) پردازش می‌کند که اغلب منجر به خطای ساختاری در ویندوز و لینوکس می‌شود، در حالی که pathlib مسیرها را به عنوان «شیء» (Object) در نظر می‌گیرد که کار با آن‌ها را مستقل از سیستم‌عامل و خواناتر می‌سازد.

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

۲. مدیریت و ساخت مسیرهای امن

پاسخ سریع: برای ترکیب مسیرها در پایتون بدون بروز خطای جداکننده سیستم‌عامل (Slash یا Backslash)، از عملگر اسلش (/) در کلاس Path استفاده کنید. این عملگر به طور خودکار فرمت مناسب ویندوز یا یونیکس را تشخیص داده و اعمال می‌کند.

جایگزینی عملگر / با متدهای قدیمی

در گذشته برای چسباندن پوشه‌ها و فایل‌ها به یکدیگر مجبور بودیم از os.path.join() استفاده کنیم که کدهای طولانی و ناخوشایندی ایجاد می‌کرد. با استفاده از pathlib این فرآیند بسیار بصری و شبیه به مسیرهای واقعی شده است:

from pathlib import Path

# تعریف مسیر پایه (مثلاً پوشه خانگی کاربر)
base_path = Path.home()

# ترکیب مسیرها با استفاده از عملگر اسلش
target_file = base_path / "documents" / "reports" / "data.csv"

print(target_file)
# خروجی در ویندوز: C:UsersUsernamedocumentsreportsdata.csv
# خروجی در لینوکس: /home/username/documents/reports/data.csv

استخراج اجزای مختلف یک مسیر

کلاس Path ویژگی‌های (Properties) بسیار مفیدی برای تجزیه مسیر در اختیارتان قرار می‌دهد که دیگر نیازی به توابع پردازش رشته (مانند split و rstrip) ندارند:

file_path = Path("/var/log/nginx/access.log.tar.gz")

print(file_path.name)      # خروجی: access.log.tar.gz (نام کامل فایل)
print(file_path.stem)      # خروجی: access.log (نام بدون آخرین پسوند)
print(file_path.suffix)    # خروجی: .gz (آخرین پسوند)
print(file_path.suffixes)  # خروجی: ['.log', '.tar', '.gz'] (تمام پسوندها)
print(file_path.parent)    # خروجی: /var/log/nginx (پوشه والد)

۳. عملیات اصلی روی فایل‌ها و دایرکتوری‌ها

پاسخ سریع: برای ایجاد فایل و دایرکتوری به صورت همزمان از متد Path.mkdir() همراه با آرگومان‌های parents=True و exist_ok=True استفاده کنید تا در صورت وجود مسیر یا عدم وجود پوشه‌های والد، برنامه‌تان دچار کرش (Crash) نشود.

راهنمای گام‌به‌گام ساخت و حذف پوشه

1. ابتدا شیء مسیر خود را ایجاد کنید: folder = Path("my_project/src/assets")
2. با فراخوانی folder.mkdir(parents=True, exist_ok=True) تمام پوشه‌های تودرتو را به یکباره و در امنیت کامل بسازید.
3. برای حذف پوشه، در صورتی که کاملاً خالی باشد، از متد folder.rmdir() استفاده کنید.

پیمایش دایرکتوری‌ها (Globbing)

یکی از ویژگی‌های قدرتمند pathlib، جستجوی فایل‌ها بر اساس الگوهای مشخص با متد glob است. این روش جایگزین بسیار کارآمدتری برای ساختار پیچیده os.walk به شمار می‌رود:

project_dir = Path("/my_project")

# پیدا کردن تمام فایل‌های پایتون در پوشه فعلی
py_files = list(project_dir.glob("*.py"))

# پیدا کردن تمام فایل‌های متنی به صورت بازگشتی در کل زیرپوشه‌ها
all_txt_files = list(project_dir.rglob("*.txt"))

for file in all_txt_files:
    print(f"یافت شد: {file.name} در مسیر {file.parent}")

۴. خواندن و نوشتن مدرن فایل‌ها

پاسخ سریع: در پایتون نوین، متدهای read_text() و write_text() از کلاس Path به شما این امکان را می‌دهند که بدون نیاز به باز کردن دستی فایل (عبارت self-managed با with)، محتوای فایل‌های متنی را در یک خط بخوانید یا بنویسید.

این متدها به طور خودکار باز و بسته شدن فایل را مدیریت می‌کنند و از بروز نشت منابع (Resource Leaks) جلوگیری به عمل می‌آورند:

file_path = Path("config.txt")

# نوشتن متن درون فایل (اگر فایل باشد بازنویسی می‌شود)
file_path.write_text("تنظیمات سرور پایتون", encoding="utf-8")

# خواندن مستقیم محتوای فایل
content = file_path.read_text(encoding="utf-8")
print(content)  # خروجی: تنظیمات سرور پایتون

۵. نکات پیشرفته و تله‌های رایج

عبور از سطح مقدماتی کار با فایل، مستلزم شناخت سناریوهای خاص دنیای واقعی است. در این بخش ۳ ترفند تخصصی را مرور می‌کنیم:

• تبدیل مسیرهای نسبی به مطلق با متد resolve(): زمانی که اسکریپت خود را از دایرکتوری دیگری اجرا می‌کنید، مسیرهای نسبی دچار خطا می‌شوند. همیشه از path.resolve() استفاده کنید تا مسیر دقیق فایل را بر مبنای موقعیت کنونی سیستم استخراج نمایید.
• سازگاری با کتابخانه‌های قدیمی: برخی کتابخانه‌های شخص ثالث (Third-party) هنوز از شیء Path پشتیبانی نمی‌کنند و به رشته سنتی نیاز دارند. در چنین مواقعی کافیست مسیر خود را به صورت صریح به رشته تبدیل کنید: str(my_path).
• جلوگیری از قفل شدن فایل‌ها: اگرچه write_text فورا اتصال فایل را می‌بندد، اما در پردازش‌های حجیم یا هنگام استفاده از متد سنتی open()، همیشه از ساختار with open() استفاده کنید تا جریان‌های فایل به طور خودکار بسته شده و رم آزاد گردد.

۶. عیب‌یابی سریع خطاهای متداول

# راهکار اول: بررسی شرطی قبل از کار با فایل
if my_path.exists():
    content = my_path.read_text()

# راهکار دوم: ساخت دایرکتوری‌های والد پیش از ایجاد فایل
my_path.parent.mkdir(parents=True, exist_ok=True)
my_path.touch() # ایجاد فایل خالی بدون خطا

۷. پرسش‌های متداول

آیا pathlib برای فایل‌های با حجم بسیار بالا مناسب است؟

متدهای read_text و read_bytes کل محتوای فایل را به یکباره وارد حافظه رم (RAM) می‌کنند. برای فایل‌های چند گیگابایتی بهتر است از شیوه سنتی پردازش خط به خط با دستور with path.open() as f: استفاده کنید تا حافظه سیستم با بحران مواجه نشود.

چطور تفاوت آدرس‌دهی ویندوز (بک‌اسلش) را با مک/لینوکس (اسلش) حل کنیم؟

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

آیا امکان حذف کل پوشه‌ها حتی در صورت پر بودن با pathlib وجود دارد؟

خیر، متد rmdir() در pathlib فقط دایرکتوری‌های کاملاً خالی را حذف می‌کند. برای حذف کل پوشه با تمام محتویات داخلی آن، باید از ماژول جانبی shutil و متد کاربردی shutil.rmtree() استفاده نمایید.

آیا ماژول os کاملا بازنشسته شده است؟

خیر. با وجود اینکه pathlib برای اکثر کارهای مربوط به مدیریت مسیر ارجحیت دارد، اما برخی کارهای سیستمی مانند خواندن متغیرهای محیطی با os.environ یا بررسی پروسس‌ها همچنان منحصراً با ماژول os انجام می‌شوند.