import { basename, extname } from 'path'; import picocolors from 'picocolors'; const SPAN_STATUS_START = 0; const SPAN_STATUS_END = 1; const spanTag = Symbol('span'); export interface TraceResult { name: string, start: number, end: number, children: TraceResult[] } const rootTraceResult: TraceResult = { name: 'root', start: 0, end: 0, children: [] }; export interface Span { [spanTag]: true, readonly stop: (time?: number) => void, readonly traceChild: (name: string) => Span, readonly traceSyncFn: (fn: (span: Span) => T) => T, readonly traceAsyncFn: (fn: (span: Span) => T | Promise) => Promise, readonly tracePromise: (promise: Promise) => Promise, readonly traceChildSync: (name: string, fn: (span: Span) => T) => T, readonly traceChildAsync: (name: string, fn: (span: Span) => Promise) => Promise, readonly traceChildPromise: (name: string, promise: Promise) => Promise, readonly traceResult: TraceResult } export const createSpan = (name: string, parentTraceResult?: TraceResult): Span => { const start = performance.now(); let curTraceResult: TraceResult; if (parentTraceResult == null) { curTraceResult = rootTraceResult; } else { curTraceResult = { name, start, end: 0, children: [] }; parentTraceResult.children.push(curTraceResult); } let status: typeof SPAN_STATUS_START | typeof SPAN_STATUS_END = SPAN_STATUS_START; const stop = (time?: number) => { if (status === SPAN_STATUS_END) { throw new Error(`span already stopped: ${name}`); } const end = time ?? performance.now(); curTraceResult.end = end; status = SPAN_STATUS_END; }; const traceChild = (name: string) => createSpan(name, curTraceResult); const span: Span = { [spanTag]: true, stop, traceChild, traceSyncFn(fn: (span: Span) => T) { const res = fn(span); span.stop(); return res; }, async traceAsyncFn(fn: (span: Span) => T | Promise): Promise { const res = await fn(span); span.stop(); return res; }, traceResult: curTraceResult, async tracePromise(promise: Promise): Promise { const res = await promise; span.stop(); return res; }, traceChildSync: (name: string, fn: (span: Span) => T): T => traceChild(name).traceSyncFn(fn), traceChildAsync: (name: string, fn: (span: Span) => T | Promise): Promise => traceChild(name).traceAsyncFn(fn), traceChildPromise: (name: string, promise: Promise): Promise => traceChild(name).tracePromise(promise) }; // eslint-disable-next-line sukka/no-redundant-variable -- self reference return span; }; export const task = (importMetaMain: boolean, importMetaPath: string) => (fn: (span: Span) => Promise, customName?: string) => { const taskName = customName ?? basename(importMetaPath, extname(importMetaPath)); const dummySpan = createSpan(taskName); if (importMetaMain) { fn(dummySpan); } return async (span?: Span) => { if (span) { return span.traceChildAsync(taskName, fn); } return fn(dummySpan); }; }; // const isSpan = (obj: any): obj is Span => { // return typeof obj === 'object' && obj && spanTag in obj; // }; // export const universalify = (taskname: string, fn: (this: void, ...args: A) => R) => { // return (...args: A) => { // const lastArg = args[args.length - 1]; // if (isSpan(lastArg)) { // return lastArg.traceChild(taskname).traceSyncFn(() => fn(...args)); // } // return fn(...args); // }; // }; export const printTraceResult = (traceResult: TraceResult = rootTraceResult) => { printStats(traceResult.children); printTree(traceResult, node => `${node.name} ${picocolors.bold(`${(node.end - node.start).toFixed(3)}ms`)}`); }; function printTree(initialTree: TraceResult, printNode: (node: TraceResult, branch: string) => string) { function printBranch(tree: TraceResult, branch: string, isGraphHead: boolean, isChildOfLastBranch: boolean) { const children = tree.children; let branchHead = ''; if (!isGraphHead) { branchHead = children.length > 0 ? '┬ ' : '─ '; } const toPrint = printNode(tree, `${branch}${branchHead}`); if (typeof toPrint === 'string') { console.log(`${branch}${branchHead}${toPrint}`); } let baseBranch = branch; if (!isGraphHead) { baseBranch = branch.slice(0, -2) + (isChildOfLastBranch ? ' ' : '│ '); } const nextBranch = `${baseBranch}├─`; const lastBranch = `${baseBranch}└─`; children.forEach((child, index) => { const last = children.length - 1 === index; printBranch(child, last ? lastBranch : nextBranch, false, last); }); } printBranch(initialTree, '', true, false); } function printStats(stats: TraceResult[]): void { const longestTaskName = Math.max(...stats.map(i => i.name.length)); const realStart = Math.min(...stats.map(i => i.start)); const realEnd = Math.max(...stats.map(i => i.end)); const statsStep = ((realEnd - realStart) / 120) | 0; stats .sort((a, b) => a.start - b.start) .forEach(stat => { console.log( `[${stat.name}]${' '.repeat(longestTaskName - stat.name.length)}`, ' '.repeat(((stat.start - realStart) / statsStep) | 0), '='.repeat(Math.max(((stat.end - stat.start) / statsStep) | 0, 1)) ); }); }