Skip to content

gh-80678: Add comment on preferred csv delimiters #96199

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
slateny wants to merge 2 commits into
base: main
Choose a base branch
from
Open

gh-80678: Add comment on preferred csv delimiters #96199

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
68a74d0
Add comment on preferred delimiters
slateny Aug 23, 2022
fbe8d54
Correct tense
slateny Oct 23, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions Doc/library/csv.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -275,6 +275,8 @@ The :mod:`csv` module defines the following classes:
reflecting the parameters found. If the optional *delimiters* parameter
is given, it is interpreted as a string containing possible valid
delimiter characters.
If not excluded by the *delimiters* parameter, and if there is ambiguity,

@eendebakpt eendebakpt Oct 22, 2022

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why is the documentation here not added to the def sniff docstring? That would be a natural place for documentation that is available from the command line or IDE.

@slateny slateny Oct 23, 2022

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure what information should go into the docstring vs in the docs. I imagine there's some duplicate, but surely not everything in the docs goes into the docstring and vice-versa. The docstring of sniff is looking a bit empty though, so it could use some work for sure.

then delimiter choice will be biased towards ``[',', '\t', ';', ' ', ':']``.

@StanFromIreland StanFromIreland Jun 12, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a little inaccurate, it is in that specific order. Maybe something like ",, ... : in that order"



.. method:: has_header(sample)
Expand Down