mirror of
https://github.com/denoland/std.git
synced 2024-11-22 04:59:05 +00:00
46 lines
1.3 KiB
TypeScript
46 lines
1.3 KiB
TypeScript
// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
|
|
|
|
import { extractAndParse, type Parser } from "./_shared.ts";
|
|
import { parse } from "@std/yaml/parse";
|
|
import type { Extract } from "./types.ts";
|
|
import { EXTRACT_YAML_REGEXP } from "./_formats.ts";
|
|
|
|
export type { Extract };
|
|
|
|
/**
|
|
* Extracts and parses {@link https://yaml.org | YAML} from the metadata of
|
|
* front matter content.
|
|
*
|
|
* @example Extract YAML front matter
|
|
* ```ts
|
|
* import { extract } from "@std/front-matter/yaml";
|
|
* import { assertEquals } from "@std/assert";
|
|
*
|
|
* const output = `---yaml
|
|
* title: Three dashes marks the spot
|
|
* ---
|
|
* Hello, world!`;
|
|
* const result = extract(output);
|
|
*
|
|
* assertEquals(result, {
|
|
* frontMatter: "title: Three dashes marks the spot",
|
|
* body: "Hello, world!",
|
|
* attrs: { title: "Three dashes marks the spot" },
|
|
* });
|
|
* ```
|
|
*
|
|
* Note: If you need to pass the options to the yaml parse,
|
|
* use the new version of this API from `@std/yaml/unstable-yaml`.
|
|
*
|
|
* @typeParam T The type of the parsed front matter.
|
|
* @param text The text to extract YAML front matter from.
|
|
* @returns The extracted YAML front matter and body content.
|
|
*/
|
|
export function extract<T>(text: string): Extract<T> {
|
|
return extractAndParse(
|
|
text,
|
|
EXTRACT_YAML_REGEXP,
|
|
((s) => parse(s)) as Parser,
|
|
);
|
|
}
|