'\" t
.\"     Title: clevercsv-code
.\"    Author: G.J.J. van den Burg
.\" Generator: Wilderness <https://pypi.org/project/wilderness>
.\"      Date: 2026-05-11
.\"    Manual: clevercsv Manual
.\"    Source: clevercsv 0.8.5
.\"  Language: Persian
.\"
.TH "CLEVERCSV-CODE" "1" "2026\-05\-11" "Clevercsv 0\&.8\&.5" "Clevercsv Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting *
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
clevercsv-code \- تولید کد پایتون برای وارد کردن یک فایل CSV
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIclevercsv code [\-e ENCODING | \-\-encoding=ENCODING]
               [\-n NUM_CHARS | \-\-num\-chars=NUM_CHARS] [\-p | \-\-pandas] <path>
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
تولید کد پایتون برای وارد کردن یک فایل CSV مشخص. این قابلیت به‌ویژه زمانی مفید است که نمی‌خواهید گویش (dialect) یک فایل یکسان را بارها و بارها شناسایی کنید. کافی است دستور زیر را اجرا کنید:
.sp
.RS 4
clevercsv code your_csv_file.csv
.RE
.sp
و کد تولیدشده را در یک اسکریپت پایتون کپی کنید.
.SH "گزینه‌ها (OPTIONS)"
.sp
.sp
.sp
\-h, \-\-help
.RS 4
نمایش این پیام راهنما و خروج
.RE
.PP
\-e, \-\-encoding
.RS 4
کدگذاری فایل CSV مشخص‌شده به‌طور خودکار با استفاده از chardet شناسایی می‌شود. در حالی که chardet بسیار دقیق است، اما بی‌نقص نیست. در موارد نادری که در تشخیص کدگذاری فایل دچار اشتباه شود، می‌توانید با تعیین کدگذاری از طریق این پرچم، آن را لغو و بازنویسی کنید. علاوه بر این، هنگامی که چندین فایل CSV با کدگذاری مشخص دارید، می‌توانید از این گزینه برای افزایش سرعت فرایند تولید کد استفاده کنید.
.RE
.PP
\-n, \-\-num\-chars
.RS 4
در فایل‌های بزرگ CSV، تشخیص گویش ممکن است به دلیل تعداد زیاد گویش‌های محتمل برای بررسی، گاهی کمی کُند باشد. برای رفع این مشکل، می‌توانید تعداد کاراکترهای مورد استفاده برای تشخیص را محدود کنید.
.sp
نکته‌ای که باید در نظر داشت این است که ممکن است CleverCSV برای استنتاج صحیح گویش نیاز به خواندن تعداد مشخصی از کاراکترها داشته باشد. برای مثال، در فایل ``imdb.csv`` در مخزن گیت‌هاب (GitHub)، گویش صحیح تنها پس از خواندن دست‌کم ۶۶ سطر از فایل قابل تشخیص است. بنابراین، اگر امکان اجرای CleverCSV روی کل فایل وجود دارد، به‌طور کلی همان توصیه می‌شود.
.RE
.PP
\-p, \-\-pandas
.RS 4
به‌طور پیش‌فرض، این دستور یک اسکریپت کوچک پایتون برای وارد کردن فایل CSV به عنوان یک لیست از لیست‌ها (list of lists) ایجاد می‌کند. با فعال کردن این گزینه، اسکریپت به‌گونه‌ای نوشته می‌شود که فایل به‌جای آن به عنوان یک DataFrame از کتابخانه Pandas خوانده شود.
.RE
.PP
<path>
.RS 4
مسیر فایل CSV
.RE
.PP
.sp
.SH "CLEVERCSV"
.sp
بخشی از مجموعه CleverCSV