コンテンツにスキップ

インストール

動作要件

httptap をインストールする前に、以下があることを確認してください:

  • Python 3.10-3.15(CPython 推奨)
  • pip または uv パッケージマネージャ
  • macOS、Linux、または Windows オペレーティングシステム

標準的なネットワーク機能以外にシステム依存関係は不要です。

uvx で実行する

恒久的なインストールなしで httptap を実行する最速の方法です。uvxuv に同梱)は httptap を取得し、一時的で隔離された環境で実行します:

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

手軽に試すのにおすすめ

uvx は事前のインストール手順が不要で、何も残しません — 単発のチェックや httptap を試すのに最適です。繰り返し使う場合は、以下のいずれかの方法でインストールしてください。

Homebrew でインストールする

brew install httptap
brew install httptap

macOS/Linux ユーザーに便利

Homebrew でのインストールは最もシンプルな方法で、シェル補完の自動セットアップも含まれます。

PyPI からインストールする

uv pip install httptap

または、グローバルツールとしてインストールします:

uv tool install httptap
pip install httptap

隔離された CLI ツールとしてインストールする場合:

pipx install httptap

コンテナ経由で実行する

署名済みのマルチアーキテクチャ(linux/amd64、linux/arm64)イメージが、リリースごとに GitHub Container Registry に公開されます:

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

イメージの署名を cosign(keyless Sigstore)で検証します:

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

固定されたメジャー/マイナータグ(例: :0:0.6:0.6.0)も公開されています。

ソースからインストールする

リポジトリをクローンする

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

uv でインストールする

uv sync

pip でインストールする

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

インストールの確認

インストール後、httptap が正しくインストールされたことを確認します:

httptap --version

次のような出力が表示されるはずです:

httptap X.Y.Z

アップグレード

httptap を最新バージョンにアップグレードするには:

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

アンインストール

httptap をシステムから削除するには:

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

シェル補完

httptap は bash と zsh のシェル補完をサポートしています。

Homebrew でのインストール

Homebrew 経由で httptap をインストールした場合、補完は自動的に構成されます。シェルを再起動するだけです:

# Restart your shell
exec $SHELL

Homebrew は補完スクリプトを自動的に次の場所に配置します:

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

追加のセットアップは不要

Homebrew はすべての補完セットアップを自動的に処理します。シェルを再起動して、Tab 補完を使い始めるだけです!

Python パッケージでのインストール

httptap を pipuv、または pipx 経由でインストールした場合、オプションの completion エクストラをインストールする必要があります:

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

有効化

  1. 仮想環境を有効化します(venv を使用している場合):

    source .venv/bin/activate
    
  2. bash/zsh の補完を有効にします。一度グローバルに登録するか:

    activate-global-python-argcomplete
    

    または、httptap のみで有効にするには、これをシェルの起動ファイル(例: ~/.bashrc または ~/.zshrc)に追加します:

    eval "$(register-python-argcomplete httptap)"
    
  3. シェルを再起動します。

使い方

インストールして有効化すると、Tab を使ってコマンドやオプションを自動補完できます:

# 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

グローバル有効化スクリプトが提供する引数補完は bash と zsh のみです。その他のシェルはこのスクリプトの対象外であり、別途構成する必要があります。


次のステップ