简单而直接的Python web 框架：web.py

程序员文章站 2022-07-07 13:32:06

...

web.py 是一个Python 的web 框架，它简单而且功能强大。web.py 是公开的，无论用于什么用途都是没有限制的。

先让大家感受一下web.py 的简单而强大：

import web

urls = (
    '/(.*)', 'hello'
)

class hello:
    def GET(self, name):
        i = web.input(times=1)
        if not name: name = 'world'
        for c in xrange(int(i.times)): print 'Hello,', name+'!'

if __name__ == "__main__": web.run(urls, globals())

看看，上面就是一个基于web.py 的完整的Web 应用。不信?!将上面的代码保存为文件code.py，在命令行下执行python code.py。然后打开你的浏览器，打开地址：http://localhost:8080/RossWan，看看结果：）没有意外的话(当然要先安装web.py，下面会有介绍)，浏览器会显示“Hello, RossWan!”。这是一个最简单的Hello world Web 应用。是不是很简单？！下面将较为详细地介绍下web.py 。Find fun :)

1. 安装（新版本下载地址https://github.com/webpy/webpy/tree/python3）

单击这里下载web.py 的安装文件，将下载得到的文件web.py-0.21.tar.gz 解压，进入解压后的文件夹，在命令行下执行：python setup.py install，在Linux 等系统下，需要root 的权限，可以执行：sudo python setup.py install。

安装完毕之后，就可以正式开始web.py 之旅…

2. URL 处理

对于一个站点来说，URL 的组织是最重要的一个部分，因为这是用户看得到的部分，而且直接影响到站点是如何工作的，在著名的站点如：del.icio.us ，其URLs 甚至是网页界面的一部分。而web.py 以简单的方式就能够构造出一个强大的URLs。

在每个web.py 应用，必须先import web 模块：

import web

现在，我们须要告诉web.py URL 如何组织，让我们以一个简单例子开始：

urls = (
  '/', 'index'    )

在上面的例子中，第一部分（‘/’）是一个匹配URL 的正则表达式，像/，/help/faq，/item/(\d+)，等等；第二部分（‘index’）是一个类名，匹配的请求将会被发送过去。

现在，我们需要编写index 类。当大部人浏览网页的时候，他们都没有注意到，浏览器是通过HTTP 跟World Wide Web 通信的。通信的细节不太重要，但要明白一点，用户是通过URLs（例如 / 或者 /foo?f=1）来请求web 服务器完成一定请求的（例如 GET 或者POST）。

GET 是最普遍的方法，用来请求一个页面。当我们在浏览器里输入“harvard.edu” 的时候，实际上它是向Web 服务器请求GET ”/“。另一个常见的方法是POST，常用于提交特定类型的表单，例如利用信用卡付费和处理一个订单。注意，GET URLs 能够被搜索引擎索引得到（想像一下Google 尝试购买你网站上的所用物品）。

在我们的web.py 代码中。我们清晰区分这两种方法：

class index:
    def GET(self):
        print "Hello, world!"

当接收到一个GET 请求时，上面的GET 方法将会被web.py 调用。

好的。现在，我们只需添加最后一行代码，让web.py 启动网页应用：

if __name__ == "__main__": web.run(urls, globals())

上面告诉web.py 如何配置URLs，以及找寻的类在文件中的全局命名空间。

整个code.py 文件的内容如下：

import web

urls = (
  '/', 'index'    )

class index:
    def GET(self):
        print "Hello, world!"

if __name__ == "__main__": web.run(urls, globals())

注意到没有，虽然我说了很多东西，但实际上web 应用的代码就只得上面的几行，而且这是一个完整的web.py 应用。在你的命令行下输入：

$ python code.py
Launching server: http://0.0.0.0:8080/

现在，你的web.py 应用已经启动了服务器。通过浏览器访问http://localhost:8080/ 的话，会见到”Hello, world！“。在启动服务器的时候，你可以在python code.py 后面添加IP 地址/端口来控制web.py 启动的服务器。例如：python code.py 8888。

3. 调试

