@jsenv/humanize 1.5.2 → 1.7.0

package/src/log/logger.js

@@ -1,85 +0,0 @@
-import {
-  LOG_LEVEL_DEBUG,
-  LOG_LEVEL_ERROR,
-  LOG_LEVEL_INFO,
-  LOG_LEVEL_OFF,
-  LOG_LEVEL_WARN,
-} from "./LOG_LEVELS.js";
-
-export const createLogger = ({ logLevel = LOG_LEVEL_INFO } = {}) => {
-  if (logLevel === LOG_LEVEL_DEBUG) {
-    return {
-      level: "debug",
-      levels: { debug: true, info: true, warn: true, error: true },
-      debug,
-      info,
-      warn,
-      error,
-    };
-  }
-  if (logLevel === LOG_LEVEL_INFO) {
-    return {
-      level: "info",
-      levels: { debug: false, info: true, warn: true, error: true },
-      debug: debugDisabled,
-      info,
-      warn,
-      error,
-    };
-  }
-  if (logLevel === LOG_LEVEL_WARN) {
-    return {
-      level: "warn",
-      levels: { debug: false, info: false, warn: true, error: true },
-      debug: debugDisabled,
-      info: infoDisabled,
-      warn,
-      error,
-    };
-  }
-  if (logLevel === LOG_LEVEL_ERROR) {
-    return {
-      level: "error",
-      levels: { debug: false, info: false, warn: false, error: true },
-      debug: debugDisabled,
-      info: infoDisabled,
-      warn: warnDisabled,
-      error,
-    };
-  }
-  if (logLevel === LOG_LEVEL_OFF) {
-    return {
-      level: "off",
-      levels: { debug: false, info: false, warn: false, error: false },
-      debug: debugDisabled,
-      info: infoDisabled,
-      warn: warnDisabled,
-      error: errorDisabled,
-    };
-  }
-  throw new Error(`unexpected logLevel.
---- logLevel ---
-${logLevel}
---- allowed log levels ---
-${LOG_LEVEL_OFF}
-${LOG_LEVEL_ERROR}
-${LOG_LEVEL_WARN}
-${LOG_LEVEL_INFO}
-${LOG_LEVEL_DEBUG}`);
-};
-
-const debug = (...args) => console.debug(...args);
-
-const debugDisabled = () => {};
-
-const info = (...args) => console.info(...args);
-
-const infoDisabled = () => {};
-
-const warn = (...args) => console.warn(...args);
-
-const warnDisabled = () => {};
-
-const error = (...args) => console.error(...args);
-
-const errorDisabled = () => {};

package/src/log/section.js

@@ -1,50 +0,0 @@
-import stripAnsi from "strip-ansi";
-import { ANSI } from "../ansi/ansi_node.js";
-
-export const renderBigSection = (params) => {
-  return renderSection({
-    width: 45,
-    ...params,
-  });
-};
-
-export const renderSection = ({
-  title,
-  content,
-  dashColor = ANSI.GREY,
-  width = 38,
-  bottomSeparator = true,
-}) => {
-  let section = "";
-
-  if (title) {
-    const titleWidth = stripAnsi(title).length;
-    const minWidthRequired = `--- … ---`.length;
-    const needsTruncate = titleWidth + minWidthRequired >= width;
-    if (needsTruncate) {
-      const titleTruncated = title.slice(0, width - minWidthRequired);
-      const leftDashes = ANSI.color("---", dashColor);
-      const rightDashes = ANSI.color("---", dashColor);
-      section += `${leftDashes} ${titleTruncated}… ${rightDashes}`;
-    } else {
-      const remainingWidth = width - titleWidth - 2; // 2 for spaces around the title
-      const dashLeftCount = Math.floor(remainingWidth / 2);
-      const dashRightCount = remainingWidth - dashLeftCount;
-      const leftDashes = ANSI.color("-".repeat(dashLeftCount), dashColor);
-      const rightDashes = ANSI.color("-".repeat(dashRightCount), dashColor);
-      section += `${leftDashes} ${title} ${rightDashes}`;
-    }
-    section += "\n";
-  } else {
-    const topDashes = ANSI.color(`-`.repeat(width), dashColor);
-    section += topDashes;
-    section += "\n";
-  }
-  section += `${content}`;
-  if (bottomSeparator) {
-    section += "\n";
-    const bottomDashes = ANSI.color(`-`.repeat(width), dashColor);
-    section += bottomDashes;
-  }
-  return section;
-};

