自动更新版本控制源中的版权简介。

update-copyright的Python项目详细描述


…-*-编码:utf-8-*-

``更新版权``是一个自动版权更新工具。我为"bug everywhere"编写了
原始版本,但最终将其复制到了我的项目中。复制是不好的,因此在这里,它被分割为
它自己的独立项目。


你需要外行和我的"wtk覆盖层"。安装时使用:

emerge-av app portage/layman
需要在
`path`中使用git`来使用git`后端,需要在`path`中使用'hg`来使用
mercurial`后端。


有关详细信息,请参见主页。要安装签出,请运行
标准::


usage
=


>您需要一个使用我们支持的vcss
(当前为git和mercurial,但为其他系统添加
后端应该很容易)。您还需要一个名为
``.update copyright.conf``的配置文件,该文件将使用python的rawconfigparser进行解析(关闭"语法文档"
插值)。您的配置文件看起来像:


[project]
name:update copyright
vcs:git

[files]
authors:yes
files:yes
ignored:copying readme。update-copyright.conf。git*
py file:update_copyright/license.py

[copyright]
简短:{project}绝对没有任何保证,并根据GNU通用公共许可证获得许可。
长:此文件是{project}的一部分。

{project}是免费软件:您可以根据发布的GNU通用公共许可证的条款重新分发和/或修改它通过自由软件基金会,无论是许可证的版本3,或(在您的选择)任何后来的版本。有关详细信息,请参阅gnu通用公共许可证。

您应该已经收到gnu通用公共许可证的副本以及{project}。如果没有,请参见<;http://www.gnu.org/licenses/>;


options
----


project.name
命名项目的字符串。替换
版权简介中的`{project}'。如果不设置,则"update copyright"将返回到使用存储库目录的名称。
project.vcs
版本控制系统的名称。
files.authors
是否应"update copyright.py"生成"authors"文件?
``yes``或``no`.
文件.files
是否应该``update copyright.py``更新版本化文件中的版权简介?``是``或``否`。
文件。忽略了不应更新
版权简介的全局匹配文件的管道分隔列表。这将保护由blurb更新算法意外捕获的文件。
files.pyfile
自动生成的许可证模块的路径,以防您的程序想要打印出其版权/许可信息。如果不设置此选项,则不会生成许可证模块。
copyright.short
包含
简短版权/许可证简介的段落列表(用空行分隔)。此模糊用于pyfile的
``short_license``函数(请参见'files.pyfile`)。这是因为有些程序会打印一个简短的许可证简介n Startup,其中
完整的文件顶端模糊可能是过度的。
版权。long
包含您的long
版权/许可证模糊的段落列表(用空行分隔)。此模糊用于替换源文件中的版权模糊。

这些行标志着一个模糊的开始,只要随后的行以````开头,这个模糊就会一直持续下去。旧的blurb
替换为一个新的blurb,该blurb是从
配置的长版权字符串中自动生成的,其中作者姓名和编辑年份是从该文件的VCS数据中提取的。

对于像c这样使用`/*…*/`
标记注释的语言来说,这是行不通的。blurb update算法也会查找任何用`/*copyright``请求并替换该行的
行,以及用新的blurb替换
以` ` `*/``开头的后续行。

都是针对每个版本的文件。如果
是您的问题,请告诉我,我们可以添加一些配置
选项来解决此问题。


您可以使用"author hacks"部分将作者添加到文件中,使用"year hacks"部分调整
文件的原始年份。作者姓名应以管道分隔。对于
示例::

[作者黑客]
路径/到/文件:john doe<;jdoe@a.com>;jane smith<;jsmith@b.net>;

[年度黑客]
路径/到/另一个/文件:2009

路径应该与项目根目录相对
。始终使用正斜杠(`/``)分隔
路径元素。

有些VCS有一个内置的方法来处理
这个问题(例如git的`.mailmap`)。对于没有vcs的用户,可以在配置文件中添加一个"aliases"部分,其中选项名
是…?例如:


[aliases]
john doe<;jdoe@a.com>;:johndoe&jdoe&jdoe&jdoe&jdoe.net>;





testing
====br/>




















br/>吨他的项目是在"GNU通用公共许可证
3版"或更高版本下发布的。


author
=


w.trevor king
wking@tremily.us




。_错误无处不在:http://bugserverywhere.org/
…_ gentoo:http://www.gentoo.org/
。_外行:http://layman.sourceforge.net/
…_ wtk覆盖:http://blog.tremily.us/posts/gentoo_overlay/
。_ git:http://git scm.com/
…_汞:http://mercurial.selenic.com/
。_主页:http://blog.tremily.us/posts/update copyright/
。_ rawconfigparser:
http://docs.python.org/dev/library/configparser.html configparser.rawconfigparser
。_语法文档:
http://docs.python.org/dev/library/configparser.html;支持的ini文件结构
。_.mailmap:http://schacon.github.com/git/git shortlog.html\u mapping\u作者
…_ GNU通用公共许可第3版:http://www.gnu.org/licenses/gpl.html

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

推荐PyPI第三方库


热门话题
面向批处理的java非阻塞队列   java如何基于HttpComponent获取html内容   java为什么我的程序会显示此错误?   java spring控制器如何处理应用程序/octetstream请求?   尝试将数据插入数据库时出现java常规错误   无法在java多线程处理中维护生产者任务的顺序   java为什么JSON数据无法访问ViewPager?   java获取Maven中特定分支的SVN buildnumber   java客户端无法从服务器接收信息   java等轴测地图绘制,生成   java无法调试ProcessBuilder   java热点JVM阵列分配   在数组中存储“inputdialog”数据的java   saml Java Inflater引发DataFormatException“无效代码长度集”   从集合(爬虫、Jsoup、Java)写入文件