fix(core): Typing in docker_client

[Tranquility2]

Supports: #305
Related : #691#692#700

Based on #504, kudos @alexanderankin

poetry run mypy --config-file pyproject.toml core/testcontainers/core/docker_client.py Success: no issues found in 1 source file

Old

 Error Summary ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━┓
┃ File Path ┃ Errors ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━┩
│ core/testcontainers/core/version.py │ 12 │
│ core/testcontainers/core/docker_client.py │ 14 │
│ core/testcontainers/core/image.py │ 17 │
│ core/testcontainers/core/waiting_utils.py │ 8 │
│ core/testcontainers/core/container.py │ 20 │
│ core/tests/test_new_docker_api.py │ 4 │
│ core/tests/test_docker_in_docker.py │ 2 │
│ core/testcontainers/compose/compose.py │ 22 │
│ core/testcontainers/compose/__init__.py │ 2 │
│ core/tests/test_version.py │ 2 │
│ core/tests/test_ryuk.py │ 2 │
│ core/tests/test_registry.py │ 1 │
│ core/tests/test_image.py │ 3 │
│ core/tests/test_compose.py │ 7 │
└───────────────────────────────────────────┴────────┘
Found 116 errors in 14 files.

New

 Error Summary ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━┓
┃ File Path ┃ Errors ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━┩
│ core/testcontainers/core/version.py │ 12 │
│ core/testcontainers/core/network.py │ 3 │
│ core/testcontainers/core/image.py │ 17 │
│ core/testcontainers/core/waiting_utils.py │ 8 │
│ core/testcontainers/core/container.py │ 19 │
│ core/tests/test_new_docker_api.py │ 4 │
│ core/tests/test_docker_in_docker.py │ 2 │
│ core/testcontainers/compose/compose.py │ 22 │
│ core/testcontainers/compose/__init__.py │ 2 │
│ core/tests/test_version.py │ 2 │
│ core/tests/test_ryuk.py │ 2 │
│ core/tests/test_registry.py │ 1 │
│ core/tests/test_image.py │ 3 │
│ core/tests/test_compose.py │ 7 │
└───────────────────────────────────────────┴────────┘
Found 104 errors in 14 files.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Please upload report for BASE (main@e9e40f9). Learn more about missing BASE report.

Additional details and impacted files

@@ Coverage Diff @@## main #702 +/- ##
=======================================
Coverage ? 84.97% =======================================
Files ? 12 Lines ? 679 Branches ? 106 =======================================
Hits ? 577 Misses ? 79 Partials ? 23 

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Tranquility2]

Please note:

core/testcontainers/core/config.py:46: error: X|YsyntaxforunionsrequiresPython3.10 [syntax]
connection_mode: str|None=environ.get("TESTCONTAINERS_CONNECTION_MODE")

Found when rebasing and updated to support 3.9 (I'm not aware of deprecating 3.9 in tc-python, feel free to update)

[Tranquility2]

@alexanderankin@kiview can you please rerun this? (I assume this was an issue with the docker registry)

[CarliJoy]

Please use cast only when required (i.e. for dict[str, Any]).

If possible always improve the runtime type safety.

[CarliJoy]

Suggested change

	ifcast(str, self)==self.bridge_ip:
	ifself==self.bridge_ip:

That is neither required nor correct.

The original code does not issue any Typing Errors:
Not in mypy nor pyright

[Tranquility2]

@CarliJoy Mypy seems to disagree:

[Tranquility2]

Update to latest mypy, still the same behavior
mypy 1.15.0 (compiled: yes)

[Tranquility2]

Found the issue :)
under "[tool.mypy]" on pyproject.toml
we have strict = true

I'll be adding # type: ignore[comparison-overlap] in the relevant locations (future PRs) @CarliJoy

[Tranquility2]

Fixed

[CarliJoy]

if self == ConnectionMode.bridge_ip:

Seems to be the type correct solution.

[Tranquility2]

Will fix after #807 as it also touch this part :)

[Tranquility2]

@CarliJoy apricate you taking the time to comment :) I'll be happy to fix and update as suggested.
I assume/hope #700 & #701 will go in first so I'll know we are really rolling with this track.

[Tranquility2]

@CarliJoy Updated with all of the Fixes