CSVLOOK(1) csvkit CSVLOOK(1)

csvlook - نمایش پرونده‌های CSV در قالب جدول متنی زیبا در خط فرمان

یک پرونده CSV را در خط فرمان با قالبی سازگار با مارک‌داون و عرض ثابت نمایش می‌دهد:

usage: csvlook [-h] [-d DELIMITER] [-t] [-q QUOTECHAR] [-u {0,1,2,3}] [-b]
               [-p ESCAPECHAR] [-z FIELD_SIZE_LIMIT] [-e ENCODING] [-L LOCALE]
               [-S] [--blanks] [--null-value NULL_VALUES [NULL_VALUES ...]]
               [--date-format DATE_FORMAT] [--datetime-format DATETIME_FORMAT]
               [-H] [-K SKIP_LINES] [-v] [-l] [--zero] [-V]
               [--max-rows MAX_ROWS] [--max-columns MAX_COLUMNS]
               [--max-column-width MAX_COLUMN_WIDTH]
               [--max-precision MAX_PRECISION] [--no-number-ellipsis]
               [-y SNIFF_LIMIT] [-I]
               [FILE]
نمایش یک پرونده CSV در خط فرمان به‌صورت یک جدول با عرض ثابت و سازگار با مارک‌داون.
آرگومان‌های مکانی:
  FILE                  پرونده CSV مورد نظر برای پردازش. در صورت حذف، ورودی
                        هدایت‌شده (پایپ) از STDIN پذیرفته می‌شود.
آرگومان‌های اختیاری:
  -h, --help            نمایش این پیام راهنما و خروج
  --max-rows MAX_ROWS   حداکثر تعداد ردیف‌ها برای نمایش پیش از کوتاه کردن داده‌ها.
  --max-columns MAX_COLUMNS
                        حداکثر تعداد ستون‌ها برای نمایش پیش از کوتاه کردن داده‌ها.
  --max-column-width MAX_COLUMN_WIDTH
                        کوتاه کردن تمامی ستون‌ها به حداکثر این عرض. باقیمانده
                        با علامت سه‌نقطه (...) جایگزین خواهد شد.
  --max-precision MAX_PRECISION
                        حداکثر تعداد ارقام اعشار برای نمایش. باقیمانده با
                        علامت سه‌نقطه (...) جایگزین خواهد شد.
  --no-number-ellipsis  غیرفعال کردن سه‌نقطه در صورت فراتر رفتن از --max-precision.
  -y SNIFF_LIMIT, --snifflimit SNIFF_LIMIT
                        محدود کردن شناسایی گویش CSV به تعداد بایت‌های مشخص‌شده.
                        تعیین "0" برای غیرفعال کردن کامل شناسایی، یا
                        "-1" برای بررسی تمام پرونده.
  -I, --no-inference    غیرفعال کردن استنتاج نوع داده (و --locale،
                        --date-format، --datetime-format و --no-leading-zeroes)
                        هنگام تجزیه ورودی.

اگر یک جدول برای نمایش مناسب بیش از حد عریض است، خروجی را با لوله (پایپ) به less -S هدایت کنید یا با استفاده از csvcut آن را کوتاه نمایید.

اگر جدول بیش از حد طولانی است، آن را با grep فیلتر کنید یا خروجی را به less پایپ نمایید.

همچنین ببینید: آرگومان‌های مشترک میان تمام ابزارها.

نکته:

بخش کسری اعداد اعشاری همواره کوتاه می‌شود. برای مهار این رفتار، از --no-inference به همراه --max-column-width استفاده کنید.

کاربرد پایه:

csvlook examples/testfixed_converted.csv

این ابزار به‌ویژه به عنوان عملیات نهایی هنگام هدایت خروجی (پایپ) از میان ابزارهای دیگر بسیار مفید است:

csvcut -c 9,1 examples/realdata/FY09_EDU_Recipients_by_State.csv | csvlook

اگر یک ردیف داده سلول‌های بیشتری نسبت به ردیف سرآیند داشته باشد، csvlook با خطا متوقف می‌شود. برای حذف چنین ردیف‌هایی از csvclean استفاده کنید.

برای نادیده گرفتن سلول‌های اضافی در عوض:

csvcut -C "" examples/bad.csv | csvlook

اگر این ردیف‌ها در بالای پرونده قرار دارند (برای نمونه اعلان‌های حق نشر)، می‌توانید از آن ردیف‌ها صرف‌نظر کنید:

csvlook --skip-lines 1 examples/bad.csv

این خطا همچنین ممکن است زمانی رخ دهد که csvlook ساختار CSV را به‌اشتباه استنتاج ("sniff") کند. برای غیرفعال کردن استنتاج CSV، مقدار --snifflimit 0 را قرار دهید و سپس در صورت نیاز، گزینه‌های --delimiter و --quotechar را خودتان تعیین کنید. یا اینکه مقدار --snifflimit -1 را تعیین کنید تا به‌جای ۱۰۲۴ بایت اول، کل پرونده به عنوان نمونه استفاده شود.

Christopher Groskopf و مشارکت‌کنندگان

2016, Christopher Groskopf and James McKinney

۱۶ اوت ۲۰۲۴ 2.2.0