Rhetoric 0.2.3

为什么值得你花点时间

关于金字塔路由子系统为何如此方便 网络开发人员- Pyramid view configuration: Let me count the ways。

作为一个使用金字塔作为他宠物项目的基础的人，Django在工作中， 我（作者）很有机会比较了两种不同的路由配置方法 由这些框架提供。我完全同意文章的要点-金字塔路线 对于编写REST服务的开发者来说更为灵活和方便。

项目经营场所

• 修辞成分尽量遵循相应的金字塔成分。
• 与Django应用程序的集成在任何可能的情况下对现有代码都是透明的。
• 修辞学url调度器的性能比金字塔调度器差，原因是 实现的天真性和与django api的兼容性带来的限制。

安装

修辞学作为PYPI软件包提供：

$ pip install Rhetoric

包装应与python2.7和python3.3或更高版本兼容。

与django的集成

1. 将django.middleware.csrf.CsrfViewMiddleware替换为 rhetoric.middleware.CsrfProtectedViewDispatchMiddleware在项目的MIDDLEWARE_CLASSES：

   # somewhere in a project_name.settings moduleMIDDLEWARE_CLASSES=[# ...'rhetoric.middleware.CsrfProtectedViewDispatchMiddleware',#'django.middleware.csrf.CsrfViewMiddleware',# ...]

2. 在项目的root urlconf内部 （通常是project_name.urls）：

   fromdjango.conf.urlsimportpatterns,include,url# ... other imports ...fromrhetoricimportConfigurator# ... various definitions ...urlpatterns=patterns('',# ... a number of standard django url definitions ...)# Rhetorical routing# ------------------config=Configurator()config.add_route('test.new.routes','/test/new/routes/{param:[a-z]+}')config.scan(ignore=[# do not scan test modules included into the project treere.compile('^.*[.]?tests[.]?.*$').match,# do not scan settings modulesre.compile('^project_name.settings[_]?[_a-z09]*$').match,])urlpatterns.extend(config.django_urls())

3. 注册视图：

   # project_name.some_app.some_modulefromrhetoricimportview_config@view_config(route_name="test.new.routes",renderer='json')defview_get(request,param):return{'Hello':param}@view_config(route_name="test.new.routes",renderer='json',request_method='POST')defview_post(request,param):return{'Hello':'POST'}

4. 从这里开始，您可以使用不同的方法请求/test/new/routes/<param>。

文件

请参见http://rhetoric.readthedocs.org/上的完整文档