Deployed the page to Github Pages.
This commit is contained in:
parent
1d79754e93
commit
2c89899458
SSH key fingerprint:
SHA256:kEsnuHX+qbwhxSAXPUQ4ox535wFHu/hIRaa53FzxRpo
62797 changed files with 6551425 additions and 15279 deletions
15
node_modules/proc-log/LICENSE
generated
vendored
Normal file
15
node_modules/proc-log/LICENSE
generated
vendored
Normal file
|
|
@ -0,0 +1,15 @@
|
|||
The ISC License
|
||||
|
||||
Copyright (c) GitHub, Inc.
|
||||
|
||||
Permission to use, copy, modify, and/or distribute this software for any
|
||||
purpose with or without fee is hereby granted, provided that the above
|
||||
copyright notice and this permission notice appear in all copies.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||||
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||||
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
||||
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
||||
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
|
||||
IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||
226
node_modules/proc-log/README.md
generated
vendored
Normal file
226
node_modules/proc-log/README.md
generated
vendored
Normal file
|
|
@ -0,0 +1,226 @@
|
|||
# proc-log
|
||||
|
||||
Emits events on the process object which a listener can consume and print to the terminal or log file.
|
||||
|
||||
This is used by various modules within the npm CLI stack in order to send log events that can be consumed by a listener on the process object.
|
||||
|
||||
Currently emits `log`, `output`, `input`, and `time` events.
|
||||
|
||||
## API
|
||||
|
||||
```js
|
||||
const { log, output, input, time } = require('proc-log')
|
||||
```
|
||||
|
||||
#### output
|
||||
* `output.standard(...args)` calls `process.emit('output', 'standard', ...args)`
|
||||
|
||||
This is for general standard output. Consumers will typically show this on stdout (after optionally formatting or filtering it).
|
||||
|
||||
* `output.error(...args)` calls `process.emit('output', 'error', ...args)`
|
||||
|
||||
This is for general error output. Consumers will typically show this on stderr (after optionally formatting or filtering it).
|
||||
|
||||
* `output.buffer(...args)` calls `process.emit('output', 'buffer', ...args)`
|
||||
|
||||
This is for buffered output. Consumers will typically buffer this until they are ready to display.
|
||||
|
||||
* `output.flush(...args)` calls `process.emit('output', 'flush', ...args)`
|
||||
|
||||
This is to indicate that the output buffer should be flushed.
|
||||
|
||||
* `output.LEVELS` an array of strings of all output method names
|
||||
|
||||
#### log
|
||||
* `log.error(...args)` calls `process.emit('log', 'error', ...args)`
|
||||
|
||||
The highest log level. For printing extremely serious errors that indicate something went wrong.
|
||||
|
||||
* `log.warn(...args)` calls `process.emit('log', 'warn', ...args)`
|
||||
|
||||
A fairly high log level. Things that the user needs to be aware of, but which won't necessarily cause improper functioning of the system.
|
||||
|
||||
* `log.notice(...args)` calls `process.emit('log', 'notice', ...args)`
|
||||
|
||||
Notices which are important, but not necessarily dangerous or a cause for excess concern.
|
||||
|
||||
* `log.info(...args)` calls `process.emit('log', 'info', ...args)`
|
||||
|
||||
Informative messages that may benefit the user, but aren't particularly important.
|
||||
|
||||
* `log.verbose(...args)` calls `process.emit('log', 'verbose', ...args)`
|
||||
|
||||
Noisy output that is more detail that most users will care about.
|
||||
|
||||
* `log.silly(...args)` calls `process.emit('log', 'silly', ...args)`
|
||||
|
||||
Extremely noisy excessive logging messages that are typically only useful for debugging.
|
||||
|
||||
* `log.http(...args)` calls `process.emit('log', 'http', ...args)`
|
||||
|
||||
Information about HTTP requests made and/or completed.
|
||||
|
||||
* `log.timing(...args)` calls `process.emit('log', 'timing', ...args)`
|
||||
|
||||
Timing information.
|
||||
|
||||
* `log.pause()` calls `process.emit('log', 'pause')`
|
||||
|
||||
Used to tell the consumer to stop printing messages.
|
||||
|
||||
* `log.resume()` calls `process.emit('log', 'resume')`
|
||||
|
||||
Used to tell the consumer that it is ok to print messages again.
|
||||
|
||||
* `log.LEVELS` an array of strings of all log method names
|
||||
|
||||
#### input
|
||||
|
||||
* `input.start(fn?)` calls `process.emit('input', 'start')`
|
||||
|
||||
Used to tell the consumer that the terminal is going to begin reading user input. Returns a function that will call `input.end()` for convenience.
|
||||
|
||||
This also takes an optional callback which will run `input.end()` on its completion. If the callback returns a `Promise` then `input.end()` will be run during `finally()`.
|
||||
|
||||
* `input.end()` calls `process.emit('input', 'end')`
|
||||
|
||||
Used to tell the consumer that the terminal has stopped reading user input.
|
||||
|
||||
* `input.read(...args): Promise` calls `process.emit('input', 'read', resolve, reject, ...args)`
|
||||
|
||||
Used to tell the consumer that the terminal is reading user input and returns a `Promise` that the producer can `await` until the consumer has finished its async action.
|
||||
|
||||
This emits `resolve` and `reject` functions (in addition to all passed in arguments) which the consumer must use to resolve the returned `Promise`.
|
||||
|
||||
#### time
|
||||
|
||||
* `time.start(timerName, fn?)` calls `process.emit('time', 'start', 'timerName')`
|
||||
|
||||
Used to start a timer with the specified name. Returns a function that will call `time.end()` for convenience.
|
||||
|
||||
This also takes an optional callback which will run `time.end()` on its completion. If the callback returns a `Promise` then `time.end()` will be run during `finally()`.
|
||||
|
||||
* `time.end(timerName)` calls `process.emit('time', 'end', timeName)`
|
||||
|
||||
Used to tell the consumer to stop a timer with the specified name.
|
||||
|
||||
## Examples
|
||||
|
||||
### log
|
||||
|
||||
Every `log` method calls `process.emit('log', level, ...otherArgs)` internally. So in order to consume those events you need to do `process.on('log', fn)`.
|
||||
|
||||
#### Colorize based on level
|
||||
|
||||
Here's an example of how to consume `proc-log` log events and colorize them based on level:
|
||||
|
||||
```js
|
||||
const chalk = require('chalk')
|
||||
|
||||
process.on('log', (level, ...args) => {
|
||||
if (level === 'error') {
|
||||
console.log(chalk.red(level), ...args)
|
||||
} else {
|
||||
console.log(chalk.blue(level), ...args)
|
||||
}
|
||||
})
|
||||
```
|
||||
|
||||
#### Pause and resume
|
||||
|
||||
`log.pause` and `log.resume` are included so you have the ability to tell your consumer that you want to pause or resume your display of logs. In the npm CLI we use this to buffer all logs on init until we know the correct loglevel to display. But we also setup a second handler that writes everything to a file even if paused.
|
||||
|
||||
```js
|
||||
let paused = true
|
||||
const buffer = []
|
||||
|
||||
// this handler will buffer and replay logs only after `procLog.resume()` is called
|
||||
process.on('log', (level, ...args) => {
|
||||
if (level === 'resume') {
|
||||
buffer.forEach((item) => console.log(...item))
|
||||
paused = false
|
||||
return
|
||||
}
|
||||
|
||||
if (paused) {
|
||||
buffer.push([level, ...args])
|
||||
} else {
|
||||
console.log(level, ...args)
|
||||
}
|
||||
})
|
||||
|
||||
// this handler will write everything to a file
|
||||
process.on('log', (...args) => {
|
||||
fs.appendFileSync('debug.log', args.join(' '))
|
||||
})
|
||||
```
|
||||
|
||||
### input
|
||||
|
||||
### `start` and `end`
|
||||
|
||||
**producer.js**
|
||||
```js
|
||||
const { output, input } = require('proc-log')
|
||||
const { readFromUserInput } = require('./my-read')
|
||||
|
||||
// Using callback passed to `start`
|
||||
try {
|
||||
const res = await input.start(
|
||||
readFromUserInput({ prompt: 'OK?', default: 'y' })
|
||||
)
|
||||
output.standard(`User said ${res}`)
|
||||
} catch (err) {
|
||||
output.error(`User cancelled: ${err}`)
|
||||
}
|
||||
|
||||
// Manually calling `start` and `end`
|
||||
try {
|
||||
input.start()
|
||||
const res = await readFromUserInput({ prompt: 'OK?', default: 'y' })
|
||||
output.standard(`User said ${res}`)
|
||||
} catch (err) {
|
||||
output.error(`User cancelled: ${err}`)
|
||||
} finally {
|
||||
input.end()
|
||||
}
|
||||
```
|
||||
|
||||
**consumer.js**
|
||||
```js
|
||||
const { read } = require('read')
|
||||
|
||||
process.on('input', (level) => {
|
||||
if (level === 'start') {
|
||||
// Hide UI to make room for user input being read
|
||||
} else if (level === 'end') {
|
||||
// Restore UI now that reading is ended
|
||||
}
|
||||
})
|
||||
```
|
||||
|
||||
### Using `read` to call `read()`
|
||||
|
||||
**producer.js**
|
||||
```js
|
||||
const { output, input } = require('proc-log')
|
||||
|
||||
try {
|
||||
const res = await input.read({ prompt: 'OK?', default: 'y' })
|
||||
output.standard(`User said ${res}`)
|
||||
} catch (err) {
|
||||
output.error(`User cancelled: ${err}`)
|
||||
}
|
||||
```
|
||||
|
||||
**consumer.js**
|
||||
```js
|
||||
const { read } = require('read')
|
||||
|
||||
process.on('input', (level, ...args) => {
|
||||
if (level === 'read') {
|
||||
const [res, rej, opts] = args
|
||||
read(opts).then(res).catch(rej)
|
||||
}
|
||||
})
|
||||
```
|
||||
153
node_modules/proc-log/lib/index.js
generated
vendored
Normal file
153
node_modules/proc-log/lib/index.js
generated
vendored
Normal file
|
|
@ -0,0 +1,153 @@
|
|||
const META = Symbol('proc-log.meta')
|
||||
module.exports = {
|
||||
META: META,
|
||||
output: {
|
||||
LEVELS: [
|
||||
'standard',
|
||||
'error',
|
||||
'buffer',
|
||||
'flush',
|
||||
],
|
||||
KEYS: {
|
||||
standard: 'standard',
|
||||
error: 'error',
|
||||
buffer: 'buffer',
|
||||
flush: 'flush',
|
||||
},
|
||||
standard: function (...args) {
|
||||
return process.emit('output', 'standard', ...args)
|
||||
},
|
||||
error: function (...args) {
|
||||
return process.emit('output', 'error', ...args)
|
||||
},
|
||||
buffer: function (...args) {
|
||||
return process.emit('output', 'buffer', ...args)
|
||||
},
|
||||
flush: function (...args) {
|
||||
return process.emit('output', 'flush', ...args)
|
||||
},
|
||||
},
|
||||
log: {
|
||||
LEVELS: [
|
||||
'notice',
|
||||
'error',
|
||||
'warn',
|
||||
'info',
|
||||
'verbose',
|
||||
'http',
|
||||
'silly',
|
||||
'timing',
|
||||
'pause',
|
||||
'resume',
|
||||
],
|
||||
KEYS: {
|
||||
notice: 'notice',
|
||||
error: 'error',
|
||||
warn: 'warn',
|
||||
info: 'info',
|
||||
verbose: 'verbose',
|
||||
http: 'http',
|
||||
silly: 'silly',
|
||||
timing: 'timing',
|
||||
pause: 'pause',
|
||||
resume: 'resume',
|
||||
},
|
||||
error: function (...args) {
|
||||
return process.emit('log', 'error', ...args)
|
||||
},
|
||||
notice: function (...args) {
|
||||
return process.emit('log', 'notice', ...args)
|
||||
},
|
||||
warn: function (...args) {
|
||||
return process.emit('log', 'warn', ...args)
|
||||
},
|
||||
info: function (...args) {
|
||||
return process.emit('log', 'info', ...args)
|
||||
},
|
||||
verbose: function (...args) {
|
||||
return process.emit('log', 'verbose', ...args)
|
||||
},
|
||||
http: function (...args) {
|
||||
return process.emit('log', 'http', ...args)
|
||||
},
|
||||
silly: function (...args) {
|
||||
return process.emit('log', 'silly', ...args)
|
||||
},
|
||||
timing: function (...args) {
|
||||
return process.emit('log', 'timing', ...args)
|
||||
},
|
||||
pause: function () {
|
||||
return process.emit('log', 'pause')
|
||||
},
|
||||
resume: function () {
|
||||
return process.emit('log', 'resume')
|
||||
},
|
||||
},
|
||||
time: {
|
||||
LEVELS: [
|
||||
'start',
|
||||
'end',
|
||||
],
|
||||
KEYS: {
|
||||
start: 'start',
|
||||
end: 'end',
|
||||
},
|
||||
start: function (name, fn) {
|
||||
process.emit('time', 'start', name)
|
||||
function end () {
|
||||
return process.emit('time', 'end', name)
|
||||
}
|
||||
if (typeof fn === 'function') {
|
||||
const res = fn()
|
||||
if (res && res.finally) {
|
||||
return res.finally(end)
|
||||
}
|
||||
end()
|
||||
return res
|
||||
}
|
||||
return end
|
||||
},
|
||||
end: function (name) {
|
||||
return process.emit('time', 'end', name)
|
||||
},
|
||||
},
|
||||
input: {
|
||||
LEVELS: [
|
||||
'start',
|
||||
'end',
|
||||
'read',
|
||||
],
|
||||
KEYS: {
|
||||
start: 'start',
|
||||
end: 'end',
|
||||
read: 'read',
|
||||
},
|
||||
start: function (fn) {
|
||||
process.emit('input', 'start')
|
||||
function end () {
|
||||
return process.emit('input', 'end')
|
||||
}
|
||||
if (typeof fn === 'function') {
|
||||
const res = fn()
|
||||
if (res && res.finally) {
|
||||
return res.finally(end)
|
||||
}
|
||||
end()
|
||||
return res
|
||||
}
|
||||
return end
|
||||
},
|
||||
end: function () {
|
||||
return process.emit('input', 'end')
|
||||
},
|
||||
read: function (...args) {
|
||||
let resolve, reject
|
||||
const promise = new Promise((_resolve, _reject) => {
|
||||
resolve = _resolve
|
||||
reject = _reject
|
||||
})
|
||||
process.emit('input', 'read', resolve, reject, ...args)
|
||||
return promise
|
||||
},
|
||||
},
|
||||
}
|
||||
45
node_modules/proc-log/package.json
generated
vendored
Normal file
45
node_modules/proc-log/package.json
generated
vendored
Normal file
|
|
@ -0,0 +1,45 @@
|
|||
{
|
||||
"name": "proc-log",
|
||||
"version": "4.2.0",
|
||||
"files": [
|
||||
"bin/",
|
||||
"lib/"
|
||||
],
|
||||
"main": "lib/index.js",
|
||||
"description": "just emit 'log' events on the process object",
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "https://github.com/npm/proc-log.git"
|
||||
},
|
||||
"author": "GitHub Inc.",
|
||||
"license": "ISC",
|
||||
"scripts": {
|
||||
"test": "tap",
|
||||
"snap": "tap",
|
||||
"posttest": "npm run lint",
|
||||
"postsnap": "eslint index.js test/*.js --fix",
|
||||
"lint": "eslint \"**/*.{js,cjs,ts,mjs,jsx,tsx}\"",
|
||||
"postlint": "template-oss-check",
|
||||
"lintfix": "npm run lint -- --fix",
|
||||
"template-oss-apply": "template-oss-apply --force"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@npmcli/eslint-config": "^4.0.0",
|
||||
"@npmcli/template-oss": "4.21.3",
|
||||
"tap": "^16.0.1"
|
||||
},
|
||||
"engines": {
|
||||
"node": "^14.17.0 || ^16.13.0 || >=18.0.0"
|
||||
},
|
||||
"templateOSS": {
|
||||
"//@npmcli/template-oss": "This file is partially managed by @npmcli/template-oss. Edits may be overwritten.",
|
||||
"version": "4.21.3",
|
||||
"publish": true
|
||||
},
|
||||
"tap": {
|
||||
"nyc-arg": [
|
||||
"--exclude",
|
||||
"tap-snapshots/**"
|
||||
]
|
||||
}
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue