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.
- dataframe_textual/common.py +33 -12
- dataframe_textual/data_frame_help_panel.py +6 -4
- dataframe_textual/data_frame_table.py +574 -309
- dataframe_textual/data_frame_viewer.py +19 -27
- dataframe_textual/sql_screen.py +202 -0
- dataframe_textual/table_screen.py +20 -18
- dataframe_textual/yes_no_screen.py +9 -5
- {dataframe_textual-1.1.5.dist-info → dataframe_textual-1.3.9.dist-info}/METADATA +88 -19
- dataframe_textual-1.3.9.dist-info/RECORD +14 -0
- {dataframe_textual-1.1.5.dist-info → dataframe_textual-1.3.9.dist-info}/entry_points.txt +1 -0
- dataframe_textual-1.1.5.dist-info/RECORD +0 -13
- {dataframe_textual-1.1.5.dist-info → dataframe_textual-1.3.9.dist-info}/WHEEL +0 -0
- {dataframe_textual-1.1.5.dist-info → dataframe_textual-1.3.9.dist-info}/licenses/LICENSE +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: dataframe-textual
|
|
3
|
-
Version: 1.
|
|
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
|
-
###
|
|
48
|
+
### Data Viewing
|
|
49
49
|
- 🚀 **Fast Loading** - Powered by Polars for efficient data handling
|
|
50
|
-
- 🎨 **Rich Terminal UI** - Beautiful, color-coded columns with
|
|
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
|
|
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+
|
|
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
|
-
| `
|
|
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
|
-
| `
|
|
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` |
|
|
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 **
|
|
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
|
-
|
|
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
|
-
|
|
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.
|
|
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,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,,
|
|
File without changes
|
|
File without changes
|