互联网协议和支持¶

本章中描述的模块实现了互联网协议以及对相关技术的支持。它们全部用 Python 实现。这些模块中的大多数都需要系统相关的模块 socket 的存在，目前大多数流行的平台上都支持该模块。这里是一个概述

webbrowser — 方便的网络浏览器控制器
- 错误
- open()
- open_new()
- open_new_tab()
- get()
- register()
- 浏览器控制器对象
wsgiref — WSGI 实用工具和参考实现
- wsgiref.util – WSGI 环境实用工具
- wsgiref.headers – WSGI 响应头工具
  - Headers
    - get_all()
    - add_header()
- wsgiref.simple_server – 一个简单的 WSGI HTTP 服务器
- wsgiref.validate — WSGI 一致性检查器
  - validator()
- wsgiref.handlers – 服务器/网关基类
- wsgiref.types – 用于静态类型检查的 WSGI 类型
- 示例
urllib — URL 处理模块
urllib.request — 用于打开 URL 的可扩展库
- urlopen()
- install_opener()
- build_opener()
- pathname2url()
- url2pathname()
- getproxies()
- Request
- OpenerDirector
- BaseHandler
- HTTPDefaultErrorHandler
- HTTPRedirectHandler
- HTTPCookieProcessor
- ProxyHandler
- HTTPPasswordMgr
- HTTPPasswordMgrWithDefaultRealm
- HTTPPasswordMgrWithPriorAuth
- AbstractBasicAuthHandler
- HTTPBasicAuthHandler
- ProxyBasicAuthHandler
- AbstractDigestAuthHandler
- HTTPDigestAuthHandler
- ProxyDigestAuthHandler
- HTTPHandler
- HTTPSHandler
- FileHandler
- DataHandler
- FTPHandler
- CacheFTPHandler
- UnknownHandler
- HTTPErrorProcessor
- Request 对象
  - full_url
  - type
  - host
  - origin_req_host
  - selector
  - data
  - unverifiable
  - method
  - get_method()
  - add_header()
  - add_unredirected_header()
  - has_header()
  - remove_header()
  - get_full_url()
  - set_proxy()
  - get_header()
  - header_items()
- OpenerDirector 对象
  - add_handler()
  - open()
  - error()
- BaseHandler 对象
  - add_parent()
  - close()
  - parent
  - default_open()
  - unknown_open()
  - http_error_default()
- HTTPRedirectHandler 对象
  - redirect_request()
  - http_error_301()
  - http_error_302()
  - http_error_303()
  - http_error_307()
  - http_error_308()
- HTTPCookieProcessor 对象
  - cookiejar
- ProxyHandler 对象
- HTTPPasswordMgr 对象
  - add_password()
  - find_user_password()
- HTTPPasswordMgrWithPriorAuth 对象
  - add_password()
  - find_user_password()
  - update_authenticated()
  - is_authenticated()
- AbstractBasicAuthHandler 对象
  - http_error_auth_reqed()
- HTTPBasicAuthHandler 对象
  - http_error_401()
- ProxyBasicAuthHandler 对象
  - http_error_407()
- AbstractDigestAuthHandler 对象
  - http_error_auth_reqed()
- HTTPDigestAuthHandler 对象
  - http_error_401()
- ProxyDigestAuthHandler 对象
  - http_error_407()
- HTTPHandler 对象
  - http_open()
- HTTPSHandler 对象
  - https_open()
- FileHandler 对象
  - file_open()
- DataHandler 对象
  - data_open()
- FTPHandler 对象
  - ftp_open()
- CacheFTPHandler 对象
  - setTimeout()
  - setMaxConns()
- UnknownHandler 对象
  - unknown_open()
- HTTPErrorProcessor 对象
  - http_response()
  - https_response()
- 示例
- 旧接口
  - urlretrieve()
  - urlcleanup()
  - URLopener
  - FancyURLopener
    - prompt_user_passwd()
