Skip to main content
Initialize the Fiddler client with connection parameters and global configuration. This function establishes a connection to the Fiddler platform and configures the global client state. It handles authentication, server compatibility validation, logging setup, and creates the singleton connection instance used throughout the client library.

​
Parameters

​
str
required
The base URL to your Fiddler platform instance
​
str
required
Authentication token obtained from the Fiddler UI Credentials tab
​
dict | None
default:"None"
Dictionary mapping protocol to proxy URL for HTTP requests
​
float | tuple[float, float] | None
default:"None"
HTTP request timeout settings (float or tuple of connect/read timeouts)
​
bool
default:"True"
Whether to verify server’s TLS certificate (default: True)
​
bool
default:"True"
Whether to validate server/client version compatibility (default: True)

​
Raises

  • ValueError – If url or token parameters are empty
  • IncompatibleClient – If server version is incompatible with client version
  • ConnectionError – If unable to connect to the Fiddler platform

​
Examples

Basic initialization:
Initialization with custom timeout and proxy:
Initialization for development with relaxed settings:
The client implements automatic retry strategies for transient failures. Configure retry duration via FIDDLER_CLIENT_RETRY_MAX_DURATION_SECONDS environment variable (default: 300 seconds).
Logging is performed under the ‘fiddler’ namespace at INFO level. If no root logger is configured, a stderr handler is automatically attached unless auto_attach_log_handler=False.