@abcnews/aunty 16.0.0 → 17.0.0-next.0

package/src/cli/deploy/index.js

@@ -1,151 +0,0 @@
-// Native
-const { existsSync, statSync } = require('fs');
-const { join } = require('path');
-
-// External
-const importLazy = require('import-lazy')(require);
-const loadJsonFile = importLazy('load-json-file');
-const { deploymentExists } = require('../../utils/ftp');
-const { to: wrap } = require('await-to-js');
-const cliSelect = importLazy('cli-select');
-
-// Ours
-const { command } = require('../');
-const { addProfileProperties } = require('../../config/deploy');
-const { getProjectConfig } = require('../../config/project');
-const { DEPLOY_FILE_NAME, OUTPUT_DIRECTORY_NAME } = require('../../constants');
-const { throws } = require('../../utils/async');
-const { dry, info, spin, warn, log, error } = require('../../utils/logging');
-const { ftp, rsync } = require('../../utils/remote');
-const { MESSAGES, VALID_TYPES } = require('./constants');
-const { dim, opt, hvy, req } = require('../../utils/color');
-
-module.exports = command(
-  {
-    name: 'deploy',
-    usage: MESSAGES.usage
-  },
-  async argv => {
-    const { root } = getProjectConfig();
-    let deployConfig;
-
-    // 1) Load the deploy configuration (created by the build process)
-
-    try {
-      deployConfig = loadJsonFile.sync(join(root, OUTPUT_DIRECTORY_NAME, DEPLOY_FILE_NAME));
-    } catch (err) {
-      throw new Error(MESSAGES.noDeployConfigFile);
-    }
-
-    let { id, targets } = deployConfig;
-
-    if (!Array.isArray(targets)) {
-      throw new Error(MESSAGES.noDeployConfigFile);
-    }
-
-    // 2) Add profile properties (type, host, port, username, password) to each target
-
-    targets = targets.map(addProfileProperties);
-
-    // 3) Validate the deploy configuration
-
-    for (let target of targets) {
-      const { from, type } = target;
-
-      // 3.1) Check profile's 'type' is valid
-      if (!VALID_TYPES.has(type)) {
-        throw MESSAGES.unrecognisedType(type);
-      }
-
-      // 3.2) Check all required properties are present
-      VALID_TYPES.get(type).REQUIRED_PROPERTIES.forEach(prop => {
-        if (target[prop] == null) {
-          throw MESSAGES.missingProperty(prop);
-        }
-      });
-
-      // 3.3) Check 'from' directory exists
-      if (!existsSync(from) || !statSync(from).isDirectory()) {
-        throw MESSAGES.noFromDirectory(from);
-      }
-
-      // 3.4) For SSH targets, give the `to` directory a trailing slash
-      if (target.type === 'ssh') {
-        target.to = target.to.replace(/\/?$/, '/');
-      }
-    }
-
-    // 4a) Log config
-
-    if (argv.dry) {
-      return dry({
-        'Deploy config': { id, targets }
-      });
-    }
-
-    // 4b) Deploy
-
-    for (let target of targets) {
-      const { publicPath, type, to } = target;
-      let shouldOverwrite = false;
-
-      // Check if the deployment already exists
-      if (argv.force) shouldOverwrite = true;
-      else if (type === 'ftp') {
-        const [checkErr] = await wrap(deploymentExists(to));
-
-        if (checkErr) {
-          if (checkErr.code === 550) {
-            // Directory doesn't exist. This is actually good though. OK to write.
-            shouldOverwrite = true;
-          } else {
-            error('An FTP error ocurred');
-          }
-        } else {
-          warn('Destination directory exists. OK to overwrite?');
-          log(`  ┗ ${hvy('dir')}: ${req(to)}`);
-
-          const overwriteSelection = (
-            await cliSelect({
-              defaultValue: 1,
-              selected: opt('❯'),
-              unselected: ' ',
-              values: [
-                { label: 'Yes', choice: true },
-                { label: 'No', choice: false }
-              ],
-              valueRenderer: ({ label }, selected) => (selected ? opt(label) : label)
-            })
-          ).value;
-          shouldOverwrite = overwriteSelection.choice;
-          log(`${dim(`Destination overwrite: ${shouldOverwrite}`)}\n`);
-        }
-      }
-
-      // Overwrite by default if ssh for now
-      if (type === 'ssh') shouldOverwrite = true;
-
-      if (shouldOverwrite) {
-        info(MESSAGES.deploy(target));
-
-        const spinner = spin('Deploying');
-
-        try {
-          if (type === 'ftp') {
-            throws(await ftp(target, spinner));
-          } else if (type === 'ssh') {
-            throws(await rsync(target));
-          }
-        } catch (err) {
-          spinner.fail('Deployment failed');
-
-          throw err;
-        }
-
-        spinner.succeed(MESSAGES.deployed(publicPath));
-      } else {
-        log('Exiting');
-      }
-    }
-  }
-);