- urllib.request 限制
urllib.response — urllib 使用的响应类
- addinfourl
  - url
  - headers
  - status
  - geturl()
  - info()
  - code
  - getcode()
urllib.parse — 将 URL 解析为组件
- URL 解析
- URL 解析安全性
- 解析 ASCII 编码的字节
- 结构化的解析结果
- URL 引用
urllib.error — urllib.request 引发的异常类
- URLError
  - reason
- HTTPError
  - url
  - code
  - reason
  - headers
  - fp
- ContentTooShortError
  - content
urllib.robotparser — robots.txt 的解析器
- RobotFileParser
http — HTTP 模块
- HTTPStatus
- HTTP 状态码
- HTTP 状态类别
  - HTTPMethod
- HTTP 方法
http.client — HTTP 协议客户端
- HTTPConnection
- HTTPSConnection
- HTTPResponse
- parse_headers()
- HTTPException
- NotConnected
- InvalidURL
- UnknownProtocol
- UnknownTransferEncoding
- UnimplementedFileMode
- IncompleteRead
- ImproperConnectionState
- CannotSendRequest
- CannotSendHeader
- ResponseNotReady
- BadStatusLine
- LineTooLong
- RemoteDisconnected
- HTTP_PORT
- HTTPS_PORT
- responses
- HTTPConnection 对象
  - request()
  - getresponse()
  - set_debuglevel()
  - set_tunnel()
  - get_proxy_response_headers()
  - connect()
  - close()
  - blocksize
  - putrequest()
  - putheader()
  - endheaders()
  - send()
- HTTPResponse 对象
  - read()
  - readinto()
  - getheader()
  - getheaders()
  - fileno()
  - msg
  - version
  - url
  - headers
  - status
  - reason
  - debuglevel
  - closed
  - geturl()
  - info()
  - getcode()
- 示例
- HTTPMessage 对象
  - HTTPMessage
ftplib — FTP 协议客户端
- 参考
  - FTP 对象
    - FTP
      - set_debuglevel()
      - connect()
      - getwelcome()
      - login()
      - abort()
      - sendcmd()
      - voidcmd()
      - retrbinary()
      - retrlines()
      - set_pasv()
      - storbinary()
      - storlines()
      - transfercmd()
      - ntransfercmd()
      - mlsd()
      - nlst()
      - dir()
      - rename()
      - delete()
      - cwd()
      - mkd()
      - pwd()
      - rmd()
      - size()
      - quit()
      - close()
  - FTP_TLS 对象
    - FTP_TLS
  - 模块变量
poplib — POP3 协议客户端
- POP3
- POP3_SSL
- error_proto
- POP3 对象
  - set_debuglevel()
  - getwelcome()
  - capa()
  - user()
  - pass_()
  - apop()
  - rpop()
  - stat()
  - list()
  - retr()
  - dele()
  - rset()
  - noop()
  - quit()
  - top()
  - uidl()
  - utf8()
  - stls()
- POP3 示例
imaplib — IMAP4 协议客户端
- IMAP4
- error
- abort
- readonly
- IMAP4_SSL
- IMAP4_stream
- Internaldate2tuple()
- Int2AP()
- ParseFlags()
- Time2Internaldate()
- IMAP4 对象
  - append()
  - authenticate()
  - check()
  - close()
  - copy()
  - create()
  - delete()
  - deleteacl()
  - enable()
  - expunge()
  - fetch()
  - getacl()
  - getannotation()
  - getquota()
  - getquotaroot()
  - list()
  - login()
  - login_cram_md5()
  - logout()
  - lsub()
  - myrights()
  - namespace()
  - noop()
  - open()
  - partial()
  - proxyauth()
  - read()
  - readline()
  - recent()
  - rename()
  - response()
  - search()
  - select()
  - send()
  - setacl()
  - setannotation()
  - setquota()
  - shutdown()
  - socket()
  - sort()
  - starttls()
  - status()
  - store()
  - subscribe()
  - thread()
  - uid()
  - unsubscribe()
  - unselect()
  - xatom()
  - PROTOCOL_VERSION
  - debug
  - utf8_enabled
