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
 | |
|   }
 | |
| }
 |