https://github.com/gherking/gherkin-io

Tool to read/write Gherkin feature files and to work with Gherkin-AST
https://github.com/gherking/gherkin-io

ast cucumber feature-file gherkin gherking hacktoberfest typescript

Last synced: 9 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/gherking/gherkin-io
• Owner: gherking
• License: mit
• Created: 2018-03-24T16:35:02.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-06-17T04:30:09.000Z (5 months ago)
• Last Synced: 2024-10-31T10:51:41.583Z (16 days ago)
• Topics: ast, cucumber, feature-file, gherkin, gherking, hacktoberfest, typescript
• Language: TypeScript
• Homepage: https://gherking.github.io/gherkin-io/
• Size: 540 KB
• Stars: 3
• Watchers: 5
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# gherkin-io

![Downloads](https://img.shields.io/npm/dw/gherkin-io?style=flat-square)

![Version@npm](https://img.shields.io/npm/v/gherkin-io?label=version%40npm&style=flat-square)

![Version@git](https://img.shields.io/github/package-json/v/gherking/gherkin-io/master?label=version%40git&style=flat-square)

![CI](https://img.shields.io/github/actions/workflow/status/gherking/gherkin-io/ci.yml?branch=master&label=ci&style=flat-square)

![Docs](https://img.shields.io/github/actions/workflow/status/gherking/gherkin-io/docs.yml?branch=master&label=docs&style=flat-square)

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](https://github.com/gherking/gherkin-io).

```typescript

function parse(content: string, uri: string): Promise

```

In TypeScript:

```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:

```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](https://github.com/gherking/gherkin-io).

```typescript

function read(pattern: string): Promise

```

In TypeScript:

```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:

```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.

```typescript

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

```

In TypeScript:

```typescript

import {Document, write, FormatterOptions} from "gherkin-io";

const document: Document = new Document(/*...*/);

const options: FormatterOptions = {/*...*/};

await write("./test.feature", document, options);

```

In JavaScript:

```javascript

const {write, Document} = require("gherkin-io");

const document = new Document(/*...*/);

const options = {/*...*/};

await write("./test.feature", document, options);

```

`FormatterOptions` is re-exported from [gherkin-formatter](https://github.com/gherking/gherkin-formatter).

For detailed documentation see the [TypeDocs documentation](https://gherking.github.io/gherkin-io/).