package/src/cli/generate/constants.js

@@ -1,39 +0,0 @@
-// Ours
-const { cmd, hvy, opt, req, sec } = require('../../utils/color');
-
-module.exports.OPTIONS = {
-  boolean: ['announce'],
-  alias: {
-    announce: 'a'
-  }
-};
-
-const GENERATOR_ALIASES = (module.exports.GENERATOR_ALIASES = {
-  c: 'component',
-  p: 'project'
-});
-
-module.exports.GENERATORS = new Set(Object.values(GENERATOR_ALIASES));
-
-module.exports.MESSAGES = {
-  generatorDoesNotExist: name => `The generator '${name}' does not exist.`,
-  noDryRuns: `Generators don't have dry runs (yet). Please run without the ${opt('--dry')} flag.`,
-  usage: `Usage: ${cmd('aunty generate')} ${req('<generator>')} ${opt('[options]')} -- ${opt('[generator_options]')}
-
-${sec('Options')}
-
-  ${opt('-h')}, ${opt('--help')}  Output the available generators, and exit.
-
-${sec('Generators')}
-
-  ${hvy('Project creation')}
-
-  ${req('project')}     Create a new project (aliased by ${cmd('aunty new')} and ${cmd('aunty init')}).
-
-  ${hvy('Project additions')}
-
-  ${req('component')}   Add a component (and tests) to ${req('src/components/')} for your project type.
-
-  Run ${cmd('aunty generate')} ${req('<generator>')} ${opt('--help')} for details of each generator's options/arguments.
-`
-};

package/src/cli/generate/index.js

@@ -1,72 +0,0 @@
-// External
-const importLazy = require('import-lazy')(require);
-const yeoman = importLazy('yeoman-environment');
-
-// Ours
-const { pack } = require('../../utils/async');
-const { announce } = require('../../utils/audio');
-const { createCommandLogo } = require('../../utils/branding');
-const { log } = require('../../utils/logging');
-const { command } = require('../');
-const { GENERATOR_ALIASES, GENERATORS, MESSAGES, OPTIONS } = require('./constants');
-
-const generate = async argv => {
-  if (argv.dry) {
-    throw MESSAGES.noDryRuns;
-  }
-
-  const generatorName = GENERATOR_ALIASES[argv._[0]] || argv._[0];
-
-  // If we didn't supply a known generator name, blow up, unless we wanted
-  // the generate command's usage message (in which case, print it, then exit).
-
-  if (!GENERATORS.has(generatorName)) {
-    if (!generatorName || generatorName.indexOf('-') === 0 || argv.help) {
-      return log(MESSAGES.usage);
-    }
-
-    throw MESSAGES.generatorDoesNotExist(generatorName);
-  }
-
-  log(createCommandLogo(`generate ${generatorName}`));
-
-  // If we're in a test environment, insert the auto adapter with the provided answers
-  const env = global.auntyYeomanAnswers
-    ? yeoman.createEnv([], {}, new (require('yeoman-automation-adapter').AutoAdapter)(global.auntyYeomanAnswers, true))
-    : yeoman.createEnv();
-
-  // Register the generator
-
-  const generatorPath = require.resolve(`../../generators/${generatorName}`);
-
-  env.register(generatorPath, generatorName);
-
-  // Run the generator, including known arguments
-
-  const runArgs = [generatorName]
-    .concat(argv['--'])
-    .concat(argv.help ? ['--help'] : [])
-    .join(' ');
-
-  const [err] = await pack(env.run(runArgs));
-
-  if (err) {
-    throw err;
-  }
-
-  if (argv.announce) {
-    announce();
-  }
-};
-
-module.exports = command(
-  {
-    name: 'generate',
-    hasSubcommands: true,
-    options: OPTIONS
-  },
-  generate
-);
-
-// Expose this for the tests
-module.exports._testGenerate = generate;

