dataframe-textual 1.1.5__py3-none-any.whl → 1.3.9__py3-none-any.whl

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.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: dataframe-textual
3
- Version: 1.1.5
3
+ Version: 1.3.9
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
@@ -29,7 +29,7 @@ Classifier: Topic :: Utilities
29
29
  Classifier: Typing :: Typed
30
30
  Requires-Python: >=3.11
31
31
  Requires-Dist: polars>=1.34.0
32
- Requires-Dist: textual>=6.5.0
32
+ Requires-Dist: textual[syntax]>=6.5.0
33
33
  Provides-Extra: dev
34
34
  Requires-Dist: textual-dev>=1.8.0; extra == 'dev'
35
35
  Provides-Extra: excel
@@ -45,11 +45,11 @@ A powerful, interactive terminal-based viewer/editor for CSV/TSV/Excel/Parquet/J
45
45
 
46
46
  ## Features
47
47
 
48
- ### Core Data Viewing
48
+ ### Data Viewing
49
49
  - 🚀 **Fast Loading** - Powered by Polars for efficient data handling
50
- - 🎨 **Rich Terminal UI** - Beautiful, color-coded columns with automatic type detection
50
+ - 🎨 **Rich Terminal UI** - Beautiful, color-coded columns with various data types (e.g., integer, float, string)
51
51
  - ⌨️ **Comprehensive Keyboard Navigation** - Intuitive controls for browsing, editing, and manipulating data
52
- - 📊 **Flexible Input** - Read from files or stdin (pipes/redirects)
52
+ - 📊 **Flexible Input** - Read from files and/or stdin (pipes/redirects)
53
53
  - 🔄 **Smart Pagination** - Lazy load rows on demand for handling large datasets
54
54
 
55
55
  ### Data Manipulation
@@ -60,7 +60,7 @@ A powerful, interactive terminal-based viewer/editor for CSV/TSV/Excel/Parquet/J
60
60
  - 💾 **Save & Undo** - Save edits back to file with full undo/redo support
61
61
 
62
62
  ### Advanced Features
63
- - 📂 **Multi-File Support** - Open multiple files in tabs for side-by-side comparison
63
+ - 📂 **Multi-File Support** - Open multiple files in separate tabs
64
64
  - 🔄 **Tab Management** - Seamlessly switch between open files with keyboard shortcuts
65
65
  - 📌 **Freeze Rows/Columns** - Keep important rows and columns visible while scrolling
66
66
  - 🎯 **Cursor Type Cycling** - Switch between cell, row, and column selection modes
@@ -161,7 +161,7 @@ When multiple files are opened:
161
161
  |-----|--------|
162
162
  | `Ctrl+O` | Open file in a new tab |
163
163
  | `Ctrl+W` | Close current tab |
164
- | `Ctrl+Shift+S` | Save all open tabs to Excel file |
164
+ | `Ctrl+A` | Save all open tabs to Excel file |
165
165
  | `>` or `b` | Move to next tab |
166
166
  | `<` | Move to previous tab |
167
167
  | `B` | Toggle tab bar visibility |
@@ -171,7 +171,7 @@ When multiple files are opened:
171
171
 
172
172
  | Key | Action |
173
173
  |-----|--------|
174
- | `Ctrl+H` | Toggle help panel |
174
+ | `F1` | Toggle help panel |
175
175
  | `k` | Cycle through themes |
176
176
 
177
177
  ---
@@ -206,17 +206,21 @@ When multiple files are opened:
206
206
  | Key | Action |
207
207
  |-----|--------|
208
208
  | `Double-click` | Edit cell or rename column header |
209
- | `X` | Clear current cell (set to NULL) |
209
+ | `delete` | Clear current cell (set to NULL) |
210
210
  | `e` | Edit current cell (respects data type) |
211
211
  | `E` | Edit entire column with expression |
212
212
  | `a` | Add empty column after current |
213
213
  | `A` | Add column with name and value/expression |
214
214
  | `-` (minus) | Delete current column |
215
+ | `_` (underscore) | Delete current column and all columns after |
216
+ | `Ctrl+_` | Delete current column and all columns before |
215
217
  | `x` | Delete current row |
218
+ | `X` | Delete current row and all rows below |
219
+ | `Ctrl+X` | Delete current row and all rows above |
216
220
  | `d` | Duplicate current column (appends '_copy' suffix) |
217
221
  | `D` | Duplicate current row |
218
222
  | `h` | Hide current column |
219
- | `H` | Show all hidden columns |
223
+ | `H` | Show all hidden rows/columns |
220
224
 
221
225
  #### Searching & Filtering
222
226
 
@@ -237,6 +241,13 @@ When multiple files are opened:
237
241
  | `v` | View only rows by selected rows and/or matches or cursor value |
238
242
  | `V` | View only rows by expression |
239
243
 
244
+ #### SQL Interface
245
+
246
+ | Key | Action |
247
+ |-----|--------|
248
+ | `l` | Simple SQL interface (select columns & WHERE clause) |
249
+ | `L` | Advanced SQL interface (full SQL queries) |
250
+
240
251
  #### Find & Replace
241
252
 
