普贤教程 › 包参考

pop3 包

POP3 客户端（RFC 1939）

纯 .px 实现（TCP 控制通道），编译（px build）与解释（px run）双模式一致。

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

安装与引入

bash

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

import pop3

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

公开接口

函数	参数
`po_connect`	`host, port=110, opts={}`
`po_login`	`conn, user, password`
`po_stat`	`conn`
`po_list`	`conn`
`po_retr`	`conn, num`
`po_top`	`conn, num, lines`
`po_uidl`	`conn, num=null`
`po_dele`	`conn, num`
`po_rset`	`conn`
`po_noop`	`conn`
`po_capa`	`conn`
`po_quit`	`conn`

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

函数	参数
`po_recv_n`	`fd, n`
`po_read_line`	`fd`
`po_trim`	`s`
`po_reply`	`fd`
`po_read_dot`	`fd`
`po_send`	`fd, cmd`
`po_expect_ok`	`fd, cmd`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/pop3 —— POP3 客户端（RFC 1939）
------------------------------------------------------------
纯 .px 实现（TCP 控制通道），编译（px build）与解释（px run）双模式一致。
对齐 Go go-imap（pop3）、Python poplib 心智：
po_connect(host[, port=110][, opts]) → Ok(conn) | Err   读 "+OK" 问候
po_login(conn, user, password)       → Ok(conn) | Err
po_stat(conn)                        → Ok({count, size})
po_list(conn)                        → Ok([{num, size}])
po_retr(conn, num)                   → Ok(str)（多行直到 "."，点填充还原）
po_top(conn, num, lines)             → Ok(str)（TOP n lines，头+指定行数）
po_uidl(conn[, num])                 → Ok(str) | Ok([{num, uidl}])
po_dele(conn, num)                   → Ok(true)（标记删除）
po_rset(conn)                        → Ok(true)（撤销所有删除标记）
po_noop(conn)                        → Ok(true)（保活）
po_capa(conn)                        → Ok([str])（能力列表）
po_quit(conn)                        → Ok(true)
单行回复 ±OK/-ERR；多行以 "." 结束；点填充还原（前导 ".." → "."）。
============================================================