Translate American to British Spelling

Example

>>> import sys
>>> from io import StringIO
>>> from techminer2.thesaurus.user import CreateThesaurus, AmericanToBritishSpelling

>>> # 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, an run the translator
>>> translaator = (
...     AmericanToBritishSpelling(tqdm_disable=True)
...     .with_thesaurus_file("demo.the.txt")
...     .where_root_directory_is("example/")
... )
>>> translaator.run()

>>> # Capture and print stderr output to test the code using doctest
>>> output = sys.stderr.getvalue()
>>> sys.stderr = original_stderr
>>> print(output) 
Converting American to British English
  File : example/thesaurus/demo.the.txt
  23 replacements made successfully
Translation completed successfully

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

    A_COMPLETE_GENERALISATION
      A_COMPLETE_GENERALIZATION
    AN_ORGANISATION
      AN_ORGANIZATION
    BEHAVIOURAL_BIASES
      BEHAVIORAL_BIASES
    CATEGORISES_RESEARCH
      CATEGORIZES_RESEARCH
    CHARACTERISE_FINTECH
      CHARACTERIZE_FINTECH
    DECENTRALISED_FINTECH_MARKETS
      DECENTRALIZED_FINTECH_MARKETS
    DIGITISED_AGRICULTURE
      DIGITIZED_AGRICULTURE
    EXCESSIVELY_RISKY_BEHAVIOUR
      EXCESSIVELY_RISKY_BEHAVIOR