@eclipse-glsp/cli 1.1.0-next.4846de1.120

package/src/commands/release/release-theia-integration.ts

@@ -0,0 +1,77 @@
+/********************************************************************************
+ * Copyright (c) 2022 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the Eclipse
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
+ * with the GNU Classpath Exception which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ ********************************************************************************/
+
+import * as sh from 'shelljs';
+import { LOGGER } from '../../util/logger';
+import {
+    asMvnVersion,
+    checkoutAndCd,
+    commitAndTag,
+    isExistingMavenVersion,
+    lernaSetVersion,
+    publish,
+    ReleaseOptions,
+    updateLernaForDryRun,
+    updateServerConfig,
+    updateVersion,
+    yarnInstall
+} from './common';
+
+let REPO_ROOT: string;
+
+export async function releaseTheiaIntegration(options: ReleaseOptions): Promise<void> {
+    LOGGER.info('Prepare glsp-theia-integration release');
+    LOGGER.debug('Release options: ', options);
+    REPO_ROOT = checkoutAndCd(options);
+    updateExternalGLSPDependencies(options.version);
+    await updateDownloadServerScript(options.version);
+    generateChangeLog();
+    lernaSetVersion(REPO_ROOT, options.version);
+    build();
+    if (options.npmDryRun) {
+        updateLernaForDryRun();
+    }
+    commitAndTag(options.version, REPO_ROOT);
+    publish(REPO_ROOT, options);
+}
+
+function updateExternalGLSPDependencies(version: string): void {
+    LOGGER.info('Update external GLSP dependencies (Client and workflow example)');
+    sh.cd(REPO_ROOT);
+    updateVersion({ name: '@eclipse-glsp/client', version }, { name: '@eclipse-glsp-examples/workflow-glsp', version });
+}
+
+async function updateDownloadServerScript(version: string): Promise<void> {
+    LOGGER.info('Update example server download config');
+    const mvnVersion = asMvnVersion(version);
+    if (!isExistingMavenVersion('org.eclipse.glsp', 'org.eclipse.glsp.server', mvnVersion)) {
+        LOGGER.warn(`No Java GLSP server with version ${mvnVersion} found on maven central!. Please release a new Java GLSP Server version
+        before publishing this release!`);
+    }
+
+    sh.cd(`${REPO_ROOT}/examples/workflow-theia/src/node`);
+    updateServerConfig('server-config.json', mvnVersion, false);
+}
+
+function build(): void {
+    LOGGER.info('Install & Build with yarn');
+    yarnInstall(REPO_ROOT);
+    LOGGER.debug('Build successful');
+}
+
+function generateChangeLog(): void {
+    // do nothing for now
+}

package/src/commands/release/release-vscode-integration.ts

@@ -0,0 +1,65 @@
+/********************************************************************************
+ * Copyright (c) 2022 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the Eclipse
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
+ * with the GNU Classpath Exception which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ ********************************************************************************/
+
+import * as sh from 'shelljs';
+import { LOGGER } from '../../util/logger';
+import {
+    checkoutAndCd,
+    commitAndTag,
+    lernaSetVersion,
+    publish,
+    ReleaseOptions,
+    updateLernaForDryRun,
+    updateVersion,
+    yarnInstall
+} from './common';
+
+let REPO_ROOT: string;
+
+export async function releaseVscodeIntegration(options: ReleaseOptions): Promise<void> {
+    LOGGER.info('Prepare glsp-vscode-integration release');
+    LOGGER.debug('Release options: ', options);
+    REPO_ROOT = checkoutAndCd(options);
+    updateExternalGLSPDependencies(options.version);
+    generateChangeLog();
+    lernaSetVersion(REPO_ROOT, options.version);
+    build();
+    if (options.npmDryRun) {
+        updateLernaForDryRun();
+    }
+    commitAndTag(options.version, REPO_ROOT);
+    publish(REPO_ROOT, options);
+}
+
+function updateExternalGLSPDependencies(version: string): void {
+    LOGGER.info('Update external GLSP dependencies (Protocol)');
+    sh.cd(REPO_ROOT);
+    updateVersion(
+        { name: '@eclipse-glsp/protocol', version },
+        { name: '@eclipse-glsp/client', version },
+        { name: '@eclipse-glsp-examples/workflow-glsp', version }
+    );
+}
+
+function build(): void {
+    LOGGER.info('Install & Build with yarn');
+    yarnInstall(REPO_ROOT);
+    LOGGER.debug('Build successful');
+}
+
+function generateChangeLog(): void {
+    // do nothing for now
+}

