Latest v.8.1.1 introduces `mypy` (typing) errors in user code

[lowvoltage]

Describe the bug
Upgrading to the latest v.8.1.1 causes mypy issues to be reported throughout the client code that imports and uses deepdiff. It seems those can't be suppressed globally, via config and need to be ignored one by one.

The minimalist main.py + mypy.ini setup below is based on the parse_path usage example from its docstring.

To Reproduce

❯ cat main.py
from deepdiff import parse_path
parse_path("root[1][2]['age']")

❯ cat mypy.ini
[mypy]
strict = True

[mypy-deepdiff.*]
ignore_missing_imports = True

❯ pip install deepdiff==8.0.1
...
Successfully installed deepdiff-8.0.1 orderly-set-5.2.2

❯ mypy main.py
Success: no issues found in 1 source file

❯ pip install deepdiff==8.1.1
...
Successfully installed deepdiff-8.1.1 orderly-set-5.2.3

❯ mypy main.py
main.py:1: error: Module "deepdiff" does not explicitly export attribute "parse_path"  [attr-defined]
main.py:2: error: Call to untyped function "parse_path" in typed context  [no-untyped-call]
Found 2 errors in 1 file (checked 1 source file)

Expected behavior
No new mypy errors are introduced

OS, DeepDiff version and Python version (please complete the following information):

• OS: macOS v.14.6; Ubuntu 24.04
• Python Version: 3.11.7
• DeepDiff Version: 8.1.1

Additional context
Seems to be caused by the presence of the py.typed marker ( #507 ) while the deepdiff codebase itself is not fully typed yet.

[johnthagen]

deepdiff does not explicitly export any of its top level exports, so this causes errors for Mypy in strict mode.

from deepdiff import DeepDiff

print(DeepDiff(1, 2))

# pyproject.toml
[tool.mypy]
strict = true

$ mypy main.py
main.py:1: error: Module "deepdiff" does not explicitly export attribute "DeepDiff"  [attr-defined]
Found 1 error in 1 file (checked 1 source file)

You can either add each exported item to __all__ or explicitly use as to indicate you intend to export it. Example:

• https://github.com/psycopg/psycopg/pull/44/files

Environment

Package           Version
----------------- -------
deepdiff          8.1.1
mypy              1.14.1
mypy-extensions   1.0.0
orderly-set       5.2.3
pip               24.0
typing_extensions 4.12.2

[seperman]

Hi @lowvoltage @johnthagen
Thanks for pointing out the issue. It is addressed on the dev branch.

[seperman]

DeepDiff 8.3.0 is released and this issue is resolved.