awais-tool/utils/meow/index.js

Get to know via `npx itishaawais`

import process from "node:process";
import parseArguments from "yargs-parser";
import camelCaseKeys from "camelcase-keys";
import { trimNewlines } from "trim-newlines";
import redent from "redent";
import { buildOptions } from "./options.js";
import { buildParserOptions } from "./parser.js";
import {
  validate,
  checkUnknownFlags,
  checkMissingRequiredFlags,
} from "./validate.js";

const buildResult = ({ pkg: packageJson, ...options }, parserOptions) => {
  const argv = parseArguments(options.argv, parserOptions);
  let help = "";

  if (options.help) {
    help = trimNewlines((options.help || "").replace(/\t+\n*$/, ""));

    if (help.includes("\n")) {
      help = redent(help, options.helpIndent);
    }

    help = `\n${help}`;
  }

  if (options.description !== false) {
    let { description } = options;

    if (description) {
      description = help
        ? redent(`\n${description}\n`, options.helpIndent)
        : `\n${description}`;
      help = `${description}${help}`;
    }
  }

  help += "\n";

  const showHelp = (code) => {
    console.log(help);
    process.exit(typeof code === "number" ? code : 2); // Default to code 2 for incorrect usage (#47)
  };

  const showVersion = () => {
    console.log(options.version);
    process.exit(0);
  };

  if (argv._.length === 0 && options.argv.length === 1) {
    if (argv.version === true && options.autoVersion) {
      showVersion();
    } else if (argv.help === true && options.autoHelp) {
      showHelp(0);
    }
  }

  const input = argv._;
  delete argv._;

  if (!options.allowUnknownFlags) {
    checkUnknownFlags(input);
  }

  const flags = camelCaseKeys(argv, { exclude: ["--", /^\w$/] });
  const unnormalizedFlags = { ...flags };

  validate(flags, options);

  for (const flagValue of Object.values(options.flags)) {
    if (Array.isArray(flagValue.aliases)) {
      for (const alias of flagValue.aliases) {
        delete flags[alias];
      }
    }

    delete flags[flagValue.shortFlag];
  }

  checkMissingRequiredFlags(options.flags, flags, input);

  return {
    input,
    flags,
    unnormalizedFlags,
    pkg: packageJson,
    help,
    showHelp,
    showVersion,
  };
};

const meow = (helpText, options = {}) => {
  const parsedOptions = buildOptions(helpText, options);
  const parserOptions = buildParserOptions(parsedOptions);
  const result = buildResult(parsedOptions, parserOptions);

  process.title = result.pkg.bin
    ? Object.keys(result.pkg.bin).at(0)
    : result.pkg.name;

  return result;
};

export default meow;