242
253
  | Key | Action |
@@ -283,7 +294,8 @@ When multiple files are opened:
283
294
  | `Ctrl+R` | Copy row to clipboard (tab-separated) |
284
295
  | `Ctrl+S` | Save current tab to file |
285
296
  | `u` | Undo last action |
286
- | `U` | Reset to original data |
297
+ | `U` | Redo last undone action |
298
+ | `Ctrl+U` | Reset to initial state |
287
299
 
288
300
  ## Features in Detail
289
301
 
@@ -512,7 +524,7 @@ Press `F` to see how many times each value appears in the current column. The mo
512
524
  **In the Frequency Table**:
513
525
  - Press `[` and `]` to sort by any column (value, count, or percentage)
514
526
  - Press `v` to **filter** the main table to show only rows with the selected value
515
- - Press `"` to **highlight** all rows containing the selected value
527
+ - Press `"` to **exclude** all rows except those containing the selected value
516
528
  - Press `q` or `Escape` to close the frequency table
517
529
 
518
530
  This is useful for:
@@ -560,9 +572,25 @@ This is useful for:
560
572
  - Delete all selected rows (if any) at once
561
573
  - Or delete single row at cursor
562
574
 
575
+ **Delete Row and Below** (`X`):
576
+ - Deletes the current row and all rows below it
577
+ - Useful for removing trailing data or the end of a dataset
578
+
579
+ **Delete Row and Above** (`Ctrl+X`):
580
+ - Deletes the current row and all rows above it
581
+ - Useful for removing leading rows or the beginning of a dataset
582
+
563
583
  **Delete Column** (`-`):
564
584
  - Removes the entire column from view and dataframe
565
585
 
586
+ **Delete Column and After** (`_`):
587
+ - Deletes the current column and all columns to the right
588
+ - Useful for removing trailing columns or the end of a dataset
589
+
590
+ **Delete Column and Before** (`Ctrl+-`):
591
+ - Deletes the current column and all columns to the left
592
+ - Useful for removing leading columns or the beginning of a dataset
593
+
566
594
  ### 9. Hide & Show Columns
567
595
 
568
596
  **Hide Column** (`h`):
@@ -570,9 +598,8 @@ This is useful for:
570
598
  - Column data is preserved in the dataframe
571
599
  - Hidden columns are included in saves
572
600
 
573
- **Show Hidden Columns** (`H`):
574
- - Restores all previously hidden columns to the display
575
- - Returns table to full column view
601
+ **Show Hidden Rows/Columns** (`H`):
602
+ - Restores all previously hidden rows/columns to the display
576
603
 
577
604
  This is useful for:
578
605
  - Focusing on specific columns without deleting data
@@ -634,14 +661,23 @@ Press `Ctrl+S` to save:
634
661
  - Choose filename in modal dialog
635
662
  - Confirm if file already exists
636
663
 
637
- ### 15. Undo/Redo
664
+ ### 15. Undo/Redo/Reset
638
665
 
639
- Press `u` to undo:
666
+ **Undo** (`u`):
640
667
  - Reverts last action with full state restoration
641
668
  - Works for edits, deletions, sorts, searches, etc.
642
669
  - Shows description of reverted action
643
670
 
644
- Press `U` to revert to when data was initially loaded
671
+ **Redo** (`U`):
672
+ - Reapplies the last undone action
673
+ - Restores the state before the undo was performed
674
+ - Useful for redoing actions you've undone by mistake
675
+ - Useful for alternating between two different states
676
+
677
+ **Reset** (`Ctrl+U`):
678
+ - Reverts all changes and returns to original data state when file was first loaded
679
+ - Clears all edits, deletions, selections, filters, and sorts
680
+ - Useful for starting fresh without reloading the file
645
681
 
646
682
  ### 16. Column Type Conversion
647
683
 
@@ -674,7 +710,40 @@ Press `@` to make URLs in the current column clickable:
674
710
  - **Scans** all cells in the current column for URLs starting with `http://` or `https://`
675
711
  - **Applies** link styling to make them clickable and dataframe remains unchanged
676
712
 
