From 968e1b4e4a6fbd5a15037cdb11a3f9dee5108570 Mon Sep 17 00:00:00 2001 From: Dennis Fink Date: Sat, 14 Nov 2026 18:44:23 +0100 Subject: docs(core): standardize reST docstrings Expand function and method documentation with consistent reST parameter, return, and exception fields while clarifying behavior where additional context is useful. Normalize test and migration docstrings to the same documentation conventions. --- tests/test_net.py | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) (limited to 'tests/test_net.py') diff --git a/tests/test_net.py b/tests/test_net.py index 4ac138d..b778310 100644 --- a/tests/test_net.py +++ b/tests/test_net.py @@ -42,7 +42,10 @@ def test_backend_rejects_private_ip_without_socket( def test_rebinding_cannot_change_socket_peer(monkeypatch: pytest.MonkeyPatch) -> None: - """The address is resolved exactly once and the socket sees only that IP.""" + """Verify that DNS rebinding cannot change the connected socket peer. + + :param monkeypatch: Pytest fixture for replacing the DNS resolver and socket calls. + """ dns = Mock(return_value=("93.184.216.34",)) monkeypatch.setattr("webmentions_ssg.net.public_addresses", dns) socket_instance = Mock() -- cgit v1.3.1