Docstrings are not raw strings

[aiven-amartin]

Before filling a bug

• have you checked the faq for known issues.
• have you checked existing issues

Describe the bug

The python azure sdk uses this module to generate its models. These models all raise SyntaxWarnings b/c the generated docstrings have invalid escape charaters. Instead of having the user of this library manually edit their api docs to be python escape compliant, the generated methods and classes should all generate raw-strings instead of escape strings. (i.e. it should be r"""... instead of just """...)

Expected behavior
All docstrings should be raw-strings since the content likely includes escape characters we do not intend to escape.

Additional context
Python will soon upgrade these to errors from warnings, so this needs to be fixed soon.

A backslash-character pair that is not a valid escape sequence now generates a SyntaxWarning, instead of DeprecationWarning. For example, re.compile("\d+.\d+") now emits a SyntaxWarning ("\d" is an invalid escape sequence, use raw strings for regular expression: re.compile(r"\d+.\d+")). In a future Python version, SyntaxError will eventually be raised, instead of SyntaxWarning.

[luckman212]

Hitting these errors using az (azure-cli) 2.72.0 on macOS:

~ $ az
/opt/homebrew/Cellar/azure-cli/2.72.0/libexec/lib/python3.12/site-packages/azure/batch/models/_models.py:9067: SyntaxWarning: invalid escape sequence '\ '
  """The source port ranges to match for the rule. Valid values are '\ *' (for all ports 0 - 65535),
/opt/homebrew/Cellar/azure-cli/2.72.0/libexec/lib/python3.12/site-packages/azure/batch/models/_models.py:9235: SyntaxWarning: invalid escape sequence '\ '
  using brackets (for example abc[\ *] would match a file named abc*\ ). Note that both and / are

     /\
    /  \    _____   _ _  ___ _
   / /\ \  |_  / | | | \'__/ _\
  / ____ \  / /| |_| | | |  __/
 /_/    \_\/___|\__,_|_|  \___|


Welcome to the cool new Azure CLI!