677
- ### 19. Clipboard Operations
713
+ ### 19. SQL Interface
714
+
715
+ The SQL interface provides two modes for querying your dataframe:
716
+
717
+ #### Simple SQL Interface (`l`)
718
+ Select specific columns and apply WHERE conditions without writing full SQL:
719
+ - Choose which columns to include in results
720
+ - Specify WHERE clause for filtering
721
+ - Ideal for quick filtering and column selection
722
+
723
+ #### Advanced SQL Interface (`L`)
724
+ Execute complete SQL queries for advanced data manipulation:
725
+ - Write full SQL queries with standard [SQL syntax](https://docs.pola.rs/api/python/stable/reference/sql/index.html)
726
+ - Support for JOINs, GROUP BY, aggregations, and more
727
+ - Access to all SQL capabilities for complex transformations
728
+ - Always use `self` as the table name
729
+
730
+ **Examples:**
731
+ ```sql
732
+ -- Filter and select specific rows and/or columns
733
+ SELECT name, age FROM self WHERE age > 30
734
+
735
+ -- Aggregate with GROUP BY
736
+ SELECT department, COUNT(*) as count, AVG(salary) as avg_salary
737
+ FROM self
738
+ GROUP BY department
739
+
740
+ -- Complex filtering with multiple conditions
741
+ SELECT *
742
+ FROM self
743
+ WHERE (age > 25 AND salary > 50000) OR department = 'Management'
744
+ ```
745
+
746
+ ### 20. Clipboard Operations
678
747
 
679
748
  Copies value to system clipboard with `pbcopy` on macOS and `xclip` on Linux
680
749
 
@@ -0,0 +1,14 @@
1
+ dataframe_textual/__init__.py,sha256=IFPb8RMUgghw0eRomehkkC684Iny_gs1VkiZMQ5ZpFk,813
2
+ dataframe_textual/__main__.py,sha256=hgjKLT3ggGxVVeRBunkArTy7PTqOHVJUf3fsH4P5dfU,2146
3
+ dataframe_textual/common.py,sha256=YeXikgy7Mvgfs4vvoloG_8i2rBBnAsHDPnjaYQfIHUM,16748
4
+ dataframe_textual/data_frame_help_panel.py,sha256=iEKaur-aH1N_oqHu-vMwEEjfkjQiThK24UO5izsOiW0,3416
5
+ dataframe_textual/data_frame_table.py,sha256=FIxhKvVEzm4wrejFu7iX_zoZFDAxO0xs0o80aeF0Km0,114086
6
+ dataframe_textual/data_frame_viewer.py,sha256=CFZv4UdD2JU_uTmXccVznb_K7NmxmFMsDkYoZBZlkc0,12716
7
+ dataframe_textual/sql_screen.py,sha256=F-4C4AwjdyiXzLl6fheGrkVMfk-Yvz5EXaXPFfZq5xs,6165
8
+ dataframe_textual/table_screen.py,sha256=o5gLWiF01oa2beTjCCqTG87qMs7XDZgkvqjfsWRU9K4,17755
9
+ dataframe_textual/yes_no_screen.py,sha256=gI4yj1T5rek10A9Va11KsuO_1XwVgvVPOUDrcknPrQM,23127
10
+ dataframe_textual-1.3.9.dist-info/METADATA,sha256=Q1a1gyNiWwMftSIPkw3XUWoVigM0KSfIpdIra0j7Wec,27924
11
+ dataframe_textual-1.3.9.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
12
+ dataframe_textual-1.3.9.dist-info/entry_points.txt,sha256=R_GoooOxcq6ab4RaHiVoZ4zrZJ-phMcGmlL2rwqncW8,107
13
+ dataframe_textual-1.3.9.dist-info/licenses/LICENSE,sha256=AVTg0gk1X-LHI-nnHlAMDQetrwuDZK4eypgSMDO46Yc,1069
14
+ dataframe_textual-1.3.9.dist-info/RECORD,,
@@ -1,2 +1,3 @@
1
1
  [console_scripts]
2
+ dataframe-textual = dataframe_textual.__main__:main
2
3
  dv = dataframe_textual.__main__:main
@@ -1,13 +0,0 @@
1
- dataframe_textual/__init__.py,sha256=IFPb8RMUgghw0eRomehkkC684Iny_gs1VkiZMQ5ZpFk,813
2
- dataframe_textual/__main__.py,sha256=hgjKLT3ggGxVVeRBunkArTy7PTqOHVJUf3fsH4P5dfU,2146
3
- dataframe_textual/common.py,sha256=q4bXS7oiJAsdcMEfHkPm5-e8SlfcwCBNhFN9TinQqV0,16171
4
- dataframe_textual/data_frame_help_panel.py,sha256=XgKGEPJr2hnDWpZ5mavLRcBSPa9cvrXdzVUGFQavXm4,3353
5
- dataframe_textual/data_frame_table.py,sha256=mOm0pzuN61N01KXi_II6Ld4-NqVYYdiKfzukDMlJpxw,102644
6
- dataframe_textual/data_frame_viewer.py,sha256=4mV3k7MNTf9TKBmGJ8fDx7itA1vo4qSmaWpvZozwfjs,12987
7
- dataframe_textual/table_screen.py,sha256=vSevLh944xBTIYVcokABCfSUi84s9gclizx6eDmxyFY,17585
8
- dataframe_textual/yes_no_screen.py,sha256=vyUKMBbbwgt5At1U430eLg3WbJvqUNoz2GpvdnMd7q0,22921
9
- dataframe_textual-1.1.5.dist-info/METADATA,sha256=JPvTklR6oWLJ5uAZxpBQzQ8eFzbZOVG6LV7whyk1wZs,25422
10
- dataframe_textual-1.1.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
11
- dataframe_textual-1.1.5.dist-info/entry_points.txt,sha256=Z0XKp1ACvmbJymekkxt-C81I0OoInksr5Ib0w2OT_a4,55
12
- dataframe_textual-1.1.5.dist-info/licenses/LICENSE,sha256=AVTg0gk1X-LHI-nnHlAMDQetrwuDZK4eypgSMDO46Yc,1069
13
- dataframe_textual-1.1.5.dist-info/RECORD,,