package/src/log/spinner.js

@@ -1,72 +0,0 @@
-import { ANSI } from "../ansi/ansi_node.js";
-
-export const startSpinner = ({
-  dynamicLog,
-  frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"],
-  fps = 20,
-  keepProcessAlive = false,
-  stopOnWriteFromOutside = true,
-  stopOnVerticalOverflow = true,
-  render = () => "",
-  effect = () => {},
-  animated = dynamicLog.stream.isTTY,
-}) => {
-  let frameIndex = 0;
-  let interval;
-  let running = true;
-
-  const spinner = {
-    message: undefined,
-  };
-
-  const update = (message) => {
-    spinner.message = running
-      ? `${frames[frameIndex]} ${message}\n`
-      : `${message}\n`;
-    return spinner.message;
-  };
-  spinner.update = update;
-
-  let cleanup;
-  if (animated && ANSI.supported) {
-    running = true;
-    cleanup = effect();
-    dynamicLog.update(update(render()));
-
-    interval = setInterval(() => {
-      frameIndex = frameIndex === frames.length - 1 ? 0 : frameIndex + 1;
-      dynamicLog.update(update(render()));
-    }, 1000 / fps);
-    if (!keepProcessAlive) {
-      interval.unref();
-    }
-  } else {
-    dynamicLog.update(update(render()));
-  }
-
-  const stop = (message) => {
-    running = false;
-    if (interval) {
-      clearInterval(interval);
-      interval = null;
-    }
-    if (cleanup) {
-      cleanup();
-      cleanup = null;
-    }
-    if (dynamicLog && message) {
-      dynamicLog.update(update(message));
-      dynamicLog = null;
-    }
-  };
-  spinner.stop = stop;
-
-  if (stopOnVerticalOverflow) {
-    dynamicLog.onVerticalOverflow = stop;
-  }
-  if (stopOnWriteFromOutside) {
-    dynamicLog.onWriteFromOutside = stop;
-  }
-
-  return spinner;
-};

package/src/log/task_log.js

@@ -1,49 +0,0 @@
-import { humanizeDuration } from "../time/time.js";
-import { UNICODE } from "../unicode/unicode_node.js";
-import { createDynamicLog } from "./dynamic_log.js";
-import { startSpinner } from "./spinner.js";
-
-export const createTaskLog = (
-  label,
-  { disabled = false, animated = true, stopOnWriteFromOutside } = {},
-) => {
-  if (disabled) {
-    return {
-      setRightText: () => {},
-      done: () => {},
-      happen: () => {},
-      fail: () => {},
-    };
-  }
-  if (animated && process.env.CAPTURING_SIDE_EFFECTS) {
-    animated = false;
-  }
-  const startMs = Date.now();
-  const dynamicLog = createDynamicLog();
-  let message = label;
-  const taskSpinner = startSpinner({
-    dynamicLog,
-    render: () => message,
-    stopOnWriteFromOutside,
-    animated,
-  });
-  return {
-    setRightText: (value) => {
-      message = `${label} ${value}`;
-    },
-    done: () => {
-      const msEllapsed = Date.now() - startMs;
-      taskSpinner.stop(
-        `${UNICODE.OK} ${label} (done in ${humanizeDuration(msEllapsed)})`,
-      );
-    },
-    happen: (message) => {
-      taskSpinner.stop(
-        `${UNICODE.INFO} ${message} (at ${new Date().toLocaleTimeString()})`,
-      );
-    },
-    fail: (message = `failed to ${label}`) => {
-      taskSpinner.stop(`${UNICODE.FAILURE} ${message}`);
-    },
-  };
-};

