387 lines
		
	
	
		
			10 KiB
		
	
	
	
		
			JavaScript
		
	
	
	
	
	
			
		
		
	
	
			387 lines
		
	
	
		
			10 KiB
		
	
	
	
		
			JavaScript
		
	
	
	
	
	
/*
 | 
						|
Copyright spdx-correct.js contributors
 | 
						|
 | 
						|
Licensed under the Apache License, Version 2.0 (the "License");
 | 
						|
you may not use this file except in compliance with the License.
 | 
						|
You may obtain a copy of the License at
 | 
						|
 | 
						|
   http://www.apache.org/licenses/LICENSE-2.0
 | 
						|
 | 
						|
Unless required by applicable law or agreed to in writing, software
 | 
						|
distributed under the License is distributed on an "AS IS" BASIS,
 | 
						|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 | 
						|
See the License for the specific language governing permissions and
 | 
						|
limitations under the License.
 | 
						|
*/
 | 
						|
var parse = require('spdx-expression-parse')
 | 
						|
var spdxLicenseIds = require('spdx-license-ids')
 | 
						|
 | 
						|
function valid (string) {
 | 
						|
  try {
 | 
						|
    parse(string)
 | 
						|
    return true
 | 
						|
  } catch (error) {
 | 
						|
    return false
 | 
						|
  }
 | 
						|
}
 | 
						|
 | 
						|
// Sorting function that orders the given array of transpositions such
 | 
						|
// that a transposition with the longer pattern comes before a transposition
 | 
						|
// with a shorter pattern. This is to prevent e.g. the transposition
 | 
						|
// ["General Public License", "GPL"] from matching to "Lesser General Public License"
 | 
						|
// before a longer and more accurate transposition ["Lesser General Public License", "LGPL"]
 | 
						|
// has a chance to be recognized.
 | 
						|
function sortTranspositions(a, b) {
 | 
						|
  var length = b[0].length - a[0].length
 | 
						|
  if (length !== 0) return length
 | 
						|
  return a[0].toUpperCase().localeCompare(b[0].toUpperCase())
 | 
						|
}
 | 
						|
 | 
						|
// Common transpositions of license identifier acronyms
 | 
						|
var transpositions = [
 | 
						|
  ['APGL', 'AGPL'],
 | 
						|
  ['Gpl', 'GPL'],
 | 
						|
  ['GLP', 'GPL'],
 | 
						|
  ['APL', 'Apache'],
 | 
						|
  ['ISD', 'ISC'],
 | 
						|
  ['GLP', 'GPL'],
 | 
						|
  ['IST', 'ISC'],
 | 
						|
  ['Claude', 'Clause'],
 | 
						|
  [' or later', '+'],
 | 
						|
  [' International', ''],
 | 
						|
  ['GNU', 'GPL'],
 | 
						|
  ['GUN', 'GPL'],
 | 
						|
  ['+', ''],
 | 
						|
  ['GNU GPL', 'GPL'],
 | 
						|
  ['GNU LGPL', 'LGPL'],
 | 
						|
  ['GNU/GPL', 'GPL'],
 | 
						|
  ['GNU GLP', 'GPL'],
 | 
						|
  ['GNU LESSER GENERAL PUBLIC LICENSE', 'LGPL'],
 | 
						|
  ['GNU Lesser General Public License', 'LGPL'],
 | 
						|
  ['GNU LESSER GENERAL PUBLIC LICENSE', 'LGPL-2.1'],
 | 
						|
  ['GNU Lesser General Public License', 'LGPL-2.1'],
 | 
						|
  ['LESSER GENERAL PUBLIC LICENSE', 'LGPL'],
 | 
						|
  ['Lesser General Public License', 'LGPL'],
 | 
						|
  ['LESSER GENERAL PUBLIC LICENSE', 'LGPL-2.1'],
 | 
						|
  ['Lesser General Public License', 'LGPL-2.1'],
 | 
						|
  ['GNU General Public License', 'GPL'],
 | 
						|
  ['Gnu public license', 'GPL'],
 | 
						|
  ['GNU Public License', 'GPL'],
 | 
						|
  ['GNU GENERAL PUBLIC LICENSE', 'GPL'],
 | 
						|
  ['MTI', 'MIT'],
 | 
						|
  ['Mozilla Public License', 'MPL'],
 | 
						|
  ['Universal Permissive License', 'UPL'],
 | 
						|
  ['WTH', 'WTF'],
 | 
						|
  ['WTFGPL', 'WTFPL'],
 | 
						|
  ['-License', '']
 | 
						|
].sort(sortTranspositions)
 | 
						|
 | 
						|
