'\" t
.\"     Title: clevercsv-explore
.\"    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-EXPLORE" "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-explore \- کاوش فایل CSV در یک شل تعاملی Python
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIclevercsv explore [\-e ENCODING | \-\-encoding=ENCODING]
                  [\-n NUM_CHARS | \-\-num\-chars=NUM_CHARS] [\-p | \-\-pandas] <path>
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
دستور explore به شما امکان می‌دهد تا یک فایل CSV را به‌سرعت در یک شل تعاملی Python کاوش کنید. این دستور گویش (dialect) فایل CSV را تشخیص داده و شما را با فایل CSVِ از پیش بارگذاری‌شده، وارد یک شل تعاملی Python (محیط REPL) می‌کند. برای شروع تنها کافی است دستور زیر را اجرا کنید:
.sp
.RS 4
clevercsv explore FILE
.RE
.sp
تا کار با فایل بارگذاری‌شده به‌صورت لیستی از لیست‌ها آغاز شود. متناوباً، می‌توانید دستور زیر را اجرا کنید:
.sp
.RS 4
clevercsv explore \-p FILE
.RE
.sp
تا فایل به‌صورت یک DataFrame در Pandas خوانده شود.
.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 را به‌صورت لیستی از لیست‌ها وارد می‌کند. با فعال‌سازی این گزینه، اسکریپت به‌گونه‌ای نوشته می‌شود که فایل به‌جای آن به‌صورت یک Pandas DataFrame خوانده شود.
.RE
.PP
<path>
.RS 4
مسیر فایل CSV
.RE
.PP
.sp
.SH "CLEVERCSV"
.sp
بخشی از مجموعه CleverCSV