web.py 本身也提供调试的工具。在最后的“if name …” 代码前面添加：

web.webapi.internalerror = web.debugerror

并在最后的“if name …” 添加”web.reloader“：

if __name__ == "__main__": web.run(urls, globals(), web.reloader)

上面的代码会使你在调试的阶段得到更多有用的信息。web.reloader 其实是一个中间件，当你在运行时修改了code.py 文件后，web.reloader 会重新加载code.py 文件，让你在浏览器上立刻可以看到变化。如何有多何变化的话，还是需要重新启动服务器。web.py 也提供web.profiler ,可以输出有用的信息，有关每个页面的每个函数调用的次数，这用助于你改善代码。

4. 模板

在Python 里面编写HTML 代码是相当累赘的，而在HTML 里嵌入Python 代码则有趣得多。幸运地，web.py 使这过程变得相当容易。

注意：旧版本的web.py 是用Cheetah templates 模板的，你可以继续使用，但官方已不再提供支持。

在我们的web 应用里，添加一个新的文件夹用来组织模板文件（例如”/templates“）。然后再新建一个HTML 文件（例如：”index.html“）:

<em>Hello</em>, world!

或者，你可以用web.py 的模板语言用编写这个HTML 文件：

$def with (name)

$if name:
    I just wanted to say <em>hello</em> to $name.
$else:
    <em>Hello</em>, world!

注意上面代码的缩进！

正如你所见的，上面的模板看上去跟这Python 文件很相似，以def with 语句开始，但在关键字前需要添加”$“。

注意：在模板内的变量，如果包含有HTML 标记，以$ 方式引用变量的话，HTML 标记只会以纯文本的显示出来。要想HTML 标记产生效果，可以用$: 引用变量。

现在，回到code.py 文件，在”import web” 的下一行添加：

render = web.template.render('templates/')

这告诉web.py 在哪里可以搜索得到模板目录。

提示：可在render 调用里添加cache = False 使得每次访问页面时都重载模板。

下面继续修改code.py 文件的GET 方法：

def GET(self):
    name = 'Bob'
    print render.index(name)

上面的”index“ 是模板的名字，”name“ 是传递过去的参数。

修改code.py 文件的urls 变量：

urls=(
    '/(.*)', 'index')

上面的“/(.*)” 是一个正则表达式。

再将GET 方法修改如下：

def GET(self,name):
    print render.index(name)

现在，访问”/“的话，会显示”Hello, world!“；访问”/Joe“ 的话，会显示”I just want to say hello to Joe“。

如果你想学习更多关于web.py templates 的话，可以访问templetor page。

5. 数据库

注意：在你开始连接数据库之前，请先安装正确的数据库驱动。例如，MySQL 使用MySALdb，Postgre 使用psycopg2。

添加以下代码，则可以正确配置你的数据库：

web.config.db_parameters = dict(
    dbn='postgres',
    user='username',
    pw='password',
    db='dbname'
)

现在，先行在数据库里创建一个简单的表：

CREATE TABLE todo (
  id serial primary key,
  title text,
  created timestamp default now(),
  done boolean default 'f'
);

初始化一行：

INSERT INTO todo (title) VALUES ('Learn web.py');

回到code.py，修改GET 方法如下：

def GET(self):
    todos = web.select('todo')
    print render.index(todos)

修改urls 变量：

urls = (
    '/', 'index')

重新编辑index.html 文件如下：

$def with (todos)
<ul>
$for todo in todos:
    <li id="t$todo.id">$todo.title</li>
</ul>

现在，可以访问”/“，如果显示”Learn web.py“，则祝贺你成功了！

现在，再让我们看看如何向数据库写入。

在index.html 文件的尾部添加如下内容：

<form method="post" action="add">
   <p>
       <input type="text" name="title" />
       <input type="submit" value="Add" />
   </p>
</form>

修改code.py 文件的urls 变量如下：

urls = (
    '/', 'index',
    '/add', 'add'
)

在code.py 里添加一个类：

class add:
    def POST(self):
        i = web.input()
        n = web.insert('todo', title=i.title)
        web.seeother('/')

