@ezs/basics 1.19.0 → 1.22.0

package/CHANGELOG.md

@@ -3,6 +3,44 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.22.0](https://github.com/Inist-CNRS/ezs/compare/@ezs/basics@1.21.0...@ezs/basics@1.22.0) (2022-09-05)
+
+
+### Bug Fixes
+
+* use location to check filename ([cb9c6e2](https://github.com/Inist-CNRS/ezs/commit/cb9c6e2f42d12c287d806b4ccebf8a4f8607e755))
+
+
+### Features
+
+* 🎸 add file load ([a06c221](https://github.com/Inist-CNRS/ezs/commit/a06c221c3463b4299383db5c613f5cabc687961c))
+
+
+
+
+
+# [1.21.0](https://github.com/Inist-CNRS/ezs/compare/@ezs/basics@1.20.0...@ezs/basics@1.21.0) (2022-07-11)
+
+
+### Features
+
+* 🎸 add target option to URLRequest ([3861c5e](https://github.com/Inist-CNRS/ezs/commit/3861c5e10b4dcfd060b49fa9b23f2bcf98d8c942))
+
+
+
+
+
+# [1.20.0](https://github.com/Inist-CNRS/ezs/compare/@ezs/basics@1.19.0...@ezs/basics@1.20.0) (2022-06-24)
+
+
+### Features
+
+* 🎸 add [URLPager] ([59dcbdc](https://github.com/Inist-CNRS/ezs/commit/59dcbdca0c33eaf2ebf5a195de153cec802d1bc1))
+
+
+
+
+
 # [1.19.0](https://github.com/Inist-CNRS/ezs/compare/@ezs/basics@1.18.0...@ezs/basics@1.19.0) (2022-06-22)
 
 

package/README.md

@@ -18,6 +18,7 @@ npm install @ezs/basics
 -   [CSVObject](#csvobject)
 -   [CSVParse](#csvparse)
 -   [CSVString](#csvstring)
+-   [FILELoad](#fileload)
 -   [FILESave](#filesave)
 -   [INIString](#inistring)
 -   [JSONParse](#jsonparse)
@@ -32,7 +33,9 @@ npm install @ezs/basics
 -   [TXTZip](#txtzip)
 -   [URLConnect](#urlconnect)
 -   [URLFetch](#urlfetch)
+-   [URLPagination](#urlpagination)
 -   [URLParse](#urlparse)
+-   [URLRequest](#urlrequest)
 -   [URLStream](#urlstream)
 -   [URLString](#urlstring)
 -   [XMLConvert](#xmlconvert)
@@ -190,6 +193,41 @@ a;b;c
 
 Returns **[String](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** 
 
+### FILELoad
+
+Take `Object` containing filename et throw content by chunk
+
+```json
+[ fi1e1.csv, file2.csv ]
+```
+
+Script:
+
+```ini
+[use]
+plugin = analytics
+plugin = basics
+
+[FILELoad]
+location = /tmp
+[CSVParse]
+```
+
+Output:
+
+```json
+[
+(...)
+]
+```
+
+#### Parameters
+
+-   `location` **[String](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** Directory location (optional, default `TMPDIR`)
+-   `compress` **[Boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** Enable gzip compression (optional, default `false`)
+
+Returns **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
+
 ### FILESave
 
 Take data, convert it to buffer and append it to file
@@ -610,6 +648,68 @@ Or if no target is specified, the output will be the returned content of URL.
 
 Returns **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
 
+### URLPagination
+
+Take `Object` and multiple it to make it one object per page
+
+Input:
+
+```json
+[{"q": "a"}]
+```
+
+Script:
+
+```ini
+[URLRequest]
+url = https://api.search.net
+
+[URLPagination]
+total = get('total')
+```
+
+Output:
+
+```json
+[
+     {
+         "q": "a",
+         "total": 22
+         "offset": 0,
+         "pageNumber": 1,
+         "totalPages", 3,
+         "maxPages": 1000,
+         "limit": 10
+     },
+     {
+         "q": "a",
+         "total": 22
+         "offset": 10,
+         "pageNumber": 2,
+         "totalPages", 3,
+         "maxPages": 1000,
+         "limit": 10
+     },
+     {
+         "q": "a",
+         "total": 22
+         "offset": 20,
+         "pageNumber": 3,
+         "totalPages", 3,
+         "maxPages": 1000,
+         "limit": 10
+     }
+ ]
+```
+
+#### Parameters
+
+-   `total` **[Number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** total to use for the pagination (optional, default `0`)
+-   `limit` **[Number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** limit to use to pagination (optional, default `10`)
+-   `maxPages` **[Number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** maxPages to use to pagination (optional, default `1000`)
+
+Returns **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
+
 ### URLParse
 
 Take an URL `String`, parse it and return `Object`.
@@ -637,6 +737,45 @@ See:
 
 Returns **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
 
+### URLRequest
+
+Take `Object` as parameters of URL, throw each chunk from the result
+
+Input:
+
+```json
+[{"q": "a"}]
+```
+
+Script:
+
+```ini
+[URLRequest]
+url = https://api.search.net
+```
+
+Output:
+
+```json
+[
+     {
+         "result": "a"
+     }
+ ]
+```
+
+#### Parameters
+
+-   `url` **[String](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?** URL to fetch
+-   `json` **[Boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** parse result as json (optional, default `true`)
+-   `target` **[String](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?** choose the key to set
+-   `timeout` **[Number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** Timeout in milliseconds (optional, default `1000`)
+-   `noerror` **[Boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** Ignore all errors, the target field will remain undefined (optional, default `false`)
+-   `retries` **[Number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** The maximum amount of times to retry the connection (optional, default `5`)
+-   `insert` **[String](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?** a header response value in the result
+
+Returns **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
+
 ### URLStream
 
 Take `String` as URL, throw each chunk from the result or

package/lib/file-load.js

@@ -0,0 +1,73 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = FILELoad;
+
+var _zlib = require("zlib");
+
+var _fs = require("fs");
+
+var _path = require("path");
+
+var _os = require("os");
+
+/**
+ * Take `Object` containing filename et throw content by chunk
+ *
+ * ```json
+ * [ fi1e1.csv, file2.csv ]
+ * ```
+ *
+ * Script:
+ *
+ * ```ini
+ * [use]
+ * plugin = analytics
+ * plugin = basics
+ *
+ * [FILELoad]
+ * location = /tmp
+ * [CSVParse]
+ *
+ * ```
+ *
+ * Output:
+ *
+ * ```json
+ * [
+ * (...)
+ * ]
+ * ```
+ *
+ * @name FILELoad
+ * @param {String} [location=TMPDIR] Directory location
+ * @param {Boolean} [compress=false] Enable gzip compression
+ * @returns {Object}
+ */
+function FILELoad(data, feed) {
+  if (this.isLast()) {
+    feed.close();
+    return;
+  }
+
+  const cwd = process.cwd();
+  const tpd = (0, _os.tmpdir)();
+  const location = this.getParam('location', tpd);
+  const compress = this.getParam('compress', false);
+  const locations = [cwd, tpd, location];
+  const file = locations.filter(Boolean).map(dir => (0, _path.resolve)(dir, String(data).trim())).filter(fil => (0, _fs.existsSync)(fil)).shift();
+
+  if (!file) {
+    feed.end();
+    return;
+  }
+
+  if (compress) {
+    feed.flow((0, _fs.createReadStream)(file).pipe((0, _zlib.createGunzip)()));
+    return;
+  }
+
+  feed.flow((0, _fs.createReadStream)(file));
+}

package/lib/index.js

@@ -41,6 +41,10 @@ var _urlFetch = _interopRequireDefault(require("./url-fetch"));
 
 var _urlParse = _interopRequireDefault(require("./url-parse"));
 
+var _urlRequest = _interopRequireDefault(require("./url-request"));
+
+var _urlPagination = _interopRequireDefault(require("./url-pagination"));
+
 var _urlString = _interopRequireDefault(require("./url-string"));
 
 var _urlStream = _interopRequireDefault(require("./url-stream"));
@@ -55,6 +59,8 @@ var _iniString = _interopRequireDefault(require("./ini-string"));
 
 var _fileSave = _interopRequireDefault(require("./file-save"));
 
+var _fileLoad = _interopRequireDefault(require("./file-load"));
+
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 const funcs = {
@@ -75,6 +81,8 @@ const funcs = {
   JSONParse: _jsonParse.default,
   JSONString: _jsonString.default,
   URLFetch: _urlFetch.default,
+  URLPagination: _urlPagination.default,
+  URLRequest: _urlRequest.default,
   URLParse: _urlParse.default,
   URLString: _urlString.default,
   URLStream: _urlStream.default,
@@ -83,6 +91,7 @@ const funcs = {
   ZIPExtract: _zipExtract.default,
   INIString: _iniString.default,
   FILESave: _fileSave.default,
+  FILELoad: _fileLoad.default,
   // aliases
   bufferify: _bufObject.default.BUFObject,
   concat: _txtConcat.default.TXTConcat,

package/lib/request.js

@@ -13,7 +13,10 @@ const request = (url, parameters) => async () => {
   const response = await (0, _fetchWithProxy.default)(url, parameters);
 
   if (!response.ok) {
-    throw new Error(response.statusText);
+    const err = new Error(response.statusText);
+    const text = await response.text();
+    err.responseText = text;
+    throw err;
   }
 
   return response;

package/lib/url-fetch.js

@@ -44,7 +44,7 @@ async function URLFetch(data, feed) {
 
   const url = this.getParam('url');
   const path = this.getParam('path');
-  const target = this.getParam('target');
+  const target = [].concat(this.getParam('target')).filter(Boolean).shift();
   const json = Boolean(this.getParam('json', false));
   const retries = Number(this.getParam('retries', 5));
   const noerror = Boolean(this.getParam('noerror', false));
@@ -74,8 +74,10 @@ async function URLFetch(data, feed) {
     const func = json ? 'json' : 'text';
     const value = await response[func]();
 
-    if (target && typeof target === 'string' && typeof data === 'object') {
-      const result = { ...data
+    if (target) {
+      const result = typeof data === 'object' ? { ...data
+      } : {
+        input: data
       };
       (0, _lodash2.default)(result, target, value);
       return feed.send(result);

package/lib/url-pager.js

@@ -0,0 +1,179 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = URLPager;
+
+var _debug = _interopRequireDefault(require("debug"));
+
+var _url = require("url");
+
+var _nodeAbortController = _interopRequireDefault(require("node-abort-controller"));
+
+var _lodash = _interopRequireDefault(require("lodash.get"));
+
+var _parseHeaders = _interopRequireDefault(require("parse-headers"));
+
+var _asyncRetry = _interopRequireDefault(require("async-retry"));
+
+var _request = _interopRequireDefault(require("./request"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * Take `Object` as parameters of URL, throw each chunk from the result
+ *
+ *
+ * Input:
+ *
+ * ```json
+ * [{"q": "a"}]
+ * ```
+ *
+ * Script:
+ *
+ * ```ini
+ * [URLPager]
+ * url = https://api.search.net
+ * path = total
+ * ```
+ *
+ * Output:
+ *
+ * ```json
+ * [
+ *      {
+ *          "q": "a",
+ *          "total": 22
+ *          "offset": 0,
+ *          "pageNumber": 1,
+ *          "totalPages", 3,
+ *          "maxPages": 1000,
+ *          "limit": 10
+ *      },
+ *      {
+ *          "q": "a",
+ *          "total": 22
+ *          "offset": 10,
+ *          "pageNumber": 2,
+ *          "totalPages", 3,
+ *          "maxPages": 1000,
+ *          "limit": 10
+ *      },
+ *      {
+ *          "q": "a",
+ *          "total": 22
+ *          "offset": 20,
+ *          "pageNumber": 3,
+ *          "totalPages", 3,
+ *          "maxPages": 1000,
+ *          "limit": 10
+ *      }
+ *  ]
+ * ```
+ *
+ * #### Example with URLs
+ *
+ * Input:
+ *
+ * ```json
+ * [
+ *   "https://httpbin.org/get?a=a",
+ *   "https://httpbin.org/get?a=b",
+ *   "https://httpbin.org/get?a=c"
+ * ]
+ * ```
+ *
+ * Script:
+ *
+ * ```ini
+ * [URLPager]
+ * path = .args
+ * ```
+ *
+ * Output:
+ *
+ * ```json
+ * [{"a": "a"}, {"a": "b"}, {"a": "c" }]
+ * ```
+ *
+ * @name URLPager
+ * @param {String} [url] URL to fetch (by default input string is taken)
+ * @param {String} [path=total] choose the path to find the number of result
+ * @param {Number} [timeout=1000] Timeout in milliseconds
+ * @param {Boolean} [noerror=false] Ignore all errors, the target field will remain undefined
+ * @param {Number} [retries=5] The maximum amount of times to retry the connection
+ * @returns {Object}
+ */
+async function URLPager(data, feed) {
+  if (this.isLast()) {
+    return feed.close();
+  }
+
+  const url = this.getParam('url');
+  const path = this.getParam('path', 'total');
+  const limit = Number(this.getParam('limit', 10));
+  const maxPages = Number(this.getParam('maxPages', 1000));
+  const retries = Number(this.getParam('retries', 5));
+  const noerror = Boolean(this.getParam('noerror', false));
+  const timeout = Number(this.getParam('timeout')) || 1000;
+  const headers = (0, _parseHeaders.default)([].concat(this.getParam('header')).filter(Boolean).join('\n'));
+  const cURL = new _url.URL(url || data);
+  const controller = new _nodeAbortController.default();
+  const parameters = {
+    timeout,
+    headers,
+    signal: controller.signal
+  };
+  const options = {
+    retries
+  };
+  cURL.search = new _url.URLSearchParams(data);
+
+  const onError = e => {
+    controller.abort();
+
+    if (noerror) {
+      (0, _debug.default)('ezs')(`Ignore item #${this.getIndex()} [URLPager] <${e}>`);
+      return feed.send(data);
+    }
+
+    (0, _debug.default)('ezs')(`Break item #${this.getIndex()} [URLPager] <${e}>`);
+    return feed.send(e);
+  };
+
+  try {
+    const response = await (0, _asyncRetry.default)((0, _request.default)(cURL.href, parameters), options);
+    const json = await response.json();
+    const total = (0, _lodash.default)(json, path);
+
+    if (total === 0) {
+      return onError(new Error('No result.'));
+    }
+
+    if (total === undefined) {
+      return onError(new Error('Unexpected response.'));
+    }
+
+    let totalPages = Math.ceil(json.total / limit);
+
+    if (totalPages > maxPages) {
+      totalPages = maxPages;
+    }
+
+    for (let pageNumber = 1; pageNumber <= totalPages; pageNumber += 1) {
+      feed.write({ ...data,
+        offset: (pageNumber - 1) * limit,
+        pageNumber,
+        totalPages,
+        maxPages,
+        limit
+      });
+    }
+
+    feed.end();
+  } catch (e) {
+    onError(e);
+  }
+}

package/lib/url-pagination.js

@@ -0,0 +1,103 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = URLPagination;
+
+/**
+ * Take `Object` and multiple it to make it one object per page
+ *
+ *
+ * Input:
+ *
+ * ```json
+ * [{"q": "a"}]
+ * ```
+ *
+ * Script:
+ *
+ * ```ini
+ * [URLRequest]
+ * url = https://api.search.net
+ *
+ * [URLPagination]
+ * total = get('total')
+ * ```
+ *
+ * Output:
+ *
+ * ```json
+ * [
+ *      {
+ *          "q": "a",
+ *          "total": 22
+ *          "offset": 0,
+ *          "pageNumber": 1,
+ *          "totalPages", 3,
+ *          "maxPages": 1000,
+ *          "limit": 10
+ *      },
+ *      {
+ *          "q": "a",
+ *          "total": 22
+ *          "offset": 10,
+ *          "pageNumber": 2,
+ *          "totalPages", 3,
+ *          "maxPages": 1000,
+ *          "limit": 10
+ *      },
+ *      {
+ *          "q": "a",
+ *          "total": 22
+ *          "offset": 20,
+ *          "pageNumber": 3,
+ *          "totalPages", 3,
+ *          "maxPages": 1000,
+ *          "limit": 10
+ *      }
+ *  ]
+ * ```
+ *
+ *
+ * @name URLPagination
+ * @param {Number} [total=0] total to use for the pagination
+ * @param {Number} [limit=10] limit to use to pagination
+ * @param {Number} [maxPages=1000] maxPages to use to pagination
+ * @returns {Object}
+ */
+function URLPagination(data, feed) {
+  if (this.isLast()) {
+    return feed.close();
+  }
+
+  const total = Number(this.getParam('total', 0));
+  const limit = Number(this.getParam('limit', 10));
+  const maxPages = Number(this.getParam('maxPages', 1000));
+
+  if (total === 0) {
+    return feed.send(new Error('No result.'));
+  }
+
+  if (Number.isNaN(total)) {
+    return feed.send(new Error('Unexpected response.'));
+  }
+
+  let totalPages = Math.ceil(total / limit);
+
+  if (totalPages > maxPages) {
+    totalPages = maxPages;
+  }
+
+  for (let pageNumber = 1; pageNumber <= totalPages; pageNumber += 1) {
+    feed.write({ ...data,
+      offset: (pageNumber - 1) * limit,
+      pageNumber,
+      totalPages,
+      maxPages,
+      limit
+    });
+  }
+
+  feed.end();
+}

package/lib/url-request.js

@@ -0,0 +1,121 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = URLRequest;
+
+var _lodash = _interopRequireDefault(require("lodash.set"));
+
+var _debug = _interopRequireDefault(require("debug"));
+
+var _url = require("url");
+
+var _nodeAbortController = _interopRequireDefault(require("node-abort-controller"));
+
+var _parseHeaders = _interopRequireDefault(require("parse-headers"));
+
+var _asyncRetry = _interopRequireDefault(require("async-retry"));
+
+var _request = _interopRequireDefault(require("./request"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * Take `Object` as parameters of URL, throw each chunk from the result
+ *
+ *
+ * Input:
+ *
+ * ```json
+ * [{"q": "a"}]
+ * ```
+ *
+ * Script:
+ *
+ * ```ini
+ * [URLRequest]
+ * url = https://api.search.net
+ * ```
+ *
+ * Output:
+ *
+ * ```json
+ * [
+ *      {
+ *          "result": "a"
+ *      }
+ *  ]
+ * ```
+ *
+ * @name URLRequest
+ * @param {String} [url] URL to fetch
+ * @param {Boolean} [json=true] parse result as json
+ * @param {String} [target] choose the key to set
+ * @param {Number} [timeout=1000] Timeout in milliseconds
+ * @param {Boolean} [noerror=false] Ignore all errors, the target field will remain undefined
+ * @param {Number} [retries=5] The maximum amount of times to retry the connection
+ * @param {String} [insert] a header response value in the result
+ * @returns {Object}
+ */
+async function URLRequest(data, feed) {
+  if (this.isLast()) {
+    return feed.close();
+  }
+
+  const url = this.getParam('url');
+  const json = Boolean(this.getParam('json', true));
+  const target = [].concat(this.getParam('target')).filter(Boolean).shift();
+  const retries = Number(this.getParam('retries', 5));
+  const noerror = Boolean(this.getParam('noerror', false));
+  const timeout = Number(this.getParam('timeout')) || 1000;
+  const headers = (0, _parseHeaders.default)([].concat(this.getParam('header')).filter(Boolean).join('\n'));
+  const inserts = [].concat(this.getParam('insert')).filter(Boolean);
+  const cURL = new _url.URL(url || data);
+  const controller = new _nodeAbortController.default();
+  const parameters = {
+    timeout,
+    headers,
+    signal: controller.signal
+  };
+  const options = {
+    retries
+  };
+
+  if (url) {
+    cURL.search = new _url.URLSearchParams(data);
+  }
+
+  const onError = e => {
+    controller.abort();
+
+    if (noerror) {
+      (0, _debug.default)('ezs')(`Ignore item #${this.getIndex()} [URLRequest] <${e}>`);
+      return feed.send(data);
+    }
+
+    (0, _debug.default)('ezs')(`Break item #${this.getIndex()} [URLRequest] <${e}>`);
+    return feed.send(e);
+  };
+
+  try {
+    const response = await (0, _asyncRetry.default)((0, _request.default)(cURL.href, parameters), options);
+    const func = json ? 'json' : 'text';
+    const value = await response[func]();
+
+    if (target) {
+      const result = typeof data === 'object' ? { ...data
+      } : {
+        url: data
+      };
+      (0, _lodash.default)(result, target, value);
+      inserts.forEach(i => (0, _lodash.default)(result, i, response.headers.get(i)));
+      return feed.send(result);
+    }
+
+    inserts.forEach(i => (0, _lodash.default)(value, i, response.headers.get(i)));
+    return feed.send(value);
+  } catch (e) {
+    onError(e);
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ezs/basics",
   "description": "Basics statements for EZS",
-  "version": "1.19.0",
+  "version": "1.22.0",
   "author": "Nicolas Thouvenin <nthouvenin@gmail.com>",
   "bugs": "https://github.com/Inist-CNRS/ezs/issues",
   "dependencies": {
@@ -36,7 +36,7 @@
   "directories": {
     "test": "test"
   },
-  "gitHead": "2003a35bd4f57965f324309db6cb0cb2afbeefbc",
+  "gitHead": "ae3bd633484915926ad8dac4040e191635939a7d",
   "homepage": "https://github.com/Inist-CNRS/ezs/tree/master/packages/basics#readme",
   "keywords": [
     "ezs"