Parqx
Parqx is a lightweight terminal UI for inspecting Apache Parquet files.
Installation
Parqx requires Python 3.12 or newer.
pip install parqx
Usage
Open a Parquet file:
parqx data/weather.parquet
Press ctrl+p → SQL query to query the file as data. Results open in new tabs.
Keyboard control
Navigation
| Key | Action |
|---|---|
↑ / ↓ |
Move the cursor up or down |
← / → |
Move the cursor left or right |
pageUp / pageDown |
Move one page up or down |
home |
Move to the leftmost column |
end |
Move to the rightmost column |
ctrl+home |
Move to the first row |
ctrl+end |
Move to the last row |
enter |
Select the current cell |
Table View
These shortcuts apply to the active tab.
| Key | Action |
|---|---|
h |
Toggle the column header row |
i |
Toggle the row-index column |
z |
Toggle zebra striping |
c |
Cycle cursor type (cell → row → column → none) |
ctrl+w |
Close the current tab, keeping at least one tab open |
SQL query
| Key | Action |
|---|---|
ctrl+p → SQL query |
Open the centered SQL editor |
enter |
Run the complete SQL query |
shift+enter |
Insert a newline |
esc |
Close the editor and cancel any running query |
License
Parqx is licensed under the MIT License. See LICENSE for details.
This project includes code derived from Textual; see NOTICE.
1 maintainer
Metadata
1 maintainer
Release files for parqx 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| parqx-0.2.0.tar.gz | 35.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| parqx-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 79.1 kB
Release files / parqx-0.2.0.tar.gz
| Download URL | parqx-0.2.0.tar.gz |
|---|---|
| Size | 35.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ac75df8db89f6a07edbd1a048f54c2c5120578cc8aa2ab493bf73565cb7f105a
|
|
BLAKE2b-256 checksum How to use checksums |
465f6d7e45a360e2d9abf24ebc0b1077ac55cb9c2ea45a7bea95b92d7a0279a3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.22 {"installer":{"name":"uv","version":"0.12.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / parqx-0.2.0-py3-none-any.whl
| Download URL | parqx-0.2.0-py3-none-any.whl |
|---|---|
| Size | 43.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c816d4fff23cb518bbdb46dfe7d029477a8453364e0f368132c204d9694e34c6
|
|
BLAKE2b-256 checksum How to use checksums |
ecb22cc85247a76f7a1d84d23c417a20157ef5393870ce59cdaea657e0066098
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.22 {"installer":{"name":"uv","version":"0.12.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
