tab-cli 0.1.3__tar.gz → 0.1.4__tar.gz

{tab_cli-0.1.3 → tab_cli-0.1.4}/.gitignore

@@ -63,6 +63,7 @@ htmlcov/
 
 # Generated assets
 docs/assets/
+site/
 
 # Claude
 .claude/

tab_cli-0.1.4/.jj/.gitignore

@@ -0,0 +1 @@
+/*

tab_cli-0.1.4/.jj/repo/index/op_links/00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000

@@ -0,0 +1,2 @@
+
+@�z�&�;uskcj����.���K��7Է
�()���:u��i�g��o-/A�9�z����:

tab_cli-0.1.4/.jj/repo/index/op_links/282ad8cf3324b2679a7d460c0fc324adfa21dcfad2f197ac6991b98ec91f98495bb3ddb2cba36ce5dfa28a52063a373bb03f5d2e34f6e0c7b6b81b3046a4d7d0

@@ -0,0 +1,3 @@
+
+@)�D0ئg���vR���o_�l�U��Xi5��6�l����aT�s���7�/�
+n}y 

tab_cli-0.1.4/.jj/repo/index/op_links/891d7ed26f62b0f8757b081e9d76840636877f1613ee17b7695fe2ee8640258c56e01291934e3797728bc2300a1b5f41e3f3ef81ab532c0e5ab475bb9b6f097a

@@ -0,0 +1,4 @@
+
+@R�W��>��q��<-��
+����W�ʭP��~�
+�+�q	m�

tab_cli-0.1.4/.jj/repo/index/op_links/89d29d938e64b1295e138faedfa5df6f6729a67e5ba8e0c3fdd1c9266e0f59a4bc35b8a21e14225072317879af3323fa0457e01d9b08608770bc23957feec6c0

@@ -0,0 +1,2 @@
+
+@�>���+~�����b���1�s����畬[��n�a�>ܚ&��[�5!�����e�D�׿s

tab_cli-0.1.4/.jj/repo/index/op_links/95fc2854c0fa2528b03e2bcabc7612f56f0bcb3d6f54a06293e21d1887885a449907b5b320a1a94bac712bf56fdad0a4184b17047c1fc179dfa83acab3f70d21

@@ -0,0 +1,2 @@
+
+@2(����7KU2�

tab_cli-0.1.4/.jj/repo/index/op_links/9a58ceae46de4649375b6b880b8500c85d34c8e9bc650dc4c993afb2fa8d45c4180331821c6226a0fb1475b04a0b9a849502647ef9c4dcac74769eb501c885fa

@@ -0,0 +1,2 @@
+
+@����$���̓
O�5<G1ບG/�9xC���vZ{D�!�v� �L�:9����B:O_��

tab_cli-0.1.4/.jj/repo/index/op_links/a19ae062208aa20b7310705af3d26ef53095a9dabfad080883cc7a32e98687063179db95cb2c71ef9064801c59fa46d261f172d83e83f96a39c274387b59dca4

@@ -0,0 +1,2 @@
+
+@��ϡ9��}�ܐ&*�UX��^�s�0

tab_cli-0.1.4/.jj/repo/index/op_links/d1169a8d10067493e42752c2a7615ff27f55bd90c38b91feef918958e29a2239ee289a0cde8385441d1f0fe9af1fb634fa6d56438b9f33ec382e81fa59d70b54

@@ -0,0 +1,2 @@
+
+@D~�J�TK6����U�M�'�?�v,D�Qe!��*1��ͧ�s�W���C�]�5rr��*

tab_cli-0.1.4/.jj/repo/index/op_links/e171e5c6039c050c2368584a537d36df221b1f9f23d285c0399b95b14608d67006229823e6831bff7d8b0c2f9e86ebaec9c6811461119195f430ade055073fed

@@ -0,0 +1,2 @@
+
+@����$���̓
O�5<G1ບG/�9xC���vZ{D�!�v� �L�:9����B:O_��

tab_cli-0.1.4/.jj/repo/index/op_links/ee118dd19aac4e1cb354f83a37dadca70bc5f086cc8d36cd0059b222bf8c7250824401ff681518d0120f8db1f96f0025c464dcfc3b1ee28777e8c76325760134

@@ -0,0 +1,2 @@
+
+@^�/mGq��GG��IT,�-�����6—���

tab_cli-0.1.4/.jj/repo/index/operations/00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000

@@ -0,0 +1 @@
+d27ad326963b75736b636adad9fb812eb3f2871e0efb4bc7db37d4b701a4282911eaaee91bed3a759e940769b667be1ed66f2d7f2f41ac3906b87ab7eec19c3a

tab_cli-0.1.4/.jj/repo/index/operations/282ad8cf3324b2679a7d460c0fc324adfa21dcfad2f197ac6991b98ec91f98495bb3ddb2cba36ce5dfa28a52063a373bb03f5d2e34f6e0c7b6b81b3046a4d7d0

@@ -0,0 +1 @@
+1029dd1c1f4430d8a667a0e48d0b817652c7ddca6f5ff56cac1755e5bb0c1cb7586935941c9b36f26cab05c0effe6154d073bd1dffbe37f22fed0a6e7d79201f

tab_cli-0.1.4/.jj/repo/index/operations/891d7ed26f62b0f8757b081e9d76840636877f1613ee17b7695fe2ee8640258c56e01291934e3797728bc2300a1b5f41e3f3ef81ab532c0e5ab475bb9b6f097a

@@ -0,0 +1 @@
+52ea57bde33e8ef4718d833c2df3cf0a9e90fdcd5715c0caad50b4e37ea60aca2b8c71096de6920dc936c40b6291e896293f91c7cfd2aa96cf6c2aa49ef662c8

tab_cli-0.1.4/.jj/repo/index/operations/8926397375b8328137652c18cd4371808b214cb26864d77dd33c8eea895e10e62c297064c3d4c703d58ee11dee81bbf9851525e3a0c33151f54c164b8a4343b0

@@ -0,0 +1 @@
+424c9a53f5458b328d77ed6a943dc35662e949befa8725cfc7eead01a270417c8d07c1001b11623a088da8d2c9c34a41573314fa2394643147e4027e8a96a605

tab_cli-0.1.4/.jj/repo/index/operations/89d29d938e64b1295e138faedfa5df6f6729a67e5ba8e0c3fdd1c9266e0f59a4bc35b8a21e14225072317879af3323fa0457e01d9b08608770bc23957feec6c0

@@ -0,0 +1 @@
+cb3e8da2bf2b7efae4a6e8fd0b8562dacd16ca0531b173a91480a9e60ee795ac5bec13fc6eb461e03edc9a26f5ff1d5ba53521a1c1a6c1ee1765b544b7d7bf73

tab_cli-0.1.4/.jj/repo/index/operations/95fc2854c0fa2528b03e2bcabc7612f56f0bcb3d6f54a06293e21d1887885a449907b5b320a1a94bac712bf56fdad0a4184b17047c1fc179dfa83acab3f70d21

@@ -0,0 +1 @@
+3228b9bef9d8374b5532b40df2da8be3bfc86de713bdad7fe620977ffa7c56db83928678caa792bf0d328db607028e045a9e41423ef7501e5b550651c3815ffe

tab_cli-0.1.4/.jj/repo/index/operations/9a58ceae46de4649375b6b880b8500c85d34c8e9bc650dc4c993afb2fa8d45c4180331821c6226a0fb1475b04a0b9a849502647ef9c4dcac74769eb501c885fa

@@ -0,0 +1 @@
+8ef99a12ae0624db198d9ecd83014fb8353c4731e0ba9a472f1fc339784308e38f1287d0765a7b0444f1a89c218c76a820dc4c9a3a39c1cedcd7423a4f5f88dc

tab_cli-0.1.4/.jj/repo/index/operations/a19ae062208aa20b7310705af3d26ef53095a9dabfad080883cc7a32e98687063179db95cb2c71ef9064801c59fa46d261f172d83e83f96a39c274387b59dca4

@@ -0,0 +1 @@
+86a1cfa113399acc7dd2dc90262a845558affb5e9373b6300dff68a485482c5e17ace9466bbc23b4301013ca1a27a577ca57ea838113f45bf321a64a242b1ad3

tab_cli-0.1.4/.jj/repo/index/operations/d1169a8d10067493e42752c2a7615ff27f55bd90c38b91feef918958e29a2239ee289a0cde8385441d1f0fe9af1fb634fa6d56438b9f33ec382e81fa59d70b54

@@ -0,0 +1 @@
+44107e81054aa5544b36eab8d811908a559b4d9027dc3fa1762c44e39551652199ef2a31f9bbcda79773c906151c12578cb18c43e0045de8b20c357272e1c62a

tab_cli-0.1.4/.jj/repo/index/operations/e171e5c6039c050c2368584a537d36df221b1f9f23d285c0399b95b14608d67006229823e6831bff7d8b0c2f9e86ebaec9c6811461119195f430ade055073fed

@@ -0,0 +1 @@
+8ef99a12ae0624db198d9ecd83014fb8353c4731e0ba9a472f1fc339784308e38f1287d0765a7b0444f1a89c218c76a820dc4c9a3a39c1cedcd7423a4f5f88dc

tab_cli-0.1.4/.jj/repo/index/operations/ee118dd19aac4e1cb354f83a37dadca70bc5f086cc8d36cd0059b222bf8c7250824401ff681518d0120f8db1f96f0025c464dcfc3b1ee28777e8c76325760134

@@ -0,0 +1 @@
+5ea52f6d4771afda4747b9f44954102c02ae2d0686f8aa9eca36c29796bbba0d14e851c0dca0a6af17bfbbbac174e3be645ae708d958390168e85c64786fc9ef

tab_cli-0.1.4/.jj/repo/index/type

@@ -0,0 +1 @@
+default

tab_cli-0.1.4/.jj/repo/op_heads/type

@@ -0,0 +1 @@
+simple_op_heads_store

tab_cli-0.1.4/.jj/repo/op_store/operations/282ad8cf3324b2679a7d460c0fc324adfa21dcfad2f197ac6991b98ec91f98495bb3ddb2cba36ce5dfa28a52063a373bb03f5d2e34f6e0c7b6b81b3046a4d7d0

@@ -0,0 +1,4 @@
+
+@�u�̴/R��E�Nmi+7��ӓV�(���\�<���'�B�&�6c�r?���l\p_[�!'��@���b ��spZ��n�0��ڿ���z2醇1yە�,q�d�Y�F�a�r�>��j9�t8{Yܤj
+�Ȋ��3���������
�Ȋ��3���������
import git refs"tongfei-alienware*tongfei2
+argsjj git init(

tab_cli-0.1.4/.jj/repo/op_store/operations/891d7ed26f62b0f8757b081e9d76840636877f1613ee17b7695fe2ee8640258c56e01291934e3797728bc2300a1b5f41e3f3ef81ab532c0e5ab475bb9b6f097a

@@ -0,0 +1,7 @@
+
+@;6��dM-�{�/gjx$�iQm��f\y�?_g)��7����i
+�0���xk̝��@��(T��%(�>+ʼv�o�=oT�b����ZD��� ��K�q+�o�ФK|�yߨ:ʳ�
+�����3���������
�����3���������
/commit f917bd9e5adc33c5e5ef59b12b4ddd7fc816a42e"tongfei-alienware*tongfei2
+argsjj commit -m jj",
+^r�%�͇��ز��EG�m�����Z�3���Y�+M���."
+�M��a�dI��`��&:���2(

tab_cli-0.1.4/.jj/repo/op_store/operations/8926397375b8328137652c18cd4371808b214cb26864d77dd33c8eea895e10e62c297064c3d4c703d58ee11dee81bbf9851525e3a0c33151f54c164b8a4343b0

@@ -0,0 +1,5 @@
+
+@͎�m�A'�7�n���0��H�Zn�n�I�c����G%���2��\�[m��w˱W�@�ҝ��d�)^��ߥ�og)�~[������&nY��5��"Pr1xy�3#�W��`�p�#�����

+����3���������
����3���������

+args�
jj file untrack site/404.html site/assets site/cli-ref site/cloud site/gen_assets.sh site/index.html site/search site/sitemap.xml site/sitemap.xml.gz",
+_��>V&�U��Ҝ�61BdH��F

tab_cli-0.1.4/.jj/repo/op_store/operations/89d29d938e64b1295e138faedfa5df6f6729a67e5ba8e0c3fdd1c9266e0f59a4bc35b8a21e14225072317879af3323fa0457e01d9b08608770bc23957feec6c0

@@ -0,0 +1,5 @@
+
+@�45�c���w3��0���O!��Უk���_��+�l��1���S�|�t�%�l����IY��U@�q���#hXJS}6�"�#҅�9���F�p"�#��}�/����Ɓa���0��U?�p
+�����3���������
�����3���������
snapshot working copy"tongfei-alienware*tongfei2
+args	jj status8
",
+F

tab_cli-0.1.4/.jj/repo/op_store/operations/95fc2854c0fa2528b03e2bcabc7612f56f0bcb3d6f54a06293e21d1887885a449907b5b320a1a94bac712bf56fdad0a4184b17047c1fc179dfa83acab3f70d21

@@ -0,0 +1,6 @@
+
+@����,����~8��
+�Ɩ��3���������
����3���������
/commit 2cf78a4bc12a1c8d99507386fb55c5a8cabb230b"tongfei-alienware*tongfei2
+args	jj commit",
+?s����$�[�m|c
+���Z�3���Y�+M���.(

tab_cli-0.1.4/.jj/repo/op_store/operations/ee118dd19aac4e1cb354f83a37dadca70bc5f086cc8d36cd0059b222bf8c7250824401ff681518d0120f8db1f96f0025c464dcfc3b1ee28777e8c76325760134

@@ -0,0 +1,5 @@
+
+@�]�~�o�l�'��鋫H*gPwm���<��P�~�6BqK{�Io�:�D�ڿ/����h��F@(*��3$�g�}F�$��!����i�����I[�ݲˣl�ߢ�R:7;�?].4��Ƕ�0F���j
+�Ȋ��3���������
�Ɋ��3���������
import git head"tongfei-alienware*tongfei2
+argsjj git init"
+Sg��>?��_ڤ���6�6(

tab_cli-0.1.4/.jj/repo/op_store/type

@@ -0,0 +1 @@
+simple_op_store

tab_cli-0.1.4/.jj/repo/store/git_target

@@ -0,0 +1 @@
+../../../.git

tab_cli-0.1.4/.jj/repo/store/type

@@ -0,0 +1 @@
+git

tab_cli-0.1.4/.jj/repo/submodule_store/type

@@ -0,0 +1 @@
+default

tab_cli-0.1.4/.jj/repo/workspace_store/index

@@ -0,0 +1,3 @@
+
+%
+default/home/tongfei/proj/tab-cli

tab_cli-0.1.4/.jj/working_copy/checkout

@@ -0,0 +1,2 @@
+@�~�ob��u{�v�6���i_��@%�V���N7�r��0
+_A��S,Z�u��o	zdefault

tab_cli-0.1.4/.jj/working_copy/type

@@ -0,0 +1 @@
+local

{tab_cli-0.1.3 → tab_cli-0.1.4}/CHANGELOG.md

@@ -1,3 +1,6 @@
+ - 0.1.4:
+   - Removed `tab sql` subcommand; SQL is now a `--sql` option on `tab view`, `tab convert`, and `tab cat`.
+   - Automatic PyArrow fallback for Parquet files that fail to read with Polars' native reader.
  - 0.1.3:
    - Separate `tab view` from `tab cat`: `tab view` does not convert formats, `tab cat` does.
    - Added `--max-cell-len` option to `tab view` to truncate long cell contents.

{tab_cli-0.1.3 → tab_cli-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tab-cli
-Version: 0.1.3
+Version: 0.1.4
 Summary: A CLI tool for tabular data
 Author-email: Tongfei Chen <tongfei@pm.me>
 License-File: LICENSE
@@ -26,7 +26,7 @@ Description-Content-Type: text/markdown
 
 # tab
 
-![pypi](https://img.shields.io/pypi/v/tab-cli)
+[![pypi](https://img.shields.io/pypi/v/tab-cli)](https://pypi.org/project/tab-cli/)
 ```sh
 pip install tab-cli
 ```

{tab_cli-0.1.3 → tab_cli-0.1.4}/README.md

@@ -1,6 +1,6 @@
 # tab
 
-![pypi](https://img.shields.io/pypi/v/tab-cli)
+[![pypi](https://img.shields.io/pypi/v/tab-cli)](https://pypi.org/project/tab-cli/)
 ```sh
 pip install tab-cli
 ```

{tab_cli-0.1.3 → tab_cli-0.1.4}/docs/cli-ref.md

@@ -13,6 +13,7 @@ Options:
 | Option                  | Description                                                                                               |
 |-------------------------|-----------------------------------------------------------------------------------------------------------|
 | `-i` / `--input-format` | Input format (`parquet`, `csv`, `tsv`, `jsonl`, `avro`). Auto-detected from extension if omitted.         |
+| `--sql`                 | SQL query to apply before displaying. The table is available as `t`.                                      |
 | `--limit`               | Maximum number of rows to display.                                                                        |
 | `--skip`                | Number of rows to skip from the beginning.                                                                |
 | `--max-cell-len`        | Truncate cell contents longer than this.                                                                 |
@@ -47,23 +48,6 @@ Options:
 | `-i` / `--input-format` | Input format (`parquet`, `csv`, `tsv`, `jsonl`, `avro`). Auto-detected from extension if omitted.         |
 
 
-## `tab sql`
-
-Run a SQL query on tabular data. The table is available as `t`.
-
-```bash
-tab sql $query $path [OPTIONS]
-```
-
-Options:
-
-| Option                  | Description                                                                                               |
-|-------------------------|-----------------------------------------------------------------------------------------------------------|
-| `-i` / `--input-format` | Input format (`parquet`, `csv`, `tsv`, `jsonl`, `avro`). Auto-detected from extension if omitted.         |
-| `-o` / `--output-format` | Output format (`parquet`, `csv`, `tsv`, `jsonl`, `avro`). If not specified, print Rich table in terminal. |
-| `--limit`               | Maximum number of rows to display.                                                                        |
-| `--skip`                | Number of rows to skip from the beginning.                                                                |
-
 ## `tab convert`
 
 Convert tabular data from one format to another.
@@ -78,6 +62,7 @@ Options:
 |-------------------------|---------------------------------------------------------------------------------------------------------|
 | `-i` / `--input-format` | Input format (`parquet`, `csv`, `tsv`, `jsonl`, `avro`). Auto-detected from extension if omitted.       |
 | `-o` / `--output-format` | Output format (`parquet`, `csv`, `tsv`, `jsonl`, `avro`). If not specified, inherits from input format. |
+| `--sql`                 | SQL query to apply before writing. The table is available as `t`.                                       |
 | `-n` / `--num-partitions` | Number of output partitions. Creates a directory with partition files.                                  |
 
 
@@ -95,6 +80,7 @@ Options:
 |-------------------------|-----------------------------------------------------------------------------------------------------------|
 | `-i` / `--input-format` | Input format (`parquet`, `csv`, `tsv`, `jsonl`, `avro`). Auto-detected from extension if omitted.         |
 | `-o` / `--output-format` | Output format (`parquet`, `csv`, `tsv`, `jsonl`, `avro`). If not specified, print Rich table in terminal. |
+| `--sql`                 | SQL query to apply after concatenation. The table is available as `t`.                                    |
 
 
 ## Global options

tab_cli-0.1.4/docs/gen_assets.sh

@@ -0,0 +1,3 @@
+mkdir -p docs/assets
+uv run tab view tests/assets/test.csv --table-svg 2> docs/assets/test.svg
+uv run tab sql 'SELECT * FROM t WHERE Metric_A_Value > 80' tests/assets/test.csv --table-svg 2> docs/assets/test-where.svg

{tab_cli-0.1.3 → tab_cli-0.1.4}/mkdocs.yml

@@ -35,4 +35,4 @@ nav:
   - 'CLI reference': 'cli-ref.md'
 
 watch:
-  - tab_cli
+  - src

{tab_cli-0.1.3 → tab_cli-0.1.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tab-cli"
-version = "0.1.3"
+version = "0.1.4"
 description = "A CLI tool for tabular data"
 authors = [{name = "Tongfei Chen", email = "tongfei@pm.me"}]
 readme = "README.md"

{tab_cli-0.1.3 → tab_cli-0.1.4}/src/tab_cli/cli.py

@@ -1,7 +1,7 @@
 """Main CLI entry point using Typer."""
 
 import sys
-from typing import Annotated, Optional
+from typing import Annotated, Optional, TypeAlias
 
 from loguru import logger
 import polars as pl
@@ -11,7 +11,20 @@ from rich.logging import RichHandler
 
 from tab_cli import config
 from tab_cli.handlers import TableWriter, infer_reader, infer_writer
-from tab_cli.handlers.cli_table import CliTableFormatter
+
+# Reusable type aliases for common CLI options
+PathArg: TypeAlias = Annotated[str, typer.Argument(help="Path to the data file or directory")]
+PathsArg: TypeAlias = Annotated[list[str], typer.Argument(help="Paths to the data files or directories")]
+SrcArg: TypeAlias = Annotated[str, typer.Argument(help="Path to the source file or directory")]
+DstArg: TypeAlias = Annotated[str, typer.Argument(help="Path to the destination file or directory")]
+InputOpt: TypeAlias = Annotated[Optional[str], typer.Option("-i", "--input-format", help="Input format, auto-detected from extension if omitted")]
+OutputOpt: TypeAlias = Annotated[Optional[str], typer.Option("-o", "--output-format", help="Output format")]
+SqlOpt: TypeAlias = Annotated[Optional[str], typer.Option("--sql", help="SQL query to apply (table is available as 't')")]
+LimitOpt: TypeAlias = Annotated[Optional[int], typer.Option("--limit", help="Maximum number of rows to display")]
+SkipOpt: TypeAlias = Annotated[int, typer.Option("--skip", help="Number of rows to skip")]
+MaxCellLenOpt: TypeAlias = Annotated[Optional[int], typer.Option("--max-cell-len", help="Truncate cell contents longer than this")]
+TableSvgOpt: TypeAlias = Annotated[bool, typer.Option("--table-svg", help="Output table as SVG")]
+NumPartitionsOpt: TypeAlias = Annotated[Optional[int], typer.Option("-n", "--num-partitions", help="Number of output partitions")]
 
 app = typer.Typer(
     help="A CLI tool for viewing and manipulating tabular data.",
@@ -47,6 +60,14 @@ def main_callback(
     )
 
 
+def _apply_sql(lf: pl.LazyFrame, sql: str | None) -> pl.LazyFrame:
+    """Apply an optional SQL query to a LazyFrame. The table is available as 't'."""
+    if sql is not None:
+        ctx = pl.SQLContext(t=lf, eager=False)
+        return ctx.execute(sql)
+    return lf
+
+
 def _apply_limit(
     lf: pl.LazyFrame,
     limit: int | None,
@@ -73,24 +94,27 @@ def _apply_limit(
 
 @app.command()
 def view(
-    path: Annotated[str, typer.Argument(help="Path to the data file or directory")],
-    limit: Annotated[Optional[int], typer.Option("--limit", help="Maximum number of rows to display")] = None,
-    skip: Annotated[int, typer.Option("--skip", help="Number of rows to skip")] = 0,
-    input: Annotated[Optional[str], typer.Option("-i", "--input-format", help="Input format, auto-detected from extension if omitted")] = None,
-    max_cell_len: Annotated[Optional[int], typer.Option("--max-cell-len", help="Truncate cell contents longer than this")] = None,
+    path: PathArg,
+    limit: LimitOpt = None,
+    skip: SkipOpt = 0,
+    input: InputOpt = None,
+    sql: SqlOpt = None,
+    max_cell_len: MaxCellLenOpt = None,
+    table_svg: TableSvgOpt = False,
 ) -> None:
     """View tabular data as a formatted table."""
     reader = infer_reader(path, format=input)
     lf = reader.read(path)
+    lf = _apply_sql(lf, sql)
     lf, truncated = _apply_limit(lf, limit=limit, skip=skip, default_limit=20 if limit is None else None)
-    writer = CliTableFormatter(truncated=truncated, max_cell_len=max_cell_len)
+    writer = infer_writer("table-svg" if table_svg else None, truncated=truncated, max_cell_len=max_cell_len)
     for chunk in writer.write(lf):
         sys.stdout.buffer.write(chunk)
 
 @app.command()
 def schema(
-    path: Annotated[str, typer.Argument(help="Path to the data file or directory")],
-    input: Annotated[Optional[str], typer.Option("-i", "--input-format", help="Input format")] = None,
+    path: PathArg,
+    input: InputOpt = None,
 ) -> None:
     """Display the schema of a tabular data file."""
     reader = infer_reader(path, format=input)
@@ -99,31 +123,10 @@ def schema(
     console.print(table_schema)
 
 
-@app.command()
-def sql(
-    query: Annotated[str, typer.Argument(help="SQL query to execute (table is available as 't')")],
-    path: Annotated[str, typer.Argument(help="Path to the data file or directory")],
-    limit: Annotated[Optional[int], typer.Option("--limit", help="Maximum number of rows to display")] = None,
-    skip: Annotated[int, typer.Option("--skip", help="Number of rows to skip")] = 0,
-    input: Annotated[Optional[str], typer.Option("-i", "--input-format", help="Input format")] = None,
-    output: Annotated[Optional[str], typer.Option("-o", "--output-format", help="Output format")] = None,
-) -> None:
-    """Run a SQL query on tabular data. The table is available as 't'."""
-    reader = infer_reader(path, format=input)
-    lf = reader.read(path)
-    ctx = pl.SQLContext(t=lf, eager=False)
-    result_lf = ctx.execute(query)
-    show_truncation = limit is None and output is None
-    result_lf, truncated = _apply_limit(result_lf, limit=limit, skip=skip, default_limit=20 if show_truncation else None)
-    writer = infer_writer(output, truncated=truncated)
-    for chunk in writer.write(result_lf):
-        sys.stdout.buffer.write(chunk)
-
-
 @app.command()
 def summary(
-    path: Annotated[str, typer.Argument(help="Path to the data file or directory")],
-    input: Annotated[Optional[str], typer.Option("-i", "--input-format", help="Input format")] = None,
+    path: PathArg,
+    input: InputOpt = None,
 ) -> None:
     """Display summary information about a tabular data file."""
     handler = infer_reader(path, format=input)
@@ -134,11 +137,12 @@ def summary(
 
 @app.command()
 def convert(
-    src: Annotated[str, typer.Argument(help="Path to the source file or directory")],
-    dst: Annotated[str, typer.Argument(help="Path to the destination file or directory")],
-    input: Annotated[Optional[str], typer.Option("-i", "--input-format", help="Input format")] = None,
-    output: Annotated[Optional[str], typer.Option("-o", "--output-format", help="Output format")] = None,
-    num_partitions: Annotated[Optional[int], typer.Option("-n", "--num-partitions", help="Number of output partitions")] = None,
+    src: SrcArg,
+    dst: DstArg,
+    input: InputOpt = None,
+    output: OutputOpt = None,
+    sql: SqlOpt = None,
+    num_partitions: NumPartitionsOpt = None,
 ) -> None:
     """Convert tabular data from one format to another."""
     reader = infer_reader(src, format=input)
@@ -151,19 +155,22 @@ def convert(
         writer = reader
         assert isinstance(writer, TableWriter)
     lf = reader.read(src)
+    lf = _apply_sql(lf, sql)
     writer.write_to_path(lf, dst, partitions=num_partitions)
 
 
 @app.command()
 def cat(
-    paths: Annotated[list[str], typer.Argument(help="Paths to the data files or directories")],
-    input: Annotated[Optional[str], typer.Option("-i", "--input-format", help="Input format")] = None,
-    output: Annotated[Optional[str], typer.Option("-o", "--output-format", help="Output format")] = None,
+    paths: PathsArg,
+    input: InputOpt = None,
+    output: OutputOpt = None,
+    sql: SqlOpt = None,
 ) -> None:
     """Concatenate tabular data from multiple files, or just print a single file."""
     reader = infer_reader(paths[0], format=input)
     files = [reader.read(path) for path in paths]
     lf = pl.concat(files, how="vertical")
+    lf = _apply_sql(lf, sql)
     if output is not None:
         writer = infer_writer(format=output)
     else: