Aplicações CLI

Construa ferramentas de linha de comando que leem entrada, escrevem saída e interagem com usuários.

O Que Vamos Construir

Um CLI simples que saúda o usuário:

$ wippy run -x app:cli
Hello from CLI!

Estrutura do Projeto

cli-app/
├── wippy.lock
└── src/
    ├── _index.yaml
    └── cli.lua

Passo 1: Criar Projeto

mkdir cli-app && cd cli-app
mkdir src

Passo 2: Definições de Entradas

Crie src/_index.yaml:

version: "1.0"
namespace: app

entries:
  # Terminal host conecta processos a stdin/stdout
  - name: terminal
    kind: terminal.host
    lifecycle:
      auto_start: true

  # Processo CLI
  - name: cli
    kind: process.lua
    source: file://cli.lua
    method: main
    modules:
      - io
O terminal.host faz a ponte entre seu processo Lua e o terminal. Sem ele, io.print() não tem para onde escrever.

Passo 3: Código CLI

Crie src/cli.lua:

local io = require("io")

local function main()
    io.print("Hello from CLI!")
    return 0
end

return { main = main }

Passo 4: Executar

wippy init
wippy run -x app:cli

Saída:

Hello from CLI!
A flag -x auto-detecta seu terminal.host e executa em modo silencioso para saída limpa.

Lendo Entrada do Usuário

local io = require("io")

local function main()
    io.write("Enter your name: ")
    local name = io.readline()

    if name and #name > 0 then
        io.print("Hello, " .. name .. "!")
    else
        io.print("Hello, stranger!")
    end

    return 0
end

return { main = main }

Saída Colorida

Use códigos de escape ANSI para cores:

local io = require("io")

local reset = "\027"
local function red(s) return "\027" .. s .. reset end
local function green(s) return "\027" .. s .. reset end
local function yellow(s) return "\027" .. s .. reset end
local function cyan(s) return "\027" .. s .. reset end
local function bold(s) return "\027" .. s .. reset end

local function main()
    io.print(bold(cyan("Welcome!")))
    io.write(yellow("Enter a number: "))

    local input = io.readline()
    local n = tonumber(input)

    if n then
        io.print("Squared: " .. green(tostring(n * n)))
        return 0
    else
        io.print(red("Error: ") .. "not a number")
        return 1
    end
end

return { main = main }

Informações do Sistema

Acesse estatísticas do runtime com o módulo system:

# Adicionar à definição da entrada
modules:
  - io
  - system

local io = require("io")
local system = require("system")

local function main()
    io.print("Host: " .. system.process.hostname())
    io.print("CPUs: " .. system.runtime.cpu_count())
    io.print("Goroutines: " .. system.runtime.goroutines())

    local mem = system.memory.stats()
    io.print("Memory: " .. string.format("%.1f MB", mem.heap_alloc / 1024 / 1024))

    return 0
end

return { main = main }

Códigos de Saída

Retorne de main() para definir o código de saída:

local function main()
    if error_occurred then
        return 1  -- Erro
    end
    return 0      -- Sucesso
end

Referência de I/O

Função Descrição
io.print(...) Escrever em stdout com nova linha
io.write(...) Escrever em stdout sem nova linha
io.eprint(...) Escrever em stderr com nova linha
io.readline() Ler linha de stdin
io.flush() Descarregar buffer de saída

Flags CLI

Flag Descrição
wippy run -x app:cli Executar processo CLI (auto-detecta terminal.host)
wippy run -x app:cli --host app:term Terminal host explícito
wippy run -x app:cli -v Com logging verbose

Próximos Passos