کدهای آماده برای مدیریت فایل‌ها با پایتون

سلام رفیق برنامه‌نویس! اگه مثل من وقتت کمه و دنبال راهکارهای سریع و جون‌دار برای مدیریت فایل‌ها توی پروژه‌هات با پایتونی، جای درستی اومدی. پایتون یه جعبه ابزار غول‌آساست که با چند خط کد ساده، می‌تونی کارهایی رو انجام بدی که با بقیه زبان‌ها ساعت‌ها درگیرت می‌کنه. از ساخت و خوندن فایل‌ها گرفته تا کپی و پاک کردن پوشه‌ها، همه چی دم دسته. هدف این مقاله اینه که مسیر رو برات صاف و هموار کنه، تا دیگه وقتت رو پای چرخیدن توی مستندات و فروم‌های مختلف از دست ندی. اینجا دقیقاً همون کدهای عملی و آماده‌ای رو پیدا می‌کنی که روزمره به کارت میان. پس بزن بریم که دنیای فایل‌ها رو با پایتون به چالش بکشیم و به بهترین شکل مدیریت کنیم. راستی، اگه دنبال گنجینه‌ای از اسنیپت‌های پایتون و ابزارهای توسعه وب می‌گردی، حتماً یه سر به بخش اسنیپت‌های پایتون و وبسایت FA-Tools بزن، کلی کد به درد بخور اونجا منتظرته!

✨ نقشه راه مدیریت فایل با پایتون (یک نگاه) ✨

import os

# ساخت یک فایل جدید
try:
    with open("my_new_file.txt", "w") as f:
        f.write("این یک فایل تستی جدید است.")
    print("فایل my_new_file.txt با موفقیت ایجاد شد.")
except IOError as e:
    print(f"خطا در ایجاد فایل: {e}")

# ساخت یک پوشه (دایرکتوری) جدید
# os.makedirs میتونه پوشه های تو در تو رو هم بسازه
try:
    os.makedirs("new_directory/sub_directory", exist_ok=True)
    print("پوشه new_directory/sub_directory با موفقیت ایجاد شد.")
except OSError as e:
    print(f"خطا در ایجاد پوشه: {e}")
    

# نوشتن در یک فایل (حالت 'w' - رونویسی)
# اگه فایل نبود، ساخته میشه. اگه بود، محتواش پاک میشه و از اول نوشته میشه.
try:
    with open("data.txt", "w", encoding="utf-8") as f:
        f.write("خط اول داده.n")
        f.write("خط دوم داده.n")
    print("نوشتن در data.txt با موفقیت انجام شد.")
except IOError as e:
    print(f"خطا در نوشتن فایل: {e}")

# اضافه کردن به یک فایل (حالت 'a' - append)
# اگه فایل نبود، ساخته میشه. اگه بود، محتوا به آخرش اضافه میشه.
try:
    with open("data.txt", "a", encoding="utf-8") as f:
        f.write("خط سوم اضافه شده.n")
    print("اضافه کردن به data.txt با موفقیت انجام شد.")
except IOError as e:
    print(f"خطا در اضافه کردن به فایل: {e}")

# خواندن از یک فایل (حالت 'r')
try:
    with open("data.txt", "r", encoding="utf-8") as f:
        content = f.read() # خواندن کل محتوا
        print("nمحتوای فایل data.txt (کل محتوا):n", content)
    
    with open("data.txt", "r", encoding="utf-8") as f:
        lines = f.readlines() # خواندن خط به خط
        print("nمحتوای فایل data.txt (خط به خط):")
        for i, line in enumerate(lines):
            print(f"خط {i+1}: {line.strip()}") # strip() برای حذف کاراکترهای اضافه مثل n
except FileNotFoundError:
    print("فایل data.txt پیدا نشد.")
except IOError as e:
    print(f"خطا در خواندن فایل: {e}")
    

import os
import shutil

# فرض می‌کنیم فایل data.txt و پوشه new_directory وجود دارن
# اگه ندارن، با کدهای بالا بسازشون
if not os.path.exists("data.txt"):
    with open("data.txt", "w") as f:
        f.write("تست کپی")
if not os.path.exists("new_directory"):
    os.makedirs("new_directory")

# تغییر نام یک فایل
try:
    os.rename("data.txt", "old_data.txt")
    print("فایل data.txt به old_data.txt تغییر نام داد.")
except FileNotFoundError:
    print("فایل data.txt برای تغییر نام پیدا نشد.")
except OSError as e:
    print(f"خطا در تغییر نام فایل: {e}")

# کپی یک فایل
try:
    shutil.copy("old_data.txt", "new_directory/copied_data.txt")
    print("فایل old_data.txt به new_directory/copied_data.txt کپی شد.")
except FileNotFoundError:
    print("فایل old_data.txt برای کپی پیدا نشد.")
except OSError as e:
    print(f"خطا در کپی فایل: {e}")