package/src/cli/index.js

@@ -1,154 +0,0 @@
-// Env
-require('dotenv').config();
-
-// Native
-const { resolve } = require('path');
-
-// External
-const importLazy = require('import-lazy')(require);
-const minimist = importLazy('minimist');
-
-// Ours
-const pkg = require('../../package');
-const { getProjectConfig } = require('../config/project');
-const { pack, packs, throws } = require('../utils/async');
-const { createCommandLogo } = require('../utils/branding');
-const { log, timer } = require('../utils/logging');
-const { merge } = require('../utils/structures');
-const {
-  COMMAND_ALIASES,
-  COMMANDS,
-  DEFAULTS,
-  DRY_VARIATIONS,
-  HELP_VARIATIONS,
-  MESSAGES,
-  SHORTHANDS,
-  VERSION_VARIATIONS
-} = require('./constants');
-
-module.exports.cli = packs(async args => {
-  const __DEBUG__stopTimer = timer('CLI');
-
-  const updateNotifier = (await import('update-notifier')).default;
-
-  updateNotifier({ pkg, updateCheckInterval: 36e5 }).notify();
-
-  // If we just want aunty's version number, print it, then exit
-
-  if (args.some(arg => VERSION_VARIATIONS.includes(arg))) {
-    return log(MESSAGES.version(pkg.version));
-  }
-
-  // Normalise the arguments (see function) and split them
-
-  args = normalise(args);
-  const [commandName, ...commandArgs] = args;
-
-  // If we didn't supply a known command name, blow up, unless we wanted
-  // aunty's usage message (in which case, print it, then exit).
-
-  if (!COMMANDS.has(commandName)) {
-    if (!commandName || args.includes(HELP_VARIATIONS[0])) {
-      let isProject = true;
-
-      try {
-        const { type } = getProjectConfig();
-
-        isProject = !!type;
-      } catch (e) {
-        isProject = false;
-      }
-
-      return log(MESSAGES.usage(isProject));
-    }
-
-    throw MESSAGES.unrecognised(commandName);
-  }
-
-  // Import the command
-
-  const __DEBUG__stopImportTimer = timer(`CLI.import(${commandName})`);
-
-  const commandFn = require(resolve(__dirname, `./${commandName}`));
-
-  if (process.env.AUNTY_DEBUG) {
-    __DEBUG__stopImportTimer();
-  }
-
-  // Execute the command with the remaining arguments
-
-  const __DEBUG__stopExecuteTimer = timer(`CLI.execute(${commandName})`);
-
-  throws(await commandFn(commandArgs, true));
-
-  if (process.env.AUNTY_DEBUG) {
-    __DEBUG__stopExecuteTimer();
-    __DEBUG__stopTimer();
-  }
-});
-
-const normalise = args => {
-  // 1) Move any dry argument variation to second position, as '--dry'
-
-  const dryArgIndex = args.findIndex(arg => DRY_VARIATIONS.includes(arg));
-
-  if (dryArgIndex > -1) {
-    args.splice(dryArgIndex, 1);
-    args.splice(1, 0, DRY_VARIATIONS[0]);
-  }
-
-  // 2) Move any help argument variation to second position, as '--help'
-
-  const helpArgIndex = args.findIndex(arg => HELP_VARIATIONS.includes(arg));
-
-  if (helpArgIndex > -1) {
-    args.splice(helpArgIndex, 1);
-    args.splice(1, 0, HELP_VARIATIONS[0]);
-  }
-
-  // 3) If the first argument is a command alias, expand it
-
-  args[0] = COMMAND_ALIASES[args[0]] || args[0];
-
-  // 4) If the first argument is a shorthand, expand it
-
-  const shorthand = SHORTHANDS[args[0]];
-
-  if (shorthand) {
-    args.splice.apply(args, [0, 1].concat(shorthand));
-  }
-
-  // 5) Return the normalised arguments
-
-  return args;
-};
-
-module.exports.command = ({ name, nodeEnv, options, usage, hasSubcommands }, fn) => {
-  name = name || DEFAULTS.name;
-  options = merge(DEFAULTS.options, options);
-  usage = usage || DEFAULTS.usage;
-
-  return packs(async (args = [], isEntryCommand) => {
-    const argv = minimist(args, options);
-
-    if (!hasSubcommands) {
-      if (argv.help) {
-        return log(typeof usage === 'function' ? usage(name) : usage);
-      }
-
-      if (isEntryCommand) {
-        log(createCommandLogo(name, argv.dry));
-      }
-    }
-
-    if (!process.env.NODE_ENV && nodeEnv) {
-      process.env.NODE_ENV = nodeEnv;
-    }
-
-    let [err] = await pack(fn(argv));
-
-    if (err) {
-      throw err;
-    }
-  });
-};