package/src/main_browser.js

@@ -1,13 +0,0 @@
-// tslint:disable:ordered-imports
-
-export { createDetailedMessage } from "./log/detailed_message.js";
-export { ANSI } from "./ansi/ansi_browser.js";
-export { UNICODE } from "./unicode/unicode_browser.js";
-export { humanize, humanizeMethodSymbol } from "./js_value/humanize.js";
-export { humanizeDuration, humanizeEllapsedTime } from "./time/time.js";
-export { humanizeFileSize, humanizeMemory } from "./byte/byte.js";
-export { distributePercentages } from "./percentage/distribute_percentages.js";
-export { generateContentFrame } from "./content_frame/content_frame.js";
-export { createCallOrderer } from "./log/call_orderer.js";
-export { errorToMarkdown } from "./error/error_to_markdown.js";
-export { errorToHTML } from "./error/error_to_html.js";

package/src/main_node.js

@@ -1,24 +0,0 @@
-// tslint:disable:ordered-imports
-
-export {
-  createDetailedMessage,
-  renderNamedSections,
-} from "./log/detailed_message.js";
-export { ANSI } from "./ansi/ansi_node.js";
-export { UNICODE } from "./unicode/unicode_node.js";
-export { humanize, humanizeMethodSymbol } from "./js_value/humanize.js";
-export { humanizeDuration, humanizeEllapsedTime } from "./time/time.js";
-export { humanizeFileSize, humanizeMemory } from "./byte/byte.js";
-export { distributePercentages } from "./percentage/distribute_percentages.js";
-export { generateContentFrame } from "./content_frame/content_frame.js";
-export { createCallOrderer } from "./log/call_orderer.js";
-export { errorToMarkdown } from "./error/error_to_markdown.js";
-export { errorToHTML } from "./error/error_to_html.js";
-
-// node only
-export { renderSection, renderBigSection } from "./log/section.js";
-export { renderDetails } from "./log/details.js";
-export { createLogger } from "./log/logger.js";
-export { createDynamicLog } from "./log/dynamic_log.js";
-export { startSpinner } from "./log/spinner.js";
-export { createTaskLog } from "./log/task_log.js";

package/src/percentage/distribute_percentages.js

@@ -1,53 +0,0 @@
-import { getPrecision, setRoundedPrecision } from "../utils/decimals.js";
-
-export const distributePercentages = (
-  namedNumbers,
-  { maxPrecisionHint = 2 } = {},
-) => {
-  const numberNames = Object.keys(namedNumbers);
-  if (numberNames.length === 0) {
-    return {};
-  }
-  if (numberNames.length === 1) {
-    const firstNumberName = numberNames[0];
-    return { [firstNumberName]: "100 %" };
-  }
-  const numbers = numberNames.map((name) => namedNumbers[name]);
-  const total = numbers.reduce((sum, value) => sum + value, 0);
-  const ratios = numbers.map((number) => number / total);
-  const percentages = {};
-  ratios.pop();
-  ratios.forEach((ratio, index) => {
-    const percentage = ratio * 100;
-    percentages[numberNames[index]] = percentage;
-  });
-  const lowestPercentage = (1 / Math.pow(10, maxPrecisionHint)) * 100;
-  let precision = 0;
-  Object.keys(percentages).forEach((name) => {
-    const percentage = percentages[name];
-    if (percentage < lowestPercentage) {
-      // check the amout of meaningful decimals
-      // and that what we will use
-      const percentageRounded = setRoundedPrecision(percentage);
-      const percentagePrecision = getPrecision(percentageRounded);
-      if (percentagePrecision > precision) {
-        precision = percentagePrecision;
-      }
-    }
-  });
-  let remainingPercentage = 100;
-
-  Object.keys(percentages).forEach((name) => {
-    const percentage = percentages[name];
-    const percentageAllocated = setRoundedPrecision(percentage, {
-      decimals: precision,
-    });
-    remainingPercentage -= percentageAllocated;
-    percentages[name] = percentageAllocated;
-  });
-  const lastName = numberNames[numberNames.length - 1];
-  percentages[lastName] = setRoundedPrecision(remainingPercentage, {
-    decimals: precision,
-  });
-  return percentages;
-};

package/src/time/time.js

@@ -1,151 +0,0 @@
-import { setPrecision, setRoundedPrecision } from "../utils/decimals.js";
-
-export const humanizeEllapsedTime = (ms, { short } = {}) => {
-  if (ms < 1000) {
-    return short ? "0s" : "0 second";
-  }
-  const { primary, remaining } = parseMs(ms);
-  if (!remaining) {
-    return inspectEllapsedUnit(primary, short);
-  }
-  return `${inspectEllapsedUnit(primary, short)} and ${inspectEllapsedUnit(
-    remaining,
-    short,
-  )}`;
-};
-const inspectEllapsedUnit = (unit, short) => {
-  const count =
-    unit.name === "second" ? Math.floor(unit.count) : Math.round(unit.count);
-  let name = unit.name;
-  if (short) {
-    name = unitShort[name];
-    if (count <= 1) {
-      return `${count}${name}`;
-    }
-    return `${count}${name}s`;
-  }
-  if (count <= 1) {
-    return `${count} ${name}`;
-  }
-  return `${count} ${name}s`;
-};
-const unitShort = {
-  year: "y",
-  month: "m",
-  week: "w",
-  day: "d",
-  hour: "h",
-  minute: "m",
-  second: "s",
-};
-
-export const humanizeDuration = (
-  ms,
-  { short, rounded = true, decimals } = {},
-) => {
-  // ignore ms below meaningfulMs so that:
-  // humanizeDuration(0.5) -> "0 second"
-  // humanizeDuration(1.1) -> "0.001 second" (and not "0.0011 second")
-  // This tool is meant to be read by humans and it would be barely readable to see
-  // "0.0001 second" (stands for 0.1 millisecond)
-  // yes we could return "0.1 millisecond" but we choosed consistency over precision
-  // so that the prefered unit is "second" (and does not become millisecond when ms is super small)
-  if (ms < 1) {
-    return short ? "0s" : "0 second";
-  }
-  const { primary, remaining } = parseMs(ms);
-  if (!remaining) {
-    return humanizeDurationUnit(primary, {
-      decimals:
-        decimals === undefined ? (primary.name === "second" ? 1 : 0) : decimals,
-      short,
-      rounded,
-    });
-  }
-  return `${humanizeDurationUnit(primary, {
-    decimals: decimals === undefined ? 0 : decimals,
-    short,
-    rounded,
-  })} and ${humanizeDurationUnit(remaining, {
-    decimals: decimals === undefined ? 0 : decimals,
-    short,
-    rounded,
-  })}`;
-};
-const humanizeDurationUnit = (unit, { decimals, short, rounded }) => {
-  const count = rounded
-    ? setRoundedPrecision(unit.count, { decimals })
-    : setPrecision(unit.count, { decimals });
-  let name = unit.name;
-  if (short) {
-    name = unitShort[name];
-    return `${count}${name}`;
-  }
-  if (count <= 1) {
-    return `${count} ${name}`;
-  }
-  return `${count} ${name}s`;
-};
-const MS_PER_UNITS = {
-  year: 31_557_600_000,
-  month: 2_629_000_000,
-  week: 604_800_000,
-  day: 86_400_000,
-  hour: 3_600_000,
-  minute: 60_000,
-  second: 1000,
-};
-
-const parseMs = (ms) => {
-  const unitNames = Object.keys(MS_PER_UNITS);
-  const smallestUnitName = unitNames[unitNames.length - 1];
-  let firstUnitName = smallestUnitName;
-  let firstUnitCount = ms / MS_PER_UNITS[smallestUnitName];
-  const firstUnitIndex = unitNames.findIndex((unitName) => {
-    if (unitName === smallestUnitName) {
-      return false;
-    }
-    const msPerUnit = MS_PER_UNITS[unitName];
-    const unitCount = Math.floor(ms / msPerUnit);
-    if (unitCount) {
-      firstUnitName = unitName;
-      firstUnitCount = unitCount;
-      return true;
-    }
-    return false;
-  });
-  if (firstUnitName === smallestUnitName) {
-    return {
-      primary: {
-        name: firstUnitName,
-        count: firstUnitCount,
-      },
-    };
-  }
-  const remainingMs = ms - firstUnitCount * MS_PER_UNITS[firstUnitName];
-  const remainingUnitName = unitNames[firstUnitIndex + 1];
-  const remainingUnitCount = remainingMs / MS_PER_UNITS[remainingUnitName];
-  // - 1 year and 1 second is too much information
-  //   so we don't check the remaining units
-  // - 1 year and 0.0001 week is awful
-  //   hence the if below
-  if (Math.round(remainingUnitCount) < 1) {
-    return {
-      primary: {
-        name: firstUnitName,
-        count: firstUnitCount,
-      },
-    };
-  }
-  // - 1 year and 1 month is great
-  return {
-    primary: {
-      name: firstUnitName,
-      count: firstUnitCount,
-    },
-    remaining: {
-      name: remainingUnitName,
-      count: remainingUnitCount,
-    },
-  };
-};