var TRANSPOSED = 0
 | 
						|
var CORRECT = 1
 | 
						|
 | 
						|
// Simple corrections to nearly valid identifiers.
 | 
						|
var transforms = [
 | 
						|
  // e.g. 'mit'
 | 
						|
  function (argument) {
 | 
						|
    return argument.toUpperCase()
 | 
						|
  },
 | 
						|
  // e.g. 'MIT '
 | 
						|
  function (argument) {
 | 
						|
    return argument.trim()
 | 
						|
  },
 | 
						|
  // e.g. 'M.I.T.'
 | 
						|
  function (argument) {
 | 
						|
    return argument.replace(/\./g, '')
 | 
						|
  },
 | 
						|
  // e.g. 'Apache- 2.0'
 | 
						|
  function (argument) {
 | 
						|
    return argument.replace(/\s+/g, '')
 | 
						|
  },
 | 
						|
  // e.g. 'CC BY 4.0''
 | 
						|
  function (argument) {
 | 
						|
    return argument.replace(/\s+/g, '-')
 | 
						|
  },
 | 
						|
  // e.g. 'LGPLv2.1'
 | 
						|
  function (argument) {
 | 
						|
    return argument.replace('v', '-')
 | 
						|
  },
 | 
						|
  // e.g. 'Apache 2.0'
 | 
						|
  function (argument) {
 | 
						|
    return argument.replace(/,?\s*(\d)/, '-$1')
 | 
						|
  },
 | 
						|
  // e.g. 'GPL 2'
 | 
						|
  function (argument) {
 | 
						|
    return argument.replace(/,?\s*(\d)/, '-$1.0')
 | 
						|
  },
 | 
						|
  // e.g. 'Apache Version 2.0'
 | 
						|
  function (argument) {
 | 
						|
    return argument
 | 
						|
      .replace(/,?\s*(V\.|v\.|V|v|Version|version)\s*(\d)/, '-$2')
 | 
						|
  },
 | 
						|
  // e.g. 'Apache Version 2'
 | 
						|
  function (argument) {
 | 
						|
    return argument
 | 
						|
      .replace(/,?\s*(V\.|v\.|V|v|Version|version)\s*(\d)/, '-$2.0')
 | 
						|
  },
 | 
						|
  // e.g. 'ZLIB'
 | 
						|
  function (argument) {
 | 
						|
    return argument[0].toUpperCase() + argument.slice(1)
 | 
						|
  },
 | 
						|
  // e.g. 'MPL/2.0'
 | 
						|
  function (argument) {
 | 
						|
    return argument.replace('/', '-')
 | 
						|
  },
 | 
						|
  // e.g. 'Apache 2'
 | 
						|
  function (argument) {
 | 
						|
    return argument
 | 
						|
      .replace(/\s*V\s*(\d)/, '-$1')
 | 
						|
      .replace(/(\d)$/, '$1.0')
 | 
						|
  },
 | 
						|
  // e.g. 'GPL-2.0', 'GPL-3.0'
 | 
						|
  function (argument) {
 | 
						|
    if (argument.indexOf('3.0') !== -1) {
 | 
						|
      return argument + '-or-later'
 | 
						|
    } else {
 | 
						|
      return argument + '-only'
 | 
						|
    }
 | 
						|
  },
 | 
						|
  // e.g. 'GPL-2.0-'
 | 
						|
  function (argument) {
 | 
						|
    return argument + 'only'
 | 
						|
  },
 | 
						|
  // e.g. 'GPL2'
 | 
						|
  function (argument) {
 | 
						|
    return argument.replace(/(\d)$/, '-$1.0')
 | 
						|
  },
 | 
						|
  // e.g. 'BSD 3'
 | 
						|
  function (argument) {
 | 
						|
    return argument.replace(/(-| )?(\d)$/, '-$2-Clause')
 | 
						|
  },
 | 
						|
  // e.g. 'BSD clause 3'
 | 
						|
  function (argument) {
 | 
						|
    return argument.replace(/(-| )clause(-| )(\d)/, '-$3-Clause')
 | 
						|
  },
 | 
						|
  // e.g. 'New BSD license'
 | 
						|
  function (argument) {
 | 
						|
    return argument.replace(/\b(Modified|New|Revised)(-| )?BSD((-| )License)?/i, 'BSD-3-Clause')
 | 
						|
  },
 | 
						|
  // e.g. 'Simplified BSD license'
 | 
						|
  function (argument) {
 | 
						|
    return argument.replace(/\bSimplified(-| )?BSD((-| )License)?/i, 'BSD-2-Clause')
 | 
						|
  },
 | 
						|
  // e.g. 'Free BSD license'
 | 
						|
  function (argument) {
 | 
						|
    return argument.replace(/\b(Free|Net)(-| )?BSD((-| )License)?/i, 'BSD-2-Clause-$1BSD')
 | 
						|
  },
 | 
						|
  // e.g. 'Clear BSD license'
 | 
						|
  function (argument) {
 | 
						|
    return argument.replace(/\bClear(-| )?BSD((-| )License)?/i, 'BSD-3-Clause-Clear')
 | 
						|
  },
 | 
						|
  // e.g. 'Old BSD License'
 | 
						|
  function (argument) {
 | 
						|
    return argument.replace(/\b(Old|Original)(-| )?BSD((-| )License)?/i, 'BSD-4-Clause')
 | 
						|
  },
 | 
						|
  // e.g. 'BY-NC-4.0'
 | 
						|
  function (argument) {
 | 
						|
    return 'CC-' + argument
 | 
						|
  },
 | 
						|
  // e.g. 'BY-NC'
 | 
						|
  function (argument) {
 | 
						|
    return 'CC-' + argument + '-4.0'
 | 
						|
  },
 | 
						|
  // e.g. 'Attribution-NonCommercial'
 | 
						|
  function (argument) {
 | 
						|
    return argument
 | 
						|
      .replace('Attribution', 'BY')
 | 
						|
      .replace('NonCommercial', 'NC')
 | 
						|
      .replace('NoDerivatives', 'ND')
 | 
						|
      .replace(/ (\d)/, '-$1')
 | 
						|
      .replace(/ ?International/, '')
 | 
						|
  },
 | 
						|
  // e.g. 'Attribution-NonCommercial'
 | 
						|
  function (argument) {
 | 
						|
    return 'CC-' +
 | 
						|
      argument
 | 
						|
        .replace('Attribution', 'BY')
 | 
						|
        .replace('NonCommercial', 'NC')
 | 
						|
        .replace('NoDerivatives', 'ND')
 | 
						|
        .replace(/ (\d)/, '-$1')
 | 
						|
        .replace(/ ?International/, '') +
 | 
						|
      '-4.0'
 | 
						|
  }
 | 
						|
]
 | 
						|
 | 
						|
