互联网协议和支持

本章介绍的模块实现了互联网协议以及相关技术支持。 它们都是用 Python 实现的。 这些模块大多需要依赖于系统的模块 socket 作为前提，该模块在大多数流行系统平台上都受到支持。 下面是一份概览:

• webbrowser --- 方便的 Web 浏览器控制工具
  • Error
  • open()
  • open_new()
  • open_new_tab()
  • get()
  • register()
  • 浏览器控制器对象
    • name
    • open()
    • open_new()
    • open_new_tab()
• wsgiref --- WSGI 工具和参考实现
  • wsgiref.util -- WSGI 环境工具
    • guess_scheme()
    • request_uri()
    • application_uri()
    • shift_path_info()
    • setup_testing_defaults()
    • is_hop_by_hop()
    • FileWrapper
  • wsgiref.headers -- WSGI 响应标头工具
    • Headers
      • get_all()
      • add_header()
  • wsgiref.simple_server -- 一个简单的 WSGI HTTP 服务器
    • make_server()
    • demo_app()
    • WSGIServer
      • set_app()
      • get_app()
    • WSGIRequestHandler
      • get_environ()
      • get_stderr()
      • handle()
  • wsgiref.validate --- WSGI 一致性检查器
    • validator()
  • wsgiref.handlers -- 服务器/网关基类
    • CGIHandler
    • IISCGIHandler
    • BaseCGIHandler
    • SimpleHandler
    • BaseHandler
      • run()
      • _write()
      • _flush()
      • get_stdin()
      • get_stderr()
      • add_cgi_vars()
      • wsgi_multithread
      • wsgi_multiprocess
      • wsgi_run_once
      • os_environ
      • server_software
      • get_scheme()
      • setup_environ()
      • log_exception()
      • traceback_limit
      • error_output()
      • error_status
      • error_headers
      • error_body
      • wsgi_file_wrapper
      • sendfile()
      • origin_server
      • http_version
    • read_environ()
  • wsgiref.types -- 用于静态类型检查的 WSGI 类型
    • StartResponse
    • WSGIEnvironment
    • WSGIApplication
    • InputStream
    • ErrorStream
    • FileWrapper
  • 例子
• 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()
  • urllib.request 的限制
• urllib.response --- urllib 使用的 Response 类
  • addinfourl
    • url
    • headers
    • status
    • geturl()
    • info()
    • code
    • getcode()
• urllib.parse --- 将 URL 解析为组件
  • URL 解析
    • urlparse()
    • parse_qs()
    • parse_qsl()
    • urlunparse()
    • urlsplit()
    • urlunsplit()
    • urljoin()
    • urldefrag()
    • unwrap()
  • URL 解析安全
  • 解析ASCII编码字节
  • 结构化解析结果
    • geturl()
    • DefragResult
    • ParseResult
    • SplitResult
    • DefragResultBytes
    • ParseResultBytes
    • SplitResultBytes
  • URL 转码
    • quote()
    • quote_plus()
    • quote_from_bytes()
    • unquote()
    • unquote_plus()
    • unquote_to_bytes()
    • urlencode()
• urllib.error --- 由 urllib.request 引发的异常类
  • URLError
    • reason
  • HTTPError
    • url
    • code
    • reason
    • headers
    • fp
  • ContentTooShortError
    • content
• urllib.robotparser --- 用于 robots.txt 的解析器
  • RobotFileParser
    • set_url()
    • read()
    • parse()
    • can_fetch()
    • mtime()
    • modified()
    • crawl_delay()
    • request_rate()
    • site_maps()
• 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
        • ssl_version
        • auth()
        • ccc()
        • prot_p()
        • prot_c()
    • 模块变量
      • error_reply
      • error_temp
      • error_perm
      • error_proto
      • all_errors
• 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 对象
    • set_debuglevel()
    • docmd()
    • connect()
    • helo()
    • ehlo()
    • ehlo_or_helo_if_needed()
    • has_extn()
    • verify()
    • login()
    • auth()
    • starttls()
    • sendmail()
    • send_message()
    • quit()
  • SMTP 示例
• uuid --- UUID objects according to RFC 9562
  • SafeUUID
    • safe
    • unsafe
    • unknown
  • UUID
  • bytes
  • bytes_le
  • fields
  • time_low
  • time_mid
  • time_hi_version
  • clock_seq_hi_variant
  • clock_seq_low
  • node
  • time
  • clock_seq
  • hex
  • int
  • urn
  • variant
  • version
  • is_safe
  • getnode()
  • uuid1()
  • uuid3()
  • uuid4()
  • uuid5()
  • uuid8()
  • NAMESPACE_DNS
  • NAMESPACE_URL
  • NAMESPACE_OID
  • NAMESPACE_X500
  • RESERVED_NCS
  • RFC_4122
  • RESERVED_MICROSOFT
  • RESERVED_FUTURE
  • 命令行用法
  • 示例
  • 命令行示例
