Skip to main content

Formatter for Gherkin language

Project description


Build Status   Build Status   Coverage Status

Maintainability   Codacy Badge

License: MIT   PyPI   Code style: black

Table of Contents


Reformat-gherkin automatically formats Gherkin files. It ensures a consistent look regardless of who wrote the file.

It can be used either as a command-line tool, or a pre-commit hook.


Install reformat-gherkin using pip.

pip install reformat-gherkin

It requires Python 3.7+ to run.


To get started straight away:

reformat-gherkin {source_file_or_directory}

You should get good results without specifying any options, as reformat-gherkin uses sensible defaults.

Command-line options

You can list the available options by running reformat-gherkin --help.

Usage: reformat-gherkin [OPTIONS] [SRC]...

  Reformat the given Gherkin files and all files in the given directories

  --check                         Don't write the files back, just return the
                                  status. Return code 0 means nothing would
                                  change. Return code 1 means some files would
                                  be reformatted. Return code 123 means there
                                  was an internal error.
  -a, --alignment [left|right]    Specify the alignment of step keywords
                                  (Given, When, Then,...). If specified, all
                                  statements after step keywords are left-
                                  aligned, spaces are inserted before/after
                                  the keywords to right/left align them. By
                                  default, step keywords are left-aligned, and
                                  there is a single space between the step
                                  keyword and the statement.
  -n, --newline [LF|CRLF]         Specify the line separators when formatting
                                  files inplace. If not specified, line
                                  separators are preserved.
  --fast / --safe                 If --fast given, skip the sanity checks of
                                  file contents. [default: --safe]
  --single-line-tags / --multi-line-tags
                                  If --single-line-tags given, output
                                  consecutive tags on one line. If --multi-
                                  line-tags given, output one tag per line.
                                  [default: --single-line-tags]
  --tab-width INTEGER             Specify the number of spaces per
                                  indentation-level. [default: 2]
  --use-tabs                      Indent lines with tabs instead of spaces.
  --config FILE                   Read configuration from FILE.
  --version                       Show the version and exit.
  --help                          Show this message and exit.

Reformat-gherkin is a well-behaved Unix-style command-line tool:

  • it does nothing if no sources are passed to it;
  • it only outputs messages to users on standard error;
  • it exits with code 0 unless an internal error occurred (or --check was used).

Config file

Reformat-gherkin can read project-specific default values for its command line options from a .reformat-gherkin.yaml file.

By default, reformat-gherkin looks for the config file starting from the common base directory of all files and directories passed on the command line. If it's not there, it looks in parent directories. It stops looking when it finds the file, or a .git directory, or a .hg directory, or the root of the file system, whichever comes first.

Example config file:

check: False
alignment: left
tab_width: 4

Version control integration

You can integrate reformat-gherkin into your version control workflow by using pre-commit. Once you have installed pre-commit, add this to the .pre-commit-config.yaml file in your repository:

  - repo:
    rev: stable
      - id: reformat-gherkin

Then run pre-commit install and you're ready to go.


This project is inspired by black. Some functions are taken from black's source code.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for reformat-gherkin, version 2.0.2
Filename, size File type Python version Upload date Hashes
Filename, size reformat_gherkin-2.0.2-py3-none-any.whl (25.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size reformat-gherkin-2.0.2.tar.gz (20.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page