生成文档源代码变体的实用程序

pear-cli的Python项目详细描述


A utility for generating variations source code for docmentation.

在文档中,您可能希望显示文件随时间的增长情况。但是,如果您只想保留源代码的一个副本。考虑以下文件:

classFoo:def__init__(self,name):self.name=namedefreverse_name(self):returnself.name.reverse()

如果我们可以增量地构建文件,我们可以先写构造函数,然后再写reverse_name。这意味着我们需要两个版本的文件:

^{pr2}$
classFoo:# constructordefreverse_name(self):returnself.name.reverse()

使用pear你可以使用它。在

使用

在根目录中包含一个pear.json文件以及必要的配置。对于上面的例子,我们可以:

{"out":"out","files":[{"path":"foo.py","tag":"without_reverse_name","layers":[{"type":"remove","start":4,"end":6}]},{"path":"foo.py","tag":"constructor_comment","layers":[{"type":"replace","start":2,"end":3,"replacement":["    # constructor"]}]}]}

然后从同一目录调用pear。这将在out/中生成foo.py_without_reverse_name和{}文件。在

欢迎加入QQ群-->: 979659372 Python中文网_新手群

推荐PyPI第三方库


热门话题
java中char的用途   swing修复,以便显示可以同时显示十进制数和整数   java给定一个场景,找到拥有的JFXPanel   java JPA 2标准获取路径导航   java如何用JUnit测试这个类?   JSF中的java请求作用域   Spring云Zuul代理背后的java Spring OAuth授权服务器   java限制聚合返回的存储桶大小   java如何在安卓应用程序中请求超级su权限   防止超级关键字的java Checkstyle规则   java 安卓。应用程序。应用程序无法强制转换到安卓。应用程序。在回收器适配器中使用FragmentManager时的活动   使用Java的Twitter广告API   切换到4.0.1版本后,java“JavaMailSenderImpl无法解析为类型”   java没有getter方法可用于名称下bean的属性   java 0/1背包堆空间   java我无法使用断点进行调试   Jar文件名表单java代码   java调用从扩展活动的MainActivity类扩展片段的类片段