package/src/commands/release/release.ts

@@ -0,0 +1,215 @@
+/********************************************************************************
+ * Copyright (c) 2022 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the Eclipse
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
+ * with the GNU Classpath Exception which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ ********************************************************************************/
+import { ChildProcess } from 'child_process';
+import { Argument } from 'commander';
+import { exit } from 'process';
+import { createInterface } from 'readline';
+import * as readline from 'readline-sync';
+import * as semver from 'semver';
+import * as sh from 'shelljs';
+import { baseCommand, configureShell, fatalExec, getShellConfig } from '../../util/command-util';
+import { configureLogger, LOGGER } from '../../util/logger';
+import { validateDirectory, validateVersion } from '../../util/validation-util';
+import {
+    asMvnVersion,
+    checkIfMavenVersionExists,
+    checkIfNpmVersionExists,
+    Component,
+    ReleaseOptions,
+    ReleaseType,
+    VERDACCIO_REGISTRY
+} from './common';
+import { releaseClient } from './release-client';
+import { releaseEclipseIntegration } from './release-eclipse-integration';
+import { releaseJavaServer } from './release-java-server';
+import { releaseServerNode } from './release-server-node';
+import { releaseTheiaIntegration } from './release-theia-integration';
+import { releaseVscodeIntegration } from './release-vscode-integration';
+
+interface ReleaseCmdOptions {
+    checkoutDir: string;
+    branch: string;
+    force: boolean;
+    publish: boolean;
+    npmDryRun: boolean;
+    draft: boolean;
+    verbose: boolean;
+}
+
+export const ReleaseCommand = baseCommand()
+    .name('release')
+    .description('Prepare & publish a new release for a glsp component')
+    .addArgument(new Argument('<component>', 'The glsp component to be released').choices(Component.CLI_CHOICES).argParser(Component.parse))
+    .addArgument(new Argument('<releaseType>', 'The release type').choices(ReleaseType.CLI_CHOICES))
+    .argument('[customVersion]', 'Custom version number. Will be ignored if the release type is not "custom"', validateVersion)
+    .option('-f, --force', 'Enable force mode', false)
+    .option('-d, --checkoutDir <checkoutDir>', 'The git checkout directory', validateDirectory, process.cwd())
+    .option('-b, --branch <branch>', 'The git branch to checkout', 'master')
+    .option('-v, --verbose', 'Enable verbose (debug) log output', false)
+    .option('--no-publish', 'Only prepare release but do not publish to github', true)
+    .option('--draft', 'Publish github releases as drafts', false)
+    .option(
+        '--npm-dryRun',
+        'Execute a npm dry-run for inspection. Publishes to the local npm registry and does not publish to github',
+        false
+    )
+    .action(release);
+
+let verdaccioChildProcess: ChildProcess | undefined = undefined;
+
+export async function release(
+    component: Component,
+    releaseType: ReleaseType,
+    customVersion: string | undefined,
+    cliOptions: ReleaseCmdOptions
+): Promise<void> {
+    try {
+        LOGGER.debug('Cli options:', cliOptions);
+        configureShell({ silent: !cliOptions.verbose });
+        configureLogger(cliOptions.verbose);
+        checkGHCli();
+        const version = deriveVersion(releaseType, customVersion);
+        const options: ReleaseOptions = { ...cliOptions, component, releaseType, version };
+        if (cliOptions.npmDryRun && options.component.releaseRepo === 'npm') {
+            await launchVerdaccio().catch(error => LOGGER.error('Error occurred during verdaccio launch', error));
+        }
+        switch (component.type) {
+            case 'server-java':
+                checkIfMavenVersionExists('org.eclipse.glsp', 'org.eclipse.glsp.server', asMvnVersion(version));
+                return releaseJavaServer(options);
+            case 'server-node':
+                await checkIfNpmVersionExists('@eclipse-glsp/server-node', version);
+                return releaseServerNode(options);
+            case 'client':
+                await checkIfNpmVersionExists('@eclipse-glsp/client', version);
+                return releaseClient(options);
+            case 'theia-integration':
+                await checkIfNpmVersionExists('@eclipse-glsp/theia-integration', version);
+                return releaseTheiaIntegration(options);
+            case 'vscode-integration':
+                await checkIfNpmVersionExists('@eclipse-glsp/vscode-integration', version);
+                return releaseVscodeIntegration(options);
+            case 'eclipse-integration':
+                await checkIfNpmVersionExists('@eclipse-glsp/ide', version);
+                return releaseEclipseIntegration(options);
+        }
+    } catch (err) {
+        console.error('An error occurred during command execution:', err);
+        exit(1);
+    } finally {
+        if (verdaccioChildProcess) {
+            verdaccioChildProcess.kill();
+        }
+    }
+}
+
+function checkGHCli(): void {
+    LOGGER.debug('Verify that Github CLI is configured correctly');
+    if (!isGithubCLIAuthenticated()) {
+        throw new Error("Github CLI is not configured properly. No user is logged in for host 'github.com'");
+    }
+}
+
+function isGithubCLIAuthenticated(): boolean {
+    LOGGER.debug('Verify that Github CLI is installed');
+    fatalExec('which gh', 'Github CLI is not installed!');
+
+    const status = sh.exec('gh auth status', getShellConfig());
+    if (status.code !== 0) {
+        if (status.stderr.includes('You are not logged into any GitHub hosts')) {
+            return false;
+        }
+        throw new Error(status.stderr);
+    }
+    if (!status.stderr.trim().includes('Logged in to github.com')) {
+        LOGGER.debug("No user is logged in for host 'github.com'");
+        return false;
+    }
+    LOGGER.debug('Github CLI is authenticated and ready to use');
+    return true;
+}
+
+function launchVerdaccio(): Promise<void> {
+    LOGGER.debug('Verify that verdaccio is installed and start if necessary');
+    fatalExec('which verdaccio', 'Verdaccio is not installed!');
+    // Check if verdaccio is alreaddy running
+    const result = sh.exec(`curl -i ${VERDACCIO_REGISTRY}`, getShellConfig());
+    if (result.code !== 0) {
+        LOGGER.info('Starting local verdaccio registry');
+        verdaccioChildProcess = sh.exec('verdaccio', { async: true, silent: true });
+        return new Promise(resolve => {
+            createInterface(verdaccioChildProcess!.stdout!).on('line', line => {
+                if (line.includes(`http address - ${VERDACCIO_REGISTRY}`)) {
+                    resolve();
+                }
+            });
+        });
+    }
+    return Promise.resolve();
+}
+
+function deriveVersion(releaseType: ReleaseType, customVersion?: string): string {
+    LOGGER.debug(`Derive version from release type: ${release}`);
+    switch (releaseType) {
+        case 'custom':
+            return getCustomVersion(customVersion);
+        case 'rc':
+            return getRCVersion();
+        case 'patch':
+        case 'major':
+        case 'minor':
+            return semverInc(releaseType);
+    }
+}
+
+const REFERENCE_NPM_PACKAGE = '@eclipse-glsp/ide';
+
+function getRCVersion(): string {
+    LOGGER.debug('Retrieve and new RC version');
+    const newBaseVersion = semverInc('minor');
+    const currentRcVersion = sh.exec(`npm view ${REFERENCE_NPM_PACKAGE} dist-tags.rc`, getShellConfig()).stdout.trim();
+    const currentRcBaseVersion = currentRcVersion.split('-')[0];
+    if (currentRcBaseVersion !== newBaseVersion) {
+        return `${newBaseVersion}-RC01`;
+    }
+    let rcNumber = Number.parseInt(currentRcVersion.replace(`${currentRcBaseVersion}-RC`, ''), 10);
+    rcNumber++;
+
+    return `${newBaseVersion}-RC` + `${rcNumber}`.padStart(2, '0');
+}
+
+function getCustomVersion(customVersion?: string): string {
+    LOGGER.debug('Retrieve and validate custom version');
+    LOGGER.debug(customVersion ? `Custom version has been passed as argument: ${customVersion}` : 'Prompt custom version from user');
+    const version = customVersion ?? readline.question('> Please enter the new version');
+    return validateVersion(version);
+}
+
+function getCurrentVersion(): string {
+    LOGGER.debug('Retrieve base version by querying the latest tag of the reference npm package');
+    const version = sh.exec(`npm view ${REFERENCE_NPM_PACKAGE} dist-tags.latest`, getShellConfig()).stdout.trim();
+    return validateVersion(version);
+}
+
+function semverInc(releaseType: semver.ReleaseType, identifier?: string): string {
+    const currentVersion = getCurrentVersion();
+    LOGGER.debug(`Execute: semver.inc("${currentVersion}", ${releaseType}, ${identifier})`);
+    const newVersion = semver.inc(currentVersion, releaseType, identifier);
+    if (!newVersion) {
+        throw new Error(`Could not increment version: ${currentVersion} `);
+    }
+    return newVersion;
+}

