作一个CLI版的时间管理工具（九）

作一个CLI版的时间管理工具（九）

这是我参与8月更文挑战的第10天，活动详情查看：8月更文挑战”

前言

上一篇文章主要阐述了自动记录事务的逻辑

经过前面8篇文章的介绍，这个工具目前已经可以进行初步的使用

本文将从头至尾的介绍一下已经开发的核心功能的使用

使用

安装

1. 须要电脑上安装Node
2. 若是依赖找不到，请先将npm源切换为官方源

npm config set registry https://registry.npmjs.org/
复制代码

安装

npm install -g time-control
复制代码

查看支持的指令

经过8天的不懈努力，能够看到咱们已经开发出了不少的指令，下面将演示一下核心的几个：

• 自动记录
• 生成周报/日报/月报（时间报告）

timec --help
复制代码

项目初始化

建立一个用于记录的项目

timec init timeLog
复制代码

建立文件

建立一个用于自动写入内容的文件

timec create auto.md
复制代码

建立的模板文件会有一些内容，能够手动清除一下

设置文件路径

设置自动记录文件的路径

timec upPath ./auto.md 
复制代码

任务管理

查看正在进行中的任务

timec task 
复制代码

建立新的任务

timec task <name>
复制代码

切换任务,这里和建立任务同样的指令与参数

若是任务已存在就选择使用这个任务

timec task <name>
复制代码

删除已存在的任务

• 加上-doption就表明是移除这个任务

timec task -d <name>
复制代码

事务管理

开始一个新的事务

timec thing <name>
复制代码

查看当前进行中的事务

timec thing
复制代码

结束当前事务

• 加上-s参数便可
• 结束事务，会自动将刚刚进行的事务记录到文件中

timec thing -s
复制代码

不切换事务，直接开始新的事务

• 将进行中的直接结束，而后将结果写入文件中
• 而后开始新的事务

timec thing <name>
复制代码

注：事务记录的数字是，事务的耗时，单位是小时（hours）保留5位小数

事务相关的操做到这就演示完毕了

有了事务记录的数据，下面就是生成报告了

下面将介绍到户导出功能

多样化导出

导出为JSON

开发者们能够用这串json，本身进行个性化的分析

timec -oj <filepath>
复制代码

导出Markdown

加上-t选项可为md文件加上详细的耗时，包含事务，任务，天维度

timec -omt <filepath>
复制代码

生成日报

指定要查看的日期和分析的文件便可：

• 生成的报告包含，一天的总耗时，某个任务的总耗时

timec -or -D <date> <filepath>
复制代码

生成月报

经过-M指定要查看的月份便可

timec -or -M <month> <filepath>
复制代码

一段时间的报告

能够用这个生成周报，任意时间范围的报告

timec -or -R <startTime_endTime> <filepath>
复制代码

小结

核心的功能基本都详细介绍完毕，演示过程当中发现了一些bug，留到下期进行优化

数据展现这一块后续也将为你们带来丰富的功能，灵感还在，只差时间

其它

因为天天空闲时间有限，本文就先到这

若是读者还感受意犹未尽，敬请期待后续更新，或持续关注一下仓库的状态

欢迎评论区提需求，交流探讨

本系列会不断的更新迭代，直至产品初代完成

• 仓库地址