@:~$neofetch
Logotipo de lintux

lintux

@
postagens
...
páginas
...
menu
@:~/postagens$less 7026662923184076566 postagem

Nunca mais procure aquele comando no histórico: conheça o LinTux

Salve comandos longos com nomes curtos, encadeie tudo em listas de execução e rode com uma rede de proteção contra o rm -rf.

       .--.
      |o_o |
      |:_/ |
     //   \ \
    (|     | )
   /'\_   _/`\
   \___)=(___/

Todo usuário de Linux tem um caderninho. Às vezes ele é um arquivo de texto esquecido na pasta pessoal, às vezes é o histórico do bash, às vezes são aliases espalhados pelo ~/.bashrc, e às vezes é a própria memória, que falha justamente no dia em que você precisa daquele comando enorme que funcionou uma única vez. O LinTux nasceu para ser esse caderninho, só que organizado, seguro e de dentro do próprio terminal.

A ideia é simples: em vez de decorar ou redigitar algo como sudo apt update && sudo apt upgrade -y, você salva o comando uma vez com um nome curto e passa a executá-lo com lintux <nome>. Tudo em um único arquivo Python que usa só a biblioteca padrão. Não há nada para instalar além do Python 3, que já vem na maioria das distribuições.

Para quem é

O LinTux foi pensado para dois públicos. Para quem está começando no Linux, ele é uma forma segura e legível de guardar os comandos que vai aprendendo, inspecioná-los antes de executar e evitar erros destrutivos. Para quem já tem estrada, é uma alternativa leve aos aliases espalhados e aos scripts improvisados, com parâmetros, histórico e backup já incluídos.

Primeiros passos

$ lintux add ola 'echo "Olá, $USER!"'      # salva um comando
$ lintux ola                               # executa

$ lintux add disco 'df -h {{1:/}}'         # parâmetro com valor padrão
$ lintux disco /home

$ lintux add list rotina                   # cria uma lista vazia
$ lintux add list rotina ola               # adiciona um comando existente
$ lintux add list rotina memoria 'free -h' # cria um comando e já o adiciona
$ lintux show rotina                       # inspeciona sem executar
$ lintux -n rotina                         # simulação
$ lintux rotina                            # executa as etapas em ordem

Listas de execução

Aqui mora a parte mais útil. Os comandos salvos podem ser agrupados em listas de execução: sequências ordenadas de etapas que rodam uma depois da outra, cada uma com o seu cabeçalho de progresso. É assim que a lista rotina do exemplo aparece no terminal:

$ lintux rotina

[1/2] Executando: ola...
      echo "Olá, $USER!"
Olá, miqueias!
✔ Etapa 1/2 concluída (0,0 s).

[2/2] Executando: memoria...
      free -h
               total        used        free      shared  buff/cache   available
Mem:           7.8Gi       513Mi       7.3Gi        12Mi       245Mi       7.3Gi
Swap:             0B          0B          0B
✔ Etapa 2/2 concluída (0,0 s).

✔ Lista 'rotina' concluída: 2/2 etapas em 0,0 s.

Se uma etapa falhar, a lista para na hora e diz exatamente onde. Quem preferir seguir adiante mesmo assim usa a opção -k. Dá para imaginar o uso: uma lista para atualizar o sistema e limpar pacotes órfãos, outra para preparar um ambiente de desenvolvimento, outra para a manutenção de fim de mês. Você monta uma vez e executa com uma palavra.

Comandos que viram modelos

Com marcadores como {{1}}, {{2:padrão}} e {{@}}, um comando salvo vira um modelo reutilizável. No exemplo acima, lintux disco mostra o espaço da raiz, e lintux disco /home mostra o da pasta pessoal. Os argumentos são sempre escapados antes de chegar ao shell. E, se o comando não tiver marcadores, os argumentos extras vão para o final: depois de lintux add ver 'ls', rodar lintux ver -la /tmp executa ls -la /tmp.

Uma rede de proteção

Quem está começando no Linux costuma ter medo, com razão, de colar no terminal um comando que encontrou em algum fórum. O LinTux ajuda de três formas:

  • Ver antes de rodar. O lintux show <nome> mostra exatamente o que será executado, e o -n simula uma lista inteira sem executar nada.
  • Confirmação para o perigo. Operações potencialmente destrutivas, como rm -rf /, mkfs, dd of=/dev/..., curl | sh e reboot, pedem confirmação antes de rodar.
  • Dados bem guardados. As gravações são atômicas, a versão anterior do banco é copiada automaticamente e toda restauração de backup é precedida de uma cópia de segurança.