package/src/util/command-util.ts

@@ -0,0 +1,54 @@
+/********************************************************************************
+ * Copyright (c) 2022 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the Eclipse
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
+ * with the GNU Classpath Exception which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ ********************************************************************************/
+import { Command } from 'commander';
+import * as sh from 'shelljs';
+
+// Commander.js utils
+export function baseCommand(cmd = new Command()): Command {
+    return cmd //
+        .showSuggestionAfterError(true)
+        .showHelpAfterError(true)
+        .allowUnknownOption(false);
+}
+
+export type ShellConfig = sh.ExecOptions & { async: false };
+export const SH_CONFIG: ShellConfig = {
+    async: false,
+    fatal: true,
+    silent: false
+};
+
+export function getShellConfig(options: Partial<Omit<ShellConfig, 'async'>> = {}): ShellConfig {
+    return {
+        ...SH_CONFIG,
+        ...options
+    };
+}
+
+export function configureShell(config: Partial<sh.ShellConfig>): void {
+    sh.config.reset();
+    getShellConfig({});
+    SH_CONFIG.silent = config.silent;
+    SH_CONFIG.fatal = config.fatal;
+}
+
+export function fatalExec(command: string, fatalErrorMessage: string, options: Partial<Omit<ShellConfig, 'async'>> = {}): sh.ShellString {
+    const result = sh.exec(command, getShellConfig(options));
+    if (result.code !== 0) {
+        throw new Error(fatalErrorMessage);
+    }
+    return result;
+}

