Pular para o conteúdo principal
Version: v4.5.0

run

Os Hooks Declarativos do tipo run servem para executar comandos. Alguns exemplos interessantes de utilização são:

  • Instalar dependências no projeto;
  • Executar comandos de alguma ferramenta que faz parte da Stack;
  • Executar configurações através de scripts shell ou batch.

Confira abaixo um exemplo simples de um Hook Declarativo do tipo run:

hooks:
  - type: run
    trigger: before-input
    commands:
      - echo hello from before-input!
      - echo you can define multiple commands in a run hook!

Ao aplicar o Template/Plugin que define esse Hook Declarativo, antes de perguntar os parâmetros de entrada, o console mostra as seguintes frases:

  • hello from before-input!
  • you can define multiple commands in a run hook!.

É possível utilizar operadores condicionais com o parâmetro conditions em um Hook, confira o exemplo abaixo:

name: my-plugin
description: Describe your plugin explaining its purpose
types:
  - app
inputs:
  - label: Deseja instalar as dependências?
    type: bool
    name: install_dependencies
hooks:
  - type: run
    trigger: after-render
    commands: 
      - echo Instalando dependências
      - npm install
    condition:
      variable: install_dependencies
      operator: "=="
      value: true

Neste exemplo o input de tipo booleano faz uma pergunta a pessoa usuária para instalar dependências. A condition faz com que neste caso o Hook seja executado caso a resposta seja verdadeira ( operador == e value true). Só então os comandos de npm install serão executados para instalar as dependências.

É possível definir comandos diferentes por sistema operacional. Confira o exemplo abaixo:

hooks:
  - type: run
    trigger: before-input
    working-dir: "{{project_name}}/some/dir"
    linux:
      - echo hello from before-input on linux!
    windows:
      - cmd /C echo hello from before-input on windows!
    mac:
      - echo hello from before-input on mac!

Neste caso, ao aplicar o Template/Plugin, a mensagem que aparece no console será diferente para cada sistema operacional. Os sistemas operacionais suportados são:

  • linux
  • mac
  • windows
caution

Operadores de encadeamento de comandos e redirecionamento de saída (|, ||, &&, &, >, >>, ;) não são suportados e são interpretados como strings ao serem executados.

Comando run no Windows​

Para executar outras aplicações através do run no Windows, utilize um dos exemplos abaixo:

  1. Usando o cmd. Nesse caso, abre uma janela do CMD extra quando o plugin está sendo aplicado, mas depois é fechada automaticamente. 
hooks:
  - type: run
    trigger: after-render
    working-dir: "{{project_name}}/some/dir"
    linux:
      - npm install
    windows:
      - cmd /c npm install
    mac:
      - npm instal
  1. Chame o binário do npm diretamente, aqui o npm é executado na mesma janela:
hooks:
  - type: run
    trigger: after-render
    working-dir: "{{project_name}}/some/dir"
    linux:
      - npm install
    windows:
      - npm.cmd install
    mac:
      - npm instal

Ações Disponíveis do Hook Declarativo run​

trigger:​

Campo para definir gatilhos que informam o momento em que a execução de comandos deve ocorrer.

before-input:
Executa os comandos do hook antes de receber os parâmetros de entrada da pessoa usuária. 

trigger: before-input

before-render:
Executa os comandos do hook antes do Template gerar arquivos no projeto. 

trigger: before-render

after-render:
Executa os comandos do hook após o Template gerar arquivos no projeto. 

trigger: after-render

working-dir:(Opcional)​

Permite que você defina um diretório relativo à raiz do projeto onde os comandos serão executados. Quando não informado, os comandos serão executados na raiz do projeto. No campo working-dir é possível utilizar expressões Jinja, por exemplo: 

working-dir: "{{project_name}}/some/dir"

commands:​

Permite que você defina um ou mais comandos para serem executados.

commands: 
  - echo hello from before-input!
  - echo you can define multiple commands in a run hook!

Para utilizar os comandos no Windows, a ferramenta CMD deve ser executada pelo argumento cmd /c. Confira um exemplo abaixo:

commands: 
  - cmd /c echo hello from before-input!
  - cmd /c echo you can define multiple commands in a run hook!

linux:(Opcional)​

Permite definir um ou mais comandos, especificando a execução em sistemas Linux. 

linux:
  - npm install

windows:(Opcional)​

Permite definir um ou mais comandos, especificando a execução em sistemas Windows. 

windows: 
  - cmd /c npm install

mac:(Opcional)​

Permite definir um ou mais comandos, especificando a execução em sistemas MacOS. 

mac:
  - npm install
caution

Nas ações do Hook Declarativo run, operadores de encadeamento de comandos e redirecionamento de saída (|, ||, &&, &, >, >>, ;) não são suportados e são interpretados como strings quando executados.

Leia também​

Esta página foi útil?