跳转到主要内容

templer工具的核心功能

项目描述

简介

此软件包提供了templer代码生成系统的核心功能。包括基本模板类、实用脚本、templer命令行包装器和基本模板,用于基本的python命名空间软件包和嵌套命名空间软件包。

templer系统的所有功能都继承并扩展自PasteScript模板。可以使用该软件包的语法生成模板,但templer系统提供包装脚本,以便开发者更容易生成软件包。

templer脚本

本包提供了一个脚本 templer。该脚本作为 PasteScript 的 paster create 命令的包装器,隐藏了该命令新手容易出错的语法。此外,templer 脚本还提供了对项目名称和其他变量的行内错误检查以及额外的帮助。建议使用此脚本(尤其是对于新用户)而不是直接使用 paster create。不过,产生的包将是相同的。

例如,要创建一个新的基本命名空间包,可以按如下方式调用脚本

templer basic_namespace

这将提示您为您的包提供名称。您提供的名称将经过验证,以确保它符合您选择的模板所期望的命名空间数量。

一旦您为您的新包设置了名称,您将被要求选择要回答的问题集。默认情况下,只选择了“简单”问题,允许您以最少交互创建新包。但是,您可以选择“专家”集,或者选择回答 所有 问题,如果您需要更多地控制包的最终输出。

在任何时候,您都可以在提示符下键入 ? 来接收当前问题的行内帮助。

如果您想在任何时间退出问题过程,只需在提示符下输入 q 即可。

附加脚本功能

除了交互式生成代码外,templer 脚本还提供了一些其他有用的功能

templer --help

提供 templer 脚本的帮助文本的完整列表。

templer --list

提供了可用的模板的详细列表。

templer --version

提供当前安装的 templer 包的版本号。

测试

此包提供了代码功能的单元测试以及每个提供的模板的 doctests。如果您对包进行了更改,您必须在提交之前确保这些测试运行成功。请也为您创建的任何代码贡献测试。要运行测试,请执行以下命令

$ python setup.py test

贡献者

  • Cris Ewing,原始作者

  • Lazaro Clapp

  • Hector Velarde

基于 zopeskel 的代码,其贡献者包括

  • Daniel Nouri

  • Tarek Ziadé

  • Mustapha Benali

  • Sylvain Viollon

  • Alan Hoey

  • Josh Johnson

  • Emanuel Sartor

  • Matthew Wilkes

  • Joel Burton

  • Cris Ewing

  • Chris Calloway

  • Chris Rossi

变更日志

1.0b4 2012年5月17日

  • 重构测试设置代码以更好地跨包共享 [cewing]

  • 修复了测试设置中由于使用 os.getcwd() 混合 doc 和非 doc 测试而暴露的 bug [cewing]

  • 修复了打包问题并标准化 setup.py [hvelarde]

  • 转换为 unittest2 并删除了过时的测试断言别名 [hvelarde]

  • 恢复对 ZopeSkel 中的 localcommands 的支持。通过使它们可选来改进 localcommands [cewing]

  • 提供退出选项,以便您可以干净地退出模板运行。在整个 templer 脚本中改进退出条件 [cewing]

  • 修复了测试中的长期 bug,该 bug 导致子包失败,而实际上它们成功了 [Lazaro Clapp]

  • 将结构代码分解为单独的方法,以便我们可以在 vars 中使用它 [cewing]

1.0b3 2011年10月6日

  • 重新许可为 MIT 以与 ZopeSkel 保持同步,因为它的内部结构已被替换 [cewing]

1.0b2 2010年12月8日

  • 修复了结构系统中导致没有许可证的模板无法渲染模板的 bug [Cris Ewing]

  • 将 zc.buildout 模板配方移动到新的包 templer.buildout 中 [Cris Ewing]

  • 提高了模板处理 setup.py 中的 'long_description' 的一致性 [Cris Ewing]

  • 固定文档引用到zopeskel脚本(当从templer包中使用时,我们将脚本称为'templer'。[Cris Ewing]

1.0b1 2010年12月1日

  • 增加了结构系统,以更好地隔离共享结构元素并提高可维护性[Cris Ewing]

  • 将包的命名空间更改为‘templer’,以促进Zope世界之外的系统使用[Cris Ewing]

  • 从zopeskel包移植了basic_namespace、nested_namespace和recipe模板,以创建新templer系统的核心(有关此迁移背后的原因,请参阅http://svn.plone.org/svn/collective/ZopeSkel/branches/2.x-maintenance/SPLITTING-PROPOSAL.txt)[Cris Ewing]

  • 由ZopeSkel创建的包[Cris Ewing]

项目详情


下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源分布

templer.core-1.0b4.zip (131.0 kB 查看哈希值

上传时间

支持

AWSAWS云计算和安全赞助商DatadogDatadog监控FastlyFastlyCDNGoogleGoogle下载分析MicrosoftMicrosoftPSF赞助商PingdomPingdom监控SentrySentry错误日志StatusPageStatusPage状态页面