نام (NAME)

clevercsv-standardize - تبدیل فایل CSV به قالبی منطبق با RFC-4180

خلاصه دستور (SYNOPSIS)

clevercsv standardize [-e ENCODING | --encoding=ENCODING]
                      [-E TARGET_ENCODING | --target-encoding=TARGET_ENCODING]
                      [-i | --in-place] [-n NUM_CHARS | --num-chars=NUM_CHARS]
                      [-o OUTPUT | --output=OUTPUT] [-t | --transpose]
                      <path [path ...]>

توضیحات (DESCRIPTION)

دستور standardize می‌تواند برای تبدیل یک فایل CSV غیر استاندارد به قالب استاندارد RFC-4180 استفاده شود [1]. هنگام استفاده از گزینهٔ --in-place، می‌توان از کد بازگشتی CleverCSV برای بررسی تغییر یافتن یا نیافتن فایل استفاده کرد. در صورتی که فایل تغییر یافته باشد، کد بازگشتی ۲ و در غیر این صورت ۰ خواهد بود.

[1]: https://tools.ietf.org/html/rfc4180

گزینه‌ها (OPTIONS)

-h, --help

نمایش این پیام راهنما و خروج.

-e, --encoding

کدگذاری فایل CSV داده‌شده به‌طور خودکار با استفاده از chardet شناسایی می‌شود. اگرچه chardet فوق‌العاده دقیق است، اما بی‌نقص نیست. در موارد نادری که در تشخیص کدگذاری فایل اشتباه می‌کند، می‌توانید با ارائهٔ آن از طریق این پرچم، کدگذاری را بازنویسی کنید. برای این دستور، کدگذاری ارائه‌شده برای فایل(های) خروجی نیز اعمال خواهد شد. اگر تنها یک کدگذاری تعیین شود، برای تمام فایل‌های داده‌شده در خط فرمان استفاده خواهد شد. در صورت ارائهٔ چندین کدگذاری، تعداد آن‌ها باید با تعداد فایل‌های ارائه‌شده در ورودی مطابقت داشته باشد.

-E, --target-encoding

در صورت عدم تعیین، کدگذاری فایل خروجی همانند فایل اصلی خواهد بود.

-i, --in-place

استانداردسازی و بازنویسی در جای فایل(های) ورودی.

-n, --num-chars

در فایل‌های بزرگ CSV، تشخیص گویش (dialect detection) به دلیل تعداد زیاد گویش‌های محتمل، ممکن است گاهی کمی کند باشد. برای تسریع این روند، می‌توانید تعداد نویسه‌های مورد استفاده برای تشخیص را محدود کنید.

نکته‌ای که باید در نظر داشت این است که CleverCSV ممکن است برای استنتاج صحیح گویش به خواندن تعداد معینی نویسه نیاز داشته باشد. به عنوان مثال، در فایل ``imdb.csv`` موجود در مخزن GitHub، گویش صحیح تنها پس از خواندن حداقل ۶۶ خط از فایل قابل شناسایی است. بنابراین، اگر امکان اجرای CleverCSV روی کل فایل وجود دارد، انجام آن معمولاً توصیه می‌شود.

-o, --output

فایل‌های خروجی برای نوشتن فایل‌های ورودیِ استانداردشده. در صورت استفاده از این گزینه همراه با بیش از یک فایل ورودی، ترتیب فایل‌های ورودی و ترتیب فایل‌های خروجی باید یکسان باشد.

-t, --transpose

ترانهادن ستون‌های فایل(های) ورودی پیش از نوشتن.

<path>

مسیر یک یا چند فایل CSV.

CLEVERCSV

بخشی از مجموعهٔ CleverCSV