Skip to content

Interface de Linha de Comando (ILC)

Jump to bottom
Leonel Sanches da Silva edited this page Sep 19, 2025 · 2 revisions

A Interface de Linha de Comando (ILC) é uma ferramenta essencial para desenvolvedores que desejam interagir com o framework Liquido de maneira eficiente e automatizada. A ILC facilita a criação de projetos, e fornece comandos úteis para o desenvolvimento e gerenciamento de aplicações Liquido.

Instalação

A ILC requer Liquido instalado globalmente. Para isso, você deve ter instalado o Node.js, pelo menos na versão 20 ou superior, que já vem com o npm (Node Package Manager). Execute o seguinte comando no terminal:

npm install -g liquido

Isso permitirá que você utilize a ILC em qualquer diretório.

Opções

  • --ajuda: exibe a descrição do comando e suas opções. Exemplo:

liquido novo --ajuda ou liquido novo -?

  • --versao: Exibe a versão atual do Liquido.

Comandos

A sintaxe de um comando na ILC do Liquido é a seguinte:

liquido <comando> [opcoes]

Os comandos disponíveis são:

  • novo: cria um novo projeto Liquido. Exemplo:

    liquido novo

    O nome do projeto pode ser passado como parâmetro:

    liquido novo meu-projeto

    Se não for, a ILC deve perguntar qual será o nome do projeto.

    Em seguida, você deverá escolher entre a arquitetura MVC ou a arquitetura Rest API.

  • servidor: inicia o servidor para testes locais. Exemplo:

    liquido servidor

    Por padrão, Liquido executa a aplicação em http://localhost:3000.

  • documentar: gera a documentação da API, usando a API da OpenAPI. Exemplo:

liquido documentar

  • gerar: gera controlador e visão correspondentes a um modelo. Exemplo: liquido gerar <nome-do-modelo>

Comando gerar e modelos

Suponha que você tenha um modelo chamado Artigo (artigo.delegua) dentro da pasta modelos com o seguinte conteúdo:

classe Artigo {
    id: numero
    titulo: texto
    conteudo: texto
}

Ao executar o comando:

liquido gerar Artigo

A ILC criará automaticamente o controlador e a visão correspondentes ao modelo Artigo, seguindo a arquitetura MVC do Liquido. A estrutura de pastas resultante deve ser:

meu-projeto-liquido/
├── modelos/
│   └── artigo.delegua
├── rotas/
│   └── artigos/
│       ├── inicial.delegua
│       └── [id]/
│           ├── editar.delegua
│           ├── excluir.delegua
|── visoes/
│   └── artigos/  
│       ├── editar.lmht
│       ├── excluir.lmht
│       ├── index.lmht
│       └── novo.lmht

Referências

Clone this wiki locally