gherkin-official
Gherkin parser (official, by Cucumber team)
Decision gist · record as of 2026-08-14
Yes. This is the official Gherkin parser maintained by the Cucumber team, actively developed, permissively licensed (MIT), and has minimal dependencies. Install it if you need to parse or compile Gherkin feature files programmatically or integrate BDD workflows into custom tooling. The only constraint is a Python 3.10+ requirement.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Low install friction with a single lightweight runtime dependency (typing-extensions).
- Active maintenance with a recent release (9 days old) and steady repository activity.
License · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution in both open-source and proprietary projects.
last release 2026-08-05 (9 days) · last repo commit 2026-08-10 · 391 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 2,846,540 downloads/mo, #2,863 on PyPI
Alternatives
Verify before relying
from gherkin import Compiler, Parser
gherkin_document = Parser().parse("Feature: ...")
gherkin_document["uri"] = "uri_of_the_feature.feature"
pickles = Compiler().compile(gherkin_document)- Whether the library API is stable across minor versions or subject to breaking changes
- Performance characteristics when parsing large feature files or many files in sequence
- Whether i18n support covers all languages needed for your test suite
What it is and what it does
Gherkin is the official parser and compiler for the Gherkin language, maintained by the Cucumber team. It reads Gherkin feature files (plain-text specifications written in a business-readable syntax) and converts them into structured data—abstract syntax trees and pickles—that testing frameworks can execute. The library is designed to work in-process, producing easily consumable objects without requiring subprocess calls or JSON parsing.
You can use it either as a library (the recommended approach) or via a command-line interface that outputs newline-delimited JSON conforming to the Cucumber Event Protocol. It supports multiple languages through i18n translations and handles table cell escaping. The package depends only on typing-extensions and supports Python 3.10 through 3.14.
Use it for
- Parse .feature files in a test runner to convert Gherkin scenarios into executable test cases.
- Build custom BDD tooling that consumes Gherkin specifications and generates test code or reports.
- Validate Gherkin syntax in feature files before passing them to Cucumber or similar frameworks.
- Extract and analyze test scenarios from feature files for documentation or coverage reporting.
- Integrate Gherkin parsing into CI/CD pipelines to compile feature files into intermediate representations.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
This is the official Gherkin parser maintained by the Cucumber team, actively developed, permissively licensed (MIT), and has minimal dependencies. Install it if you need to parse or compile Gherkin feature files programmatically or integrate BDD workflows into custom tooling. The only constraint is a Python 3.10+ requirement.
Install
gherkin-official on PyPI
Before you install
Low install friction with a single lightweight runtime dependency (typing-extensions). Active maintenance with a recent release (9 days old) and steady repository activity.
Requires Python 3.10 or later.
License in practice
MIT license permits unrestricted use, modification, and distribution in both open-source and proprietary projects.
Quickstart
from gherkin import Compiler, Parser
gherkin_document = Parser().parse("Feature: ...")
gherkin_document["uri"] = "uri_of_the_feature.feature"
pickles = Compiler().compile(gherkin_document)Verify before relying
- Whether the library API is stable across minor versions or subject to breaking changes
- Performance characteristics when parsing large feature files or many files in sequence
- Whether i18n support covers all languages needed for your test suite
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagetyping-extensions |
| Maintenance | Actively maintained 9 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 2,846,540 / month, #2,863 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Programming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: gherkin_official-42.0.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “gherkin parser”
- gherkin-officialParses and compiles Gherkin feature files into abstract syntax trees…
- cucumber-tag-expressionsParses and evaluates boolean tag expressions (using and, or, not…
- pytest-bddpytest-bdd implements Gherkin-based behavior-driven development…
Give your agent the search over MCP, or paste the wish link into any chat.
More Testing packages
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
pytest is a testing framework that lets you write test functions using plain assert statements and automatically discovers and runs them, with detailed failure reporting.
virtualenv creates isolated Python environments where packages can be installed independently without affecting the system Python or other projects.
Coverage.py measures which lines of Python code are executed during test runs, reporting coverage percentages and identifying untested code paths.
Install it if you want to measure test completeness or enforce coverage thresholds in your project.
pytest-asyncio is a pytest plugin that enables writing and running async test functions using the asyncio library, allowing developers to await code directly within test cases.
Install it if you write tests for any asyncio-based code.
A pytest plugin that generates test reports in Common Test Report Format (CTRF) as JSON, compatible with pytest-xdist and pytest-playwright for distributed and browser-based testing.
Install it if you need CTRF-formatted test output for CI/CD integration or cross-tool reporting.
See also cucumber-tag-expressions · reformat-gherkin · cucumber-expressions · pytest-bdd · radish-bdd · behave · behave-django · tree-sitter-java · tree-sitter-ruby · aws-lambda-builders