README

这是一个使用symfony控制台组件构建的超级简单的跟踪时间应用程序。

我需要一个时间跟踪器，但并不真的需要一个完整的网络界面或GUI来做像将时间日志添加到CSV文件这样简单的事情。没有看到很多选择，我决定自己做一个。

安装

您可以通过运行 composer global require judahnator/time-tracker 来安装此项目。这将全局安装包，如果您的composer bin目录已添加到系统 $PATH 变量中，您可以使用 timetracker 命令。

接下来，您需要设置时间日志位置。日志文件将格式化为CSV。

timetracker set:log '/full/path/to/your/spreadsheet.csv

用法

您可以通过简单地输入 timetracker 来查找可用的命令。

为了一个稍微真实的例子，假设您想为一个客户'Trees Are Cool LLC'启动一个计时器。

timetracker timer:start -c 'Trees Are Cool LLC' '在网站上做一些很酷的工作'

您可以使用列表命令来查看活动计时器。

timetracker timer:list

如果您想编辑计时器，您可以使用交互式的 timer:edit 命令，或者您可以使用命令选项来完成所有操作。

timetracker timer:edit 5b16b3cb74d7c -c='Trees Are Cool LLC' -d='修复CSS错误'

然后您完成工作并想将时间添加到日志中。您在这里使用 timer:stop 命令，它将帮助您选择要停止并添加到日志中的计时器。

timetracker timer:stop

如果您有一个想要丢弃的计时器，您可以使用 timetracker timer:delete 命令。

升级帮助

在升级此包时，请注意内部缓存文件将被覆盖。这不是世界末日，因为截至编写此内容，它只包含日志位置和活动计时器。

如果您已单独安装此项目，有更新前后脚本将内部缓存文件复制到您的系统临时文件目录。 这些脚本在通过composer全局安装项目时不会运行

如果您不想在全球范围内安装包时丢失活动计时器，您应该在全局 composer.json 文件中添加两个脚本。其具体位置因系统而异，但在我个人的系统上，它位于 ~/.config/composer/composer.json

您需要添加的两个脚本可以在此项目的composer.json中看到，只需将它们添加到您的全局 composer.json 即可。文件应类似于以下内容

{
    "require": {
        // other packages ...
        "judahnator/time-tracker": "^1.0"
    },
    "scripts": {
        "pre-update-cmd": "judahnator\\TimeTracker\\Update::preUpdate",
        "post-update-cmd": "judahnator\\TimeTracker\\Update::postUpdate"
    }
}