Timest - 简单易用的打卡 CLI

Timest 是一个简单易用的 CLI 时间卡。打卡上班。打卡下班。查看工作时间。

安装

1. 使用 cargo

$ cargo install timest

2. 从源码构建 - 必须安装 cargo/rustup

# Linux
$ git clone https://github.com/stephenlf/timest.git
$ cd timest
$ cargo build --release
$ cp target/release/timest ~/.cargo/bin/timest

使用方法

打卡

轻松打卡上班和下班。

# Clock in/out
$ timest clock i
$ timest clock o
# Clock in/out at a different time or date
$ timest clock i --time 8:00
$ timest clock i --time 8:00 --date 2023-05-31
$ timest clock o --t 8:00 --d 2023-05-31

查看报告

查看今天的报告。

$ timest clock i -t 11:23:38
$ timest clock o -t 12:09:59
$ timest report
# Output below

警告不完整的工作间隔，并提示修复它们。

$ timest clock i -t  8:00
$ timest clock i -t  13:20:23
$ timest clock i -o  14:00
$ timest report
# Output below

运行简单的报告以查看原始时间戳。

# See today's reports
$ timest report simple
# Gathering data from day 2023-11-25
# ====TODAY'S TIMESHEET====
# ->>    2023-05-31
#  ________________________
# |  7  |  11:23:38  |  i  |
# |  8  |  12:09:59  |  o  |

使用 --date/-d 标志指定要查看的日期，或使用 --yesterday/-y 标志查看昨天的报告。

$ timest report -y
# ...

修复条目

使用 timest report simple 获取条目 ID，然后运行 timest fix {id} 修改错误的条目。 timest fix {id} 使用与 timest clock 相同的参数。

$ timest clock i -t 8:00
$ timest report simple
# Gathering data from day 2023-11-25
# ====TODAY'S TIMESHEET====
# ->>    2023-05-31
#  ________________________
# |  9  |  08:00:00  |  i  |
$ timest fix 9 o -t 11:24:38
$ timest report simple
# Gathering data from day 2023-11-25
# ====TODAY'S TIMESHEET====
# ->>    2023-05-31
#  ________________________
# |  9  |  11:24:38  |  o  |

删除条目

使用 timest report simple 获取条目 ID，然后运行 timest delete {id} 删除错误的条目。

$ timest clock i -t 8:00
$ timest clock i -t 8:01
$ timest report simple
# Gathering data from day 2023-11-25
# ====TODAY'S TIMESHEET====
# ->>    2023-05-31
#  ________________________
# |  10 |  11:24:38  |  o  |
# |  11 |  11:24:38  |  o  |
$ timest delete 11
$ timest report simple
# Gathering data from day 2023-11-25
# ====TODAY'S TIMESHEET====
# ->>    2023-05-31
#  ________________________
# |  10 |  11:24:38  |  o  |