generator-easy-ui5 3.3.0 → 3.5.1

package/generators/app/index.js

@@ -8,7 +8,9 @@ const { hasYarn } = require("yarn-or-npm");
 const path = require("path");
 const fs = require("fs");
 const { rm } = require("fs").promises;
+const glob = require("glob");
 
+const { request } = require("@octokit/request");
 const { Octokit } = require("@octokit/rest");
 const { throttling } = require("@octokit/plugin-throttling");
 const MyOctokit = Octokit.plugin(throttling);
@@ -19,525 +21,608 @@ const AdmZip = require("adm-zip");
 const NPM_CONFIG_PREFIX = "easy-ui5_";
 let npmConfig;
 const getNPMConfig = (configName) => {
-  if (!npmConfig) {
-    npmConfig = require("libnpmconfig").read();
-  }
-  return npmConfig && npmConfig[`${NPM_CONFIG_PREFIX}${configName}`]
-}
+	if (!npmConfig) {
+		npmConfig = require("libnpmconfig").read();
+	}
+	return npmConfig && npmConfig[`${NPM_CONFIG_PREFIX}${configName}`];
+};
 
 // the command line options of the generator
 const generatorOptions = {
-  ghAuthToken: {
-    type: String,
-    description:
-      "GitHub authToken to optionally access private generator repositories",
-  },
-  ghOrg: {
-    type: String,
-    description: "GitHub organization to lookup for available generators",
-    default: "ui5-community",
-    hide: true // we don't want to recommend to use this option
-  },
-  subGeneratorPrefix: {
-    type: String,
-    description: "Prefix used for the lookup of the available generators",
-    default: "generator-ui5-",
-    hide: true // we don't want to recommend to use this option
-  },
-  addGhOrg: {
-    type: String,
-    description: `GitHub organization to lookup for additional available generators`,
-    hide: true, // we don't want to recommend to use this option
-    npmConfig: true
-  },
-  addSubGeneratorPrefix: {
-    type: String,
-    description: `Prefix used for the lookup of the additional available generators`,
-    default: "generator-",
-    hide: true, // we don't want to recommend to use this option
-    npmConfig: true
-  },
-  list: {
-    type: Boolean,
-    description: "List the available subcommands of the generator",
-  },
-  verbose: {
-    type: Boolean,
-    description: "Enable detailed logging",
-  },
-  skipUpdate: {
-    type: Boolean,
-    description: "Skip the update of the plugin generators",
-  },
-  plugins: {
-    type: Boolean,
-    alias: "p",
-    description: "Get detailed version information",
-  }
+	ghAuthToken: {
+		type: String,
+		description: "GitHub authToken to optionally access private generator repositories",
+		npmConfig: true,
+	},
+	ghOrg: {
+		type: String,
+		description: "GitHub organization to lookup for available generators",
+		default: "ui5-community",
+		hide: true, // we don't want to recommend to use this option
+	},
+	subGeneratorPrefix: {
+		type: String,
+		description: "Prefix used for the lookup of the available generators",
+		default: "generator-ui5-",
+		hide: true, // we don't want to recommend to use this option
+	},
+	addGhOrg: {
+		type: String,
+		description: "GitHub organization to lookup for additional available generators",
+		hide: true, // we don't want to recommend to use this option
+		npmConfig: true,
+	},
+	addSubGeneratorPrefix: {
+		type: String,
+		description: "Prefix used for the lookup of the additional available generators",
+		default: "generator-",
+		hide: true, // we don't want to recommend to use this option
+		npmConfig: true,
+	},
+	list: {
+		type: Boolean,
+		description: "List the available subcommands of the generator",
+	},
+	skipUpdate: {
+		type: Boolean,
+		description: "Skip the update of the plugin generator",
+	},
+	forceUpdate: {
+		type: Boolean,
+		description: "Force the update of the plugin generator",
+	},
+	offline: {
+		type: Boolean,
+		alias: "o",
+		description: "Running easy-ui5 in offline mode",
+	},
+	verbose: {
+		type: Boolean,
+		description: "Enable detailed logging",
+	},
+	plugins: {
+		type: Boolean,
+		alias: "p",
+		description: "Get detailed version information",
+	},
+	next: {
+		type: Boolean,
+		description: "Preview the next mode to consume templates from bestofui5.org",
+	},
 };
 
 const generatorArgs = {
-  generator: {
-    type: String,
-    required: false,
-    description: "Name of the generator to invoke (without the \"generator-ui5-\" prefix)",
-  },
-  subcommand: {
-    type: String,
-    required: false,
-    description: "Name of the subcommand to invoke (without the \"generator:\" prefix)",
-  },
+	generator: {
+		type: String,
+		required: false,
+		description: 'Name of the generator to invoke (without the "generator-ui5-" prefix)',
+	},
+	subcommand: {
+		type: String,
+		required: false,
+		description: 'Name of the subcommand to invoke (without the "generator:" prefix)',
+	},
 };
 
 module.exports = class extends Generator {
-  constructor(args, opts) {
-    super(args, opts, {
-      // disable the Yeoman 5 package-manager logic (auto install)!
-      customInstallTask: "disabled"
-    });
-
-    Object.keys(generatorArgs).forEach((argName) => {
-      // register the argument for being displayed in the help
-      this.argument(argName, generatorArgs[argName]);
-    });
-
-    Object.keys(generatorOptions).forEach((optionName) => {
-      const initialValue = this.options[optionName];
-      // register the option for being displayed in the help
-      this.option(optionName, generatorOptions[optionName]);
-      const defaultedValue = this.options[optionName];
-      if (generatorOptions[optionName].npmConfig) {
-        // if a value is set, use the set value (parameter has higher precedence than npm config)
-        // => this.option(...) applies the default value to this.options[...] used as last resort
-        this.options[optionName] = initialValue || getNPMConfig(optionName) || defaultedValue;
-      }
-    });
-  }
-
-  _showBusy(statusText) {
-    this._clearBusy();
-    const progressChars = ["\\", "|", "/", "-"];
-    let i = 0;
-    process.stdout.write(`\r${statusText}  `);
-    this._busy = {
-      text: statusText,
-      timer: setInterval(() => {
-        process.stdout.write(`\r${statusText} ${progressChars[i++]}`);
-        i %= progressChars.length;
-      }, 250),
-    };
-  }
-
-  _clearBusy(newLine) {
-    if (this._busy) {
-      clearInterval(this._busy.timer);
-      process.stdout.write("\r".padEnd(this._busy.text.length + 3) + (newLine ? "\n" : ""));
-      delete this._busy;
-    }
-  }
-
-  async prompting() {
-
-    // Have Yeoman greet the user.
-    if (!this.options.embedded) {
-      this.log(yosay(`Welcome to the ${chalk.red("easy-ui5")} generator!`));
-    }
-
-    const home = path.join(__dirname, "..", "..");
-
-    // check the permissions to Easy UI5s plugin directory which must
-    // allow read/write to install additional plugin generators
-    let pluginsHome = path.join(home, "plugin-generators");
-    try {
-      fs.accessSync(pluginsHome, fs.constants.R_OK | fs.constants.W_OK);
-    } catch (e) {
-      pluginsHome = path.join(require("os").homedir(), ".npm", "_generator-easy-ui5", "plugin-generators");
-      if (this.options.verbose) {
-        console.error(`Plugin directory: ${chalk.green(pluginsHome)}`);
-        console.error(chalk.red(e.message));
-      }
-      fs.mkdirSync(pluginsHome, { recursive: true });
-    }
-
-    // log the plugins and configuration
-    if (this.options.plugins) {
-      const glob = require("glob");
-      const yeoman = require("yeoman-environment/package.json");
-
-      const components = {
-        "Node.js": process.version,
-        "yeoman-environment": yeoman.version,
-        "generator-easy-ui5": require(path.join(home, "package.json")).version,
-        "home": home,
-        "pluginsHome": pluginsHome,
-      };
-
-      Object.keys(components).forEach((component) => {
-        this.log(`${chalk.green(component)}: ${components[component]}`);
-      });
-
-      this.log(chalk.green("\nAvailable generators:"));
-      glob.sync(`${pluginsHome}/*/package.json`).forEach((plugin) => {
-        const name = plugin.match(/.*\/(.+)\/package\.json/)[1];
-        const lib = require(plugin);
-        this.log(`  - ${chalk.green(name)}: ${lib.version}`);
-      });
-
-      return;
-    }
-
-    // create the octokit client to retrieve the generators from GH org
-    const octokit = new MyOctokit({
-      userAgent: `${this.rootGeneratorName()}:${this.rootGeneratorVersion()}`,
-      auth: this.options.ghAuthToken,
-      throttle: {
-        onRateLimit: (retryAfter, options) => {
-          this.log(
-            `${chalk.yellow("Hit the GitHub API limit!")} Request quota exhausted for this request.`
-          );
-
-          if (options.request.retryCount === 0) {
-            // only retries once
-            this.log(`Retrying after ${retryAfter} seconds. Alternatively, you can cancel this operation and supply an auth token with the \`--ghAuthToken\` option. For more details, run \`yo easy-ui5 --help\`. `);
-            return true;
-          }
-        },
-        onAbuseLimit: () => {
-          // does not retry, only logs a warning
-          this.log(
-            `${chalk.red("Hit the GitHub API limit again!")} Please supply an auth token with the \`--ghAuthToken\` option. For more details, run \`yo easy-ui5 --help\` `
-          );
-
-        },
-      }
-    });
-
-    // helper for filtering repos with corresponding subGenerator prefix
-    const filterReposWithSubGeneratorPrefix = (repos, subGeneratorPrefix) => {
-      if (!Array.isArray(repos)) {
-        return [];
-      }
-      return repos.filter((repo) =>
-        repo.name.startsWith(`${subGeneratorPrefix}`)
-      ).map((repo) => {
-        return {
-          org: repo.owner?.login,
-          name: repo.name,
-          branch: repo.default_branch,
-          subGeneratorName: repo.name.substring(subGeneratorPrefix.length),
-        };
-      });
-    }
-
-    // helper to retrieve the available repositories for a GH org
-    const listGeneratorsForOrg = async (ghOrg, subGeneratorPrefix) => {
-      const response = await octokit.repos.listForOrg({
-        org: ghOrg,
-      });
-      return filterReposWithSubGeneratorPrefix(response?.data, subGeneratorPrefix);
-    }
-
-    // helper to retrieve the available repositories for a GH user
-    const listGeneratorsForUser = async (ghUser, subGeneratorPrefix) => {
-      const response = await octokit.repos.listForUser({
-        username: ghUser,
-      });
-      return filterReposWithSubGeneratorPrefix(response?.data, subGeneratorPrefix);
-    }
-
-    // retrieve the available repositories
-    let availGenerators;
-    try {
-      availGenerators = await listGeneratorsForOrg(this.options.ghOrg, this.options.subGeneratorPrefix);
-    } catch (e) {
-      console.error(`Failed to connect to GitHub to retrieve available generators for "${this.options.ghOrg}" organization! Run with --verbose for details!`);
-      if (this.options.verbose) {
-        console.error(e);
-      }
-      return;
-    }
-    try {
-      if (this.options.addGhOrg && this.options.addSubGeneratorPrefix) {
-        availGenerators = availGenerators.concat(await listGeneratorsForOrg(this.options.addGhOrg, this.options.addSubGeneratorPrefix));
-      }
-    } catch (e) {
-      if (this.options.verbose) {
-        this.log(`Failed to connect to GitHub retrieve additional generators for "${this.options.addGhOrg}" organization! Try to retrieve for user...`);
-      }
-      try {
-        availGenerators = availGenerators.concat(await listGeneratorsForUser(this.options.addGhOrg, this.options.addSubGeneratorPrefix));
-      } catch (e) {
-        console.error(`Failed to connect to GitHub to retrieve additional generators for organization or user "${this.options.addGhOrg}"! Run with --verbose for details!`);
-        if (this.options.verbose) {
-          console.error(e);
-        }
-        return;
-      }
-    }
-
-    // download the generator from GH (or the test generator)
-    let generatorPath;
-    if (this.options.generator === "test") {
-      generatorPath = path.join(
-        __dirname,
-        "../../plugin-generators/generator-ui5-test"
-      );
-    } else {
-
-      // check for provided generator being available on GH
-      let generator = this.options.generator && availGenerators.find((repo) => 
-        repo.subGeneratorName === this.options.generator
-      );
-
-      // if no generator is provided and doesn't exist, ask for generator name
-      if (!generator) {
-        if (this.options.generator) {
-          this.log(
-            `The generator ${chalk.red(
-              this.options.generator
-            )} was not found. Please select an existing generator!`
-          );
-        }
-
-        const generatorIdx = (
-          await this.prompt([
-            {
-              type: "list",
-              name: "generator",
-              message: "Select your generator?",
-              choices: availGenerators.map((availGenerator, idx) => ({
-                name: `${availGenerator.subGeneratorName}${this.options.addGhOrg ? ` [${availGenerator.org}]` : ""}`,
-                value: idx,
-              })),
-            },
-          ])
-        ).generator;
-        generator = availGenerators[generatorIdx];
-      }
-
-      // fetch the available branches to retrieve the latest commit SHA
-      let reqBranch;
-      try {
-        reqBranch = await octokit.repos.getBranch({
-          owner: generator.org,
-          repo: generator.name,
-          branch: generator.branch,
-        });
-      } catch (e) {
-        console.error(chalk.red(`Failed to retrieve the default branch for repository "${generator.name}" for "${generator.org}" organization! Run with --verbose for details!`));
-        if (this.options.verbose) {
-          console.error(chalk.red(e.message));
-        }
-        return;
-      }
-
-      const commitSHA = reqBranch.data.commit.sha;
-
-      if (this.options.verbose) {
-        this.log(
-          `Using commit ${commitSHA} from @${generator.org}/${generator.name}#${generator.default_branch}...`
-        );
-      }
-      generatorPath = path.join(pluginsHome, generator.name);
-      const shaMarker = path.join(generatorPath, `.${commitSHA}`);
-
-      if (fs.existsSync(generatorPath) && !this.options.skipUpdate) {
-        // check if the SHA marker exists to know whether the generator is up-to-date or not
-        if (!fs.existsSync(shaMarker)) {
-          if (this.options.verbose) {
-            this.log(`Generator "${generator.name}" in "${generatorPath}" is outdated...`);
-          }
-          // remove if the SHA marker doesn't exist => outdated!
-          this._showBusy(`  Removing old "${generator.name}" templates`);
-          await rm(generatorPath, { recursive: true });
-        }
-      }
-
-      // re-fetch the generator and extract into local plugin folder
-      if (!fs.existsSync(generatorPath)) {
-        if (this.options.verbose) {
-          this.log(`Extracting ZIP to "${generatorPath}"...`);
-        }
-        this._showBusy(`  Downloading and extracting "${generator.name}" templates`);
-        const reqZIPArchive = await octokit.repos.downloadZipballArchive({
-          owner: generator.org,
-          repo: generator.name,
-          ref: commitSHA,
-        });
-        const buffer = Buffer.from(new Uint8Array(reqZIPArchive.data));
-        const zip = new AdmZip(buffer);
-        const zipEntries = zip.getEntries();
-        zipEntries.forEach((entry) => {
-          const match =
-            !entry.isDirectory && entry.entryName.match(/[^\/]+\/(.+)/);
-          if (match) {
-            const entryPath = match[1].slice(0, entry.name.length * -1);
-            zip.extractEntryTo(
-              entry,
-              path.join(generatorPath, entryPath),
-              false,
-              true
-            );
-          }
-        });
-        fs.writeFileSync(shaMarker, commitSHA);
-
-        // run yarn/npm install
-        if (this.options.verbose) {
-          this.log("Installing the plugin dependencies...");
-        }
-        this._showBusy(`  Preparing "${generator.name}"`);
-        await new Promise(function (resolve, reject) {
-          spawn((hasYarn() ? "yarn" : "npm"), ["install", "--no-progress", "--ignore-engines"], {
-            stdio: this.config.verbose ? "inherit" : "ignore",
-            cwd: generatorPath,
-            env: {
-              ...process.env,
-              "NO_UPDATE_NOTIFIER": true
-            }
-          }).on("exit", function (code) {
-            resolve(code);
-          }).on("error", function (err) {
-            reject(err);
-          });
-        }.bind(this));
-      }
-    }
-
-    this._clearBusy(true);
-
-    // filter the local options and the help command
-    const opts = Object.keys(this._options).filter(
-      (optionName) =>
-        !(generatorOptions.hasOwnProperty(optionName) || optionName === "help")
-    );
-
-    // create the env for the plugin generator
-    const yeoman = require("yeoman-environment");
-    const env = yeoman.createEnv(this.args, opts);
-
-    // helper to derive the subcommand
-    function deriveSubcommand(namespace) {
-      const match = namespace.match(/[^:]+:(.+)/);
-      return match ? match[1] : namespace;
-    }
-
-    // filter the hidden subgenerators already
-    //   -> subgenerators must be found in env as they are returned by lookup!
-    let subGenerators = env
-      .lookup({ localOnly: true, packagePaths: generatorPath })
-      .filter((sub) => {
-        const subGenerator = env.get(sub.namespace);
-        return !subGenerator.hidden;
-      });
-
-    // list the available subgenerators in the console (as help)
-    if (this.options.list) {
-      let maxLength = 0;
-      this.log(subGenerators
-        .map(sub => {
-          maxLength = Math.max(sub.namespace.length, maxLength);
-          return sub;
-        })
-        .reduce((output, sub) => {
-          const subGenerator = env.get(sub.namespace);
-          const displayName = subGenerator.displayName || "";
-          let line = `  ${deriveSubcommand(sub.namespace).padEnd(maxLength + 2)}`;
-          if (displayName) {
-            line += ` # ${subGenerator.displayName}`;
-          }
-          return `${output}\n${line}`;
-        }, `Subcommands (${subGenerators.length}):`));
-      return;
-    }
-
-    // if a subcommand is provided as argument, identify the matching subgenerator
-    // and remove the rest of the subgenerators from the list for later steps
-    if (this.options.subcommand) {
-      const selectedSubGenerator = subGenerators
-        .filter((sub) => {
-          // identify the subgenerator by subcommand
-          return new RegExp(`:${this.options.subcommand}$`).test(sub.namespace);
-        });
-      if (selectedSubGenerator.length == 1) {
-        subGenerators = selectedSubGenerator;
-      } else {
-        this.log(
-          `The generator ${chalk.red(
-            this.options.generator
-          )} has no subcommand ${chalk.red(
-            this.options.subcommand
-          )}. Please select an existing subcommand!`
-        );
-      }
-    }
-
-    // transform the list of the subgenerators and identify the
-    // default subgenerator for the default selection
-    let defaultSubGenerator;
-    let maxLength = 0;
-    subGenerators = subGenerators
-      .map(sub => {
-        const generator = env.get(sub.namespace);
-        let subcommand = deriveSubcommand(sub.namespace);
-        let displayName = generator.displayName || subcommand;
-        maxLength = Math.max(displayName.length, maxLength);
-        return {
-          subcommand,
-          displayName,
-          sub,
-        };
-      })
-      .map(({ subcommand, displayName, sub }) => {
-        const transformed = {
-          name: `${displayName.padEnd(maxLength + 2)} [${subcommand}]`,
-          value: sub.namespace,
-        };
-        if (/:app$/.test(sub.namespace)) {
-          defaultSubGenerator = transformed;
-        }
-        return transformed;
-      });
-
-    // at least 1 subgenerator must be present
-    if (subGenerators.length >= 1) {
-
-      // by default the 1st subgenerator is used
-      let subGenerator = subGenerators[0].value;
-
-      // if more than 1 subgenerator is present
-      // ask the developer to select one!
-      if (subGenerators.length > 1) {
-        subGenerator = (
-          await this.prompt([
-            {
-              type: "list",
-              name: "subGenerator",
-              message: "What do you want to do?",
-              default: defaultSubGenerator && defaultSubGenerator.value,
-              choices: subGenerators,
-            },
-          ])
-        ).subGenerator;
-      }
-
-      if (this.options.verbose) {
-        this.log(`Calling ${chalk.red(subGenerator)}...`);
-      }
-
-      // finally, run the subgenerator
-      env.run(subGenerator, {
-        verbose: this.options.verbose,
-        embedded: true,
-      });
-
-    } else {
-      this.log(
-        `The generator ${chalk.red(
-          this.options.generator
-        )} has no visible subgenerators!`
-      );
-    }
-
-  }
+	constructor(args, opts) {
+		super(args, opts, {
+			// disable the Yeoman 5 package-manager logic (auto install)!
+			customInstallTask: "disabled",
+		});
+
+		Object.keys(generatorArgs).forEach((argName) => {
+			// register the argument for being displayed in the help
+			this.argument(argName, generatorArgs[argName]);
+		});
+
+		Object.keys(generatorOptions).forEach((optionName) => {
+			const initialValue = this.options[optionName];
+			// register the option for being displayed in the help
+			this.option(optionName, generatorOptions[optionName]);
+			const defaultedValue = this.options[optionName];
+			if (generatorOptions[optionName].npmConfig) {
+				// if a value is set, use the set value (parameter has higher precedence than npm config)
+				// => this.option(...) applies the default value to this.options[...] used as last resort
+				this.options[optionName] = initialValue || getNPMConfig(optionName) || defaultedValue;
+			}
+		});
+	}
+
+	_showBusy(statusText) {
+		this._clearBusy();
+		const progressChars = ["\\", "|", "/", "-"];
+		let i = 0;
+		process.stdout.write(`\r${statusText}  `);
+		this._busy = {
+			text: statusText,
+			timer: setInterval(() => {
+				process.stdout.write(`\r${statusText} ${progressChars[i++]}`);
+				i %= progressChars.length;
+			}, 250),
+		};
+	}
+
+	_clearBusy(newLine) {
+		if (this._busy) {
+			clearInterval(this._busy.timer);
+			process.stdout.write("\r".padEnd(this._busy.text.length + 3) + (newLine ? "\n" : ""));
+			delete this._busy;
+		}
+	}
+
+	async prompting() {
+		const home = path.join(__dirname, "..", "..");
+		const pkgJson = require(path.join(home, "package.json"));
+
+		// Have Yeoman greet the user.
+		if (!this.options.embedded) {
+			this.log(yosay(`Welcome to the ${chalk.red("easy-ui5")} ${chalk.yellow(pkgJson.version)} generator!`));
+		}
+
+		// check the permissions to Easy UI5s plugin directory which must
+		// allow read/write to install additional plugin generators
+		let pluginsHome = path.join(home, "plugin-generators");
+		try {
+			fs.accessSync(pluginsHome, fs.constants.R_OK | fs.constants.W_OK);
+		} catch (e) {
+			pluginsHome = path.join(require("os").homedir(), ".npm", "_generator-easy-ui5", "plugin-generators");
+			if (this.options.verbose) {
+				console.error(`Plugin directory: ${chalk.green(pluginsHome)}`);
+				console.error(chalk.red(e.message));
+			}
+			fs.mkdirSync(pluginsHome, { recursive: true });
+		}
+
+		// log the plugins and configuration
+		if (this.options.plugins) {
+			const yeoman = require("yeoman-environment/package.json");
+
+			const components = {
+				"Node.js": process.version,
+				"yeoman-environment": yeoman.version,
+				"generator-easy-ui5": pkgJson.version,
+				home: home,
+				pluginsHome: pluginsHome,
+			};
+
+			Object.keys(components).forEach((component) => {
+				this.log(`${chalk.green(component)}: ${components[component]}`);
+			});
+
+			this.log(chalk.green("\nAvailable generators:"));
+			glob.sync(`${pluginsHome}/*/package.json`).forEach((plugin) => {
+				const name = plugin.match(/.*\/generator-(.+)\/package\.json/)[1];
+				const lib = require(plugin);
+				this.log(`  - ${chalk.green(name)}: ${lib.version}`);
+			});
+
+			return;
+		}
+
+		// create the octokit client to retrieve the generators from GH org
+		// when not running in offline mode!
+		let octokit;
+		if (this.options.offline) {
+			this.log(`Running in ${chalk.yellow("offline")} mode!`);
+		} else {
+			octokit = new MyOctokit({
+				userAgent: `${this.rootGeneratorName()}:${this.rootGeneratorVersion()}`,
+				auth: this.options.ghAuthToken,
+				throttle: {
+					onRateLimit: (retryAfter, options) => {
+						this.log(`${chalk.yellow("Hit the GitHub API limit!")} Request quota exhausted for this request.`);
+						if (options.request.retryCount === 0) {
+							// only retries once
+							this.log(
+								`Retrying after ${retryAfter} seconds. Alternatively, you can cancel this operation and supply an auth token with the \`--ghAuthToken\` option. For more details, run \`yo easy-ui5 --help\`. `
+							);
+							return true;
+						}
+					},
+					onAbuseLimit: () => {
+						// does not retry, only logs a warning
+						this.log(`${chalk.red("Hit the GitHub API limit again!")} Please supply an auth token with the \`--ghAuthToken\` option. For more details, run \`yo easy-ui5 --help\` `);
+					},
+				},
+			});
+		}
+
+		// helper for filtering repos with corresponding subGenerator prefix
+		const filterReposWithSubGeneratorPrefix = (repos, subGeneratorPrefix) => {
+			if (!Array.isArray(repos)) {
+				return [];
+			}
+			return repos
+				.filter((repo) => repo.name.startsWith(`${subGeneratorPrefix}`))
+				.map((repo) => {
+					return {
+						org: repo.owner?.login,
+						name: repo.name,
+						branch: repo.default_branch,
+						subGeneratorName: repo.name.substring(subGeneratorPrefix.length),
+					};
+				});
+		};
+
+		// helper to retrieve the available repositories for a GH org
+		const listGeneratorsForOrg = async (ghOrg, subGeneratorPrefix) => {
+			const response = await octokit.repos.listForOrg({
+				org: ghOrg,
+			});
+			return filterReposWithSubGeneratorPrefix(response?.data, subGeneratorPrefix);
+		};
+
+		// helper to retrieve the available repositories for a GH user
+		const listGeneratorsForUser = async (ghUser, subGeneratorPrefix) => {
+			const response = await octokit.repos.listForUser({
+				username: ghUser,
+			});
+			return filterReposWithSubGeneratorPrefix(response?.data, subGeneratorPrefix);
+		};
+
+		// determine the generator to be used
+		let generator;
+
+		// try to identify whether concrete generator is defined
+		if (!generator) {
+			// determine generator by ${owner}/${repo}(!${dir})? syntax, e.g.:
+			//   > yo easy-ui5 SAP-samples/ui5-typescript-tutorial
+			//   > yo easy-ui5 SAP-samples/ui5-typescript-tutorial#1.0
+			//   > yo easy-ui5 SAP-samples/ui5-typescript-tutorial\!/generator
+			//   > yo easy-ui5 SAP-samples/ui5-typescript-tutorial\!/generator#1.0
+			const reGenerator = /([^\/]+)\/([^\!\#]+)(?:\!([^\#]+))?(?:\#(.+))?/;
+			const matchGenerator = reGenerator.exec(this.options.generator);
+			if (matchGenerator) {
+				// derive and path the generator information from command line
+				const [owner, repo, dir = "/generator", branch] = matchGenerator.slice(1);
+				generator = {
+					org: owner,
+					name: repo,
+					branch,
+					dir,
+					pluginPath: `_/${owner}/${repo}`,
+				};
+				// log which generator is being used!
+				if (this.options.verbose) {
+					this.log(`Using generator ${chalk.green(`${owner}/${repo}!${dir}${branch ? "#" + branch : ""}`)}`);
+				}
+			}
+		}
+
+		// retrieve the available repositories (if no generator is specified specified directly)
+		let availGenerators;
+		if (!generator) {
+			if (this.options.offline) {
+				availGenerators = glob.sync(`${pluginsHome}/generator-*/package.json`).map((plugin) => {
+					const match = plugin.match(/.*\/(generator-(.+))\/package\.json/);
+					return {
+						org: "local",
+						name: match[1],
+						subGeneratorName: match[2].match(/(?:ui5-)?(.*)/)?.[1] || match[2],
+						local: true,
+					};
+				});
+			} else {
+				if (this.options.next) {
+					// check bestofui5.org for generators
+					try {
+						const response = await request({
+							method: "GET",
+							url: "https://raw.githubusercontent.com/ui5-community/bestofui5-data/live-data/data/data.json",
+						});
+						const data = JSON.parse(response.data);
+
+						availGenerators = data?.packages
+							?.filter((entry) => {
+								return entry.type === "generator";
+							})
+							.map((entry) => {
+								return {
+									org: entry.gitHubOwner,
+									name: entry.gitHubRepo,
+									subGeneratorName: entry.gitHubRepo.match(/(?:generator-(?:ui5-)?)(.*)/)?.[1] || entry.gitHubRepo,
+								};
+							});
+					} catch (e) {
+						console.error("Failed to connect to bestofui5.org to retrieve all available generators! Run with --verbose for details!");
+						if (this.options.verbose) {
+							console.error(e);
+						}
+						return;
+					}
+				} else {
+					// check the main GH org for generators
+					try {
+						availGenerators = await listGeneratorsForOrg(this.options.ghOrg, this.options.subGeneratorPrefix);
+					} catch (e) {
+						console.error(`Failed to connect to GitHub to retrieve all available generators for "${this.options.ghOrg}" organization! Run with --verbose for details!`);
+						if (this.options.verbose) {
+							console.error(e);
+						}
+						return;
+					}
+
+					// check the additional GH org for generators with a different prefix
+					try {
+						if (this.options.addGhOrg && this.options.addSubGeneratorPrefix) {
+							availGenerators = availGenerators.concat(await listGeneratorsForOrg(this.options.addGhOrg, this.options.addSubGeneratorPrefix));
+						}
+					} catch (e) {
+						if (this.options.verbose) {
+							this.log(`Failed to connect to GitHub retrieve additional generators for "${this.options.addGhOrg}" organization! Try to retrieve for user...`);
+						}
+						try {
+							availGenerators = availGenerators.concat(await listGeneratorsForUser(this.options.addGhOrg, this.options.addSubGeneratorPrefix));
+						} catch (e1) {
+							console.error(`Failed to connect to GitHub to retrieve additional generators for organization or user "${this.options.addGhOrg}"! Run with --verbose for details!`);
+							if (this.options.verbose) {
+								console.error(e1);
+							}
+							return;
+						}
+					}
+				}
+			}
+		}
+
+		// if no generator is provided and doesn't exist, ask for generator name
+		if (!generator) {
+			// check for provided generator being available on GH
+			generator = this.options.generator && availGenerators.find((repo) => repo.subGeneratorName === this.options.generator);
+
+			// if no generator is provided and doesn't exist, ask for generator name
+			if (this.options.generator && !generator) {
+				this.log(`The generator ${chalk.red(this.options.generator)} was not found. Please select an existing generator!`);
+			}
+
+			// still not found, select a generator
+			if (!generator) {
+				const generatorIdx = (
+					await this.prompt([
+						{
+							type: "list",
+							name: "generator",
+							message: "Select your generator?",
+							choices: availGenerators.map((availGenerator, idx) => ({
+								name: `${availGenerator.subGeneratorName}${this.options.addGhOrg ? ` [${availGenerator.org}]` : ""}`,
+								value: idx,
+							})),
+						},
+					])
+				).generator;
+				generator = availGenerators[generatorIdx];
+			}
+		}
+
+		let generatorPath = path.join(pluginsHome, generator.pluginPath || generator.name);
+		if (!this.options.offline) {
+			// lookup the default path of the generator if not set
+			if (!generator.branch) {
+				try {
+					const repoInfo = await octokit.repos.get({
+						owner: generator.org,
+						repo: generator.name,
+					});
+					generator.branch = repoInfo.data.default_branch;
+				} catch (e) {
+					console.error(`Generator "${owner}/${repo}!${dir}${branch ? "#" + branch : ""}" not found! Run with --verbose for details!`);
+					if (this.options.verbose) {
+						console.error(e);
+					}
+					return;
+				}
+			}
+			// fetch the branch to retrieve the latest commit SHA
+			let commitSHA;
+			try {
+				// determine the commitSHA
+				const reqBranch = await octokit.repos.getBranch({
+					owner: generator.org,
+					repo: generator.name,
+					branch: generator.branch,
+				});
+				commitSHA = reqBranch.data.commit.sha;
+			} catch (e) {
+				console.error(chalk.red(`Failed to retrieve the branch "${generator.branch}" for repository "${generator.name}" for "${generator.org}" organization! Run with --verbose for details!`));
+				if (this.options.verbose) {
+					console.error(chalk.red(e.message));
+				}
+				return;
+			}
+
+			if (this.options.verbose) {
+				this.log(`Using commit ${commitSHA} from @${generator.org}/${generator.name}#${generator.branch}...`);
+			}
+			const shaMarker = path.join(generatorPath, `.${commitSHA}`);
+
+			if (fs.existsSync(generatorPath) && !this.options.skipUpdate) {
+				// check if the SHA marker exists to know whether the generator is up-to-date or not
+				if (this.options.forceUpdate || !fs.existsSync(shaMarker)) {
+					if (this.options.verbose) {
+						this.log(`Generator "${generator.name}" in "${generatorPath}" is outdated...`);
+					}
+					// remove if the SHA marker doesn't exist => outdated!
+					this._showBusy(`  Removing old "${generator.name}" templates`);
+					await rm(generatorPath, { recursive: true });
+				}
+			}
+
+			// re-fetch the generator and extract into local plugin folder
+			if (!fs.existsSync(generatorPath)) {
+				if (this.options.verbose) {
+					this.log(`Extracting ZIP to "${generatorPath}"...`);
+				}
+				this._showBusy(`  Downloading and extracting "${generator.name}" templates`);
+				const reqZIPArchive = await octokit.repos.downloadZipballArchive({
+					owner: generator.org,
+					repo: generator.name,
+					ref: commitSHA,
+				});
+				const buffer = Buffer.from(new Uint8Array(reqZIPArchive.data));
+				const zip = new AdmZip(buffer);
+				const zipEntries = zip.getEntries();
+				zipEntries.forEach((entry) => {
+					const match = !entry.isDirectory && entry.entryName.match(/[^\/]+(\/.+)/);
+					let entryPath;
+					if (generator.dir && match && match[1].startsWith(generator.dir)) {
+						entryPath = path.dirname(match[1].substring(generator.dir.length));
+					} else if (!generator.dir && match) {
+						entryPath = path.dirname(match[1]);
+					}
+					if (entryPath) {
+						zip.extractEntryTo(entry, path.join(generatorPath, entryPath), false, true);
+					}
+				});
+				fs.writeFileSync(shaMarker, commitSHA);
+
+				// run yarn/npm install
+				if (this.options.verbose) {
+					this.log("Installing the plugin dependencies...");
+				}
+				this._showBusy(`  Preparing "${generator.name}"`);
+				await new Promise(
+					function (resolve, reject) {
+						spawn(hasYarn() ? "yarn" : "npm", ["install", "--no-progress", "--ignore-engines"], {
+							stdio: this.config.verbose ? "inherit" : "ignore",
+							cwd: generatorPath,
+							env: {
+								...process.env,
+								NO_UPDATE_NOTIFIER: true,
+							},
+						})
+							.on("exit", function (code) {
+								resolve(code);
+							})
+							.on("error", function (err) {
+								reject(err);
+							});
+					}.bind(this)
+				);
+			}
+
+			this._clearBusy(true);
+		}
+
+		// filter the local options and the help command
+		const opts = Object.keys(this._options).filter((optionName) => !(generatorOptions.hasOwnProperty(optionName) || optionName === "help"));
+
+		// create the env for the plugin generator
+		let env = this.env; // in case of Yeoman UI the env is injected!
+		if (!env) {
+			const yeoman = require("yeoman-environment");
+			env = yeoman.createEnv(this.args, opts);
+		}
+
+		// helper to derive the subcommand
+		function deriveSubcommand(namespace) {
+			const match = namespace.match(/[^:]+:(.+)/);
+			return match ? match[1] : namespace;
+		}
+
+		// filter the hidden subgenerators already
+		//   -> subgenerators must be found in env as they are returned by lookup!
+		let subGenerators = env.lookup({ localOnly: true, packagePaths: generatorPath }).filter((sub) => {
+			const subGenerator = env.get(sub.namespace);
+			return !subGenerator.hidden;
+		});
+
+		// list the available subgenerators in the console (as help)
+		if (this.options.list) {
+			let maxLength = 0;
+			this.log(
+				subGenerators
+					.map((sub) => {
+						maxLength = Math.max(sub.namespace.length, maxLength);
+						return sub;
+					})
+					.reduce((output, sub) => {
+						const subGenerator = env.get(sub.namespace);
+						const displayName = subGenerator.displayName || "";
+						let line = `  ${deriveSubcommand(sub.namespace).padEnd(maxLength + 2)}`;
+						if (displayName) {
+							line += ` # ${subGenerator.displayName}`;
+						}
+						return `${output}\n${line}`;
+					}, `Subcommands (${subGenerators.length}):`)
+			);
+			return;
+		}
+
+		// if a subcommand is provided as argument, identify the matching subgenerator
+		// and remove the rest of the subgenerators from the list for later steps
+		if (this.options.subcommand) {
+			const selectedSubGenerator = subGenerators.filter((sub) => {
+				// identify the subgenerator by subcommand
+				return new RegExp(`:${this.options.subcommand}$`).test(sub.namespace);
+			});
+			if (selectedSubGenerator.length == 1) {
+				subGenerators = selectedSubGenerator;
+			} else {
+				this.log(`The generator ${chalk.red(this.options.generator)} has no subcommand ${chalk.red(this.options.subcommand)}. Please select an existing subcommand!`);
+			}
+		}
+
+		// transform the list of the subgenerators and identify the
+		// default subgenerator for the default selection
+		let defaultSubGenerator;
+		let maxLength = 0;
+		subGenerators = subGenerators
+			.map((sub) => {
+				const subGenerator = env.get(sub.namespace);
+				let subcommand = deriveSubcommand(sub.namespace);
+				let displayName = subGenerator.displayName || subcommand;
+				maxLength = Math.max(displayName.length, maxLength);
+				return {
+					subcommand,
+					displayName,
+					sub,
+				};
+			})
+			.map(({ subcommand, displayName, sub }) => {
+				const transformed = {
+					name: `${displayName.padEnd(maxLength + 2)} [${subcommand}]`,
+					value: sub.namespace,
+				};
+				if (/:app$/.test(sub.namespace)) {
+					defaultSubGenerator = transformed;
+				}
+				return transformed;
+			});
+
+		// at least 1 subgenerator must be present
+		if (subGenerators.length >= 1) {
+			// by default the 1st subgenerator is used
+			let subGenerator = subGenerators[0].value;
+
+			// if more than 1 subgenerator is present
+			// ask the developer to select one!
+			if (subGenerators.length > 1) {
+				subGenerator = (
+					await this.prompt([
+						{
+							type: "list",
+							name: "subGenerator",
+							message: "What do you want to do?",
+							default: defaultSubGenerator && defaultSubGenerator.value,
+							choices: subGenerators,
+						},
+					])
+				).subGenerator;
+			}
+
+			if (this.options.verbose) {
+				this.log(`Calling ${chalk.red(subGenerator)}...\n  \\_ in: ${generatorPath}`);
+			}
+
+			// finally, run the subgenerator
+			env.run(subGenerator, {
+				verbose: this.options.verbose,
+				embedded: true,
+				destinationRoot: this.destinationRoot(),
+			});
+		} else {
+			this.log(`The generator ${chalk.red(this.options.generator)} has no visible subgenerators!`);
+		}
+	}
 };