Sort By Ends With Key Match

Example

>>> # TEST PREPARATION
>>> import sys
>>> from io import StringIO
>>> from techminer2.thesaurus.user import CreateThesaurus, SortByEndsWithKeyMatch

>>> # Redirecting stderr to avoid messages during doctests
>>> original_stderr = sys.stderr
>>> sys.stderr = StringIO()

>>> # Reset the thesaurus to initial state
>>> CreateThesaurus(thesaurus_file="demo.the.txt", field="raw_descriptors",
...     root_directory="example/", quiet=True).run()

>>> # Creates, configures, and runs the sorter
>>> sorter = (
...     SortByEndsWithKeyMatch()
...     .with_thesaurus_file("demo.the.txt")
...     .having_pattern("BUSINESS")
...     .where_root_directory_is("example/")
... )
>>> sorter.run()

>>> # Capture and print stderr output to test the code using doctest
>>> output = sys.stderr.getvalue()
>>> sys.stderr = original_stderr
>>> print(output)
Sorting thesaurus file by key match
     File : example/thesaurus/demo.the.txt
  Pattern : BUSINESS
  3 matching keys found
  Thesaurus sorting by key match completed successfully

Printing thesaurus header
  File : example/thesaurus/demo.the.txt

    AGRIBUSINESS
      AGRIBUSINESS
    BUSINESS
      BUSINESS; BUSINESSES
    THE_BANKING_BUSINESS
      THE_BANKING_BUSINESS
    A_A_)_THEORY
      A_A_)_THEORY
    A_A_THEORY
      A_A_THEORY
    A_BASIC_RANDOM_SAMPLING_STRATEGY
      A_BASIC_RANDOM_SAMPLING_STRATEGY
    A_BEHAVIOURAL_PERSPECTIVE
      A_BEHAVIOURAL_PERSPECTIVE
    A_BETTER_UNDERSTANDING
      A_BETTER_UNDERSTANDING