dataframe-textual 2.41.1__tar.gz → 2.42.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (18) hide show
  1. {dataframe_textual-2.41.1 → dataframe_textual-2.42.0}/PKG-INFO +6 -2
  2. {dataframe_textual-2.41.1 → dataframe_textual-2.42.0}/README.md +5 -1
  3. {dataframe_textual-2.41.1 → dataframe_textual-2.42.0}/pyproject.toml +1 -1
  4. {dataframe_textual-2.41.1 → dataframe_textual-2.42.0}/src/dataframe_textual/__main__.py +34 -2
  5. {dataframe_textual-2.41.1 → dataframe_textual-2.42.0}/src/dataframe_textual/common.py +1 -1
  6. {dataframe_textual-2.41.1 → dataframe_textual-2.42.0}/uv.lock +1 -1
  7. {dataframe_textual-2.41.1 → dataframe_textual-2.42.0}/.gitignore +0 -0
  8. {dataframe_textual-2.41.1 → dataframe_textual-2.42.0}/LICENSE +0 -0
  9. {dataframe_textual-2.41.1 → dataframe_textual-2.42.0}/main.py +0 -0
  10. {dataframe_textual-2.41.1 → dataframe_textual-2.42.0}/src/dataframe_textual/__init__.py +0 -0
  11. {dataframe_textual-2.41.1 → dataframe_textual-2.42.0}/src/dataframe_textual/data_frame_help_panel.py +0 -0
  12. {dataframe_textual-2.41.1 → dataframe_textual-2.42.0}/src/dataframe_textual/data_frame_table.py +0 -0
  13. {dataframe_textual-2.41.1 → dataframe_textual-2.42.0}/src/dataframe_textual/data_frame_viewer.py +0 -0
  14. {dataframe_textual-2.41.1 → dataframe_textual-2.42.0}/src/dataframe_textual/file_picker_screen.py +0 -0
  15. {dataframe_textual-2.41.1 → dataframe_textual-2.42.0}/src/dataframe_textual/loading_screen.py +0 -0
  16. {dataframe_textual-2.41.1 → dataframe_textual-2.42.0}/src/dataframe_textual/table_screen.py +0 -0
  17. {dataframe_textual-2.41.1 → dataframe_textual-2.42.0}/src/dataframe_textual/theme_screen.py +0 -0
  18. {dataframe_textual-2.41.1 → dataframe_textual-2.42.0}/src/dataframe_textual/yes_no_screen.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: dataframe-textual
3
- Version: 2.41.1
3
+ Version: 2.42.0
4
4
  Summary: Interactive terminal viewer/editor for tabular data
5
5
  Project-URL: Homepage, https://github.com/need47/dataframe-textual
6
6
  Project-URL: Repository, https://github.com/need47/dataframe-textual.git
@@ -135,7 +135,7 @@ dv *.parquet --all-in-one
135
135
 
136
136
  ```
137
137
  usage: dv [-h] [-V] [-d DELIMITER] [-f FORMAT] [-F [FIELDS ...]] [-H [HEADER ...]] [-L [N]] [-I] [-T] [-E] [-C [PREFIX]] [-Q [C]] [-K N] [-A N] [-M [N]] [-N NULL [NULL ...]] [--theme [THEME]]
138
- [--all-in-one] [--sql SQL] [-o OUTPUT]
138
+ [--all-in-one] [--expr EXPR] [--sql SQL] [-o OUTPUT]
139
139
  [files ...]
140
140
 
141
141
  TUI viewer/editor for tabular data (e.g., CSV/Excel).
@@ -173,6 +173,7 @@ options:
173
173
  --theme [THEME] Set the theme for the application. If used without value, show available themes.
174
174
  --all-in-one, --aio, --one
175
175
  Read all files (must be of same format and same structure) into one single table.
176
+ --expr EXPR Specify a Polars expression to filter data (e.g., $age > 30)
176
177
  --sql SQL Specify a SQL query to execute on the input file (e.g., to select and filter data)
177
178
  -o, --output OUTPUT Output file (optionally modified) with specified format, which is inferred from file extension (e.g., .csv, .xlsx).
178
179
  ```
@@ -241,6 +242,9 @@ dv data.csv -F name age 1 -1
241
242
  # Read all files (must be of same format and same structure) into one single table
242
243
  dv data-1.csv data-2.csv --all-in-one
243
244
 
245
+ # Filter rows before opening the viewer using a Polars expression
246
+ dv data.csv --expr '$age > 30'
247
+
244
248
  # Filter data using SQL query (use 'self' as the table name)
245
249
  dv data.csv --sql 'SELECT * FROM self WHERE age > 30'
246
250
 
@@ -96,7 +96,7 @@ dv *.parquet --all-in-one
96
96
 
