3.2.0

.gitlab-ci.yml

@@ -1,128 +0,0 @@
-# gitzone ci_default
-image: registry.gitlab.com/hosttoday/ht-docker-node:npmci
-
-cache:
-  paths:
-    - .npmci_cache/
-  key: '$CI_BUILD_STAGE'
-
-stages:
-  - security
-  - test
-  - release
-  - metadata
-
-before_script:
-  - pnpm install -g pnpm
-  - pnpm install -g @shipzone/npmci
-  - npmci npm prepare
-
-# ====================
-# security stage
-# ====================
-# ====================
-# security stage
-# ====================
-auditProductionDependencies:
-  image: registry.gitlab.com/hosttoday/ht-docker-node:npmci
-  stage: security
-  script:
-     - npmci command npm config set registry https://registry.npmjs.org
-     - npmci command pnpm audit --audit-level=high --prod
-  tags:
-    - lossless
-    - docker
-  allow_failure: true
-
-auditDevDependencies:
-  image: registry.gitlab.com/hosttoday/ht-docker-node:npmci
-  stage: security
-  script:
-    - npmci command npm config set registry https://registry.npmjs.org
-    - npmci command pnpm audit --audit-level=high --dev
-  tags:
-    - lossless
-    - docker
-  allow_failure: true
-
-# ====================
-# test stage
-# ====================
-
-testStable:
-  stage: test
-  script:
-    - npmci node install stable
-    - npmci npm install
-    - npmci npm test
-  coverage: /\d+.?\d+?\%\s*coverage/
-  tags:
-    - docker
-
-testBuild:
-  stage: test
-  script:
-    - npmci node install stable
-    - npmci npm install
-    - npmci npm build
-  coverage: /\d+.?\d+?\%\s*coverage/
-  tags:
-    - docker
-
-release:
-  stage: release
-  script:
-    - npmci node install stable
-    - npmci npm publish
-  only:
-    - tags
-  tags:
-    - lossless
-    - docker
-    - notpriv
-
-# ====================
-# metadata stage
-# ====================
-codequality:
-  stage: metadata
-  allow_failure: true
-  only:
-    - tags
-  script:
-    - npmci command npm install -g typescript
-    - npmci npm prepare
-    - npmci npm install
-  tags:
-    - lossless
-    - docker
-    - priv
-
-trigger:
-  stage: metadata
-  script:
-    - npmci trigger
-  only:
-    - tags
-  tags:
-    - lossless
-    - docker
-    - notpriv
-
-pages:
-  stage: metadata
-  script:
-    - npmci node install stable
-    - npmci npm install
-    - npmci command npm run buildDocs
-  tags:
-    - lossless
-    - docker
-    - notpriv
-  only:
-    - tags
-  artifacts:
-    expire_in: 1 week
-    paths:
-      - public
-  allow_failure: true

changelog.md

@@ -0,0 +1,69 @@
+# Changelog
+
+## 2024-12-09 - 3.2.0 - feat(SmartExecution)
+Add support for scheduling restarts to SmartExecution
+
+- Introduced the ability to handle consecutive restarts efficiently in SmartExecution.
+- Ensures that multiple restart requests merge into a single additional restart request if one is already in progress.
+
+## 2024-12-09 - 3.1.0 - feat(core)
+Refactor codebase and update dependencies.
+
+- Refactored core classes with improved structure and modularization.
+- Updated tsbuild, tsrun, tapbundle, and @types/node dependencies to newer versions.
+- Improved build script in package.json to use tsbuild with tsfolders.
+
+## 2024-09-17 - 3.0.6 - fix(core)
+Fix interactive shell execution and update dependencies
+
+- Corrected the interactive shell execution logic by separating it into a dedicated method.
+- Updated development dependencies for `@git.zone/tsbuild`, `@git.zone/tsrun`, `@git.zone/tstest`, `@push.rocks/tapbundle`, and `@types/node`.
+- Updated runtime dependencies for `@push.rocks/smartpromise`, and `@types/which`.
+- Removed legacy .gitlab-ci.yml file.
+
+## 2024-05-29 - 3.0.5 - Documentation
+update description
+
+## 2024-04-18 - 3.0.4 to 3.0.5 - Maintenance
+Bug fixes and configuration updates
+
+- fix(core): update
+- update tsconfig
+- update npmextra.json: githost
+
+## 2024-03-16 - 3.0.3 to 3.0.4 - Maintenance
+Bug fixes
+
+- fix(core): update
+
+## 2023-06-22 - 2.0.30 to 3.0.3 - Major Update
+Major changes including breaking changes, bug fixes, and improvements.
+
+- BREAKING CHANGE(core): switched to ES syntax and added support for interactivity
+- fix(core): update
+
+## 2021-11-07 - 2.0.27 to 2.0.30 - Maintenance
+Bug fixes
+
+- fix(core): cosmetics
+- fix(core): update
+
+## 2021-08-17 - 2.0.26 to 2.0.27 - Maintenance
+Bug fixes
+
+- fix(core): update
+
+## 2020-05-22 - 2.0.25 to 2.0.26 - Maintenance
+Bug fixes
+
+- fix(core): update
+
+## 2019-08-27 - 2.0.22 to 2.0.25 - Maintenance
+Bug fixes
+
+- fix(core): update
+
+## 2019-05-28 - 2.0.16 to 2.0.22 - Maintenance
+Bug fixes
+
+- fix(core): update

