, file, **kwargs)[source]

Detect the format of a given file and suggest kwargs for reading.

State: Stable as of 0.4.0.


file : openable (filepath, URL, filehandle, etc.)

The file to sniff. Something that is understood by

kwargs : dict, optional

Keyword arguments will be passed to newline cannot be provided.


(str, dict)

The name of the format of the file and any suggested kwargs for use with the corresponding reader.



This occurs when the format is not ‘claimed’ by any registered sniffer or when the format is ambiguous and has been ‘claimed’ by more than one sniffer.


If newline is provided in kwargs.