# جابجایی (Move) یا تغییر مکان یک فایل/پوشه
# این تابع هم برای فایل و هم برای پوشه کار میکنه
try:
    shutil.move("old_data.txt", "moved_data.txt")
    print("فایل old_data.txt به moved_data.txt جابجا شد.")
except FileNotFoundError:
    print("فایل old_data.txt برای جابجایی پیدا نشد.")
except OSError as e:
    print(f"خطا در جابجایی فایل: {e}")

# کپی یک پوشه کامل
# shutil.copytree("new_directory", "backup_directory")
# این تابع برای کپی کل یک پوشه به همراه محتویاتش استفاده میشه.
# دقت کن که پوشه مقصد (backup_directory) نباید از قبل وجود داشته باشه.
# اگه میخوای چندتا کد اسکریپ باحال برای کپی و بکاپ‌گیری ببینید، حتما به 
# بخش کدهای آماده یه سر بزن.
    

import os
import shutil

# فرض می‌کنیم فایل moved_data.txt و پوشه new_directory/sub_directory و backup_directory وجود دارن.
# اگه ندارن، با کدهای بالا بسازشون
if not os.path.exists("moved_data.txt"):
    with open("moved_data.txt", "w") as f:
        f.write("تست حذف فایل")
if not os.path.exists("empty_directory"):
    os.makedirs("empty_directory")
if not os.path.exists("directory_with_files"):
    os.makedirs("directory_with_files")
    with open("directory_with_files/temp.txt", "w") as f:
        f.write("فایل داخل پوشه")

# حذف یک فایل
try:
    os.remove("moved_data.txt")
    print("فایل moved_data.txt با موفقیت حذف شد.")
except FileNotFoundError:
    print("فایل moved_data.txt برای حذف پیدا نشد.")
except OSError as e:
    print(f"خطا در حذف فایل: {e}")

# حذف یک پوشه خالی
try:
    os.rmdir("empty_directory")
    print("پوشه empty_directory با موفقیت حذف شد.")
except OSError as e:
    print(f"خطا در حذف پوشه خالی: {e}") # اگه پوشه خالی نباشه اینجا خطا میده

# حذف یک پوشه غیرخالی و تمام محتویاتش (خیلی خطرناکه! با احتیاط استفاده کنید)
try:
    shutil.rmtree("directory_with_files")
    print("پوشه directory_with_files و محتویات آن با موفقیت حذف شدند.")
except FileNotFoundError:
    print("پوشه directory_with_files برای حذف پیدا نشد.")
except OSError as e:
    print(f"خطا در حذف پوشه غیرخالی: {e}")
    

import os

# فرض می‌کنیم یه سری فایل و پوشه تستی داریم
# مثلاً: test_dir/file1.txt, test_dir/image.jpg, test_dir/sub_folder
if not os.path.exists("test_dir"):
    os.makedirs("test_dir")
    with open("test_dir/file1.txt", "w") as f: f.write("test")
    with open("test_dir/image.jpg", "w") as f: f.write("test")
    os.makedirs("test_dir/sub_folder")

directory_path = "test_dir"

# لیست کردن همه محتویات
print(f"nمحتویات {directory_path}:")
try:
    for item in os.listdir(directory_path):
        print(item)
except FileNotFoundError:
    print(f"پوشه {directory_path} پیدا نشد.")
except OSError as e:
    print(f"خطا در لیست کردن محتویات: {e}")


# فیلتر کردن فایل‌های با پسوند خاص
print(f"nفایل‌های متنی در {directory_path}:")
try:
    text_files = [f for f in os.listdir(directory_path) if f.endswith(".txt")]
    for file in text_files:
        print(file)
except FileNotFoundError:
    print(f"پوشه {directory_path} پیدا نشد.")

# تشخیص فایل و پوشه
print(f"nتشخیص فایل و پوشه در {directory_path}:")
try:
    for item in os.listdir(directory_path):
        full_path = os.path.join(directory_path, item)
        if os.path.isfile(full_path):
            print(f"{item} (فایل)")
        elif os.path.isdir(full_path):
            print(f"{item} (پوشه)")
except FileNotFoundError:
    print(f"پوشه {directory_path} پیدا نشد.")
    

import os

file_path = "/home/user/documents/report.pdf"
directory_path = "/home/user/projects"

print(f"مسیر کامل: {file_path}")
print(f"نام فایل: {os.path.basename(file_path)}") # report.pdf
print(f"نام پوشه: {os.path.dirname(file_path)}") # /home/user/documents
print(f"نام و پسوند: {os.path.splitext(file_path)}") # ('/home/user/documents/report', '.pdf')
print(f"آیا مسیر مطلق است؟ {os.path.isabs(file_path)}") # True
print(f"ترکیب مسیرها: {os.path.join(directory_path, 'my_project', 'main.py')}") # /home/user/projects/my_project/main.py

# بررسی وجود فایل یا پوشه
print(f"آیا report.pdf وجود دارد؟ {os.path.exists('report.pdf')}") # False (چون اینجا فایل رو نساختیم)
print(f"آیا این یک فایل است؟ {os.path.isfile(file_path)}") # False
print(f"آیا این یک پوشه است؟ {os.path.isdir(directory_path)}") # True (اگه وجود داشته باشه)
    

