可计费

这是一个简单的命令行工具，可以显示每月可计费小时数的报告。它与 Toggl 和 Harvest 集成。

主要功能是能够为每个客户设置每月目标。可计费提供了基于定义的目标的每月估计、每日和每周目标。

输出示例

# billable -s -m 2
[Toggl]
February 2023
My Second Client        19:00 🟢 23:28/20:00 🎯 0:15 a day, 1:15 a week
My First Client         23:00 🔴 28:24/30:00 🎯 1:45 a day, 8:45 a week
January 2023
My Second Client        30:00 🟢 30:00/20:00
My First Client         17:00 🔴 17:00/30:00

[Harvest]
February 2023
Harvest Client          27:00 🟢 33:21/33:00 🎯 1:30 a day, 7:30 a week
January 2023
Harvest Client          35:00 🟢 35:00/33:00

安装

您可以使用 cargo 安装 billable

cargo install billable

配置

配置文件 config.toml 从以下位置加载：

• 当前目录
• 或 ~/Library/Application Support/com.robertwijas.billable

运行 billable 会提供创建示例配置的选项。

用法

# billable --help
Usage: billable [OPTIONS]

Options:
  -m, --months <MONTHS>            [default: 1]
  -s, --show-minutes
  -c, --config-name <CONFIG_NAME>  [default: config]
  -h, --help                       Print help

待办事项/功能

• 显示当前月份每个客户的小时数
• 移除硬编码的月份
• 显示过去两个月报告
• 从 $HOME/.billable.toml 或类似位置读取用户配置文件
• 支持控制显示的最近月份数量的参数
• 更好的时间精度（或向上取整小时）
• 配置每月目标
• 显示结果时使用基本文本格式
• 显示当前月份每个客户的估计小时数
• 指示目标进度
• 添加显示带分钟的时间的选项
• 计算达到目标的最佳每周和每日速度
• 在目标提示中支持显示分钟标志
• 添加 Harvest
• 添加演示报告提供者
• 如果缺失，根据 config.toml.example 自动创建配置
• 将示例输出添加到 README 中（最好基于演示报告）
• 用控制台替换彩色输出
• 使用控制台中的 Style 提取样式代码
• 调整第一列宽度以适应最长的客户名称
• 创建 CHANGELOG
• 支持假日（？）或允许以某种方式覆盖工作日
• 添加显示所有客户 总计 行的选项
• 添加显示每周报告的选项
• 使用 GitHub Actions 配置自动发布
• 项目/配置的报告
• 显示 PLN（即支持每小时费率）中的小时数
• 自动货币转换
• 实现异步 HTTP 请求