.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "IN2CSV" "1" "Aug 16, 2024" "2.2.0" "csvkit"
.SH "نام (NAME)"
in2csv \- تبدیل قالب‌های مختلف داده‌های جدولی به CSV
.SH "توضیحات (DESCRIPTION)"
.sp
قالب‌های گوناگون داده‌های جدولی را به CSV تبدیل می‌کند.
.sp
تبدیل پرونده‌های با عرض ثابت (fixed width) مستلزم ارائه یک فایل طرحواره (schema) با گزینه \(dq\-s\(dq است. فایل طرحواره باید ساختار زیر را داشته باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
column,start,length
name,0,30
birthday,30,10
age,40,3
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
سطر سرایند الزامی است، اگرچه ستون‌ها می‌توانند به هر ترتیبی باشند:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
usage: in2csv [\-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]
              [\-f {csv,dbf,fixed,geojson,json,ndjson,xls,xlsx}] [\-s SCHEMA]
              [\-k KEY] [\-n] [\-\-sheet SHEET] [\-\-write\-sheets WRITE_SHEETS]
              [\-\-use\-sheet\-names] [\-\-reset\-dimensions]
              [\-\-encoding\-xls ENCODING_XLS] [\-y SNIFF_LIMIT] [\-I]
              [FILE]

Convert common, but less awesome, tabular data formats to CSV.

positional arguments:
  FILE                  The CSV file to operate on. If omitted, will accept
                        input as piped data via STDIN.

optional arguments:
  \-h, \-\-help            show this help message and exit
  \-f {csv,dbf,fixed,geojson,json,ndjson,xls,xlsx}, \-\-format {csv,dbf,fixed,geojson,json,ndjson,xls,xlsx}
                        The format of the input file. If not specified will be
                        inferred from the file type.
  \-s SCHEMA, \-\-schema SCHEMA
                        Specify a CSV\-formatted schema file for converting
                        fixed\-width files. See web documentation.
  \-k KEY, \-\-key KEY     Specify a top\-level key to look within for a list of
                        objects to be converted when processing JSON.
  \-n, \-\-names           Display sheet names from the input Excel file.
  \-\-sheet SHEET         The name of the Excel sheet to operate on.
  \-\-write\-sheets WRITE_SHEETS
                        The names of the Excel sheets to write to files, or
                        \(dq\-\(dq to write all sheets.
  \-\-use\-sheet\-names     Use the sheet names as file names when \-\-write\-sheets
                        is set.
  \-\-reset\-dimensions    Ignore the sheet dimensions provided by the XLSX file.
  \-\-encoding\-xls ENCODING_XLS
                        Specify the encoding of the input XLS file.
  \-y SNIFF_LIMIT, \-\-snifflimit SNIFF_LIMIT
                        Limit CSV dialect sniffing to the specified number of
                        bytes. Specify \(dq0\(dq to disable sniffing entirely, or
                        \(dq\-1\(dq to sniff the entire file.
  \-I, \-\-no\-inference    Disable type inference (and \-\-locale, \-\-date\-format,
                        \-\-datetime\-format, \-\-no\-leading\-zeroes) when parsing
                        CSV input.

 Some command\-line flags only pertain to specific input formats.
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
همچنین ببینید: آرگومان‌های مشترک میان تمام ابزارها.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
قالب \(dqndjson\(dq به معنای \(dqJSON با جداکننده خط جدید\(dq (newline delimited JSON) است که در بسیاری از APIهای جریانی استفاده می‌شود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اگر یک فایل XLS هنگام مشاهده در اکسل کاملاً مشابه با یک فایل XLSX به نظر برسد، ممکن است در خروجی CSV یکسان نباشند. برای مثال، XLSX نوع داده عدد صحیح دارد اما XLS ندارد. اعدادی که در یک فایل XLS مشابه اعداد صحیح به نظر می‌رسند در CSV دارای اعشار خواهند بود، در حالی که در فایل XLSX چنین نخواهد بود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
جهت تبدیل از قالب HTML، ابزار \fI\%messytables\fP را مد نظر قرار دهید.
.UNINDENT
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.sp
تبدیل فایل سرستون‌های جغرافیایی سرشماری ۲۰۰۰ از عرض ثابت به CSV و از کدگذاری latin-1 به utf8:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
in2csv \-e iso\-8859\-1 \-f fixed \-s examples/realdata/census_2000/census2000_geo_schema.csv examples/realdata/census_2000/usgeo_excerpt.upl
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
مجموعه‌ای از طرحواره‌های با عرض ثابت در پروژه \fBffs\fP نگهداری می‌شود:
.sp
\fI\%https://github.com/wireservice/ffs\fP
.UNINDENT
.UNINDENT
.sp
تبدیل یک فایل اکسل .xls:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
in2csv examples/test.xls
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
استانداردسازی قالب‌بندی یک فایل CSV (نقل‌قول‌ها، انتهای خطوط و غیره):
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
in2csv examples/realdata/FY09_EDU_Recipients_by_State.csv
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
دریافت issueهای باز csvkit از وب‌سرویس گیت‌هاب، تبدیل پاسخ JSON به CSV و نوشتن آن در یک فایل:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
curl https://api.github.com/repos/wireservice/csvkit/issues?state=open | in2csv \-f json \-v
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
تبدیل یک فایل DBase DBF به معادل CSV آن:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
in2csv examples/testdbf.dbf
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
این ابزار به سرایندهای بدون نام، نام اختصاص می‌دهد. برای جلوگیری از این رفتار اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
in2csv \-\-no\-header\-row examples/test.xlsx | tail \-n +2
.ft P
.fi
.UNINDENT
.UNINDENT
.SH "عیب‌یابی (TROUBLESHOOTING)"
.sp
اگر هنگام ارائه فایل ورودی با قالب CSV یا اکسل خطایی مانند خطای زیر رخ دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
ValueError: Row 0 has 11 values, but Table only has 1 columns.
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
ممکن است فایل ورودی دارای سطر‌های ابتدایی پیش از سطر سرایند و سطر‌های داده باشد. می‌توانید با استفاده از \fB\-\-skip\-lines\fP (\fB\-K\fP) این ردیف‌ها را نادیده بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
in2csv \-\-skip\-lines 3 examples/test_skip_lines.csv
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
اگر یک فایل XLSX سطر‌ها یا ستون‌های بسیار کمی تولید کند، ممکن است برنامه‌ای که فایل را ایجاد کرده \fI\%ابعاد کاربرگ را اشتباه تنظیم کرده باشد\fP\&. دوباره با گزینه \fB\-\-reset\-dimensions\fP امتحان کنید.
.SH "نویسنده (AUTHOR)"
Christopher Groskopf و مشارکت‌کنندگان
.SH "حق نشر (COPYRIGHT)"
2016, Christopher Groskopf and James McKinney
.\" Generated by docutils manpage writer.
.