Skip to main content

Instalação

Requisitos​

  • Python 3.12 ou superior
  • pip (gerenciador de pacotes Python)

Métodos de Instalação​

🚀 Instalador Automático (Recomendado)​

O método mais simples e que não requer privilégios de administrador:

curl -fsSL https://raw.githubusercontent.com/rodrigocnascimento/zshellcheck/main/install-zshcheck.sh | bash

Ou, se preferir baixar primeiro:

wget https://raw.githubusercontent.com/rodrigocnascimento/zshellcheck/main/install-zshcheck.sh
chmod +x install-zshcheck.sh
./install-zshcheck.sh

O que o instalador faz:

  • Cria um ambiente virtual isolado em ~/.local/zshcheck
  • Instala o pacote PyPI
  • Cria um link em ~/.local/bin/zshcheck
  • Não polui seu sistema - tudo fica em ~/.local

Importante: Certifique-se de que ~/.local/bin está no seu PATH. Adicione ao seu ~/.zshrc ou ~/.bashrc:

export PATH="$HOME/.local/bin:$PATH"

Desinstalação:

rm -rf ~/.local/zshcheck ~/.local/bin/zshcheck

📦 pipx (para quem usa pipx)​

Se você já usa pipx para gerenciar ferramentas CLI:

pipx install zshshellcheck

🐍 pip (ambiente virtual)​

Se preferir gerenciar manualmente:

python3 -m venv zshcheck-env
source zshcheck-env/bin/activate
pip install zshshellcheck

Para tornar disponível globalmente, crie um symlink:

ln -s $(pwd)/zshcheck-env/bin/zshcheck ~/.local/bin/zshcheck

Instalação em desenvolvimento​

Se você quer contribuir ou modificar o código:

git clone https://github.com/rodrigocnascimento/zshellcheck.git
cd zshshellcheck
pip install -e .

Dependências de desenvolvimento​

Se você também quer rodar os testes e linting:

pip install -e ".[dev]"

Verificação da instalação​

Após a instalação, verifique se está funcionando:

zshcheck --version

A saída deve mostrar a versão instalada, algo como:

zshcheck, version 0.2.1

Atualização​

Para instalador automático:​

./install-zshcheck.sh

Para pipx:​

pipx upgrade zshshellcheck

Para pip (em venv):​

pip install --upgrade zshshellcheck

Desinstalação​

Para instalador automático:​

rm -rf ~/.local/zshcheck ~/.local/bin/zshcheck

Para pipx:​

pipx uninstall zshshellcheck

Para pip:​

pip uninstall zshshellcheck