SyntaxWarnings when running a snippet from the README.md

[dilawar]

I ran the following snippet https://github.com/dilawar/joss-review-7618-ratesb-python/blob/674ad72e64fd11505a8809d45a7b0b412b748b83/review_ratesb_python/sanity_checks.py

I got the following warnings. I am on Windows + Python 3.12

uv run -s sanity_checks.py
C:\tools\msys64\home\dilaw\Work\GITHUB\joss-review-7618-ratesb-python\review_ratesb_python\.venv\Lib\site-packages\SBMLKinetics\kinetics_output.py:453: SyntaxWarning: invalid escape sequence '\p'
  """
C:\tools\msys64\home\dilaw\Work\GITHUB\joss-review-7618-ratesb-python\review_ratesb_python\.venv\Lib\site-packages\SBMLKinetics\kinetics_output.py:483: SyntaxWarning: invalid escape sequence '\p'
  """
C:\tools\msys64\home\dilaw\Work\GITHUB\joss-review-7618-ratesb-python\review_ratesb_python\.venv\Lib\site-packages\SBMLKinetics\kinetics_output.py:553: SyntaxWarning: invalid escape sequence '\p'
  """
C:\tools\msys64\home\dilaw\Work\GITHUB\joss-review-7618-ratesb-python\review_ratesb_python\.venv\Lib\site-packages\SBMLKinetics\kinetics_output.py:613: SyntaxWarning: invalid escape sequence '\p'
  """
C:\tools\msys64\home\dilaw\Work\GITHUB\joss-review-7618-ratesb-python\review_ratesb_python\.venv\Lib\site-packages\SBMLKinetics\kinetics_output.py:647: SyntaxWarning: invalid escape sequence '\p'
  """
C:\tools\msys64\home\dilaw\Work\GITHUB\joss-review-7618-ratesb-python\review_ratesb_python\.venv\Lib\site-packages\SBMLKinetics\kinetics_output.py:680: SyntaxWarning: invalid escape sequence '\p'
  """
C:\tools\msys64\home\dilaw\Work\GITHUB\joss-review-7618-ratesb-python\review_ratesb_python\.venv\Lib\site-packages\SBMLKinetics\kinetics_output.py:702: SyntaxWarning: invalid escape sequence '\p'
  """
C:\tools\msys64\home\dilaw\Work\GITHUB\joss-review-7618-ratesb-python\review_ratesb_python\.venv\Lib\site-packages\SBMLKinetics\kinetics_output.py:731: SyntaxWarning: invalid escape sequence '\p'
  """
C:\tools\msys64\home\dilaw\Work\GITHUB\joss-review-7618-ratesb-python\review_ratesb_python\.venv\Lib\site-packages\SBMLKinetics\kinetics_output.py:753: SyntaxWarning: invalid escape sequence '\p'
  """
_J0:
  Warning 1004: Flux is not decreasing as product increases.

If these SyntaxWarning can not be fixed for some reason then it should be mentioned in docs.

[dilawar]

A minor nitpick, feel free to ignore:

The last warning -- _J0: Warning 1004: Flux is not decreasing as product increases. can be confusing to user who didn't read the docs properly. Perhaps you can add a Learn more which links to official docs if any warning is emitted by the program?

[RMeli]

JOSS review: openjournals/joss-reviews#7618

[longxf21]

A minor nitpick, feel free to ignore:

The last warning -- _J0: Warning 1004: Flux is not decreasing as product increases. can be confusing to user who didn't read the docs properly. Perhaps you can add a Learn more which links to official docs if any warning is emitted by the program?

@llaDeXiaoHao

[longxf21]

Thank you for raising this issue! Python 3.12 introduces some warnings with string, and the warnings arise from unescaped backslashes (\p) in triple-quoted docstrings, which Python interprets as invalid escape sequences. For now we have suppressed the issue and made a release in pypi.