Stempel

一个小工具，用于存储和计算工作时间。

⚠️ v0.10.0 引入了新的存储文件格式。运行 stempel migrate 更新您的 json 数据库到新格式。

用法

管理一天示例

# First of, configure some settings
stempel configure
# start working now
stempel start
# start a break five minutes ago
stempel break start --offset 5m-
# optional: break can be canceled:
stempel cancel
# finish break in one hour (only if not canceled above)
stempel break stop --offset 1h+
# Finish the day
stempel stop
# Alternatively, you can specify the time point to stop as a time in 24h format
stempel stop --time 17:38

要获取详细参考，请运行 stempel help 或 stempel SUBCOMMAND --help。可用的子命令有

• cancel 取消最后一个休息或开始，如果没有休息或开始则不执行任何操作，
• break：使用 start 或 stop 作为子命令来处理休息，
• migrate：将存储文件从旧格式（0.10.0 之前）迁移到新格式（自 v0.10.0 以来）
• start：开始一个工作周期，如果之前已经开始了则终止，
• stats 打印当前统计信息。
• stop：检查存储文件中是否存在 start 条目，并计算工作时间，如果没有找到 start 条目则终止，
• configure：为 stempel 设置一些默认值并将它们与数据库文件一起保存。目前可用的
  • 统计命令打印的月份数量
  • 每天的工作小时数

自动补全

运行 stempel completions --shell <shell> 获取 shell 补全文件，例如，对于 zsh 运行 stempel completions --shell zsh。根据您的特定 shell 源此文件。

source <(stempel completions --shell zsh)

选项

--offset

此选项允许指定相对于当前时间的正或负偏移量。换句话说，使用选项 --offset 10m+ 表示命令将在当前时间加上10分钟后执行，20s- 表示当前时间减去20秒。语法允许 [Xh][Xm][Xs](+-)，其中 X 可以是任何数字，h|m|s 分别代表小时、分钟和秒。以下列为例。

一些例子

• 2h30m4s+：从现在起2小时30分钟4秒
• 1h90s-：现在之前1小时90秒
• 20m30s+：从现在起20分钟30秒
• 60s-：现在之前1分钟

--时间

此选项允许指定相应操作的特定时间。如果您想在特定时间开始或停止，请使用此选项。格式为 HH:MM，24小时制，日期设置为当前日期，例如 13:47 表示今天下午 13h 47。

--storage

指定所有工作条目写入的存储文件路径。默认路径为 $HOME/.config/stempel.json，在执行 start 子命令的第一次调用时创建。

许可

MIT