簡單而直接的Python web 框架:web.py

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.inputweb.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,成功

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章