parquet-tools
Easy install parquet-tools
Decision gist · record as of 2026-08-14
Yes, if you need a lightweight CLI for ad-hoc Parquet inspection and S3 access. The low install friction and permissive license make it easy to add to a project. However, dormant maintenance means no bug fixes or feature updates are coming; if you need active support or encounter issues, you may need to fork or switch to direct pyarrow usage.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9 or later.
- S3 access requires AWS credentials configured in your environment (boto3 dependency handles this).
- Low friction installation with a pure-Python wheel.
License · maintenance · safety
MIT (permissive) — MIT license is permissive, allowing use in commercial and private projects with minimal restrictions; attribution is required but no copyleft obligations apply.
last release 2024-03-19 (878 days) · last repo commit 2024-07-09 · 182 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 241,103 downloads/mo, #8,886 on PyPI
Alternatives
Verify before relying
$ pip install parquet-tools
$ parquet-tools show /path/to/file.parquet
$ parquet-tools inspect /path/to/file.parquet
$ parquet-tools csv s3://bucket/file.parquet- Whether the package handles nested or complex Parquet schemas beyond the basic examples shown.
- Performance characteristics when working with large Parquet files or S3 datasets.
- Whether the CSV export preserves all data types or has known limitations.
What it is and what it does
parquet-tools is a command-line utility that wraps Apache Arrow to inspect and read Parquet files stored locally or on Amazon S3. It provides three main commands: `show` to display file contents in a human-readable table format, `inspect` to examine file metadata and schema details, and `csv` to export data as CSV for piping to other tools. The package depends on pyarrow for Parquet parsing, pandas for data manipulation, boto3 for S3 access, and tabulate and colorama for formatted terminal output.
The tool is designed for quick exploration and debugging of Parquet files without writing Python code. It works with both local files and S3 paths using glob patterns. However, the project is dormant—the last release was in March 2024 with no recent commits—so it receives no active maintenance. It remains functional for basic use cases but should not be relied upon for bug fixes or updates.
Use it for
- Quickly inspect the schema and metadata of a Parquet file to understand its structure before processing.
- Preview the first rows of a Parquet file on S3 without downloading the entire dataset.
- Export a Parquet file to CSV format for import into spreadsheet or analytics tools.
- Debug data quality issues by examining row-level content and column types in a Parquet dataset.
- Automate Parquet inspection in shell scripts or CI/CD pipelines for data validation.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need a lightweight CLI for ad-hoc Parquet inspection and S3 access.
The low install friction and permissive license make it easy to add to a project. However, dormant maintenance means no bug fixes or feature updates are coming; if you need active support or encounter issues, you may need to fork or switch to direct pyarrow usage.
Install
parquet-tools on PyPI
Before you install
Low friction installation with a pure-Python wheel. Maintenance is dormant—last release was in March 2024 and no commits since July 2024—so expect no active bug fixes or feature updates, though the package remains functional for its core use case.
Requires Python 3.9 or later. S3 access requires AWS credentials configured in your environment (boto3 dependency handles this).
License in practice
MIT license is permissive, allowing use in commercial and private projects with minimal restrictions; attribution is required but no copyleft obligations apply.
Quickstart
$ pip install parquet-tools
$ parquet-tools show /path/to/file.parquet
$ parquet-tools inspect /path/to/file.parquet
$ parquet-tools csv s3://bucket/file.parquetVerify before relying
- Whether the package handles nested or complex Parquet schemas beyond the basic examples shown.
- Performance characteristics when working with large Parquet files or S3 datasets.
- Whether the CSV export preserves all data types or has known limitations.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 7 packagesboto3coloramahalopandaspyarrowtabulatethrift |
| Maintenance | Dormant 878 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 241,103 / month, #8,886 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.9 |
Evidence: parquet_tools-0.2.16-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “parquet file viewer cli”
- parquet-toolsCommand-line tool to read, inspect, and export Parquet files from…
- parquet-metadataParquet-metadata is a command-line tool that reads and displays…
- parquetReads Apache Parquet files in pure Python and outputs data as JSON or…
Give your agent the search over MCP, or paste the wish link into any chat.
More Utilities packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Detects and normalizes text encoding from unknown or ambiguous sources, supporting all IANA character sets that Python's core library provides codecs for, with the ability to register custom codecs.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Pygments is a syntax highlighter that colorizes source code and text in over 500 languages and formats, outputting to HTML, LaTeX, RTF, SVG, images, or ANSI terminal sequences.
Install it if you need to display or transform source code.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
See also parquet · parquet-metadata · s3fs · kedro-datasets · pyspark-extension · tinybird · duckdb · dbt-duckdb · datafusion · s3cmd