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

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

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

前言

上一篇文章主要阐述了多种日期的数据导出与任务管理相关的指令开发

本文将会涉及指令：

1. 删除指定任务:timec task -d [name]
   1. 添加了一个option参数-d，标识要移除这个任务
2. 设置记录默认输出位置:timec upPath <recordFilepath>
   1. 用户后续经过指令添加/完成事务均会在此记录
3. 开始/结束具体的事务：timec thing -s [name]
   1. 其中-s标识，是否暂存任务状态的可选参数

本期效果

TODO： 补一张图

功能开发

删除任务指令

这个功能只需在昨天开发的任务管理指令的基础上添加一个可选指令便可

• 首先使用option方法注册--del可选参数
• 经过解构从cmdObj上拿到del的值

commander.command("task [name]")
    .option('-d, --del', 'Delete task or thing')
    .action((name, cmdObj) => {
        const { del } = cmdObj
        // ...code
    }
复制代码

若是del的值为true，代表设置了del这个option

• 使用splice方法，从任务数组中删除这一项
• 删除后更新配置文件
  • 若是任务被清空了，那么将defaultTaskIdx置为-1
  • 不然以当前任务列表的第一项，做为正在进行的任务

const idx = tasks.findIndex(v => v === name)

if (del) {
    tasks.splice(idx, 1)
    console.log(`del ${name} success`);
    config.defaultTaskIdx = tasks.length ? 0 : -1
    if (config.defaultTaskIdx === 0) {
        console.log('now use task：', tasks[config.defaultTaskIdx]);
    }
}

writeFileSync(configPath, JSON.stringify(config))
复制代码

删除任务的功能，就简简单单的搞定了

设置记录默认输出位置

功能背景

在未引入经过指令记录所作任务的耗时时

须要手动将这些记录添加到记录文件中

指望后续能经过指令，就自动计算事务耗时，而后将记录自动写到目标文件中

若是目标文件的地址是拼在参数中，不免在每次使用的时候稍显麻烦

为了不这个小麻烦，就将目标文件的路径存到配置文件中

指令开发

其中存储位置对应配置文件中的recordFilepath属性

{
    "recordFilepath":"/Users/sugar/Documents/fe-project/time-control/test.md"
}
复制代码

经过commander.command注册指令，设置为upPath <recordFilepath>

• emm这个命名感受有点奇怪，暂时没想到更好的命名方式，后续在优化阶段统一更新

/** * 更改默认记录文件的位置 */
commander.command("upPath <recordFilepath>")
    // .alias('urp')
    .description('update config recordFilepath')
    .action((recordFilePath) => {
        // ...code
    })
复制代码

经过指令执行目录cwd与传入的文件相对路径recordFilePath获得输出文件所在位置的绝对路径

而后将这个绝对路径赋值给配置文件的recordFilePath属性

经过fs.existsSync方法，判断这个文件是否存在，若是不存在就自动建立

最后经过fs.writeFileSync更新配置文件

const config = require(configPath)
const fullPath = path.resolve(cwd, recordFilePath)
config.recordFilepath = fullPath
if (!existsSync(fullPath)) {
    // 自动建立空文件
    createFile(fullPath, '', false)
}
writeFileSync(configPath, JSON.stringify(config))
console.log('set recordFilePath success：', fullPath);
复制代码

设置输出文件路径的指令开发到这就完毕了

事务管理指令开发

指望经过简单的timec thing -s [name],便可完成事务的添加，结束，自动写入到文件

其中--stopoption是可选的，标识结束这个工做，将其写入到文件之中去

首先注册指令，而后从配置文件中取出相关的配置项目

其中thing属性的结构以下

{
    "name":"abc",
    "startTime":"2021-08-08 22:18:19"
}
复制代码

分别存放当前进行中的事务名和事务开始时间

commander.command("thing [name]")
    .option('-s, --stop', 'stop a thing ')
    .description('update config recordFilepath')
    .action((name, cmdObj) => {
        const config = require(configPath)
        const { thing, recordFilepath, tasks, defaultTaskIdx } = config
        const task = tasks[defaultTaskIdx]
        
    })
复制代码

首先作一些判断，避免引起错误

1. 判断是否设置了写出文件路径
2. 判断是否设置了任务

若是没有设置，抛出响应提示信息

const s = new Date(thing.startTime)

if (!existsSync(recordFilepath)) {
    console.log(`${recordFilepath} is not exist`);
    console.log('you can use "timec upPath <recordFilepath>" set it');
    return
}
if (!task) {
    console.log('not set task');
    console.log('you can use "timec task [name]" set it');
    return
}

复制代码

若是没有传入事件名称name，表示使用查询功能，打印当前事务的基本信息

• 名称
• 开始时间
• 已经持续了多久（暂时毫秒代替），TODO：后续优化

若是设置告终束的标志stop，则将这个事务的记录写入到文件之中去，更新配置文件

if (!name) {
    if (!thing.name) {
        console.log('Events not in progress');
        return
    }
    const { stop } = cmdObj
    if (stop) {
        writeRecord(recordFilepath, task, thing.name, thing.startTime)
        thing.name = ''
        thing.startTime = ''
        writeFileSync(configPath, JSON.stringify(config))
        return
    }
    console.log('------');
    console.log(`-name: ${thing.name}`);
    console.log(`-start: ${s.format('yyyy-MM-dd hh:mm:ss')}`);
    // TODO：时分秒
    console.log(`-duration: ${Date.now() - s} mss`);
    console.log('------');
    return
}
复制代码

具体的输出到文件的方法writeRecord逻辑稍微有些复杂，今日时间实在有限，明日再详细分析

其它

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

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

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

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

• 仓库地址