Skip to content

IMAPlib Lib/imaplib.py folders with spaces in their names #148770

Description

@mikebatgithub

Documentation

https://docs.python.org/3/library/imaplib.html
Using the select function : The documentation could be updated to read :
"If the mailbox (or folder) name includes a space (E.G. my important mail) then use
select('"my important mail"')

Linked PRs

Activity

  1. added a commit that references this issue on Apr 19, 2026
  2. vadmium commented on Apr 20, 2026

    @vadmium
    Member

    I think this may not be limited to the select method. Perhaps it is better to expand the paragraph about quoting arguments under https://docs.python.org/3/library/imaplib.html#imap4-objects? That also needs updating since the automatic quoting mechanism it describes was removed in the Python 3 transition (Issue #92835).

    Issue #68215 is also open about documenting IMAP parameter and return values in general.

  3. serhiy-storchaka commented on Jul 5, 2026

    @serhiy-storchaka
    Member

    imaplib now quotes mailbox names automatically since GH-152703, so the manual-quoting workaround no longer needs documenting. The paragraph about argument quoting in the docs was updated as part of that change.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions