[Karrigell]Karrigell Web开发入门第一季

Karrigell是一个用纯Python写的web框架，它非常简单而且有很多的特性。

这个教程将会一步一步的说明如何使用Karrigell编写程序。

使用Karrigell开发是很简单的:∙分发包自带一些强大的东西:一个web服务器和一个数据库引擎，整个包的大小不到1MB∙不需要配置:只需解压包，运行服务器然后写代码即可∙程序可以是纯Python代码也可以是Python与HTML混合就像PHP一样；它没有模板语法，需要学习自定义标签人们发现Kariigell是如此的简单，可以像玩具一样只需一些入门或一些动态web服务器的知识就可以了。

如果要想写一个“Hello world!”程序，需要键入：print "Hello, world !"但是如果你看过它的文档，你可能会对这个玩具能做的事感到惊讶：∙简单的访问HTML表单∙可以在一个脚本内包含其它脚本∙非常简单的基于内存的session管理∙基本的HTTP身份验证∙HTTP重定向∙保护文件夹∙多语言版本的动态页面∙多样的编程方式，从把一个站点放在一个纯Python脚本中到像PHP一样一个脚本是一个页面的方式∙内含Cheetah模板系统∙自带一个非常快的异步web服务器∙支持虚拟主机∙支持gzip∙可以在Apache或Xitami下运行∙带有一个简洁和完整的调试器∙带有一个数据库管理系统还有更多的特性….更多的信息参见documentation1. Getting started首先，download最新版的Karrigell并且把它解压。

打开windows的命令行窗口并运行内置的服务器：>python Karrigell.py使用一个文本编辑器保存如下Python代码到webapps目录hello.py的文件里：print "hello world !"然后在web浏览器里键入http://localhost/hello.py查看结果默认的，Python脚本被渲染成HTML代码。

如果想使用纯文本格式可在代码里设置Content-Type 头，就像这样：RESPONSE['Content-Type'] = 'text/plain'print "hello world !"这个例子展示Karrigell如何工作的：脚本都运行在一个命名空间内。

RESPONSE是这个命名空间里可用的名字，它是一个字典控制着HTTP响应的头。

2. HTML forms让我们来看看在提交了一个HTML窗体后如何得到这些信息。

新建这些HTML代码片段并保存在hello.htm中<form action="hello.py">Say hello to <input name="user"><input type="submit" value="Ok"></form>这个页面显示用户名，并且可以提交到hello.py脚本这是如何让hello.py打印信息的脚本：print "Hello, " + _user内置的Karrigell名字空间在接受到自浏览器发送的数据后会有一个叫_user的变量，它是输入到user字段的字符串值（注意是以下划线开头的，它用来避免与Python的关键字或内置的名字冲突）。

也可以选择使用这样的语法：print "Hello, " + QUERY['user']QUERY是一个提交表单的字段名字的字典3. Logging and session management如果想在一个站点里标识一个用户，比如需要打印它的名字，最简单的技巧是session管理。

Karrigell使用另一个内置的名字一个叫Session()的函数来管理session，它返回一个可以设置任何属性的Python对象。

编辑脚本hello.py :print "Hello, " + _userSession().user = _userprint """What would you like to order :<form action="order.py">CD <input type="radio" name="type" value="CD">book <input type="radio" name="type" value="book"><input type="submit" value="Ok"></form>"""在第二行设置session对象的user属性值为_user。

Session对象是web浏览器特有的，因此它能保证和持久一个用户可以被其它脚本标识。

例如可以在order.py中使用：print "Hello %s" %Session().userprint "So you want to order a %s" %_type4. Authentication身份认证是一个非常常见的任务用来检查一个用户是否有执行一个任务的权限。

因此，要求用户需要输入登录名和密码，程序会在数据库里查看登录名/密码是否合法。

改变HTML页面来要求输入一个用户名和密码而不只是一个用户名：<form action="check.py">Login <input name="login"><br>Password <input type="password" name="password"><input type="submit" value="Ok"></form>check.py脚本是这样的：def is_valid(login,password):# replace this with a check in the users databasereturn login == 'login' and password == 'password'if is_valid(_login,_password):Session().login = _loginprint "Hello %s <br>" %_loginprint """What would you like to order :<form action="order.py">CD <input type="radio" name="type" value="CD">book <input type="radio" name="type" value="book"><input type="submit" value="Ok"></form>"""else:print "Sorry, you are not allowed to access this page"Session对象有了一个login属性后，就可以在其他脚本里通过测试这个属性来测试用户的合法性了：if hasattr(Session(),'login'):(show information for authorized users)else:(show information for unlogged visitors)当然也可以选择使用基本HTTP身份认证：一个要求输入登录名和密码的弹出式窗口。

为了达到验证的目的在命名空间里一个叫Authentication()的函数，像这样使用：def authTest():(check if AUTH_USER and AUTH_PASSWORD are in the database) Authentication(authTest,"Authentication test",/"Sorry, you are not allowed to access this page")print """What would you like to order :<form action="order.py">CD <input type="radio" name="type" value="CD">book <input type="radio" name="type" value="book"><input type="submit" value="Ok"></form>"""Authentication()带有3个参数：∙function：调用的函数，这个函数没有参数，但是它使用AUTH_USER和AUTH_PASSWORD 它们是在弹出窗口输入的用户名和密码,如果验证成功将会继续执行下面的脚本∙realm：是一个显示在弹出窗口上的字符串∙message：当function没有返回True时，验证未成功时返回的信息。

如果验证成功将会继续执行下面的脚本。

5. Karrigell services目前我们都是把脚本写在不同的文件里。

但是一些比较小的脚本就会变的乏味和难以维护。

我们可以使用Karrigell services：Python脚本的每一个函数匹配一个URL。