docs(csv): use assertions in example code snippets

csv/_io.ts

@@ -219,12 +219,13 @@ function runeCount(s: string): number {
  * @example Usage
  * ```ts
  * import { parse, ParseError } from "@std/csv/parse";
+ * import { assertEquals } from "@std/assert/assert-equals";
  *
  * try {
  *   parse(`a "word","b"`);
  * } catch (error) {
  *   if (error instanceof ParseError) {
- *     console.error(error.message);
+ *     assertEquals(error.message, `parse error on line 1, column 2: bare " in non-quoted-field`);
  *   }
  * }
  * ```
@@ -236,12 +237,13 @@ export class ParseError extends SyntaxError {
    * @example Usage
    * ```ts
    * import { parse, ParseError } from "@std/csv/parse";
+   * import { assertEquals } from "@std/assert/assert-equals";
    *
    * try {
    *   parse(`a "word","b"`);
    * } catch (error) {
    *   if (error instanceof ParseError) {
-   *     console.error(error.startLine);
+   *     assertEquals(error.startLine, 1);
    *   }
    * }
    * ```
@@ -253,12 +255,13 @@ export class ParseError extends SyntaxError {
    * @example Usage
    * ```ts
    * import { parse, ParseError } from "@std/csv/parse";
+   * import { assertEquals } from "@std/assert/assert-equals";
    *
    * try {
    *   parse(`a "word","b"`);
    * } catch (error) {
    *   if (error instanceof ParseError) {
-   *     console.error(error.line);
+   *     assertEquals(error.line, 1);
    *   }
    * }
    * ```
@@ -270,12 +273,13 @@ export class ParseError extends SyntaxError {
    * @example Usage
    * ```ts
    * import { parse, ParseError } from "@std/csv/parse";
+   * import { assertEquals } from "@std/assert/assert-equals";
    *
    * try {
    *   parse(`a "word","b"`);
    * } catch (error) {
    *   if (error instanceof ParseError) {
-   *     console.error(error.column);
+   *     assertEquals(error.column, 2);
    *   }
    * }
    * ```
@@ -286,10 +290,17 @@ export class ParseError extends SyntaxError {
    * Constructs a new instance.
    *
    * @example Usage
-   * ```ts no-eval
-   * import { ParseError } from "@std/csv/parse";
+   * ```ts
+   * import { parse, ParseError } from "@std/csv/parse";
+   * import { assertEquals } from "@std/assert/assert-equals";
    *
-   * throw new ParseError(1, 2, 3, "error message");
+   * try {
+   *   parse(`a "word","b"`);
+   * } catch (error) {
+   *   if (error instanceof ParseError) {
+   *     assertEquals(error.message, `parse error on line 1, column 2: bare " in non-quoted-field`);
+   *   }
+   * }
    * ```
    *
    * @param start Line where the record starts

csv/csv_parse_stream.ts

@@ -67,7 +67,7 @@ export type RowType<T> = T extends undefined ? string[]
  * {@link https://www.rfc-editor.org/rfc/rfc4180.html | RFC 4180}.
  *
  * @example Usage
- * ```ts
+ * ```ts no-assert
  * import { CsvParseStream } from "@std/csv/csv-parse-stream";
  *
  * const source = ReadableStream.from([
@@ -98,7 +98,7 @@ export class CsvParseStream<
   /** Construct a new instance.
    *
    * @example Usage
-   * ```ts
+   * ```ts no-assert
    * import { CsvParseStream } from "@std/csv/csv-parse-stream";
    *
    * const source = ReadableStream.from([
@@ -196,7 +196,7 @@ export class CsvParseStream<
    * The instance's {@linkcode ReadableStream}.
    *
    * @example Usage
-   * ```ts
+   * ```ts no-assert
    * import { CsvParseStream } from "@std/csv/csv-parse-stream";
    *
    * const source = ReadableStream.from([
@@ -222,7 +222,7 @@ export class CsvParseStream<
    * The instance's {@linkcode WritableStream}.
    *
    * @example Usage
-   * ```ts
+   * ```ts no-assert
    * import { CsvParseStream } from "@std/csv/csv-parse-stream";
    *
    * const source = ReadableStream.from([

csv/csv_stringify_stream.ts

@@ -23,7 +23,7 @@ export interface CsvStringifyStreamOptions {
  * Convert each chunk to a CSV record.
  *
  * @example Usage
- * ```ts
+ * ```ts no-assert
  * import { CsvStringifyStream } from "@std/csv/csv-stringify-stream";
  *
  * const path = await Deno.makeTempFile();
@@ -53,7 +53,7 @@ export class CsvStringifyStream<TOptions extends CsvStringifyStreamOptions>
    * Construct a new instance.
    *
    * @example Usage
-   * ```ts
+   * ```ts no-assert
    * import { CsvStringifyStream } from "@std/csv/csv-stringify-stream";
    *
    * const path = await Deno.makeTempFile();

csv/mod.ts

@@ -32,7 +32,7 @@
  *
  * results in the fields
  *
- * ```ts
+ * ```ts no-assert
  * [`normal string`, `quoted-field`]
  * ```
  *
@@ -55,7 +55,7 @@
  *
  * results in
  *
- * ```ts
+ * ```ts no-assert
  * [`Multi-line
  * field`, `comma is ,`]
  * ```

csv/stringify.ts

@@ -172,7 +172,7 @@ function normalizeColumn(column: Column): NormalizedColumn {
  * Error thrown in {@linkcode stringify}.
  *
  * @example Usage
- * ```ts
+ * ```ts no-assert
  * import { stringify, StringifyError } from "@std/csv/stringify";
  *
  * try {