gherking/gherkin-io

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 28 Commits
.github/workflows		.github/workflows
src		src
tests		tests
.eslintignore		.eslintignore
.eslintrc		.eslintrc
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

Repository files navigation

gherkin-io

Downloads Version@npm Version@git CI Docs

Tool to read/write Gherkin feature files and work with Gherking AST

Usage

Parse feature string

The parse function can be used to parse feature file content to AST.

function parse(content: string, uri: string): Promise<Document>

In TypeScript:

import {parse, Document} from "gherkin-io";
import {TagFormat} from "gherkin-ast";
const document: Document = await parse(
 "Feature: Test\n...",
 "./features/test.feature",
 {tagFormat: TagFormat.FUNCTIONAL} // default
);

In JavaScript:

const {parse} = require("gherkin-io");
const {TagFormat} = require("gherkin-ast");
const document = await read(
 "Feature: Test\n...", 
 "./features/test.feature", 
 {tagFormat: TagFormat.FUNCTIONAL} // default
);

Read feature files

The read function can be used to parse feature file(s) to AST.

function read(pattern: string): Promise<Document[]>

In TypeScript:

import {read, Document} from "gherkin-io";
import {TagFormat} from "gherkin-ast";
const documents: Document[] = await read(
 "./features/*.feature",
 {tagFormat: TagFormat.FUNCTIONAL} // default
);

In JavaScript:

const {read} = require("gherkin-io");
const {TagFormat} = require("gherkin-ast");
const documents = await read(
 "./features/*.feature",
 {tagFormat: TagFormat.FUNCTIONAL} // default
);

Write feature files

The write function can be used to write an AST to a feature file.

function write(filePath: string, document: Document, options?: FormatterOptions): Promise<void>

In TypeScript:

import {Document, write, FormatterOptions} from "gherkin-io";
const document: Document = new Document(/*...*/);
const options: FormatterOptions = {/*...*/};
await write("./test.feature", document, options);

In JavaScript:

const {write, Document} = require("gherkin-io");
const document = new Document(/*...*/);
const options = {/*...*/};
await write("./test.feature", document, options);