'\" t
.\"     Title: clevercsv-standardize
.\"    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: English
.\"
.TH "CLEVERCSV-STANDARDIZE" "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-standardize \- تبدیل فایل CSV به قالبی منطبق با RFC-4180
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIclevercsv 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 \&...]>
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
دستور standardize می‌تواند برای تبدیل یک فایل CSV غیر استاندارد به قالب استاندارد RFC\-4180 استفاده شود [1]. هنگام استفاده از گزینهٔ \-\-in\-place، می‌توان از کد بازگشتی CleverCSV برای بررسی تغییر یافتن یا نیافتن فایل استفاده کرد. در صورتی که فایل تغییر یافته باشد، کد بازگشتی ۲ و در غیر این صورت ۰ خواهد بود.
.sp
[1]: https://tools.ietf.org/html/rfc4180
.SH "گزینه‌ها (OPTIONS)"
.sp
.sp
.sp
\-h, \-\-help
.RS 4
نمایش این پیام راهنما و خروج.
.RE
.PP
\-e, \-\-encoding
.RS 4
کدگذاری فایل CSV داده‌شده به‌طور خودکار با استفاده از chardet شناسایی می‌شود. اگرچه chardet فوق‌العاده دقیق است، اما بی‌نقص نیست. در موارد نادری که در تشخیص کدگذاری فایل اشتباه می‌کند، می‌توانید با ارائهٔ آن از طریق این پرچم، کدگذاری را بازنویسی کنید. برای این دستور، کدگذاری ارائه‌شده برای فایل(های) خروجی نیز اعمال خواهد شد. اگر تنها یک کدگذاری تعیین شود، برای تمام فایل‌های داده‌شده در خط فرمان استفاده خواهد شد. در صورت ارائهٔ چندین کدگذاری، تعداد آن‌ها باید با تعداد فایل‌های ارائه‌شده در ورودی مطابقت داشته باشد.
.RE
.PP
\-E, \-\-target\-encoding
.RS 4
در صورت عدم تعیین، کدگذاری فایل خروجی همانند فایل اصلی خواهد بود.
.RE
.PP
\-i, \-\-in\-place
.RS 4
استانداردسازی و بازنویسی در جای فایل(های) ورودی.
.RE
.PP
\-n, \-\-num\-chars
.RS 4
در فایل‌های بزرگ CSV، تشخیص گویش (dialect detection) به دلیل تعداد زیاد گویش‌های محتمل، ممکن است گاهی کمی کند باشد. برای تسریع این روند، می‌توانید تعداد نویسه‌های مورد استفاده برای تشخیص را محدود کنید.
.sp
نکته‌ای که باید در نظر داشت این است که CleverCSV ممکن است برای استنتاج صحیح گویش به خواندن تعداد معینی نویسه نیاز داشته باشد. به عنوان مثال، در فایل ``imdb.csv`` موجود در مخزن GitHub، گویش صحیح تنها پس از خواندن حداقل ۶۶ خط از فایل قابل شناسایی است. بنابراین، اگر امکان اجرای CleverCSV روی کل فایل وجود دارد، انجام آن معمولاً توصیه می‌شود.
.RE
.PP
\-o, \-\-output
.RS 4
فایل‌های خروجی برای نوشتن فایل‌های ورودیِ استانداردشده. در صورت استفاده از این گزینه همراه با بیش از یک فایل ورودی، ترتیب فایل‌های ورودی و ترتیب فایل‌های خروجی باید یکسان باشد.
.RE
.PP
\-t, \-\-transpose
.RS 4
ترانهادن ستون‌های فایل(های) ورودی پیش از نوشتن.
.RE
.PP
<path>
.RS 4
مسیر یک یا چند فایل CSV.
.RE
.PP
.sp
.SH "CLEVERCSV"
.sp
بخشی از مجموعهٔ CleverCSV