Re-try in more cases when socket cannot first be created

[dhalbert]

Recover in more cases when a socket cannot be created. This problem is particularly acute on ESP32-S2 on CircuitPython 9.x.x. Use a 9.1.0 build past beta.1 if you would like user-specifiable timeouts. Testing welcome by anyone.

This appears to fix adafruit/circuitpython#9219.

Also:

• Clarify some documentation. Use sphinx argument documentation style.
• Fix some typos.
• Remove a few internal comments marking code sections.
• Clarify an error message.
• Internally, catch exceptions instead of passing them back.
• Change one exception.
• Update to pylint 3.1.0 so pre-commit can run under Python 3.12.

Test program:

import gc
import os
import wifi
import socketpool
import ssl


import adafruit_connection_manager
import adafruit_requests

# Get WiFi details, ensure these are setup in settings.toml
ssid = os.getenv("CIRCUITPY_WIFI_SSID")
password = os.getenv("CIRCUITPY_WIFI_PASSWORD")

# Without ConnectionManager
# pool = socketpool.SocketPool(wifi.radio)
# ssl_context = adafruit_connection_manager.get_radio_ssl_context(wifi.radio)

pool = adafruit_connection_manager.get_radio_socketpool(wifi.radio)
ssl_context = ssl.create_default_context()

requests = adafruit_requests.Session(pool, ssl_context)

wifi.radio.connect(ssid, password)

for url in (
    # bunch of failures: failures vs working doesn't really matter
    "https://192.168.1.253",
    "https://192.168.1.252",
    "https://192.168.1.251",
    "https://192.168.1.250",
    "https://192.168.1.249",
    "https://192.168.1.248",
    "https://192.168.1.247",
    "https://192.168.1.246",
    "https://192.168.1.245",
    # various working sites
    "https://example.org",
    "https://example.net",
    "https://example.com",
):
    print(url)
    try:
        response = requests.get(url, timeout=2)
        #print(response.text)
    except Exception as e:
        print(type(e), e)

[justmobilize]

@dhalbert tested and looks good. Quick comments:

1. Added a question on tests
2. I assume this will be a major release as the exceptions returned are different
3. Created PRs for requests and minimqtt as these changes will break tests

[dhalbert]

I assume this will be a major release as the exceptions returned are different

Yes, I will do that, though since it was error returns on bad args, I don't think it will affect much code.