项目的问题跟踪程序,在文本文件中
tisu的Python项目详细描述
tis_
ti s_[ti_su,tissue西班牙语]允许使用单个文本文件管理(github)项目的问题跟踪程序
注意:这是一项正在进行的工作。欢迎提出请求和反馈。
安装
$ pip3 install --user -U tisu
用法
tis_可以使用一个简单的标记文件导入和导出问题,其中每个部分 是另一个问题。
# issue title
issue body
如果在跟踪器中已经存在一个问题,该数字是标题中的前缀,包 方括号:
# [#1] issue title
在这种情况下,tis_将更新这个问题,而不是创建一个新的问题。
这是当前的命令行帮助::
(tissue)tin@morochita:~$ tisu --help
Tisú: your issue tracker, in a text file
Usage:
tisu push <markdown_file> <repo> [--user=<user>] [--pass=<pass>]
tisu pull <markdown_file> <repo> [--state=<state>]
Options:
-h --help Show this screen.
--version Show version.
--state=<state> Filter by issue state [default: open].
--user=<user> Github username to send issues. Repo's username if no given.
--pass=<pass> Github password. Prompt if no given.
示例
假设你想把一些问题 this TODO.md 文件
$ tisu push TODO.md mgaitan/tisu
Github password:
Created #11: support metadata
Created #12: setup travis CI
结果:
然后,我可以提取并覆盖文件。
$ tisu pull TODO.md mgaitan/tisu
This is the result。 在本例中,我没有在网上更改任何内容,内容(几乎)是相同的,但是请注意 每个标题都有其ID号。
使用元数据
tis_还可以轻松同步问题的元数据。
格式是:<meta_var>: <value/s>
,其中<meta_var>
是一个assignee
,labels
。
或者milestone
。这些元数据行可以位于标题下的任何位置(而不是
必要的是所有人,按此顺序或所有人一起)如果在场,
它们将从发送的问题描述中删除。
例如,使用一些元数据创建新问题
# Make a video
:assignee: mgaitan
:labels: docs, idea
:milestone: sprint 1
Make an screencast showing how to use Tisú.
如果以后要关闭此问题,可以添加此元数据并推送。
# [#13] Make a video
:assignee: mgaitan
:labels: docs, idea
:milestone: sprint 1
Make an screencast showing how to use Tisú.
:state: closed
更改日志
1.1(2019-04-22)
- 错误修复:未设置受让人。
- 推断回购。
0.2(亦称1.0)(2016-03-19)
- 撞击0.2。
- 通过元数据提供状态支持。
- 与github同步元数据。
- 更好的测试。
- 从正文中清除元数据。
- 分析元数据。
- 最好是自述。
- 以TOdo文件为例。
0.1(2016-03-15)
- 触摸自述文件。
- 重命名包。
- 基本功能推送命令。可以创建或更新问题。
- 基本命令行。可以从Github中提取。
- 基本的github获取程序。
- 分析器接收路径。
- 基于docutils的基本解析器。
- 创建readme.md。