gstatx 0.2.0 → 0.2.2
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.
- package/dist/index.js +26 -26
- package/package.json +2 -2
package/dist/index.js
CHANGED
|
@@ -1,40 +1,40 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{createRequire as W1}from"node:module";var
|
|
3
|
-
`)}displayWidth($){return p($).length}styleTitle($){return $}styleUsage($){return $.split(" ").map((q)=>{if(q==="[options]")return this.styleOptionText(q);if(q==="[command]")return this.styleSubcommandText(q);if(q[0]==="["||q[0]==="<")return this.styleArgumentText(q);return this.styleCommandText(q)}).join(" ")}styleCommandDescription($){return this.styleDescriptionText($)}styleOptionDescription($){return this.styleDescriptionText($)}styleSubcommandDescription($){return this.styleDescriptionText($)}styleArgumentDescription($){return this.styleDescriptionText($)}styleDescriptionText($){return $}styleOptionTerm($){return this.styleOptionText($)}styleSubcommandTerm($){return $.split(" ").map((q)=>{if(q==="[options]")return this.styleOptionText(q);if(q[0]==="["||q[0]==="<")return this.styleArgumentText(q);return this.styleSubcommandText(q)}).join(" ")}styleArgumentTerm($){return this.styleArgumentText($)}styleOptionText($){return $}styleArgumentText($){return $}styleSubcommandText($){return $}styleCommandText($){return $}padWidth($,q){return Math.max(q.longestOptionTermLength($,q),q.longestGlobalOptionTermLength($,q),q.longestSubcommandTermLength($,q),q.longestArgumentTermLength($,q))}preformatted($){return/\n[^\S\r\n]/.test($)}formatItem($,q,J
|
|
4
|
-
`+" ".repeat(q+Z));return X+Y+" ".repeat(Z)+
|
|
5
|
-
${X}`)}boxWrap($,q){if(q<this.minWidthToWrap)return $;let
|
|
6
|
-
`)}}function p($){let q=/\x1b\[\d*(;\d*)*m/g;return $.replace(q,"")}A1.Help=d;A1.stripColor=p});var P=U((b1)=>{var{InvalidArgumentError:O1}=E();class i{constructor($,q){this.flags=$,this.description=q||"",this.required=$.includes("<"),this.optional=$.includes("["),this.variadic=/\w\.\.\.[>\]]$/.test($),this.mandatory=!1;let
|
|
2
|
+
import{createRequire as W1}from"node:module";var M1=Object.create;var{getPrototypeOf:L1,defineProperty:l,getOwnPropertyNames:U1}=Object;var S1=Object.prototype.hasOwnProperty;var K1=($,q,z)=>{z=$!=null?M1(L1($)):{};let J=q||!$||!$.__esModule?l(z,"default",{value:$,enumerable:!0}):z;for(let Q of U1($))if(!S1.call(J,Q))l(J,Q,{get:()=>$[Q],enumerable:!0});return J};var U=($,q)=>()=>(q||$((q={exports:{}}).exports,q),q.exports);var I=W1(import.meta.url);var E=U((j1)=>{class w extends Error{constructor($,q,z){super(z);Error.captureStackTrace(this,this.constructor),this.name=this.constructor.name,this.code=q,this.exitCode=$,this.nestedError=void 0}}class c extends w{constructor($){super(1,"commander.invalidArgument",$);Error.captureStackTrace(this,this.constructor),this.name=this.constructor.name}}j1.CommanderError=w;j1.InvalidArgumentError=c});var y=U((N1)=>{var{InvalidArgumentError:V1}=E();class m{constructor($,q){switch(this.description=q||"",this.variadic=!1,this.parseArg=void 0,this.defaultValue=void 0,this.defaultValueDescription=void 0,this.argChoices=void 0,$[0]){case"<":this.required=!0,this._name=$.slice(1,-1);break;case"[":this.required=!1,this._name=$.slice(1,-1);break;default:this.required=!0,this._name=$;break}if(this._name.endsWith("..."))this.variadic=!0,this._name=this._name.slice(0,-3)}name(){return this._name}_collectValue($,q){if(q===this.defaultValue||!Array.isArray(q))return[$];return q.push($),q}default($,q){return this.defaultValue=$,this.defaultValueDescription=q,this}argParser($){return this.parseArg=$,this}choices($){return this.argChoices=$.slice(),this.parseArg=(q,z)=>{if(!this.argChoices.includes(q))throw new V1(`Allowed choices are ${this.argChoices.join(", ")}.`);if(this.variadic)return this._collectValue(q,z);return q},this}argRequired(){return this.required=!0,this}argOptional(){return this.required=!1,this}}function D1($){let q=$.name()+($.variadic===!0?"...":"");return $.required?"<"+q+">":"["+q+"]"}N1.Argument=m;N1.humanReadableArgName=D1});var A=U((A1)=>{var{humanReadableArgName:w1}=y();class d{constructor(){this.helpWidth=void 0,this.minWidthToWrap=40,this.sortSubcommands=!1,this.sortOptions=!1,this.showGlobalOptions=!1}prepareContext($){this.helpWidth=this.helpWidth??$.helpWidth??80}visibleCommands($){let q=$.commands.filter((J)=>!J._hidden),z=$._getHelpCommand();if(z&&!z._hidden)q.push(z);if(this.sortSubcommands)q.sort((J,Q)=>{return J.name().localeCompare(Q.name())});return q}compareOptions($,q){let z=(J)=>{return J.short?J.short.replace(/^-/,""):J.long.replace(/^--/,"")};return z($).localeCompare(z(q))}visibleOptions($){let q=$.options.filter((J)=>!J.hidden),z=$._getHelpOption();if(z&&!z.hidden){let J=z.short&&$._findOption(z.short),Q=z.long&&$._findOption(z.long);if(!J&&!Q)q.push(z);else if(z.long&&!Q)q.push($.createOption(z.long,z.description));else if(z.short&&!J)q.push($.createOption(z.short,z.description))}if(this.sortOptions)q.sort(this.compareOptions);return q}visibleGlobalOptions($){if(!this.showGlobalOptions)return[];let q=[];for(let z=$.parent;z;z=z.parent){let J=z.options.filter((Q)=>!Q.hidden);q.push(...J)}if(this.sortOptions)q.sort(this.compareOptions);return q}visibleArguments($){if($._argsDescription)$.registeredArguments.forEach((q)=>{q.description=q.description||$._argsDescription[q.name()]||""});if($.registeredArguments.find((q)=>q.description))return $.registeredArguments;return[]}subcommandTerm($){let q=$.registeredArguments.map((z)=>w1(z)).join(" ");return $._name+($._aliases[0]?"|"+$._aliases[0]:"")+($.options.length?" [options]":"")+(q?" "+q:"")}optionTerm($){return $.flags}argumentTerm($){return $.name()}longestSubcommandTermLength($,q){return q.visibleCommands($).reduce((z,J)=>{return Math.max(z,this.displayWidth(q.styleSubcommandTerm(q.subcommandTerm(J))))},0)}longestOptionTermLength($,q){return q.visibleOptions($).reduce((z,J)=>{return Math.max(z,this.displayWidth(q.styleOptionTerm(q.optionTerm(J))))},0)}longestGlobalOptionTermLength($,q){return q.visibleGlobalOptions($).reduce((z,J)=>{return Math.max(z,this.displayWidth(q.styleOptionTerm(q.optionTerm(J))))},0)}longestArgumentTermLength($,q){return q.visibleArguments($).reduce((z,J)=>{return Math.max(z,this.displayWidth(q.styleArgumentTerm(q.argumentTerm(J))))},0)}commandUsage($){let q=$._name;if($._aliases[0])q=q+"|"+$._aliases[0];let z="";for(let J=$.parent;J;J=J.parent)z=J.name()+" "+z;return z+q+" "+$.usage()}commandDescription($){return $.description()}subcommandDescription($){return $.summary()||$.description()}optionDescription($){let q=[];if($.argChoices)q.push(`choices: ${$.argChoices.map((z)=>JSON.stringify(z)).join(", ")}`);if($.defaultValue!==void 0){if($.required||$.optional||$.isBoolean()&&typeof $.defaultValue==="boolean")q.push(`default: ${$.defaultValueDescription||JSON.stringify($.defaultValue)}`)}if($.presetArg!==void 0&&$.optional)q.push(`preset: ${JSON.stringify($.presetArg)}`);if($.envVar!==void 0)q.push(`env: ${$.envVar}`);if(q.length>0){let z=`(${q.join(", ")})`;if($.description)return`${$.description} ${z}`;return z}return $.description}argumentDescription($){let q=[];if($.argChoices)q.push(`choices: ${$.argChoices.map((z)=>JSON.stringify(z)).join(", ")}`);if($.defaultValue!==void 0)q.push(`default: ${$.defaultValueDescription||JSON.stringify($.defaultValue)}`);if(q.length>0){let z=`(${q.join(", ")})`;if($.description)return`${$.description} ${z}`;return z}return $.description}formatItemList($,q,z){if(q.length===0)return[];return[z.styleTitle($),...q,""]}groupItems($,q,z){let J=new Map;return $.forEach((Q)=>{let X=z(Q);if(!J.has(X))J.set(X,[])}),q.forEach((Q)=>{let X=z(Q);if(!J.has(X))J.set(X,[]);J.get(X).push(Q)}),J}formatHelp($,q){let z=q.padWidth($,q),J=q.helpWidth??80;function Q(R,B){return q.formatItem(R,z,B,q)}let X=[`${q.styleTitle("Usage:")} ${q.styleUsage(q.commandUsage($))}`,""],Y=q.commandDescription($);if(Y.length>0)X=X.concat([q.boxWrap(q.styleCommandDescription(Y),J),""]);let Z=q.visibleArguments($).map((R)=>{return Q(q.styleArgumentTerm(q.argumentTerm(R)),q.styleArgumentDescription(q.argumentDescription(R)))});if(X=X.concat(this.formatItemList("Arguments:",Z,q)),this.groupItems($.options,q.visibleOptions($),(R)=>R.helpGroupHeading??"Options:").forEach((R,B)=>{let G=R.map((M)=>{return Q(q.styleOptionTerm(q.optionTerm(M)),q.styleOptionDescription(q.optionDescription(M)))});X=X.concat(this.formatItemList(B,G,q))}),q.showGlobalOptions){let R=q.visibleGlobalOptions($).map((B)=>{return Q(q.styleOptionTerm(q.optionTerm(B)),q.styleOptionDescription(q.optionDescription(B)))});X=X.concat(this.formatItemList("Global Options:",R,q))}return this.groupItems($.commands,q.visibleCommands($),(R)=>R.helpGroup()||"Commands:").forEach((R,B)=>{let G=R.map((M)=>{return Q(q.styleSubcommandTerm(q.subcommandTerm(M)),q.styleSubcommandDescription(q.subcommandDescription(M)))});X=X.concat(this.formatItemList(B,G,q))}),X.join(`
|
|
3
|
+
`)}displayWidth($){return p($).length}styleTitle($){return $}styleUsage($){return $.split(" ").map((q)=>{if(q==="[options]")return this.styleOptionText(q);if(q==="[command]")return this.styleSubcommandText(q);if(q[0]==="["||q[0]==="<")return this.styleArgumentText(q);return this.styleCommandText(q)}).join(" ")}styleCommandDescription($){return this.styleDescriptionText($)}styleOptionDescription($){return this.styleDescriptionText($)}styleSubcommandDescription($){return this.styleDescriptionText($)}styleArgumentDescription($){return this.styleDescriptionText($)}styleDescriptionText($){return $}styleOptionTerm($){return this.styleOptionText($)}styleSubcommandTerm($){return $.split(" ").map((q)=>{if(q==="[options]")return this.styleOptionText(q);if(q[0]==="["||q[0]==="<")return this.styleArgumentText(q);return this.styleSubcommandText(q)}).join(" ")}styleArgumentTerm($){return this.styleArgumentText($)}styleOptionText($){return $}styleArgumentText($){return $}styleSubcommandText($){return $}styleCommandText($){return $}padWidth($,q){return Math.max(q.longestOptionTermLength($,q),q.longestGlobalOptionTermLength($,q),q.longestSubcommandTermLength($,q),q.longestArgumentTermLength($,q))}preformatted($){return/\n[^\S\r\n]/.test($)}formatItem($,q,z,J){let X=" ".repeat(2);if(!z)return X+$;let Y=$.padEnd(q+$.length-J.displayWidth($)),Z=2,H=(this.helpWidth??80)-q-Z-2,R;if(H<this.minWidthToWrap||J.preformatted(z))R=z;else R=J.boxWrap(z,H).replace(/\n/g,`
|
|
4
|
+
`+" ".repeat(q+Z));return X+Y+" ".repeat(Z)+R.replace(/\n/g,`
|
|
5
|
+
${X}`)}boxWrap($,q){if(q<this.minWidthToWrap)return $;let z=$.split(/\r\n|\n/),J=/[\s]*[^\s]+/g,Q=[];return z.forEach((X)=>{let Y=X.match(J);if(Y===null){Q.push("");return}let Z=[Y.shift()],T=this.displayWidth(Z[0]);Y.forEach((H)=>{let R=this.displayWidth(H);if(T+R<=q){Z.push(H),T+=R;return}Q.push(Z.join(""));let B=H.trimStart();Z=[B],T=this.displayWidth(B)}),Q.push(Z.join(""))}),Q.join(`
|
|
6
|
+
`)}}function p($){let q=/\x1b\[\d*(;\d*)*m/g;return $.replace(q,"")}A1.Help=d;A1.stripColor=p});var P=U((b1)=>{var{InvalidArgumentError:O1}=E();class i{constructor($,q){this.flags=$,this.description=q||"",this.required=$.includes("<"),this.optional=$.includes("["),this.variadic=/\w\.\.\.[>\]]$/.test($),this.mandatory=!1;let z=x1($);if(this.short=z.shortFlag,this.long=z.longFlag,this.negate=!1,this.long)this.negate=this.long.startsWith("--no-");this.defaultValue=void 0,this.defaultValueDescription=void 0,this.presetArg=void 0,this.envVar=void 0,this.parseArg=void 0,this.hidden=!1,this.argChoices=void 0,this.conflictsWith=[],this.implied=void 0,this.helpGroupHeading=void 0}default($,q){return this.defaultValue=$,this.defaultValueDescription=q,this}preset($){return this.presetArg=$,this}conflicts($){return this.conflictsWith=this.conflictsWith.concat($),this}implies($){let q=$;if(typeof $==="string")q={[$]:!0};return this.implied=Object.assign(this.implied||{},q),this}env($){return this.envVar=$,this}argParser($){return this.parseArg=$,this}makeOptionMandatory($=!0){return this.mandatory=!!$,this}hideHelp($=!0){return this.hidden=!!$,this}_collectValue($,q){if(q===this.defaultValue||!Array.isArray(q))return[$];return q.push($),q}choices($){return this.argChoices=$.slice(),this.parseArg=(q,z)=>{if(!this.argChoices.includes(q))throw new O1(`Allowed choices are ${this.argChoices.join(", ")}.`);if(this.variadic)return this._collectValue(q,z);return q},this}name(){if(this.long)return this.long.replace(/^--/,"");return this.short.replace(/^-/,"")}attributeName(){if(this.negate)return s(this.name().replace(/^no-/,""));return s(this.name())}helpGroup($){return this.helpGroupHeading=$,this}is($){return this.short===$||this.long===$}isBoolean(){return!this.required&&!this.optional&&!this.negate}}class t{constructor($){this.positiveOptions=new Map,this.negativeOptions=new Map,this.dualOptions=new Set,$.forEach((q)=>{if(q.negate)this.negativeOptions.set(q.attributeName(),q);else this.positiveOptions.set(q.attributeName(),q)}),this.negativeOptions.forEach((q,z)=>{if(this.positiveOptions.has(z))this.dualOptions.add(z)})}valueFromOption($,q){let z=q.attributeName();if(!this.dualOptions.has(z))return!0;let J=this.negativeOptions.get(z).presetArg,Q=J!==void 0?J:!1;return q.negate===(Q===$)}}function s($){return $.split("-").reduce((q,z)=>{return q+z[0].toUpperCase()+z.slice(1)})}function x1($){let q,z,J=/^-[^-]$/,Q=/^--[^-]/,X=$.split(/[ |,]+/).concat("guard");if(J.test(X[0]))q=X.shift();if(Q.test(X[0]))z=X.shift();if(!q&&J.test(X[0]))q=X.shift();if(!q&&Q.test(X[0]))q=z,z=X.shift();if(X[0].startsWith("-")){let Y=X[0],Z=`option creation failed due to '${Y}' in option flags '${$}'`;if(/^-[^-][^-]/.test(Y))throw new Error(`${Z}
|
|
7
7
|
- a short flag is a single dash and a single character
|
|
8
8
|
- either use a single dash and a single character (for a short flag)
|
|
9
|
-
- or use a double dash for a long option (and can have two, like '--ws, --workspace')`);if(
|
|
9
|
+
- or use a double dash for a long option (and can have two, like '--ws, --workspace')`);if(J.test(Y))throw new Error(`${Z}
|
|
10
10
|
- too many short flags`);if(Q.test(Y))throw new Error(`${Z}
|
|
11
11
|
- too many long flags`);throw new Error(`${Z}
|
|
12
|
-
- unrecognised flag format`)}if(q===void 0&&
|
|
13
|
-
(Did you mean one of ${
|
|
14
|
-
(Did you mean ${
|
|
15
|
-
- specify the name in Command constructor or using .name()`);if(q=q||{},q.isDefault)this._defaultCommandName=$._name;if(q.noHelp||q.hidden)$._hidden=!0;return this._registerCommand($),$.parent=this,$._checkForBrokenPassThrough(),this}createArgument($,q){return new c1($,q)}argument($,q,J
|
|
16
|
-
Expecting one of '${
|
|
17
|
-
- already used by option '${q.flags}'`)}this._initOptionGroup($),this.options.push($)}_registerCommand($){let q=(
|
|
18
|
-
- either make a new Command for each call to parse, or stop storing options as properties`);this._name=this._savedState._name,this._scriptPath=null,this.rawArgs=[],this._optionValues={...this._savedState._optionValues},this._optionValueSources={...this._savedState._optionValueSources},this.args=[],this.processedArgs=[]}_checkForMissingExecutable($,q,
|
|
19
|
-
- if '${
|
|
12
|
+
- unrecognised flag format`)}if(q===void 0&&z===void 0)throw new Error(`option creation failed due to no flags found in '${$}'.`);return{shortFlag:q,longFlag:z}}b1.Option=i;b1.DualOptions=t});var n=U((u1)=>{function v1($,q){if(Math.abs($.length-q.length)>3)return Math.max($.length,q.length);let z=[];for(let J=0;J<=$.length;J++)z[J]=[J];for(let J=0;J<=q.length;J++)z[0][J]=J;for(let J=1;J<=q.length;J++)for(let Q=1;Q<=$.length;Q++){let X=1;if($[Q-1]===q[J-1])X=0;else X=1;if(z[Q][J]=Math.min(z[Q-1][J]+1,z[Q][J-1]+1,z[Q-1][J-1]+X),Q>1&&J>1&&$[Q-1]===q[J-2]&&$[Q-2]===q[J-1])z[Q][J]=Math.min(z[Q][J],z[Q-2][J-2]+1)}return z[$.length][q.length]}function h1($,q){if(!q||q.length===0)return"";q=Array.from(new Set(q));let z=$.startsWith("--");if(z)$=$.slice(2),q=q.map((Y)=>Y.slice(2));let J=[],Q=3,X=0.4;if(q.forEach((Y)=>{if(Y.length<=1)return;let Z=v1($,Y),T=Math.max($.length,Y.length);if((T-Z)/T>X){if(Z<Q)Q=Z,J=[Y];else if(Z===Q)J.push(Y)}}),J.sort((Y,Z)=>Y.localeCompare(Z)),z)J=J.map((Y)=>`--${Y}`);if(J.length>1)return`
|
|
13
|
+
(Did you mean one of ${J.join(", ")}?)`;if(J.length===1)return`
|
|
14
|
+
(Did you mean ${J[0]}?)`;return""}u1.suggestSimilar=h1});var e=U((i1)=>{var l1=I("node:events").EventEmitter,k=I("node:child_process"),L=I("node:path"),F=I("node:fs"),_=I("node:process"),{Argument:c1,humanReadableArgName:m1}=y(),{CommanderError:O}=E(),{Help:d1,stripColor:p1}=A(),{Option:r,DualOptions:s1}=P(),{suggestSimilar:a}=n();class b extends l1{constructor($){super();this.commands=[],this.options=[],this.parent=null,this._allowUnknownOption=!1,this._allowExcessArguments=!1,this.registeredArguments=[],this._args=this.registeredArguments,this.args=[],this.rawArgs=[],this.processedArgs=[],this._scriptPath=null,this._name=$||"",this._optionValues={},this._optionValueSources={},this._storeOptionsAsProperties=!1,this._actionHandler=null,this._executableHandler=!1,this._executableFile=null,this._executableDir=null,this._defaultCommandName=null,this._exitCallback=null,this._aliases=[],this._combineFlagAndOptionalValue=!0,this._description="",this._summary="",this._argsDescription=void 0,this._enablePositionalOptions=!1,this._passThroughOptions=!1,this._lifeCycleHooks={},this._showHelpAfterError=!1,this._showSuggestionAfterError=!0,this._savedState=null,this._outputConfiguration={writeOut:(q)=>_.stdout.write(q),writeErr:(q)=>_.stderr.write(q),outputError:(q,z)=>z(q),getOutHelpWidth:()=>_.stdout.isTTY?_.stdout.columns:void 0,getErrHelpWidth:()=>_.stderr.isTTY?_.stderr.columns:void 0,getOutHasColors:()=>x()??(_.stdout.isTTY&&_.stdout.hasColors?.()),getErrHasColors:()=>x()??(_.stderr.isTTY&&_.stderr.hasColors?.()),stripColor:(q)=>p1(q)},this._hidden=!1,this._helpOption=void 0,this._addImplicitHelpCommand=void 0,this._helpCommand=void 0,this._helpConfiguration={},this._helpGroupHeading=void 0,this._defaultCommandGroup=void 0,this._defaultOptionGroup=void 0}copyInheritedSettings($){return this._outputConfiguration=$._outputConfiguration,this._helpOption=$._helpOption,this._helpCommand=$._helpCommand,this._helpConfiguration=$._helpConfiguration,this._exitCallback=$._exitCallback,this._storeOptionsAsProperties=$._storeOptionsAsProperties,this._combineFlagAndOptionalValue=$._combineFlagAndOptionalValue,this._allowExcessArguments=$._allowExcessArguments,this._enablePositionalOptions=$._enablePositionalOptions,this._showHelpAfterError=$._showHelpAfterError,this._showSuggestionAfterError=$._showSuggestionAfterError,this}_getCommandAndAncestors(){let $=[];for(let q=this;q;q=q.parent)$.push(q);return $}command($,q,z){let J=q,Q=z;if(typeof J==="object"&&J!==null)Q=J,J=null;Q=Q||{};let[,X,Y]=$.match(/([^ ]+) *(.*)/),Z=this.createCommand(X);if(J)Z.description(J),Z._executableHandler=!0;if(Q.isDefault)this._defaultCommandName=Z._name;if(Z._hidden=!!(Q.noHelp||Q.hidden),Z._executableFile=Q.executableFile||null,Y)Z.arguments(Y);if(this._registerCommand(Z),Z.parent=this,Z.copyInheritedSettings(this),J)return this;return Z}createCommand($){return new b($)}createHelp(){return Object.assign(new d1,this.configureHelp())}configureHelp($){if($===void 0)return this._helpConfiguration;return this._helpConfiguration=$,this}configureOutput($){if($===void 0)return this._outputConfiguration;return this._outputConfiguration={...this._outputConfiguration,...$},this}showHelpAfterError($=!0){if(typeof $!=="string")$=!!$;return this._showHelpAfterError=$,this}showSuggestionAfterError($=!0){return this._showSuggestionAfterError=!!$,this}addCommand($,q){if(!$._name)throw new Error(`Command passed to .addCommand() must have a name
|
|
15
|
+
- specify the name in Command constructor or using .name()`);if(q=q||{},q.isDefault)this._defaultCommandName=$._name;if(q.noHelp||q.hidden)$._hidden=!0;return this._registerCommand($),$.parent=this,$._checkForBrokenPassThrough(),this}createArgument($,q){return new c1($,q)}argument($,q,z,J){let Q=this.createArgument($,q);if(typeof z==="function")Q.default(J).argParser(z);else Q.default(z);return this.addArgument(Q),this}arguments($){return $.trim().split(/ +/).forEach((q)=>{this.argument(q)}),this}addArgument($){let q=this.registeredArguments.slice(-1)[0];if(q?.variadic)throw new Error(`only the last argument can be variadic '${q.name()}'`);if($.required&&$.defaultValue!==void 0&&$.parseArg===void 0)throw new Error(`a default value for a required argument is never used: '${$.name()}'`);return this.registeredArguments.push($),this}helpCommand($,q){if(typeof $==="boolean"){if(this._addImplicitHelpCommand=$,$&&this._defaultCommandGroup)this._initCommandGroup(this._getHelpCommand());return this}let z=$??"help [command]",[,J,Q]=z.match(/([^ ]+) *(.*)/),X=q??"display help for command",Y=this.createCommand(J);if(Y.helpOption(!1),Q)Y.arguments(Q);if(X)Y.description(X);if(this._addImplicitHelpCommand=!0,this._helpCommand=Y,$||q)this._initCommandGroup(Y);return this}addHelpCommand($,q){if(typeof $!=="object")return this.helpCommand($,q),this;return this._addImplicitHelpCommand=!0,this._helpCommand=$,this._initCommandGroup($),this}_getHelpCommand(){if(this._addImplicitHelpCommand??(this.commands.length&&!this._actionHandler&&!this._findCommand("help"))){if(this._helpCommand===void 0)this.helpCommand(void 0,void 0);return this._helpCommand}return null}hook($,q){let z=["preSubcommand","preAction","postAction"];if(!z.includes($))throw new Error(`Unexpected value for event passed to hook : '${$}'.
|
|
16
|
+
Expecting one of '${z.join("', '")}'`);if(this._lifeCycleHooks[$])this._lifeCycleHooks[$].push(q);else this._lifeCycleHooks[$]=[q];return this}exitOverride($){if($)this._exitCallback=$;else this._exitCallback=(q)=>{if(q.code!=="commander.executeSubCommandAsync")throw q};return this}_exit($,q,z){if(this._exitCallback)this._exitCallback(new O($,q,z));_.exit($)}action($){let q=(z)=>{let J=this.registeredArguments.length,Q=z.slice(0,J);if(this._storeOptionsAsProperties)Q[J]=this;else Q[J]=this.opts();return Q.push(this),$.apply(this,Q)};return this._actionHandler=q,this}createOption($,q){return new r($,q)}_callParseArg($,q,z,J){try{return $.parseArg(q,z)}catch(Q){if(Q.code==="commander.invalidArgument"){let X=`${J} ${Q.message}`;this.error(X,{exitCode:Q.exitCode,code:Q.code})}throw Q}}_registerOption($){let q=$.short&&this._findOption($.short)||$.long&&this._findOption($.long);if(q){let z=$.long&&this._findOption($.long)?$.long:$.short;throw new Error(`Cannot add option '${$.flags}'${this._name&&` to command '${this._name}'`} due to conflicting flag '${z}'
|
|
17
|
+
- already used by option '${q.flags}'`)}this._initOptionGroup($),this.options.push($)}_registerCommand($){let q=(J)=>{return[J.name()].concat(J.aliases())},z=q($).find((J)=>this._findCommand(J));if(z){let J=q(this._findCommand(z)).join("|"),Q=q($).join("|");throw new Error(`cannot add command '${Q}' as already have command '${J}'`)}this._initCommandGroup($),this.commands.push($)}addOption($){this._registerOption($);let q=$.name(),z=$.attributeName();if($.negate){let Q=$.long.replace(/^--no-/,"--");if(!this._findOption(Q))this.setOptionValueWithSource(z,$.defaultValue===void 0?!0:$.defaultValue,"default")}else if($.defaultValue!==void 0)this.setOptionValueWithSource(z,$.defaultValue,"default");let J=(Q,X,Y)=>{if(Q==null&&$.presetArg!==void 0)Q=$.presetArg;let Z=this.getOptionValue(z);if(Q!==null&&$.parseArg)Q=this._callParseArg($,Q,Z,X);else if(Q!==null&&$.variadic)Q=$._collectValue(Q,Z);if(Q==null)if($.negate)Q=!1;else if($.isBoolean()||$.optional)Q=!0;else Q="";this.setOptionValueWithSource(z,Q,Y)};if(this.on("option:"+q,(Q)=>{let X=`error: option '${$.flags}' argument '${Q}' is invalid.`;J(Q,X,"cli")}),$.envVar)this.on("optionEnv:"+q,(Q)=>{let X=`error: option '${$.flags}' value '${Q}' from env '${$.envVar}' is invalid.`;J(Q,X,"env")});return this}_optionEx($,q,z,J,Q){if(typeof q==="object"&&q instanceof r)throw new Error("To add an Option object use addOption() instead of option() or requiredOption()");let X=this.createOption(q,z);if(X.makeOptionMandatory(!!$.mandatory),typeof J==="function")X.default(Q).argParser(J);else if(J instanceof RegExp){let Y=J;J=(Z,T)=>{let H=Y.exec(Z);return H?H[0]:T},X.default(Q).argParser(J)}else X.default(J);return this.addOption(X)}option($,q,z,J){return this._optionEx({},$,q,z,J)}requiredOption($,q,z,J){return this._optionEx({mandatory:!0},$,q,z,J)}combineFlagAndOptionalValue($=!0){return this._combineFlagAndOptionalValue=!!$,this}allowUnknownOption($=!0){return this._allowUnknownOption=!!$,this}allowExcessArguments($=!0){return this._allowExcessArguments=!!$,this}enablePositionalOptions($=!0){return this._enablePositionalOptions=!!$,this}passThroughOptions($=!0){return this._passThroughOptions=!!$,this._checkForBrokenPassThrough(),this}_checkForBrokenPassThrough(){if(this.parent&&this._passThroughOptions&&!this.parent._enablePositionalOptions)throw new Error(`passThroughOptions cannot be used for '${this._name}' without turning on enablePositionalOptions for parent command(s)`)}storeOptionsAsProperties($=!0){if(this.options.length)throw new Error("call .storeOptionsAsProperties() before adding options");if(Object.keys(this._optionValues).length)throw new Error("call .storeOptionsAsProperties() before setting option values");return this._storeOptionsAsProperties=!!$,this}getOptionValue($){if(this._storeOptionsAsProperties)return this[$];return this._optionValues[$]}setOptionValue($,q){return this.setOptionValueWithSource($,q,void 0)}setOptionValueWithSource($,q,z){if(this._storeOptionsAsProperties)this[$]=q;else this._optionValues[$]=q;return this._optionValueSources[$]=z,this}getOptionValueSource($){return this._optionValueSources[$]}getOptionValueSourceWithGlobals($){let q;return this._getCommandAndAncestors().forEach((z)=>{if(z.getOptionValueSource($)!==void 0)q=z.getOptionValueSource($)}),q}_prepareUserArgs($,q){if($!==void 0&&!Array.isArray($))throw new Error("first parameter to parse must be array or undefined");if(q=q||{},$===void 0&&q.from===void 0){if(_.versions?.electron)q.from="electron";let J=_.execArgv??[];if(J.includes("-e")||J.includes("--eval")||J.includes("-p")||J.includes("--print"))q.from="eval"}if($===void 0)$=_.argv;this.rawArgs=$.slice();let z;switch(q.from){case void 0:case"node":this._scriptPath=$[1],z=$.slice(2);break;case"electron":if(_.defaultApp)this._scriptPath=$[1],z=$.slice(2);else z=$.slice(1);break;case"user":z=$.slice(0);break;case"eval":z=$.slice(1);break;default:throw new Error(`unexpected parse option { from: '${q.from}' }`)}if(!this._name&&this._scriptPath)this.nameFromFilename(this._scriptPath);return this._name=this._name||"program",z}parse($,q){this._prepareForParse();let z=this._prepareUserArgs($,q);return this._parseCommand([],z),this}async parseAsync($,q){this._prepareForParse();let z=this._prepareUserArgs($,q);return await this._parseCommand([],z),this}_prepareForParse(){if(this._savedState===null)this.saveStateBeforeParse();else this.restoreStateBeforeParse()}saveStateBeforeParse(){this._savedState={_name:this._name,_optionValues:{...this._optionValues},_optionValueSources:{...this._optionValueSources}}}restoreStateBeforeParse(){if(this._storeOptionsAsProperties)throw new Error(`Can not call parse again when storeOptionsAsProperties is true.
|
|
18
|
+
- either make a new Command for each call to parse, or stop storing options as properties`);this._name=this._savedState._name,this._scriptPath=null,this.rawArgs=[],this._optionValues={...this._savedState._optionValues},this._optionValueSources={...this._savedState._optionValueSources},this.args=[],this.processedArgs=[]}_checkForMissingExecutable($,q,z){if(F.existsSync($))return;let J=q?`searched for local subcommand relative to directory '${q}'`:"no directory for search for local subcommand, use .executableDir() to supply a custom directory",Q=`'${$}' does not exist
|
|
19
|
+
- if '${z}' is not meant to be an executable command, remove description parameter from '.command()' and use '.description()' instead
|
|
20
20
|
- if the default executable name is not suitable, use the executableFile option to supply a custom name or path
|
|
21
|
-
- ${
|
|
21
|
+
- ${J}`;throw new Error(Q)}_executeSubCommand($,q){q=q.slice();let z=!1,J=[".js",".ts",".tsx",".mjs",".cjs"];function Q(H,R){let B=L.resolve(H,R);if(F.existsSync(B))return B;if(J.includes(L.extname(R)))return;let G=J.find((M)=>F.existsSync(`${B}${M}`));if(G)return`${B}${G}`;return}this._checkForMissingMandatoryOptions(),this._checkForConflictingOptions();let X=$._executableFile||`${this._name}-${$._name}`,Y=this._executableDir||"";if(this._scriptPath){let H;try{H=F.realpathSync(this._scriptPath)}catch{H=this._scriptPath}Y=L.resolve(L.dirname(H),Y)}if(Y){let H=Q(Y,X);if(!H&&!$._executableFile&&this._scriptPath){let R=L.basename(this._scriptPath,L.extname(this._scriptPath));if(R!==this._name)H=Q(Y,`${R}-${$._name}`)}X=H||X}z=J.includes(L.extname(X));let Z;if(_.platform!=="win32")if(z)q.unshift(X),q=o(_.execArgv).concat(q),Z=k.spawn(_.argv[0],q,{stdio:"inherit"});else Z=k.spawn(X,q,{stdio:"inherit"});else this._checkForMissingExecutable(X,Y,$._name),q.unshift(X),q=o(_.execArgv).concat(q),Z=k.spawn(_.execPath,q,{stdio:"inherit"});if(!Z.killed)["SIGUSR1","SIGUSR2","SIGTERM","SIGINT","SIGHUP"].forEach((R)=>{_.on(R,()=>{if(Z.killed===!1&&Z.exitCode===null)Z.kill(R)})});let T=this._exitCallback;Z.on("close",(H)=>{if(H=H??1,!T)_.exit(H);else T(new O(H,"commander.executeSubCommandAsync","(close)"))}),Z.on("error",(H)=>{if(H.code==="ENOENT")this._checkForMissingExecutable(X,Y,$._name);else if(H.code==="EACCES")throw new Error(`'${X}' not executable`);if(!T)_.exit(1);else{let R=new O(1,"commander.executeSubCommandAsync","(error)");R.nestedError=H,T(R)}}),this.runningCommand=Z}_dispatchSubcommand($,q,z){let J=this._findCommand($);if(!J)this.help({error:!0});J._prepareForParse();let Q;return Q=this._chainOrCallSubCommandHook(Q,J,"preSubcommand"),Q=this._chainOrCall(Q,()=>{if(J._executableHandler)this._executeSubCommand(J,q.concat(z));else return J._parseCommand(q,z)}),Q}_dispatchHelpCommand($){if(!$)this.help();let q=this._findCommand($);if(q&&!q._executableHandler)q.help();return this._dispatchSubcommand($,[],[this._getHelpOption()?.long??this._getHelpOption()?.short??"--help"])}_checkNumberOfArguments(){if(this.registeredArguments.forEach(($,q)=>{if($.required&&this.args[q]==null)this.missingArgument($.name())}),this.registeredArguments.length>0&&this.registeredArguments[this.registeredArguments.length-1].variadic)return;if(this.args.length>this.registeredArguments.length)this._excessArguments(this.args)}_processArguments(){let $=(z,J,Q)=>{let X=J;if(J!==null&&z.parseArg){let Y=`error: command-argument value '${J}' is invalid for argument '${z.name()}'.`;X=this._callParseArg(z,J,Q,Y)}return X};this._checkNumberOfArguments();let q=[];this.registeredArguments.forEach((z,J)=>{let Q=z.defaultValue;if(z.variadic){if(J<this.args.length){if(Q=this.args.slice(J),z.parseArg)Q=Q.reduce((X,Y)=>{return $(z,Y,X)},z.defaultValue)}else if(Q===void 0)Q=[]}else if(J<this.args.length){if(Q=this.args[J],z.parseArg)Q=$(z,Q,z.defaultValue)}q[J]=Q}),this.processedArgs=q}_chainOrCall($,q){if($?.then&&typeof $.then==="function")return $.then(()=>q());return q()}_chainOrCallHooks($,q){let z=$,J=[];if(this._getCommandAndAncestors().reverse().filter((Q)=>Q._lifeCycleHooks[q]!==void 0).forEach((Q)=>{Q._lifeCycleHooks[q].forEach((X)=>{J.push({hookedCommand:Q,callback:X})})}),q==="postAction")J.reverse();return J.forEach((Q)=>{z=this._chainOrCall(z,()=>{return Q.callback(Q.hookedCommand,this)})}),z}_chainOrCallSubCommandHook($,q,z){let J=$;if(this._lifeCycleHooks[z]!==void 0)this._lifeCycleHooks[z].forEach((Q)=>{J=this._chainOrCall(J,()=>{return Q(this,q)})});return J}_parseCommand($,q){let z=this.parseOptions(q);if(this._parseOptionsEnv(),this._parseOptionsImplied(),$=$.concat(z.operands),q=z.unknown,this.args=$.concat(q),$&&this._findCommand($[0]))return this._dispatchSubcommand($[0],$.slice(1),q);if(this._getHelpCommand()&&$[0]===this._getHelpCommand().name())return this._dispatchHelpCommand($[1]);if(this._defaultCommandName)return this._outputHelpIfRequested(q),this._dispatchSubcommand(this._defaultCommandName,$,q);if(this.commands.length&&this.args.length===0&&!this._actionHandler&&!this._defaultCommandName)this.help({error:!0});this._outputHelpIfRequested(z.unknown),this._checkForMissingMandatoryOptions(),this._checkForConflictingOptions();let J=()=>{if(z.unknown.length>0)this.unknownOption(z.unknown[0])},Q=`command:${this.name()}`;if(this._actionHandler){J(),this._processArguments();let X;if(X=this._chainOrCallHooks(X,"preAction"),X=this._chainOrCall(X,()=>this._actionHandler(this.processedArgs)),this.parent)X=this._chainOrCall(X,()=>{this.parent.emit(Q,$,q)});return X=this._chainOrCallHooks(X,"postAction"),X}if(this.parent?.listenerCount(Q))J(),this._processArguments(),this.parent.emit(Q,$,q);else if($.length){if(this._findCommand("*"))return this._dispatchSubcommand("*",$,q);if(this.listenerCount("command:*"))this.emit("command:*",$,q);else if(this.commands.length)this.unknownCommand();else J(),this._processArguments()}else if(this.commands.length)J(),this.help({error:!0});else J(),this._processArguments()}_findCommand($){if(!$)return;return this.commands.find((q)=>q._name===$||q._aliases.includes($))}_findOption($){return this.options.find((q)=>q.is($))}_checkForMissingMandatoryOptions(){this._getCommandAndAncestors().forEach(($)=>{$.options.forEach((q)=>{if(q.mandatory&&$.getOptionValue(q.attributeName())===void 0)$.missingMandatoryOptionValue(q)})})}_checkForConflictingLocalOptions(){let $=this.options.filter((z)=>{let J=z.attributeName();if(this.getOptionValue(J)===void 0)return!1;return this.getOptionValueSource(J)!=="default"});$.filter((z)=>z.conflictsWith.length>0).forEach((z)=>{let J=$.find((Q)=>z.conflictsWith.includes(Q.attributeName()));if(J)this._conflictingOption(z,J)})}_checkForConflictingOptions(){this._getCommandAndAncestors().forEach(($)=>{$._checkForConflictingLocalOptions()})}parseOptions($){let q=[],z=[],J=q;function Q(H){return H.length>1&&H[0]==="-"}let X=(H)=>{if(!/^-(\d+|\d*\.\d+)(e[+-]?\d+)?$/.test(H))return!1;return!this._getCommandAndAncestors().some((R)=>R.options.map((B)=>B.short).some((B)=>/^-\d$/.test(B)))},Y=null,Z=null,T=0;while(T<$.length||Z){let H=Z??$[T++];if(Z=null,H==="--"){if(J===z)J.push(H);J.push(...$.slice(T));break}if(Y&&(!Q(H)||X(H))){this.emit(`option:${Y.name()}`,H);continue}if(Y=null,Q(H)){let R=this._findOption(H);if(R){if(R.required){let B=$[T++];if(B===void 0)this.optionMissingArgument(R);this.emit(`option:${R.name()}`,B)}else if(R.optional){let B=null;if(T<$.length&&(!Q($[T])||X($[T])))B=$[T++];this.emit(`option:${R.name()}`,B)}else this.emit(`option:${R.name()}`);Y=R.variadic?R:null;continue}}if(H.length>2&&H[0]==="-"&&H[1]!=="-"){let R=this._findOption(`-${H[1]}`);if(R){if(R.required||R.optional&&this._combineFlagAndOptionalValue)this.emit(`option:${R.name()}`,H.slice(2));else this.emit(`option:${R.name()}`),Z=`-${H.slice(2)}`;continue}}if(/^--[^=]+=/.test(H)){let R=H.indexOf("="),B=this._findOption(H.slice(0,R));if(B&&(B.required||B.optional)){this.emit(`option:${B.name()}`,H.slice(R+1));continue}}if(J===q&&Q(H)&&!(this.commands.length===0&&X(H)))J=z;if((this._enablePositionalOptions||this._passThroughOptions)&&q.length===0&&z.length===0){if(this._findCommand(H)){q.push(H),z.push(...$.slice(T));break}else if(this._getHelpCommand()&&H===this._getHelpCommand().name()){q.push(H,...$.slice(T));break}else if(this._defaultCommandName){z.push(H,...$.slice(T));break}}if(this._passThroughOptions){J.push(H,...$.slice(T));break}J.push(H)}return{operands:q,unknown:z}}opts(){if(this._storeOptionsAsProperties){let $={},q=this.options.length;for(let z=0;z<q;z++){let J=this.options[z].attributeName();$[J]=J===this._versionOptionName?this._version:this[J]}return $}return this._optionValues}optsWithGlobals(){return this._getCommandAndAncestors().reduce(($,q)=>Object.assign($,q.opts()),{})}error($,q){if(this._outputConfiguration.outputError(`${$}
|
|
22
22
|
`,this._outputConfiguration.writeErr),typeof this._showHelpAfterError==="string")this._outputConfiguration.writeErr(`${this._showHelpAfterError}
|
|
23
23
|
`);else if(this._showHelpAfterError)this._outputConfiguration.writeErr(`
|
|
24
|
-
`),this.outputHelp({error:!0});let
|
|
25
|
-
`),this._exit(0,"commander.version",$)}),this}description($,q){if($===void 0&&q===void 0)return this._description;if(this._description=$,q)this._argsDescription=q;return this}summary($){if($===void 0)return this._summary;return this._summary=$,this}alias($){if($===void 0)return this._aliases[0];let q=this;if(this.commands.length!==0&&this.commands[this.commands.length-1]._executableHandler)q=this.commands[this.commands.length-1];if($===q._name)throw new Error("Command alias can't be the same as its name");let
|
|
26
|
-
Expecting one of '${
|
|
27
|
-
`)}),this}_outputHelpIfRequested($){let q=this._getHelpOption();if(q&&$.find((
|
|
28
|
-
`);for(let Q of
|
|
29
|
-
`)[0]||"";
|
|
30
|
-
`).filter((G)=>G.trim()),Z=null,
|
|
31
|
-
\uD83D\uDCCA Contributors for ${X.path}:`),console.log("─".repeat(60)),X.contributors.length===0)console.log(" No contributors found");else for(let Y of X.contributors)if(q)console.log(` ${Y.name} <${Y.email}> (${Y.commits} commits)`);else console.log(` ${Y.name} <${Y.email}>`)}catch(Q){console.error("Error processing repositories:",Q)}}import{writeFileSync as D2}from"node:fs";import{resolve as N2}from"node:path";async function
|
|
32
|
-
\uD83D\uDCCA Summary:`);for(let
|
|
33
|
-
Repository: ${
|
|
24
|
+
`),this.outputHelp({error:!0});let z=q||{},J=z.exitCode||1,Q=z.code||"commander.error";this._exit(J,Q,$)}_parseOptionsEnv(){this.options.forEach(($)=>{if($.envVar&&$.envVar in _.env){let q=$.attributeName();if(this.getOptionValue(q)===void 0||["default","config","env"].includes(this.getOptionValueSource(q)))if($.required||$.optional)this.emit(`optionEnv:${$.name()}`,_.env[$.envVar]);else this.emit(`optionEnv:${$.name()}`)}})}_parseOptionsImplied(){let $=new s1(this.options),q=(z)=>{return this.getOptionValue(z)!==void 0&&!["default","implied"].includes(this.getOptionValueSource(z))};this.options.filter((z)=>z.implied!==void 0&&q(z.attributeName())&&$.valueFromOption(this.getOptionValue(z.attributeName()),z)).forEach((z)=>{Object.keys(z.implied).filter((J)=>!q(J)).forEach((J)=>{this.setOptionValueWithSource(J,z.implied[J],"implied")})})}missingArgument($){let q=`error: missing required argument '${$}'`;this.error(q,{code:"commander.missingArgument"})}optionMissingArgument($){let q=`error: option '${$.flags}' argument missing`;this.error(q,{code:"commander.optionMissingArgument"})}missingMandatoryOptionValue($){let q=`error: required option '${$.flags}' not specified`;this.error(q,{code:"commander.missingMandatoryOptionValue"})}_conflictingOption($,q){let z=(X)=>{let Y=X.attributeName(),Z=this.getOptionValue(Y),T=this.options.find((R)=>R.negate&&Y===R.attributeName()),H=this.options.find((R)=>!R.negate&&Y===R.attributeName());if(T&&(T.presetArg===void 0&&Z===!1||T.presetArg!==void 0&&Z===T.presetArg))return T;return H||X},J=(X)=>{let Y=z(X),Z=Y.attributeName();if(this.getOptionValueSource(Z)==="env")return`environment variable '${Y.envVar}'`;return`option '${Y.flags}'`},Q=`error: ${J($)} cannot be used with ${J(q)}`;this.error(Q,{code:"commander.conflictingOption"})}unknownOption($){if(this._allowUnknownOption)return;let q="";if($.startsWith("--")&&this._showSuggestionAfterError){let J=[],Q=this;do{let X=Q.createHelp().visibleOptions(Q).filter((Y)=>Y.long).map((Y)=>Y.long);J=J.concat(X),Q=Q.parent}while(Q&&!Q._enablePositionalOptions);q=a($,J)}let z=`error: unknown option '${$}'${q}`;this.error(z,{code:"commander.unknownOption"})}_excessArguments($){if(this._allowExcessArguments)return;let q=this.registeredArguments.length,z=q===1?"":"s",Q=`error: too many arguments${this.parent?` for '${this.name()}'`:""}. Expected ${q} argument${z} but got ${$.length}.`;this.error(Q,{code:"commander.excessArguments"})}unknownCommand(){let $=this.args[0],q="";if(this._showSuggestionAfterError){let J=[];this.createHelp().visibleCommands(this).forEach((Q)=>{if(J.push(Q.name()),Q.alias())J.push(Q.alias())}),q=a($,J)}let z=`error: unknown command '${$}'${q}`;this.error(z,{code:"commander.unknownCommand"})}version($,q,z){if($===void 0)return this._version;this._version=$,q=q||"-V, --version",z=z||"output the version number";let J=this.createOption(q,z);return this._versionOptionName=J.attributeName(),this._registerOption(J),this.on("option:"+J.name(),()=>{this._outputConfiguration.writeOut(`${$}
|
|
25
|
+
`),this._exit(0,"commander.version",$)}),this}description($,q){if($===void 0&&q===void 0)return this._description;if(this._description=$,q)this._argsDescription=q;return this}summary($){if($===void 0)return this._summary;return this._summary=$,this}alias($){if($===void 0)return this._aliases[0];let q=this;if(this.commands.length!==0&&this.commands[this.commands.length-1]._executableHandler)q=this.commands[this.commands.length-1];if($===q._name)throw new Error("Command alias can't be the same as its name");let z=this.parent?._findCommand($);if(z){let J=[z.name()].concat(z.aliases()).join("|");throw new Error(`cannot add alias '${$}' to command '${this.name()}' as already have command '${J}'`)}return q._aliases.push($),this}aliases($){if($===void 0)return this._aliases;return $.forEach((q)=>this.alias(q)),this}usage($){if($===void 0){if(this._usage)return this._usage;let q=this.registeredArguments.map((z)=>{return m1(z)});return[].concat(this.options.length||this._helpOption!==null?"[options]":[],this.commands.length?"[command]":[],this.registeredArguments.length?q:[]).join(" ")}return this._usage=$,this}name($){if($===void 0)return this._name;return this._name=$,this}helpGroup($){if($===void 0)return this._helpGroupHeading??"";return this._helpGroupHeading=$,this}commandsGroup($){if($===void 0)return this._defaultCommandGroup??"";return this._defaultCommandGroup=$,this}optionsGroup($){if($===void 0)return this._defaultOptionGroup??"";return this._defaultOptionGroup=$,this}_initOptionGroup($){if(this._defaultOptionGroup&&!$.helpGroupHeading)$.helpGroup(this._defaultOptionGroup)}_initCommandGroup($){if(this._defaultCommandGroup&&!$.helpGroup())$.helpGroup(this._defaultCommandGroup)}nameFromFilename($){return this._name=L.basename($,L.extname($)),this}executableDir($){if($===void 0)return this._executableDir;return this._executableDir=$,this}helpInformation($){let q=this.createHelp(),z=this._getOutputContext($);q.prepareContext({error:z.error,helpWidth:z.helpWidth,outputHasColors:z.hasColors});let J=q.formatHelp(this,q);if(z.hasColors)return J;return this._outputConfiguration.stripColor(J)}_getOutputContext($){$=$||{};let q=!!$.error,z,J,Q;if(q)z=(Y)=>this._outputConfiguration.writeErr(Y),J=this._outputConfiguration.getErrHasColors(),Q=this._outputConfiguration.getErrHelpWidth();else z=(Y)=>this._outputConfiguration.writeOut(Y),J=this._outputConfiguration.getOutHasColors(),Q=this._outputConfiguration.getOutHelpWidth();return{error:q,write:(Y)=>{if(!J)Y=this._outputConfiguration.stripColor(Y);return z(Y)},hasColors:J,helpWidth:Q}}outputHelp($){let q;if(typeof $==="function")q=$,$=void 0;let z=this._getOutputContext($),J={error:z.error,write:z.write,command:this};this._getCommandAndAncestors().reverse().forEach((X)=>X.emit("beforeAllHelp",J)),this.emit("beforeHelp",J);let Q=this.helpInformation({error:z.error});if(q){if(Q=q(Q),typeof Q!=="string"&&!Buffer.isBuffer(Q))throw new Error("outputHelp callback must return a string or a Buffer")}if(z.write(Q),this._getHelpOption()?.long)this.emit(this._getHelpOption().long);this.emit("afterHelp",J),this._getCommandAndAncestors().forEach((X)=>X.emit("afterAllHelp",J))}helpOption($,q){if(typeof $==="boolean"){if($){if(this._helpOption===null)this._helpOption=void 0;if(this._defaultOptionGroup)this._initOptionGroup(this._getHelpOption())}else this._helpOption=null;return this}if(this._helpOption=this.createOption($??"-h, --help",q??"display help for command"),$||q)this._initOptionGroup(this._helpOption);return this}_getHelpOption(){if(this._helpOption===void 0)this.helpOption(void 0,void 0);return this._helpOption}addHelpOption($){return this._helpOption=$,this._initOptionGroup($),this}help($){this.outputHelp($);let q=Number(_.exitCode??0);if(q===0&&$&&typeof $!=="function"&&$.error)q=1;this._exit(q,"commander.help","(outputHelp)")}addHelpText($,q){let z=["beforeAll","before","after","afterAll"];if(!z.includes($))throw new Error(`Unexpected value for position to addHelpText.
|
|
26
|
+
Expecting one of '${z.join("', '")}'`);let J=`${$}Help`;return this.on(J,(Q)=>{let X;if(typeof q==="function")X=q({error:Q.error,command:Q.command});else X=q;if(X)Q.write(`${X}
|
|
27
|
+
`)}),this}_outputHelpIfRequested($){let q=this._getHelpOption();if(q&&$.find((J)=>q.is(J)))this.outputHelp(),this._exit(0,"commander.helpDisplayed","(outputHelp)")}}function o($){return $.map((q)=>{if(!q.startsWith("--inspect"))return q;let z,J="127.0.0.1",Q="9229",X;if((X=q.match(/^(--inspect(-brk)?)$/))!==null)z=X[1];else if((X=q.match(/^(--inspect(-brk|-port)?)=([^:]+)$/))!==null)if(z=X[1],/^\d+$/.test(X[3]))Q=X[3];else J=X[3];else if((X=q.match(/^(--inspect(-brk|-port)?)=([^:]+):(\d+)$/))!==null)z=X[1],J=X[3],Q=X[4];if(z&&Q!=="0")return`${z}=${J}:${parseInt(Q)+1}`;return q})}function x(){if(_.env.NO_COLOR||_.env.FORCE_COLOR==="0"||_.env.FORCE_COLOR==="false")return!1;if(_.env.FORCE_COLOR||_.env.CLICOLOR_FORCE!==void 0)return!0;return}i1.Command=b;i1.useColor=x});var J1=U((o1)=>{var{Argument:$1}=y(),{Command:C}=e(),{CommanderError:r1,InvalidArgumentError:q1}=E(),{Help:a1}=A(),{Option:z1}=P();o1.program=new C;o1.createCommand=($)=>new C($);o1.createOption=($,q)=>new z1($,q);o1.createArgument=($,q)=>new $1($,q);o1.Command=C;o1.Option=z1;o1.Argument=$1;o1.Help=a1;o1.CommanderError=r1;o1.InvalidArgumentError=q1;o1.InvalidOptionArgumentError=q1});import{readFileSync as y2}from"node:fs";import{dirname as F2,join as w2}from"node:path";import{fileURLToPath as A2}from"node:url";var Q1=K1(J1(),1),{program:d2,createCommand:p2,createArgument:s2,createOption:i2,CommanderError:t2,InvalidArgumentError:n2,InvalidOptionArgumentError:r2,Command:X1,Argument:a2,Option:o2,Help:e2}=Q1.default;import{join as V2}from"node:path";import{existsSync as Y1}from"node:fs";import{readFile as T2}from"node:fs/promises";import{dirname as Z1,join as H1,resolve as f}from"node:path";var B2=".gstatxrc.json";function v($){let z=$.replace(/\.git$/,"").split(/[/:]/);return z[z.length-1]||"repository"}function _2($){let q=f($),z=20,J=0;while(J<z){let Q=H1(q,B2);if(Y1(Q))return Q;let X=Z1(q);if(X===q)break;q=X,J++}return null}async function V($,q=process.cwd()){try{let z;if($){let Y=f($);if(!Y1(Y))return console.error(`Error: Config file not found: ${Y}`),null;z=Y}else if(z=_2(q),!z)return null;let J=await T2(z,"utf-8"),Q=JSON.parse(J),X=Z1(z);if(Q.repositories)Q.repositories=Q.repositories.map((Y)=>{if(!Y.path&&Y.url){let Z=v(Y.url);return{...Y,path:H1(X,Z),name:Y.name||Z}}if(Y.path)return{...Y,path:f(X,Y.path)};return Y});return{config:Q,configDir:X}}catch(z){if($)console.error(`Error: Failed to load config file: ${z}`);return null}}import{exec as G2,execSync as M2}from"node:child_process";import{access as L2}from"node:fs/promises";import{join as U2}from"node:path";import{promisify as S2}from"node:util";var R1=S2(G2);async function W($){try{return await L2(U2($,".git")),!0}catch{return!1}}async function h($){try{let{stdout:q}=await R1("git shortlog -sn --all",{cwd:$}),z=[],J=q.trim().split(`
|
|
28
|
+
`);for(let Q of J){let X=Q.match(/^\s*(\d+)\s+(.+)$/);if(X){let Y=parseInt(X[1]||"0",10),Z=X[2]||"",{stdout:T}=await R1(`git log --format='%aE' --author="${Z.replace(/"/g,"\\\"")}" -1`,{cwd:$}),H=T.trim().split(`
|
|
29
|
+
`)[0]||"";z.push({name:Z,email:H,commits:Y})}}return z.sort((Q,X)=>X.commits-Q.commits)}catch(q){throw new Error(`Failed to get contributors from ${$}: ${q}`)}}function u($,q,z){let J='git log --format="%H|%an|%ae|%ad|%s" --date=iso-strict --numstat';if(q)J+=` --since="${q}"`;if(z)J+=` --until="${z}"`;let Q=M2(J,{encoding:"utf-8",cwd:$,maxBuffer:10485760}),X=[],Y=Q.split(`
|
|
30
|
+
`).filter((G)=>G.trim()),Z=null,T=0,H=0,R=0,B=[];for(let G of Y)if(G.includes("|")){if(Z?.hash&&Z?.author&&Z?.email&&Z?.date&&Z?.message)X.push({hash:Z.hash,author:Z.author,email:Z.email,date:Z.date,message:Z.message,filesChanged:T,insertions:H,deletions:R,files:B});let[M,S,K,j,...G1]=G.split("|");if(M&&S&&K&&j)Z={hash:M.trim(),author:S.trim(),email:K.trim(),date:j.trim(),message:G1.join("|").trim()},T=0,H=0,R=0,B=[]}else{let M=G.trim().split(/\s+/);if(M.length>=2&&M[0]&&M[1]){let S=parseInt(M[0],10)||0,K=parseInt(M[1],10)||0,j=M.slice(2).join(" ");if(j&&!Number.isNaN(S)&&!Number.isNaN(K))T++,H+=S,R+=K,B.push({path:j,insertions:S,deletions:K})}}if(Z?.hash&&Z?.author&&Z?.email&&Z?.date&&Z?.message)X.push({hash:Z.hash,author:Z.author,email:Z.email,date:Z.date,message:Z.message,filesChanged:T,insertions:H,deletions:R,files:B});return X}import{exec as K2}from"node:child_process";import{existsSync as T1}from"node:fs";import{mkdir as W2}from"node:fs/promises";import{dirname as j2}from"node:path";import{promisify as I2}from"node:util";var E2=I2(K2);async function g($){if(!$.path)return console.error(`Error: Repository ${$.name||"unknown"} has no path specified`),null;if(T1($.path)&&await W($.path))return $.path;if(T1($.path))return console.error(`Error: Path exists but is not a git repository: ${$.path}`),null;if(!$.url)return console.error(`Error: Repository not found at ${$.path} and no URL provided for cloning`),null;try{console.log(`Cloning repository from ${$.url} to ${$.path}...`);let q=j2($.path),z=$.path.split("/").pop()||"repository";try{await W2(q,{recursive:!0})}catch(J){}return await E2(`git clone "${$.url}" "${$.path}"`),console.log(`✓ Successfully cloned ${$.name||z}`),$.path}catch(q){return console.error(`Error: Failed to clone repository: ${q}`),null}}class D{config;loadedConfig=null;constructor($={}){this.config=$}async initialize(){if(!this.config.repositories){if(this.loadedConfig=await V(this.config.configPath),this.loadedConfig?.config.repositories)this.config.repositories=this.loadedConfig.config.repositories;if(this.loadedConfig?.config)this.config={...this.loadedConfig.config,...this.config,repositories:this.config.repositories||this.loadedConfig.config.repositories}}if(this.config.repositories)this.config.repositories=this.config.repositories.map(($)=>{if(!$.path&&$.url){let q=this.loadedConfig?.configDir||process.cwd(),z=v($.url);return{...$,path:V2(q,z),name:$.name||z}}return $});if(this.config.cloneIfNotExists&&this.config.repositories){let $=[];for(let q of this.config.repositories){if(!q.path){console.error(`Error: Repository ${q.name||"unknown"} has no path and no URL`),$.push("");continue}let z=await g(q);if(z)$.push(z);else $.push(q.path)}this.config.repositories=this.config.repositories.map((q,z)=>({...q,path:$[z]||q.path}))}}getRepoPaths($){if($&&$.length>0)return $;if(this.config.repositories)return this.config.repositories.map((q)=>q.path).filter((q)=>q!==void 0);return[]}async listContributors($){await this.initialize();let q=this.getRepoPaths($);if(q.length===0)throw new Error("No repository paths specified");let z=[];for(let J of q){if(!await W(J))throw new Error(`${J} is not a git repository`);try{let X=await h(J);z.push({path:J,contributors:X})}catch(X){throw new Error(`Failed to get contributors from ${J}: ${X}`)}}return z}async getHistory($,q,z){await this.initialize();let J=this.getRepoPaths($);if(J.length===0)throw new Error("No repository paths specified");let Q=[];for(let X of J){if(!await W(X))throw new Error(`${X} is not a git repository`);try{let Z=u(X,q,z);Q.push({path:X,commits:Z})}catch(Z){throw new Error(`Failed to get commit history from ${X}: ${Z}`)}}return Q}}async function B1($,q=!0,z){let J=new D({configPath:z});try{let Q=await J.listContributors($);for(let X of Q)if(console.log(`
|
|
31
|
+
\uD83D\uDCCA Contributors for ${X.path}:`),console.log("─".repeat(60)),X.contributors.length===0)console.log(" No contributors found");else for(let Y of X.contributors)if(q)console.log(` ${Y.name} <${Y.email}> (${Y.commits} commits)`);else console.log(` ${Y.name} <${Y.email}>`)}catch(Q){console.error("Error processing repositories:",Q)}}import{writeFileSync as D2}from"node:fs";import{resolve as N2}from"node:path";async function _1($,q={},z){let J=new D({configPath:z});try{let Q=await J.getHistory($,q.since,q.until),X={generatedAt:new Date().toISOString(),period:{since:q.since,until:q.until},repositories:Q.map((Z)=>{let T=new Set(Z.commits.flatMap((B)=>B.files.map((G)=>G.path))).size,H=Z.commits.reduce((B,G)=>B+G.insertions,0),R=Z.commits.reduce((B,G)=>B+G.deletions,0);return{path:Z.path,commits:Z.commits,summary:{totalCommits:Z.commits.length,totalFilesChanged:T,totalInsertions:H,totalDeletions:R}}})},Y=JSON.stringify(X,null,2);if(q.out){let Z=N2(process.cwd(),q.out);D2(Z,Y,"utf-8"),console.log(`✅ Report saved to: ${Z}`),console.log(`
|
|
32
|
+
\uD83D\uDCCA Summary:`);for(let T of X.repositories)console.log(`
|
|
33
|
+
Repository: ${T.path}`),console.log(` Commits: ${T.summary.totalCommits}`),console.log(` Files Changed: ${T.summary.totalFilesChanged}`),console.log(` Lines Added: ${T.summary.totalInsertions.toLocaleString()}`),console.log(` Lines Removed: ${T.summary.totalDeletions.toLocaleString()}`)}else console.log(Y)}catch(Q){throw console.error("Error generating history report:",Q),Q}}var P2=A2(import.meta.url),k2=F2(P2),O2=w2(k2,"..","package.json"),x2=JSON.parse(y2(O2,"utf-8")),b2=x2.version,N=new X1;N.name("gstatx").description("A CLI tool to export statistics from git repositories").version(b2).option("-c, --config <path>","Specify custom config file path").configureHelp({helpWidth:100});N.command("contributors").description("List contributors for specified repositories").option("--no-commits","Hide commit counts in contributor list").argument("[repo-paths...]","Repository paths").action(async($,q,z)=>{let J=z.parent?.opts().config,X=(await V(J))?.config.contributors?.["no-commits"]??!1,Y=!(q.noCommits||X),Z=$.length===0?void 0:$;await B1(Z,Y,J)}).addHelpText("after",`
|
|
34
34
|
Examples:
|
|
35
35
|
gstatx contributors ./my-repo
|
|
36
36
|
gstatx contributors ./repo1 ./repo2
|
|
37
|
-
gstatx contributors --no-commits ./my-repo`);N.command("hist").description("Generate commit history report").option("-s, --since <date>",'Start date for the report (e.g., "2024-01-01", "1 month ago")').option("-u, --until <date>",'End date for the report (e.g., "2024-12-31", "now")').option("-o, --out <file>","Output file path (defaults to stdout)").argument("[repo-paths...]","Repository paths").action(async($,q,
|
|
37
|
+
gstatx contributors --no-commits ./my-repo`);N.command("hist").description("Generate commit history report").option("-s, --since <date>",'Start date for the report (e.g., "2024-01-01", "1 month ago")').option("-u, --until <date>",'End date for the report (e.g., "2024-12-31", "now")').option("-o, --out <file>","Output file path (defaults to stdout)").argument("[repo-paths...]","Repository paths").action(async($,q,z)=>{let J=z.parent?.opts().config,Q={since:q.since,until:q.until,out:q.out},X=$.length===0?void 0:$;await _1(X,Q,J)}).addHelpText("after",`
|
|
38
38
|
Examples:
|
|
39
39
|
gstatx hist ./my-repo
|
|
40
40
|
gstatx hist --since "1 month ago" ./my-repo
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "gstatx",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.2",
|
|
4
4
|
"description": "Export stats of a repo or list of repos",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"engines": {
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
"scripts": {
|
|
25
25
|
"build": "bun build src/index.ts --outdir dist --target node --minify && bun build src/lib.ts --outdir dist --target node --minify && tsc -p tsconfig.build.json",
|
|
26
26
|
"prepack": "bun run build",
|
|
27
|
-
"postinstall": "./scripts/setup-git-hooks.sh",
|
|
27
|
+
"postinstall": "test -f ./scripts/setup-git-hooks.sh && ./scripts/setup-git-hooks.sh || exit 0",
|
|
28
28
|
"setup:hooks": "./scripts/setup-git-hooks.sh",
|
|
29
29
|
"start": "bun run src/index.ts",
|
|
30
30
|
"lint": "biome lint .",
|