97
97
  ```
98
98
  usage: dv [-h] [-V] [-d DELIMITER] [-f FORMAT] [-F [FIELDS ...]] [-H [HEADER ...]] [-L [N]] [-I] [-T] [-E] [-C [PREFIX]] [-Q [C]] [-K N] [-A N] [-M [N]] [-N NULL [NULL ...]] [--theme [THEME]]
99
- [--all-in-one] [--sql SQL] [-o OUTPUT]
99
+ [--all-in-one] [--expr EXPR] [--sql SQL] [-o OUTPUT]
100
100
  [files ...]
101
101
 
102
102
  TUI viewer/editor for tabular data (e.g., CSV/Excel).
@@ -134,6 +134,7 @@ options:
134
134
  --theme [THEME] Set the theme for the application. If used without value, show available themes.
135
135
  --all-in-one, --aio, --one
136
136
  Read all files (must be of same format and same structure) into one single table.
137
+ --expr EXPR Specify a Polars expression to filter data (e.g., $age > 30)
137
138
  --sql SQL Specify a SQL query to execute on the input file (e.g., to select and filter data)
138
139
  -o, --output OUTPUT Output file (optionally modified) with specified format, which is inferred from file extension (e.g., .csv, .xlsx).
139
140
  ```
@@ -202,6 +203,9 @@ dv data.csv -F name age 1 -1
202
203
  # Read all files (must be of same format and same structure) into one single table
203
204
  dv data-1.csv data-2.csv --all-in-one
204
205
 
206
+ # Filter rows before opening the viewer using a Polars expression
207
+ dv data.csv --expr '$age > 30'
208
+
205
209
  # Filter data using SQL query (use 'self' as the table name)
206
210
  dv data.csv --sql 'SELECT * FROM self WHERE age > 30'
207
211
 
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "dataframe-textual"
7
- version = "2.41.1"
7
+ version = "2.42.0"
8
8
  description = "Interactive terminal viewer/editor for tabular data"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.11"
@@ -8,7 +8,15 @@ import polars as pl
8
8
  from textual.theme import BUILTIN_THEMES
9
9
 
10
10
  from . import __version__
11
- from .common import SUPPORTED_FORMATS, guess_file_format, handle_compute_error, load_dataframe, write_file
11
+ from .common import (
12
+ SUPPORTED_FORMATS,
13
+ guess_file_format,
14
+ handle_compute_error,
15
+ load_dataframe,
16
+ tentative_expr,
17
+ validate_expr,
18
+ write_file,
19
+ )
12
20
  from .data_frame_viewer import DataFrameViewer
13
21
 
14
22
 
@@ -160,6 +168,8 @@ def cli() -> argparse.Namespace:
160
168
  help="Read all files (must be of same format and same structure) into one single table.",
161
169
  )
162
170
 
171
+ parser.add_argument("--expr", help="Specify a Polars expression to filter data (e.g., $age > 30)")
172
+
163
173
  parser.add_argument(
164
174
  "--sql", help="Specify a SQL query to execute on the input file (e.g., to select and filter data)"
165
175
  )
@@ -245,7 +255,21 @@ def main() -> None:
245
255
 
246
256
  return
247
257
 
248
- if args.sql:
258
+ if args.expr:
259
+ for source in sources:
260
+ columns = source.lf.collect_schema().names()
261
+ try:
262
+ expr = validate_expr(args.expr, columns)
263
+ except Exception as e:
264
+ print(f"Error validating expression [$error]{args.expr}[/]", file=sys.stderr)
265
+ sys.exit(1)
266
+
267
+ try:
268
+ source.lf = source.lf.filter(expr)
269
+ except pl.exceptions.ComputeError as e:
270
+ print(f"Error applying expression `{args.expr}`: {e}", file=sys.stderr)
271
+ sys.exit(1)
272
+ elif args.sql:
249
273
  for source in sources:
250
274
  ctx = pl.SQLContext(frames={"self": source.lf})
251
275
  try:
@@ -294,6 +318,14 @@ def validate_args(args: argparse.Namespace) -> None:
294
318
  )
295
319
  sys.exit(1)
296
320
 
321
+ if args.expr:
322
+ if not tentative_expr(args.expr):
323
+ print(
324
+ f"Invalid expression: `{args.expr}`. Did you forget the `$` prefix for column references?",
325
+ file=sys.stderr,
326
+ )
327
+ sys.exit(1)
328
+
297
329
 
298
330
  if __name__ == "__main__":
299
331
  main()
@@ -308,7 +308,7 @@ def tentative_expr(expr: str) -> bool:
308
308
  return False
309
309
 
310
310
 
311
- def validate_expr(expr: str, columns: list[str], current_col_idx: int) -> pl.Expr | None:
311
+ def validate_expr(expr: str, columns: list[str], current_col_idx: int = 0) -> pl.Expr | None:
312
312
  """Validate and return the expression.
313
313
 
314
314
  Parses a user-provided expression string and validates it as a valid Polars expression.
@@ -171,7 +171,7 @@ wheels = [
171
171
 
172
172
  [[package]]
173
173
  name = "dataframe-textual"
174
- version = "2.41.1"
174
+ version = "2.42.0"
175
175
  source = { editable = "." }
176
176
  dependencies = [
177
177
  { name = "fastexcel" },