Skip to content

gh-148770: Document quoting requirement for IMAP mailbox names with spaces #148785

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

Closed
CodeLine9 wants to merge 2 commits into from
Closed

gh-148770: Document quoting requirement for IMAP mailbox names with spaces #148785

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
60b03d2
gh-148770: Document quoting requirement for IMAP mailbox names with s…
CodeLine9 Apr 19, 2026
32d0925
Merge branch 'main' into clawoss/docs/148770-imaplib-select-quoting
CodeLine9 May 11, 2026
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
Next Next commit
gh-148770: Document quoting requirement for IMAP mailbox names with s… 
…paces

Add a note to IMAP4.select() documenting that mailbox names containing
spaces must be quoted by the caller, e.g. M.select('"my important mail"').
  • Loading branch information
@CodeLine9
CodeLine9 committed Apr 19, 2026
commit 60b03d2fcde8936303d5212c288f7e367db19549
6 changes: 6 additions & 0 deletions Doc/library/imaplib.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -519,6 +519,12 @@ An :class:`IMAP4` instance has the following methods:
(``EXISTS`` response). The default *mailbox* is ``'INBOX'``. If the *readonly*
flag is set, modifications to the mailbox are not allowed.

.. note::

Mailbox names containing spaces must be quoted by the caller.
For example, to select a mailbox named ``my important mail``, use
``M.select('"my important mail"')``.


.. method:: IMAP4.send(data)

Expand Down
Loading