Saltar a contenido

Instalación

Requisitos

Antes de instalar httptap, asegúrate de tener:

  • Python 3.10-3.15 (se recomienda CPython)
  • Gestor de paquetes pip o uv
  • Sistema operativo macOS, Linux o Windows

No se requieren dependencies del sistema más allá de la red estándar.

Ejecución con uvx

La forma más rápida de ejecutar httptap sin una instalación permanente. uvx (incluido con uv) obtiene httptap y lo ejecuta en un entorno efímero y aislado:

uvx --from "httptap[completion]" httptap https://example.com

Recomendado para una prueba rápida

uvx no necesita un paso de instalación previo y no deja nada atrás — ideal para comprobaciones puntuales o para probar httptap. Para un uso repetido, instálalo con uno de los métodos siguientes.

Instalación mediante Homebrew

brew install httptap
brew install httptap

Cómodo para usuarios de macOS/Linux

La instalación con Homebrew es el método más sencillo e incluye la configuración automática del autocompletado de shell.

Instalación desde PyPI

uv pip install httptap

O instálalo como una herramienta global:

uv tool install httptap
pip install httptap

Para una instalación aislada de la herramienta de CLI:

pipx install httptap

Ejecución mediante contenedor

En cada versión se publican imágenes multiarquitectura firmadas (linux/amd64, linux/arm64) en GitHub Container Registry:

docker run --rm ghcr.io/ozeranskii/httptap:latest https://example.com

Verifica la firma de la imagen con cosign (Sigstore sin claves):

cosign verify ghcr.io/ozeranskii/httptap:latest \
  --certificate-identity-regexp 'https://github\.com/ozeranskii/httptap/\.github/workflows/release\.yml@.*' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

También se publican etiquetas mayores/menores fijadas (p. ej. :0, :0.6, :0.6.0).

Instalación desde el código fuente

Clona el repositorio

git clone https://github.com/ozeranskii/httptap.git
cd httptap

Instala con uv

uv sync

Instala con pip

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -e .

Verificación de la instalación

Después de la instalación, verifica que httptap se instaló correctamente:

httptap --version

Deberías ver una salida similar a:

httptap X.Y.Z

Actualización

Para actualizar httptap a la última versión:

brew upgrade httptap
uv pip install --upgrade httptap
pip install --upgrade httptap

Desinstalación

Para eliminar httptap de tu sistema:

brew uninstall httptap
uv pip uninstall httptap
pip uninstall httptap
pipx uninstall httptap

Autocompletado de shell

httptap admite el autocompletado de shell para bash y zsh.

Instalación con Homebrew

Si instalaste httptap mediante Homebrew, el autocompletado se configura automáticamente. Simplemente reinicia tu shell:

# Restart your shell
exec $SHELL

Homebrew coloca automáticamente los scripts de autocompletado en:

  • Bash: $(brew --prefix)/etc/bash_completion.d/
  • Zsh: $(brew --prefix)/share/zsh/site-functions/

No se require configuración adicional

Homebrew gestiona toda la configuración del autocompletado automáticamente. ¡Solo reinicia tu shell y empieza a usar el autocompletado con Tab!

Instalación del paquete de Python

Si instalaste httptap mediante pip, uv o pipx, necesitas instalar los extras opcionales de completion:

uv pip install "httptap[completion]"
pip install "httptap[completion]"
pipx install "httptap[completion]"

Activación

  1. Activa tu entorno virtual (si usas venv):

    source .venv/bin/activate
    
  2. Habilita el autocompletado para bash/zsh. O bien regístralo globalmente una vez:

    activate-global-python-argcomplete
    

    O, para habilitarlo solo para httptap, añade esto a tu archivo de inicio del shell (p. ej. ~/.bashrc o ~/.zshrc):

    eval "$(register-python-argcomplete httptap)"
    
  3. Reinicia tu shell.

Uso

Una vez instalado y activado, puedes usar Tab para autocompletar commandos y opciones:

# Complete command options
httptap --<TAB>

# Complete after typing partial option
httptap --fol<TAB>
# Completes to: httptap --follow

# Complete multiple options
httptap --follow --time<TAB>
# Completes to: httptap --follow --timeout

Note

El script de activación global proporciona autocompletado de arguments solo para bash y zsh. Otros shells no están cubiertos por el script y deben configurarse por separado.


¿Qué sigue?