• socketserver --- 用于网络服务器的框架
  • TCPServer
  • UDPServer
  • UnixStreamServer
  • UnixDatagramServer
  • 服务器创建的说明
    • ForkingMixIn
    • ThreadingMixIn
      • block_on_close
      • max_children
      • daemon_threads
    • ForkingTCPServer
    • ForkingUDPServer
    • ThreadingTCPServer
    • ThreadingUDPServer
    • ForkingUnixStreamServer
    • ForkingUnixDatagramServer
    • ThreadingUnixStreamServer
    • ThreadingUnixDatagramServer
  • Server 对象
    • BaseServer
      • fileno()
      • handle_request()
      • serve_forever()
      • service_actions()
      • shutdown()
      • server_close()
      • address_family
      • RequestHandlerClass
      • server_address
      • socket
      • allow_reuse_address
      • request_queue_size
      • socket_type
      • timeout
      • finish_request()
      • get_request()
      • handle_error()
      • handle_timeout()
      • process_request()
      • server_activate()
      • server_bind()
      • verify_request()
  • 请求处理器对象
    • BaseRequestHandler
      • setup()
      • handle()
      • finish()
      • request
      • client_address
      • server
    • StreamRequestHandler
    • DatagramRequestHandler
      • rfile
      • wfile
  • 例子
    • socketserver.TCPServer 示例
    • socketserver.UDPServer 示例
    • 异步混合类
• http.server --- HTTP 服务器
  • HTTPServer
  • ThreadingHTTPServer
  • BaseHTTPRequestHandler
    • client_address
    • server
    • close_connection
    • requestline
    • command
    • path
    • request_version
    • headers
    • rfile
    • wfile
    • server_version
    • sys_version
    • error_message_format
    • error_content_type
    • protocol_version
    • MessageClass
    • responses
    • handle()
    • handle_one_request()
    • handle_expect_100()
    • send_error()
    • send_response()
    • send_header()
    • send_response_only()
    • end_headers()
    • flush_headers()
    • log_request()
    • log_error()
    • log_message()
    • version_string()
    • date_time_string()
    • log_date_time_string()
    • address_string()
  • SimpleHTTPRequestHandler
    • server_version
    • extensions_map
    • do_HEAD()
    • do_GET()
  • CGIHTTPRequestHandler
    • cgi_directories
    • do_POST()
  • 安全考量
• http.cookies --- HTTP 状态管理
  • CookieError
  • BaseCookie
  • SimpleCookie
  • Cookie 对象
    • value_decode()
    • value_encode()
    • output()
    • js_output()
    • load()
  • 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 对象
    • add_cookie_header()
    • extract_cookies()
    • set_policy()
    • make_cookies()
    • set_cookie_if_ok()
    • set_cookie()
    • clear()
    • clear_session_cookies()
    • save()
    • load()
    • revert()
    • filename
    • delayload
  • FileCookieJar 的子类及其与 Web 浏览器的协同
    • MozillaCookieJar
    • LWPCookieJar
  • CookiePolicy 对象
    • set_ok()
    • return_ok()
    • domain_return_ok()
    • path_return_ok()
    • netscape
    • rfc2965
    • hide_cookie2
  • DefaultCookiePolicy 对象
    • blocked_domains()
    • set_blocked_domains()
    • is_blocked()
    • allowed_domains()
    • set_allowed_domains()
    • is_not_allowed()
    • rfc2109_as_netscape
    • strict_domain
    • strict_rfc2965_unverifiable
    • strict_ns_unverifiable
    • strict_ns_domain
    • strict_ns_set_initial_dollar
    • strict_ns_set_path
    • DomainStrictNoDots
    • DomainStrictNonDomain
    • DomainRFC2965Match
    • DomainLiberal
    • DomainStrict
  • Cookie 对象
    • version
    • name
    • value
    • port
    • domain
    • path
    • secure
    • expires
    • discard
    • comment
    • comment_url
    • rfc2109
    • port_specified
    • domain_specified
    • domain_initial_dot
    • has_nonstandard_attr()
    • get_nonstandard_attr()
    • set_nonstandard_attr()
    • is_expired()
  • 例子
