命令行金字塔¶
你的 Pyramid 可以使用各种命令行实用程序控制和检查应用程序。本章记录了这些实用程序。
我们通常将这个实用程序集合称为“p-scripts”,它是“金字塔控制台脚本”的缩写。
每个p-script的命令行使用详细信息在 p* 脚本文档 .
运行P脚本¶
所有的金字塔控制台脚本都可以运行:
以它的名字
作为python模块
奔跑 p*
脚本名称¶
金字塔的每个控制台脚本都可以按其名称运行。例如:
$VENV/bin/pserve development.ini --reload
备注
$VENV/bin/
是我们用来简化金字塔文档的惯例。它代表 bin
虚拟环境中的目录,其中 $VENV
是表示其路径的环境变量。见 安装 Pyramid 在UNIX系统上 和 Why use $VENV/bin/pip instead of source bin/activate, then pip 更多信息。
运行时对python使用自定义参数 p*
脚本¶
在 1.5 版本加入.
每个金字塔的控制台脚本 (pserve
, pviews
等等)可以使用 python3 -m
,允许在运行时将自定义参数发送到Python解释器。例如:
python3 -m pyramid.scripts.pserve development.ini --reload
pviews
:显示给定URL的匹配视图¶
参见
另见输出 pviews --help .
对于具有多个视图的大型应用程序,即使您自己定义了所有视图,也很难将视图配置详细信息保存在头脑中。你可以使用 pviews
命令在终端窗口中打印应用程序中给定URL的匹配路由和视图的摘要。这个 pviews
命令接受两个参数。第一个论点 pviews
是应用程序的路径 .ini
文件和节名 .ini
指向应用程序的文件。这应该是格式 config_file#section_name
. 第二个参数是要测试匹配视图的URL。这个 section_name
可以省略;如果是,则认为是 main
.
下面是使用 traversal :
1$VENV/bin/pviews development.ini#tutorial /FrontPage
2
3URL = /FrontPage
4
5 context: <tutorial.models.Page object at 0xa12536c>
6 view name:
7
8 View:
9 -----
10 tutorial.views.view_page
11 required permission = view
输出的顶部和底部总是有请求的URL,所有视图都与它们的视图配置详细信息匹配。在本例中,只有一个视图匹配,因此只有一个 View 部分。对于每个匹配视图,将显示关联视图可调用的完整代码路径,以及作为该视图配置一部分的任何权限和谓词。
更复杂的配置可能会生成如下内容:
1$VENV/bin/pviews development.ini#shootout /about
2
3URL = /about
4
5 context: <shootout.models.RootFactory object at 0xa56668c>
6 view name: about
7
8 Route:
9 ------
10 route name: about
11 route pattern: /about
12 route path: /about
13 subpath:
14 route predicates (request method = GET)
15
16 View:
17 -----
18 shootout.views.about_view
19 required permission = view
20 view predicates (request_param testing, header X/header)
21
22 Route:
23 ------
24 route name: about_post
25 route pattern: /about
26 route path: /about
27 subpath:
28 route predicates (request method = POST)
29
30 View:
31 -----
32 shootout.views.about_view_post
33 required permission = view
34 view predicates (request_param test)
35
36 View:
37 -----
38 shootout.views.about_view_post2
39 required permission = view
40 view predicates (request_param test2)
在这种情况下,我们要处理的是 URL dispatch 应用。此特定URL有两个匹配的路由。首先显示匹配的路由信息,然后显示与该路由关联的任何视图。从第二个匹配的路由输出中可以看到,一个路由可以与多个视图关联。
对于不匹配任何视图的URL, pviews
只需打印出 找不到 消息。
pshell
:交互式Shell¶
参见
另见输出 pshell --help .
一旦安装了用于开发的程序, pip install -e .
您可以使用交互式的python shell在python环境中执行表达式,与应用程序运行“for real”时使用的表达式完全相同。为此,请使用 pshell
命令行实用程序。
论点 pshell
遵循格式 config_file#section_name
在哪里? config_file
是应用程序的路径 .ini
文件和 section_name
是 app
中的节名称 .ini
指向应用程序的文件。例如,您的应用程序 .ini
文件可能有 [app:main]
看起来像这样的部分:
1[app:main]
2use = egg:MyProject
3pyramid.reload_templates = true
4pyramid.debug_authorization = false
5pyramid.debug_notfound = false
6pyramid.debug_templates = true
7pyramid.default_locale_name = en
如果是这样,则可以使用以下命令使用名称调用调试shell main
作为节名称:
$VENV/bin/pshell starter/development.ini#main
Python 2.6.5 (r265:79063, Apr 29 2010, 00:31:32)
[GCC 4.4.3] on linux2
Type "help" for more information.
Environment:
app The WSGI application.
registry Active Pyramid registry.
request Active request object.
root Root of the default resource tree.
root_factory Default root factory used to create `root`.
>>> root
<myproject.resources.MyResource object at 0x445270>
>>> registry
<Registry myproject>
>>> registry.settings['pyramid.debug_notfound']
False
>>> from myproject.views import my_view
>>> from pyramid.request import Request
>>> r = Request.blank('/')
>>> my_view(r)
{'project': 'myproject'}
加载的wsgi应用程序将作为 app
全球的。另外,如果加载的应用程序是 Pyramid 没有周围环境的应用程序 middleware , the root
默认返回的对象 root factory , registry
和 request
将可用。
你也可以简单地依靠 main
通过在文件名后省略任何哈希值来默认节名:
$VENV/bin/pshell starter/development.ini
出版社 Ctrl-D
退出交互shell(或 Ctrl-Z
在Windows上)。
延伸Shell¶
在使用交互式shell时,当您启动 pshell
. 为了促进这一点, pshell
会找个特别的 [pshell]
在你的章节 .ini
文件并将后续的键/值对公开给shell。每个键都是一个变量名,在pshell会话中是全局的;每个值都是一个 dotted Python name . 如果指定,则使用特殊键 setup
应该是 dotted Python name 指向接受将加载到shell中的全局字典的可调用文件。这允许每次执行某些自定义初始化代码时, pshell
运行。这个 setup
也可以从命令行使用 --setup
选项,它将覆盖 .ini
文件。
例如,您希望将模型与数据库会话一起公开给shell,以便在实际的数据库上改变模型。这里,我们假设您的模型存储在 myapp.models
包和您正在使用的 pyramid_tm
将请求上的事务管理器配置为 request.tm
.
1[pshell]
2setup = myapp.lib.pshell.setup
3models = myapp.models
通过定义 setup
可调用,我们将创建模块 myapp.lib.pshell
包含名为 setup
这将在全球环境暴露于Shell之前接受全球环境。在这里,我们改变了环境的请求,并添加了一个新的值,该值包含了应用程序的WebTest版本,我们可以轻松地向该版本提交请求。这个 setup
Callable也可以是一个生成器,它可以包装整个shell生命周期,在shell退出时执行代码。
1# myapp/lib/pshell.py
2from contextlib import suppress
3from transaction.interfaces import NoTransaction
4from webtest import TestApp
5
6def setup(env):
7 request = env['request']
8 request.host = 'www.example.com'
9 request.scheme = 'https'
10
11 env['testapp'] = TestApp(env['app'])
12
13 # start a transaction which can be used in the shell
14 request.tm.begin()
15
16 # if using the SQLAlchemy backend from our cookiecutter, the dbsession is
17 # connected to the transaction manager above
18 env['tm'] = request.tm
19 env['dbsession'] = request.dbsession
20 try:
21 yield
22
23 finally:
24 with suppress(NoTransaction):
25 request.tm.abort()
当这 .ini
文件已加载,额外变量 models
可立即使用。自从A setup
还指定了Callable,它被执行,并且有新的变量 testapp
, tm
和 dbsession
是公开的,请求被配置为从主机生成URL http://www.example.com
. 例如:
$VENV/bin/pshell starter/development.ini
Python 2.6.5 (r265:79063, Apr 29 2010, 00:31:32)
[GCC 4.4.3] on linux2
Type "help" for more information.
Environment:
app The WSGI application.
registry Active Pyramid registry.
request Active request object.
root Root of the default resource tree.
root_factory Default root factory used to create `root`.
testapp <webtest.TestApp object at ...>
Custom Variables:
dbsession
model myapp.models
tm
>>> testapp.get('/')
<200 OK text/html body='<!DOCTYPE...l>\n'/3337>
>>> request.route_url('home')
'https://www.example.com/'
>>> user = dbsession.query(models.User).get(1)
>>> user.name = 'Joe'
>>> tm.commit()
>>> tm.begin()
>>> user = dbsession.query(models.User).get(1)
>>> user.name == 'Joe'
'Joe'
替代Shell¶
这个 pshell
如果默认的python repl不令人满意,可以使用备用repl轻松地扩展命令。假设您安装了绑定,例如 pyramid_ipython
它通常是自动选择和使用的。您还可以使用 -p choice
或 --python-shell choice
选择权。
$VENV/bin/pshell -p ipython development.ini#MyProject
你可以使用 --list-shells
查看可用Shell的选项。
$VENV/bin/pshell --list-shells
Available shells:
bpython
ipython
python
如果要使用开箱即用不受支持的shell,可以通过在 setup.py
:
setup(
entry_points={
'pyramid.pshell_runner': [
'myshell=my_app:ptpython_shell_factory',
],
},
)
然后shell工厂应该返回一个接受两个参数的函数, env
和 help
,如下所示:
from ptpython.repl import embed
def ptpython_shell_runner(env, help):
print(help)
return embed(locals=env)
在 1.6 版本发生变更: 用户定义的shell可以使用入口点注册。在此之前,唯一支持的Shell是 ipython
, bpython
和 python
.
ipython
和 bpython
已经被转移到各自的包裹中 pyramid_ipython
和 pyramid_bpython
.
设置默认Shell¶
你可以使用 default_shell
你的选择 [pshell]
指定首选Shell列表的ini部分。
1[pshell]
2default_shell = ptpython ipython bpython
在 1.6 版本加入.
proutes
:显示所有应用程序路由¶
参见
另见输出 proutes --help .
你可以使用 proutes
命令在终端窗口中打印与应用程序相关的路由摘要。很像 pshell
命令(见) pshell :交互式Shell ) proutes
命令接受一个格式为的参数 config_file#section_name
. 这个 config_file
是应用程序的路径 .ini
文件,以及 section_name
是 app
中的节名称 .ini
指向应用程序的文件。默认情况下, section_name
是 main
可以省略。
例如:
1$VENV/bin/proutes development.ini
2Name Pattern View Method
3---- ------- ---- ------
4debugtoolbar /_debug_toolbar/*subpath <wsgiapp> *
5__static/ /static/*subpath dummy_starter:static/ *
6__static2/ /static2/*subpath /var/www/static/ *
7__pdt_images/ /pdt_images/*subpath pyramid_debugtoolbar:static/img/ *
8a / <unknown> *
9no_view_attached / <unknown> *
10route_and_view_attached / app1.standard_views.route_and_view_attached *
11method_conflicts /conflicts app1.standard_conflicts <route mismatch>
12multiview /multiview app1.standard_views.multiview GET,PATCH
13not_post /not_post app1.standard_views.multiview !POST,*
proutes
生成具有四列的表: Name , 模式 , View 和 方法 . “名称”列中列出的项是路由名称,“模式”列中列出的项是路由模式,“视图”列中列出的项是当请求与关联的路由模式匹配时将调用的视图可调用的表示,而“方法”列中列出的项是关联的请求方法使用路由名称。视图列可能显示 <unknown>
如果找不到可调用的关联视图。路由名称的“方法”列可以显示 <route mismatch>
如果视图可调用不接受路由的任何请求方法,或者 *
如果视图可调用将接受路由的任何请求方法。如果应用程序中没有配置路由,则当 proutes
执行。
使用时很方便 proutes
命令通常用于配置要查看的列及其顺序。为了促进这一点, proutes
会找个特别的 [proutes]
在你的章节 .ini
文件并将其用作默认值。
例如,您可以删除请求方法并首先放置视图:
1[proutes]
2format = view
3 name
4 pattern
还可以使用逗号或空格分隔格式:
1[proutes]
2format = view name pattern
3
4[proutes]
5format = view, name, pattern
如果要临时配置列和顺序,则存在参数 --format
,这是要包含的列的逗号分隔列表。当前可用的格式为 name
, pattern
, view
和 method
.
ptweens
:显示“Tweens”¶
参见
另见输出 ptweens --help .
A tween 是位于主金字塔应用程序请求处理程序和调用它的wsgi应用程序之间的一点代码。用户可以获取隐式tween排序(调用指定的排序)的表示形式。 pyramid.config.Configurator.add_tween()
)以及明确的tween顺序(由 pyramid.tweens
配置设置)使用 ptweens
命令。Tween工厂将在 ptweens
输出。
例如,这里是 ptweens
命令在没有任何显式tweens的情况下针对配置的系统运行:
1$VENV/bin/ptweens development.ini
2"pyramid.tweens" config value NOT set (implicitly ordered tweens used)
3
4Implicit Tween Chain
5
6Position Name Alias
7-------- ---- -----
8- - INGRESS
90 pyramid_debugtoolbar.toolbar.toolbar_tween_factory pdbt
101 pyramid.tweens.excview_tween_factory excview
11- - MAIN
这里是 ptweens
针对配置的系统运行命令 with 在ITS中定义的显式tweens development.ini
文件:
1$VENV/bin/ptweens development.ini
2"pyramid.tweens" config value set (explicitly ordered tweens used)
3
4Explicit Tween Chain (used)
5
6Position Name
7-------- ----
8- INGRESS
90 starter.tween_factory2
101 starter.tween_factory1
112 pyramid.tweens.excview_tween_factory
12- MAIN
13
14Implicit Tween Chain (not used)
15
16Position Name
17-------- ----
18- INGRESS
190 pyramid_debugtoolbar.toolbar.toolbar_tween_factory
201 pyramid.tweens.excview_tween_factory
21- MAIN
以下是 development.ini
以上使用 ptweens
报告使用了显式tween链的命令:
1[app:main]
2use = egg:starter
3reload_templates = true
4debug_authorization = false
5debug_notfound = false
6debug_routematch = false
7debug_templates = true
8default_locale_name = en
9pyramid.include = pyramid_debugtoolbar
10pyramid.tweens = starter.tween_factory2
11 starter.tween_factory1
12 pyramid.tweens.excview_tween_factory
见 登记吐温 有关Tweens的更多信息。
prequest
:调用请求¶
参见
另见输出 prequest --help .
你可以使用 prequest
命令行实用程序,用于在不启动服务器的情况下向应用程序发送请求并查看响应正文。
有两个必需的参数 prequest
:
配置文件/节:遵循格式
config_file#section_name
在哪里config_file
是应用程序的路径.ini
文件和section_name
是app
中的节名称.ini
文件。这个section_name
是可选的;默认为main
. 例如:development.ini
.路径:这应该是要在服务器上呈现的资源的URL的非URL引用的路径元素。例如,
/
.
例如:
$VENV/bin/prequest development.ini /
这将把响应的主体打印到调用它的控制台上。
支持多种选项 prequest
. 这些应该在任何配置文件名或url之前。
prequest
有一个 -d
(即, --display-headers
)选项,打印输出前服务器返回的状态和头:
$VENV/bin/prequest -d development.ini /
这将打印控制台响应的状态、标题和正文。
您可以使用 --header
选项:
$VENV/bin/prequest --header=Host:example.com development.ini /
通过将头文件转换为其CGI/WSGI等效文件(例如, Host=example.com
将插入 HTTP_HOST
标题变量作为值 example.com
)倍数 --header
可以提供选项。特殊标题值 content-type
设置 CONTENT_TYPE
在wsgi环境中。
默认情况下, prequest
发送一个 GET
请求。您可以使用 -m
(阿卡 --method
选择权。 GET
, HEAD
, POST
和 DELETE
当前支持。当你使用 POST
,的标准输入 prequest
进程用作 POST
身体:
$VENV/bin/prequest -mPOST development.ini / < somefile
pdistreport
:显示所有已安装的发行版及其版本¶
在 1.5 版本加入.
参见
另见输出 pdistreport --help .
你可以使用 pdistreport
命令显示 Pyramid 使用中的版本、使用中的python版本以及在您的python环境中安装的所有python发行版:
$VENV/bin/pdistreport
Pyramid version: 1.5dev
Platform Linux-3.2.0-51-generic-x86_64-with-debian-wheezy-sid
Packages:
authapp 0.0
/home/chrism/projects/foo/src/authapp
beautifulsoup4 4.1.3
/home/chrism/projects/foo/lib/python2.7/site-packages/beautifulsoup4-4.1.3-py2.7.egg
# ... more output ...
pdistreport
没有选择。当您遇到问题并且需要比您的环境更熟悉Python打包和分发的人时,它的输出对于粘贴到Pastebin非常有用。
写剧本¶
所有Web应用程序的核心都是接受请求并返回响应的系统。当一个请求被 Pyramid 应用程序,系统从请求接收状态,该状态稍后将被应用程序代码所依赖。例如,一个 view callable 可能会假设它是针对一个具有 request.matchdict
一个特定的构图,而另一个则假定matchdict的构图不同。
同时,可以方便地编写“在金字塔环境中”工作的python脚本,例如更新 Pyramid 应用。但是,“真实的”金字塔环境没有完全独立于请求的静态状态;您的应用程序(以及金字塔本身)几乎总是依赖于能够从请求中获取信息。当运行一个只从应用程序导入代码并尝试运行它的python脚本时,就没有请求数据,因为没有任何真正的web请求。因此,应用程序的某些部分和一些金字塔API将无法工作。
因此, Pyramid 使在类似于特定环境的环境中运行脚本成为可能 request 到达你 Pyramid 应用。这是通过使用 pyramid.paster.bootstrap()
脚本主体中的命令。
在 1.1 版本加入: pyramid.paster.bootstrap()
在 1.8 版本发生变更: 增加了 bootstrap
通过自动清除 with
语句。
在最简单的情况下, pyramid.paster.bootstrap()
可与单个参数一起使用,该参数接受 PasteDeploy .ini
将金字塔应用程序的配置表示为单个参数的文件:
from pyramid.paster import bootstrap
with bootstrap('/path/to/my/development.ini') as env:
print(env['request'].route_url('home'))
pyramid.paster.bootstrap()
返回包含框架相关信息的字典。此词典将始终包含 request 对象作为其 request
关键。
以下键在中可用 env
词典返回者 pyramid.paster.bootstrap()
:
请求
A
pyramid.request.Request
对象,表示脚本的当前请求状态。
应用程序
这个 WSGI 由引导生成的应用程序对象。
根
这个 resource 你的根 Pyramid 应用。这是由 root factory 在应用程序中配置。
登记处
这个 application registry 你的 Pyramid 应用。
更接近
可用于弹出内部 Pyramid 线程本地堆栈(由
pyramid.threadlocal.get_current_registry()
和pyramid.threadlocal.get_current_request()
)当脚本编写工作完成时。
假设 /path/to/my/development.ini
上面示例中使用的文件如下所示:
[pipeline:main]
pipeline = translogger
another
[filter:translogger]
filter_app_factory = egg:Paste#translogger
setup_console_handler = False
logger_name = wsgi
[app:another]
use = egg:MyProject
上述引导程序示例加载的配置将使用 [pipeline:main]
默认情况下配置文件的部分。指定 /path/to/my/development.ini
逻辑上等同于指定 /path/to/my/development.ini#main
. 在这种情况下,我们将使用包含 app
包裹在粘贴“translogger”中的对象 middleware (将请求记录到控制台)。
您还可以指定一个特定的 部分 在PasteDeploy .ini
要加载的文件,而不是 main
:
from pyramid.paster import bootstrap
with bootstrap('/path/to/my/development.ini#another') as env:
print(env['request'].route_url('home'))
上面的示例指定 another
app
, pipeline
或 composite
PasteDeploy配置文件的部分。这个 app
对象存在于 env
词典返回者 pyramid.paster.bootstrap()
将是 Pyramid router .
更改请求¶
默认情况下,金字塔将在 env
URL字典 http://localhost:80/
. 这意味着在脚本执行期间由金字塔生成的任何URL都将锚定在这里。这通常不是你想要的。
那么我们如何使金字塔生成正确的URL呢?
假设您在应用程序中配置了类似这样的路由:
config.add_route('verify', '/verify/{code}')
您需要通知金字塔环境,WSGi应用程序正在处理来自特定基础的请求。例如,我们想模拟在 https://example.com/prefix ,以确保生成的URL对于我们的部署是正确的。这可以通过改变产生的请求对象来实现,或者更简单地通过构造所需的请求并将其传递到 bootstrap()
:
from pyramid.paster import bootstrap
from pyramid.request import Request
request = Request.blank('/', base_url='https://example.com/prefix')
with bootstrap('/path/to/my/development.ini#another', request=request) as env:
print(env['request'].application_url)
# will print 'https://example.com/prefix'
现在,您可以轻松地使用金字塔的API来生成URL:
env['request'].route_url('verify', code='1337')
# will return 'https://example.com/prefix/verify/1337'
清理¶
如果你在使用 with
-语句变量则无需担心。但是,如果直接使用返回的环境,那么当脚本逻辑完成时,调用 closer
回调:
from pyramid.paster import bootstrap
env = bootstrap('/path/to/my/development.ini')
# .. do stuff ...
env['closer']()
设置日志记录¶
默认情况下, pyramid.paster.bootstrap()
不配置配置文件中存在的日志参数。如果要根据配置日志记录 [logger]
以及配置文件中的相关部分,使用以下命令:
import pyramid.paster
pyramid.paster.setup_logging('/path/to/my/development.ini')
见 登录 有关在中登录的详细信息 Pyramid .
将脚本制作成控制台脚本¶
“控制台脚本”是 Setuptools 安装到 bin
python目录 virtual environment (或“基本”python环境)当 distribution 安装脚本的位置。因为它安装在 bin
虚拟环境的目录安装分发后,它是一种方便的打包和分发功能的方法,您可以从命令行调用这些功能。创建控制台脚本通常比创建 .py
编写脚本并指导人们使用“正确的”Python解释器来调用它。控制台脚本生成的文件 bin
当它被调用时,它将始终使用“正确的”python环境,这意味着它将总是在一个环境中被调用,在这个环境中它所需要的所有库(如pyramid)都可用。
通常,您可以通过执行以下操作将脚本生成控制台脚本:
使用现有分发(例如,您已经通过
cookiecutter
)或者创建至少具有一个包或模块的新分发。它应该在发行版中的任何模块中包含一个不带参数的可调用(通常是一个函数),并且运行您希望运行的任何代码。添加
[console_scripts]
截面到entry_points
分发的参数,该参数在脚本名和表示添加到分发中的可调用项的点名称之间创建映射。跑
pip install -e .
或pip install .
重新安装您的发行版。重新安装分发时,表示在最后一步中命名的脚本的文件将位于bin
安装分发的虚拟环境的目录。它将是可执行的。从终端调用它将执行调用。
作为一个例子,让我们创建一些代码,这些代码可以由一个控制台脚本调用,该脚本打印金字塔应用程序的部署设置。为此,我们将假装您有一个分发包,其中包含一个名为 myproject
. 在这个包中,我们将假装您添加了 scripts.py
包含以下代码的模块:
1# myproject.scripts module
2
3import optparse
4import sys
5import textwrap
6
7from pyramid.paster import bootstrap
8
9def settings_show():
10 description = """\
11 Print the deployment settings for a Pyramid application. Example:
12 'show_settings deployment.ini'
13 """
14 usage = "usage: %prog config_uri"
15 parser = optparse.OptionParser(
16 usage=usage,
17 description=textwrap.dedent(description)
18 )
19 parser.add_option(
20 '-o', '--omit',
21 dest='omit',
22 metavar='PREFIX',
23 type='string',
24 action='append',
25 help=("Omit settings which start with PREFIX (you can use this "
26 "option multiple times)")
27 )
28
29 options, args = parser.parse_args(sys.argv[1:])
30 if not len(args) >= 1:
31 print('You must provide at least one argument')
32 return 2
33 config_uri = args[0]
34 omit = options.omit
35 if omit is None:
36 omit = []
37 with bootstrap(config_uri) as env:
38 settings = env['registry'].settings
39 for k, v in settings.items():
40 if any([k.startswith(x) for x in omit]):
41 continue
42 print('%-40s %-20s' % (k, v))
此脚本使用python optparse
模块,使我们能够理解传递给脚本的额外参数。它使用 pyramid.paster.bootstrap()
函数获取由配置文件定义的应用程序的信息,并打印在该配置文件中定义的部署设置。
将此脚本添加到包后,您需要告诉分发的 setup.py
关于它的存在。在发行版的顶级目录中, setup.py
文件将如下所示:
1import os
2
3from setuptools import setup, find_packages
4
5here = os.path.abspath(os.path.dirname(__file__))
6with open(os.path.join(here, 'README.txt')) as f:
7 README = f.read()
8with open(os.path.join(here, 'CHANGES.txt')) as f:
9 CHANGES = f.read()
10
11requires = ['pyramid', 'pyramid_debugtoolbar']
12
13tests_require = [
14 'WebTest',
15 'pytest',
16 'pytest-cov',
17]
18
19setup(name='MyProject',
20 version='0.0',
21 description='My project',
22 long_description=README + '\n\n' + CHANGES,
23 classifiers=[
24 "Programming Language :: Python",
25 "Framework :: Pyramid",
26 "Topic :: Internet :: WWW/HTTP",
27 "Topic :: Internet :: WWW/HTTP :: WSGI :: Application",
28 ],
29 author='',
30 author_email='',
31 url='',
32 keywords='web pyramid pylons',
33 packages=find_packages(exclude=['tests']),
34 include_package_data=True,
35 zip_safe=False,
36 install_requires=requires,
37 extras_require={
38 'testing': tests_require,
39 },
40 entry_points = """\
41 [paste.app_factory]
42 main = myproject:main
43 """,
44 )
我们要改变 setup.py
添加文件 [console_scripts]
段内的 entry_points
字符串。在本节中,应指定 scriptname = dotted.path.to:yourfunction
线。例如:
[console_scripts]
show_settings = myproject.scripts:settings_show
这个 show_settings
name will be the name of the script that is installed into bin
. The colon (:
) between `` myproject.scripts``和 settings_show
上面表示 myproject.scripts
是一个python模块,并且 settings_show
是该模块中的函数,其中包含您希望作为调用 show_settings
从命令行编写脚本。
结果是:
1import os
2
3from setuptools import setup, find_packages
4
5here = os.path.abspath(os.path.dirname(__file__))
6with open(os.path.join(here, 'README.txt')) as f:
7 README = f.read()
8with open(os.path.join(here, 'CHANGES.txt')) as f:
9 CHANGES = f.read()
10
11requires = ['pyramid', 'pyramid_debugtoolbar']
12
13tests_require = [
14 'WebTest',
15 'pytest',
16 'pytest-cov',
17]
18
19setup(name='MyProject',
20 version='0.0',
21 description='My project',
22 long_description=README + '\n\n' + CHANGES,
23 classifiers=[
24 "Programming Language :: Python",
25 "Framework :: Pyramid",
26 "Topic :: Internet :: WWW/HTTP",
27 "Topic :: Internet :: WWW/HTTP :: WSGI :: Application",
28 ],
29 author='',
30 author_email='',
31 url='',
32 keywords='web pyramid pylons',
33 packages=find_packages(),
34 include_package_data=True,
35 zip_safe=False,
36 install_requires=requires,
37 extras_require={
38 'testing': tests_require,
39 },
40 entry_points = """\
41 [paste.app_factory]
42 main = myproject:main
43 [console_scripts]
44 show_settings = myproject.scripts:settings_show
45 """,
46)
一旦你这样做了,调用 $VENV/bin/pip install -e .
将安装名为的文件 show_settings
进入 $somevenv/bin
目录中有一小段指向入口点的python代码。它将是可执行的。不带任何参数运行它将打印一个错误并退出。使用配置文件路径的单个参数运行它将打印设置。用一个 --omit=foo
参数将省略以键开头的设置 foo
. 使用两个“省略”选项运行它(例如, --omit=foo --omit=bar
)将忽略所有具有以任一项开头的键的设置 foo
或 bar
:
$VENV/bin/show_settings development.ini --omit=pyramid --omit=debugtoolbar
debug_routematch False
debug_templates True
reload_templates True
mako.directories []
debug_notfound False
default_locale_name en
reload_resources False
debug_authorization False
reload_assets False
prevent_http_cache False
皮拉米德 pserve
, pshell
, prequest
, ptweens
等 p*
脚本作为控制台脚本实现。当您调用其中一个脚本时,您使用的是控制台脚本。