Перейти к основному содержимому

Командная строка

Чтобы запустить выполнение скрипта из командной строки, используйте команду executor.

executor [параметры] [скрипт] [аргументы_метода]

Параметры​

При выполнении команды executor вы можете указать следующие параметры:

  • -v, --version — выводит информацию о версии.

  • -h, --help — выводит справочную информацию по работе с командой.

  • -d, --debug-port <аргумент> — устанавливает номер порта для отладки. Номер порта <аргумент> должен находиться в диапазоне от 0 до 65535 (не включая эти значения).

  • c, --cmpt-mode <режим_совместимости> — устанавливает режим совместимости. Параметр <режим_совместимости> может принимать следующие значения:

    • 8.0, 9.0 и т. д. — конкретная версия режима совместимости. Можно указывать только мажорные версии «1С:Предприятие.Элемента Скрипта», начиная с 6.0;

    • current — режим совместимости, соответствующий текущей версии «1С:Предприятие.Элемента Скрипта»;

    • script (по умолчанию) — режим совместимости, указанный в скрипте с помощью директивы #совместимость <режим_совместимости>. Например:

      #совместимость 8.0

      Если директива отсутствует, используется значение current. Если значение, указанное в директиве, отличается от режима совместимости запуска скрипта, выводится предупреждение.

  • -l, -locale <аргумент> — устанавливает локаль.

  • --warn-unclosed-resources — сообщает о незакрытых ресурсах в конце выполнения.

  • --modules-path <путь> — устанавливает путь к каталогу подключаемых модулей (подробнее).

  • --dev-lang <язык> — устанавливает вариант языка разработки: ru — русский, en — английский. Значение по умолчанию определяется по ключевому слову в первом объявлении метода.

Запуск скрипта​

Чтобы запустить метод Скрипт(), используемый по умолчанию, вы можете указать только путь до скрипта:

executor path/to/script.sbsl

Чтобы запустить определенный метод в скрипте, укажите его имя при вызове команды:

executor path/to/script.sbsl::Выполнить

Аргументы​

Вы можете передать в параметры методов позиционные и именованные аргументы:

  • Для передачи именованных аргументов используйте ключевое слово <arg>: -arg1 знч1 -arg2 знч2. Например, метод с сигнатурой РешитьКвадратноеУравнение(a: Число, b: Число, с: Число): Массив<Число> можно вызвать следующим образом:

    executor path/to/script.sbsl::РешитьКвадратноеУравнение -a 1 -b -3 -c 2

  • Для передачи позиционных аргументов перечислите значения аргументов в нужном порядке: знч1 знч2.

    executor path/to/script.sbsl::РешитьКвадратноеУравнение 1 -3 2

В качестве признака прекращения разбора аргументов командной строки используйте параметр --. Он отключает разбор оставшейся части командной строки, и все остальные значения передаются как параметры скрипта (с пробелом в качестве разделителя).

Параметр -- также используется, если в качестве значения другого параметра командной строки executor необходимо передать последовательность символов, начинающихся с -.

Аргументы типа «Строка»​

Для передачи аргумента типа Строка используйте двойные кавычки: "строковое значение".

executor path/to/script.sbsl::ПолучениеСтроки "Это строка-аргумент"

Аргументы типа «Массив»​

Для передачи аргумента типа Массив используйте параметр --: -- элемент1, элемент2, элемент3.

executor path/to/script.sbsl::ПолучениеМассиваСтрок -- "Первая строка" "Вторая строка" "Самая последняя строка"

Аргументы типа «Соответствие»​

Чтобы передать аргумент типа Соответствие, используйте именованные параметры. Чтобы передать в метод соответствие {ключ1: знч1, ключ2: знч2}, укажите аргументы в формате -ключ1 знч1 -ключ2 знч2.

важно

Обратите внимание, что соответствие должно быть единственным аргументом метода.

executor path/to/script.sbsl::ПолучениеСоответствия -"1" "Строка1" -"2" "Строка2"

Результат работы​

Во время работы executor выводит информацию в стандартный поток вывода (stdout).

Информация об ошибках выводится в стандартный поток ошибок (stderr).

Кодировка выводимой информации​

Кодировка выводимой информации зависит от используемой операционной системы:

  • для Linux: UTF-8,
  • для macOS: UTF-8,
  • для Windows: CP866.

См. также​

Последнее обновление