1 个不稳定版本
| 0.3.0 | 2020年12月16日 |
|---|
#530 在 日期和时间
37KB
775 行
cassiopeia
cassiopeia 是一个简单的 kookie 办公生态系统计时工具。
kookie 办公生态系统是一套我用来经营业务的免费软件、纯文本工具。你可能还想看看另一个名为 invoice 的工具！
如何使用
每次文件只跟踪一个你正在工作的客户或项目。时间文件本身是一系列命令，后面跟着相关数据。以下有四个关键字
HEADER：定义有关客户的信息，并将时间文件版本存储起来，以避免将来解析与不兼容版本的问题START：以本地时区的时间戳打开一个工作会话STOP：以本地时区的时间戳关闭一个工作会话INVOICE：将之前会话的部分标记为“已收费”。这对于项目持续时间较长，你希望收费部分你已完成的工作很有用。
建议不要手动编写此文件，尽管你当然可以。以 ;; 开头的行是注释，将被忽略。但请注意：它们将在 cassiopeia 下次写入文件时被删除。注释传递功能已在计划中，但尚未实现！
cass(1) 包含一些命令
start将开始跟踪账户stop将停止跟踪，如果不存在打开的槽位，则出错invoice将向时间文件添加一个发票块
所有命令都需要一个 -f（或 --file）参数，以了解它们正在操作哪个时间文件。如果没有提供，则尝试当前工作目录中的 time.cass 文件。如果该文件不存在，则程序会错误退出。
默认情况下，时间值将四舍五入到下一个 15 分钟。要禁用此功能，将 -r 传递给 start 或 stop 命令。
与发票的交互
卡西欧佩亚（Cassiopeia）旨在输出可用于为客户生成发票的 .yml 配置文件。为此，它需要访问您的客户数据库，并使用您时间文件头部的 client 和 project 键来查找它们。如果没有这些键，您可以通过使用 --client 和 --project 手动将此数据传递给 invoice 命令。您可以使用 --client-db 提供您的客户数据库路径。
以下命令将为客户 ACME inc. 生成的项目生成发票
$ cass invoice --client-db /home/office/clients.yml --client acme --project world-domination
欢迎通过我的 [公开邮箱] 发送建议
依赖项
~6–15MB
~136K SLoC