mirror of
https://github.com/JonasunderscoreJones/api.jonasjones.dev.git
synced 2025-10-23 12:09:19 +02:00
Initial commit (by create-cloudflare CLI)
This commit is contained in:
commit
58a42872a0
1745 changed files with 741893 additions and 0 deletions
21
node_modules/napi-build-utils/LICENSE
generated
vendored
Normal file
21
node_modules/napi-build-utils/LICENSE
generated
vendored
Normal file
|
|
@ -0,0 +1,21 @@
|
|||
MIT License
|
||||
|
||||
Copyright (c) 2018 inspiredware
|
||||
|
||||
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.
|
||||
48
node_modules/napi-build-utils/README.md
generated
vendored
Normal file
48
node_modules/napi-build-utils/README.md
generated
vendored
Normal file
|
|
@ -0,0 +1,48 @@
|
|||
# napi-build-utils
|
||||
|
||||
[](https://www.npmjs.com/package/napi-build-utils)
|
||||
|
||||
[](https://travis-ci.org/inspiredware/napi-build-utils)
|
||||
[](http://standardjs.com/)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
|
||||
A set of utilities to assist developers of tools that build [N-API](https://nodejs.org/api/n-api.html#n_api_n_api) native add-ons.
|
||||
|
||||
## Background
|
||||
|
||||
This module is targeted to developers creating tools that build N-API native add-ons.
|
||||
|
||||
It implements a set of functions that aid in determining the N-API version supported by the currently running Node instance and the set of N-API versions against which the N-API native add-on is designed to be built. Other functions determine whether a particular N-API version can be built and can issue console warnings for unsupported N-API versions.
|
||||
|
||||
Unlike the modules this code is designed to facilitate building, this module is written entirely in JavaScript.
|
||||
|
||||
## Quick start
|
||||
|
||||
```bash
|
||||
$ npm install napi-build-utils
|
||||
```
|
||||
|
||||
The module exports a set of functions documented [here](./index.md). For example:
|
||||
|
||||
```javascript
|
||||
var napiBuildUtils = require('napi-build-utils');
|
||||
var napiVersion = napiBuildUtils.getNapiVersion(); // N-API version supported by Node, or undefined.
|
||||
```
|
||||
|
||||
## Declaring supported N-API versions
|
||||
|
||||
Native modules that are designed to work with [N-API](https://nodejs.org/api/n-api.html#n_api_n_api) must explicitly declare the N-API version(s) against which they are coded to build. This is accomplished by including a `binary.napi_versions` property in the module's `package.json` file. For example:
|
||||
|
||||
```json
|
||||
"binary": {
|
||||
"napi_versions": [2,3]
|
||||
}
|
||||
```
|
||||
|
||||
In the absence of a need to compile against a specific N-API version, the value `3` is a good choice as this is the N-API version that was supported when N-API left experimental status.
|
||||
|
||||
Modules that are built against a specific N-API version will continue to operate indefinitely, even as later versions of N-API are introduced.
|
||||
|
||||
## Support
|
||||
|
||||
If you run into problems or limitations, please file an issue and we'll take a look. Pull requests are also welcome.
|
||||
213
node_modules/napi-build-utils/index.js
generated
vendored
Normal file
213
node_modules/napi-build-utils/index.js
generated
vendored
Normal file
|
|
@ -0,0 +1,213 @@
|
|||
'use strict'
|
||||
// Copyright (c) 2018 inspiredware
|
||||
|
||||
var path = require('path')
|
||||
var pkg = require(path.resolve('package.json'))
|
||||
|
||||
var versionArray = process.version
|
||||
.substr(1)
|
||||
.replace(/-.*$/, '')
|
||||
.split('.')
|
||||
.map(function (item) {
|
||||
return +item
|
||||
})
|
||||
|
||||
/**
|
||||
*
|
||||
* A set of utilities to assist developers of tools that build
|
||||
* [N-API](https://nodejs.org/api/n-api.html#n_api_n_api) native add-ons.
|
||||
*
|
||||
* The main repository can be found
|
||||
* [here](https://github.com/inspiredware/napi-build-utils#napi-build-utils).
|
||||
*
|
||||
* @module napi-build-utils
|
||||
*/
|
||||
|
||||
/**
|
||||
* Implements a consistent name of `napi` for N-API runtimes.
|
||||
*
|
||||
* @param {string} runtime The runtime string.
|
||||
* @returns {boolean}
|
||||
*/
|
||||
exports.isNapiRuntime = function (runtime) {
|
||||
return runtime === 'napi'
|
||||
}
|
||||
|
||||
/**
|
||||
* Determines whether the specified N-API version is supported
|
||||
* by both the currently running Node instance and the package.
|
||||
*
|
||||
* @param {string} napiVersion The N-API version to check.
|
||||
* @returns {boolean}
|
||||
*/
|
||||
exports.isSupportedVersion = function (napiVersion) {
|
||||
var version = parseInt(napiVersion, 10)
|
||||
return version <= exports.getNapiVersion() && exports.packageSupportsVersion(version)
|
||||
}
|
||||
|
||||
/**
|
||||
* Determines whether the specified N-API version is supported by the package.
|
||||
* The N-API version must be preseent in the `package.json`
|
||||
* `binary.napi_versions` array.
|
||||
*
|
||||
* @param {number} napiVersion The N-API version to check.
|
||||
* @returns {boolean}
|
||||
* @private
|
||||
*/
|
||||
exports.packageSupportsVersion = function (napiVersion) {
|
||||
if (pkg.binary && pkg.binary.napi_versions &&
|
||||
pkg.binary.napi_versions instanceof Array) {
|
||||
for (var i = 0; i < pkg.binary.napi_versions.length; i++) {
|
||||
if (pkg.binary.napi_versions[i] === napiVersion) return true
|
||||
};
|
||||
};
|
||||
return false
|
||||
}
|
||||
|
||||
/**
|
||||
* Issues a warning to the supplied log if the N-API version is not supported
|
||||
* by the current Node instance or if the N-API version is not supported
|
||||
* by the package.
|
||||
*
|
||||
* @param {string} napiVersion The N-API version to check.
|
||||
* @param {Object} log The log object to which the warnings are to be issued.
|
||||
* Must implement the `warn` method.
|
||||
*/
|
||||
exports.logUnsupportedVersion = function (napiVersion, log) {
|
||||
if (!exports.isSupportedVersion(napiVersion)) {
|
||||
if (exports.packageSupportsVersion(napiVersion)) {
|
||||
log.warn('This Node instance does not support N-API version ' + napiVersion)
|
||||
} else {
|
||||
log.warn('This package does not support N-API version ' + napiVersion)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Issues warnings to the supplied log for those N-API versions not supported
|
||||
* by the N-API runtime or the package.
|
||||
*
|
||||
* Note that this function is specific to the
|
||||
* [`prebuild`](https://github.com/prebuild/prebuild#prebuild) package.
|
||||
*
|
||||
* `target` is the list of targets to be built and is determined in one of
|
||||
* three ways from the command line arguments:
|
||||
* (1) `--target` specifies a specific target to build.
|
||||
* (2) `--all` specifies all N-API versions supported by the package.
|
||||
* (3) Neither of these specifies to build the single "best version available."
|
||||
*
|
||||
* `prebuild` is an array of objects in the form `{runtime: 'napi', target: '2'}`.
|
||||
* The array contains the list of N-API versions that are supported by both the
|
||||
* package being built and the currently running Node instance.
|
||||
*
|
||||
* The objective of this function is to issue a warning for those items that appear
|
||||
* in the `target` argument but not in the `prebuild` argument.
|
||||
* If a specific target is supported by the package (`packageSupportsVersion`) but
|
||||
* but note in `prebuild`, the assumption is that the target is not supported by
|
||||
* Node.
|
||||
*
|
||||
* @param {(Array<string>|string)} target The N-API version(s) to check. Target is
|
||||
* @param {Array<Object>} prebuild A config object created by the `prebuild` package.
|
||||
* @param {Object} log The log object to which the warnings are to be issued.
|
||||
* Must implement the `warn` method.
|
||||
* @private
|
||||
*/
|
||||
exports.logMissingNapiVersions = function (target, prebuild, log) {
|
||||
if (exports.getNapiBuildVersions()) {
|
||||
var targets = [].concat(target)
|
||||
targets.forEach(function (napiVersion) {
|
||||
if (!prebuildExists(prebuild, napiVersion)) {
|
||||
if (exports.packageSupportsVersion(parseInt(napiVersion, 10))) {
|
||||
log.warn('This Node instance does not support N-API version ' + napiVersion)
|
||||
} else {
|
||||
log.warn('This package does not support N-API version ' + napiVersion)
|
||||
}
|
||||
}
|
||||
})
|
||||
} else {
|
||||
log.error('Builds with runtime \'napi\' require a binary.napi_versions ' +
|
||||
'property on the package.json file')
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Determines whether the specified N-API version exists in the prebuild
|
||||
* configuration object.
|
||||
*
|
||||
* Note that this function is speicifc to the `prebuild` and `prebuild-install`
|
||||
* packages.
|
||||
*
|
||||
* @param {Object} prebuild A config object created by the `prebuild` package.
|
||||
* @param {string} napiVersion The N-APi version to be checked.
|
||||
* @return {boolean}
|
||||
* @private
|
||||
*/
|
||||
var prebuildExists = function (prebuild, napiVersion) {
|
||||
if (prebuild) {
|
||||
for (var i = 0; i < prebuild.length; i++) {
|
||||
if (prebuild[i].target === napiVersion) return true
|
||||
}
|
||||
}
|
||||
return false
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the best N-API version to build given the highest N-API
|
||||
* version supported by the current Node instance and the N-API versions
|
||||
* supported by the package, or undefined if a suitable N-API version
|
||||
* cannot be determined.
|
||||
*
|
||||
* The best build version is the greatest N-API version supported by
|
||||
* the package that is less than or equal to the highest N-API version
|
||||
* supported by the current Node instance.
|
||||
*
|
||||
* @returns {number|undefined}
|
||||
*/
|
||||
exports.getBestNapiBuildVersion = function () {
|
||||
var bestNapiBuildVersion = 0
|
||||
var napiBuildVersions = exports.getNapiBuildVersions(pkg)
|
||||
if (napiBuildVersions) {
|
||||
var ourNapiVersion = exports.getNapiVersion()
|
||||
napiBuildVersions.forEach(function (napiBuildVersion) {
|
||||
if (napiBuildVersion > bestNapiBuildVersion &&
|
||||
napiBuildVersion <= ourNapiVersion) {
|
||||
bestNapiBuildVersion = napiBuildVersion
|
||||
}
|
||||
})
|
||||
}
|
||||
return bestNapiBuildVersion === 0 ? undefined : bestNapiBuildVersion
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns an array of N-API versions supported by the package.
|
||||
*
|
||||
* @returns {Array<string>}
|
||||
*/
|
||||
exports.getNapiBuildVersions = function () {
|
||||
var napiBuildVersions = []
|
||||
// remove duplicates, convert to text
|
||||
if (pkg.binary && pkg.binary.napi_versions) {
|
||||
pkg.binary.napi_versions.forEach(function (napiVersion) {
|
||||
var duplicated = napiBuildVersions.indexOf('' + napiVersion) !== -1
|
||||
if (!duplicated) {
|
||||
napiBuildVersions.push('' + napiVersion)
|
||||
}
|
||||
})
|
||||
}
|
||||
return napiBuildVersions.length ? napiBuildVersions : undefined
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the highest N-API version supported by the current node instance
|
||||
* or undefined if N-API is not supported.
|
||||
*
|
||||
* @returns {string|undefined}
|
||||
*/
|
||||
exports.getNapiVersion = function () {
|
||||
var version = process.versions.napi // string, can be undefined
|
||||
if (!version) { // this code should never need to be updated
|
||||
if (versionArray[0] === 9 && versionArray[1] >= 3) version = '2' // 9.3.0+
|
||||
else if (versionArray[0] === 8) version = '1' // 8.0.0+
|
||||
}
|
||||
return version
|
||||
}
|
||||
81
node_modules/napi-build-utils/index.md
generated
vendored
Normal file
81
node_modules/napi-build-utils/index.md
generated
vendored
Normal file
|
|
@ -0,0 +1,81 @@
|
|||
<a name="module_napi-build-utils"></a>
|
||||
|
||||
## napi-build-utils
|
||||
A set of utilities to assist developers of tools that build
|
||||
[N-API](https://nodejs.org/api/n-api.html#n_api_n_api) native add-ons.
|
||||
|
||||
The main repository can be found
|
||||
[here](https://github.com/inspiredware/napi-build-utils#napi-build-utils).
|
||||
|
||||
|
||||
* [napi-build-utils](#module_napi-build-utils)
|
||||
* [.isNapiRuntime(runtime)](#module_napi-build-utils.isNapiRuntime) ⇒ <code>boolean</code>
|
||||
* [.isSupportedVersion(napiVersion)](#module_napi-build-utils.isSupportedVersion) ⇒ <code>boolean</code>
|
||||
* [.logUnsupportedVersion(napiVersion, log)](#module_napi-build-utils.logUnsupportedVersion)
|
||||
* [.getBestNapiBuildVersion()](#module_napi-build-utils.getBestNapiBuildVersion) ⇒ <code>number</code> \| <code>undefined</code>
|
||||
* [.getNapiBuildVersions()](#module_napi-build-utils.getNapiBuildVersions) ⇒ <code>Array.<string></code>
|
||||
* [.getNapiVersion()](#module_napi-build-utils.getNapiVersion) ⇒ <code>string</code> \| <code>undefined</code>
|
||||
|
||||
<a name="module_napi-build-utils.isNapiRuntime"></a>
|
||||
|
||||
### napi-build-utils.isNapiRuntime(runtime) ⇒ <code>boolean</code>
|
||||
Implements a consistent name of `napi` for N-API runtimes.
|
||||
|
||||
**Kind**: static method of [<code>napi-build-utils</code>](#module_napi-build-utils)
|
||||
|
||||
| Param | Type | Description |
|
||||
| --- | --- | --- |
|
||||
| runtime | <code>string</code> | The runtime string. |
|
||||
|
||||
<a name="module_napi-build-utils.isSupportedVersion"></a>
|
||||
|
||||
### napi-build-utils.isSupportedVersion(napiVersion) ⇒ <code>boolean</code>
|
||||
Determines whether the specified N-API version is supported
|
||||
by both the currently running Node instance and the package.
|
||||
|
||||
**Kind**: static method of [<code>napi-build-utils</code>](#module_napi-build-utils)
|
||||
|
||||
| Param | Type | Description |
|
||||
| --- | --- | --- |
|
||||
| napiVersion | <code>string</code> | The N-API version to check. |
|
||||
|
||||
<a name="module_napi-build-utils.logUnsupportedVersion"></a>
|
||||
|
||||
### napi-build-utils.logUnsupportedVersion(napiVersion, log)
|
||||
Issues a warning to the supplied log if the N-API version is not supported
|
||||
by the current Node instance or if the N-API version is not supported
|
||||
by the package.
|
||||
|
||||
**Kind**: static method of [<code>napi-build-utils</code>](#module_napi-build-utils)
|
||||
|
||||
| Param | Type | Description |
|
||||
| --- | --- | --- |
|
||||
| napiVersion | <code>string</code> | The N-API version to check. |
|
||||
| log | <code>Object</code> | The log object to which the warnings are to be issued. Must implement the `warn` method. |
|
||||
|
||||
<a name="module_napi-build-utils.getBestNapiBuildVersion"></a>
|
||||
|
||||
### napi-build-utils.getBestNapiBuildVersion() ⇒ <code>number</code> \| <code>undefined</code>
|
||||
Returns the best N-API version to build given the highest N-API
|
||||
version supported by the current Node instance and the N-API versions
|
||||
supported by the package, or undefined if a suitable N-API version
|
||||
cannot be determined.
|
||||
|
||||
The best build version is the greatest N-API version supported by
|
||||
the package that is less than or equal to the highest N-API version
|
||||
supported by the current Node instance.
|
||||
|
||||
**Kind**: static method of [<code>napi-build-utils</code>](#module_napi-build-utils)
|
||||
<a name="module_napi-build-utils.getNapiBuildVersions"></a>
|
||||
|
||||
### napi-build-utils.getNapiBuildVersions() ⇒ <code>Array.<string></code>
|
||||
Returns an array of N-API versions supported by the package.
|
||||
|
||||
**Kind**: static method of [<code>napi-build-utils</code>](#module_napi-build-utils)
|
||||
<a name="module_napi-build-utils.getNapiVersion"></a>
|
||||
|
||||
### napi-build-utils.getNapiVersion() ⇒ <code>string</code> \| <code>undefined</code>
|
||||
Returns the highest N-API version supported by the current node instance
|
||||
or undefined if N-API is not supported.
|
||||
|
||||
**Kind**: static method of [<code>napi-build-utils</code>](#module_napi-build-utils)
|
||||
41
node_modules/napi-build-utils/package.json
generated
vendored
Normal file
41
node_modules/napi-build-utils/package.json
generated
vendored
Normal file
|
|
@ -0,0 +1,41 @@
|
|||
{
|
||||
"name": "napi-build-utils",
|
||||
"version": "1.0.2",
|
||||
"description": "A set of utilities to assist developers of tools that build N-API native add-ons",
|
||||
"main": "index.js",
|
||||
"scripts": {
|
||||
"doc": "jsdoc2md index.js >index.md",
|
||||
"test": "mocha test/ && npm run lint",
|
||||
"lint": "standard",
|
||||
"prepublishOnly": "npm run test && npm run doc"
|
||||
},
|
||||
"keywords": [
|
||||
"n-api",
|
||||
"prebuild",
|
||||
"prebuild-install"
|
||||
],
|
||||
"author": "Jim Schlight",
|
||||
"license": "MIT",
|
||||
"homepage": "https://github.com/inspiredware/napi-build-utils#readme",
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "git+https://github.com/inspiredware/napi-build-utils.git"
|
||||
},
|
||||
"bugs": {
|
||||
"url": "https://github.com/inspiredware/napi-build-utils/issues"
|
||||
},
|
||||
"devDependencies": {
|
||||
"chai": "^4.1.2",
|
||||
"jsdoc-to-markdown": "^4.0.1",
|
||||
"mocha": "^5.2.0",
|
||||
"standard": "^12.0.1"
|
||||
},
|
||||
"binary": {
|
||||
"note": "napi-build-tools is not an N-API module. This entry is for unit testing.",
|
||||
"napi_versions": [
|
||||
2,
|
||||
2,
|
||||
3
|
||||
]
|
||||
}
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue