Развёртывание проекта с нуля

{
  "private": true,
  "devDependencies": {
    "@yamato-daiwa/automation": "0.8.0"
  }
}

npm i

Попытки первого запуска YDA

Если Вы прямо из консоли попробуете вызывать yda, то скорее всего получите сообщение наподобие:

"yda" не является внутренней или внешней командой, исполняемой программной или пакетным файлом.

Объясняется это тем, что установка зависимости в node_modules проекта не делает её обнаруживаемой для консолей. Легче всего исправить это, запустив команду посредством npm-скрипта. Добавьте такой скрипт в package.json:

{
  "private": true,
  "scripts": {
    "build": "yda"
  },
  "devDependencies": {
    "@yamato-daiwa/automation": "0.8.0"
  }
}

Теперь yda можно запустить посредством `npm run`:

npm run build

Будет получено следующее сообщение об ошибке:

InvalidConsoleCommandError: Invalid Console Command
Invalid console command for the application "Yamato Daiwa Automation". The option "--mode" is required for the command "build" (default command phrase). Please check the reference for this command:
● build (default command phrase)
  Builds the projects according to the configuration file ("yda.config.yaml" as default).

  ■ Options

    --mode
      The project building mode; affects to presence or absence of incremental building, browser live reloading, code minification etc.

      ◯ Shortcut: -m
      ◯ Type: string
      ◯ Is Required: Yes
      ◯ Allowed Alternatives:
        ◆ STATIC_PREVIEW
        ◆ LOCAL_DEVELOPMENT
        ◆ TESTING
        ◆ STAGING
        ◆ PRODUCTION

    --selectiveExecution
      Allows to specify the selection of tasks, entry points groups, etc. by selective execution ID, herewith the desired selective execution must be preliminarily defined in the configuration file.

      ◯ Shortcut: -s
      ◯ Type: string
      ◯ Is Required: No

    --configurationFile
      Custom name of the configuration file (the default one is "yda.config.yaml")

      ◯ Shortcut: -c
      ◯ Type: string
      ◯ Is Required: No

Occurrence location: ConsoleCommandsParser.parse(commandLineInterfaceSpecification, argumentsVector)

Из сообщения об ошибке при переводе на русской даже первых четырёх строк причина ошибки абсолютно ясна, но многие начинающие разработчики боятся подобных ошибок и даже не пытаются их прочитать и перевести. А сказано в сообщении то, что для командной фразы build (которая по умолчанию, потому мы её не указали) обязательна опция --mode. Ниже отображена справка по данной командной фразе, где, разумеется, упомянута опция --mode, сказано, что она имеет строковый тип и принимает одно из пяти перечисленных значений. На данном этапе мы можем выбрать любой из них — например, PRODUCTION:

{
  "private": true,
  "scripts": {
    "build": "yda --mode PRODUCTION"
  },
  "devDependencies": {
    "@yamato-daiwa/automation": "0.8.0"
  }
}

Перезапустим утилиту:

npm run build

Возникнет другая ошибка:

FileNotFoundError: File Not Found
The configuration file for "Yamato Daiwa Automation" utility not found at path "D:\IntelliJ IDEA\InHouseDevelopment\YamatoDaiwaAutomation\FunctionalTests\ZeroStart\yda.config.yaml". The "Yamato Daiwa Automation" utility is required the configuration file and will expect the file "yda.config.yaml" at the same directory as CLI has been invoked. You can set custom configuration file name via CLI if you want.

Occurrence location: EntryPoint.interpretAndExecuteConsoleCommand()

Inner error:
FileNotFoundError: File Not Found
File with path "D:\IntelliJ IDEA\InHouseDevelopment\YamatoDaiwaAutomation\FunctionalTests\ZeroStart\yda.config.yaml" not found.

Опять же, при переводе на русский причина ясна и понятна. В ошибке говорится об отсутствии файла конфигурации yda.config.yaml, о том, где этот файл искали, и о том, что этот файл необходим — в общем всё объяснено, даже не надо руководство читать. Поэтому создадим этот файл.