Method spawn

src/back/ManagedChildProcess.ts:105–152

* Spawn process and keep track on it. * * @param auto Automatically restart if exits early

(auto?: boolean)

   * @param auto Automatically restart if exits early
   */
  public spawn(auto?: boolean): void {
    if (!this.process && !this._isRestarting) {
      // Reset the auto restart counter when we've manually / deliberately spawned the process
      if (!auto) {
        this.autoRestartCount = 0;
      }
      // Spawn process
      log.debug('Server', `Executable: ${this.info.filename} - Arguments: ${this.info.arguments.join(' ')}`);
      this.process = spawn(this.info.filename, this.info.arguments, { cwd: this.cwd, detached: this.detached, shell: this.shell, env: this.env});
      // Set start timestamp
      this.startTime = Date.now();
      // Log
      this.logContent(this.name + ' has been started');
      // Setup listeners
      if (this.process.stdout) {
        const stdout = readline.createInterface({ input: this.process.stdout });
        stdout.on('line', this.logContentAny);
      }
      if (this.process.stderr) {
        const stderr = readline.createInterface({ input: this.process.stderr });
        stderr.on('line', this.logContentAny);
      }
      // Update state
      this.setState(ProcessState.RUNNING);
      // Register child process listeners
      this.process.on('exit', (code, signal) => {
        if (code) { this.logContent(`${this.name} exited with code ${code}`);     }
        else      { this.logContent(`${this.name} exited with signal ${signal}`); }
        const wasRunning = (this.state === ProcessState.RUNNING);
        this.process = undefined;
        this.emit('exit', code, signal);
        this.setState(ProcessState.STOPPED);
        if (this.autoRestart && wasRunning && code) {
          if (this.autoRestartCount < MAX_RESTARTS) {
            this.autoRestartCount++;
            this.spawn(true);
          } else {
            this.logContent(`${this.name} Service crashed too frequently, leaving stopped.`);
          }
        }
      })
      .on('error', error => {
        this.logContent(`${this.name} failed to start - ${error.message}`);
        this.setState(ProcessState.STOPPED);
        this.process = undefined;
      });
    }
  }

  /** Politely ask the child process to exit (if it is running). */
  public async kill(): Promise<void> {