前言
上一篇文章主要阐述了两个指令的开发：
- 初始化项目模板指令：
timec init <projectName> - 初始化记录模板指令：
timec create <filename>
本节将主要介绍：自动生成一段时间内的报告
期望效果的指令为：timec -or --range <startTime>_<endTime> <filename1> <filename1> .....
本期效果
网络异常，图片无法展示
|
功能开发
一定时间范围内的报告生成
可用于周报，日报，月报的统计数据生成，方便自己复盘一周所做的事情
指令注册
注意：省略了前几篇里已经出现过的指令逻辑
轻车熟路，使用option方法注册新的可选参数：
- -r：代表要输出报告
- -R：代表要输出的事件范围
// 导出 commander.arguments('<filenames...>') // 多个文件/目录 .option('-o, --output', 'Export analysis results') .option('-r, --report', 'Export the result as a md report') .option('-R, --range [startDate_endDate]', 'A time period') // .action
再添加简单的判断逻辑：
-r对应的是report属性，为true表明启用了这个option-R对应range属性，其值为string类型
- 开始与结束时间使用下划线
_分割
- 主要关注
getJSONByRange与outPutReport这两个方法的实现 - 内容的读取逻辑(
content)，在前几篇的文章已经详细介绍过了，这里就不再赘述
.action((filenames, cmdObj) => { const { output,report } = cmdObj // 导出 if (output) { let outFileName = 'res' if(report){ const {range} = cmdObj if(range){ const [startTime,endTime] = range.split('_') // createFile(getFilePath(cwd, `report-${outFileName}.md`),outPutReport(getJSONByRange(content,startTime,endTime)),false) // 方便观察调用结构，展开如下 const outPutPath = getFilePath(cwd, `report-${outFileName}.md`) const json = getJSONByRange(content,startTime,endTime) const data = outPutReport(json) createFile(outPutPath,data,false) } } } })
范围内的json获取
这个逻辑相对简单：
- 先调用
getJSON方法将传入的内容转为json对象
- 其中每一项数据的
title为yyyy-mm-dd的日期
- 先调用
sort方法对数据按时间从小到大排序 - 在使用
filter方法对数据按照传入的起止时间进行过滤筛选 - 最后便产生了所需要的结果
function getJSONByRange(fileContent, startTime, endTime) { let jsonSchema = getJSON(fileContent) // 从小到大排 jsonSchema = jsonSchema.sort((a, b) => { const d1 = new Date(a.title) const d2 = new Date(b.title) return d1 - d2 }).filter(v => { const d = new Date(v.title) const s = new Date(startTime) const e = new Date(endTime) return d >= s && d <= e }) return jsonSchema }
JSON转报告内容
期望的报告内容格式如下
# 开始时间 - 结束时间 **总耗时** xxx ## 任务名 >耗时：yyyy * 事件1 * 事件2 * 事件3 ## 任务名 >耗时：yyyy * 事件1 * 事件2 * 事件3
结构定下来后，咱们开始对json数据进行操刀
JSON数据结构如下（复习一下）
[ { "title": "2021-08-03", "tasks": [ { "title": "任务1", "things": [ { "time": "0.2", "content": "a组件" }, { "time": "0.3", "content": "b组件" } ] }, ] }, ]
首先使用一个数组存放每一行的数据的结果（最终md的每一行）
const res = [] // 记录总耗时 let sumTime = 0
开始结束时间分别为json对象的第一项和最后一项的title
const startDate = jsonSchema[0].title const endDate = jsonSchema[jsonSchema.length-1].title // 时间 res.push(`# ${startDate} 至 ${endDate}`)
确定时间之后，就是任务的归类
后面大部分操作都是使用
Array.prototype.reduce，不熟悉的同学可以MDN查询一下
先将所有任务收进同一个数组里：
- 遍历然后用
concat链接这些数组
// 过滤出所有的tasks const allTasks = jsonSchema.reduce((pre,current)=>{ return pre.concat(current.tasks) },[])
合并相同任务(task)的事务(things)
合并前
[ { "title": "任务1", "things": [ { "time": "0.2", "content": "a组件" }, ] }, { "title": "任务1", "things": [ { "time": "0.3", "content": "b组件" } ] }, ]
合并后
[ { "title": "任务1", "things": [ { "time": "0.2", "content": "a组件" }, { "time": "0.3", "content": "b组件" } ] } ]
确定好前后的结构后，逻辑代码就容易书写了:
- 如果
pre为空数组则直接存入 - 遍历已经存入的内容，判断是否存在相同的任务
- 不存在，则加入
pre - 存在，则将其things加入
pre.things
// 合并相同的任务 const tasks = allTasks.reduce((pre,current)=>{ if(pre.length===0){ pre.push(current) return pre } let sameTask = pre.find(v=>v.title===current.title) if(!sameTask){ pre.push(current) return pre } sameTask.things.push(...current.things) return pre },[])
结构整理完毕，接着就是内容的生成了:
- 使用
for...of遍历每一个任务 - 内部使用
Array.prototype.map遍历事务
- 遍历的同时将任务时间计算出来
- 一个任务遍历完，先添加任务耗时，再添加事务列表
- 最后，将所有任务使用的总时间利用数组的
splice方法，将其插入结果第二项
到此，生成范围报告的逻辑就完成了
for (const taskItem of tasks) { res.push('') res.push(`## ${taskItem.title}`) let taskTime = 0 let things = taskItem.things.map(thing=>{ const {time,content} = thing taskTime += (+time) return `* ${content}` }) res.push(`>耗时：${taskTime.toFixed(2)}`) res.push(...things) sumTime += taskTime } res.splice(1,0,`**总耗时** ${sumTime.toFixed(2)}`)
其它
由于每天空闲时间有限，本文就先到这
如果读者还感觉意犹未尽，敬请期待后续更新，或先关注一下仓库
欢迎评论区提需求，交流探讨
本系列会不断的更新迭代，直至产品初代完成
