onkeltem / toggl-report

Toggl.com CLI 报告工具。

0.0.1 2020-03-03 11:31 UTC

This package is auto-updated.

Last update: 2024-09-29 05:29:04 UTC


README

toggl-report 是一个命令行工具,用于连接到您的 Toggl 账户,并创建一个按日期或任务分组的美观报告。

它被创建来获取时间花费的清晰画面,并将其用于将日志数据手动传输到 RedMine、Jira。

演示

按日期分组

Report for the last 10 days grouped by date

按任务分组

Report for the last 10 days grouped by task

先决条件

为了使用此软件包,您需要安装 Composer

安装

$ composer require onkeltem/toggl-report

用法

示例调用

$ vendor/bin/toggl -te7581a1373e5f723e205679f0a075aa7 -p12693340 -n30 -T

这将打印出按 任务 分组的过去 30 天的项目的报告。认证令牌通过 -t 选项传递。

您可以通过将 tokenproject_id 存储在 config.php 文件中来节省输入,例如。

<?php
    $toggl_token = 'e7581a1373e5f723e205679f0a075aa7';
    $project_id = '12693340';

Windows 支持

toggl-report 是一个 Linux shell 脚本,因此它不会在 Windows 环境中运行。我可以为 Windows 用户创建一个 bat 文件,但这似乎不太合理 - 例如,控制台颜色(该工具使用的)也会被破坏。除此之外,微软已经长期提供了对 Linux 的支持,称为 Windows Subsystem for Linux。它带来了不错的终端应用程序,像 apt 这样的软件包管理器,并允许原生运行 bash 脚本。所以,请使用它。

待办事项

  • 切换到 https://github.com/DataMincer/task-runner 以获取合理的选项解析
  • 添加显式的日期范围选项(目前截止日期等于今天)
  • 添加 JSON 和 CSV 输出格式
  • 添加对多个项目和账户(令牌)的支持(也许对团队来说)
  • 您的建议?欢迎到 问题