Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/antham/ghokin
Parallelized formatter with no external dependencies for gherkin (cucumber, behat...)
https://github.com/antham/ghokin
behat cucumber formatter gherkin
Last synced: 24 days ago
JSON representation
Parallelized formatter with no external dependencies for gherkin (cucumber, behat...)
- Host: GitHub
- URL: https://github.com/antham/ghokin
- Owner: antham
- License: mit
- Created: 2018-08-03T11:36:35.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-09-06T06:00:11.000Z (about 2 months ago)
- Last Synced: 2024-09-27T11:41:05.660Z (about 1 month ago)
- Topics: behat, cucumber, formatter, gherkin
- Language: Go
- Homepage:
- Size: 442 KB
- Stars: 43
- Watchers: 5
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-go - ghokin - Parallelized formatter with no external dependencies for gherkin (cucumber, behat...). (Utilities / Utility/Miscellaneous)
- awesome-go-extra - ghokin - 08-03T11:36:35Z|2022-06-30T07:03:03Z| (Utilities / Fail injection)
README
# [](https://goreportcard.com/report/github.com/antham/ghokin) [](https://codecov.io/gh/antham/ghokin) []()
Ghokin format and apply transformation on gherkin files.
---
- [Install](#install)
- [Usage](#usage)
- [Documentation](#documentation)
- [Contribute](#contribute)
---
## Install
Download the latest binary for your achitecture [here](https://github.com/antham/ghokin/releases/latest).
If you can't find a binary for your architecture, install the go toolchain, clone the repository and run : `go install .`.
## Usage
```
Clean and/or apply transformation on gherkin files
Usage:
ghokin [command]
Available Commands:
check Check a file/folder is well formatted
fmt Format a feature file/folder
help Help about any command
Flags:
--config string config file
-h, --help help for ghokin
Use "ghokin [command] --help" for more information about a command.
```
⚠️ Ghokin works only on `UTF-8` encoded files, it will detect and convert automatically files that are not encoded in this charset.
### fmt stdout
Dump stdin or a feature file formatted on stdout
```
ghokin fmt stdout features/test.feature
```
or
```
cat features/test.feature|ghokin fmt stdout
```
### fmt replace
Format and replace a file or all files in a directory
```
ghokin fmt replace features/test.feature
```
or
```
ghokin fmt replace features/
```
### check
Ensure a file or all files in a directory are well formatted, exit with an error code otherwise
```
ghokin check features/test.feature
```
or
```
ghokin check features/
```
## Documentation
### Shell commands
You can run shell commands from within your feature file to transform some datas with annotations, to do so you need first to define in the config an alias and afterwards you can simply "comment" the line before the line you want to transform with that alias.
For instance let say `@json` calls behind the curtain `jq`, we could validate and format some json in our feature like so :
```
Feature: A Feature
Description
Scenario: A scenario to test
Given a thing
# @json
"""
{
"test": "test"
}
"""
```
### Config
Defaut config is to use 2 spaces for indentation.
It's possible to override configuration by defining a `.ghokin.yml` file in the home directory or in the current directory where we are running the binary from :
```
indent: 2
aliases:
json: "jq ."
```
Aliases key defined [shell commands](#shell-commands) callable in comments as we discussed earlier.
It's possible to use environments variables instead of a static config file :
```
export GHOKIN_INDENT=2
export GHOKIN_ALIASES='{"json":"jq ."}'
```
## Contribute
If you want to add a new feature to ghokin project, the best way is to open a ticket first to know exactly how to implement your changes in code.
### Setup
After cloning the repository you need to install vendors with `go mod vendor`
To test your changes locally you can run go tests with : `make test-all`