普贤教程 › 包参考

imap 包

IMAP4rev1 客户端

编译（px build）与解释（px run）双模式一致。

项	值
包名	`imap`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`imap.px`
分类	`网络与协议`
文件数 / 行数	`1 / 243`

安装与引入

bash

pxpkg init          # 首次
pxpkg add imap@0.2.0
pxpkg install

import imap

所属分类教程：网络与协议

公开接口

函数	参数
`imap_connect`	`host, port, timeout_ms`
`imap_login`	`conn, user, pass`
`imap_list`	`conn`
`imap_select`	`conn, mailbox`
`imap_examine`	`conn, mailbox`
`imap_fetch`	`conn, seq, items`
`imap_search`	`conn, criteria`
`imap_create`	`conn, mailbox`
`imap_delete`	`conn, mailbox`
`imap_rename`	`conn, old, new`
`imap_copy`	`conn, seq, mailbox`
`imap_store`	`conn, seq, flags`
`imap_close`	`conn`
`imap_noop`	`conn`
`imap_logout`	`conn`

其余 6 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`o_rd_u8b`	`b, off`
`o_read_line`	`fd`
`o_send_line`	`conn, line`
`o_tag`
`o_cmd`	`conn, line`
`o_literal_len`	`line`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/imap —— IMAP4rev1 客户端
------------------------------------------------------------
编译（px build）与解释（px run）双模式一致。
对照 Go go-imap / Python imaplib 心智：
imap_connect(host, port[, timeout_ms]) → Ok(conn) | Err
imap_login(conn, user, pass)           → Ok(true) | Err
imap_list(conn)                        → Ok([mailbox...])
imap_select(conn, mailbox)             → Ok({exists, recent})
imap_examine(conn, mailbox)            → Ok({exists, recent})（只读）
imap_fetch(conn, seq, items)           → Ok([body...])
imap_search(conn, criteria)            → Ok([seq...])
imap_create(conn, mailbox)             → Ok(true)
imap_delete(conn, mailbox)             → Ok(true)
imap_rename(conn, old, new)            → Ok(true)
imap_copy(conn, seq, mailbox)          → Ok(true)
imap_store(conn, seq, flags)           → Ok(true)（设置标记如 +FLAGS (\Seen)）
imap_close(conn)                       → Ok(null)（expunge + deselect）
imap_noop(conn)                        → Ok(true)
imap_logout(conn)                      → Ok(null)
协议：tag = "A<序号>"，行尾 CRLF；响应逐行读，FETCH literal {N} 读 N 字节；
终止行 tag OK/NO/BAD 判定成败。
============================================================