generate-ip 2.2.6 → 2.2.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +14 -14
  2. package/dist/cli.min.js +6 -3
  3. package/dist/generate-ip.min.js +1 -1
  4. package/docs/README.md +14 -14
  5. package/package.json +2 -2
package/README.md CHANGED
@@ -1,11 +1,11 @@
1
- # > generate-ip
1
+ # <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/generate-ip/media/images/icons/node-graph/white/icon55x49.png"><img height=32 src="https://raw.githubusercontent.com/adamlui/js-utils/main/generate-ip/media/images/icons/node-graph/black/icon55x49.png"></picture> generate-ip
2
2
 
3
3
  ### Randomly generate, format, and validate IPv4/IPv6 addresses.
4
4
 
5
5
  <a href="#%EF%B8%8F-mit-license"><img height=31 src="https://img.shields.io/badge/License-MIT-orange.svg?logo=internetarchive&logoColor=white&labelColor=464646&style=for-the-badge"></a>
6
- <a href="https://github.com/adamlui/js-utils/releases/tag/generate-ip-2.2.6"><img height=31 src="https://img.shields.io/badge/Latest_Build-2.2.6-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
6
+ <a href="https://github.com/adamlui/js-utils/releases/tag/generate-ip-2.2.8"><img height=31 src="https://img.shields.io/badge/Latest_Build-2.2.8-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
7
7
  <a href="https://www.npmjs.com/package/generate-ip?activeTab=code"><img height=31 src="https://img.shields.io/npm/unpacked-size/generate-ip?style=for-the-badge&logo=ebox&logoColor=white&labelColor=464646&color=blue"></a>
8
- <a href="https://github.com/adamlui/js-utils/blob/generate-ip-2.2.6/generate-ip/dist/generate-ip.min.js"><img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/generate-ip/dist/generate-ip.min.js?branch=generate-ip-2.2.6&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
8
+ <a href="https://github.com/adamlui/js-utils/blob/generate-ip-2.2.8/generate-ip/dist/generate-ip.min.js"><img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/generate-ip/dist/generate-ip.min.js?branch=generate-ip-2.2.8&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
9
9
  <a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_js-utils:generate-ip/src/generate-ip.js"><img height=31 src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fsonarcloud.io%2Fapi%2Fmeasures%2Fcomponent%3Fcomponent%3Dadamlui_js-utils%3Agenerate-ip%2Fsrc%2Fgenerate-ip.js%26metricKeys%3Dvulnerabilities&query=%24.component.measures.0.value&style=for-the-badge&logo=sonarcloud&logoColor=white&labelColor=464646&label=Vulnerabilities&color=gold"></a>
10
10
  <a href="https://github.com/toolleeo/cli-apps#networking"><img height=31 src="https://img.shields.io/badge/Mentioned_in-Awesome-c4a2bd?logo=awesomelists&logoColor=white&labelColor=464646&style=for-the-badge"></a>
11
11
  <a href="https://www.jsdelivr.com/package/npm/generate-ip?tab=stats"><img height=31 src="https://img.shields.io/jsdelivr/npm/hm/generate-ip?style=for-the-badge&logo=jsdelivr&logoColor=white&label=jsDelivr%20Hits&labelColor=464646&color=49c5d8"></a>
@@ -72,14 +72,14 @@ const { ipv4, ipv6 } = require('generate-ip');
72
72
  #### <> HTML script tag:
73
73
 
74
74
  ```html
75
- <script src="https://cdn.jsdelivr.net/npm/generate-ip@2.2.6/dist/generate-ip.min.js"></script>
75
+ <script src="https://cdn.jsdelivr.net/npm/generate-ip@2.2.8/dist/generate-ip.min.js"></script>
76
76
  ```
77
77
 
78
78
  #### ES6:
79
79
 
80
80
  ```js
81
81
  (async () => {
82
- await import('https://cdn.jsdelivr.net/npm/generate-ip@2.2.6/dist/generate-ip.min.js');
82
+ await import('https://cdn.jsdelivr.net/npm/generate-ip@2.2.8/dist/generate-ip.min.js');
83
83
  // Your code here...
84
84
  })();
85
85
  ```
@@ -88,7 +88,7 @@ const { ipv4, ipv6 } = require('generate-ip');
88
88
 
89
89
  ```js
90
90
  ...
91
- // @require https://cdn.jsdelivr.net/npm/generate-ip@2.2.6/dist/generate-ip.min.js
91
+ // @require https://cdn.jsdelivr.net/npm/generate-ip@2.2.8/dist/generate-ip.min.js
92
92
  // ==/UserScript==
93
93
 
94
94
  // Your code here...
@@ -96,7 +96,7 @@ const { ipv4, ipv6 } = require('generate-ip');
96
96
 
97
97
  <br>
98
98
 
99
- 📝 **Note:** To always import the latest version (not recommended in production!) remove the `@2.2.6` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-ip/dist/generate-ip.min.js`
99
+ 📝 **Note:** To always import the latest version (not recommended in production!) remove the `@2.2.8` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-ip/dist/generate-ip.min.js`
100
100
 
101
101
  <br>
102
102
 
@@ -215,13 +215,13 @@ Name | Type | Description | Default Value
215
215
  #
216
216
 
217
217
 
218
- #### `ipv6.format(address[, options])`
218
+ #### `ipv6.format(ipv6address[, options])`
219
219
 
220
220
  Formats an IPv6 address according to `options` passed, returning a string:
221
221
 
222
222
  ```js