package/src/cli/release/constants.js

@@ -1,67 +0,0 @@
-// Ours
-const { cmd, hvy, ok, opt, sec } = require('../../utils/color');
-
-const FORCE_REMINDER = `Use the ${opt('--force')} option to ignore warnings or release without tagging.`;
-const VALID_BUMPS = (module.exports.VALID_BUMPS = new Set(['major', 'minor', 'patch', 'prerelease']));
-
-const OPTIONS = (module.exports.OPTIONS = {
-  string: ['bump', 'git-remote'],
-  default: {
-    'git-remote': 'origin'
-  }
-});
-
-module.exports.MESSAGES = {
-  bumpQuestion: dry =>
-    `${ok('?')} ${hvy(`What package version bump ${dry ? 'would this release have been' : 'is this release'}?`)}`,
-  changes: (tag, tags, changelog) =>
-    changelog.length
-      ? `${tags.length ? `Here's what's changed since ${hvy(tag)}` : 'Here are the initial changes'}:
-
-${changelog.join('\n')}
-`
-      : `${cmd('ℹ')} Nothing has changed since ${hvy(tag)}\n`,
-  createCommit: (from, to) => `Bump version ${hvy(from)} → ${hvy(to)}`,
-  createTag: tag => `Create tag ${hvy(tag)}`,
-  forceReminder: FORCE_REMINDER,
-  hasChanges: `You shouldn't release builds which may contain un-committed changes! ${FORCE_REMINDER}`,
-  hasTag: (tag, isTagOnHead) =>
-    `The tag ${hvy(tag)} already exists${
-      isTagOnHead ? '' : ` and your current HEAD doesn't point to it`
-    }! ${FORCE_REMINDER}`,
-  invalidBump: bump =>
-    `You supplied an invalid bump value ${hvy(bump)}. It can be: ${hvy(Array.from(VALID_BUMPS).join('|'))}`,
-  notDefaultBranch: (label, defaultBranch) =>
-    `You are trying to release from ${hvy(label)}. You should only release from ${hvy(defaultBranch)}`,
-  notRepo: `You can't tag a release or deploy using a tag name becase this project isn't a git repo.`,
-  pushCommit: remote => `Push version bump to remote ${hvy(remote)}`,
-  pushTag: (tag, remote) => `Push tag ${hvy(tag)} to remote ${hvy(remote)}`,
-  usage: name => `Usage: ${cmd(`aunty ${name}`)} ${opt('[options]')}
-
-${sec('Options')}
-
-  ${opt(`--bump={${Array.from(VALID_BUMPS).join('|')}}`)}  Preselect the package version bump for this release ${opt(
-    '[default: PROMPT]'
-  )}
-  ${opt('--git-remote')}                Git remote to push release tags to (if it exists) ${opt(
-    `[default: "${OPTIONS.default['git-remote']}"]`
-  )}
-  ${opt('-d')}, ${opt('--dry')}                   Output the release version & git remote, then exit
-  ${opt('-f')}, ${opt('--force')}                 Ignore warnings & don't bump version ${opt('[default: false]')}
-
-${sec('Examples')}
-
-  ${cmd('aunty release')}
-    1. Ensure working directory is in a deployable state
-    2. Prompt for version bump choice and determine release version
-    3. Run \`${cmd('aunty build')} ${opt('--id=<version>')}\`
-    4. Commit & tag new version, pushing to existing git remote
-    5. Run \`${cmd('aunty deploy')}\`
-    
-  ${cmd(`aunty release ${opt('--bump=major')}`)}
-    As above, skipping (2).
-
-  ${cmd(`aunty release ${opt('--force')}`)}
-    As above, skipping (1, 2 & 4).
-`
-};

