Skip to main content
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 retries a failed request up to 5 times, with exponential backoff, when the server returns HTTP 429, 500, 502, 503, or 504.
The SDK logs through the standard logging module under the fiddler_evals logger and adds no handlers of its own; configure logging in your application to see its messages.