SyntaxWarning: invalid escape sequence in _models.py when running Azure CLI on macOS

[RevenantBob]

Describe the bug

When running the azure-cli on macOS (Homebrew install), Python shows SyntaxWarning messages about invalid escape sequences in docstrings within the azure.batch.models._models.py file.

Related command

az login

Errors

/opt/homebrew/Cellar/azure-cli/2.75.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.75.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

Issue script & Debug output

Not sure this step is necessary for a syntax error telling the line number.

/opt/homebrew/Cellar/azure-cli/2.75.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.75.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
Expected behavior
No SyntaxWarning should appear. Backslashes in docstrings should be escaped (\\) or the string should be marked as a raw string (r'...').

Expected behavior

No SyntaxWarning should appear. Backslashes in docstrings should be escaped (\) or the string should be marked as a raw string (r'...').

Environment Summary

macOS Sequoia 15.5 (24F74)
Python 3.12
Azure CLI installed via Homebrew (azure-cli/2.75.0)

Additional context

This is a docstring only — so there’s no runtime breakage. It just clutters the output with warnings.

[yonzhan]

Thank you for opening this issue, we will look into it.

[github-actions]

Here are some similar issues that might help you. Please check if they can solve your problem.

• Syntax error #31530
• SyntaxWarning: invalid escape sequence '\ ' warning in azure SDK #30440

---

Possible solution (Extracted from existing issue, might be incorrect; please verify carefully)

Solution 1:

Downgrading Python to version 3.10 fixed the issue for me.

Reference:

• SyntaxWarning: invalid escape sequence '\ ' warning in azure SDK #30440 (comment)

Solution 2:

brew reinstall python fixed it for me.

Reference:

• SyntaxWarning: invalid escape sequence '\ ' warning in azure SDK #30440 (comment)

Solution 3:

In my case, python@3.12 was the problem. python@3.13.3 fixes the problem. Thank you for the tip!

Reference:

• SyntaxWarning: invalid escape sequence '\ ' warning in azure SDK #30440 (comment)

Powered by issue-sentinel

[jiasli]

azure-batch no longer contains the invalid escape sequence '\ ':

https://github.com/Azure/azure-sdk-for-python/blob/5b185b229b07baf06b55e4885890ec5cd209cefa/sdk/batch/azure-batch/azure/batch/models/_models.py#L10044

It was fixed by Azure/azure-sdk-for-python#40222.

Azure CLI needs to adopt the latest azure-batch 14.2.0:

azure-cli/src/azure-cli/requirements.py3.Linux.txt

Line 6 in 89da35f

azure-batch==15.0.0b1