## Expressions - выражения

Некоторые настройки параметров шаблона могут быть представлены "выражениями" - это строчки определённого формата,
которые могут быть вычислены для работы шаблонов.

Выражения бывают двух типов - текстовые и булевы.

Примеры выражений для секции `widgets`:

```yaml
suggest: fragment_${className.classToResource().underscoreToCamelCase()}
visibility: ${includeModule}
availability: true
# visibility: ${uiFramework} == compose
# availability: ${uiFramework} != views
```

Текст внутри `${}` считается за "динамическую" часть выражения, которую требуется вычислять в зависимости от содержания,
текст вне фигурных скобок - фиксированная часть.
Внутри `${}` можно использовать только те параметры, которые уже были объявлены ВЫШЕ по тексту рецепта.

Для текстовых параметров можно использовать дополнительные extension-функции:

- `activityToLayout`
- `fragmentToLayout`
- `classToResource`
- `camelCaseToUnderlines`
- `layoutToActivity`
- `layoutToFragment`
- `underscoreToCamelCase`

Для булевских выражений сейчас поддерживаются:

- `true` / `false`
- `${booleanParameter}`
- `${stringOrSuggestParameter} == value`
- `${stringOrSuggestParameter} != value`

Логические `&&` / `||` пока не поддерживаются.

Примеры выражений для секции `recipe`:

```yaml
- open:
    file: ${srcOut}/di/${moduleName}.kt

- instantiate:
    from: root/build.gradle.ftl
    to: ${rootOut}/build.gradle

- instantiateAndOpen:
    from: root/res/layout/fragment_container.xml.ftl
    to: ${resOut}/layout/${fragmentName}.xml

- instantiateAndOpen:
    from: root/main/AndroidManifest.xml
    to: ${manifestOut}/AndroidManifest.xml

- instantiate:
    from: root/main/MyFile.kt
    to: ${currentDirOut}/folder/MyFile.kt
```

В секции `recipe` добавляются 4 встроенных параметра:

- `rootOut` - рутовая папка модуля
- `manifestOut` - путь до папки `src/main` в модуле
- `resOut` - путь до папки `res` внутри модуля
- `srcOut` - путь до папки `src/<source-set>/<current-dir>` в модуле
- `currentDirOut` - путь до папки, которая была выбрана в `Project View` для запуска `Action` плагина Geminio. 

---

[Обратно к содержанию](../../README.md)