import shutil
import os

# ساخت یک پوشه تستی با چند فایل
if not os.path.exists("files_to_compress"):
    os.makedirs("files_to_compress")
    with open("files_to_compress/doc1.txt", "w") as f: f.write("Document 1")
    with open("files_to_compress/doc2.txt", "w") as f: f.write("Document 2")

# فشرده‌سازی پوشه به صورت ZIP
try:
    # base_name: نام فایل خروجی (بدون پسوند)
    # format: نوع فشرده سازی (zip, tar, gztar, bztar, xztar)
    # root_dir: دایرکتوری که فایل‌ها ازش انتخاب میشن
    # base_dir: دایرکتوری داخل root_dir که فشرده میشه (اگه خالی باشه، کل root_dir)
    shutil.make_archive("my_archive", "zip", "files_to_compress")
    print("پوشه files_to_compress با موفقیت فشرده شد به my_archive.zip")
except Exception as e:
    print(f"خطا در فشرده سازی: {e}")

# اکسترکت کردن فایل ZIP
try:
    if not os.path.exists("extracted_files"):
        os.makedirs("extracted_files")
    shutil.unpack_archive("my_archive.zip", "extracted_files")
    print("فایل my_archive.zip با موفقیت در extracted_files اکسترکت شد.")
except FileNotFoundError:
    print("فایل my_archive.zip برای اکسترکت پیدا نشد.")
except Exception as e:
    print(f"خطا در اکسترکت کردن: {e}")

# پاکسازی فایل‌ها و پوشه‌های تستی
try:
    shutil.rmtree("files_to_compress")
    shutil.rmtree("extracted_files")
    os.remove("my_archive.zip")
    print("فایل‌ها و پوشه‌های تستی پاکسازی شدند.")
except Exception as e:
    print(f"خطا در پاکسازی: {e}")
    

مشکل: رایج‌ترین خطا! وقتی پایتون نمی‌تونه فایل یا پوشه‌ای که بهش گفتی رو پیدا کنه. معمولاً به خاطر اشتباه تایپی در مسیر یا عدم وجود فایل/پوشه هست.

راه حل:

• مسیر رو چک کن: مطمئن شو که مسیر فایل یا پوشه رو دقیق و بدون اشتباه تایپ کردی.
• وجود داشتن فایل/پوشه: قبل از انجام عملیات، با os.path.exists() وجودش رو چک کن.
• مسیر مطلق یا نسبی: مطمئن شو که از مسیر درستی استفاده می‌کنی. مسیرهای نسبی نسبت به محل اجرای اسکریپت در نظر گرفته می‌شن.
• اجازه دسترسی: مطمئن شو که برنامه پایتون اجازه دسترسی به اون مسیر رو داره.

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

راه حل:

• اجرای با دسترسی ادمین: اگه رو ویندوز هستی، اسکریپت رو با “Run as administrator” اجرا کن. تو لینوکس و مک، از sudo python your_script.py استفاده کن.
• بستن فایل‌های باز: مطمئن شو که هیچ برنامه دیگه‌ای فایل مورد نظر رو باز نکرده باشه.
• تغییرر پرمیشن‌ها: تو لینوکس/مک، می‌تونی با دستور chmod پرمیشن‌های فایل رو تغییر بدی (مثلاً chmod 777 file.txt، البته این کار زیاد امن نیست).

مشکل: این خطاها وقتی پیش میان که مثلاً سعی می‌کنی یه پوشه رو با os.remove() حذف کنی (که فقط برای فایل‌هاست) یا یه فایل رو با os.rmdir() (که فقط برای پوشه‌های خالیه).

راه حل:

• تشخیص نوع: همیشه قبل از عملیات، با os.path.isfile() و os.path.isdir() نوع مسیر رو تشخیص بده.
• ابزار درست: برای حذف فایل os.remove()، برای حذف پوشه خالی os.rmdir() و برای حذف پوشه غیرخالی shutil.rmtree() رو استفاده کن.

مشکل: این خطاها معمولاً وقتی پیش میان که داری با فایل‌های متنی کار می‌کنی و پایتون نمی‌تونه کاراکترهای خاص (مثل فارسی) رو به درستی بخونه یا بنویسه.

راه حل:

• مشخص کردن Encoding: همیشه و همیشه، وقتی فایل متنی رو باز می‌کنی، encoding="utf-8" رو مشخص کن. این امن‌ترین و رایج‌ترین روشه.

⚠️ نیاز به کدهای آماده بیشتر یا کمک در پروژه‌هات داری؟

اگه این اسنیپت‌ها کارتو راه انداختن و دنبال ابزارهای حرفه‌ای‌تر یا حتی کدهای آماده برای CSS، JavaScript، HTML یا وردپرس می‌گردی، یه سر به بخش کدهای آماده FA-Tools بزن. برای مشاوره یا کمک مستقیم هم می‌تونی باهام تماس بگیری:

📞 09202232789