qsu 1.0.5 → 1.0.8

package/.eslintrc.cjs

@@ -16,7 +16,7 @@ module.exports = {
     'plugin:@typescript-eslint/recommended',
   ],
   rules: {
-    'linebreak-style': ['error', 'windows'],
+    'linebreak-style': 0,
     'arrow-parens': 0,
     'max-len': 0,
     '@typescript-eslint/no-explicit-any': 0

package/README.md

@@ -1,6 +1,7 @@
 <div align="center">
 
 ![logo](qsu-logo.png)
+
 ### Node.js Quick & Simple Utility for JavaScript
 
 [![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/jooy2/qsu/blob/master/LICENSE)
@@ -10,19 +11,22 @@
 ![github repo size](https://img.shields.io/github/repo-size/jooy2/qsu)
 [![npm downloads](https://img.shields.io/npm/dm/qsu.svg)](https://www.npmjs.com/package/qsu)
 [![Followers](https://img.shields.io/github/followers/jooy2?style=social)](https://github.com/jooy2)
+![Stars](https://img.shields.io/github/stars/jooy2/qsu?style=social)
+![Commit Count](https://img.shields.io/github/commit-activity/y/jooy2/qsu)
+![Line Count](https://img.shields.io/tokei/lines/github/jooy2/qsu)
 </div>
 
-A collection of complex or useful features that are often used in JavaScript. It is implemented to be used in both a client or server environment.
+A collection of complex or useful features that are often used in **JavaScript**. It is implemented to be used in both a client or server environment.
 
-qsu is optimized for modern development environments, so older browsers such as Internet Explorer 11 and Legacy Edge (Not Chromium) may not support it unless you use a transcompiler. Some functions use ES6 or higher JS standard syntax.
+**qsu** is optimized for modern development environments, so older browsers such as Internet Explorer 11 and Legacy Edge (Not Chromium) may not support it unless you use a transcompiler. Some functions use ES6 or higher JS standard syntax.
 
 Some solutions partially referenced external documentation (e.g. [Stack Overflow](https://stackoverflow.com)).
 
 # Installation
-Qsu requires Node.js 14.x or higher, and the repository is serviced through NPM.
+Qsu requires **Node.js 14.x** or higher, and the repository is serviced through **[NPM](https://npmjs.com)**.
 After configuring the node environment, you can simply run the following command.
 ```bash
-$ npm i --save qsu
+$ npm i qsu
 ```
 
 # Usage
@@ -264,7 +268,7 @@ _.truncate('hello', 3); // Returns 'hel'
 _.truncate('hello', 2, '...'); // Returns 'he...'
 ```
 
-### `_.split (string)`
+### `_.split (string[])`
 
 Splits a string based on the specified character and returns it as an Array. Unlike the existing split, it splits the values provided as multiple parameters (array or multiple arguments) at once.
 - `str::string`
@@ -354,6 +358,41 @@ Remove duplicate characters from a given string and output only one.
 _.strUnique('aaabbbcc'); // Returns 'abc'
 ```
 
+### `_.isEqual (boolean)`
+
+It compares the first argument value as the left operand and the argument values given thereafter as the right operand, and returns `true` if the values are all the same.
+
+`isEqual` returns `true` even if the data types do not match, but `isEqualStrict` returns `true` only when the data types of all argument values match.
+- `leftOperand::any`
+- `rightOperand::any||any[]||...any`
+
+```javascript
+const val1 = 'Left';
+const val2 = 1;
+
+_.isEqual('Left', 'Left', val1); // Returns true
+_.isEqual(1, [1, '1', 1, val2]); // Returns true
+_.isEqual(val1, ['Right', 'Left', 1]); // Returns false
+_.isEqual(1, 1, 1, 1); // Returns true
+```
+
+### `_.isEqualStrict (boolean)`
+
+It compares the first argument value as the left operand and the argument values given thereafter as the right operand, and returns `true` if the values are all the same.
+
+`isEqual` returns `true` even if the data types do not match, but `isEqualStrict` returns `true` only when the data types of all argument values match.
+- `leftOperand::any`
+- `rightOperand::any||any[]||...any`
+
+```javascript
+const val1 = 'Left';
+const val2 = 1;
+
+_.isEqualStrict('Left', 'Left', val1); // Returns true
+_.isEqualStrict(1, [1, '1', 1, val2]); // Returns false
+_.isEqualStrict(1, 1, '1', 1); // Returns false
+```
+
 ### `_.isEmpty (boolean)`
 
 Returns true if the passed data is empty or has a length of 0.
@@ -520,7 +559,7 @@ _.license({
 ```
 
 # Contribute
-You can report issues on GitHub Issue. You can also request a pull to fix bugs and add frequently used features.
+You can report issues on [GitHub Issue Tracker](https://github.com/jooy2/qsu/issues). You can also request a pull to fix bugs and add frequently used features.
 
 # License
-Copyright © 2021 Jooy2 Released under the MIT license.
+Copyright © 2021-2022 Jooy2 Released under the MIT license.

package/dist/index.d.ts

@@ -30,7 +30,7 @@ export default class Qsu {
     static strRandom<N extends number>(length: PositiveNumber<N>, additionalCharacters?: string): string;
     static strBlindRandom<N extends number>(str: string, blindLength: PositiveNumber<N>, blindStr?: string): string;
     static truncate<N extends number>(str: string, length: PositiveNumber<N>, ellipsis?: string): string;
-    static split(str: string, ...splitter: Array<string>): string | string[];
+    static split(str: string, ...splitter: Array<string>): string[];
     static encrypt(str: string, secret: string, algorithm?: string, ivSize?: number): string;
     static decrypt(str: string, secret: string, algorithm?: string): string;
     static md5(str: string): string;
@@ -39,6 +39,8 @@ export default class Qsu {
     static encodeBase64(str: string): string;
     static decodeBase64(encodedStr: string): string;
     static strUnique(str: string): string;
+    static isEqual(leftOperand: any, ...rightOperand: Array<any>): boolean;
+    static isEqualStrict(leftOperand: any, ...rightOperand: Array<any>): boolean;
     static isEmpty(data?: any): boolean;
     static isUrl(url: string, withProtocol?: boolean, strict?: boolean): boolean;
     static contains(str: any[] | string, search: any[] | string, exact?: boolean): boolean;

package/dist/index.js

@@ -1,5 +1,5 @@
-import path from 'path';
-import crypto from 'crypto';
+import { basename, extname, win32 } from 'path';
+import { randomBytes, createCipheriv, createDecipheriv, createHash, } from 'crypto';
 export default class Qsu {
     /*
     * Misc
@@ -177,6 +177,9 @@ export default class Qsu {
     }
     static truncate(str, length, ellipsis = '') {
         let convStr = str;
+        if (!str) {
+            return '';
+        }
         if (str.length > length) {
             convStr = str.substring(0, length) + ellipsis;
         }
@@ -208,7 +211,7 @@ export default class Qsu {
             }
         }
         if (charPattern.length < 1 && strPattern.length < 1) {
-            return str;
+            return [str];
         }
         if (charPattern.length > 0) {
             charPattern = `[${charPattern}]`;
@@ -222,8 +225,8 @@ export default class Qsu {
         if (!str || str.length < 1) {
             return '';
         }
-        const iv = crypto.randomBytes(ivSize);
-        const cipher = crypto.createCipheriv(algorithm, secret, iv);
+        const iv = randomBytes(ivSize);
+        const cipher = createCipheriv(algorithm, secret, iv);
         let enc = cipher.update(str);
         enc = Buffer.concat([enc, cipher.final()]);
         return `${iv.toString('hex')}:${enc.toString('hex')}`;
@@ -233,19 +236,19 @@ export default class Qsu {
             return '';
         }
         const arrStr = str.split(':');
-        const decipher = crypto.createDecipheriv(algorithm, secret, Buffer.from(arrStr.shift(), 'hex'));
+        const decipher = createDecipheriv(algorithm, secret, Buffer.from(arrStr.shift(), 'hex'));
         let decrypted = decipher.update(Buffer.from(arrStr.join(':'), 'hex'));
         decrypted = Buffer.concat([decrypted, decipher.final()]);
         return decrypted.toString();
     }
     static md5(str) {
-        return crypto.createHash('md5').update(str).digest('hex');
+        return createHash('md5').update(str).digest('hex');
     }
     static sha1(str) {
-        return crypto.createHash('sha1').update(str).digest('hex');
+        return createHash('sha1').update(str).digest('hex');
     }
     static sha256(str) {
-        return crypto.createHash('sha256').update(str).digest('hex');
+        return createHash('sha256').update(str).digest('hex');
     }
     static encodeBase64(str) {
         return Buffer.from(str, 'utf8').toString('base64');
@@ -259,6 +262,27 @@ export default class Qsu {
     /*
     * Verify
     * */
+    static isEqual(leftOperand, ...rightOperand) {
+        const rightOperands = rightOperand.length > 0 && typeof rightOperand[0] === 'object' ? rightOperand[0] : rightOperand;
+        const rightOperandLength = rightOperands.length;
+        for (let i = 0; i < rightOperandLength; i += 1) {
+            // eslint-disable-next-line eqeqeq
+            if (rightOperands[i] != leftOperand) {
+                return false;
+            }
+        }
+        return true;
+    }
+    static isEqualStrict(leftOperand, ...rightOperand) {
+        const rightOperands = rightOperand.length > 0 && typeof rightOperand[0] === 'object' ? rightOperand[0] : rightOperand;
+        const rightOperandLength = rightOperands.length;
+        for (let i = 0; i < rightOperandLength; i += 1) {
+            if (rightOperands[i] !== leftOperand) {
+                return false;
+            }
+        }
+        return true;
+    }
     static isEmpty(data) {
         if (!data) {
             return true;
@@ -331,7 +355,7 @@ export default class Qsu {
         }
     }
     static isBotAgent(userAgent) {
-        return /bot|naverbot|google|Googlebot|Googlebot-Mobile|Googlebot-Image|Google favicon|Mediapartners-Google|bingbot|slurp|java|wget|curl|Commons-HttpClient|Python-urllib|libwww|httpunit|nutch|phpcrawl|msnbot|jyxobot|FAST-WebCrawler|FAST Enterprise Crawler|biglotron|teoma|convera|seekbot|gigablast|exabot|ngbot|ia_archiver|GingerCrawler|webmon |httrack|webcrawler|grub.org|UsineNouvelleCrawler|antibot|netresearchserver|speedy|fluffy|bibnum.bnf|findlink|msrbot|panscient|yacybot|AISearchBot|IOI|ips-agent|tagoobot|MJ12bot|dotbot|woriobot|yanga|buzzbot|mlbot|yandexbot|purebot|Linguee Bot|Voyager|CyberPatrol|voilabot|baiduspider|citeseerxbot|spbot|twengabot|postrank|turnitinbot|scribdbot|page2rss|sitebot|linkdex|Adidxbot|blekkobot|ezooms|dotbot|Mail.RU_Bot|discobot|heritrix|findthatfile|europarchive.org|NerdByNature.Bot|sistrix crawler|ahrefsbot|Aboundex|domaincrawler|wbsearchbot|summify|ccbot|edisterbot|seznambot|ec2linkfinder|gslfbot|aihitbot|intelium_bot|facebookexternalhit|yeti|RetrevoPageAnalyzer|lb-spider|sogou|lssbot|careerbot|wotbox|wocbot|ichiro|DuckDuckBot|lssrocketcrawler|drupact|webcompanycrawler|acoonbot|openindexspider|gnam gnam spider|web-archive-net.com.bot|backlinkcrawler|coccoc|integromedb|content crawler spider|toplistbot|seokicks-robot|it2media-domain-crawler|ip-web-crawler.com|siteexplorer.info|elisabot|proximic|changedetection|blexbot|arabot|WeSEE:Search|niki-bot|CrystalSemanticsBot|rogerbot|360Spider|psbot|InterfaxScanBot|Lipperhey SEO Service|CC Metadata Scaper|g00g1e.net|GrapeshotCrawler|urlappendbot|brainobot|fr-crawler|binlar|SimpleCrawler|Livelapbot|Twitterbot|cXensebot|smtbot|bnf.fr_bot|A6-Indexer|ADmantX|Facebot|Twitterbot|OrangeBot|memorybot|AdvBot|MegaIndex|SemanticScholarBot|ltx71|nerdybot|xovibot|BUbiNG|Qwantify|archive.org_bot|Applebot|TweetmemeBot|crawler4j|findxbot|SemrushBot|yoozBot|lipperhey|y!j-asr|Domain Re-Animator Bot|AddThis/i.test(userAgent);
+        return /bot|naverbot|google|Googlebot|Googlebot-Mobile|Googlebot-Image|Google favicon|Chrome-Lighthouse|Mediapartners-Google|bingbot|slurp|java|wget|curl|Commons-HttpClient|Python-urllib|libwww|httpunit|nutch|phpcrawl|msnbot|jyxobot|FAST-WebCrawler|FAST Enterprise Crawler|biglotron|teoma|convera|seekbot|gigablast|exabot|ngbot|ia_archiver|GingerCrawler|webmon |httrack|webcrawler|grub.org|UsineNouvelleCrawler|antibot|netresearchserver|speedy|fluffy|bibnum.bnf|findlink|msrbot|panscient|yacybot|AISearchBot|IOI|ips-agent|tagoobot|MJ12bot|dotbot|woriobot|yanga|buzzbot|mlbot|yandexbot|purebot|Linguee Bot|Voyager|CyberPatrol|voilabot|baiduspider|citeseerxbot|spbot|twengabot|postrank|turnitinbot|scribdbot|page2rss|sitebot|linkdex|Adidxbot|blekkobot|ezooms|dotbot|Mail.RU_Bot|discobot|heritrix|findthatfile|europarchive.org|NerdByNature.Bot|sistrix crawler|ahrefsbot|Aboundex|domaincrawler|wbsearchbot|summify|ccbot|edisterbot|seznambot|ec2linkfinder|gslfbot|aihitbot|intelium_bot|facebookexternalhit|yeti|RetrevoPageAnalyzer|lb-spider|sogou|lssbot|careerbot|wotbox|wocbot|ichiro|DuckDuckBot|lssrocketcrawler|drupact|webcompanycrawler|acoonbot|openindexspider|gnam gnam spider|web-archive-net.com.bot|backlinkcrawler|coccoc|integromedb|content crawler spider|toplistbot|seokicks-robot|it2media-domain-crawler|ip-web-crawler.com|siteexplorer.info|elisabot|proximic|changedetection|blexbot|arabot|WeSEE:Search|niki-bot|CrystalSemanticsBot|rogerbot|360Spider|psbot|InterfaxScanBot|Lipperhey SEO Service|CC Metadata Scaper|g00g1e.net|GrapeshotCrawler|urlappendbot|brainobot|fr-crawler|binlar|SimpleCrawler|Livelapbot|Twitterbot|cXensebot|smtbot|bnf.fr_bot|A6-Indexer|ADmantX|Facebot|Twitterbot|OrangeBot|memorybot|AdvBot|MegaIndex|SemanticScholarBot|ltx71|nerdybot|xovibot|BUbiNG|Qwantify|archive.org_bot|Applebot|TweetmemeBot|crawler4j|findxbot|SemrushBot|yoozBot|lipperhey|y!j-asr|Domain Re-Animator Bot|AddThis/i.test(userAgent);
     }
     /*
     * Format
@@ -340,10 +364,20 @@ export default class Qsu {
         return new Intl.NumberFormat().format(number);
     }
     static fileName(filePath, withExtension = false) {
+        if (!filePath) {
+            return '';
+        }
+        if (filePath.indexOf('/') === -1) {
+            // Windows path
+            if (withExtension) {
+                return win32.basename(filePath);
+            }
+            return win32.basename(filePath, extname(filePath));
+        }
         if (withExtension) {
-            return path.basename(filePath);
+            return basename(filePath);
         }
-        return path.basename(filePath, path.extname(filePath));
+        return basename(filePath, extname(filePath));
     }
     static fileSize(bytes, decimals = 2) {
         if (bytes === 0 || bytes < 0) {

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "qsu",
-  "version": "1.0.5",
-  "description": "Quick and Simple Utility for javascript",
+  "version": "1.0.8",
+  "description": "Quick and Simple Utility for JavaScript",
   "type": "module",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc",
-    "test": "npm run lint && npm run build && mocha --parallel test/*.spec.js",
+    "test": "npm run build && mocha --parallel test/*.spec.js",
     "lint": "eslint .",
     "lint:fix": "eslint --fix ."
   },
@@ -43,15 +43,15 @@
     "math"
   ],
   "devDependencies": {
-    "@types/node": "^18.0.0",
-    "@typescript-eslint/eslint-plugin": "^5.28.0",
-    "@typescript-eslint/parser": "^5.28.0",
-    "date-fns": "^2.28.0",
-    "eslint": "^8.17.0",
+    "@types/node": "^18.7.3",
+    "@typescript-eslint/eslint-plugin": "^5.33.0",
+    "@typescript-eslint/parser": "^5.33.0",
+    "date-fns": "^2.29.1",
+    "eslint": "^8.22.0",
     "eslint-config-airbnb": "^19.0.4",
     "eslint-plugin-import": "^2.26.0",
     "mocha": "^10.0.0",
-    "ts-node": "^10.8.1",
-    "typescript": "^4.7.3"
+    "ts-node": "^10.9.1",
+    "typescript": "^4.7.4"
   }
 }

package/CHANGELOG.md

@@ -1,36 +0,0 @@
-# Change Log
-
-## 1.0.5 (2022-06-23)
-
-- `contains`: When the length of the str parameter value of string type is 0, no error is thrown and false is returned.
-
-## 1.0.4 (2022-06-16)
-**NOTICE**: `convertDate` is no longer supported due to the removal of `moment` as a dependent module.
-
-The `today` method has changed its usage. We no longer support custom date formats.
-
-- `split`: Add new split method
-- `today`: Remove dependent modules, change parameters to use pure code
-- `convertDate`: Remove method
-- `encrypt`, `decrypt`: Add basic validation check (more fix)
-
-## 1.0.3 (2022-05-24)
-
-- `encrypt`, `decrypt`: Add basic validation check
-
-## 1.0.2 (2022-05-23)
-
-- `encrypt` `decrypt`: Add basic validation check
-- `strBlindRandom`: Override the deprecated substr method
-
-## 1.0.1 (2022-05-12)
-
-- Minimize bundle size and clean up code
-
-## 1.0.0 (2022-05-09)
-
-- First version release
-
-## 0.0.1 ~ 0.5.5 (2021-03-16 ~ 2022-04-09)
-
-- This is for the Alpha release and is not recommended for use.