[python-dateutil] dateutil.parser.parse(fuzzy_with_tokens=True) returns a tuple

[ellieayla]

@overload the parse function at module and class level, separate return type for fuzzy_with_tokens: Literal[True] and Literal[False].

Note, not entirely sure this syntax is perfect. mypy is happy locally, but that doesn't check against the upstream library behaviour. Could use a second pair of eyes.

Closes issue #15473

ref:

https://github.com/dateutil/dateutil/blob/e081f6725fbb49cae6eedab7010f517e8490859b/src/dateutil/parser/_parser.py#L702

https://github.com/dateutil/dateutil/blob/e081f6725fbb49cae6eedab7010f517e8490859b/src/dateutil/parser/_parser.py#L871

[ellieayla]

uv run mypy stubs/python-dateutil/dateutil
Success: no issues found in 17 source files

uv run mypy --strict stubs/python-dateutil/dateutil
stubs/python-dateutil/dateutil/tz/_common.pyi:15: error: Function is missing a return type annotation  [no-untyped-def]
stubs/python-dateutil/dateutil/parser/_parser.pyi:156: error: Function is missing a return type annotation  [no-untyped-def]  # __init__
stubs/python-dateutil/dateutil/parser/_parser.pyi:156: note: Use "-> None" if function does not return a value
stubs/python-dateutil/dateutil/rrule.pyi:65: error: Function is missing a return type annotation  [no-untyped-def]
stubs/python-dateutil/dateutil/rrule.pyi:66: error: Function is missing a return type annotation  [no-untyped-def]

The untyped definiton in stubs/python-dateutil/dateutil/parser/_parser.pyi:156 is just an __init__ that could be typed None. The other 3 function definitions missing return types are more complex, and I haven't tried to type them.

• _common.pyi:15: enfold - https://dateutil.readthedocs.io/en/stable/tz.html#dateutil.tz.enfold
• rrule.pyi:65-66: after/before - https://dateutil.readthedocs.io/en/stable/rrule.html#dateutil.rrule.rrule.after

cc @lev-blit @donbarbos

[donbarbos]

Thank you! Only one comment

[github-actions]

According to mypy_primer, this change has no effect on the checked open source code. 🤖🎉

[donbarbos]

Thanks! LGTM