转自:http://blog.csdn.net/xiangmin2587/article/details/8203503
http://pythonpaste.org/deploy/
帮助文档http://pythonpaste.org/deploy/module-paste.deploy.html
Paste Deployment是用于发现和配置WSGI appliaction和server的系统。对于WSGI application用户提供一个单独的简单的函数(loadapp),用于从配置文件或者python egg中加载WSGI application。因为WSGI application提供了唯一的单独简单的访问入口,所以application 发布者并不需要暴露application的内部的实现细节。
那么系统管理员可在不了解任何python知识或者WSGI Application或者WSGI container的情况下进行安装和管理。Paste Deployment目前已经不需要Paste项目的其他部分支持,可以单独做一个package进行使用。Paste Deploy的发布在MIT license。
Paste Deploy目前已经通过了V1.0。
必须注意的地方: Paste Deploy 最关键的地方是入口点【 entry points】 (例如, paste.app_factory (入口点是 python 项目发布时定义的,并且会指定发布的程序的入口点符合的 protocal的种类,后面会有介绍 并不是这些入口点唯一的使用者,很多扩展可能直接去使用这些入口点,这样做可能比通过 Paste Deploy 使用更好。入口点是不能发生变化的,如果改变是必须的话,只能定义新的入口点。可以使用Paste Deployment用于加载WSGI的应用,大多数的Python框架都支持WSGI。主要的函数是paste.deploy.loadapp,基本使用方法如下:
目前支持两种URI模式config:和egg:
1.1.1.1. config:URIs
config:URIs——URI表示配置文件(不同于3.3.1节的配置文件,此处的配置文件是用于指示,所需要加载的application是哪些)的位置
配置文件的格式:
[section_name]
key = value
another key = a long value
that extends over multiple lines
所有的value都是string类型,key和section name都是大小写敏感的,并且可以包含标点符号和空白符,但是头部和尾部的空白部分将会去掉。
如果出现需要断行的情况,只需要在下一行开始时是空白符即可
#和;表示注释。
配置文件中可能会定义多个application,定义方式如下:
application定义
在一个文件中可以定义多个application,每个application都应该有自己独立的section,即使仅有一个application存在,也需要写入到section中。
每个定义一个application的section都应该以app:前缀开头。main section进入[app:main]或[app]
指定运行application的Python code方式有两种:
第一种方法,指向其他的URI(前两个section)或name(后两个section)
[app:myapp]
use = config:another_config_file.ini#app_name
#调用其他的配置文件(可能定义了多个应用程序),并需要执行的应用程序的名称
# or any URI:
[app:myotherapp]
use = egg:MyApp
# or a callable from a module:
[app:mythirdapp]
use = call:my.project:myapplication
# or even another section:
[app:mylastapp]
use = myotherapp
Configuration
配置了use字段或者通过协议名称(上面提到的两种方法),就完成了配置文件最基本的配置,section中其他的key都会作为关键字参数传递给factory。下面看一个例子:
[app:blog]
use = egg:MyBlog
database = mysql://localhost/blogdb
blogname = This Is My Blog!
定义了一个application,名字为blog,运行的程序是MyBlog(他是一个egg),需要传递给MyBlog的参数是database和blogname。
这里有个比较有趣的例子,我们可以再定义另外一个section去覆盖上面的配置,如下:
[app:otherblog]
use = blog
blogname = The other face of my blog
“use = blog”表明使用的应用程序是section blog;
但是传递的参数是:blogname = The other face of my blog,覆盖掉了section blog的对应的配置信息。这种设置方式也可以定义在普通的配置文件中,即使用use = config:other_config_file 这种方式进行。
这种方式看起来好像是没什么意义的,只是从一个位置指向另一个位置,而实际上这对于增添和更新application是非常有效的。
Global Configuration
当多个application需要共享相同的配置时,我们可以采用上述的方法,使用其他的section,如果想要不同的value值,则重新定义覆盖掉它。但是这种方法,不能够添加其他的配置参数,即只能覆盖掉use的section中已经定义的部分。
所以可以采用[DEFUALT]方法定义全局的配置信息,[DEFUALT]的配置信息将会全部传入到所有的Application中,通常情况下,也可作为application的默认设置。application可以自主定义覆盖全局的默认值
为免去对所有application配置全局共享信息的麻烦可以使用[DEUALT]section,注意DEFUALT是大小写敏感的。
[DEFAULT]
admin_email = webmaster@example.com
[app:main]
use = ...
set admin_email = bob@example.com
set关键字使用,将会覆盖掉global的对应的配置。
第二种方法,精确定义application需要运行的Python code
[app:myapp]
paste.app_factory = myapp.modulename:app_factory
这种方式必须明确指定使用的protocol(此例中是paste.app_factory),value值表示需要import的内容。此例中是import myapp.modulename,然后检测app_factory执行
application的其他类型:composition application
composition application:类似与application,但是他是由多个application组成的,一个简单的例子就是URL mapper,例如,
[composite:main]
use = egg:Paste#urlmap
/ = mainapp
/files = staticapp
[app:mainapp]
use = egg:MyApp
[app:staticapp]
use = egg:Paste#static
document_root = /path/to/docroot
使用loadapp加载composition application, “main” 看起来就是和其他应用程序相同的,仅是一个application,但是根据配置文件的设置,“main”是可以访问其他的application的。
filter composition
可以采用不同的方式将filter应用到application中,通常情况下依赖于需要使用多少个filter和使用filter的顺序。
第一种方法:filter-with设置
[app:main]
use = egg:MyEgg
filter-with = printdebug
[filter:printdebug]
use = egg:Paste#printdebug
# and you could have another filter-with here, and so on...
另一种方法:filter-app pipeline
此外,还有两个特殊的section可以添加filter到application中去:[filter-app:…] [pipeline:…]
filter-app:定义一个filter,并且使用一个特殊的关键字next指向application,将application添加到filter中(这与[filter:…]很类似)
pipeline:当需要定义一系列的fiter时应用。在configuration中添加关键字pipeline,pipeline是一个filters的链表,以一个application结束,例如
[pipeline:main]
pipeline = filter1 egg:FilterEgg#filter2 filter3 app
[filter:filter1]
...
注:参考博文http://blog.csdn.net/sonicatnoc/article/details/6539716
里面描述filter调用的顺序,其实是一个嵌套的过程,调用的过程是不断的返回
filter1->filter2->filter3->……->end_app
执行的时候是
end_app->……->filter3->filter2->filter1
1.1.1.1. 配置文件简单例子与Paste Deploy交互的主要方式是通过配置文件,一个非常简单配置文件的例子如下:
[app:main]
use = egg:PasteEnabledPackage
option1 = foo
option2 = bar
[server:main]
use = egg:PasteScript#wsgiutils
host = 127.0.0.1
port = 80
每个[]表示一个section,彼此间是独立的。
[type:name]
如[app:main],Paste Deploy认为是一个名字为main的application。
配置文件的内容都是以“name=value”的形式进行表示的,如果有多个value,那么就表示为“ name = value1#value2#value3”类似的模式。
[app:main]:appliction section
[server:main]:server section
[composite:…]用于调度多个application,compostion是复合的意思
use = egg:PasteEnabledPackage
表示名为PasteEnabledPackage的Package将被运行,这个Package的格式是egg的格式。而后面的字段,将作为关键字参数传递给PastEnablePackage
第2个section:[server:main],名为main的server
use = egg:PasteScript#wsgiutils
表示使用发布的egg文件PasteScript中的wsgiutils程序
官网上的例子
[composite:main]
use = egg:Paste#urlmap
/ = home
/blog = blog
/wiki = wiki
/cms = config:cms.ini
[app:home]
use = egg:Paste#static
document_root = %(here)s/htdocs
[filter-app:blog]
use = egg:Authentication#auth
next = blogapp
roles = admin
htpasswd = /home/me/users.htpasswd
[app:blogapp]
use = egg:BlogApp
database = sqlite:/home/me/blog.db
[app:wiki]
use = call:mywiki.main:application
database = sqlite:/home/me/wiki.db
先看[composite:main]section,这是一个composite类型的section,意味着将会调度请求到其他的application中去。use = egg:Paste#urlmap,表明使用的compostite Appliaciton是Paste.urlmap。urlmap是一个特殊的composite application,它可以根据请求的前缀,调度到其他的application中去。如配置文件中所示
[composite:main]
use = egg:Paste#urlmap
/ = home #请求前缀“/”转去home application
/blog = blog #请求前缀“/blog”转去blog application
/wiki = wiki #请求前缀“/wiki”转去wiki application
/cms = config:cms.ini # just refers to another file cms.ini in the same directory.
[app:home]section
[app:home]
use = egg:Paste#static
document_root = %(here)s/htdocs
其他部分
[filter-app:blog]
use = egg:Authentication#auth
next = blogapp
roles = admin
htpasswd = /home/me/users.htpasswd
[app:blogapp]
use = egg:BlogApp
database = sqlite:/home/me/blog.db
[app:wiki]
[app:wiki]
use = call:mywiki.main:application
database = sqlite:/home/me/wiki.db
1.1.1.2. egg: URIs
Python Egg是使用setuptools发布和安装形式,并且将metadata添加到普通的Python package
对于egg有两个重要的地方:
第一,specificaition——name关键字指定egg 的名字,并且能够指定egg的版本号
第二,entry point —— 指向了你创建的packages的Python Object,并且指明Protocol的具体类型。
以swift的setup.py为例:protocol是paste.app_factory,包含的应用程序名称是proxy、object、container、account,你可以通过egg:egg名字#应用程序名字获取应用程序服务,以swift为例
name=’swift’
那么object应用程序的URI表示为egg:swift#object
value是导入objects的命令,主入口函数在swift.obj.server的app_factory函数
SHAPE \* MERGEFORMAT
entry_points={ 'paste.app_factory': [ 'proxy=swift.proxy.server:app_factory', 'object=swift.obj.server:app_factory', 'container=swift.container.server:app_factory', 'account=swift.account.server:app_factory', ], 是一个callable object是在ini文件中default section中定义的一系列key-value对,而**kwargs,即一些本地配置,是在ini文件中,filter:xxx section中定义的一系列key-value对。filter_factory<span times="" new="" roman";="" mso-hansi-font-family:"times="" roman";mso-bidi-font-family:"times="" mso-font-kerning:1.0pt;mso-ansi-language:en-us;mso-fareast-language:zh-cn;="" mso-bidi-language:ar-sa"="" style="word-wrap: break-word; line-height: 1.5; font-size: 10.5pt; font-family: 宋体;">返回一个filter对象 |