223
- const address = '0d::ffff:192.1.56.10/96',
224
- formattedAddress = ipv6.format(address, { leadingZeros: true, doubleColon: false });
223
+ const ipv6address = '0d::ffff:192.1.56.10/96',
224
+ formattedAddress = ipv6.format(ipv6address, { leadingZeros: true, doubleColon: false });
225
225
 
226
226
  console.log(formattedAddress);
227
227
 
@@ -321,14 +321,14 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
321
321
 
322
322
  ## 🛠️ Related utilities
323
323
 
324
- ### [🔒 generate-pw](../generate-pw)
324
+ ### [🔒 generate-pw](../generate-pw) <a href="https://github.com/toolleeo/cli-apps#password-managers"><img height=18 src="https://awesome.re/mentioned-badge.svg"></a>
325
325
 
326
326
  > Randomly generate, strengthen, and validate cryptographically-secure passwords.
327
327
  <br>[Install](https://docs.js-utils.com/generate-pw/#-installation) /
328
328
  [Readme](https://docs.js-utils.com/generate-pw/#readme) /
329
329
  [API usage](https://docs.js-utils.com/generate-pw/#-api-usage) /
330
330
  [CLI usage](https://docs.js-utils.com/generate-pw/#-command-line-usage) /
331
- [Discuss](https://js-utils.com/discussions)
331
+ [Discuss](https://github.js-utils.com/discussions)
332
332
 
333
333
  ### <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/geolocate/media/images/icons/wire-globe/white/icon32.png"><img height=22 src="https://raw.githubusercontent.com/adamlui/js-utils/main/geolocate/media/images/icons/wire-globe/black/icon32.png"></picture> [geolocate](https://js-utils.com/geolocate)
334
334
 
@@ -337,12 +337,12 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
337
337
  [Readme](https://docs.js-utils.com/geolocate/#readme) /
338
338
  [CLI usage](https://docs.js-utils.com/geolocate/#-command-line-usage) /
339
339
  [API usage](https://docs.js-utils.com/geolocate/#-api-usage) /
340
- [Discuss](https://js-utils.com/discussions)
340
+ [Discuss](https://github.js-utils.com/discussions)
341
341
 
342
342
  <br>
343
343
 
344
344
  <img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
345
345
 
346
346
  <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/media/images/icons/home/white/icon32x27.png"><img height=13 src="https://raw.githubusercontent.com/adamlui/js-utils/main/media/images/icons/home/dark-gray/icon32x27.png"></picture> <a href="https://js-utils.com">**More JavaScript utilities**</a> /
347
- <a href="https://js-utils.com/discussions">Discuss</a> /
347
+ <a href="https://github.js-utils.com/discussions">Discuss</a> /
348
348
  <a href="#-generate-ip">Back to top ↑</a>
package/dist/cli.min.js CHANGED
@@ -4,12 +4,15 @@
4
4
  * Source: https://code.js-utils.com/generate-ip
5
5
  * Documentation: https://docs.js-utils.com/generate-ip
6
6
  */
7
- const pkgName="generate-ip",docURL="https://docs.js-utils.com/generate-ip/#-command-line-usage",ipv4=require(__dirname.match(/src/)?"./generate-ip":"./generate-ip.min")["ipv4"],fs=require("fs"),path=require("path"),execSync=require("child_process")["execSync"],nc="",br="",by="",config={},argRegex={paramOptions:{qty:/^--?qu?a?n?ti?t?y(?:=.*|$)/},flags:{quietMode:/^--?q(?:uiet)?(?:-?mode)?$/},infoCmds:{help:/^--?h(?:elp)?$/,version:/^--?ve?r?s?i?o?n?$/}};if(process.argv.forEach(o=>{var e,n,r;o.startsWith("-")&&(e=Object.keys(argRegex.paramOptions).find(e=>argRegex.paramOptions[e].test(o)),r=Object.keys(argRegex.flags).find(e=>argRegex.flags[e].test(o)),n=Object.keys(argRegex.infoCmds).find(e=>argRegex.infoCmds[e].test(o)),r?config[r]=!0:e?(o.includes("=")||(console.error(`
7
+ const pkgName="generate-ip",docURL="https://docs.js-utils.com/generate-ip/#-command-line-usage",ipv4=require(__dirname.match(/src/)?"./generate-ip":"./generate-ip.min")["ipv4"],fs=require("fs"),path=require("path"),execSync=require("child_process")["execSync"],nc="",br="",by="",bw="",config={},argRegex={paramOptions:{qty:/^--?qu?a?n?ti?t?y(?:=.*|$)/},flags:{quietMode:/^--?q(?:uiet)?(?:-?mode)?$/},infoCmds:{help:/^--?h(?:elp)?$/,version:/^--?ve?r?s?i?o?n?$/}};if(process.argv.forEach(o=>{var e,n,r;o.startsWith("-")&&(e=Object.keys(argRegex.paramOptions).find(e=>argRegex.paramOptions[e].test(o)),r=Object.keys(argRegex.flags).find(e=>argRegex.flags[e].test(o)),n=Object.keys(argRegex.infoCmds).find(e=>argRegex.infoCmds[e].test(o)),r?config[r]=!0:e?(o.includes("=")||(console.error(`
8
8
  ${br}ERROR: Arg [--${o.replace(/-/g,"")}] requires '=' followed by a value.`+nc),printHelpCmdAndDocURL(),process.exit(1)),r=o.split("=")[1],config[e]=parseInt(r)||r):n||(console.error(`
9
9
  ${br}ERROR: Arg [${o}] not recognized.`+nc),console.info(`
10
10
  ${by}Valid arguments are below.`+nc),printHelpSections(["paramOptions","flags","infoCmds"]),printHelpCmdAndDocURL(),process.exit(1)))}),process.argv.some(e=>argRegex.infoCmds.help.test(e)))printHelpSections();else if(process.argv.some(e=>argRegex.infoCmds.version.test(e))){const k=execSync(`npm view ${pkgName} version`).toString().trim()||"none";let e,r=process.cwd();for(;"/"!=r;){const n=path.join(r,"package.json");if(fs.existsSync(n)){const o=require(n);e=(o.dependencies?.[pkgName]||o.devDependencies?.[pkgName])?.match(/(\d+\.\d+\.\d+)/)[0]||"none";break}r=path.dirname(r)}console.info(`
11
11
  Global version: `+k),console.info("Local version: "+e)}else{config.qty&&(isNaN(config.qty)||config.qty<1)&&(console.error(`
12
- ${br}Error: [qty] argument can only be > 0.`+nc),printHelpCmdAndDocURL(),process.exit(1));const p=ipv4.generate({qty:config.qty||1,verbose:!config.quietMode});config.quietMode||(1<config.qty&&console.info(`[ ${p.join(", ")} ]`),console.info("\nCopying to clipboard...")),copyToClipboard(Array.isArray(p)?p.join("\n"):p)}function printHelpSections(e=["cmdFormat","paramOptions","flags","infoCmds"]){const o={cmdFormat:[`
13
- ${by}generate-ip [options|commands]`+nc],paramOptions:["\nParameter options:"," --qty=n Generate n IP address(es)."],flags:["\nBoolean options:"," -q, --quiet Suppress all logging except errors."],infoCmds:["\nInfo commands:"," -h, --help Display help screen."," -v, --version Show version number."]};e.forEach(e=>{o[e]?.forEach(e=>{{const r=process.stdout.columns||80,s=[],o=e.match(/\S+|\s+/g);let n="";o.forEach(e=>{var o=r-(0==s.length?0:29);n.length+e.length>o&&(s.push(0==s.length?n:n.trimStart()),n=""),n+=e}),s.push(0==s.length?n:n.trimStart()),s.forEach((e,o)=>console.info(0==o?e:" ".repeat(29)+e))}})})}function printHelpCmdAndDocURL(){console.info(`
12
+ ${br}Error: [qty] argument can only be > 0.`+nc),printHelpCmdAndDocURL(),process.exit(1));const p=ipv4.generate({qty:config.qty||1,verbose:!config.quietMode});config.quietMode||(1<config.qty&&console.info(`[ ${p.join(", ")} ]`),console.info("\nCopying to clipboard...")),copyToClipboard(Array.isArray(p)?p.join("\n"):p)}function printHelpSections(e=["usage","paramOptions","flags","infoCmds"]){const o={usage:[`
13
+ ${bw}Usage:`+nc," generate-ip [options|commands]"],paramOptions:[`
14
+ ${bw}Parameter options:`+nc," --qty=n Generate n IP address(es)."],flags:[`
15
+ ${bw}Boolean options:`+nc," -q, --quiet Suppress all logging except errors."],infoCmds:[`
16
+ ${bw}Info commands:`+nc," -h, --help Display help screen."," -v, --version Show version number."]};e.forEach(e=>{o[e]?.forEach(e=>{{const r=process.stdout.columns||80,s=[],o=e.match(/\S+|\s+/g);let n="";o.forEach(e=>{var o=r-(0==s.length?0:29);n.length+e.length>o&&(s.push(0==s.length?n:n.trimStart()),n=""),n+=e}),s.push(0==s.length?n:n.trimStart()),s.forEach((e,o)=>console.info(0==o?e:" ".repeat(29)+e))}})})}function printHelpCmdAndDocURL(){console.info(`
14
17
  ${by}For more help, type 'generate-ip --help' or visit
15
18
  `+(docURL+nc))}function copyToClipboard(e){e=e.replace(/\s+$/,"").replace(/"/g,'""'),"darwin"==process.platform?execSync(`printf "${e}" | pbcopy`):"linux"==process.platform?execSync(`printf "${e}" | xclip -selection clipboard`):"win32"==process.platform&&execSync(`Set-Clipboard -Value "${e}"`,{shell:"powershell"})}
package/dist/generate-ip.min.js CHANGED
@@ -3,4 +3,4 @@
3
3
  * Source: https://code.js-utils.com/generate-ip
4
4
  * Documentation: https://docs.js-utils.com/generate-ip
5
5
  */
6
- let randomInt;try{({randomInt}=require("crypto"))}catch(e){const b=window.crypto||window.msCrypto;randomInt=(e,o)=>{var t=b?.getRandomValues(new Uint32Array(1))[0]/4294967295||Math.random();return Math.floor(t*(o-e))+e}}const ipv4={generate:function(o={}){var e={verbose:!0,qty:1};if(validateOptions(o,e,"https://docs.js-utils.com/generate-ip/#ipv4generateoptions","ipv4.generate({ verbose: false, qty: 3 })")){(o={...e,...o}).verbose&&console.info(`ipv4.generate() » Generating IPv4 address${1<o.qty?"es":""}...`);var t=[];if(1<o.qty)for(let e=0;e<o.qty;e++)t.push(this.generate({...o,qty:1,verbose:!1}));else{var i=[];for(let e=0;e<4;e++)i.push(randomInt(0,256));t.push(i.join("."))}e=1<o.qty?t:t[0];return o.verbose&&(console.info(`ipv4.generate() » IPv4 address${1<o.qty?"es":""} generated!`),1==o.qty?console.info("ipv4.generate() » "+e):"undefined"!=typeof require&&/cli(?:\.min)?\.js$/.test(require.main.filename)||console.info("ipv4.generate() » Check returned array.")),e}},validate:function(e,o={}){var t="https://docs.js-utils.com/generate-ip/#ipv4validateaddress-options",i={verbose:!0};if("string"!=typeof e)console.error("ipv4.validate() » ERROR: 1st arg <address> must be a string."),console.info("ipv4.validate() » For more help, please visit "+t);else if(validateOptions(o,i,t,"ipv4.validate('0.0.255.255', { verbose: false })"))return(o={...i,...o}).verbose&&console.info("ipv4.validate() » Validating IPv4 address..."),i=!(4!=(t=e.split(".")).length||t.some(e=>!/^\d+$/.test(e)||parseInt(e,10)<0||255<parseInt(e,10))),o.verbose&&console.info(`ipv4.validate() » IP is ${i?"":"in"}valid IPv4 address!`),i}},ipv6={generate:function(o={}){var e={verbose:!0,qty:1,leadingZeros:!1,doubleColon:!0};if(validateOptions(o,e,"https://docs.js-utils.com/generate-ip/#ipv6generateoptions","ipv6.generate({ leadingZeros: true, qty: 5 })")){(o={...e,...o}).verbose&&console.info(`ipv6.generate() » Generating IPv6 address${1<o.qty?"es":""}...`);var t=[];if(1<o.qty)for(let e=0;e<o.qty;e++)t.push(this.generate({...o,qty:1,verbose:!1}));else{const i=[],{qty:r,...s}=o;for(let e=0;e<8;e++){let o="";for(let e=0;e<4;e++)o+=randomInt(0,16).toString(16);i.push(o)}t.push(this.format(i.join(":"),{...s,verbose:!1}))}e=1<o.qty?t:t[0];return o.verbose&&(console.info(`ipv6.generate() » IPv6 address${1<o.qty?"es":""} generated!`),console.info(1==o.qty?"ipv6.generate() » "+e:"ipv6.generate() » Check returned array.")),e}},format:function(o,t={}){var i,e="https://docs.js-utils.com/generate-ip/#ipv6formataddress-options",r={verbose:!0,leadingZeros:!1,doubleColon:!0};if("string"!=typeof o)console.error("ipv6.format() » ERROR: 1st arg <address> must be a string."),console.info("ipv6.format() » For more help, please visit "+e);else if(this.validate(o,{verbose:!1})){if(validateOptions(t,r,e,"ipv6.format('0d::ffff:192.1.56.10/96', { leadingZeros: true, doubleColon: false })")){t={...r,...t};let e=o;if(e=t.doubleColon?(t.verbose&&console.info("ipv6.format() » Replacing zero series w/ '::'..."),e.replace(/:(?:0+:)+/,"::")):(t.verbose&&console.info("ipv6.format() » Expanding '::' into zero series..."),r=e.split(":").filter(Boolean).length,i=t.leadingZeros?"0000":"0",r=Array(8-r).fill(i).join(":"),e.replace("::",`:${r}:`)),t.leadingZeros){t.verbose&&console.info("ipv6.format() » Adding leading zeros...");var s=e.split(":");for(let e=0;e<s.length;e++)for(;s[e].length<4;)s[e]="0"+s[e];e=s.join(":")}else t.verbose&&console.info("ipv6.format() » Stripping leading zeros..."),e=o.replace(/(^|(?<=:))0+(?!:)/g,"$1");return t.verbose&&(e!=o?console.info("ipv6.format() » IP formatted successfully!"):console.info("ipv6.format() » IP already formatted to specs."),console.info("ipv6.format() » "+e)),e}}else console.error(`ipv6.format() » ERROR: ${o} is not a valid IPv6 address.`),console.info("ipv6.format() » For more help, please visit "+e)},validate:function(e,o={}){var t="https://docs.js-utils.com/generate-ip/#ipv6validateaddress-options",i={verbose:!0};if("string"!=typeof e)console.error("ipv6.validate() » ERROR: 1st arg <address> must be a string."),console.info("ipv6.validate() » For more help, please visit "+t);else if(validateOptions(o,i,t,"ipv6.validate('0:0:0:0:0:ffff:192.1.56.10/96', { verbose: false })")){(o={...i,...o}).verbose&&console.info("ipv6.validate() » Validating IPv6 address...");const r=e.split(/::?/),s=r[r.length-1];t=!(e.includes("::")&&2<e.split("::").length||/:{3,}/g.test(e)||r.length<2||8<r.length||r.some(e=>!(/^[\dA-Fa-f]{1,4}$/.test(e)||e==s&&ipv4.validate(s.replace(/\/(?:0|(?:[1-2]?\d)|32|96)$/,""),{verbose:!1}))));return o.verbose&&console.info(`ipv6.validate() » IP is ${t?"":"in"}valid IPv6 address!`),t}}};function validateOptions(e,o,t,i){const r=JSON.stringify(o,null,2).replace(/"([^"]+)":/g,"$1:").replace(/"/g,"'").replace(/\n\s*/g," "),s=Object.keys(o).join(", "),n=Object.keys(o).filter(e=>"boolean"==typeof o[e]),a=Object.keys(o).filter(e=>Number.isInteger(o[e]));let l="validateOptions() » ";try{l=validateOptions.caller?.name+"() » "}catch(e){}var v=i.split(",").findIndex(e=>e.trim().startsWith("{"))+1,p=(v+=["st","nd","rd"][v-1]||"th",()=>{console.info(`${l}Valid options: [ ${s} ]`),console.info(l+"If omitted, default settings are: "+r)}),d=()=>{console.info(l+"For more help, please visit "+t)};if("object"!=typeof e)return console.error(l+`ERROR: ${"0th"==v?"[O":v+" arg [o"}ptions] can only be an object of key/values.`),console.info(l+"Example valid call: "+i),p(),d(),!1;for(const f in e){if(!Object.prototype.hasOwnProperty.call(o,f))return console.error(`${l}ERROR: \`${f}\` is an invalid option.`),p(),d(),!1;if(n.includes(f)&&"boolean"!=typeof e[f])return console.error(`${l}ERROR: [${f}] option can only be \`true\` or \`false\`.`),d(),!1;if(a.includes(f)&&(e[f]=parseInt(e[f],10),isNaN(e[f])||e[f]<1))return console.error(`${l}ERROR: [${f}] option can only be an integer > 0.`),d(),!1}return!0}try{module.exports={ipv4:ipv4,ipv6:ipv6}}catch(e){}try{window.ipv4=ipv4,window.ipv6=ipv6}catch(e){}
6
+ let randomInt;try{({randomInt}=require("crypto"))}catch(e){const b=window.crypto||window.msCrypto;randomInt=(e,o)=>{var t=b?.getRandomValues(new Uint32Array(1))[0]/4294967295||Math.random();return Math.floor(t*(o-e))+e}}const ipv4={generate:function(o={}){var e={verbose:!0,qty:1};if(validateOptions(o,e,"https://docs.js-utils.com/generate-ip/#ipv4generateoptions","ipv4.generate({ verbose: false, qty: 3 })")){(o={...e,...o}).verbose&&console.info(`ipv4.generate() » Generating IPv4 address${1<o.qty?"es":""}...`);var t=[];if(1<o.qty)for(let e=0;e<o.qty;e++)t.push(this.generate({...o,qty:1,verbose:!1}));else{var i=[];for(let e=0;e<4;e++)i.push(randomInt(0,256));t.push(i.join("."))}e=1<o.qty?t:t[0];return o.verbose&&(console.info(`ipv4.generate() » IPv4 address${1<o.qty?"es":""} generated!`),1==o.qty?console.info("ipv4.generate() » "+e):"undefined"!=typeof require&&/cli(?:\.min)?\.js$/.test(require.main.filename)||console.info("ipv4.generate() » Check returned array.")),e}},validate:function(e,o={}){var t="https://docs.js-utils.com/generate-ip/#ipv4validateaddress-options",i={verbose:!0};if("string"!=typeof e)console.error("ipv4.validate() » ERROR: 1st arg <address> must be a string."),console.info("ipv4.validate() » For more help, please visit "+t);else if(validateOptions(o,i,t,"ipv4.validate('0.0.255.255', { verbose: false })"))return(o={...i,...o}).verbose&&console.info("ipv4.validate() » Validating IPv4 address..."),i=!(4!=(t=e.split(".")).length||t.some(e=>!/^\d+$/.test(e)||parseInt(e,10)<0||255<parseInt(e,10))),o.verbose&&console.info(`ipv4.validate() » IP is ${i?"":"in"}valid IPv4 address!`),i}},ipv6={generate:function(o={}){var e={verbose:!0,qty:1,leadingZeros:!1,doubleColon:!0};if(validateOptions(o,e,"https://docs.js-utils.com/generate-ip/#ipv6generateoptions","ipv6.generate({ leadingZeros: true, qty: 5 })")){(o={...e,...o}).verbose&&console.info(`ipv6.generate() » Generating IPv6 address${1<o.qty?"es":""}...`);var t=[];if(1<o.qty)for(let e=0;e<o.qty;e++)t.push(this.generate({...o,qty:1,verbose:!1}));else{const i=[],{qty:r,...s}=o;for(let e=0;e<8;e++){let o="";for(let e=0;e<4;e++)o+=randomInt(0,16).toString(16);i.push(o)}t.push(this.format(i.join(":"),{...s,verbose:!1}))}e=1<o.qty?t:t[0];return o.verbose&&(console.info(`ipv6.generate() » IPv6 address${1<o.qty?"es":""} generated!`),console.info(1==o.qty?"ipv6.generate() » "+e:"ipv6.generate() » Check returned array.")),e}},format:function(o,t={}){var i,e="https://docs.js-utils.com/generate-ip/#ipv6formatipv6address-options",r={verbose:!0,leadingZeros:!1,doubleColon:!0};if("string"!=typeof o)console.error("ipv6.format() » ERROR: 1st arg <ipv6address> must be a string."),console.info("ipv6.format() » For more help, please visit "+e);else if(this.validate(o,{verbose:!1})){if(validateOptions(t,r,e,"ipv6.format('0d::ffff:192.1.56.10/96', { leadingZeros: true, doubleColon: false })")){t={...r,...t};let e=o;if(e=t.doubleColon?(t.verbose&&console.info("ipv6.format() » Replacing zero series w/ '::'..."),e.replace(/:(?:0+:)+/,"::")):(t.verbose&&console.info("ipv6.format() » Expanding '::' into zero series..."),r=e.split(":").filter(Boolean).length,i=t.leadingZeros?"0000":"0",r=Array(8-r).fill(i).join(":"),e.replace("::",`:${r}:`)),t.leadingZeros){t.verbose&&console.info("ipv6.format() » Adding leading zeros...");var s=e.split(":");for(let e=0;e<s.length;e++)for(;s[e].length<4;)s[e]="0"+s[e];e=s.join(":")}else t.verbose&&console.info("ipv6.format() » Stripping leading zeros..."),e=o.replace(/(^|(?<=:))0+(?!:)/g,"$1");return t.verbose&&(e!=o?console.info("ipv6.format() » IP formatted successfully!"):console.info("ipv6.format() » IP already formatted to specs."),console.info("ipv6.format() » "+e)),e}}else console.error(`ipv6.format() » ERROR: ${o} is not a valid IPv6 address.`),console.info("ipv6.format() » For more help, please visit "+e)},validate:function(e,o={}){var t="https://docs.js-utils.com/generate-ip/#ipv6validateaddress-options",i={verbose:!0};if("string"!=typeof e)console.error("ipv6.validate() » ERROR: 1st arg <address> must be a string."),console.info("ipv6.validate() » For more help, please visit "+t);else if(validateOptions(o,i,t,"ipv6.validate('0:0:0:0:0:ffff:192.1.56.10/96', { verbose: false })")){(o={...i,...o}).verbose&&console.info("ipv6.validate() » Validating IPv6 address...");const r=e.split(/::?/),s=r[r.length-1];t=!(e.includes("::")&&2<e.split("::").length||/:{3,}/g.test(e)||r.length<2||8<r.length||r.some(e=>!(/^[\dA-Fa-f]{1,4}$/.test(e)||e==s&&ipv4.validate(s.replace(/\/(?:0|(?:[1-2]?\d)|32|96)$/,""),{verbose:!1}))));return o.verbose&&console.info(`ipv6.validate() » IP is ${t?"":"in"}valid IPv6 address!`),t}}};function validateOptions(e,o,t,i){const r=JSON.stringify(o,null,2).replace(/"([^"]+)":/g,"$1:").replace(/"/g,"'").replace(/\n\s*/g," "),s=Object.keys(o).join(", "),n=Object.keys(o).filter(e=>"boolean"==typeof o[e]),a=Object.keys(o).filter(e=>Number.isInteger(o[e]));let l="validateOptions() » ";try{l=validateOptions.caller?.name+"() » "}catch(e){}var p=i.split(",").findIndex(e=>e.trim().startsWith("{"))+1,v=(p+=["st","nd","rd"][p-1]||"th",()=>{console.info(`${l}Valid options: [ ${s} ]`),console.info(l+"If omitted, default settings are: "+r)}),d=()=>{console.info(l+"For more help, please visit "+t)};if("object"!=typeof e)return console.error(l+`ERROR: ${"0th"==p?"[O":p+" arg [o"}ptions] can only be an object of key/values.`),console.info(l+"Example valid call: "+i),v(),d(),!1;for(const f in e){if(!Object.prototype.hasOwnProperty.call(o,f))return console.error(`${l}ERROR: \`${f}\` is an invalid option.`),v(),d(),!1;if(n.includes(f)&&"boolean"!=typeof e[f])return console.error(`${l}ERROR: [${f}] option can only be \`true\` or \`false\`.`),d(),!1;if(a.includes(f)&&(e[f]=parseInt(e[f],10),isNaN(e[f])||e[f]<1))return console.error(`${l}ERROR: [${f}] option can only be an integer > 0.`),d(),!1}return!0}const apiAliases={ipv4:["IPV4","IPv4","ipV4"],ipv6:["IPV6","IPv6","ipV6"]};try{module.exports={ipv4:ipv4,ipv6:ipv6}}catch(e){}try{window.ipv4=ipv4,window.ipv6=ipv6}catch(e){}for(const ua in apiAliases)apiAliases[ua].forEach(e=>{try{module.exports[e]=module.exports[ua]}catch(e){}try{window[e]=window[ua]}catch(e){}});
package/docs/README.md CHANGED
@@ -1,11 +1,11 @@
1
- # > generate-ip
1
+ # <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/generate-ip/media/images/icons/node-graph/white/icon55x49.png"><img height=32 src="https://raw.githubusercontent.com/adamlui/js-utils/main/generate-ip/media/images/icons/node-graph/black/icon55x49.png"></picture> generate-ip
2
2
 
3
3
  ### Randomly generate, format, and validate IPv4/IPv6 addresses.
4
4
 
5
5
  <a href="#%EF%B8%8F-mit-license"><img height=31 src="https://img.shields.io/badge/License-MIT-orange.svg?logo=internetarchive&logoColor=white&labelColor=464646&style=for-the-badge"></a>
6
- <a href="https://github.com/adamlui/js-utils/releases/tag/generate-ip-2.2.6"><img height=31 src="https://img.shields.io/badge/Latest_Build-2.2.6-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
6
+ <a href="https://github.com/adamlui/js-utils/releases/tag/generate-ip-2.2.8"><img height=31 src="https://img.shields.io/badge/Latest_Build-2.2.8-44cc11.svg?logo=icinga&logoColor=white&labelColor=464646&style=for-the-badge"></a>
7
7
  <a href="https://www.npmjs.com/package/generate-ip?activeTab=code"><img height=31 src="https://img.shields.io/npm/unpacked-size/generate-ip?style=for-the-badge&logo=ebox&logoColor=white&labelColor=464646&color=blue"></a>
8
- <a href="https://github.com/adamlui/js-utils/blob/generate-ip-2.2.6/generate-ip/dist/generate-ip.min.js"><img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/generate-ip/dist/generate-ip.min.js?branch=generate-ip-2.2.6&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
8
+ <a href="https://github.com/adamlui/js-utils/blob/generate-ip-2.2.8/generate-ip/dist/generate-ip.min.js"><img height=31 src="https://img.shields.io/github/size/adamlui/js-utils/generate-ip/dist/generate-ip.min.js?branch=generate-ip-2.2.8&label=Minified%20Size&logo=databricks&logoColor=white&labelColor=464646&color=ff69b4&style=for-the-badge"></a>
9
9
  <a href="https://sonarcloud.io/component_measures?metric=new_vulnerabilities&id=adamlui_js-utils:generate-ip/src/generate-ip.js"><img height=31 src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fsonarcloud.io%2Fapi%2Fmeasures%2Fcomponent%3Fcomponent%3Dadamlui_js-utils%3Agenerate-ip%2Fsrc%2Fgenerate-ip.js%26metricKeys%3Dvulnerabilities&query=%24.component.measures.0.value&style=for-the-badge&logo=sonarcloud&logoColor=white&labelColor=464646&label=Vulnerabilities&color=gold"></a>
10
10
  <a href="https://github.com/toolleeo/cli-apps#networking"><img height=31 src="https://img.shields.io/badge/Mentioned_in-Awesome-c4a2bd?logo=awesomelists&logoColor=white&labelColor=464646&style=for-the-badge"></a>
11
11
  <a href="https://www.jsdelivr.com/package/npm/generate-ip?tab=stats"><img height=31 src="https://img.shields.io/jsdelivr/npm/hm/generate-ip?style=for-the-badge&logo=jsdelivr&logoColor=white&label=jsDelivr%20Hits&labelColor=464646&color=49c5d8"></a>
@@ -72,14 +72,14 @@ const { ipv4, ipv6 } = require('generate-ip');
72
72
  #### <> HTML script tag:
73
73
 
74
74
  ```html
75
- <script src="https://cdn.jsdelivr.net/npm/generate-ip@2.2.6/dist/generate-ip.min.js"></script>
75
+ <script src="https://cdn.jsdelivr.net/npm/generate-ip@2.2.8/dist/generate-ip.min.js"></script>
76
76
  ```
77
77
 
78
78
  #### ES6:
79
79
 
80
80
  ```js
81
81
  (async () => {
82
- await import('https://cdn.jsdelivr.net/npm/generate-ip@2.2.6/dist/generate-ip.min.js');
82
+ await import('https://cdn.jsdelivr.net/npm/generate-ip@2.2.8/dist/generate-ip.min.js');
83
83
  // Your code here...
84
84
  })();
85
85
  ```
@@ -88,7 +88,7 @@ const { ipv4, ipv6 } = require('generate-ip');
88
88
 
89
89
  ```js
90
90
  ...
91
- // @require https://cdn.jsdelivr.net/npm/generate-ip@2.2.6/dist/generate-ip.min.js
91
+ // @require https://cdn.jsdelivr.net/npm/generate-ip@2.2.8/dist/generate-ip.min.js
92
92
  // ==/UserScript==
93
93
 
94
94
  // Your code here...
@@ -96,7 +96,7 @@ const { ipv4, ipv6 } = require('generate-ip');
96
96
 
97
97
  <br>
98
98
 
99
- 📝 **Note:** To always import the latest version (not recommended in production!) remove the `@2.2.6` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-ip/dist/generate-ip.min.js`
99
+ 📝 **Note:** To always import the latest version (not recommended in production!) remove the `@2.2.8` version tag from the jsDelivr URL: `https://cdn.jsdelivr.net/npm/generate-ip/dist/generate-ip.min.js`
100
100
 
101
101
  <br>
102
102
 
@@ -215,13 +215,13 @@ Name | Type | Description | Default Value
215
215
  #
216
216
 
217
217
 
218
- #### `ipv6.format(address[, options])`
218
+ #### `ipv6.format(ipv6address[, options])`
219
219
 
220
220
  Formats an IPv6 address according to `options` passed, returning a string:
221
221
 
222
222
  ```js
223
- const address = '0d::ffff:192.1.56.10/96',
224
- formattedAddress = ipv6.format(address, { leadingZeros: true, doubleColon: false });
223
+ const ipv6address = '0d::ffff:192.1.56.10/96',
224
+ formattedAddress = ipv6.format(ipv6address, { leadingZeros: true, doubleColon: false });
225
225
 
226
226
  console.log(formattedAddress);
227
227
 
@@ -321,14 +321,14 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
321
321
 
322
322
  ## 🛠️ Related utilities
323
323
 
324
- ### [🔒 generate-pw](../generate-pw)
324
+ ### [🔒 generate-pw](../generate-pw) <a href="https://github.com/toolleeo/cli-apps#password-managers"><img height=18 src="https://awesome.re/mentioned-badge.svg"></a>
325
325
 
326
326
  > Randomly generate, strengthen, and validate cryptographically-secure passwords.
327
327
  <br>[Install](https://docs.js-utils.com/generate-pw/#-installation) /
328
328
  [Readme](https://docs.js-utils.com/generate-pw/#readme) /
329
329
  [API usage](https://docs.js-utils.com/generate-pw/#-api-usage) /
330
330
  [CLI usage](https://docs.js-utils.com/generate-pw/#-command-line-usage) /
331
- [Discuss](https://js-utils.com/discussions)
331
+ [Discuss](https://github.js-utils.com/discussions)
332
332
 
333
333
  ### <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/geolocate/media/images/icons/wire-globe/white/icon32.png"><img height=22 src="https://raw.githubusercontent.com/adamlui/js-utils/main/geolocate/media/images/icons/wire-globe/black/icon32.png"></picture> [geolocate](https://js-utils.com/geolocate)
334
334
 
@@ -337,12 +337,12 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
337
337
  [Readme](https://docs.js-utils.com/geolocate/#readme) /
338
338
  [CLI usage](https://docs.js-utils.com/geolocate/#-command-line-usage) /
339
339
  [API usage](https://docs.js-utils.com/geolocate/#-api-usage) /
340
- [Discuss](https://js-utils.com/discussions)
340
+ [Discuss](https://github.js-utils.com/discussions)
341
341
 
342
342
  <br>
343
343
 
344
344
  <img height=6px width="100%" src="https://raw.githubusercontent.com/adamlui/js-utils/main/docs/images/aqua-separator.png">
345
345
 
346
346
  <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/adamlui/js-utils/main/media/images/icons/home/white/icon32x27.png"><img height=13 src="https://raw.githubusercontent.com/adamlui/js-utils/main/media/images/icons/home/dark-gray/icon32x27.png"></picture> <a href="https://js-utils.com">**More JavaScript utilities**</a> /
347
- <a href="https://js-utils.com/discussions">Discuss</a> /
347
+ <a href="https://github.js-utils.com/discussions">Discuss</a> /
348
348
  <a href="#-generate-ip">Back to top ↑</a>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "generate-ip",
3
- "version": "2.2.6",
3
+ "version": "2.2.8",
4
4
  "description": "Randomly generate, format, and validate IPv4/IPv6 addresses.",
5
5
  "author": {
6
6
  "name": "Adam Lui",
@@ -56,6 +56,6 @@
56
56
  "url": "https://github.com/sponsors/adamlui"
57
57
  },
58
58
  "devDependencies": {
59
- "@adamlui/minify.js": "^1.5.3"
59
+ "@adamlui/minify.js": "^1.5.4"
60
60
  }
61
61
  }