var licensesWithVersions = spdxLicenseIds
 | 
						|
  .map(function (id) {
 | 
						|
    var match = /^(.*)-\d+\.\d+$/.exec(id)
 | 
						|
    return match
 | 
						|
      ? [match[0], match[1]]
 | 
						|
      : [id, null]
 | 
						|
  })
 | 
						|
  .reduce(function (objectMap, item) {
 | 
						|
    var key = item[1]
 | 
						|
    objectMap[key] = objectMap[key] || []
 | 
						|
    objectMap[key].push(item[0])
 | 
						|
    return objectMap
 | 
						|
  }, {})
 | 
						|
 | 
						|
var licensesWithOneVersion = Object.keys(licensesWithVersions)
 | 
						|
  .map(function makeEntries (key) {
 | 
						|
    return [key, licensesWithVersions[key]]
 | 
						|
  })
 | 
						|
  .filter(function identifySoleVersions (item) {
 | 
						|
    return (
 | 
						|
      // Licenses has just one valid version suffix.
 | 
						|
      item[1].length === 1 &&
 | 
						|
      item[0] !== null &&
 | 
						|
      // APL will be considered Apache, rather than APL-1.0
 | 
						|
      item[0] !== 'APL'
 | 
						|
    )
 | 
						|
  })
 | 
						|
  .map(function createLastResorts (item) {
 | 
						|
    return [item[0], item[1][0]]
 | 
						|
  })
 | 
						|
 | 
						|
