tab-cli 0.1.6__tar.gz → 0.1.7__tar.gz

{tab_cli-0.1.6 → tab_cli-0.1.7}/CHANGELOG.md

@@ -1,3 +1,5 @@
+  - 0.1.7:
+    - Optional dependency groups are now named `tab-cli[s3|gs|az]`, in accordance with the protocol name.
   - 0.1.6:
     - Fixed bug in pyarrow loading of Parquet files.
     - Added global config file support: settings can be persisted in `~/.config/tab/config.json`. Config file values serve as defaults that CLI flags override.

tab_cli-0.1.7/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: tab-cli
+Version: 0.1.7
+Summary: A CLI tool for tabular data
+Author-email: Tongfei Chen <tongfei@pm.me>
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: blobfile>=3.0
+Requires-Dist: fsspec>=2025.1.0
+Requires-Dist: jmespath>=1.0
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: polars-fastavro>=0.5.1
+Requires-Dist: polars>=1.0
+Requires-Dist: pyarrow>=15.0
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.21.1
+Provides-Extra: az
+Requires-Dist: adlfs>=2025.1.0; extra == 'az'
+Requires-Dist: azure-identity>=1.10.0; extra == 'az'
+Provides-Extra: gs
+Requires-Dist: gcsfs>=2025.1.0; extra == 'gs'
+Requires-Dist: google-auth>=2.27.0; extra == 'gs'
+Provides-Extra: s3
+Requires-Dist: boto3>=1.28.0; extra == 's3'
+Requires-Dist: s3fs>=2025.1.0; extra == 's3'
+Description-Content-Type: text/markdown
+
+# tab
+
+[![pypi](https://img.shields.io/pypi/v/tab-cli)](https://pypi.org/project/tab-cli/)
+
+A CLI tool for viewing, querying, and converting tabular data files.
+Reads CSV, TSV, JSON Lines, Parquet, and Avro -- locally or from S3, GCS, and Azure Blob Storage.
+
+```sh
+pip install tab-cli
+```
+
+**Documentation**: [tongfei.me/tab](https://tongfei.me/tab)
+
+---
+
+## Quick look
+
+### View any tabular file
+
+```bash
+tab view data.csv
+```
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ctongfei/tab/refs/heads/gh-pages/assets/test.svg" alt="tab view" width="680">
+</p>
+
+### Query with SQL
+
+The table is always available as `t`:
+
+```bash
+tab view --sql 'SELECT * FROM t WHERE Metric_A_Value > 80' data.csv
+```
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ctongfei/tab/refs/heads/gh-pages/assets/test-where.svg" alt="tab view --sql" width="680">
+</p>
+
+### Reshape rows with JMESPath
+
+```bash
+tab view --jp '{id: participant.id, city: profile.address.city}' data.parquet 
+```
+
+### Convert between formats
+
+```bash
+tab convert data.csv data.parquet
+tab convert data.parquet data.jsonl -o jsonl
+tab convert data.csv output_dir/ -o parquet -n 4   # partitioned
+```
+
+### Concatenate files
+
+```bash
+tab cat part1.csv part2.csv part3.csv -o jsonl > combined.jsonl
+```
+
+### Inspect schema and summary
+
+```bash
+tab schema data.parquet
+tab summary data.parquet
+```
+
+### Read from stdin
+
+```bash
+curl -s https://example.com/data.csv | tab view -i csv -
+```
+
+### Read from cloud storage
+
+```bash
+tab view s3://bucket/path/data.parquet
+tab view gs://bucket/path/data.csv
+tab view az://container/path/data.jsonl
+```
+
+Install cloud extras as needed:
+
+```sh
+pip install 'tab-cli[s3]'    # AWS S3
+pip install 'tab-cli[gs]'    # Google Cloud Storage
+pip install 'tab-cli[az]'    # Azure Blob Storage
+```
+
+## Supported formats
+ - csv
+ - tsv
+ - jsonl
+ - parquet
+ - avro

tab_cli-0.1.7/README.md

@@ -0,0 +1,94 @@
+# tab
+
+[![pypi](https://img.shields.io/pypi/v/tab-cli)](https://pypi.org/project/tab-cli/)
+
+A CLI tool for viewing, querying, and converting tabular data files.
+Reads CSV, TSV, JSON Lines, Parquet, and Avro -- locally or from S3, GCS, and Azure Blob Storage.
+
+```sh
+pip install tab-cli
+```
+
+**Documentation**: [tongfei.me/tab](https://tongfei.me/tab)
+
+---
+
+## Quick look
+
+### View any tabular file
+
+```bash
+tab view data.csv
+```
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ctongfei/tab/refs/heads/gh-pages/assets/test.svg" alt="tab view" width="680">
+</p>
+
+### Query with SQL
+
+The table is always available as `t`:
+
+```bash
+tab view --sql 'SELECT * FROM t WHERE Metric_A_Value > 80' data.csv
+```
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ctongfei/tab/refs/heads/gh-pages/assets/test-where.svg" alt="tab view --sql" width="680">
+</p>
+
+### Reshape rows with JMESPath
+
+```bash
+tab view --jp '{id: participant.id, city: profile.address.city}' data.parquet 
+```
+
+### Convert between formats
+
+```bash
+tab convert data.csv data.parquet
+tab convert data.parquet data.jsonl -o jsonl
+tab convert data.csv output_dir/ -o parquet -n 4   # partitioned
+```
+
+### Concatenate files
+
+```bash
+tab cat part1.csv part2.csv part3.csv -o jsonl > combined.jsonl
+```
+
+### Inspect schema and summary
+
+```bash
+tab schema data.parquet
+tab summary data.parquet
+```
+
+### Read from stdin
+
+```bash
+curl -s https://example.com/data.csv | tab view -i csv -
+```
+
+### Read from cloud storage
+
+```bash
+tab view s3://bucket/path/data.parquet
+tab view gs://bucket/path/data.csv
+tab view az://container/path/data.jsonl
+```
+
+Install cloud extras as needed:
+
+```sh
+pip install 'tab-cli[s3]'    # AWS S3
+pip install 'tab-cli[gs]'    # Google Cloud Storage
+pip install 'tab-cli[az]'    # Azure Blob Storage
+```
+
+## Supported formats
+ - csv
+ - tsv
+ - jsonl
+ - parquet
+ - avro

{tab_cli-0.1.6 → tab_cli-0.1.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tab-cli"
-version = "0.1.6"
+version = "0.1.7"
 description = "A CLI tool for tabular data"
 authors = [{name = "Tongfei Chen", email = "tongfei@pm.me"}]
 readme = "README.md"
@@ -20,8 +20,8 @@ dependencies = [
 
 [project.optional-dependencies]
 s3 = ["s3fs>=2025.1.0", "boto3>=1.28.0"]
-gcs = ["gcsfs>=2025.1.0", "google-auth>=2.27.0"]
-azure = ["adlfs>=2025.1.0", "azure-identity>=1.10.0"]
+gs = ["gcsfs>=2025.1.0", "google-auth>=2.27.0"]
+az = ["adlfs>=2025.1.0", "azure-identity>=1.10.0"]
 
 [dependency-groups]
 dev = [

tab_cli-0.1.6/PKG-INFO

@@ -1,37 +0,0 @@
-Metadata-Version: 2.4
-Name: tab-cli
-Version: 0.1.6
-Summary: A CLI tool for tabular data
-Author-email: Tongfei Chen <tongfei@pm.me>
-License-File: LICENSE
-Requires-Python: >=3.10
-Requires-Dist: blobfile>=3.0
-Requires-Dist: fsspec>=2025.1.0
-Requires-Dist: jmespath>=1.0
-Requires-Dist: loguru>=0.7.3
-Requires-Dist: polars-fastavro>=0.5.1
-Requires-Dist: polars>=1.0
-Requires-Dist: pyarrow>=15.0
-Requires-Dist: rich>=13.0
-Requires-Dist: typer>=0.21.1
-Provides-Extra: azure
-Requires-Dist: adlfs>=2025.1.0; extra == 'azure'
-Requires-Dist: azure-identity>=1.10.0; extra == 'azure'
-Provides-Extra: gcs
-Requires-Dist: gcsfs>=2025.1.0; extra == 'gcs'
-Requires-Dist: google-auth>=2.27.0; extra == 'gcs'
-Provides-Extra: s3
-Requires-Dist: boto3>=1.28.0; extra == 's3'
-Requires-Dist: s3fs>=2025.1.0; extra == 's3'
-Description-Content-Type: text/markdown
-
-# tab
-
-[![pypi](https://img.shields.io/pypi/v/tab-cli)](https://pypi.org/project/tab-cli/)
-```sh
-pip install tab-cli
-```
-
-A CLI tool for viewing, querying, and converting tabular data files. Supports AWS / Azure / Google Cloud Storage URLs.
-
- - Documentation: [docs](https://tongfei.me/tab)

tab_cli-0.1.6/README.md

@@ -1,10 +0,0 @@
-# tab
-
-[![pypi](https://img.shields.io/pypi/v/tab-cli)](https://pypi.org/project/tab-cli/)
-```sh
-pip install tab-cli
-```
-
-A CLI tool for viewing, querying, and converting tabular data files. Supports AWS / Azure / Google Cloud Storage URLs.
-
- - Documentation: [docs](https://tongfei.me/tab)