paradiego

node_modules/eslint-plugin-react/lib/util/version.js

@@ -0,0 +1,197 @@
+/**
+ * @fileoverview Utility functions for React and Flow version configuration
+ * @author Yannick Croissant
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const resolve = require('resolve');
+const semver = require('semver');
+const error = require('./error');
+
+const ULTIMATE_LATEST_SEMVER = '999.999.999';
+
+let warnedForMissingVersion = false;
+
+function resetWarningFlag() {
+  warnedForMissingVersion = false;
+}
+
+let cachedDetectedReactVersion;
+
+function resetDetectedVersion() {
+  cachedDetectedReactVersion = undefined;
+}
+
+function resolveBasedir(contextOrFilename) {
+  if (contextOrFilename) {
+    const filename = typeof contextOrFilename === 'string' ? contextOrFilename : contextOrFilename.getFilename();
+    const dirname = path.dirname(filename);
+    try {
+      if (fs.statSync(filename).isFile()) {
+        // dirname must be dir here
+        return dirname;
+      }
+    } catch (err) {
+      // https://github.com/eslint/eslint/issues/11989
+      if (err.code === 'ENOTDIR') {
+        // virtual filename could be recursive
+        return resolveBasedir(dirname);
+      }
+    }
+  }
+  return process.cwd();
+}
+
+function convertConfVerToSemver(confVer) {
+  const fullSemverString = /^[0-9]+\.[0-9]+$/.test(confVer) ? `${confVer}.0` : confVer;
+  return semver.coerce(fullSemverString.split('.').map((part) => Number(part)).join('.'));
+}
+
+let defaultVersion = ULTIMATE_LATEST_SEMVER;
+
+function resetDefaultVersion() {
+  defaultVersion = ULTIMATE_LATEST_SEMVER;
+}
+
+function readDefaultReactVersionFromContext(context) {
+  // .eslintrc shared settings (https://eslint.org/docs/user-guide/configuring#adding-shared-settings)
+  if (context.settings && context.settings.react && context.settings.react.defaultVersion) {
+    let settingsDefaultVersion = context.settings.react.defaultVersion;
+    if (typeof settingsDefaultVersion !== 'string') {
+      error('Warning: default React version specified in eslint-pluigin-react-settings must be a string; '
+        + `got "${typeof settingsDefaultVersion}"`);
+    }
+    settingsDefaultVersion = String(settingsDefaultVersion);
+    const result = convertConfVerToSemver(settingsDefaultVersion);
+    if (result) {
+      defaultVersion = result.version;
+    } else {
+      error(`Warning: React version specified in eslint-plugin-react-settings must be a valid semver version, or "detect"; got “${settingsDefaultVersion}”. Falling back to latest version as default.`);
+    }
+  } else {
+    defaultVersion = ULTIMATE_LATEST_SEMVER;
+  }
+}
+
+// TODO, semver-major: remove context fallback
+function detectReactVersion(context) {
+  if (cachedDetectedReactVersion) {
+    return cachedDetectedReactVersion;
+  }
+
+  const basedir = resolveBasedir(context);
+
+  try {
+    const reactPath = resolve.sync('react', { basedir });
+    const react = require(reactPath); // eslint-disable-line global-require, import/no-dynamic-require
+    cachedDetectedReactVersion = react.version;
+    return cachedDetectedReactVersion;
+  } catch (e) {
+    if (e.code === 'MODULE_NOT_FOUND') {
+      if (!warnedForMissingVersion) {
+        let sentence2 = 'Assuming latest React version for linting.';
+        if (defaultVersion !== ULTIMATE_LATEST_SEMVER) {
+          sentence2 = `Assuming default React version for linting: "${defaultVersion}".`;
+        }
+        error(`Warning: React version was set to "detect" in eslint-plugin-react settings, but the "react" package is not installed. ${sentence2}`);
+        warnedForMissingVersion = true;
+      }
+      cachedDetectedReactVersion = defaultVersion;
+      return cachedDetectedReactVersion;
+    }
+    throw e;
+  }
+}
+
+function getReactVersionFromContext(context) {
+  readDefaultReactVersionFromContext(context);
+  let confVer = defaultVersion;
+  // .eslintrc shared settings (https://eslint.org/docs/user-guide/configuring#adding-shared-settings)
+  if (context.settings && context.settings.react && context.settings.react.version) {
+    let settingsVersion = context.settings.react.version;
+    if (settingsVersion === 'detect') {
+      settingsVersion = detectReactVersion(context);
+    }
+    if (typeof settingsVersion !== 'string') {
+      error('Warning: React version specified in eslint-plugin-react-settings must be a string; '
+        + `got “${typeof settingsVersion}”`);
+    }
+    confVer = String(settingsVersion);
+  } else if (!warnedForMissingVersion) {
+    error('Warning: React version not specified in eslint-plugin-react settings. '
+      + 'See https://github.com/jsx-eslint/eslint-plugin-react#configuration .');
+    warnedForMissingVersion = true;
+  }
+
+  const result = convertConfVerToSemver(confVer);
+  if (!result) {
+    error(`Warning: React version specified in eslint-plugin-react-settings must be a valid semver version, or "detect"; got “${confVer}”`);
+  }
+  return result ? result.version : defaultVersion;
+}
+
+// TODO, semver-major: remove context fallback
+function detectFlowVersion(context) {
+  const basedir = resolveBasedir(context);
+
+  try {
+    const flowPackageJsonPath = resolve.sync('flow-bin/package.json', { basedir });
+    const flowPackageJson = require(flowPackageJsonPath); // eslint-disable-line global-require, import/no-dynamic-require
+    return flowPackageJson.version;
+  } catch (e) {
+    if (e.code === 'MODULE_NOT_FOUND') {
+      error('Warning: Flow version was set to "detect" in eslint-plugin-react settings, '
+        + 'but the "flow-bin" package is not installed. Assuming latest Flow version for linting.');
+      return ULTIMATE_LATEST_SEMVER;
+    }
+    throw e;
+  }
+}
+
+function getFlowVersionFromContext(context) {
+  let confVer = defaultVersion;
+  // .eslintrc shared settings (https://eslint.org/docs/user-guide/configuring#adding-shared-settings)
+  if (context.settings.react && context.settings.react.flowVersion) {
+    let flowVersion = context.settings.react.flowVersion;
+    if (flowVersion === 'detect') {
+      flowVersion = detectFlowVersion(context);
+    }
+    if (typeof flowVersion !== 'string') {
+      error('Warning: Flow version specified in eslint-plugin-react-settings must be a string; '
+        + `got “${typeof flowVersion}”`);
+    }
+    confVer = String(flowVersion);
+  } else {
+    throw 'Could not retrieve flowVersion from settings'; // eslint-disable-line no-throw-literal
+  }
+
+  const result = convertConfVerToSemver(confVer);
+  if (!result) {
+    error(`Warning: Flow version specified in eslint-plugin-react-settings must be a valid semver version, or "detect"; got “${confVer}”`);
+  }
+  return result ? result.version : defaultVersion;
+}
+
+function test(semverRange, confVer) {
+  return semver.satisfies(confVer, semverRange);
+}
+
+function testReactVersion(context, semverRange) {
+  return test(semverRange, getReactVersionFromContext(context));
+}
+
+function testFlowVersion(context, semverRange) {
+  return test(semverRange, getFlowVersionFromContext(context));
+}
+
+module.exports = {
+  testReactVersion,
+  testFlowVersion,
+  resetWarningFlag,
+  resetDetectedVersion,
+  resetDefaultVersion,
+};