package/src/util/git-util.ts

@@ -0,0 +1,172 @@
+/********************************************************************************
+ * Copyright (c) 2022 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the Eclipse
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
+ * with the GNU Classpath Exception which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ ********************************************************************************/
+
+import { resolve } from 'path';
+import * as sh from 'shelljs';
+import { getShellConfig } from './command-util';
+
+export function isGitRepository(path?: string): boolean {
+    cdIfPresent(path);
+    const isGitRepo =
+        sh
+            .exec('git rev-parse --is-inside-work-tree', getShellConfig({ silent: true }))
+            .stdout.trim()
+            .toLocaleLowerCase() === 'true';
+    return isGitRepo;
+}
+
+export function getGitRoot(path?: string): string {
+    cdIfPresent(path);
+    const fileString = sh.exec('git rev-parse --show-toplevel', getShellConfig()).stdout.trim();
+    return resolve(fileString);
+}
+
+export function hasGitChanges(path?: string): boolean {
+    return getUncommittedChanges(path).length > 0;
+}
+
+/**
+ * Returns the files that have uncommitted changes (staged, not staged and untracked) of a git repository.
+ * Filepaths are absolute.
+ */
+export function getUncommittedChanges(path?: string): string[] {
+    cdIfPresent(path);
+    return sh
+        .exec('git status --porcelain', getShellConfig())
+        .stdout.trim()
+        .split('\n')
+        .map(fileInfo =>
+            // Extract relative file path from the info string and convert to absolute path
+            resolve(path ?? process.cwd(), fileInfo.trim().split(' ').pop() ?? '')
+        );
+}
+
+/**
+ * Returns the files tha have been changed with the last commit (also includes currently staged but uncommitted changes)
+ * Filepaths are absolute.
+ */
+export function getChangesOfLastCommit(path?: string): string[] {
+    cdIfPresent(path);
+    return sh
+        .exec('git diff --name-only HEAD^', getShellConfig())
+        .stdout.trim()
+        .split('\n')
+        .map(file => resolve(path ?? process.cwd(), file));
+}
+
+/**
+ * Returns the last modification date of a file (or the last commit) in a git repo.
+ * @param filePath The file. If undefined the modification date of the last commit will be returned
+ * @param repoRoot The path to the repo root. If undefined the current working directory is used.
+ * @returns The date or undefined if the file is outside of the git repo.
+ */
+export function getLastModificationDate(filePath?: string, repoRoot?: string): Date | undefined {
+    cdIfPresent(repoRoot);
+    const result = sh.exec(`git log -1 --pretty="format:%ci" ${filePath ?? ''}`, getShellConfig());
+    if (result.code !== 0) {
+        return undefined;
+    }
+    return new Date(result.stdout.trim());
+}
+/**
+ * Returns the last modification date of a file in a git repo.
+ * @param filePath The file
+ * @param repoRoot The path to the repo root. If undefined the current working directory is used.
+ * @returns The date or undefined if the file is outside of the git repo.
+ */
+export function getFirstModificationDate(filePath: string, repoRoot?: string): Date | undefined {
+    cdIfPresent(repoRoot);
+    const result = sh.exec(`git log --pretty="format:%ci" --follow ${filePath}`, getShellConfig());
+    if (result.code !== 0) {
+        return undefined;
+    }
+    const datesString = result.stdout.trim();
+    if (datesString.length === 0) {
+        return new Date();
+    }
+
+    const date = datesString.split('\n').pop();
+    return date ? new Date(date) : undefined;
+}
+
+export function getFilesOfCommit(commitHash: string, repoRoot?: string): string[] {
+    cdIfPresent(repoRoot);
+    const result = sh.exec(`git show --pretty="" --name-only ${commitHash}`, getShellConfig());
+    if (result.code !== 0) {
+        return [];
+    }
+
+    return result.stdout.trim().split('\n');
+}
+
+/**
+ * Returns the commit hash of the initial commit of the given repository
+ * @param repoRoot The path to the repo root. If undefined the current working directory is used.
+ * @returns The commit hash or undefined if something went wrong.
+ */
+export function getInitialCommit(repoRoot?: string): string | undefined {
+    cdIfPresent(repoRoot);
+    const result = sh.exec('git log --pretty=oneline --reverse', getShellConfig());
+    if (result.code !== 0) {
+        return undefined;
+    }
+    const commits = result.stdout.trim();
+    if (commits.length === 0) {
+        return undefined;
+    }
+    return commits.substring(0, commits.indexOf(' '));
+}
+
+/**
+ * Returns the commit hash of the first commit for a given file (across renames).
+ * @param repoRoot The path to the repo root. If undefined the current working directory is used.
+ * @returns The commit hash or undefined if something went wrong.
+ */
+export function getFirstCommit(filePath: string, repoRoot?: string): string | undefined {
+    cdIfPresent(repoRoot);
+    const result = sh.exec(`git log --follow  --pretty=format:"%H" ${filePath}`, getShellConfig());
+    if (result.code !== 0) {
+        return undefined;
+    }
+    return result.stdout.trim().split('\n').pop();
+}
+
+export function getLatestGithubRelease(path?: string): string {
+    cdIfPresent(path);
+    const release = sh.exec('gh release list --exclude-drafts -L 1', getShellConfig()).stdout.trim().split('\t');
+    return release[release.length - 2];
+}
+
+export function getLatestTag(path?: string): string {
+    cdIfPresent(path);
+    return sh.exec('git describe --abbrev=0 --tags', getShellConfig()).stdout.trim();
+}
+
+export function hasBranch(branch: string, path?: string): boolean {
+    cdIfPresent(path);
+    return sh.exec(`git branch --list ${branch}`, getShellConfig()).stdout.trim().length !== 0;
+}
+
+export function getRemoteUrl(path?: string): string {
+    cdIfPresent(path);
+    return sh.exec('git config --get remote.origin.url', getShellConfig()).stdout.trim();
+}
+
+function cdIfPresent(path?: string): void {
+    if (path) {
+        sh.cd(path);
+    }
+}