web.input 使你能够方便地访问用户通过表单提交上来的变量。web.insert 用于向数据库的 “todo” 表插入数据，并且返回新插入行的ID。web.seeother 用于重转向到”/“。

提示：对于数据库的操作，还有web.transact()， web.commit()， web.rollback()，web.update()。

在web.py 里，还有web.input，web.query 和其它的函数，返回”Storage objects”，可以像字典型类(dictionaries) 的使用。

6. 总结

web.py 的确相当的小巧，应当归属于轻量级的web 框架。但这并不影响web.py 的强大，而且使用起来很简单、很直接。在实际应用上，web.py 更多的是学术上的价值，因为你可以看到更多web 应用的底层，这在当今“抽象得很好”的web 框架上是学不到的：）如果想了解更多web.py，可以访问web.py 的官方文档。

这篇教程到这里也要结束了，如果你对web.py 有兴趣，可以搜索更多关于web.py 的文档看看，你一定会发现更酷的东西。Have fun!

原文：http://rdc.hundsun.com/portal/article/703.html

=========================以下是本人安装遇到问题====================================

安装setup.py报错，缺少utils模块：

D:\web.py-0.38>python setup.py install

Traceback (most recent call last):

File "setup.py", line 6, in <module>

from web import __version__

File "D:\web.py-0.38\web\__init__.py", line 14, in <module>

import utils, db, net, wsgi, http, webapi, httpserver, debugerror

ModuleNotFoundError: No module named 'utils'

安装utils:

D:\web.py-0.38>pip3 install utils
Collecting utils
Downloading https://files.pythonhosted.org/packages/9b/de/9ffaf89be661b32d1e0cff05e1af5e4fc2d608c47498975e94aca219aed4/utils-0.9.0-py2.py3-none-any.whl
Installing collected packages: utils

Successfully installed utils-0.9.0

安装setup.py报错，缺少db模块：

D:\web.py-0.38>python setup.py install
Traceback (most recent call last):
File "setup.py", line 6, in <module>
from web import __version__
File "D:\web.py-0.38\web\__init__.py", line 14, in <module>
import utils, db, net, wsgi, http, webapi, httpserver, debugerror
ModuleNotFoundError: No module named 'db'

安装db模块：

D:\web.py-0.38>pip3 install db
Collecting db
Downloading https://files.pythonhosted.org/packages/a9/22/f65d64c83e63790b3273c6adb3bff338ad594f46d84b41bd1f94593b40a6/db-0.1.1.tar.gz
Collecting antiorm (from db)
Downloading https://files.pythonhosted.org/packages/0b/f8/71baa4824d9666c1be51d117119579a97f461ddbded48b2e01a6ad0554b5/antiorm-1.2.1.tar.gz (171kB)
100% |████████████████████████████████| 174kB 622kB/s
Building wheels for collected packages: db, antiorm
Running setup.py bdist_wheel for db ... done
Stored in directory: C:\Users\test_yinshuai\AppData\Local\pip\Cache\wheels\30\eb\ba\237fa002d1d1b2e73cedcefd26a9db37c4b72c7e5156ea0501
Running setup.py bdist_wheel for antiorm ... done
Stored in directory: C:\Users\test_yinshuai\AppData\Local\pip\Cache\wheels\b0\91\4d\f8fe808786ff1cda9e7e99e1b1bbda9196ab26786017965313
Successfully built db antiorm
Installing collected packages: antiorm, db
Successfully installed antiorm-1.2.1 db-0.1.1

安装setup.py提示missing parentheses in call to 'print'：我python3.6版本，webpy是2.x版本，下载最新版本https://github.com/webpy/webpy/tree/python3 （webpy-python3）
解压并切换到新目录，执行python web.py install,成功

简单而直接的Python web 框架：web.py

使用Python的Scrapy框架编写web爬虫的简单示例

简单介绍Python的轻便web框架Bottle

简单介绍Python下自己编写web框架的一些要点

Linux系统上Nginx+Python的web.py与Django框架环境