Skip to main content

Detects the delimiter used in CSV, TSV and other ad hoc file formats.

Project description



Detects the delimiter used in CSV, TSV and other ad hoc file formats.


Use pip install detect_delimiter


detect_delimiter exposes the detect() functinon, which takes a str as input and returns a delimiter.

>>> from detect_delimiter import detect
>>> detect("looks|like|the vertical bar\n is|the|delimiter\n")

When detect() doesn't know, it returns None:

>>> text = "not really any delimiters in here.\nthis is just text.\n"
>>> detect()

It's possible to provide a default, which will be used in that case:

>>> detect(text, default=',')

By default, detect() will prevent avoid checking alpha-numeric characters and the period/full stop character ("."). This can be adjusted via the blacklist parameter.

If you believe that you know the delimiter, it's possible to provide a list of possible delimiters to check for via the whitelist parameter. If you don't provide a value, [',', ';', ':', '|', '\t'] will be checked.


You can either use pytest or tox directly from the project's root directory.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for detect-delimiter, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size detect_delimiter-0.1.1-py3-none-any.whl (3.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size detect_delimiter-0.1.1.tar.gz (3.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page