tianon/gosleep

gosleep

• 项目地址：https://github.com/tianon/gosleep

镜像概述和主要用途

gosleep 是一个增强版的睡眠工具，功能类似于 Unix 系统中的 sleep(1) 命令，但提供了更灵活的时间指定方式和直观的进度显示。它支持通过 Go 风格的持续时间字符串（如 1m、2h3m2s）设置睡眠时长，或直接指定具体的睡眠时间点（如 13:04、2016-11-18 00:00:00），同时会实时显示睡眠进度条，帮助用户直观了解剩余等待时间。

核心功能和特性

• Go 持续时间解析：支持 Go 语言风格的持续时间格式，如 10s（10秒）、2h3m2s（2小时3分2秒）等，便于直观设置睡眠时长。
• 指定具体睡眠时间点：可直接设置目标时间点（如 14:39、2023-12-31 23:59:59），工具会自动计算并睡眠至该时间。
• 实时进度条显示：睡眠过程中显示进度条及百分比，清晰展示已等待时长/总时长，提升用户体验。

使用场景和适用范围

• 脚本任务中的精确延迟控制：如自动化脚本中需要等待特定时长后执行下一步操作。
• 定时任务前的等待：需在指定时间点执行任务时，通过 --until 设置目标时间，避免手动计算延迟。
• 可视化等待场景：需要直观了解等待进度的交互式操作或演示。

使用方法和配置说明

命令行参数

示例命令

查看帮助信息

console
$ gosleep --help
用法：
  gosleep --for <duration> 或 --until <time>

应用选项：
      --for
      --until

帮助选项：
  -h, --help   显示此帮助信息

通过持续时间睡眠（--for）

睡眠10秒，并显示进度条：

console
$ gosleep --for 10s
 10s / 10s [███████████████████████████████████████████████████████████] 100.0% 

通过目标时间点睡眠（--until）

1. 睡眠至当天14:39（当前时间早于目标时间）：

console
$ date
2023-12-13 14:38:41 CST
$ gosleep --until 14:39
 19s / 19s [███████████████████████████████████████████████████████████] 100.0% 

2. 目标时间在过去（错误提示）：

console
$ date
2023-12-13 14:38:20 CST
$ gosleep --until 14:38:20
error: requested sleep time in the past: -8.415878269s

3. 睡眠至未来日期时间：

console
$ gosleep --until '2024-01-01 00:00:00'
^C8s / 441h20m45s [                                                    ]   0.0%  # 可按Ctrl+C中断

4. 睡眠至当天特定时间点（显示进度）：

console
$ gosleep --until '2023-12-13 17:00'
 22s / 2h19m6s [▏                                                      ]   0.3% 

注意事项

• --for 和 --until 为互斥参数，每次运行需指定其中一个。

• --until 指定的时间若在当前时间之前，工具会立即返回错误并提示时间差。

• 时间字符串支持格式：HH:MM（如 13:04）、YYYY-MM-DD HH:MM:SS（如 2023-12-31 23:59:59）等。===SHORT_DESC=== 类似sleep命令，但支持Go持续时间解析（如1m、2h3m2s）或指定具体睡眠时间点，并带有进度条。 ===FULL_DESC===# gosleep

• 项目地址：https://github.com/tianon/gosleep

镜像概述和主要用途

gosleep 是一个增强版的睡眠工具，功能类似于 Unix 系统中的 sleep(1)，但支持 Go 风格的持续时间解析（如 1m、2h3m2s）或指定具体的睡眠时间点（如 13:04、2023-12-31 23:59:59），并在睡眠过程中显示实时进度条，帮助用户直观了解等待状态。

核心功能和特性

• Go 持续时间解析：支持 10s（10秒）、2h3m2s（2小时3分2秒）等直观的时间格式，简化睡眠时长设置。
• 指定具体睡眠时间点：可直接设置目标时间点（如 14:39、2024-01-01 00:00:00），自动计算并睡眠至该时间。
• 实时进度条显示：睡眠过程中动态展示进度条及百分比，清晰呈现已等待时长/总时长。

使用场景和适用范围

• 脚本任务中的精确延迟控制：自动化脚本中需等待特定时长后执行后续操作。
• 定时任务前的等待：需在指定时间点触发任务时，通过 --until 直接设置目标时间，无需手动计算延迟。
• 可视化等待场景：交互式操作或演示中，需直观展示等待进度的场景。

使用方法和配置说明

命令行参数

示例命令

查看帮助信息

console
$ gosleep --help
用法：
  gosleep --for <duration> 或 --until <time>

应用选项：
      --for
      --until

帮助选项：
  -h, --help   显示此帮助信息

通过持续时间睡眠（--for）

睡眠10秒并显示进度条：

console
$ gosleep --for 10s
 10s / 10s [███████████████████████████████████████████████████████████] 100.0% 

通过目标时间点睡眠（--until）

1. 睡眠至当天14:39（当前时间早于目标时间）：

console
$ date
2023-12-13 14:38:41 CST
$ gosleep --until 14:39
 19s / 19s [███████████████████████████████████████████████████████████] 100.0% 

2. 目标时间在过去（返回错误）：

console
$ date
2023-12-13 14:38:20 CST
$ gosleep --until 14:38:20
error: requested sleep time in the past: -8.415878269s

3. 睡眠至未来日期时间（可按Ctrl+C中断）：

console
$ gosleep --until '2024-01-01 00:00:00'
^C8s / 441h20m45s [                                                    ]   0.0% 

4. 显示部分进度示例：

console
$ gosleep --until '2023-12-13 17:00'
 22s / 2h19m6s [▏                                                      ]   0.3% 

注意事项

• --for 和 --until 为互斥参数，每次运行需指定其一。
• --until 时间若在当前时间之前，工具会立即返回错误并提示时间差。
• 时间字符串支持 HH:MM、YYYY-MM-DD HH:MM:SS 等常见格式。