Макросы

Встроенные макросы Runium.

$base64decode

Декодирует строку из формата Base64.

Параметры

Параметр	Обязательный	Описание
value	Да	Строка в формате Base64

Пример

{
  "decoded": "$base64decode(SGVsbG8gV29ybGQ=)"
}

Результат:

{
  "decoded": "Hello World"
}

---

$base64encode

Кодирует строку в формат Base64.

Параметры

Параметр	Обязательный	Описание
value	Да	Строка для кодирования

Пример

{
  "encoded": "$base64encode(Hello World)"
}

Результат:

{
  "encoded": "SGVsbG8gV29ybGQ="
}

---

$content

Читает содержимое файла.

Параметры

Параметр	Обязательный	Описание
path	Да	Путь к файлу

Пример

{
  "fileContent": "$content(config.txt)"
}

Результат (если файл содержит "Hello World"):

{
  "fileContent": "Hello World"
}

---

$date

Возвращает текущую дату и время в формате YYYY-MM-DD hh:mm:ss.sss.

Параметры

Макрос не принимает параметров.

Пример

{
  "createdAt": "$date()"
}

Результат:

{
  "createdAt": "2026-01-01 12:34:56.123"
}

---

$empty

Возвращает пустую строку.

Параметры

Макрос не принимает параметров.

Пример

{
  "value": "$empty()"
}

Результат:

{
  "value": ""
}

---

$env

Возвращает значение переменной окружения.

Параметры

Параметр	Обязательный	Описание
name	Да	Имя переменной окружения
defaultValue	Нет	Значение по умолчанию, если переменная окружения не задана

Примеры

Получение значения переменной окружения:

{
  "user": "$env(USER)"
}

С значением по умолчанию:

{
  "user": "$env(USER, guest)"
}

---

$eq

Возвращает одно из двух значений в зависимости от равенства двух входных значений.

Параметры

Параметр	Обязательный	Описание
value1	Да	Первое значение для сравнения
value2	Да	Второе значение для сравнения
trueValue	Нет	Значение, возвращаемое если value1 === value2 (по умолчанию пустая строка)
falseValue	Нет	Значение, возвращаемое если value1 !== value2 (по умолчанию пустая строка)

Примеры

Простое сравнение:

{
  "file": "$eq($env(USER), admin, admin.txt, user.txt)"
}

Если USER=admin, результат:

{
  "file": "admin.txt"
}

Если USER=guest, результат:

{
  "file": "user.txt"
}

Вложенные макросы:

{
  "config": "$eq($env(NODE_ENV), production, $path(config/prod.json), $path(config/dev.json))"
}

---

$homedir

Возвращает путь к домашнему каталогу текущего пользователя.

Параметры

Макрос не принимает параметров.

Пример

{
  "home": "$homedir()"
}

Результат (Linux/macOS):

{
  "home": "/home/username"
}

---

$json

Создает JSON из строкового представления JavaScript объекта или примитива.

Параметры

Параметр	Обязательный	Описание
jsonString	Да	Строковое представление JavaScript объекта или примитива

TIP

Макрос не экранирует двойные кавычки.

Для получения значения в виде объекта, используйте служебный макрос $unwrap.

Примеры

Создание JSON:

{
  "value": "$unwrap($json({a: 12, b: true}))"
}

Результат:

{
  "value": { "a": 12, "b": true }
}

---

$max

Возвращает максимальное значение из переданных аргументов.

Параметры

Параметр	Обязательный	Описание
...values	Да	Числа для сравнения

Пример

{
  "maxValue": "$max(10, 25, 5, 30, 15)"
}

Результат:

{
  "maxValue": "30"
}

---

$min

Возвращает минимальное значение из переданных аргументов.

Параметры

Параметр	Обязательный	Описание
...values	Да	Числа для сравнения

Пример

{
  "minValue": "$min(10, 25, 5, 30, 15)"
}

Результат:

{
  "minValue": "5"
}

