愚蠢的简单时间追踪器
ti的Python项目详细描述
ti–一个愚蠢的简单时间跟踪器
ti 是一个小型的命令行时间跟踪应用程序。 简单的基本用法如下:
$ ti on my-project $ ti fin
你也可以给它人类可读的时间:
$ ti on my-project 30mins ago
ti 具有许多其他酷炫功能。一起阅读以发现。
ti是一个简单的命令行时间跟踪器。完全重写了 在python中(最初是一个bash脚本),并且具有(几乎)完整的测试覆盖率。它 灵感来源于 timed ,这是一个不错的项目 如果你不喜欢,你应该去看看。 ti 也需要 从简单的t中获得灵感
如果一个时间跟踪工具让我思考超过3-5秒,我就会失去我的线路 忘记我在做什么。这就是我创建 ti 的原因。用 ti ,您将尽可能快地输入,无论如何您都应该很好地使用它。
关于 ti 最重要的部分是它只提供了几个命令 管理您的时间跟踪,然后走开。
所有数据都保存在json文件` ~/.ti sheet``中。(可以使用 $sheet_file 环境变量。)json易于访问,可以 处理成其他更样式化的文档。一些想法:
- 阅读json文件生成漂亮的html报告。
- 根据标签或任务建立月度统计。
- 阅读您当前的工作项目并在终端提示中显示它。 也许即使你已经工作了几个小时。
这是您的数据。
顺便说一下,源代码是一个相当小的python脚本,所以如果您知道 python,您可能需要浏览一下它,以便更好地了解它的工作原理。
注意:如果您使用了以前的bash版本的ti,这是非常可怕的 由于只在Linux上工作,您可能会注意到 python版本。我并不是真的很想念它们,所以我可能不会添加它们。如果有人 有任何有趣的用例,我愿意考虑。
用法
以下是最低使用方式:
$ ti on my-project Start working on my-project. $ ti status You have been working on my-project for less than a minute. $ ti fin So you stopped working on my-project.
on 和 fin 可能需要一段时间(下面将进一步描述格式)才能 应用操作:
$ ti on another-project 2 hours ago Start working on another-project. $ ti s You have been working on another-project for about 2 hours. $ ti fin 30 minutes ago So you stopped working on another-project.
在前面的示例中还演示了所有命令的短别名, 他们的第一封信。例如, s 表示 状态, o 表示 开 , f 用于 fin 等。
简要记录您一直在做的事情:
$ ti note waiting for Napoleon to take over the world $ ti n another simple note for demo purposes
为您的活动添加趣味和利润标签:
$ ti tag imp
使用 log (或 l )命令获取所有活动的日志:
$ ti log
命令参考
运行 ti -h (或 --help 或 help 或仅运行 h ) 获取命令的简短命令摘要。
打开
- 短: o
- 语法: ti(o on)<;name>; [<;time>;…]
开始跟踪 <;name>; 给出的项目/活动的时间。例如:
ti on conquest
告诉ti现在开始跟踪征服的活动。 您可以选择指定过去的相对时间,如下所示:
ti on conquest 10mins ago
时间格式详见下文。
鳍
-
短:
f
-
语法:
ti(f fin)
[<;time>;…]
结束当前活动的跟踪 现在 。就像 打开 命令一样 上面,你可以给过去一个可选的时间。例子:
$ ti on my-project $ ti fin0
告诉 ti 您已在完成当前活动,嗯,10 几分钟前。
状态
-
短:
s
-
语法:
ti(s status)
提供有关当前状态的简短人类可读消息,即是否有 当前是否正在跟踪。例子:
$ ti on my-project $ ti fin1
-
短:
t -
语法:
ti(t tag) <;tag>;…
此命令将给定的标记添加到当前活动。标记当前不是 在 ti 时间跟踪器中使用,但它们将保存在json数据中 文件。您可以将它们用于您喜欢的任何目的。
例如,如果您有一个脚本从 ti 数据,你可以用像 red 或 important这样的标记来标记一些活动 该活动将在最终的HTML报告中以红色显示。
像这样使用:
$ ti on my-project $ ti fin2
将joe的 红色和 标记添加到当前活动中。您可以指定 任何数量的标签。
标签目前是为您准备的。根据需要使用。
注意
-
短:
n
-
语法:
ti(n note)
<;note text>;…
此命令将添加有关当前活动的注释。同样,像标签一样,这个没有 时间跟踪方面的显著性。这是给你自己的 记录目的和脚本,以便处理 ti 数据。
像这样使用:
$ ti on my-project $ ti fin3
添加注释 与其他团队讨论此问题。 到当前活动。
日志
- 短: l1
- 语法: ti(l log)[今天]
提供所有活动和每个活动花费的总时间的类似于表的表示 其中,
时间格式
目前只识别以下内容。如果有什么不是 已处理,但应该是,请打开有关它的问题或拉取请求 (所讨论的函数是 解析时间 )
- n 秒前可以写为:
- n 秒前
- n 秒前
- n 秒前
- n 秒前
- n s之前
- a 代替上述所有情况下的 n ,表示1秒。
- 例如, 10s前 , 1秒前 25秒前 , 25秒前
其中 n 是任意数,并且 n 和 允许使用时间单位(包括零空间)。
状态
这个项目正在测试阶段。如果您发现任何错误或有任何反馈,请打开 Github问题
您可以从 Github
- 把它放在 $path 中的某个位置,并确保它具有可执行权限。
- 使用命令pip install安装pyyaml
- 使用命令安装colorama
之后, ti 应该工作正常。
此外,还可以访问github上的项目页面 更多详细信息。