Add a test of stdlib availability during .pth handling.

Author: freakboy3742

pth-tester/pth_tester.py

@@ -1,8 +1,21 @@
 initialized = False
+has_socket = False
 
 
 # The pth_tester module should be initalized by processing the `.pth` file
 # created on installation.
 def init():
     global initialized
+    global has_socket
+
     initialized = True
+
+    # At the time that the module is initialized, it *should* have access
+    # to all of the standard library. This might not be true, depending on
+    # the initialization order of the site module and sys.path.
+    try:
+        import socket  # NOQA: F401
+
+        has_socket = True
+    except ImportError:
+        pass

pth-tester/pyproject.toml

@@ -4,5 +4,5 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "x-pth-tester"
-version = "1.0.0"
+version = "2025.3.26"
 classifiers = ["Private :: Do Not Upload"]

tests/test_common.py

@@ -453,3 +453,20 @@ def test_pth_handling():
     # The pth_tester module should be "initialized" as a result of
     # processing the .pth file created when the package is installed.
     assert pth_tester.initialized
+
+    # When the .pth file is processed, the full standard library should be
+    # available. Check if the initialization process could import socket.
+    if sys.platform == "android" or hasattr(sys, "getandroidapilevel"):
+        # Android is known to have an issue with .pth/sys.path ordering that
+        # causes this test to fail. For now, accept this as an XFAIL; if it
+        # passes, fail as an indicator that the bug has been resolved, and we
+        # can simplify the test.
+        try:
+            assert pth_tester.has_socket
+            pytest.fail("Android .pth handling bug has been resolved.")
+        except AssertionError:
+            pytest.xfail(
+                "On Android, .pth files are processed before sys.path is finalized."
+            )
+    else:
+        assert pth_tester.has_socket