了解wsgiref.util模块的基本用法

wsgiref.util模块是Python内置的WSGI（Web Server Gateway Interface）工具模块，提供了一些基本的功能函数，用于处理WSGI请求和响应。

下面是wsgiref.util模块一些常用函数的介绍以及使用例子。

1. wsgiref.util.request_uri(environ, include_query=True)

该函数用于获取当前请求的完整URI，包括路径和查询参数。参数include_query默认为True，表示包括查询参数，如果为False，则只返回路径部分。

示例：

   from wsgiref.util import request_uri

   def application(environ, start_response):
       uri = request_uri(environ)
       start_response('200 OK', [('Content-Type', 'text/plain')])
       yield uri.encode('utf-8')

   # 运行WSGI应用程序...
   

当访问http://localhost:8000/hello?name=world时，会返回"/hello?name=world"。

2. wsgiref.util.setup_testing_defaults(environ)

该函数用于设置WSGI环境变量的默认值，方便进行测试，自动为environ设置一些必要的WSGI变量。

示例：

   from wsgiref.util import setup_testing_defaults

   def application(environ, start_response):
       setup_testing_defaults(environ)
       start_response('200 OK', [('Content-Type', 'text/plain')])
       yield 'Hello, WSGI'.encode('utf-8')

   # 运行WSGI应用程序...
   

使用该函数后，environ会被自动设置为测试环境的默认值，如REQUEST_METHOD为'GET'，SCRIPT_NAME为空字符串等。

3. wsgiref.util.shift_path_info(environ)

该函数用于从environ中获取当前请求的URL路径，并剥离掉 部分作为路径信息。shift_path_info会修改environ，移除掉路径信息的 部分，并返回移除的部分。

示例：

   from wsgiref.util import shift_path_info

   def application(environ, start_response):
       path_info = shift_path_info(environ)
       start_response('200 OK', [('Content-Type', 'text/plain')])
       yield path_info.encode('utf-8')

   # 运行WSGI应用程序...
   

当访问http://localhost:8000/hello/world时，会返回"/hello"。

4. wsgiref.util.application_uri(environ)

该函数用于获取当前请求的应用程序URI，即去除了路径信息和查询参数的URI。

示例：

   from wsgiref.util import application_uri

   def application(environ, start_response):
       uri = application_uri(environ)
       start_response('200 OK', [('Content-Type', 'text/plain')])
       yield uri.encode('utf-8')

   # 运行WSGI应用程序...
   

当访问http://localhost:8000/hello?name=world时，会返回"http://localhost:8000"。

5. wsgiref.util.shift_query_string(environ)

该函数用于从environ中获取当前请求的查询字符串，并将其从environ中移除，并返回查询字符串。

示例：

   from wsgiref.util import shift_query_string

   def application(environ, start_response):
       query_string = shift_query_string(environ)
       start_response('200 OK', [('Content-Type', 'text/plain')])
       yield query_string.encode('utf-8')

   # 运行WSGI应用程序...
   

当访问http://localhost:8000/hello?name=world时，会返回"name=world"。

综上所述，wsgiref.util模块提供了一些有用的函数，用于处理WSGI请求和响应。以上是一些常用函数的介绍和使用示例，可以根据具体的需求选择使用。