licensesWithVersions = undefined
 | 
						|
 | 
						|
// If all else fails, guess that strings containing certain substrings
 | 
						|
// meant to identify certain licenses.
 | 
						|
var lastResorts = [
 | 
						|
  ['UNLI', 'Unlicense'],
 | 
						|
  ['WTF', 'WTFPL'],
 | 
						|
  ['2 CLAUSE', 'BSD-2-Clause'],
 | 
						|
  ['2-CLAUSE', 'BSD-2-Clause'],
 | 
						|
  ['3 CLAUSE', 'BSD-3-Clause'],
 | 
						|
  ['3-CLAUSE', 'BSD-3-Clause'],
 | 
						|
  ['AFFERO', 'AGPL-3.0-or-later'],
 | 
						|
  ['AGPL', 'AGPL-3.0-or-later'],
 | 
						|
  ['APACHE', 'Apache-2.0'],
 | 
						|
  ['ARTISTIC', 'Artistic-2.0'],
 | 
						|
  ['Affero', 'AGPL-3.0-or-later'],
 | 
						|
  ['BEER', 'Beerware'],
 | 
						|
  ['BOOST', 'BSL-1.0'],
 | 
						|
  ['BSD', 'BSD-2-Clause'],
 | 
						|
  ['CDDL', 'CDDL-1.1'],
 | 
						|
  ['ECLIPSE', 'EPL-1.0'],
 | 
						|
  ['FUCK', 'WTFPL'],
 | 
						|
  ['GNU', 'GPL-3.0-or-later'],
 | 
						|
  ['LGPL', 'LGPL-3.0-or-later'],
 | 
						|
  ['GPLV1', 'GPL-1.0-only'],
 | 
						|
  ['GPL-1', 'GPL-1.0-only'],
 | 
						|
  ['GPLV2', 'GPL-2.0-only'],
 | 
						|
  ['GPL-2', 'GPL-2.0-only'],
 | 
						|
  ['GPL', 'GPL-3.0-or-later'],
 | 
						|
  ['MIT +NO-FALSE-ATTRIBS', 'MITNFA'],
 | 
						|
  ['MIT', 'MIT'],
 | 
						|
  ['MPL', 'MPL-2.0'],
 | 
						|
  ['X11', 'X11'],
 | 
						|
  ['ZLIB', 'Zlib']
 | 
						|
].concat(licensesWithOneVersion).sort(sortTranspositions)
 | 
						|
 | 
						|
var SUBSTRING = 0
 | 
						|
var IDENTIFIER = 1
 | 
						|
 | 
						|
var validTransformation = function (identifier) {
 | 
						|
  for (var i = 0; i < transforms.length; i++) {
 | 
						|
    var transformed = transforms[i](identifier).trim()
 | 
						|
    if (transformed !== identifier && valid(transformed)) {
 | 
						|
      return transformed
 | 
						|
    }
 | 
						|
  }
 | 
						|
  return null
 | 
						|
}
 | 
						|
 | 
						|
var validLastResort = function (identifier) {
 | 
						|
  var upperCased = identifier.toUpperCase()
 | 
						|
  for (var i = 0; i < lastResorts.length; i++) {
 | 
						|
    var lastResort = lastResorts[i]
 | 
						|
    if (upperCased.indexOf(lastResort[SUBSTRING]) > -1) {
 | 
						|
      return lastResort[IDENTIFIER]
 | 
						|
    }
 | 
						|
  }
 | 
						|
  return null
 | 
						|
}
 | 
						|
 | 
						|
