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.

Source Distribution

detect_delimiter-0.1.1.tar.gz (3.1 kB view hashes)

Uploaded Source

Built Distribution

detect_delimiter-0.1.1-py3-none-any.whl (3.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page