- IMAP4 示例
smtplib — SMTP 协议客户端
- SMTP
- SMTP_SSL
- LMTP
- SMTPException
- SMTPServerDisconnected
- SMTPResponseException
- SMTPSenderRefused
- SMTPRecipientsRefused
- SMTPDataError
- SMTPConnectError
- SMTPHeloError
- SMTPNotSupportedError
- SMTPAuthenticationError
- SMTP 对象
- SMTP 示例
uuid — 根据 RFC 4122 的 UUID 对象
- SafeUUID
  - safe
  - unsafe
  - unknown
- UUID
- bytes
- bytes_le
- 字段
- time_low
- time_mid
- time_hi_version
- clock_seq_hi_variant
- clock_seq_low
- 节点
- 时间
- clock_seq
- 十六进制
- 整数
- urn
- 变体
- version
- is_safe
- getnode()
- uuid1()
- uuid3()
- uuid4()
- uuid5()
- NAMESPACE_DNS
- NAMESPACE_URL
- NAMESPACE_OID
- NAMESPACE_X500
- RESERVED_NCS
- RFC_4122
- RESERVED_MICROSOFT
- RESERVED_FUTURE
- 命令行用法
- 示例
- 命令行示例
socketserver — 网络服务器框架
- TCPServer
- UDPServer
- UnixStreamServer
- UnixDatagramServer
- 服务器创建注意事项
- 服务器对象
  - BaseServer
- 请求处理程序对象
- 示例
http.server — HTTP 服务器
- HTTPServer
- ThreadingHTTPServer
- BaseHTTPRequestHandler
- SimpleHTTPRequestHandler
- CGIHTTPRequestHandler
  - cgi_directories
  - do_POST()
- 安全注意事项
http.cookies — HTTP 状态管理
- CookieError
- BaseCookie
- SimpleCookie
- Cookie 对象
- Morsel 对象
  - Morsel
    - expires
    - path
    - comment
    - domain
    - secure
    - version
    - httponly
    - samesite
  - value
  - coded_value
  - key
  - set()
  - isReservedKey()
  - output()
  - js_output()
  - OutputString()
  - update()
  - copy()
  - setdefault()
- 示例
http.cookiejar — HTTP 客户端的 Cookie 处理
- LoadError
- CookieJar
- FileCookieJar
- CookiePolicy
- DefaultCookiePolicy
- Cookie
- CookieJar 和 FileCookieJar 对象
- FileCookieJar 子类以及与 Web 浏览器的合作
  - MozillaCookieJar
  - LWPCookieJar
- CookiePolicy 对象
- DefaultCookiePolicy 对象
- Cookie 对象
- 示例
xmlrpc — XMLRPC 服务器和客户端模块
xmlrpc.client — XML-RPC 客户端访问
- ServerProxy
- ServerProxy 对象
- DateTime 对象
  - DateTime
    - decode()
    - encode()
- Binary 对象
  - Binary
- Fault 对象
  - Fault
    - faultCode
    - faultString
- ProtocolError 对象
  - ProtocolError
    - url
    - errcode
    - errmsg
    - headers
- MultiCall 对象
  - MultiCall
- 便捷函数
  - dumps()
  - loads()
- 客户端使用示例
- 客户端和服务器使用示例
xmlrpc.server — 基本 XML-RPC 服务器
- SimpleXMLRPCServer
- CGIXMLRPCRequestHandler
- SimpleXMLRPCRequestHandler
- SimpleXMLRPCServer 对象
- CGIXMLRPCRequestHandler
- 编写 XMLRPC 服务器文档
- DocXMLRPCServer 对象
- DocCGIXMLRPCRequestHandler
ipaddress — IPv4/IPv6 操作库
- 便捷工厂函数
- IP 地址
- IP 网络定义
- 接口对象
- 其他模块级函数
- 自定义异常
  - AddressValueError
  - NetmaskValueError