var anyCorrection = function (identifier, check) {
 | 
						|
  for (var i = 0; i < transpositions.length; i++) {
 | 
						|
    var transposition = transpositions[i]
 | 
						|
    var transposed = transposition[TRANSPOSED]
 | 
						|
    if (identifier.indexOf(transposed) > -1) {
 | 
						|
      var corrected = identifier.replace(
 | 
						|
        transposed,
 | 
						|
        transposition[CORRECT]
 | 
						|
      )
 | 
						|
      var checked = check(corrected)
 | 
						|
      if (checked !== null) {
 | 
						|
        return checked
 | 
						|
      }
 | 
						|
    }
 | 
						|
  }
 | 
						|
  return null
 | 
						|
}
 | 
						|
 | 
						|
module.exports = function (identifier, options) {
 | 
						|
  options = options || {}
 | 
						|
  var upgrade = options.upgrade === undefined ? true : !!options.upgrade
 | 
						|
  function postprocess (value) {
 | 
						|
    return upgrade ? upgradeGPLs(value) : value
 | 
						|
  }
 | 
						|
  var validArugment = (
 | 
						|
    typeof identifier === 'string' &&
 | 
						|
    identifier.trim().length !== 0
 | 
						|
  )
 | 
						|
  if (!validArugment) {
 | 
						|
    throw Error('Invalid argument. Expected non-empty string.')
 | 
						|
  }
 | 
						|
  identifier = identifier.trim()
 | 
						|
  if (valid(identifier)) {
 | 
						|
    return postprocess(identifier)
 | 
						|
  }
 | 
						|
  var noPlus = identifier.replace(/\+$/, '').trim()
 | 
						|
  if (valid(noPlus)) {
 | 
						|
    return postprocess(noPlus)
 | 
						|
  }
 | 
						|
  var transformed = validTransformation(identifier)
 | 
						|
  if (transformed !== null) {
 | 
						|
    return postprocess(transformed)
 | 
						|
  }
 | 
						|
  transformed = anyCorrection(identifier, function (argument) {
 | 
						|
    if (valid(argument)) {
 | 
						|
      return argument
 | 
						|
    }
 | 
						|
    return validTransformation(argument)
 | 
						|
  })
 | 
						|
  if (transformed !== null) {
 | 
						|
    return postprocess(transformed)
 | 
						|
  }
 | 
						|
  transformed = validLastResort(identifier)
 | 
						|
  if (transformed !== null) {
 | 
						|
    return postprocess(transformed)
 | 
						|
  }
 | 
						|
  transformed = anyCorrection(identifier, validLastResort)
 | 
						|
  if (transformed !== null) {
 | 
						|
    return postprocess(transformed)
 | 
						|
  }
 | 
						|
  return null
 | 
						|
}
 | 
						|
 | 
						|
function upgradeGPLs (value) {
 | 
						|
  if ([
 | 
						|
    'GPL-1.0', 'LGPL-1.0', 'AGPL-1.0',
 | 
						|
    'GPL-2.0', 'LGPL-2.0', 'AGPL-2.0',
 | 
						|
    'LGPL-2.1'
 | 
						|
  ].indexOf(value) !== -1) {
 | 
						|
    return value + '-only'
 | 
						|
  } else if ([
 | 
						|
    'GPL-1.0+', 'GPL-2.0+', 'GPL-3.0+',
 | 
						|
    'LGPL-2.0+', 'LGPL-2.1+', 'LGPL-3.0+',
 | 
						|
    'AGPL-1.0+', 'AGPL-3.0+'
 | 
						|
  ].indexOf(value) !== -1) {
 | 
						|
    return value.replace(/\+$/, '-or-later')
 | 
						|
  } else if (['GPL-3.0', 'LGPL-3.0', 'AGPL-3.0'].indexOf(value) !== -1) {
 | 
						|
    return value + '-or-later'
 | 
						|
  } else {
 | 
						|
    return value
 | 
						|
  }
 | 
						|
}
 |