diff options
author | LinuxWizard42 <computerwizard@linuxmail.org> | 2022-10-12 22:54:37 +0300 |
---|---|---|
committer | LinuxWizard42 <computerwizard@linuxmail.org> | 2022-10-12 22:54:37 +0300 |
commit | 703e03aba33f234712206769f57717ba7d92d23d (patch) | |
tree | 0041f04ccb75bd5379c764e9fe42249fffe75fc3 /node_modules/electron-download | |
parent | ab6e257e6e9d9a483d7e86f220d8b209a2cd7753 (diff) | |
download | FlashRunner-703e03aba33f234712206769f57717ba7d92d23d.tar.gz FlashRunner-703e03aba33f234712206769f57717ba7d92d23d.tar.zst |
Added export_allowed file to make repository visible in cgit
Diffstat (limited to 'node_modules/electron-download')
-rw-r--r-- | node_modules/electron-download/CODE_OF_CONDUCT.md | 5 | ||||
-rw-r--r-- | node_modules/electron-download/LICENSE | 29 | ||||
-rw-r--r-- | node_modules/electron-download/collaborators.md | 8 | ||||
-rw-r--r-- | node_modules/electron-download/lib/arch.js | 30 | ||||
-rwxr-xr-x | node_modules/electron-download/lib/cli.js | 18 | ||||
-rw-r--r-- | node_modules/electron-download/lib/index.js | 336 | ||||
-rw-r--r-- | node_modules/electron-download/package.json | 64 | ||||
-rw-r--r-- | node_modules/electron-download/readme.md | 106 |
8 files changed, 596 insertions, 0 deletions
diff --git a/node_modules/electron-download/CODE_OF_CONDUCT.md b/node_modules/electron-download/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..1fa4492 --- /dev/null +++ b/node_modules/electron-download/CODE_OF_CONDUCT.md @@ -0,0 +1,5 @@ +# Code of Conduct + +This project is a part of the Electron ecosystem. As such, all contributions to this project follow +[Electron's code of conduct](https://github.com/electron/electron/blob/master/CODE_OF_CONDUCT.md) +where appropriate. diff --git a/node_modules/electron-download/LICENSE b/node_modules/electron-download/LICENSE new file mode 100644 index 0000000..35fdbc8 --- /dev/null +++ b/node_modules/electron-download/LICENSE @@ -0,0 +1,29 @@ +BSD 3-Clause License + +Copyright (c) 2018, Electron Userland +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +* Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + +* Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + +* Neither the name of the copyright holder nor the names of its + contributors may be used to endorse or promote products derived from + this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/node_modules/electron-download/collaborators.md b/node_modules/electron-download/collaborators.md new file mode 100644 index 0000000..fb551a1 --- /dev/null +++ b/node_modules/electron-download/collaborators.md @@ -0,0 +1,8 @@ +## Collaborators + +electron-download is only possible due to the excellent work of the following collaborators: + +<table><tbody><tr><th align="left">maxogden</th><td><a href="https://github.com/maxogden">GitHub/maxogden</a></td></tr> +<tr><th align="left">mafintosh</th><td><a href="https://github.com/mafintosh">GitHub/mafintosh</a></td></tr> +<tr><th align="left">fritx</th><td><a href="https://github.com/fritx">GitHub/fritx</a></td></tr> +</tbody></table> diff --git a/node_modules/electron-download/lib/arch.js b/node_modules/electron-download/lib/arch.js new file mode 100644 index 0000000..46a0ed5 --- /dev/null +++ b/node_modules/electron-download/lib/arch.js @@ -0,0 +1,30 @@ +'use strict' + +const execSync = require('child_process').execSync + +module.exports = { + host: function host (quiet) { + const arch = process.arch + if (arch === 'arm') { + switch (process.config.variables.arm_version) { + case '6': + return module.exports.uname() + case '7': + return 'armv7l' + default: + if (!quiet) { + console.warn(`WARNING: Could not determine specific ARM arch. Detected ARM version: ${JSON.stringify(process.config.variables.arm_version)}`) + } + } + } + + return arch + }, + + /** + * Returns the arch name from the `uname` utility. + */ + uname: function uname () { + return execSync('uname -m').toString().trim() + } +} diff --git a/node_modules/electron-download/lib/cli.js b/node_modules/electron-download/lib/cli.js new file mode 100755 index 0000000..32e2f12 --- /dev/null +++ b/node_modules/electron-download/lib/cli.js @@ -0,0 +1,18 @@ +#!/usr/bin/env node + +'use strict' + +const download = require('./') +const minimist = require('minimist') + +const opts = minimist(process.argv.slice(2)) + +if (opts['strict-ssl'] === false) { + opts.strictSSL = false +} + +download(opts, (err, zipPath) => { + if (err) throw err + console.log('Downloaded zip:', zipPath) + process.exit(0) +}) diff --git a/node_modules/electron-download/lib/index.js b/node_modules/electron-download/lib/index.js new file mode 100644 index 0000000..11c037d --- /dev/null +++ b/node_modules/electron-download/lib/index.js @@ -0,0 +1,336 @@ +'use strict' + +const arch = require('./arch') +const debug = require('debug')('electron-download') +const envPaths = require('env-paths') +const fs = require('fs-extra') +const rc = require('rc') +const nugget = require('nugget') +const os = require('os') +const path = require('path') +const pathExists = require('path-exists') +const semver = require('semver') +const sumchecker = require('sumchecker') + +class ElectronDownloader { + constructor (opts) { + this.opts = Object.assign({ autoDownload: true }, opts) + if (this.opts.force && !this.opts.autoDownload) { + throw new Error('force and autoDownload options are incompatible for Electron Download') + } + + this.npmrc = {} + try { + rc('npm', this.npmrc) + } catch (error) { + console.error(`Error reading npm configuration: ${error.message}`) + } + } + + get baseUrl () { + if (this.version.indexOf('nightly') !== -1) { + return process.env.NPM_CONFIG_ELECTRON_NIGHTLY_MIRROR || + process.env.npm_config_electron_nightly_mirror || + process.env.npm_package_config_electron_nightly_mirror || + process.env.ELECTRON_NIGHTLY_MIRROR || + this.opts.nightly_mirror || + 'https://github.com/electron/nightlies/releases/download/v' + } + return process.env.NPM_CONFIG_ELECTRON_MIRROR || + process.env.npm_config_electron_mirror || + process.env.npm_package_config_electron_mirror || + process.env.ELECTRON_MIRROR || + this.opts.mirror || + 'https://github.com/electron/electron/releases/download/v' + } + + get middleUrl () { + return process.env.NPM_CONFIG_ELECTRON_CUSTOM_DIR || + process.env.npm_config_electron_custom_dir || + process.env.npm_package_config_electron_custom_dir || + process.env.ELECTRON_CUSTOM_DIR || + this.opts.customDir || + this.version + } + + get urlSuffix () { + return process.env.NPM_CONFIG_ELECTRON_CUSTOM_FILENAME || + process.env.npm_config_electron_custom_filename || + process.env.npm_package_config_electron_custom_filename || + process.env.ELECTRON_CUSTOM_FILENAME || + this.opts.customFilename || + this.filename + } + + get arch () { + return this.opts.arch || arch.host(this.quiet) + } + + get cache () { + const cacheLocation = this.opts.cache || process.env.ELECTRON_CACHE + if (cacheLocation) return cacheLocation + + const oldCacheDirectory = path.join(os.homedir(), './.electron') + if (pathExists.sync(path.join(oldCacheDirectory, this.filename))) { + return oldCacheDirectory + } + // use passed argument or XDG environment variable fallback to OS default + return envPaths('electron', {suffix: ''}).cache + } + + get cachedChecksum () { + return path.join(this.cache, `${this.checksumFilename}-${this.version}`) + } + + get cachedZip () { + return path.join(this.cache, this.filename) + } + + get checksumFilename () { + return 'SHASUMS256.txt' + } + + get checksumUrl () { + return `${this.baseUrl}${this.middleUrl}/${this.checksumFilename}` + } + + get filename () { + const type = `${this.platform}-${this.arch}` + const suffix = `v${this.version}-${type}` + + if (this.chromedriver) { + // Chromedriver started using Electron's version in asset name in 1.7.0 + if (semver.gte(this.version, '1.7.0')) { + return `chromedriver-${suffix}.zip` + } else { + return `chromedriver-v2.21-${type}.zip` + } + } else if (this.mksnapshot) { + return `mksnapshot-${suffix}.zip` + } else if (this.ffmpeg) { + return `ffmpeg-${suffix}.zip` + } else if (this.symbols) { + return `electron-${suffix}-symbols.zip` + } else if (this.dsym) { + return `electron-${suffix}-dsym.zip` + } else { + return `electron-${suffix}.zip` + } + } + + get platform () { + return this.opts.platform || os.platform() + } + + get proxy () { + let proxy + if (this.npmrc && this.npmrc.proxy) proxy = this.npmrc.proxy + if (this.npmrc && this.npmrc['https-proxy']) proxy = this.npmrc['https-proxy'] + + return proxy + } + + get quiet () { + return this.opts.quiet || process.stdout.rows < 1 + } + + get strictSSL () { + let strictSSL = true + if (this.opts.strictSSL === false || this.npmrc['strict-ssl'] === false) { + strictSSL = false + } + + return strictSSL + } + + get force () { + return this.opts.force || false + } + + get symbols () { + return this.opts.symbols || false + } + + get dsym () { + return this.opts.dsym || false + } + + get chromedriver () { + return this.opts.chromedriver || false + } + + get mksnapshot () { + return this.opts.mksnapshot || false + } + + get ffmpeg () { + return this.opts.ffmpeg || false + } + + get url () { + return process.env.ELECTRON_DOWNLOAD_OVERRIDE_URL || + `${this.baseUrl}${this.middleUrl}/${this.urlSuffix}` + } + + get verifyChecksumNeeded () { + return !this.opts.disableChecksumSafetyCheck && semver.gte(this.version, '1.3.2') + } + + get version () { + return this.opts.version + } + + get headers () { + return this.opts.headers + } + + checkForCachedChecksum (cb) { + pathExists(this.cachedChecksum) + .then(exists => { + if (exists && !this.force) { + this.verifyChecksum(cb) + } else { + this.downloadChecksum(cb) + } + }) + } + + checkForCachedZip (cb) { + pathExists(this.cachedZip).then(exists => { + if (exists && !this.force) { + debug('zip exists', this.cachedZip) + this.checkIfZipNeedsVerifying(cb) + } else if (this.opts.autoDownload) { + this.ensureCacheDir(cb) + } else { + cb(new Error(`File: "${this.cachedZip}" does not exist locally and autoDownload is false`)) + } + }) + } + + checkIfZipNeedsVerifying (cb) { + if (this.verifyChecksumNeeded) { + debug('Verifying zip with checksum') + return this.checkForCachedChecksum(cb) + } + return cb(null, this.cachedZip) + } + + createCacheDir (cb) { + fs.mkdirs(this.cache, (err) => { + if (err) { + if (err.code !== 'EACCES') return cb(err) + // try local folder if homedir is off limits (e.g. some linuxes return '/' as homedir) + const localCache = path.resolve('./.electron') + return fs.mkdirs(localCache, function (err) { + if (err) return cb(err) + cb(null, localCache) + }) + } + cb(null, this.cache) + }) + } + + downloadChecksum (cb) { + this.downloadFile(this.checksumUrl, this.cachedChecksum, cb, this.verifyChecksum.bind(this)) + } + + downloadFile (url, cacheFilename, cb, onSuccess) { + const tempFileName = `tmp-${process.pid}-${(ElectronDownloader.tmpFileCounter++).toString(16)}-${path.basename(cacheFilename)}` + debug('downloading', url, 'to', this.cache) + const nuggetOpts = { + target: tempFileName, + dir: this.cache, + resume: true, + quiet: this.quiet, + strictSSL: this.strictSSL, + proxy: this.proxy, + headers: this.headers + } + nugget(url, nuggetOpts, (errors) => { + if (errors) { + // nugget returns an array of errors but we only need 1st because we only have 1 url + return this.handleDownloadError(cb, errors[0]) + } + + this.moveFileToCache(tempFileName, cacheFilename, cb, onSuccess) + }) + } + + downloadIfNotCached (cb) { + if (!this.version) return cb(new Error('must specify version')) + debug('info', {cache: this.cache, filename: this.filename, url: this.url}) + this.checkForCachedZip(cb) + } + + downloadZip (cb) { + this.downloadFile(this.url, this.cachedZip, cb, this.checkIfZipNeedsVerifying.bind(this)) + } + + ensureCacheDir (cb) { + debug('creating cache dir') + this.createCacheDir((err, actualCache) => { + if (err) return cb(err) + this.opts.cache = actualCache // in case cache dir changed + this.downloadZip(cb) + }) + } + + handleDownloadError (cb, error) { + if (error.message.indexOf('404') === -1) return cb(error) + if (this.symbols) { + error.message = `Failed to find Electron symbols v${this.version} for ${this.platform}-${this.arch} at ${this.url}` + } else { + error.message = `Failed to find Electron v${this.version} for ${this.platform}-${this.arch} at ${this.url}` + } + + return cb(error) + } + + moveFileToCache (filename, target, cb, onSuccess) { + const cache = this.cache + debug('moving', filename, 'from', cache, 'to', target) + fs.rename(path.join(cache, filename), target, (err) => { + if (err) { + fs.unlink(cache, cleanupError => { + try { + if (cleanupError) { + console.error(`Error deleting cache file: ${cleanupError.message}`) + } + } finally { + cb(err) + } + }) + } else { + onSuccess(cb) + } + }) + } + + verifyChecksum (cb) { + const options = {} + if (semver.lt(this.version, '1.3.5')) { + options.defaultTextEncoding = 'binary' + } + const checker = new sumchecker.ChecksumValidator('sha256', this.cachedChecksum, options) + checker.validate(this.cache, this.filename).then(() => { + cb(null, this.cachedZip) + }, (err) => { + fs.unlink(this.cachedZip, (fsErr) => { + if (fsErr) return cb(fsErr) + cb(err) + }) + }) + } +} + +ElectronDownloader.tmpFileCounter = 0 + +module.exports = function download (opts, cb) { + try { + const downloader = new ElectronDownloader(opts) + downloader.downloadIfNotCached(cb) + } catch (err) { + cb(err) + } +} diff --git a/node_modules/electron-download/package.json b/node_modules/electron-download/package.json new file mode 100644 index 0000000..86dc5cb --- /dev/null +++ b/node_modules/electron-download/package.json @@ -0,0 +1,64 @@ +{ + "name": "electron-download", + "version": "4.1.1", + "description": "download electron prebuilt binary zips from github releases", + "main": "lib/index.js", + "bin": { + "electron-download": "lib/cli.js" + }, + "scripts": { + "lint": "eslint lib test", + "unit-tests": "tape test/*.js", + "test": "npm run unit-tests && npm run lint" + }, + "repository": { + "type": "git", + "url": "git+https://github.com/electron-userland/electron-download.git" + }, + "author": "max ogden", + "license": "BSD-3-Clause", + "bugs": { + "url": "https://github.com/electron-userland/electron-download/issues" + }, + "homepage": "https://github.com/electron-userland/electron-download#readme", + "dependencies": { + "debug": "^3.0.0", + "env-paths": "^1.0.0", + "fs-extra": "^4.0.1", + "minimist": "^1.2.0", + "nugget": "^2.0.1", + "path-exists": "^3.0.0", + "rc": "^1.2.1", + "semver": "^5.4.1", + "sumchecker": "^2.0.2" + }, + "devDependencies": { + "eslint": "^4.4.1", + "eslint-config-standard": "^10.2.1", + "eslint-plugin-import": "^2.7.0", + "eslint-plugin-node": "^5.1.1", + "eslint-plugin-promise": "^3.5.0", + "eslint-plugin-standard": "^3.0.1", + "sinon": "^6.1.4", + "tape": "^4.8.0", + "temp": "^0.8.3" + }, + "eslintConfig": { + "extends": "standard", + "parserOptions": { + "sourceType": "script" + }, + "rules": { + "strict": [ + "error" + ], + "prefer-const": [ + "error" + ] + } + }, + "keywords": [], + "engines": { + "node": ">= 4.0" + } +} diff --git a/node_modules/electron-download/readme.md b/node_modules/electron-download/readme.md new file mode 100644 index 0000000..364cad2 --- /dev/null +++ b/node_modules/electron-download/readme.md @@ -0,0 +1,106 @@ +# electron-download + +[](https://travis-ci.org/electron-userland/electron-download) +[](https://ci.appveyor.com/project/electron-bot/electron-download/branch/master) + +[](https://www.npmjs.com/package/electron-download) + +Downloads an Electron release zip from GitHub. + +Used by [electron-prebuilt](https://npmjs.org/electron-prebuilt) and [electron-packager](https://npmjs.org/electron-packager) + +### Usage + +**Note: Requires Node >= 4.0 to run.** + +```shell +$ npm install --global electron-download +$ electron-download --version=0.31.1 +``` + +```javascript +const download = require('electron-download') + +download({ + version: '0.25.1', + arch: 'ia32', + platform: 'win32', + cache: './zips' +}, function (err, zipPath) { + // zipPath will be the path of the zip that it downloaded. + // If the zip was already cached it will skip + // downloading and call the cb with the cached zip path. + // If it wasn't cached it will download the zip and save + // it in the cache path. +}) +``` + +If you don't specify `arch` or `platform` args it will use the built-in `os` module to get the values from the current OS. Specifying `version` is mandatory. If there is a `SHASUMS256.txt` file available for the `version`, the file downloaded will be validated against its checksum to ensure that it was downloaded without errors. + +You can also use `electron-download` to download the `chromedriver`, `ffmpeg`, +`mksnapshot`, and symbols assets for a specific Electron release. This can be +configured by setting the `chromedriver`, `ffmpeg`, `mksnapshot`, or +`symbols` property to `true` in the specified options object. Only one of +these options may be specified per download call. + +You can force a re-download of the asset and the `SHASUM` file by setting the +`force` option to `true`. + +If you would like to override the mirror location, three options are available. The mirror URL is composed as `url = ELECTRON_MIRROR + ELECTRON_CUSTOM_DIR + '/' + ELECTRON_CUSTOM_FILENAME`. + +You can set the `ELECTRON_MIRROR` or [`NPM_CONFIG_ELECTRON_MIRROR`](https://docs.npmjs.com/misc/config#environment-variables) environment variable or `mirror` opt variable to use a custom base URL for grabbing Electron zips. The same pattern applies to `ELECTRON_CUSTOM_DIR` and `ELECTRON_CUSTOM_FILENAME`: + +```plain +## Electron Mirror of China +ELECTRON_MIRROR="https://npm.taobao.org/mirrors/electron/" + +## or for a local mirror +ELECTRON_MIRROR="https://10.1.2.105/" +ELECTRON_CUSTOM_DIR="our/internal/filePath" +ELECTRON_CUSTOM_FILENAME="electron.zip" +``` + +You can set ELECTRON_MIRROR in `.npmrc` as well, using the lowercase name: + +```plain +electron_mirror=https://10.1.2.105/ +electron_custom_dir="our/internal/filePath" +electron_custom_filename="electron.zip" +``` + +You can also set the same variables in your project's package.json: + +```json +{ + "name" : "my-electron-project", + "config" : { + "electron_mirror": "https://10.1.2.105/", + "electron_custom_dir": "our/internal/filePath", + "electron_custom_filename": "electron.zip" + } +} +``` + +The order of precedence is: + +1. npm config or .npmrc, uppercase (`process.env.NPM_CONFIG_ELECTRON_*`) +1. npm config or .npmrc, lowercase(`process.env.npm_config_electron_*`) +1. package.json (`process.env.npm_package_config_electron_*`) +1. environment variables (`process.env.ELECTRON_*`) +1. the options given to `download` +1. defaults + +You can also disable checksum validation if you really want to (this is in +general a bad idea). Do this by setting `disableChecksumSafetyCheck` to `true` +in the options object. Use this only when testing local build of Electron, +if you have internal builds of Electron you should generate the SHASUMS file +yourself and let `electron-download` still perform its hash validations. + +### Cache location +The location of the cache depends on the operating system, the defaults are: +- Linux: `$XDG_CACHE_HOME` or `~/.cache/electron/` +- MacOS: `~/Library/Caches/electron/` +- Windows: `$LOCALAPPDATA/electron/Cache` or `~/AppData/Local/electron/Cache/` + +You can set the `ELECTRON_CACHE` environment variable to set cache location explicitly. + |