package/src/unicode/unicode_browser.js

@@ -1,7 +0,0 @@
-import { ANSI } from "../ansi/ansi_browser.js";
-import { createUnicode } from "./unicode_runtime_agnostic.js";
-
-export const UNICODE = createUnicode({
-  supported: true,
-  ANSI,
-});

package/src/unicode/unicode_node.js

@@ -1,8 +0,0 @@
-import isUnicodeSupported from "is-unicode-supported";
-import { ANSI } from "../ansi/ansi_node.js";
-import { createUnicode } from "./unicode_runtime_agnostic.js";
-
-export const UNICODE = createUnicode({
-  supported: process.env.FORCE_UNICODE === "1" || isUnicodeSupported(),
-  ANSI,
-});

package/src/unicode/unicode_runtime_agnostic.js

@@ -1,56 +0,0 @@
-// see also https://github.com/sindresorhus/figures
-
-export const createUnicode = ({ supported, ANSI }) => {
-  const UNICODE = {
-    supported,
-    get COMMAND_RAW() {
-      return UNICODE.supported ? `❯` : `>`;
-    },
-    get OK_RAW() {
-      return UNICODE.supported ? `✔` : `√`;
-    },
-    get FAILURE_RAW() {
-      return UNICODE.supported ? `✖` : `×`;
-    },
-    get DEBUG_RAW() {
-      return UNICODE.supported ? `◆` : `♦`;
-    },
-    get INFO_RAW() {
-      return UNICODE.supported ? `ℹ` : `i`;
-    },
-    get WARNING_RAW() {
-      return UNICODE.supported ? `⚠` : `‼`;
-    },
-    get CIRCLE_CROSS_RAW() {
-      return UNICODE.supported ? `ⓧ` : `(×)`;
-    },
-    get CIRCLE_DOTTED_RAW() {
-      return UNICODE.supported ? `◌` : `*`;
-    },
-    get COMMAND() {
-      return ANSI.color(UNICODE.COMMAND_RAW, ANSI.GREY); // ANSI_MAGENTA)
-    },
-    get OK() {
-      return ANSI.color(UNICODE.OK_RAW, ANSI.GREEN);
-    },
-    get FAILURE() {
-      return ANSI.color(UNICODE.FAILURE_RAW, ANSI.RED);
-    },
-    get DEBUG() {
-      return ANSI.color(UNICODE.DEBUG_RAW, ANSI.GREY);
-    },
-    get INFO() {
-      return ANSI.color(UNICODE.INFO_RAW, ANSI.BLUE);
-    },
-    get WARNING() {
-      return ANSI.color(UNICODE.WARNING_RAW, ANSI.YELLOW);
-    },
-    get CIRCLE_CROSS() {
-      return ANSI.color(UNICODE.CIRCLE_CROSS_RAW, ANSI.RED);
-    },
-    get ELLIPSIS() {
-      return UNICODE.supported ? `…` : `...`;
-    },
-  };
-  return UNICODE;
-};

