CherryPy Tutorial
CherryPy Useful Resources
Selected Reading
- Deployment Of Application
- CherryPy - Testing
- CherryPy - Demo Application
- CherryPy - Use Of Ajax
- CherryPy - Presentation Layer
- CherryPy - Web Services
- CherryPy - A Working Application
- CherryPy - ToolBox
- Bulit-in Http Server
- CherryPy - Vocabulary
- CherryPy - Environment Setup
- CherryPy - Introduction
- CherryPy - Home
CherryPy Useful Resources
Selected Reading
- Who is Who
- Computer Glossary
- HR Interview Questions
- Effective Resume Writing
- Questions and Answers
- UPSC IAS Exams Notes
CherryPy - ToolBox
CherryPy - ToolBox
Within CherryPy, built-in tools offer a single interface to call the CherryPy pbrary. The tools defined in CherryPy can be implemented in the following ways −
From the configuration settings
As a Python decorator or via the special _cp_config attribute of a page handler
As a Python callable that can be appped from within any function
Basic Authentication Tool
The purpose of this tool is to provide basic authentication to the apppcation designed in the apppcation.
Arguments
This tool uses the following arguments −
| Name | Default | Description |
|---|---|---|
| realm | N/A | String defining the realm value. |
| users | N/A | Dictionary of the form − username:password or a Python callable function returning such a dictionary. |
| encrypt | None | Python callable used to encrypt the password returned by the cpent and compare it with the encrypted password provided in the users dictionary. |
Example
Let us take an example to understand how it works −
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)
The get_users function returns a hard-coded dictionary but also fetches the values from a database or anywhere else. The class admin includes this function which makes use of an authentication built-in tool of CherryPy. The authentication encrypts the password and the user Id.
The basic authentication tool is not really secure, as the password can be encoded and decoded by an intruder.
Caching Tool
The purpose of this tool is to provide memory caching of CherryPy generated content.
Arguments
This tool uses the following arguments −
| Name | Default | Description |
|---|---|---|
| invapd_methods | ("POST", "PUT", "DELETE") | Tuples of strings of HTTP methods not to be cached. These methods will also invapdate (delete) any cached copy of the resource. |
| cache_Class | MemoryCache | Class object to be used for caching |
Decoding Tool
The purpose of this tool is to decode the incoming request parameters.
Arguments
This tool uses the following arguments −
| Name | Default | Description |
|---|---|---|
| encoding | None | It looks for the content-type header |
| Default_encoding | "UTF-8" | Default encoding to be used when none is provided or found. |
Example
Let us take an example to understand how it works −
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(), / )
The above code takes a string from the user and it will redirect the user to "hello.html" page where it will be displayed as “Hello” with the given name.
The output of the above code is as follows −
hello.html
Advertisements