Karrigell 入门
原文:http://www.devshed.com/c/a/Python/Karrigell-for-Python/
因为python并不是特别为web开发而生,所以现在很多的python使用者都在开发能够让python运行于web的框架.Karrigell就是现在为数众多的python/web框架之一.本文将对Karrigell做简要的介绍.
简介
Karrigell是一个功能强大且灵活的python/web框架,为web开发提供了多种解决方案.并且,很重要的,它的安装和使用都非常的简单.即使是python的初学者,也不会在使用Karrigell的时候犯迷糊,并且Karrigell也没有因为结构简单而限制python的一些特性.它提供了自己的web服务器完成工作,但是也非常容易的和其他的web服务器(例如apache)结合工作,所以如果你选择了Karrigell,你仍然可以使用之前一直在使用的web服务器.
这篇文章将从Karrigell的安装开始说起,介绍数个Karrigell的重要特性.
安装Karrigell
上面说了,Karrigell的安装一点都不麻烦.你要做的第一步是到SourceForge下载最新的Karrigell，当你下载了zip包后,将其解压缩到一个容易找到的目录.然后直接双击Karrigell.py启动Karrigell的内置web服务器.如果你现在并不想把Karrigell和其他的web服务器结合使用,那Karrigell的安装到此就结束了.
但如果你想要设置你的web服务器来和Karrigell结合,我们拿apache来举例子.我们现在需要Karrigell在apache的后台运行,来使apache将相关的请求传送给Karrigell
因为apache一般会运行在80端口,你需要给Karrigell设置一个其他的运行端口.有两个方法来达到这个目的,其一是使用命令行来完成,或者可以改变Karrigell的配置文件.先来看如何用命令行,我们将在8080端口运行Karrigell.
C:\Karrigell>Karrigell.py -P 8080
第二种,你需要找到Karrigell.ini,然后加上这么一句
port=8080
现在你需要配置apache将有关的请求转向到Karrigell.一般来说,你希望apache可以处理任何的静态文件请求,比如php.你可以和apache共享同一个路径, 也可以设立单独的路径..然后设置那些文件需要apache把请求传递给Karrigell,你需要添加下面的内容到apache的 httpd.conf 文件.
RewriteEngine On
RewriteRule ^/(.*).py(.*) 1.py$2]http://localhost:8080/$1.py$2 [L,P]
RewriteRule ^/(.*).ks(.*) 1.ks$2]http://localhost:8080/$1.ks$2 [L,P]
RewriteRule ^/(.*).hip(.*) 1.hip$2]http://localhost:8080/$1.hip$2 [L,P]
RewriteRule ^/(.*).pih(.*) 1.pih$2]http://localhost:8080/$1.pih$2 [P]
如果你想, 你可以设置全部的特定文件请求都转给Karrigell.在本文中,我们将使用testarea这个路径,所以我们这样设置httpd.conf:
RewriteEngine On
RewriteRule ^/testarea(.*) 1]http://localhost:8080/testarea$1 [P]
当然你可以这样:
RewriteEngine On
RewriteRule ^/testarea/(.*).py(.*)
1.py$2]http://localhost:8080/testarea/$1.py$2 [L,P]
RewriteRule ^/testarea/(.*).ks(.*)
1.ks$2]http://localhost:8080/testarea/$1.ks$2 [L,P]
RewriteRule ^/testarea/(.*).hip(.*)
1.hip$2]http://localhost:8080/testarea/$1.hip$2 [L,P]
RewriteRule ^/testarea/(.*).pih(.*)
1.pih$2]http://localhost:8080/testarea/$1.pih$2 [P]
Scripts和Services
Python scripts和Karrigell services将是python开发者使用Karrigell最容易接触的两个概念.Python scripts就是python的脚本,开发者使用print语句输出到用户浏览器的内容.如果你还不明白,建立一个testarea目录,然后我们将开始创建我们的第一个Python scripts.新建一个文件test.py:
print "<center>"
print "Hello!"
print "<br /><br />"
print "Karrigell is configured and working."
print "</center>"
在浏览器中打开这个文件,如果之前你的Karrigell都正确设置,那你将会看到输出的内容.
Python scripts也可以容易的使用表单.让我们再来创建一个简单的页面,用户可以在这个页面输入自己的名字.新建文件askname.py:
if QUERY.has_key ( "name" ):
print "Your name is", _name + "."
else:
print "What is your name?<br />"
print "<form>"
print "<input type='text' name='name' /><br />"
print "<input type='submit' value='Proceed' />"
print "</form>"
Karrigell services的编写和Python scripts类似.这个的作用是映射请求到用户指定的方法.指定方法的名字通过跟在Karrigell services后面进行传递.比如,下面这个url将会调用test这个方法
http://localhost/testarea/test.ks/test
让我们实际编写下这个例子
def index():
print "Index function."
def test():
print "Test function."
如果不传递方法名而使用这些Python scripts,你的程序会默认执行index方法.如果传递了方法名test,那test方法就会被调用.调用一个不存在的方法会抛出异常.
使用Karrigell services来处理表单传递的数据也很简单.让我们来创建一个ascname.ks
def index():
print "What is your name?<br />"
print "<form action='nameSubmit'>"
print "<input type='text' name='name' /><br />"
print "<input type='submit' value='Proceed' />"
print "</form>"
def nameSubmit ( name ):
print "Your name is", name + "."
当然,允许外部公开访问你的方法是一件很危险的事情,为了阻止不允许的用户访问你的方法,按照下面所述给你的方法加前缀:
def _private():
pass
尝试访问_private方法将会抛出异常.
使用HIP
在askname.py,有一件事情值得注意,这个代码镉刑嗟膒rint语句.如果可以不使用print而直接输出,那将会是一件多么好的事情.幸运的是,Karrigell提供了这样的功能.这被称为HTML Inside Python,这将清除所有讨厌的print语句.并且从askname.py到TML Inside Python的转换也非常容易.我们只是需要移走那些print语句.删除askname.py里的print并将文件重命名为askname.hip
f QUERY.has_key ( "name" ):
"Your name is", _name + "."
else:
"What is your name?<br />"
"<form method='POST'>"
"<input type='text' name='name' /><br />"
"<input type='submit' value='Proceed' />"
"</form>"
这就是HTML Inside Python.Karrigell将会检查你的文件并自动在需要的地方添加print.HTML Inside Python是Karrigell简单易学的一个有力证明.
Python Inside HTML
Karrigell提供了HTML
Inside Python,那自然的,也会提供Python Inside HTML.和一般的做法一样,将python语句写在特殊的标记里,然后把最终结果发送到用户的浏览器.让我们来创建一个简单的示例,random.pih
<% import random %>
Random number: <b><% print random.random() %></b>
正如你说看到的,Python Inside HTML的概念如此的简单.而其实,代码块可以更加的简单:
<%= random.random() %>
但是,如果处理更复杂的逻辑,比如处理表单数据?表单数据可以像在Python scripts中被处理那样被处理.这是有一个askname.py的复制品askname.pih
<% if QUERY.has_key ( "name" ): %>
Your name is <%= _name %>.
<% end %>
<% else: %>
What is your name?<br />
<form method='POST'>
<input type='text' name='name' /><br />
<input type='submit' value='Proceed' />
</form>
<% end %>
请注意<% end %>的使用.这将标识代码块的结尾,就像上面我们的条件语句的缩进一样.另一个可选择的办法是使用indent标签,这个也被用来标识代码缩进.
<indent>
<% if QUERY.has_key ( "name" ): %>
Your name is <%= _name %>.
<% else: %>
What is your name?<br />
<form method='POST'>
<input type='text' name='name' /><br />
<input type='submit' value='Proceed' />
</form>
</indent>
更多的特性
我们来这样试一下,标签可以通过Python scripts这样使用,tagtest.py
rom HTMLTags import *
print CENTER ( B ( "Test." ) )
session同样可以在Karrigell被处理,并且Karrigell还提供了一个良好的接近于面向对象的session机制.让我们创建一段简单的代码来示范Karrigell中的session.回到我们的第一个例子,用户将会获得一个幸运数字.如果用户刷新页面,该数字仍然存在,因为这个数字将被保存在sessin中.当然,用户将可以选择重新获取新的幸运数字,这通过关闭sessin来完成.创立一个名为luckynumber.ks的Karrigell services,输入下面的代码:
import random
user = Session()
def index():
if not "luckyNumber" in dir ( user ):
user.luckyNumber = random.randint ( 0, 20 )
print "Your lucky number:", user.luckyNumber
print "<br /><br />"
print "<a href='reset'>Reset Lucky Number</a>"
def reset():
user.close()
print "Your lucky number has been reset."
print "<br /><br />"
print "<a href='index'>Back</a>"
结论
Karrigell提供了四种方法来进行web开放,Python scripts,Karrigell services,HTML Inside Python和Python Inside HTML,每种方法都有其特点,但是他们却都有一个共同的优点:使用简单.Karrigell 将web开发变成了一件优雅,简单的事情.无论是单独使用Karrigell还是和apache结合使用,都是令人吃惊的简单.因为,无论是对于初学者,还是老手,Karrigell都是不错的选择.