package/src/utils/decimals.js

@@ -1,95 +0,0 @@
-export const getPrecision = (number) => {
-  if (Math.floor(number) === number) return 0;
-  const [, decimals] = number.toString().split(".");
-  return decimals.length || 0;
-};
-
-export const setRoundedPrecision = (
-  number,
-  { decimals = 1, decimalsWhenSmall = decimals } = {},
-) => {
-  return setDecimalsPrecision(number, {
-    decimals,
-    decimalsWhenSmall,
-    transform: Math.round,
-  });
-};
-
-export const setFlooredPrecision = (
-  number,
-  { decimals = 1, decimalsWhenSmall = decimals } = {},
-) => {
-  return setDecimalsPrecision(number, {
-    decimals,
-    decimalsWhenSmall,
-    transform: Math.floor,
-  });
-};
-
-export const setCeiledPrecision = (
-  number,
-  { decimals = 1, decimalsWhenSmall = decimals } = {},
-) => {
-  return setDecimalsPrecision(number, {
-    decimals,
-    decimalsWhenSmall,
-    transform: Math.ceil,
-  });
-};
-
-export const setPrecision = (
-  number,
-  { decimals = 1, decimalsWhenSmall = decimals } = {},
-) => {
-  return setDecimalsPrecision(number, {
-    decimals,
-    decimalsWhenSmall,
-    transform: parseInt,
-  });
-};
-
-const setDecimalsPrecision = (
-  number,
-  {
-    transform,
-    decimals, // max decimals for number in [-Infinity, -1[]1, Infinity]
-    decimalsWhenSmall, // max decimals for number in [-1,1]
-  } = {},
-) => {
-  if (number === 0) {
-    return 0;
-  }
-  let numberCandidate = Math.abs(number);
-  if (numberCandidate < 1) {
-    const integerGoal = Math.pow(10, decimalsWhenSmall - 1);
-    let i = 1;
-    while (numberCandidate < integerGoal) {
-      numberCandidate *= 10;
-      i *= 10;
-    }
-    const asInteger = transform(numberCandidate);
-    const asFloat = asInteger / i;
-    return number < 0 ? -asFloat : asFloat;
-  }
-  const coef = Math.pow(10, decimals);
-  const numberMultiplied = (number + Number.EPSILON) * coef;
-  const asInteger = transform(numberMultiplied);
-  const asFloat = asInteger / coef;
-  return number < 0 ? -asFloat : asFloat;
-};
-
-// https://www.codingem.com/javascript-how-to-limit-decimal-places/
-// export const roundNumber = (number, maxDecimals) => {
-//   const decimalsExp = Math.pow(10, maxDecimals)
-//   const numberRoundInt = Math.round(decimalsExp * (number + Number.EPSILON))
-//   const numberRoundFloat = numberRoundInt / decimalsExp
-//   return numberRoundFloat
-// }
-
-// export const setPrecision = (number, precision) => {
-//   if (Math.floor(number) === number) return number
-//   const [int, decimals] = number.toString().split(".")
-//   if (precision <= 0) return int
-//   const numberTruncated = `${int}.${decimals.slice(0, precision)}`
-//   return numberTruncated
-// }