requests-unixsocket

import requests_unixsocket import os # Example for Docker daemon socket (adjust path if needed) docker_socket_path = '/var/run/docker.sock' # or os.environ.get('DOCKER_SOCKET', '/var/run/docker.sock') # Ensure the socket path exists for a runnable example # In a real scenario, Docker or another service would create this. # For this quickstart, we'll just check if it exists or use a dummy. if not os.path.exists(docker_socket_path): print(f"Warning: Docker socket not found at {docker_socket_path}. Quickstart might not connect.") # Fallback to a non-existent path for structure, but it will fail. docker_socket_path = '/tmp/nonexistent_socket.sock' # Explicit Session usage session = requests_unixsocket.Session() # The socket path must be percent-encoded in the URL host part encoded_socket_path = requests_unixsocket.requests.compat.quote_plus(docker_socket_path) url = f'http+unix://{encoded_socket_path}/info' try: response = session.get(url, timeout=5) response.raise_for_status() # Raise an exception for HTTP errors print("Explicit Session usage successful!") print(f"Status Code: {response.status_code}") print(f"JSON Response Keys: {list(response.json().keys())[:5]}...") except requests_unixsocket.requests.exceptions.ConnectionError as e: print(f"Connection Error: Could not connect to UNIX socket at {docker_socket_path}. Is a service listening there? (Error: {e})") except Exception as e: print(f"An unexpected error occurred: {e}") # --- Alternative: Monkeypatching (affects global requests behavior) --- # This is generally discouraged for libraries, but shown for completeness. # with requests_unixsocket.monkeypatch(): # try: # response_mp = requests_unixsocket.requests.get(url, timeout=5) # response_mp.raise_for_status() # print("\nMonkeypatching usage successful!") # print(f"Status Code: {response_mp.status_code}") # print(f"JSON Response Keys: {list(response_mp.json().keys())[:5]}...") # except requests_unixsocket.requests.exceptions.ConnectionError as e: # print(f"\nMonkeypatching Connection Error: Could not connect to UNIX socket at {docker_socket_path}. (Error: {e})") # except Exception as e: # print(f"\nAn unexpected error occurred with monkeypatching: {e}")