package/src/util/logger.ts

@@ -0,0 +1,57 @@
+/********************************************************************************
+ * Copyright (c) 2022 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License v. 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0.
+ *
+ * This Source Code may also be made available under the following Secondary
+ * Licenses when the conditions for such availability set forth in the Eclipse
+ * Public License v. 2.0 are satisfied: GNU General Public License, version 2
+ * with the GNU Classpath Exception which is available at
+ * https://www.gnu.org/software/classpath/license.html.
+ *
+ * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+ ********************************************************************************/
+
+export interface Logger extends Pick<Console, LogLevel> {
+    newLine(): void;
+}
+
+export type LogLevel = 'info' | 'debug' | 'error' | 'warn';
+
+const levels: Record<LogLevel, { threshold: number; color: string }> = {
+    error: { threshold: 0, color: '\x1b[31m' }, // red
+    warn: { threshold: 1, color: '\x1b[33m' }, // yellow
+    info: { threshold: 2, color: '\x1b[0m' }, // default terminal color
+    debug: { threshold: 3, color: '\x1b[32m' } // green
+};
+
+let levelThreshold: number = levels.info.threshold;
+
+export const LOGGER: Logger = {
+    info: (...args) => log('info', ...args),
+    error: (...args) => log('error', ...args),
+    warn: (...args) => log('warn', ...args),
+    debug: (...args) => log('debug', ...args),
+    newLine: () => console.log('')
+} as const;
+
+function log(level: LogLevel, ...args: any[]): void {
+    const levelData = levels[level];
+    if (levelThreshold < levelData.threshold) {
+        return;
+    }
+    console[level](levelData.color, ...args, '\x1b[0m');
+}
+
+export function configureLogger(level: LogLevel): void;
+export function configureLogger(verbose: boolean): void;
+export function configureLogger(levelOrVerbose: LogLevel | boolean): void {
+    if (typeof levelOrVerbose === 'boolean') {
+        const level: LogLevel = levelOrVerbose ? 'debug' : 'info';
+        levelThreshold = levels[level].threshold;
+    } else {
+        levelThreshold = levels[levelOrVerbose].threshold;
+    }
+}