Expose Python API as package imports (#352)

* feat: Expose public API as package imports
    - Update usage documentation
* debt: Drop redundant test module for removed Python 2 support
    - Python 2 compatibility character count code has been removed

CHANGELOG.md

@@ -9,6 +9,7 @@ This document is formatted according to the principles of [Keep A CHANGELOG](htt
 ## [Unreleased]
 ### Added
 - [.NET] Enabled overriding of parser's error-handling
+- [Python] Expose Python public API as package imports ([#352](https://github.com/cucumber/gherkin/pull/352))
 
 ### Fixed
 - [c] slight update to existing CMakeFiles.txt to propagate VERSION. Close #320 ([#328](https://github.com/cucumber/gherkin/pull/328))

README.md

@@ -133,11 +133,9 @@ func main() {
 #### Python
 
 ```python
-from gherkin.parser import Parser
-from gherkin.pickles.compiler import Compiler
+from gherkin import Compiler, Parser
 
-parser = Parser()
-gherkin_document = parser.parse("Feature: ...")
+gherkin_document = Parser().parse("Feature: ...")
 gherkin_document["uri"] = "uri_of_the_feature.feature"
 pickles = Compiler().compile(gherkin_document)
 ```

python/gherkin/__init__.py

@@ -0,0 +1,11 @@
+"""gherkin-official public API."""
+
+from __future__ import annotations
+
+from .parser import Parser
+from .pickles.compiler import Compiler
+
+__all__ = [
+    "Compiler",
+    "Parser",
+]