• xmlrpc --- XMLRPC 服务端与客户端模块
• xmlrpc.client --- XML-RPC 客户端访问
  • ServerProxy
  • ServerProxy 对象
    • listMethods()
    • methodSignature()
    • methodHelp()
  • DateTime 对象
    • DateTime
      • decode()
      • encode()
  • Binary 对象
    • Binary
      • data
      • decode()
      • encode()
  • Fault 对象
    • Fault
      • faultCode
      • faultString
  • ProtocolError 对象
    • ProtocolError
      • url
      • errcode
      • errmsg
      • headers
  • MultiCall 对象
    • MultiCall
  • 便捷函数
    • dumps()
    • loads()
  • 客户端用法的示例
  • 客户端与服务器用法的示例
• xmlrpc.server --- 基本 XML-RPC 服务器
  • SimpleXMLRPCServer
  • CGIXMLRPCRequestHandler
  • SimpleXMLRPCRequestHandler
  • SimpleXMLRPCServer 对象
    • register_function()
    • register_instance()
    • register_introspection_functions()
    • register_multicall_functions()
    • rpc_paths
    • SimpleXMLRPCServer 示例
  • CGIXMLRPCRequestHandler
    • register_function()
    • register_instance()
    • register_introspection_functions()
    • register_multicall_functions()
    • handle_request()
  • 文档 XMLRPC 服务器
    • DocXMLRPCServer
    • DocCGIXMLRPCRequestHandler
    • DocXMLRPCRequestHandler
  • DocXMLRPCServer 对象
    • set_server_title()
    • set_server_name()
    • set_server_documentation()
  • DocCGIXMLRPCRequestHandler
    • set_server_title()
    • set_server_name()
    • set_server_documentation()
• ipaddress --- IPv4/IPv6 操作库
  • 方便的工厂函数
    • ip_address()
    • ip_network()
    • ip_interface()
  • IP 地址
    • 地址对象
      • IPv4Address
        • version
        • max_prefixlen
        • compressed
        • exploded
        • packed
        • reverse_pointer
        • is_multicast
        • is_private
        • is_global
        • is_unspecified
        • is_reserved
        • is_loopback
        • is_link_local
        • ipv6_mapped
      • __format__()
      • IPv6Address
        • compressed
        • exploded
        • packed
        • reverse_pointer
        • version
        • max_prefixlen
        • is_multicast
        • is_private
        • is_global
        • is_unspecified
        • is_reserved
        • is_loopback
        • is_link_local
        • is_site_local
        • ipv4_mapped
        • scope_id
        • sixtofour
        • teredo
      • __format__()
    • 转换字符串和整数
    • 运算符
      • 比较运算符
      • 算术运算符
  • IP网络的定义
    • 前缀、网络掩码和主机掩码
    • 网络对象
      • IPv4Network
        • version
        • max_prefixlen
        • is_multicast
        • is_private
        • is_unspecified
        • is_reserved
        • is_loopback
        • is_link_local
        • network_address
        • broadcast_address
        • hostmask
        • netmask
        • with_prefixlen
        • compressed
        • exploded
        • with_netmask
        • with_hostmask
        • num_addresses
        • prefixlen
        • hosts()
        • overlaps()
        • address_exclude()
        • subnets()
        • supernet()
        • subnet_of()
        • supernet_of()
        • compare_networks()
      • IPv6Network
        • version
        • max_prefixlen
        • is_multicast
        • is_private
        • is_unspecified
        • is_reserved
        • is_loopback
        • is_link_local
        • network_address
        • broadcast_address
        • hostmask
        • netmask
        • with_prefixlen
        • compressed
        • exploded
        • with_netmask
        • with_hostmask
        • num_addresses
        • prefixlen
        • hosts()
        • overlaps()
        • address_exclude()
        • subnets()
        • supernet()
        • subnet_of()
        • supernet_of()
        • compare_networks()
        • is_site_local
    • 运算符
      • 逻辑运算符
      • 迭代
      • 作为地址容器的网络
  • 接口对象
    • IPv4Interface
      • ip
      • network
      • with_prefixlen
      • with_netmask
      • with_hostmask
    • IPv6Interface
      • ip
      • network
      • with_prefixlen
      • with_netmask
      • with_hostmask
    • 运算符
      • 逻辑运算符
  • 其他模块级别函数
    • v4_int_to_packed()
    • v6_int_to_packed()
    • summarize_address_range()
    • collapse_addresses()
    • get_mixed_type_key()
  • 自定义异常
    • AddressValueError
    • NetmaskValueError