CherryPy - 工具箱

在 CherryPy 中，内置工具提供了一个单一的接口来调用 CherryPy 库。CherryPy 中定义的工具可以通过以下方式实现：

从配置设置
作为 Python 装饰器或通过页面处理程序的特殊 _cp_config 属性
作为可以在任何函数内部应用的 Python 可调用对象

基本身份验证工具

此工具的目的是为应用程序中设计的应用程序提供基本身份验证。

参数

此工具使用以下参数：

名称	默认值	描述
领域	N/A	定义领域值的字符串。
用户	N/A	表单为 username:password 的字典或返回此类字典的 Python 可调用函数。
加密	无	用于加密客户端返回的密码并将其与用户字典中提供的加密密码进行比较的 Python 可调用对象。

示例

让我们举一个例子来了解它是如何工作的：

import sha
import cherrypy

class Root:
@cherrypy.expose
def index(self):

return """
<html>
   <head></head>
   <body>
      <a href = "admin">Admin </a>
   </body>
</html>
""" 

class Admin:

@cherrypy.expose
def index(self):
return "This is a private area"

if __name__ == '__main__':
def get_users():
# 'test': 'test'
return {'test': 'b110ba61c4c0873d3101e10871082fbbfd3'}
def encrypt_pwd(token):

return sha.new(token).hexdigest()
   conf = {'/admin': {'tools.basic_auth.on': True,
      tools.basic_auth.realm': 'Website name',
      'tools.basic_auth.users': get_users,
      'tools.basic_auth.encrypt': encrypt_pwd}}
   root = Root()
root.admin = Admin()
cherrypy.quickstart(root, '/', config=conf)

get_users 函数返回一个硬编码字典，但也从数据库或其他任何地方获取值。admin 类包含此函数，该函数利用了 CherryPy 的内置身份验证工具。身份验证加密密码和用户 ID。

基本身份验证工具实际上并不安全，因为密码可以被入侵者编码和解码。

缓存工具

此工具的目的是提供 CherryPy 生成的内容的内存缓存。

参数

此工具使用以下参数：

名称	默认值	描述
无效方法	("POST", "PUT", "DELETE")	不应缓存的 HTTP 方法的字符串元组。这些方法还将使资源的任何缓存副本失效（删除）。
缓存类	MemoryCache	用于缓存的类对象

解码工具

此工具的目的是解码传入的请求参数。

参数

此工具使用以下参数：

名称	默认值	描述
编码	无	它查找内容类型标头
默认编码	"UTF-8"	当未提供或找到任何编码时使用的默认编码。

示例

让我们举一个例子来了解它是如何工作的：

import cherrypy
from cherrypy import tools

class Root:
@cherrypy.expose
def index(self):

return """ 
<html>
   <head></head>
   <body>
      <form action = "hello.html" method = "post">
         <input type = "text" name = "name" value = "" />
         <input type = ”submit” name = "submit"/>
      </form>
   </body>
</html>
"""

@cherrypy.expose
@tools.decode(encoding='ISO-88510-1')
def hello(self, name):
return "Hello %s" % (name, )
if __name__ == '__main__':
cherrypy.quickstart(Root(), '/')

以上代码从用户那里获取一个字符串，它将把用户重定向到“hello.html”页面，在那里它将显示为“Hello”，后面跟着给定的名称。

以上代码的输出如下：

hello.html

打印页面