نام (NAME)

clevercsv-code - تولید کد پایتون برای وارد کردن یک فایل CSV

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

clevercsv code [-e ENCODING | --encoding=ENCODING]
               [-n NUM_CHARS | --num-chars=NUM_CHARS] [-p | --pandas] <path>

توضیحات (DESCRIPTION)

تولید کد پایتون برای وارد کردن یک فایل CSV مشخص. این قابلیت به‌ویژه زمانی مفید است که نمی‌خواهید گویش (dialect) یک فایل یکسان را بارها و بارها شناسایی کنید. کافی است دستور زیر را اجرا کنید:

clevercsv code your_csv_file.csv

و کد تولیدشده را در یک اسکریپت پایتون کپی کنید.

گزینه‌ها (OPTIONS)

-h, --help

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

-e, --encoding

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

-n, --num-chars

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

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

-p, --pandas

به‌طور پیش‌فرض، این دستور یک اسکریپت کوچک پایتون برای وارد کردن فایل CSV به عنوان یک لیست از لیست‌ها (list of lists) ایجاد می‌کند. با فعال کردن این گزینه، اسکریپت به‌گونه‌ای نوشته می‌شود که فایل به‌جای آن به عنوان یک DataFrame از کتابخانه Pandas خوانده شود.

<path>

مسیر فایل CSV

CLEVERCSV

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