parsecsv/csv-spec.org
1
0
Fork 0
mirror of https://github.com/parsecsv/csv-spec.org.git synced 2026-02-19 08:56:39 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add 0.9.0-draft.2

Browse Source
This commit is contained in:
Jim Myhrberg
2017-10-08 16:27:12 +01:00
parent fd1e7465b8
commit fb8c45b6f2
8 changed files with 662 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
docs/index.html
View File

@@ -9,8 +9,8 @@
<link rel="stylesheet" href="https:////maxcdn.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css">
<link type="text/css" rel="stylesheet" href="/assets/main-5df19fc13b2a391dcab974f0584820f95eecdd416e60b99950f2058c61a2e99f.css">
<!-- Begin Jekyll SEO tag v2.2.3 -->
<title>CSV Spec 0.9.0-draft.1 | CSV Spec</title>
<meta property="og:title" content="CSV Spec 0.9.0-draft.1" />
<title>CSV Spec 0.9.0-draft.2 | CSV Spec</title>
<meta property="og:title" content="CSV Spec 0.9.0-draft.2" />
<meta name="author" content="Jim Myhrberg" />
<meta property="og:locale" content="en_US" />
<meta name="description" content="An attempt to describe CSV-like formats in a obvious and easy to understand way, complete with code examples aimed at developers." />
@@ -19,7 +19,7 @@
<meta property="og:url" content="https://csv-spec.org/" />
<meta property="og:site_name" content="CSV Spec" />
<script type="application/ld+json">
{"@context":"http://schema.org","@type":"WebSite","name":"CSV Spec","headline":"CSV Spec 0.9.0-draft.1","author":{"@type":"Person","name":"Jim Myhrberg"},"description":"An attempt to describe CSV-like formats in a obvious and easy to understand way, complete with code examples aimed at developers.","url":"https://csv-spec.org/"}
{"@context":"http://schema.org","@type":"WebSite","name":"CSV Spec","headline":"CSV Spec 0.9.0-draft.2","author":{"@type":"Person","name":"Jim Myhrberg"},"description":"An attempt to describe CSV-like formats in a obvious and easy to understand way, complete with code examples aimed at developers.","url":"https://csv-spec.org/"}
</script>
<!-- End Jekyll SEO tag -->
</head>
@@ -34,7 +34,10 @@
<li class="pure-menu-item">
<div class="pure-menu-label">Versions:</div>
</li>
<li class="pure-menu-item version-0.9.0-draft.1 pure-menu-selected">
<li class="pure-menu-item version-0.9.0-draft.2 pure-menu-selected">
<a href="/spec/0.9.0-draft.2.html" class="pure-menu-link">0.9.0-draft.2</a>
</li>
<li class="pure-menu-item version-0.9.0-draft.1">
<a href="/spec/0.9.0-draft.1.html" class="pure-menu-link">0.9.0-draft.1</a>
</li>
</ul>
@@ -47,7 +50,7 @@
</div>
<div id="main">
<div class="content">
<h1 id="csv-spec-090-draft1">CSV Spec 0.9.0-draft.1</h1>
<h1 id="csv-spec-090-draft2">CSV Spec 0.9.0-draft.2</h1>
<h2 id="summary">Summary</h2>
<p>CSV is not a file format, it is a loose set of guidelines of how to structure
tabular data into a plain text string. As such there’s an endless amount of
@@ -71,8 +74,8 @@
<h2 id="roadmap">Roadmap</h2>
<ol>
<li>Write up core specification rules. <em>[in-progress]</em></li>
<li>~Create website for <a href="http://csv-spec.org/">csv-spec.org</a>.~ <em><strong>[done]</strong></em></li>
<li>Create input/output test files covering all rules in the specification.</li>
<li>Create website for <a href="http://csv-spec.org/">csv-spec.org</a>.</li>
<li>Create linting tool as a NPM module, allowing easy validation of CSV data
both client-side in a web browser, and server side via a command line tool.</li>
<li>Create automatic delimiter character detection code snippets in various
@@ -94,9 +97,9 @@
<li><strong>Line Break</strong> — Line breaks in CSV files can be CRLF (<code class="highlighter-rouge">\r\n</code>), LF (<code class="highlighter-rouge">\n</code>), and
even in rare cases CR (<code class="highlighter-rouge">\r</code>).</li>
<li><strong>LF, CR, and CRLF</strong> — Different types of line breaks, typically determined by
the OS. Linux, OSX, and other *NIX operating systems generally use a line feed
(LF or <code class="highlighter-rouge">\n</code>) character. Windows uses a carriage return (CR or <code class="highlighter-rouge">\r</code>) and a line
feed character, effectively “CRLF” (<code class="highlighter-rouge">\r\n</code>).</li>
the OS. Linux, macOS, and other *NIX operating systems generally use a line
feed (LF or <code class="highlighter-rouge">\n</code>) character. Windows uses a carriage return (CR or <code class="highlighter-rouge">\r</code>) and a
line feed character, effectively “CRLF” (<code class="highlighter-rouge">\r\n</code>).</li>
</ul>
<h2 id="csv-format-specification">CSV Format Specification</h2>
<p>The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”,
@@ -289,8 +292,10 @@ xxx, "y, yy" ,zzz¬
<li><code class="highlighter-rouge">Null</code>/<code class="highlighter-rouge">nil</code> values MUST be rendered as empty strings.</li>
</ul>
</li>
<li>When parsing input CSV data all forms of line breaks (CRLF, LF, and CR) MUST
be supported.</li>
<li>
<p>When parsing input CSV data all forms of line breaks (CRLF, LF, and CR) MUST
be supported.</p>
</li>
<li>When rendering output CSV data, CRLF MUST be used for line breaks to ensure
maximum cross-platform compatibility.</li>
</ol>