拿掉 build files

This commit is contained in:
2022-07-18 16:33:23 +08:00
parent 41e2287bcb
commit 3707f158a3
31953 changed files with 0 additions and 4411796 deletions
-21
View File
@@ -1,21 +0,0 @@
# Changelog
All notable changes to this project will be documented in this file.
## 3.0.0 (2021-04-21)
### Added
- Excluding Webpack 5 module federation (automatically adding to allowlist)
### Changed
- Better arguments handling for the exported function
- Changed code syntax to ES6
### Removed
- Removed support for Node < 6
## 2.5.2 (2020-08-24)
### Changed
- Changed exported function signature - to remove deprecation notice when used in Webpack 5
## 2.5.0 (2020-07-12)
### Added
- Options validation - throwing an error when using a mispell of one of the options
-21
View File
@@ -1,21 +0,0 @@
The MIT License (MIT)
Copyright (c) 2016 Liad Yosef
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
-150
View File
@@ -1,150 +0,0 @@
Webpack node modules externals
==============================
> Easily exclude node modules in Webpack
[![Version](https://img.shields.io/npm/v/webpack-node-externals.svg)](https://www.npmjs.org/package/webpack-node-externals)
[![Downloads](https://img.shields.io/npm/dm/webpack-node-externals.svg)](https://www.npmjs.org/package/webpack-node-externals)
[![Build Status](https://travis-ci.org/liady/webpack-node-externals.svg?branch=master)](https://travis-ci.org/liady/webpack-node-externals)
Webpack allows you to define [*externals*](https://webpack.js.org/configuration/externals) - modules that should not be bundled.
When bundling with Webpack for the backend - you usually don't want to bundle its `node_modules` dependencies.
This library creates an *externals* function that ignores `node_modules` when bundling in Webpack.<br/>(Inspired by the great [Backend apps with Webpack](http://jlongster.com/Backend-Apps-with-Webpack--Part-I) series)
## Quick usage
```sh
npm install webpack-node-externals --save-dev
```
In your `webpack.config.js`:
```js
const nodeExternals = require('webpack-node-externals');
...
module.exports = {
...
target: 'node', // in order to ignore built-in modules like path, fs, etc.
externals: [nodeExternals()], // in order to ignore all modules in node_modules folder
...
};
```
And that's it. All node modules will no longer be bundled but will be left as `require('module')`.
**Note**: For Webpack 5, replace `target: 'node'` with the `externalsPreset` object:
```js
// Webpack 5
const nodeExternals = require('webpack-node-externals');
...
module.exports = {
...
externalsPresets: { node: true }, // in order to ignore built-in modules like path, fs, etc.
externals: [nodeExternals()], // in order to ignore all modules in node_modules folder
...
};
```
## Detailed overview
### Description
This library scans the `node_modules` folder for all node_modules names, and builds an *externals* function that tells Webpack not to bundle those modules, or any sub-modules of theirs.
### Configuration
This library accepts an `options` object.
#### `options.allowlist (=[])`
An array for the `externals` to allow, so they **will** be included in the bundle. Can accept exact strings (`'module_name'`), regex patterns (`/^module_name/`), or a function that accepts the module name and returns whether it should be included.
<br/>**Important** - if you have set aliases in your webpack config with the exact same names as modules in *node_modules*, you need to allowlist them so Webpack will know they should be bundled.
#### `options.importType (='commonjs')`
The method in which unbundled modules will be required in the code. Best to leave as `commonjs` for node modules.
May be one of [documented options](https://webpack.js.org/configuration/externals/#externals) or function `callback(moduleName)` which returns custom code to be returned as import type, e.g:
```js
options.importType = function (moduleName) {
return 'amd ' + moduleName;
}
```
#### `options.modulesDir (='node_modules')`
The folder in which to search for the node modules.
#### `options.additionalModuleDirs (='[]')`
Additional folders to look for node modules.
#### `options.modulesFromFile (=false)`
Read the modules from the `package.json` file instead of the `node_modules` folder.
<br/>Accepts a boolean or a configuration object:
```js
{
modulesFromFile: true,
/* or */
modulesFromFile: {
fileName: /* path to package.json to read from */,
includeInBundle: [/* whole sections to include in the bundle, i.e 'devDependencies' */],
excludeFromBundle: [/* whole sections to explicitly exclude from the bundle, i.e only 'dependencies' */]
}
}
```
## Usage example
```js
var nodeExternals = require('webpack-node-externals');
...
module.exports = {
...
target: 'node', // important in order not to bundle built-in modules like path, fs, etc.
externals: [nodeExternals({
// this WILL include `jquery` and `webpack/hot/dev-server` in the bundle, as well as `lodash/*`
allowlist: ['jquery', 'webpack/hot/dev-server', /^lodash/]
})],
...
};
```
For most use cases, the defaults of `importType` and `modulesDir` should be used.
## Q&A
#### Why not just use a regex in the Webpack config?
Webpack allows inserting [regex](https://webpack.js.org/configuration/externals/#regex) in the *externals* array, to capture non-relative modules:
```js
{
externals: [
// Every non-relative module is external
// abc -> require("abc")
/^[a-z\-0-9]+$/
]
}
```
However, this will leave unbundled **all non-relative requires**, so it does not account for aliases that may be defined in webpack itself.
This library scans the `node_modules` folder, so it only leaves unbundled the actual node modules that are being used.
#### How can I bundle required assets (i.e css files) from node_modules?
Using the `allowlist` option, this is possible. We can simply tell Webpack to bundle all files with extensions that are not js/jsx/json, using this [regex](https://regexper.com/#%5C.(%3F!(%3F%3Ajs%7Cjson)%24).%7B1%2C5%7D%24):
```js
...
nodeExternals({
// load non-javascript files with extensions, presumably via loaders
allowlist: [/\.(?!(?:jsx?|json)$).{1,5}$/i],
}),
...
```
Thanks @wmertens for this idea.
#### Why is not bundling node_modules a good thing?
When writing a node library, for instance, you may want to split your code to several files, and use Webpack to bundle them. However - you wouldn't want to bundle your code with its entire node_modules dependencies, for two reasons:
1. It will bloat your library on npm.
2. It goes against the entire npm dependencies management. If you're using Lodash, and the consumer of your library also has the same Lodash dependency, npm makes sure that it will be added only once. But bundling Lodash in your library will actually make it included twice, since npm is no longer managing this dependency.
As a consumer of a library, I want the library code to include only its logic, and just state its dependencies so they could me merged/resolved with the rest of the dependencies in my project. Bundling your code with your dependencies makes it virtually impossible.
In short: **It's useful if your code is used by something that has dependencies managed by npm**
## Contribute
Contributions and pull requests are welcome. Please run the tests to make sure nothing breaks.
### Test
```sh
npm run test
```
## License
MIT
-85
View File
@@ -1,85 +0,0 @@
const utils = require('./utils');
const scopedModuleRegex = new RegExp(
'@[a-zA-Z0-9][\\w-.]+/[a-zA-Z0-9][\\w-.]+([a-zA-Z0-9./]+)?',
'g'
);
function getModuleName(request, includeAbsolutePaths) {
let req = request;
const delimiter = '/';
if (includeAbsolutePaths) {
req = req.replace(/^.*?\/node_modules\//, '');
}
// check if scoped module
if (scopedModuleRegex.test(req)) {
// reset regexp
scopedModuleRegex.lastIndex = 0;
return req.split(delimiter, 2).join(delimiter);
}
return req.split(delimiter)[0];
}
module.exports = function nodeExternals(options) {
options = options || {};
const mistakes = utils.validateOptions(options) || [];
if (mistakes.length) {
mistakes.forEach((mistake) => {
utils.error(mistakes.map((mistake) => mistake.message));
utils.log(mistake.message);
});
}
const webpackInternalAllowlist = [/^webpack\/container\/reference\//];
const allowlist = []
.concat(webpackInternalAllowlist)
.concat(options.allowlist || []);
const binaryDirs = [].concat(options.binaryDirs || ['.bin']);
const importType = options.importType || 'commonjs';
const modulesDir = options.modulesDir || 'node_modules';
const modulesFromFile = !!options.modulesFromFile;
const includeAbsolutePaths = !!options.includeAbsolutePaths;
const additionalModuleDirs = options.additionalModuleDirs || [];
// helper function
function isNotBinary(x) {
return !utils.contains(binaryDirs, x);
}
// create the node modules list
let nodeModules = modulesFromFile
? utils.readFromPackageJson(options.modulesFromFile)
: utils.readDir(modulesDir).filter(isNotBinary);
additionalModuleDirs.forEach(function (additionalDirectory) {
nodeModules = nodeModules.concat(
utils.readDir(additionalDirectory).filter(isNotBinary)
);
});
// return an externals function
return function (...args) {
const [arg1, arg2, arg3] = args;
// let context = arg1;
let request = arg2;
let callback = arg3;
// in case of webpack 5
if (arg1 && arg1.context && arg1.request) {
// context = arg1.context;
request = arg1.request;
callback = arg2;
}
const moduleName = getModuleName(request, includeAbsolutePaths);
if (
utils.contains(nodeModules, moduleName) &&
!utils.containsPattern(allowlist, request)
) {
if (typeof importType === 'function') {
return callback(null, importType(request));
}
// mark this module as external
// https://webpack.js.org/configuration/externals/
return callback(null, importType + ' ' + request);
}
callback();
};
};
-78
View File
@@ -1,78 +0,0 @@
{
"_args": [
[
"webpack-node-externals@3.0.0",
"/home/node/nuxt"
]
],
"_from": "webpack-node-externals@3.0.0",
"_id": "webpack-node-externals@3.0.0",
"_inBundle": false,
"_integrity": "sha512-LnL6Z3GGDPht/AigwRh2dvL9PQPFQ8skEpVrWZXLWBYmqcaojHNN0onvHzie6rq7EWKrrBfPYqNEzTJgiwEQDQ==",
"_location": "/webpack-node-externals",
"_phantomChildren": {},
"_requested": {
"type": "version",
"registry": true,
"raw": "webpack-node-externals@3.0.0",
"name": "webpack-node-externals",
"escapedName": "webpack-node-externals",
"rawSpec": "3.0.0",
"saveSpec": null,
"fetchSpec": "3.0.0"
},
"_requiredBy": [
"/@nuxt/webpack"
],
"_resolved": "https://registry.npmjs.org/webpack-node-externals/-/webpack-node-externals-3.0.0.tgz",
"_spec": "3.0.0",
"_where": "/home/node/nuxt",
"author": {
"name": "Liad Yosef",
"url": "https://github.com/liady"
},
"bugs": {
"url": "https://github.com/liady/webpack-node-externals/issues"
},
"dependencies": {},
"description": "Easily exclude node_modules in Webpack bundle",
"devDependencies": {
"chai": "^3.5.0",
"eslint": "^7.7.0",
"eslint-plugin-import": "^2.22.0",
"mocha": "^2.5.3",
"mock-fs": "^4.12.0",
"ncp": "^2.0.0",
"webpack": "^4.44.1"
},
"engines": {
"node": ">=6"
},
"files": [
"LICENSE",
"README.md",
"index.js",
"utils.js"
],
"homepage": "https://github.com/liady/webpack-node-externals",
"keywords": [
"webpack",
"node_modules",
"node",
"bundle",
"externals"
],
"license": "MIT",
"main": "index.js",
"name": "webpack-node-externals",
"repository": {
"type": "git",
"url": "git+https://github.com/liady/webpack-node-externals.git"
},
"scripts": {
"test": "npm run unit-watch",
"unit": "mocha --colors ./test/*.spec.js",
"unit-watch": "mocha --colors -w ./test/*.spec.js"
},
"version": "3.0.0"
}
-146
View File
@@ -1,146 +0,0 @@
const fs = require('fs');
const path = require('path');
exports.contains = function contains(arr, val) {
return arr && arr.indexOf(val) !== -1;
};
const atPrefix = new RegExp('^@', 'g');
exports.readDir = function readDir(dirName) {
if (!fs.existsSync(dirName)) {
return [];
}
try {
return fs
.readdirSync(dirName)
.map(function (module) {
if (atPrefix.test(module)) {
// reset regexp
atPrefix.lastIndex = 0;
try {
return fs
.readdirSync(path.join(dirName, module))
.map(function (scopedMod) {
return module + '/' + scopedMod;
});
} catch (e) {
return [module];
}
}
return module;
})
.reduce(function (prev, next) {
return prev.concat(next);
}, []);
} catch (e) {
return [];
}
};
exports.readFromPackageJson = function readFromPackageJson(options) {
if (typeof options !== 'object') {
options = {};
}
const includeInBundle = options.exclude || options.includeInBundle;
const excludeFromBundle = options.include || options.excludeFromBundle;
// read the file
let packageJson;
try {
const fileName = options.fileName || 'package.json';
const packageJsonString = fs.readFileSync(
path.resolve(process.cwd(), fileName),
'utf8'
);
packageJson = JSON.parse(packageJsonString);
} catch (e) {
return [];
}
// sections to search in package.json
let sections = [
'dependencies',
'devDependencies',
'peerDependencies',
'optionalDependencies',
];
if (excludeFromBundle) {
sections = [].concat(excludeFromBundle);
}
if (includeInBundle) {
sections = sections.filter(function (section) {
return [].concat(includeInBundle).indexOf(section) === -1;
});
}
// collect dependencies
const deps = {};
sections.forEach(function (section) {
Object.keys(packageJson[section] || {}).forEach(function (dep) {
deps[dep] = true;
});
});
return Object.keys(deps);
};
exports.containsPattern = function containsPattern(arr, val) {
return (
arr &&
arr.some(function (pattern) {
if (pattern instanceof RegExp) {
return pattern.test(val);
} else if (typeof pattern === 'function') {
return pattern(val);
} else {
return pattern == val;
}
})
);
};
exports.validateOptions = function (options) {
options = options || {};
const results = [];
const mistakes = {
allowlist: ['allowslist', 'whitelist', 'allow'],
importType: ['import', 'importype', 'importtype'],
modulesDir: ['moduledir', 'moduledirs'],
modulesFromFile: ['modulesfile'],
includeAbsolutePaths: ['includeAbsolutesPaths'],
additionalModuleDirs: ['additionalModulesDirs', 'additionalModulesDir'],
};
const optionsKeys = Object.keys(options);
const optionsKeysLower = optionsKeys.map(function (optionName) {
return optionName && optionName.toLowerCase();
});
Object.keys(mistakes).forEach(function (correctTerm) {
if (!options.hasOwnProperty(correctTerm)) {
mistakes[correctTerm]
.concat(correctTerm.toLowerCase())
.forEach(function (mistake) {
const ind = optionsKeysLower.indexOf(mistake.toLowerCase());
if (ind > -1) {
results.push({
message: `Option '${optionsKeys[ind]}' is not supported. Did you mean '${correctTerm}'?`,
wrongTerm: optionsKeys[ind],
correctTerm: correctTerm,
});
}
});
}
});
return results;
};
exports.log = function (message) {
console.log(`[webpack-node-externals] : ${message}`);
};
exports.error = function (errors) {
throw new Error(
errors
.map(function (error) {
return `[webpack-node-externals] : ${error}`;
})
.join('\r\n')
);
};