@stoplight/yaml

Useful functions when working with YAML.

Explore the interfaces: TSDoc
View the changelog: Releases

Installation

Supported in modern browsers and node.

# latest stable
yarn add @stoplight/yaml

Usage

getJsonPathForPosition: Computes JSON path for given position.
getLocationForJsonPath: Retrieves location of node matching given JSON path.
parseWithPointers: Parses YAML into JSON and also returns diagnostics as well as full ast with line information.

// basic example of parseWithPointers
import { parseWithPointers } from "@stoplight/yaml";

const result = parseWithPointers("foo: bar");

console.log(result.data); // => the {foo: "bar"} JS object

// basic example of getJsonPathForPosition and getLocationForJsonPath
import { getJsonPathForPosition, getLocationForJsonPath, parseWithPointers } from "@stoplight/yaml";

const result = parseWithPointers(`hello: world
address:
    street: 123`
);

const path = getJsonPathForPosition(result, { line: 2, character: 7 }); // line and character are 0-based
console.log(path); // -> ["address", "street"];

const position = getLocationForJsonPath(result, ['address']);
console.log(position.range.start); // { line: 1, character: 8 } line and character are 0-based
console.log(position.range.end); // { line: 2, character: 15 } line and character are 0-based

Contributing

Clone repo.
Create / checkout feature/{name}, chore/{name}, or fix/{name} branch.
Install deps: yarn.
Make your changes.
Run tests: yarn test.prod.
Stage relevant files to git.
Commit: yarn commit. NOTE: Commits that don't follow the conventional format will be rejected. yarn commit creates this format for you, or you can put it together manually and then do a regular git commit.
Push: git push.
Open PR targeting the next branch.

License

stoplightio/yaml

ErrorLooks like something went wrong!

About

Resources

License

Stars

Watchers

Forks

Releases 46

Packages 0

Contributors 7

Languages

Error
Looks like something went wrong!

Packages