---

$ne

Возвращает одно из двух значений в зависимости от неравенства двух входных значений.

Параметры

Параметр	Обязательный	Описание
value1	Да	Первое значение для сравнения
value2	Да	Второе значение для сравнения
trueValue	Нет	Значение, возвращаемое если value1 !== value2 (по умолчанию пустая строка)
falseValue	Нет	Значение, возвращаемое если value1 === value2 (по умолчанию пустая строка)

Примеры

Простое сравнение:

{
  "mode": "$ne($env(DEBUG), true, development, production)"
}

Если DEBUG=false, результат:

{
  "mode": "development"
}

Если DEBUG=true, результат:

{
  "mode": "production"
}

---

$path

Возвращает абсолютный путь, вычисленный относительно текущего рабочего каталога.

Параметры

Параметр	Обязательный	Описание
...path	Да	Один или несколько сегментов пути для объединения

Примеры

Относительный путь:

{
  "configPath": "$path(config/app.json)"
}

Несколько сегментов пути:

{
  "dataPath": "$path(data, users, profile.json)"
}

Путь на уровень выше:

{
  "parentPath": "$path(../file.txt)"
}

---

$platform

Возвращает название платформы операционной системы.

Параметры

Макрос не принимает параметров.

Пример

{
  "os": "$platform()"
}

Результат (на Linux):

{
  "os": "linux"
}

Возможные значения: linux, darwin, win32, freebsd, openbsd, sunos, aix.

---

$random

Генерирует случайное целое число в заданном диапазоне.

Параметры

Параметр	Обязательный	Описание
min	Нет	Минимальное значение (по умолчанию 0)
max	Нет	Максимальное значение (по умолчанию 2^53 − 1)

Примеры

Случайное число:

{
  "randomValue": "$random()"
}

Случайное число в диапазоне:

{
  "randomValue": "$random(1, 10)"
}

Результат:

{
  "randomValue": "7"
}

---

$timestamp

Возвращает текущее время в миллисекундах с начала эпохи Unix (Unix timestamp).

Параметры

Макрос не принимает параметров.

Пример

{
  "timestamp": "$timestamp()"
}

Результат:

{
  "timestamp": "1705328445123"
}

---

$tmpdir

Возвращает путь к временному каталогу операционной системы.

Параметры

Макрос не принимает параметров.

Пример

{
  "tempDir": "$tmpdir()"
}

Результат (Linux):

{
  "tempDir": "/tmp"
}

---

$unwrap

Служебный макрос, удаляющий кавычки вокруг значения. Используется для получения нестроковых значений (чисел, булевых значений, объектов и т.п.) в JSON.

Параметры

Параметр	Обязательный	Описание
value	Да	Значение для удаления кавычек

Примеры

Получение числового значения:

{
  "timestamp": "$timestamp()"
}

Результат - значение в кавычках:

{
  "timestamp": "1705328445123"
}

Для удаления кавычек используем $unwrap:

{
  "timestamp": "$unwrap($timestamp())"
}

Результат:

{
  "timestamp": 1705328445123
}

---

$username

Возвращает имя текущего пользователя операционной системы.

Параметры

Макрос не принимает параметров.

Пример

{
  "user": "$username()"
}

Результат:

{
  "user": "john"
}

---

$uuid

Генерирует уникальный идентификатор UUID v4.

Параметры

Макрос не принимает параметров.

Пример

{
  "id": "$uuid()"
}

Результат:

{
  "id": "fb97307e-5cc1-4109-8c6d-19074df9f5d1"
}

---

Вложенные макросы

Макросы можно вкладывать друг в друга для создания сложных выражений.

Примеры

Условный путь на основе переменной окружения:

{
  "logFile": "$eq($env(NODE_ENV), production, $path(logs/prod.log), $path(logs/dev.log))"
}

Использование домашнего каталога в пути:

{
  "configPath": "$path($homedir(), .config, myapp, config.json)"
}