package.json

@@ -1,19 +1,19 @@
 {
   "name": "@push.rocks/smartshell",
   "private": false,
-  "version": "3.0.5",
+  "version": "3.2.0",
   "description": "A library for executing shell commands using promises.",
   "main": "dist_ts/index.js",
   "typings": "dist_ts/index.d.ts",
   "type": "module",
   "scripts": {
     "test": "(tstest test/)",
-    "build": "(tsbuild --web)",
+    "build": "(tsbuild tsfolders --web)",
     "buildDocs": "tsdoc"
   },
   "repository": {
     "type": "git",
-    "url": "git+ssh://git@gitlab.com/pushrocks/smartshell.git"
+    "url": "https://code.foss.global/push.rocks/smartshell.git"
   },
   "keywords": [
     "shell commands",
@@ -31,21 +31,21 @@
   "bugs": {
     "url": "https://gitlab.com/pushrocks/smartshell/issues"
   },
-  "homepage": "https://gitlab.com/pushrocks/smartshell#README",
+  "homepage": "https://code.foss.global/push.rocks/smartshell",
   "devDependencies": {
-    "@git.zone/tsbuild": "^2.1.66",
-    "@git.zone/tsrun": "^1.2.44",
-    "@git.zone/tstest": "^1.0.77",
-    "@push.rocks/tapbundle": "^5.0.23",
-    "@types/node": "^20.12.7"
+    "@git.zone/tsbuild": "^2.2.0",
+    "@git.zone/tsrun": "^1.3.3",
+    "@git.zone/tstest": "^1.0.90",
+    "@push.rocks/tapbundle": "^5.5.3",
+    "@types/node": "^22.10.1"
   },
   "dependencies": {
     "@push.rocks/smartdelay": "^3.0.1",
     "@push.rocks/smartexit": "^1.0.23",
-    "@push.rocks/smartpromise": "^4.0.2",
-    "@types/which": "^3.0.3",
+    "@push.rocks/smartpromise": "^4.0.4",
+    "@types/which": "^3.0.4",
     "tree-kill": "^1.2.2",
-    "which": "^4.0.0"
+    "which": "^5.0.0"
   },
   "files": [
     "ts/**/*",

ts/00_commitinfo_data.ts

@@ -1,8 +1,8 @@
 /**
- * autocreated commitinfo by @pushrocks/commitinfo
+ * autocreated commitinfo by @push.rocks/commitinfo
  */
 export const commitinfo = {
   name: '@push.rocks/smartshell',
-  version: '3.0.5',
+  version: '3.2.0',
   description: 'A library for executing shell commands using promises.'
 }

ts/classes.shelllog.ts

@@ -1,4 +1,4 @@
-import * as plugins from './smartshell.plugins.js';
+import * as plugins from './plugins.js';
 
 /**
  * a log handler for spawned logs

ts/classes.smartexecution.ts

@@ -0,0 +1,55 @@
+import * as plugins from './plugins.js';
+import { Smartshell, type IExecResultStreaming } from './classes.smartshell.js';
+
+export interface IDeferred<T> {
+  resolve: (value?: T | PromiseLike<T>) => void;
+  reject: (reason?: any) => void;
+  promise: Promise<T>;
+}
+
+export class SmartExecution {
+  public smartshell: Smartshell;
+  public currentStreamingExecution: IExecResultStreaming;
+  public commandString: string;
+
+  private isRestartInProgress = false;
+  private isAnotherRestartRequested = false;
+
+  constructor(commandStringArg: string) {
+    this.commandString = commandStringArg;
+  }
+
+  /**
+   * Schedules a restart. If a restart is currently in progress, any additional calls
+   * to restart will merge into a single additional restart request, which will only execute
+   * once the current restart completes.
+   */
+  public async restart(): Promise<void> {
+    if (this.isRestartInProgress) {
+      // If there's already a restart in progress, just mark that another restart was requested
+      this.isAnotherRestartRequested = true;
+      return;
+    }
+
+    this.isRestartInProgress = true;
+    try {
+      if (!this.smartshell) {
+        this.smartshell = new Smartshell({
+          executor: 'bash',
+        });
+      }
+      if (this.currentStreamingExecution) {
+        await this.currentStreamingExecution.kill();
+      }
+      this.currentStreamingExecution = await this.smartshell.execStreaming(this.commandString);
+    } finally {
+      this.isRestartInProgress = false;
+    }
+
+    // If another restart was requested while we were busy, we handle it now
+    if (this.isAnotherRestartRequested) {
+      this.isAnotherRestartRequested = false;
+      await this.restart();
+    }
+  }
+}

ts/classes.smartshell.ts

@@ -1,7 +1,7 @@
-import * as plugins from './smartshell.plugins.js';
-import { ShellEnv } from './smartshell.classes.shellenv.js';
-import type { IShellEnvContructorOptions, TExecutor } from './smartshell.classes.shellenv.js';
-import { ShellLog } from './smartshell.classes.shelllog.js';
+import * as plugins from './plugins.js';
+import { ShellEnv } from './classes.shellenv.js';
+import type { IShellEnvContructorOptions, TExecutor } from './classes.shellenv.js';
+import { ShellLog } from './classes.shelllog.js';
 
 import * as cp from 'child_process';
 
@@ -39,39 +39,51 @@ export class Smartshell {
     interactive?: boolean;
   }): Promise<IExecResult | IExecResultStreaming | void> {
     if (options.interactive) {
-      if (process.env.CI) {
-        return;
-      }
+      return await this._execInteractive(options);
+    }
 
-      const done = plugins.smartpromise.defer();
-      
-      // Notice that stdio is set to 'inherit'
-      const shell = cp.spawn(options.commandString, {
-        stdio: 'inherit',
-        shell: true,
-        detached: true
-      });
-
-      this.smartexit.addProcess(shell);
-
-      shell.on('close', (code) => {
-        console.log(`interactive shell terminated with code ${code}`);
-        this.smartexit.removeProcess(shell);
-        done.resolve();
-      });
-
-      await done.promise;
+    return await this._execCommand(options);
+  }
 
+  private async _execInteractive(options: {
+    commandString: string;
+    interactive?: boolean;
+  }): Promise<void> {
+    if (process.env.CI) {
       return;
     }
 
+    const done = plugins.smartpromise.defer();
+
+    const shell = cp.spawn(options.commandString, {
+      stdio: 'inherit',
+      shell: true,
+      detached: true
+    });
+
+    this.smartexit.addProcess(shell);
+
+    shell.on('close', (code) => {
+      console.log(`interactive shell terminated with code ${code}`);
+      this.smartexit.removeProcess(shell);
+      done.resolve();
+    });
+
+    await done.promise;
+  }
+
+  private async _execCommand(options: {
+    commandString: string;
+    silent?: boolean;
+    strict?: boolean;
+    streaming?: boolean;
+  }): Promise<IExecResult | IExecResultStreaming> {
     const done = plugins.smartpromise.defer<IExecResult | IExecResultStreaming>();
     const childProcessEnded = plugins.smartpromise.defer<IExecResult>();
 
-    let commandToExecute = options.commandString;
-    commandToExecute = this.shellEnv.createEnvExecString(options.commandString);
+    const commandToExecute = this.shellEnv.createEnvExecString(options.commandString);
 
-    const spawnlogInstance = new ShellLog();
+    const shellLogInstance = new ShellLog();
     const execChildProcess = cp.spawn(commandToExecute, [], {
       shell: true,
       cwd: process.cwd(),
@@ -83,16 +95,16 @@ export class Smartshell {
 
     execChildProcess.stdout.on('data', (data) => {
       if (!options.silent) {
-        spawnlogInstance.writeToConsole(data);
+        shellLogInstance.writeToConsole(data);
       }
-      spawnlogInstance.addToBuffer(data);
+      shellLogInstance.addToBuffer(data);
     });
 
     execChildProcess.stderr.on('data', (data) => {
       if (!options.silent) {
-        spawnlogInstance.writeToConsole(data);
+        shellLogInstance.writeToConsole(data);
       }
-      spawnlogInstance.addToBuffer(data);
+      shellLogInstance.addToBuffer(data);
     });
 
     execChildProcess.on('exit', (code, signal) => {
@@ -103,7 +115,7 @@ export class Smartshell {
 
       const execResult = {
         exitCode: code,
-        stdout: spawnlogInstance.logStore.toString(),
+        stdout: shellLogInstance.logStore.toString(),
       };
 
       if (!options.streaming) {
@@ -191,4 +203,4 @@ export class Smartshell {
   public async execAndWaitForLineSilent(commandString: string, regexArg: RegExp) {
     return this.execAndWaitForLine(commandString, regexArg, true);
   }
-}
+}

ts/index.ts

@@ -1,2 +1,3 @@
-export * from './smartshell.classes.smartshell.js';
-export { which } from './smartshell.plugins.js';
+export * from './classes.smartshell.js';
+export * from './classes.smartexecution.js';
+export { which } from './plugins.js';