139 lines
16 KiB
JavaScript
139 lines
16 KiB
JavaScript
|
'use strict';var _declaredScope = require('eslint-module-utils/declaredScope');var _declaredScope2 = _interopRequireDefault(_declaredScope);
|
||
|
|
var _builder = require('../exportMap/builder');var _builder2 = _interopRequireDefault(_builder);
|
||
|
|
var _exportMap = require('../exportMap');var _exportMap2 = _interopRequireDefault(_exportMap);
|
||
|
|
var _docsUrl = require('../docsUrl');var _docsUrl2 = _interopRequireDefault(_docsUrl);function _interopRequireDefault(obj) {return obj && obj.__esModule ? obj : { 'default': obj };}
|
||
|
|
|
||
|
|
function message(deprecation) {
|
||
|
|
return 'Deprecated' + (deprecation.description ? ': ' + String(deprecation.description) : '.');
|
||
|
|
}
|
||
|
|
|
||
|
|
function getDeprecation(metadata) {
|
||
|
|
if (!metadata || !metadata.doc) {return;}
|
||
|
|
|
||
|
|
return metadata.doc.tags.find(function (t) {return t.title === 'deprecated';});
|
||
|
|
}
|
||
|
|
|
||
|
|
module.exports = {
|
||
|
|
meta: {
|
||
|
|
type: 'suggestion',
|
||
|
|
docs: {
|
||
|
|
category: 'Helpful warnings',
|
||
|
|
description: 'Forbid imported names marked with `@deprecated` documentation tag.',
|
||
|
|
url: (0, _docsUrl2['default'])('no-deprecated') },
|
||
|
|
|
||
|
|
schema: [] },
|
||
|
|
|
||
|
|
|
||
|
|
create: function () {function create(context) {
|
||
|
|
var deprecated = new Map();
|
||
|
|
var namespaces = new Map();
|
||
|
|
|
||
|
|
function checkSpecifiers(node) {
|
||
|
|
if (node.type !== 'ImportDeclaration') {return;}
|
||
|
|
if (node.source == null) {return;} // local export, ignore
|
||
|
|
|
||
|
|
var imports = _builder2['default'].get(node.source.value, context);
|
||
|
|
if (imports == null) {return;}
|
||
|
|
|
||
|
|
var moduleDeprecation = imports.doc && imports.doc.tags.find(function (t) {return t.title === 'deprecated';});
|
||
|
|
if (moduleDeprecation) {
|
||
|
|
context.report({ node: node, message: message(moduleDeprecation) });
|
||
|
|
}
|
||
|
|
|
||
|
|
if (imports.errors.length) {
|
||
|
|
imports.reportErrors(context, node);
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
|
||
|
|
node.specifiers.forEach(function (im) {
|
||
|
|
var imported = void 0;var local = void 0;
|
||
|
|
switch (im.type) {
|
||
|
|
|
||
|
|
case 'ImportNamespaceSpecifier':{
|
||
|
|
if (!imports.size) {return;}
|
||
|
|
namespaces.set(im.local.name, imports);
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
|
||
|
|
case 'ImportDefaultSpecifier':
|
||
|
|
imported = 'default';
|
||
|
|
local = im.local.name;
|
||
|
|
break;
|
||
|
|
|
||
|
|
case 'ImportSpecifier':
|
||
|
|
imported = im.imported.name;
|
||
|
|
local = im.local.name;
|
||
|
|
break;
|
||
|
|
|
||
|
|
default:return; // can't handle this one
|
||
|
|
}
|
||
|
|
|
||
|
|
// unknown thing can't be deprecated
|
||
|
|
var exported = imports.get(imported);
|
||
|
|
if (exported == null) {return;}
|
||
|
|
|
||
|
|
// capture import of deep namespace
|
||
|
|
if (exported.namespace) {namespaces.set(local, exported.namespace);}
|
||
|
|
|
||
|
|
var deprecation = getDeprecation(imports.get(imported));
|
||
|
|
if (!deprecation) {return;}
|
||
|
|
|
||
|
|
context.report({ node: im, message: message(deprecation) });
|
||
|
|
|
||
|
|
deprecated.set(local, deprecation);
|
||
|
|
|
||
|
|
});
|
||
|
|
}
|
||
|
|
|
||
|
|
return {
|
||
|
|
Program: function () {function Program(_ref) {var body = _ref.body;return body.forEach(checkSpecifiers);}return Program;}(),
|
||
|
|
|
||
|
|
Identifier: function () {function Identifier(node) {
|
||
|
|
if (node.parent.type === 'MemberExpression' && node.parent.property === node) {
|
||
|
|
return; // handled by MemberExpression
|
||
|
|
}
|
||
|
|
|
||
|
|
// ignore specifier identifiers
|
||
|
|
if (node.parent.type.slice(0, 6) === 'Import') {return;}
|
||
|
|
|
||
|
|
if (!deprecated.has(node.name)) {return;}
|
||
|
|
|
||
|
|
if ((0, _declaredScope2['default'])(context, node.name) !== 'module') {return;}
|
||
|
|
context.report({
|
||
|
|
node: node,
|
||
|
|
message: message(deprecated.get(node.name)) });
|
||
|
|
|
||
|
|
}return Identifier;}(),
|
||
|
|
|
||
|
|
MemberExpression: function () {function MemberExpression(dereference) {
|
||
|
|
if (dereference.object.type !== 'Identifier') {return;}
|
||
|
|
if (!namespaces.has(dereference.object.name)) {return;}
|
||
|
|
|
||
|
|
if ((0, _declaredScope2['default'])(context, dereference.object.name) !== 'module') {return;}
|
||
|
|
|
||
|
|
// go deep
|
||
|
|
var namespace = namespaces.get(dereference.object.name);
|
||
|
|
var namepath = [dereference.object.name];
|
||
|
|
// while property is namespace and parent is member expression, keep validating
|
||
|
|
while (namespace instanceof _exportMap2['default'] && dereference.type === 'MemberExpression') {
|
||
|
|
// ignore computed parts for now
|
||
|
|
if (dereference.computed) {return;}
|
||
|
|
|
||
|
|
var metadata = namespace.get(dereference.property.name);
|
||
|
|
|
||
|
|
if (!metadata) {break;}
|
||
|
|
var deprecation = getDeprecation(metadata);
|
||
|
|
|
||
|
|
if (deprecation) {
|
||
|
|
context.report({ node: dereference.property, message: message(deprecation) });
|
||
|
|
}
|
||
|
|
|
||
|
|
// stash and pop
|
||
|
|
namepath.push(dereference.property.name);
|
||
|
|
namespace = metadata.namespace;
|
||
|
|
dereference = dereference.parent;
|
||
|
|
}
|
||
|
|
}return MemberExpression;}() };
|
||
|
|
|
||
|
|
}return create;}() };
|
||
|
|
//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9ydWxlcy9uby1kZXByZWNhdGVkLmpzIl0sIm5hbWVzIjpbIm1lc3NhZ2UiLCJkZXByZWNhdGlvbiIsImRlc2NyaXB0aW9uIiwiZ2V0RGVwcmVjYXRpb24iLCJtZXRhZGF0YSIsImRvYyIsInRhZ3MiLCJmaW5kIiwidCIsInRpdGxlIiwibW9kdWxlIiwiZXhwb3J0cyIsIm1ldGEiLCJ0eXBlIiwiZG9jcyIsImNhdGVnb3J5IiwidXJsIiwic2NoZW1hIiwiY3JlYXRlIiwiY29udGV4dCIsImRlcHJlY2F0ZWQiLCJNYXAiLCJuYW1lc3BhY2VzIiwiY2hlY2tTcGVjaWZpZXJzIiwibm9kZSIsInNvdXJjZSIsImltcG9ydHMiLCJFeHBvcnRNYXBCdWlsZGVyIiwiZ2V0IiwidmFsdWUiLCJtb2R1bGVEZXByZWNhdGlvbiIsInJlcG9ydCIsImVycm9ycyIsImxlbmd0aCIsInJlcG9ydEVycm9ycyIsInNwZWNpZmllcnMiLCJmb3JFYWNoIiwiaW0iLCJpbXBvcnRlZCIsImxvY2FsIiwic2l6ZSIsInNldCIsIm5hbWUiLCJleHBvcnRlZCIsIm5hbWVzcGFjZSIsIlByb2dyYW0iLCJib2R5IiwiSWRlbnRpZmllciIsInBhcmVudCIsInByb3BlcnR5Iiwic2xpY2UiLCJoYXMiLCJNZW1iZXJFeHByZXNzaW9uIiwiZGVyZWZlcmVuY2UiLCJvYmplY3QiLCJuYW1lcGF0aCIsIkV4cG9ydE1hcCIsImNvbXB1dGVkIiwicHVzaCJdLCJtYXBwaW5ncyI6ImFBQUEsa0U7QUFDQSwrQztBQUNBLHlDO0FBQ0EscUM7O0FBRUEsU0FBU0EsT0FBVCxDQUFpQkMsV0FBakIsRUFBOEI7QUFDNUIseUJBQW9CQSxZQUFZQyxXQUFaLGlCQUErQkQsWUFBWUMsV0FBM0MsSUFBMkQsR0FBL0U7QUFDRDs7QUFFRCxTQUFTQyxjQUFULENBQXdCQyxRQUF4QixFQUFrQztBQUNoQyxNQUFJLENBQUNBLFFBQUQsSUFBYSxDQUFDQSxTQUFTQyxHQUEzQixFQUFnQyxDQUFFLE9BQVM7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
|