package/src/cli/release/index.js

@@ -1,162 +0,0 @@
-// Native
-const { existsSync } = require('fs');
-const { join } = require('path');
-
-// External
-const importLazy = require('import-lazy')(require);
-const cliSelect = importLazy('cli-select');
-const loadJsonFile = importLazy('load-json-file');
-const semver = importLazy('semver');
-const writeJsonFile = importLazy('write-json-file');
-
-// Ours
-const { getProjectConfig } = require('../../config/project');
-const { throws } = require('../../utils/async');
-const { dim, opt } = require('../../utils/color');
-const {
-  commitAll,
-  createTag,
-  getChangelog,
-  getCurrentLabel,
-  getDefaultBranch,
-  getRemotes,
-  getSemverTags,
-  hasChanges,
-  isRepo,
-  push,
-  pushTag
-} = require('../../utils/git');
-const { dry, log, spin } = require('../../utils/logging');
-const { combine } = require('../../utils/structures');
-const { command } = require('../');
-const buildCommand = require('../build');
-const deployCommand = require('../deploy');
-const { MESSAGES, OPTIONS, VALID_BUMPS } = require('./constants');
-
-module.exports = command(
-  {
-    name: 'release',
-    options: OPTIONS,
-    usage: MESSAGES.usage
-  },
-  async argv => {
-    const { pkg, root } = getProjectConfig();
-
-    // 1) Ensure the project is a git repo and determine remotes
-
-    if (!(await isRepo())) {
-      throw MESSAGES.notRepo;
-    }
-
-    const remotes = await getRemotes();
-    const remote = argv['git-remote'];
-
-    // 2) Ensure the default branch is checked out (skippable)
-
-    const label = await getCurrentLabel();
-    const defaultBranch = await getDefaultBranch(remote);
-
-    if (!argv.force && label !== defaultBranch) {
-      throw MESSAGES.notDefaultBranch(label, defaultBranch);
-    }
-
-    // 3) Ensure the project no un-committed changes (skippable)
-
-    if (!argv.force && (await hasChanges())) {
-      throw MESSAGES.hasChanges;
-    }
-
-    // 4) Determine the release version
-
-    if (argv.bump && !VALID_BUMPS.has(argv.bump)) {
-      throw MESSAGES.invalidBump(argv.bump);
-    }
-
-    const pkgVersion = pkg.version;
-    const isPrerelease = semver.prerelease(pkgVersion);
-    let bump = !argv.force && VALID_BUMPS.has(argv.bump) && argv.bump;
-
-    if (!argv.force && !isPrerelease && !bump) {
-      log(MESSAGES.changes(pkgVersion, await getSemverTags(), await getChangelog(pkgVersion)));
-      log(MESSAGES.bumpQuestion(argv.dry));
-
-      const bumpSelection = (
-        await cliSelect({
-          defaultValue: 0,
-          selected: opt('❯'),
-          unselected: ' ',
-          values: [...VALID_BUMPS].reverse().map(bump => ({
-            bump,
-            label: `${bump.replace(/^\w/, c => c.toUpperCase())} (${semver.inc(pkgVersion, bump)})`
-          })),
-          valueRenderer: ({ label }, selected) => (selected ? opt(label) : label)
-        })
-      ).value;
-      bump = bumpSelection.bump;
-      log(`${dim(bumpSelection.label)}\n`);
-    }
-
-    const version =
-      (isPrerelease || bump) && semver.valid(pkgVersion)
-        ? isPrerelease
-          ? pkgVersion.split('-')[0]
-          : semver.inc(pkgVersion, bump)
-        : pkgVersion;
-
-    if (argv.dry) {
-      return dry({
-        Release: {
-          bump,
-          version,
-          'git-remote': remote
-        }
-      });
-    }
-
-    // 5) Build with the new version to ensure there are no errors
-
-    throws(await buildCommand(['--id', version]));
-
-    // 6) Bump the project's version number (optional, skippable)
-
-    let spinner;
-
-    if (!argv.force && version !== pkgVersion) {
-      spinner = spin(MESSAGES.createCommit(pkgVersion, version));
-      updateJsonFile(join(root, 'package.json'), { version });
-      updateJsonFile(join(root, 'package-lock.json'), { version });
-      await commitAll(version);
-      spinner.succeed();
-
-      if (remotes.has(remote)) {
-        spinner = spin(MESSAGES.pushCommit(remote));
-        await push();
-        spinner.succeed();
-      }
-    }
-
-    // 7) Tag a new release (skippable)
-
-    if (!argv.force) {
-      spinner = spin(MESSAGES.createTag(version));
-      await createTag(version);
-      spinner.succeed();
-
-      if (remotes.has(remote)) {
-        spinner = spin(MESSAGES.pushTag(version, remote));
-        await pushTag(remote, version);
-        spinner.succeed();
-      }
-    }
-
-    // 8) Deploy
-
-    throws(await deployCommand());
-  }
-);
-
-const updateJsonFile = (path, source) => {
-  if (existsSync(path)) {
-    writeJsonFile.sync(path, combine(loadJsonFile.sync(path), source));
-  }
-};

package/src/cli/serve/constants.js

@@ -1,33 +0,0 @@
-// Ours
-const { cmd, hvy, opt, sec } = require('../../utils/color');
-
-module.exports.BUNDLE_ANALYZER_CONFIG = {
-  analyzerHost: '127.0.0.1',
-  logLevel: 'error',
-  openAnalyzer: false
-};
-
-module.exports.MESSAGES = {
-  port: ({ port, errorType }) => `Port ${port} could not be used (${errorType}). Attempting to use port ${port + 1}`,
-  analysis: ({ analyzerHost, analyzerPort }) => `http://${analyzerHost}:${analyzerPort}`,
-  serve: ({ bundleAnalysisPath, hot, publicPath }) => `Serve (${hvy(process.env.NODE_ENV)}):${
-    bundleAnalysisPath
-      ? `
-  ┣ ${hvy('bundle analysis')}: ${bundleAnalysisPath}`
-      : ''
-  }
-  ┣ ${hvy('hot')}: ${cmd(hot ? 'yes' : 'no')}
-  ┗ ${hvy('publicPath')}: ${publicPath}`,
-  // TODO: Add aunty config section to usage
-  usage: name => `Usage: ${cmd(`aunty ${name}`)} ${opt('[options]')}
-
-${sec('Options')}
-
-  ${opt('-d')}, ${opt('--dry')} Output the generated webpack & dev server configuration, then exit
-
-${sec('Environment variables')}
-
-  • Builds will assume you have set ${cmd('NODE_ENV=development')}, unless you specify otherwise.
-  • You can override the host and port the server listens on by setting ${cmd('AUNTY_HOST')} and ${cmd('AUNTY_PORT')}.
-`
-};