Vale a honestidade: o detector de operações destrutivas é uma heurística, não uma garantia. Antes de rodar algo que você não escreveu, o lintux show continua sendo o melhor amigo.

Feito para o terminal de verdade

  • Comandos interativos funcionam. A senha do sudo e as confirmações [S/n] se comportam exatamente como no seu terminal, com a saída em tempo real.
  • Organização. Dá para renomear (as listas são atualizadas sozinhas), reordenar as etapas, adicionar descrições, pesquisar e editar no seu $EDITOR.
  • Histórico. Cada execução fica registrada com data, duração e código de saída.
  • Backup em um comando. O lintux new backup salva tudo na sua pasta de Downloads, e o lintux add backup restaura mesclando os dados e avisando sobre conflitos.
  • Autocompletar com Tab no bash, e sugestões do tipo "você quis dizer…?" para nomes digitados errado.
  • Amigo de scripts. O LinTux termina com o mesmo código de saída do comando que executou.

Atenção às aspas

Esta é a lição de shell que o LinTux acaba ensinando de brinde. Comandos que têm &&, ||, |, >, ;, $, * ou ~ precisam ir entre aspas simples:

$ lintux add atualizar 'sudo apt update && sudo apt upgrade -y'   # certo
$ lintux add atualizar sudo apt update && sudo apt upgrade -y     # errado

Sem as aspas, o seu shell processa os operadores antes de o LinTux receber qualquer coisa: na segunda linha, só sudo apt update é salvo, e o sudo apt upgrade -y roda na mesma hora. Nenhum programa consegue impedir isso, porque acontece no shell.

E quando o comando já tem aspas simples dentro dele? O bash não aceita aspas simples dentro de aspas simples. Para esses casos, digite só o nome e deixe o LinTux pedir o comando. Ele é salvo exatamente como você digitou, porque nunca passa pelo shell:

$ lintux add colunas
Digite o comando de 'colunas' exatamente como no terminal.
› awk -F, '{print $1}' vendas.csv | sort | uniq -c
✔ Comando 'colunas' salvo.

Desde a versão 1.0.1, o LinTux também percebe quando o shell "comeu" as aspas internas. Em vez de salvar um comando quebrado em silêncio, ele mostra os pedaços que recebeu e oferece para você digitar de novo.

Instalação

Funciona nas famílias Debian (Debian, Ubuntu, Linux Mint e derivadas) e Red Hat (Fedora, RHEL, CentOS, AlmaLinux, Rocky Linux e derivadas), com Python 3.6 ou mais recente:

$ git clone https://github.com/miqueiasklippel/lintux.git
$ cd lintux
$ ./install.sh            # para todo o sistema: /usr/local/bin/lintux (usa sudo)
$ ./install.sh --user     # só para o seu usuário: ~/.local/bin/lintux

Depois, abra um terminal novo para carregar o autocompletar. Para atualizar, basta rodar o install.sh de novo: os seus comandos salvos não são tocados. Para remover, há o ./uninstall.sh, com --keep para manter os dados ou --purge para apagá-los depois de salvar um último backup em Downloads.

Dois detalhes que valem saber: os comandos rodam via bash -c, então aliases e funções definidos no ~/.bashrc não ficam disponíveis (salve o comando completo, não o alias). E o Ctrl+C interrompe o comando em execução e a lista inteira, mesmo com -k.

Licença

O LinTux é distribuído sob a licença PolyForm Noncommercial 1.0.0. Você pode usar, estudar, modificar e compartilhar para qualquer fim não comercial: uso pessoal, estudo, pesquisa, projetos de hobby e uso por organizações beneficentes, de ensino e públicas. O uso comercial depende de autorização do autor. Por essa restrição, o projeto é source-available, e não "código aberto" no sentido estrito da Open Source Initiative, mas todo o código está público e livre para ler.

No site do projeto há ainda um terminal simulado no navegador, para experimentar os comandos sem executar nada no seu computador.

$ abrir lintux.klippelbit.app.br
$ git clone github.com/miqueiasklippel/lintux

Comece pelo comando que você mais digita e mais esquece. Salve, dê um nome curto e nunca mais procure por ele no histórico.

@:~/postagens$tail comentarios.log

Comentários