This commit is contained in:
2024-08-18 23:38:55 +08:00
parent e8dbb9bab3
commit 8f57f57c1d
1004 changed files with 234067 additions and 16087 deletions

View File

@@ -0,0 +1,13 @@
Copyright (C) 2015-present SheetJS
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.

View File

@@ -0,0 +1,104 @@
# exit-on-epipe
Cleanly exit on pipe errors in NodeJS scripts.
NOTE: The underlying problem was addressed in 8.x NodeJS versions but the fix
was not backported to 6.x and other versions of NodeJS.
These errors are common in pipelines that involve NodeJS scripts. For example,
take a simple script that prints out 10 lines:
```js
for(var i = 0; i < 10; ++i) console.log(i)
```
NodeJS will print an error message if the output is truncated:
```bash
$ cat t.js
for(var i = 0; i < 10; ++i) console.log(i)
$ node --version
v6.11.1
$ node t.js | head -n 1
0
events.js:160
throw er; // Unhandled 'error' event
^
Error: write EPIPE
at exports._errnoException (util.js:1018:11)
at WriteWrap.afterWrite (net.js:800:14)
```
The process will cleanly exit if you require the module:
```bash
$ cat t.js
require("exit-on-epipe");
for(var i = 0; i < 10; ++i) console.log(i)
$ node t.js | head -n 1
0
```
## Installation
With [npm](https://www.npmjs.org/package/exit-on-epipe):
```bash
$ npm install exit-on-epipe
```
## Usage
For basic scripts, requiring at the top of the source file suffices:
```js
require('exit-on-epipe');
// ... rest of source
```
For more advanced situations (e.g. handing other streams), call the module:
```js
var eoepipe = require('exit-on-epipe');
eoepipe(stream); // will exit process on an EPIPE error on stream
eoepipe(stream, handler); // will call handler() instead of process.exit
```
## Interface
The module exports a single function (exposed as the variable `eoepipe`).
`eoepipe(stream, bail)` will attach an error handler to `stream` which will:
- call the `bail` function if the error `.code` is `"EPIPE"` or `.errno` is `32`
- defer to the default behavior if there are no other error handlers
- noop if the error is not `EPIPE` and if there are other error handlers
If the `bail` function is not specified, `process.exit` is used.
If the `stream` parameter is not specified, no action will be taken
## Notes
The script will not perform any action if `process` or `process.stdout` are not
available. It is safe to use in a web page.
## License
Please consult the attached LICENSE file for details. All rights not explicitly
granted by the Apache 2.0 license are reserved by the Original Author.
## Badges
[![Build Status](https://travis-ci.org/SheetJS/node-exit-on-epipe.svg?branch=master)](https://travis-ci.org/SheetJS/node-exit-on-epipe)
[![npm license](https://img.shields.io/npm/l/exit-on-epipe.svg)](https://npmjs.org/package/exit-on-epipe)
[![NPM Downloads](https://img.shields.io/npm/dt/exit-on-epipe.svg)](https://npmjs.org/package/exit-on-epipe)
[![Dependencies Status](https://david-dm.org/sheetjs/node-exit-on-epipe/status.svg)](https://david-dm.org/sheetjs/node-exit-on-epipe)
[![ghit.me](https://ghit.me/badge.svg?repo=sheetjs/node-exit-on-epipe)](https://ghit.me/repo/sheetjs/node-exit-on-epipe)
[![Analytics](https://ga-beacon.appspot.com/UA-36810333-1/SheetJS/node-exit-on-epipe?pixel)](https://github.com/SheetJS/node-exit-on-epipe)

View File

@@ -0,0 +1,20 @@
/* exit-on-epipe.js (C) 2015-present SheetJS -- http://sheetjs.com */
/* vim: set ts=2: */
/*jshint eqnull:true, node:true */
var eoepipe = function eoepipeit(S/*:events$EventEmitter*/, bail/*:?()=>any*/) {
if(!S || !S.on) return;
if(!bail && typeof process !== 'undefined') bail = process.exit;
var eoe = function eoeit(err/*:ErrnoError*/) {
if(err.code === 'EPIPE' || err.errno === /*EPIPE*/32) { if(bail) bail(); else return; }
var cnt = S.listenerCount ? S.listenerCount('error') : S.listeners('error').length;
if(cnt == 1) {
S.removeListener('error', eoe);
S.emit('error', err);
S.on('error', eoe);
}
};
S.on('error', eoe);
};
if(typeof module !== 'undefined') module.exports = eoepipe;
if(typeof process !== 'undefined') eoepipe(process.stdout);

View File

@@ -0,0 +1,71 @@
{
"_args": [
[
"exit-on-epipe@1.0.1",
"/Users/wuyu/Desktop/61/Git/h5game_ailesson_v2.4/packages/excel_to_json"
]
],
"_from": "exit-on-epipe@1.0.1",
"_id": "exit-on-epipe@1.0.1",
"_inBundle": false,
"_integrity": "sha1-C92S6H1ShdJn2qgXHQ6wYVlolpI=",
"_location": "/exit-on-epipe",
"_phantomChildren": {},
"_requested": {
"type": "version",
"registry": true,
"raw": "exit-on-epipe@1.0.1",
"name": "exit-on-epipe",
"escapedName": "exit-on-epipe",
"rawSpec": "1.0.1",
"saveSpec": null,
"fetchSpec": "1.0.1"
},
"_requiredBy": [
"/cfb/adler-32",
"/cfb/crc-32",
"/node-xlsx/adler-32",
"/node-xlsx/crc-32",
"/node-xlsx/xlsx"
],
"_resolved": "https://registry.nlark.com/exit-on-epipe/download/exit-on-epipe-1.0.1.tgz",
"_spec": "1.0.1",
"_where": "/Users/wuyu/Desktop/61/Git/h5game_ailesson_v2.4/packages/excel_to_json",
"author": {
"name": "sheetjs"
},
"bugs": {
"url": "https://github.com/SheetJS/node-exit-on-epipe/issues"
},
"dependencies": {},
"description": "Cleanly exit process on EPIPE",
"devDependencies": {
"mocha": "~2.5.3"
},
"engines": {
"node": ">=0.8"
},
"files": [
"exit-on-epipe.js",
"LICENSE",
"README.md"
],
"homepage": "https://github.com/SheetJS/node-exit-on-epipe#readme",
"keywords": [
"epipe",
"pipe",
"error",
"exit"
],
"license": "Apache-2.0",
"main": "./exit-on-epipe",
"name": "exit-on-epipe",
"repository": {
"type": "git",
"url": "git://github.com/SheetJS/node-exit-on-epipe.git"
},
"scripts": {
"test": "make test"
},
"version": "1.0.1"
}