کدنویس — ایجنتِ هوشِ مصنوعیِ فارسی

این اسکریپت همهٔ فایل‌های Excel یک پوشه را می‌خواند و ردیف‌های آن‌ها را در یک فایل خروجی ادغام می‌کند. نام فایل و شیت مبدأ نیز به خروجی اضافه می‌شود و اختلاف ستون‌ها، شیت‌های خالی و فایل‌های موقت اکسل مدیریت می‌شوند.

کد

فایل زیر را با نام `merge_excel.py` ذخیره کنید: ```python from __future__ import annotations import argparse import sys from pathlib import Path import pandas as pd SUPPORTED_EXTENSIONS = {".xlsx", ".xls", ".xlsm"} def find_excel_files(input_dir: Path, output_file: Path) -> list[Path]: """فایل‌های اکسل ورودی را با ترتیب نام پیدا می‌کند.""" output_resolved = output_file.resolve() return sorted( ( path for path in input_dir.iterdir() if path.is_file() and path.suffix.lower() in SUPPORTED_EXTENSIONS and not path.name.startswith("~$") and path.resolve() != output_resolved ), key=la…

توضیح

اسکریپت فایل‌های `.xlsx`، `.xls` و `.xlsm` موجود در پوشهٔ ورودی را بر اساس نام مرتب می‌کند و سپس داده‌های آن‌ها را زیر یکدیگر قرار می‌دهد. دو ستون `فایل_مبدأ` و `شیت_مبدأ` در ابتدای خروجی مشخص می‌کنند هر ردیف از کجا آمده است. اگر ترتیب یا تعداد ستون‌های فایل‌ها متفاوت باشد، ستون‌های هم‌نام با یکدیگر تطبیق داده می‌شوند و خانه‌های فاقد مقدار خالی می‌مانند. فایل‌های موقت اکسل با پیشوند `~$` و خود فایل خروجی نادیده گرفته می‌شوند. این روش داده‌ها را ادغام می‌کند، اما قالب‌بندی، رنگ، فرمول، نمودار، تصویر و سلول‌های ادغام‌شده را عیناً منتقل نمی‌کند. مقدار فعلی سلول‌ها در خروجی نوشته می‌شود.

• حالت پیش‌فرض تمام شیت‌های تمام فایل‌ها را ادغام می‌کند.
• برای خواندن فقط یک شیت مشخص، گزینهٔ `--sheet` را وارد کنید.
• شیت‌های خالی نادیده گرفته می‌شوند.
• اگر خواندن یک فایل شکست بخورد، سایر فایل‌ها پردازش می‌شوند و در پایان خطا گزارش می‌شود.

نحوهٔ اجرا/تست

ابتدا Python را نصب کرده و در ترمینال وابستگی‌ها را نصب کنید: ```bash python -m pip install pandas openpyxl xlrd ``` همهٔ فایل‌های اکسل را در پوشه‌ای مانند `excel_files` قرار دهید. سپس برای ادغام تمام شیت‌ها اجرا کنید: ```bash python merge_excel.py excel_files -o خروجی_ادغام‌شده.xlsx ``` برای ادغام فقط شیتی با نام `فروش`: ```bash python merge_excel.py excel_files -o خروجی_فروش.xlsx --sheet "فروش" ``` در ویندوز، اگر مسیر فاصله دارد آن را داخل کوتیشن بگذارید: ```bash python merge_excel.py "C:\Users\User\Documents\Excel Files" -o "C:\Users\User\Documents\merged.xlsx" ``` برای تست، دو فایل کوچک با ستون‌های یکسان بسازید، اسکریپت را اجرا کنید و تعداد ردیف‌های خروجی را با مجموع ردیف‌های ورو…

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

نکاتِ امنیتی

اسکریپت را فقط روی فایل‌های قابل‌اعتماد اجرا کنید و پیش از پردازش فایل‌های مهم، نسخهٔ پشتیبان داشته باشید. فایل خروجی ممکن است شامل تجمیع اطلاعات حساس همهٔ فایل‌ها باشد؛ بنابراین سطح دسترسی پوشهٔ خروجی را بررسی کنید و آن را بدون ضرورت در فضای عمومی یا پیام‌رسان‌ها قرار ندهید. کتابخانه‌ها را ترجیحاً داخل محیط مجازی نصب و از منبع رسمی دریافت کنید. این اسکریپت ماکروهای فایل‌های `.xlsm` را به خروجی منتقل نمی‌کند؛ خروجی همیشه یک فایل معمولی `.xlsx` است. همچنین برای جلوگیری از حملات فرمولی، اگر قرار است خروجی بعداً به CSV تبدیل و در سامانهٔ دیگری وارد شود، سلول‌هایی که با `=`, `+`, `-` یا `@` شروع می‌شوند باید پیش از ورود اعتبارسنجی شوند.

• روی فایل‌های اصلی بازنویسی انجام ندهید؛ نام جداگانه‌ای برای خروجی انتخاب کنید.
• پس از ادغام، چند ردیف تصادفی و جمع‌های مالی را با فایل‌های مبدأ تطبیق دهید.
• برای فایل‌های بسیار بزرگ، فضای خالی دیسک و حافظهٔ کافی در نظر بگیرید.