Expose Python API as package imports

[kieran-ryan]

🤔 What's changed?

• Exposed Python API as package imports

- from gherkin.parser import Parser
- from gherkin.pickles.compiler import Compiler
+ from gherkin import Compiler, Parser

• Dropped count_symbols_test.py unit test module

⚡️ What's your motivation?

• Simplifies API and package usage - such as IDE completions for the public API
• Aligns with the JavaScript API
• count_symbols_test.py module tested Python compatibility code; which has been removed (Drop python 2 compatibility #282)

🏷️ What kind of change is this?

• ⚡ New feature (non-breaking change which adds new behaviour)

♻️ Anything particular you want feedback on?

• Whether anything should additionally be exposed; or indeed reverted

📋 Checklist:

• I agree to respect and uphold the Cucumber Community Code of Conduct
• Users should know about my change
  • I have added an entry to the "Unreleased" section of the CHANGELOG, linking to this pull request.

[kieran-ryan]

Thank for review @youtux - and similarly @jsa34 (saw you left and dropped comment) - appreciate it both!

[jsa34]

I dropped it because I thought I was being too picky ( apologies! 🫣)

[kieran-ryan]

I dropped it because I thought I was being too picky ( apologies! 🫣)

I actually would have made same comment @jsa34! 😄 Appreciate raising! Is interesting. The way I would have formatted __all__ was as you described - alphabetically; though with ruff's automatic fix for sorting __all__ - RUF022 (unsorted-dunder-all) - it performs a natural sort, respecting case first before alphabetic ordering. Something we can format and validate - which is cool; though perhaps not the 'go to' style for many.

__all__ = [
    "a_variable",
    "CapWords",
    "UPPER_CASE",
]

ruff check --select=RUF022 module.py --fix

__all__ = [
    "UPPER_CASE",
    "CapWords",
    "a_variable",
]

[jsa34]

Ah! Never knew - every day's a school day! Thanks for the detailed reply!