Чтобы запустить выполнение скрипта из командной строки, используйте команду 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 (по умолчанию) — режим совместимости, указанный в скрипте с пом ощью директивы #совместимость <режим_совместимости>. Например:
Если директива отсутствует, используется значение 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.
См. также