Installation - MiguelElGallo/iparq GitHub Wiki

Installation

Home

iparq is a Python CLI tool for inspecting Parquet files. This page covers all supported installation methods for iparq v0.5.0.

Requirements

  • Python >= 3.9
  • Supported Python versions tested in CI: 3.9, 3.10, 3.11, 3.12, and 3.13

iparq depends on:

  • pyarrow
  • typer
  • pydantic
  • rich

Build system:

  • hatchling

1. Zero Installation (Recommended)

The easiest way to use iparq is with Astral's UV tool runner, uvx. This runs the tool without installing it globally.

uvx --refresh iparq inspect yourparquet.parquet

No installation needed.

To install UV, see:

https://docs.astral.sh/uv/getting-started/installation/

2. Using pip

Install from PyPI with pip:

pip install iparq
iparq --help

3. Using uv

If you use uv for Python package management:

uv pip install iparq
iparq --help

4. Using Homebrew (macOS)

On macOS, you can install iparq with Homebrew:

brew tap MiguelElGallo/tap https://github.com/MiguelElGallo//homebrew-iparq.git
brew install MiguelElGallo/tap/iparq
iparq --help

5. From Source (Development)

To work from source or contribute to development:

git clone https://github.com/MiguelElGallo/iparq.git
cd iparq
uv sync --all-extras
uv run iparq --help

Verification

After installation, verify that iparq is available:

iparq --help

If the installation succeeded, this command should display the CLI help output.

Troubleshooting

iparq: command not found

  • Make sure the installation completed successfully.
  • Ensure your Python or tool-managed bin directory is on your PATH.
  • If you used uvx, run the command through uvx instead of calling iparq directly.

Python version is too old

  • iparq requires Python 3.9 or newer.
  • Check your version with:
python --version

pip install fails

  • Upgrade packaging tools first:
python -m pip install --upgrade pip setuptools wheel
  • Then try installing iparq again.

uv or uvx is not installed

Homebrew install issues

  • Run brew update and try again.
  • Confirm the tap URL is reachable.
  • Make sure Homebrew itself is installed and working correctly.

See Also